This shows you the differences between two versions of the page.
en:poimanager [2013/11/18 15:28] |
en:poimanager [2018/02/27 09:34] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Documentation of the POI Manager ====== | ||
+ | |||
+ | |||
+ | ===== Graphical user interface ===== | ||
+ | |||
+ | === Overview === | ||
+ | {{ : | ||
+ | The graphical user interface of the POI Manager can logically be subdivided in a map and list section. The map allows browsing, visualizing, | ||
+ | |||
+ | The second section contains the non geographical representation of the POIs in form of lists. Lists allow enabling to look for single POIs by name based filtering or sorting functions. | ||
+ | |||
+ | The map view and list view are interactive based on the fact that the selection of a POI in the map leads to the selection of the corresponding entry in the listed view of the collection. | ||
+ | |||
+ | === Description of the graphical user interface === | ||
+ | {{ : | ||
+ | - **Search bar** allows searching for places, localities, municipalities or coordinates | ||
+ | - Spatial **coordinates bar** allows defining the type of spatial references as well as reading the coordinates of the mouse cursor | ||
+ | - Activate or deactivate the list of **available additional layers** | ||
+ | - **Login** or logout button to create or terminate a user session | ||
+ | - Activate or deactivate the **overview map** | ||
+ | - **Non geographical view** of the available collections (see following sub chapters) | ||
+ | - Dynamic **scale bar** | ||
+ | - **Map navigation bar** allows zooming in and out, panning vertical or horizontal and zooming out to the initial extent of the country | ||
+ | |||
+ | =====Map===== | ||
+ | |||
+ | The map section allows browsing, visualizing, | ||
+ | |||
+ | ====Changing the base (background) map==== | ||
+ | Generally the map contains a base map layer and the POIs of a selected collection, the base map should give additional support for orientation on the map. Several types of base maps can be displayed by selecting the accordingly layer at the table of layers available the " | ||
+ | |||
+ | ====Overview map==== | ||
+ | On the lower right corner of the map you can find a second double arrowed button allowing to show or hide a small interactive overview map (see point 5 of the GUI description). The extent of the current map windows is represented by a red square, as both windows are interactively connected the extent on the overview map will change when the main map extent is changed and vice versa. | ||
+ | |||
+ | |||
+ | |||
+ | ====Context menu==== | ||
+ | {{ : | ||
+ | The context menu of the map can be opened by clicking the right mouse button anywhere on the map. The context menu includes the following three options: | ||
+ | * **Find in the list** - Shows the appropriated entry in the selected collection (Note: Returns no entry if no POI was clicked) | ||
+ | * **Create a POI here** - Opens the " | ||
+ | * **Associate this position with the selected file** - Set the clicked point on the map as the new point for the currently selected entry of the collection. This step is equal to editing a point manually, you will change the old geometry to a new one. (Note: For persistent changes you need to save your changes by hitting the __Save__ button on the upper left corner of the " | ||
+ | |||
+ | **Note**: If no collection is selected at the "My collection" | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | =====Collections===== | ||
+ | |||
+ | A collection is a set of POIs created by users or accumulated by including public collections into a new one. Visually each collection is one list of POIs. All collections are managed in the lower part of the application. The management of collections is organized in tabs including the following tabs: | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | * **My collections** - Allows managing all collections that I have created or shared with friends | ||
+ | * **Public collections** - List of collection that are accessible for the public | ||
+ | * **Collection data** - Listing the currently selected collection | ||
+ | * **Available styles** - Defining symbols for visualizing my POIs | ||
+ | * **Available tool tips** - Defining pop up windows for my POIs | ||
+ | * **Geocoding list** - Monitoring the geocoding processes | ||
+ | |||
+ | ====My Collection==== | ||
+ | |||
+ | All collections that I can access are listed in this tab. Collections are visible to me if I am the creator of it or if a friend shares a collection with me. The tab menu bar includes only one __New collection__ button allowing me to create new empty collections. The listing section contains 5 columns displaying attribute values for each collection. The listing navigation bar is located at the bottom of the page, it facilitates to navigate trough the pages of a list. Collections comprehend 5 attributes including : | ||
+ | * **Public** - Parameter that indicates if a collection is available for the public | ||
+ | * **Nom** - Name of the collection | ||
+ | * **Description** - Field intended for plain text describing the collection | ||
+ | * **Owner** - Username of the creator of the collection | ||
+ | * **Creation date** - Creation date of the collection | ||
+ | |||
+ | === Context menu === | ||
+ | |||
+ | {{ : | ||
+ | The context menu of a collection can be opened by a right mouse click on the collection entry. It contains all options that are available for those collection. | ||
+ | * **Give me a link to this map** - Opens a map view element in a new window showing all POIs included at the selected collection. To embed this map into an external web site the user only needs to copy the link at the address bar and include it at its own web site | ||
+ | * **Select the collection** - This button selects the collection represented by the current selected line in the list so that the POIs are visualized at the map (Note: The currently selected collection is permanently labeled at the //Active collection// | ||
+ | * **Share the collection** - Initializes the process of sharing collections with friends. The dialog that pops up allows you to select the desired friends (see Tutorial for more information) | ||
+ | * **Create a new collection** - Creates a new collection, equal to the __New collection__ button at the tab toolbar at the upper left corner of the tab | ||
+ | * **Public collection** - Declares this collection as accessible to the public (Note: current state can be checked at the first column //Public//) | ||
+ | * **Private collection** - Declares this collection as accessible only by me or my shared friends | ||
+ | * **Modify collection** - Edit the initial parameters set at the moment of creation (including name and description of the collection) | ||
+ | * **Save modification** - Changes of collection properties are only persistent after you saved them by hitting this button (Note: Unsaved modification are illustrated with a red flag at the upper left corner of the accordingly attribute field) | ||
+ | * **Synchronize collection** - If the collection contains part of a public collection this button leads to the synchronization (update) of those imported POIs (**Attention**: | ||
+ | * **Export as XLS**: Initializes the download process of the selected collection as Microsoft Office Excel 97-2003 (.xls) file format | ||
+ | * **Delete selected collections**: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====Public collection==== | ||
+ | |||
+ | All collection that are accessible to the public are listed in this tab. Own collections can be shared with the public by using the __Share this collection__ button at the __My collections__ tab (see section __My collection__ for further information). Public collections comprehend 5 attributes including : | ||
+ | * **Public** - Parameter that indicates if a collection is available for the public | ||
+ | * **Nom** - Name of the collection | ||
+ | * **Description** - Field intended for plain text describing the collection | ||
+ | * **Owner** - Username of the creator of the collection | ||
+ | * **Creation date** - Creation date of the collection | ||
+ | |||
+ | ===Context menu=== | ||
+ | {{ : | ||
+ | The context menu of a public collection can be opened by a right mouse click on the collection entry. It contains all options that are available for those collection. | ||
+ | |||
+ | * **Select the collection** - This button selects the collection represented by the current selected line in the list so that the POIs are visualized at the map (Note: The currently selected collection is permanently labeled at the //Active collection// | ||
+ | * **Give me a link to this map** - Opens a map view element in a new window showing all POIs included at the selected collection. To embed this map into an external web site the user only needs to copy the link at the address bar and include it at its own web site | ||
+ | * **Import this collection into mine** - Initializes the import process to include the public collection to one of mine collection. The pop up dialog includes a combo box menu allowing to select one of mine existing collection in which the POIs of the public collection should be imported. (Note: If you want to create a new collection containing only the POIs of the public collection, you need to create a empty collection first) | ||
+ | |||
+ | |||
+ | ====Collection data==== | ||
+ | |||
+ | All POIs that are in the currently selected collection are listed in this tab. It includes several option as well as a text filter search function. The listing section contains 19 columns displaying attribute values for each POI. If you want to scroll through POI entries you can use the browsing toolbar located at the bottom of the page. Each column is headed with a filter field allowing to filter the entire collection by the appropriate field. The listing section contains the following 19 columns: | ||
+ | |||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * {{: | ||
+ | * **Image** - Image attached to the POI | ||
+ | * **Status** - Classification of geocoding result (10 = manually verified, 9-6 good - satisfying), | ||
+ | * **Ratio** - Auto-Evaluated ratio of the geocoding result (1= maximal similarity between matching and input address, 0 = very low similarity) | ||
+ | * **Nom** - Name of the POI | ||
+ | * **Description** - Plain text description of the POI | ||
+ | * **Matching address** - Address assigned by the geocoding process | ||
+ | * **Number** - House number of the appropriated | ||
+ | * **Street** - Street name of the appropriated | ||
+ | * **Zip** - Postal Code of the appropriated POI | ||
+ | * **Locality** - Name of the Locality of the appropriated POI | ||
+ | * **Easting** - Horizontal coordinate of the appropriated POI | ||
+ | * **Northing** - Vertical coordinate of the appropriated POI | ||
+ | * **Lon** - WGS84 Longitude coordinate of the appropriated POI | ||
+ | * **Lat** - WGS84 Latitude coordinate of the appropriated POI | ||
+ | * **Type** - Type of POI (Hotel, Restaurant, monument, etc. ) | ||
+ | |||
+ | ===Toolbar menu=== | ||
+ | {{ : | ||
+ | |||
+ | The toolbar of the // | ||
+ | * **Save** - Save all POIs persistently (**Note**: unsaved changes of POIs are marked with a red upper right corner) | ||
+ | * **Geocode all** - (Re-)Launches the geocoding process for all POIs comprehended in this collection | ||
+ | * **Import data** - Opens the dialog for importing POIs from Excel file formatted lists. | ||
+ | * **Synchronize collection** - Launches the synchronization process that updates all imported POIs (**Note**: Successively edited POIs from public collections will be overwritten, | ||
+ | * **POI actions** - Opens a sub menu containing all available actions for the currently selected POI. (see context menu of POI entries) | ||
+ | * **Filters** - Apply filters on the list of POIs (Choose between show all POIs, show only non-geocoded POIs or show only POIs with bad auto-evaluated results) | ||
+ | * **Textual Filter** - Filters the entire collection by searching the names for the entered text or characters | ||
+ | * **Edit mode** - Check box for switching between editing and none editing mode (**Note**: Single POI can be changed without enabling editing mode) | ||
+ | |||
+ | ===Context menu of POI entries=== | ||
+ | |||
+ | {{ : | ||
+ | The context menu of POIs can be opened by hitting the right mouse button on a POI line or by using the __POI actions__ button. The following options are available at the context menu: | ||
+ | |||
+ | * **Edit the line** - Launches the editing mode for this single line. You can change the position of the POI manually be click and drag the POI to the new position on the map. To save your changes persistently you need to save your POIs after you finished editing. (**Note**: Attribute values like //name// or // | ||
+ | * **Center on the map** - Changes the extent of the map so that the POI is located at the center | ||
+ | * **Give me a link to this point** - Opens a new browser tab including a map view element showing **only** the selected POI. (**Note**: To get a map element showing the entire collection you need to use the //Give me link to the map// function at the __My collection__ tab) | ||
+ | * **Flag as verified** - Marks the selected POI as manually verified resulting with auto-evaluating //Status// " | ||
+ | * **Delete selected lines** - Deletes the selected POI | ||
+ | * **Geocode the selected lines** - Launches the geocoding process for the selected line | ||
+ | * **Edit the position** - Starts the editing mode for the selected POI (**Note**: If you want to save your changes persistently, | ||
+ | * **Add an image** - Adding an image file to the POI (**Note**: The image can be shown at the tool tip of the POI by selecting the " | ||
+ | * **Remove an image** - Remove the image file associated with the POI | ||
+ | * **Import the selected lines into a collection** - Opens the export dialog where you have to choose the destination collection | ||
+ | |||
+ | |||
+ | ====Available styles==== | ||
+ | |||
+ | All available style for the selected collection are listed in this tab. The toolbar of the //Available styles// tab includes one sub menu and one button. The listing section contains five columns. The following attribute fields are defined for styles: | ||
+ | * **On screen** - Check box to set the currently used style | ||
+ | * **Default** - Check box to set the currently used default style | ||
+ | * **Nom** - Name of the appropriate style | ||
+ | * **Description** - Plain text description of the currently appropriated style | ||
+ | * **Owner** - Username of the creator of the style | ||
+ | |||
+ | **Note**: Styles are connected to selections, this leads to the fact that styles cannot be accessed via other collections | ||
+ | |||
+ | ===Toolbar of the POI styles tab=== | ||
+ | {{ : | ||
+ | |||
+ | The toolbar of //Available styles// tab is located between the tab bar and the list section. It contains one sub menu and one button. The following options are available at the toolbar: | ||
+ | |||
+ | * **Styles actions** - Opens the context menu of the styles including all available options {{ : | ||
+ | * **Save Modification** - You need to save your changes manually after editing the styles parameter at the listing section. You can edit the attribute values of the listing section by double clicking the appropriate field. (**Note**: Unsaved changes are marked with a upper left red corner of the attribute field ) | ||
+ | |||
+ | |||
+ | ===Context menu of the POI styles=== | ||
+ | |||
+ | The context menu of the available style of a collection can be opened by hit the right mouse button or the __Styles actions__ button at the toolbar. The context menu of a style includes the following two options: | ||
+ | * **New style** - Opens a dialog allowing to define new style by indication name and description and format style parameters | ||
+ | * **Modify symbol** - Opens the style parameter dialog where all parameters can be changed. After changing parameter you have to save your changes by hitting the __Save Modification__ at the toolbar or the __Save the symbol definition__ at the style dialog window. | ||
+ | |||
+ | ===Symbol definition dialog=== | ||
+ | |||
+ | The symbol definition dialog can be accessed by hitting the __Modify symbol__ button at the context menu of an existing style **or** by creating a new style with the __New style__ button at the toolbar of the //Available styles// tab or the context menu of the listing section. | ||
+ | |||
+ | {{ : | ||
+ | * **Symbol** - Allows to define a unique symbol for all POIs | ||
+ | * **Symbol Name** - Open the symbol chooser dialog by hitting the __Choose symbol__ button. You can choose between PNG image files, predefined system symbols (mapserver symbols) or user symbols. To add a new user symbol you can choose the **Add new user symbol** at the left //Symbol tree// | ||
+ | * **Couleur de remplissage** - Fill color of the symbol (only needed in case of system symbols) | ||
+ | * **Couleur de la ligne** - Color of symbol lines (only needed in case of system symbols) | ||
+ | * **Taille** - Size of the symbol or image in Pixel | ||
+ | * **Outline width** - Width of the symbol lines (only needed in case of system symbols) | ||
+ | * **Angle** - Rotation of the image or symbol in degrees(°) | ||
+ | * **Categorized** - Allows to evaluate classification rules to categorized your POIs. You can select a attribute field name the the first line of the tab. The listing section above the combo box menu shows you the available values for the selected attribute field. If you choose a system symbol you can hit __Automatically fill__ to generate automatically a color ramp assigning each attribute value a unique color. Or you define manually for each category of POIs a specific symbol by selecting the desired symbol and define the symbol at the lower part of the tab (analogue to the //uniqie symbol// definition tab). | ||
+ | * **Etiquette** - Allows to add a dynamic label to your POI | ||
+ | * **Label column** - Define the attribute field name that includes the values you want to show (e.g. Name of POI) | ||
+ | * **Show Label** - Check this box to show the label at the map | ||
+ | * **Max scale** - Define a maximal scale to which your labels will be displayed. If the user choose a bigger scale the labels will **not** be visualized. | ||
+ | * **Couleur de remplissage** - Fill color of the text | ||
+ | * **Couleur de la ligne** - Outline color of the text | ||
+ | * **Size** - Text size | ||
+ | * **Angle** - Rotation of the text | ||
+ | * **Offset x, y** - Horizontally (x) or vertically (y) offset of the text. **Note**: If x,y offset are 0, the label will placed at the upper left of symbol. Moving rules: (negative values are allowed) | ||
+ | * To the right -> increase the x value | ||
+ | * To the left -> decrease the x value | ||
+ | * Up -> increase the y value | ||
+ | * Down -> decrease the y value | ||
+ | * **General information** - Set or change general information about the style like name or description. **Note**: You entered this properties at the first dialog when you create a new style | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ====Available tool tips==== | ||
+ | |||
+ | Tool tips are the small windows including additional information that pops up when users click on a POI. All available tool tips are listed at the __Available tooltips__ tab. This tab is very similar to the //Available style// tab and includes a toolbar with a sub menu button and a listing section comprehending two columns. The following attribute fields are available: | ||
+ | * **Default** - Check box that allows setting the tool tip of the selected collection | ||
+ | * **Nom** - Name of the tool tip | ||
+ | |||
+ | ===Toolbar and context menu of POI tool tips=== | ||
+ | |||
+ | The toolbar of the tool tip tab contains only one single sub menu button that is including the context menu of the selected tool tip. The context menu contains two options: | ||
+ | * **New tooltip** - Opens the new tool tip dialog allowing to define the name and the content of the tool tip | ||
+ | * **Modify tooltip** - Opens the currently selected tool tip and allows to edit the content | ||
+ | ==== Geocoding List==== | ||
+ | |||
+ | The history of all ongoing and completed geocoding processes is listed here. The Toolbar contains one button invoking a refreshment of the list. The listing section of this tab contains four columns: | ||
+ | * **start_date** - Date and time when the geocoding process was launched | ||
+ | * **end_date** - Date and time when the geocoding process was completed | ||
+ | * **launcher** - Name of the user that started the process | ||
+ | * **cnt** - Count of POIs that are/were geocode during the process | ||
+ | ===== Tutorials ===== | ||
+ | |||
+ | ====How to create a new collection==== | ||
+ | |||
+ | - Select the __My collection tab__{{ : | ||
+ | - Create a new collection by using the __New collection__ button at the toolbar or by right clicking in the listing section{{ : | ||
+ | - Enter collection parameter | ||
+ | - Enter the name of your collection | ||
+ | - Enter a description of the collection | ||
+ | - Click __Create__{{ : | ||
+ | - After the successful creation of your new collection, a new line was added to your list of collections. {{ : | ||
+ | |||
+ | **Note:** The first attribute //Public// is set to //false// by default. This means that your collection is __not__ public, only you can see it for the moment. Learn how to share your collection with friends or the public ([[http:// | ||
+ | |||
+ | |||
+ | ====How to create manually new POI==== | ||
+ | |||
+ | - Select the desired collection at the __My collection__ tab by the context menu (right mouse click) of the appropriate collection{{ : | ||
+ | - Change to the __Collection data__ tab by double clicking the selected collection at the listing section of the __My collection__ tab **or** | ||
+ | - Open the context menu on the map at the location of the new POI and click the __Create a POI here__{{ : | ||
+ | - Enter additional Attribute fields like Name, Description, | ||
+ | - A new line is added at the listing section of the __Collection data__ representing the new POI{{ : | ||
+ | |||
+ | **Note**: To change a attribute value of a POI you can access the attribute window by clicking __Edit this line__ at the context menu of the appropriate POI at the listing section | ||
+ | ====How to visualize my collection on the map==== | ||
+ | |||
+ | - To set or change the visualization of POIs you need to selected the appropriate collection first{{ : | ||
+ | - Change to the __Available styles__ tab{{ : | ||
+ | - Create a new style by clicking __Styles actions__ at the toolbar and __New Style__ at the sub menu **or** edit an existing style by clicking __Modifiy symbol__ at the context menu of a style at the list{{ : | ||
+ | - Define a unique symbol or categorized symbols and labels for the POI of the selected collection **and** click __Save the symbol definition__{{ : | ||
+ | - Close the symbol definition dialog by clicking the X at the top right of the dialog (Don't forget to save your definition by clicking __Save the symbol definition__){{ : | ||
+ | - After the successful definition of the visualization of a collection you need to verify if the style is selected at the //On screen// attribute field at the listing section of the __Available styles__ tab{{ : | ||
+ | - The visualization of your POIs is now set or changed and should be visible at the map{{ : | ||
+ | |||
+ | ====How to add a tool tip to my collection on the map==== | ||
+ | |||
+ | - [[http:// | ||
+ | - Change to the __Available tooltips__ tab{{ : | ||
+ | - Open the tool tip formatting dialog by creating a new tool tip by using the __Tooltips actions__ or the context menu of the listing section **or** edit an existing tool tip by using the __Modify tooltip__ function of the context menu of the specific tool tip{{ : | ||
+ | - Enter a name and the title of the tool tip. The name will only used to identify the tool tip definition. The title represents the title of tool tip which will be visible when the window pops up{{ : | ||
+ | - Define the (static) content of the tool tip at the //Text// field.{{ : | ||
+ | - Placeholders represent variables that are filled dynamically with the POI specific content (like names, addresses, user specific field values, etc). You can add those information by adding a placeholder represented by the name of the attribute field name. On the right of the text field toolbar you can find a combo box menu containing all attribute fields available at the **__current selected__** collection. By clicking on the desired attribute you add a ${name_of_the_attribute} representation of the value in the text field, the specific POI value will be entered here dynamically at the moment when the user opens the POI. If you added images to your POIs you can add them here by using the //image// object at the list{{ : | ||
+ | - Click __Create the tooltip__ when your finished and you want to save your settings{{ : | ||
+ | - Check if you have set the right check box at the //Default// column at the __Available tooltips__ tab{{ : | ||
+ | - When you click now on one of your POIs the customized tool tip will pop up and show the additional information for your POI{{ : | ||
+ | ====How to import POI from my excel file==== | ||
+ | |||
+ | - To import POIs from a Excel file you need to [[http:// | ||
+ | - Select the __Collection data__ tab{{ : | ||
+ | - Open the import dialog by clicking on the __Import data__ button{{ : | ||
+ | - By clicking on __Select a File__ a //File Upload// dialog pops up, you can now browse to the folder with the Excel file and select it, by clicking on __Open__ you set the path to the local file{{ : | ||
+ | - Click __Next__ at the //Import file// dialog | ||
+ | - Now you have to indicate which column should be assigned to which attribute field. This can be done at the third column of the listing section by clicking on the empty field.{{ : | ||
+ | - Open the list with possible attribute assignments and select the appropriate value. At the address field you have to indicate the form how the address is structured **and** click __Next__. The following address structures are supported: | ||
+ | - **All address attributes** are stored in **separated fields** (assign the single values to appropriated fields) | ||
+ | - **House number & street name** are stored in **one field** | ||
+ | - **Postal code & locality** are stored in **one field** | ||
+ | - **Entire Address** is stored in **one field**{{ : | ||
+ | - Provide additional information by checking the boxes in matching cases{{ : | ||
+ | - If you checked the //Geocode the address// box you will get ask if you want to do this now. Click __Yes__ if you want to launch geocoding now **or** __No__ if want to start the process later manually. Successively you will get ask if you want to geocode the lines that have been manually move or verfied, click __Yes__{{ : | ||
+ | - Automatically the application will jump to the __Geocoding list__ | ||
+ | - The //Status// attribute at the listing section of the __Collection data__ tab gives you information about the auto-evaluation of the geocoding result for each POI. The following status codes are possible: | ||
+ | - **10-9**: Manually verification of the POI by the user (is considered as correct!!) | ||
+ | - **8**: Good geocoding evaluation (Matching address identical to the geocode address) | ||
+ | - **7-6**: Partial matching of addresses (strings of characters are identical) | ||
+ | - **5**: Bad geocoding result | ||
+ | - **999**: Error code. Geocoding was not possible (Hint: Maybe the needed address attributes weren' | ||
+ | - All POI are now visualized at the map, excepts the POI with the 999 status code. You can verified the POIs now manually **and** in case of mis-geocoding you can edit the POI manually by clicking | ||
+ | |||
+ | **Note**: Only complete addresses can be geocoded successfully. A complete address contains house number, street name and name of locality and optionally the postal code | ||
+ | ====How to import POI from a (public) collection==== | ||
+ | - Select the desired collection at the __My collection__ tab by the context menu (right mouse click) of the appropriate collection{{ : | ||
+ | - Change to the __Public collections__ tab{{ : | ||
+ | - Select a entire collection **or** select a single POI in a collection and choose __Import this collection into mine__ respectively __Import the selected lines into a collection__ to open the //Import wizard//{{ : | ||
+ | - Choose the destination collection from the combo box list at // Existing collection// | ||
+ | - You can check now the destination collection and you will see that the POI are imported | ||
+ | **Note**: You can import POIs not only by public collection but also from your own collection (copy from collection A to collection B) or from a collection shared with friends. The procedure is analogue | ||
+ | |||
+ | **Note**: Importing POIs means creating a copy, if you want to update your imported POIs later you have to hit the __Synchronize collection__ button. **Attention**: | ||
+ | ====How to share my collection==== | ||
+ | |||
+ | - Select a collection at the __My collection__ tab{{ : | ||
+ | - You can share your collection with the public or with your friend | ||
+ | - Share with the public | ||
+ | - Hit the __Public collection__ button at the context menu of the collection you want to share{{ : | ||
+ | - Share with friends | ||
+ | - Hit the __Share collection__ button at the context menu of the collection you want to share, this will open the //Rights for the collection// | ||
+ | - You can add or delete users with the toolbar located above the listing section of this dialog. To Add a new user hit the __New user__ button, this leads to the attachment of a new line at the listing section{{ : | ||
+ | - Click the empty field in the //Nom d' | ||
+ | - The red corners of at the listing section are showing that there are unsaved modifications, | ||
+ | - To close the window you can hit the X button in the upper right corner{{ : | ||
+ | |||
+ | ====How to include my collection on my web site==== | ||
+ | |||
+ | - Select the desired collection at the __My collection__ tab {{ : | ||
+ | - The context menu of a collection or a single POI contains a __Give me a link to this map__ respectively __Give me a link to this point__ function{{ : | ||
+ | - A new browser window will open with a new map element showing the collection or the single POI{{ : | ||
+ | - If you want to include this map into your own website you can copy the source code of this new window into your own web site code | ||
+ | - At your < | ||
+ | - At your < | ||
+ | |||
+ | |||
+ | |||
+ | ======= Testing of the poi Manager ======= | ||
+ | |||
+ | ====== Tab: My Collection ====== | ||
+ | |||
+ | ==== Create new collection ==== | ||
+ | |||
+ | * Create new collection by hitting the "new collection" | ||
+ | * Entering Name and Description of the new collection | ||
+ | * Save attributes by hitting " | ||
+ | * **OBSERVATION**: | ||
+ | * **FINAL STATE**: Successful. | ||
+ | * **FINAL COMMENT**: None. | ||
+ | |||
+ | ==== Share my collection with friends ==== | ||
+ | * Open user selecting dialog by hitting the "Share the collection" | ||
+ | * By the hitting the "New User" button a new entry can be created | ||
+ | * Selected one user from the combo box in the user field | ||
+ | * **ERROR**: Rights cannot be changed | ||
+ | * Saving the new list of users by hitting " | ||
+ | * Closing the dialog by hitting the " | ||
+ | * **FINAL STATE**: Collection is successfully shared with other users | ||
+ | * **FINAL COMMENT**: Improvement of user experience possible by adding a search function for users as well as organizing user in groups leading to the possibility of sharing common project with professional or social groups | ||
+ | |||
+ | ==== Share my collection with public ==== | ||
+ | * Using the " | ||
+ | * **ERROR**: The attribute in the " | ||
+ | * **ERROR** Button "give me a link" should be grayed out when collection is private. | ||
+ | * **FINAL STATE**: Not successful. | ||
+ | * **FINAL COMMENT**: None expects the error. | ||
+ | |||
+ | ==== General observations ==== | ||
+ | * < | ||
+ | * **SOLUTION**: | ||
+ | * **ERROR**: The selected POI symbol of a collection remains on the screen after a switch between two collections | ||
+ | * **ERROR**: When I delete the selected collection the map has to be refreshed, otherwise the collection is still visible at the map till the map is refreshed by panning or zooming | ||
+ | * **COMMENT**: | ||
+ | |||
+ | ====== Tab: Public collections ====== | ||
+ | |||
+ | |||
+ | ==== General observations ==== | ||
+ | * Selecting a collection works. | ||
+ | * Getting the link of the map works. | ||
+ | * Importing to one of mine collection works. | ||
+ | * Synchronizing a public collection in one of mine collection works. | ||
+ | |||
+ | |||
+ | |||
+ | ====== Tab: Collection data ====== | ||
+ | |||
+ | ==== Create POIs manually by address ==== | ||
+ | * Manual creation of a new POI by hitting the " | ||
+ | * **OBSERVATION**: | ||
+ | * Input of the address of my new POI, as well as some additional attributes like URL, Description, | ||
+ | * Save values by hitting " | ||
+ | * POI is successfully created | ||
+ | * Launching of the geocoding process by hitting " | ||
+ | * **OBSERVATION**: | ||
+ | * **FINAL STATE**: Successful. | ||
+ | * **FINAL COMMENT**: Improvement of intuitive user experience possible. | ||
+ | |||
+ | ==== Create POI manually by placing it on map ==== | ||
+ | |||
+ | * Manual creation of a new POI by hitting the " | ||
+ | * Manual positioning of the POI on the map to the location i want to create my POI | ||
+ | * Entering additional attributes like name, desciption, ... | ||
+ | * Save values by hitting " | ||
+ | * POI is successfully created | ||
+ | * Launching of the geocoding process by hitting " | ||
+ | * **OBSERVATION**: | ||
+ | * **FINAL STATE**: Not successful. | ||
+ | * **FINAL COMMENT**: Reverse geocoding not completed. | ||
+ | |||
+ | |||
+ | ==== Import new POIs defined in a EXCEL file ==== | ||
+ | |||
+ | * Creation of a dummy excel file | ||
+ | * Create a new collection at the " | ||
+ | * Import EXCEL file by " | ||
+ | * **ERROR**: Geocoding of the imported POIs failed. Error code 999 (Error occurred during geocoding). No detailed information. | ||
+ | * **OBSERVATION**: | ||
+ | * **GUESS 1**: Format of the EXCEL table was wrong. | ||
+ | * **TRY**: Create manually a single POI without geocoding and export to xls-file to get the required format. | ||
+ | * **OBSERVATION**: | ||
+ | * **GUESS 2**: XLS-file locked by excel. Reading of xls file not possible | ||
+ | * **TRY**: Closing excel. | ||
+ | * **OBSERVATION**: | ||
+ | * **FINAL STATE**: Not successful. | ||
+ | |||
+ | |||
+ | ==== Editing a existing POI by activating "Edit mode" ==== | ||
+ | * Check "Edit mode" combo box | ||
+ | * Selecting an entry in the collection data tab | ||
+ | * Manually editing of the POI position on the map | ||
+ | * < | ||
+ | * < | ||
+ | * < | ||
+ | * **NOTE**: I discovered the " | ||
+ | * Saving the new POI coordinates by hitting the " | ||
+ | * **FINAL STATE**: Successful. | ||
+ | * **FINAL COMMENT**: Improvement of intuitive user experience possible -> placing the " | ||
+ | |||
+ | ==== Editing a existing POI without activating the "Edit mode" ==== | ||
+ | * Selecting an entry in the collection data tab | ||
+ | * Hit "Edit the position" | ||
+ | * **OBSERVATION**: | ||
+ | * Moving the blue point to the new position of the POI | ||
+ | * Saving the new POI coordinates by hitting the " | ||
+ | * **FINAL STATE**: Successful. | ||
+ | * **FINAL COMMENT**: Improvement of intuitive user experience possible -> placing the " | ||
+ | |||
+ | ==== General observations ==== | ||
+ | |||
+ | * **ERROR**: hitting POI actions -> //add image// leads to no reaction. I guess the button hyperlink is not set. | ||
+ | * < | ||
+ | * **QUESTION**: | ||
+ | * **NOTE**: Filtering works | ||
+ | * **NOTE**: majority of "POI actions" | ||
+ | * **COMMENT**: | ||
+ | * **COMMENT**: | ||
+ | * **ERROR**: When I select a Attribute field name at the Import file dialog and go back by " | ||
+ | * **COMMENT**: | ||
+ | |||
+ | ====== Tab: Available styles ====== | ||
+ | |||
+ | ==== Create new style ==== | ||
+ | * Creating new style by clicking the "New Style" button of the "Style actions" | ||
+ | * Entering name and description | ||
+ | * **OBSERVATION**: | ||
+ | * Selecting a single symbol for all POIs by defining the symbol at the " | ||
+ | * Saved and applied the style by hitting the "Save the symbol definition" | ||
+ | * Defined categories of symbols at the " | ||
+ | * Chose a attribute field containing the attribute that should be categorized | ||
+ | * Defined a symbol for each category or select " | ||
+ | * Saved and applied the style by hitting the "Save the symbol definition" | ||
+ | * Set a label by selecting a attribute field at the " | ||
+ | * Defined different maximal scales | ||
+ | * **FINAL STATE**: Successful. | ||
+ | * **FINAL COMMENT**: | ||
+ | * Single symbols and categorized symbols shouldn' | ||
+ | * " | ||
+ | |||
+ | ==== General observations ==== | ||
+ | * **ERROR**: If I cancel the creation of a new style at the style definition dialog by hitting the " | ||
+ | * **ERROR**: Symbol definition dialog - SVG symbols looks similar to PNG excepts the name. But they are not shown at the map? Looks like the files would not exists. | ||
+ | |||
+ | |||
+ | ====== Tab: Available tooltips ====== | ||
+ | |||
+ | * Creating a new tool tip by hitting the "New tooltip" | ||
+ | * Entering the name and title of the tool tip | ||
+ | * **COMMENT** Title field supports only static input | ||
+ | * Defining the body part of the tool tip with static and dynamic context, attribute values are inserted by a combobox menu filled with all attribute field names | ||
+ | * Different formatting orders on static and dynamic text tested | ||
+ | * **FINAL_STATE**: | ||
+ | * **FINAL_COMMENT**: | ||
+ | * **ERROR** Uploaded images cannot be shown in tooltip : internal server error (tried with GIF and PNG) | ||
+ | |||
+ | ====== Tab: Geocoding list ====== | ||
+ | |||
+ | * **NOTE**: Nice to have. | ||
+ | * **ERROR**: When the " | ||
+ | * **FINAL_STATE**: | ||
+ | * **FINAL_COMMENT**: | ||
+ | |||
+ | ====== Application ====== | ||
+ | |||
+ | * **ERROR**: When I change the spatial reference system to UTM or WGS84 the " | ||
+ | * **NOTE**: The current way of notification which collection is active doesn' | ||
+ | * **COMMENT**: | ||
+ | * **ERROR**: Geocoding is not correct with an address containing year numbers. E.g. "1, place des sacrifies 1940-1945 L-4115 ESCH-SUR-ALZETTE" | ||
+ | * **COMMENT** Translations should be rechecked | ||
+ | * **COMMENT**: | ||
+ | ====== Fiche "POI Manager" | ||
+ | |||
+ | * Point 9: Select a POI from the list leads to select it automatically on the map. Selecting a POI from the map should result in selecting this item in the list and center at this item, this is not working or supported. | ||
+ | |||
+ | |||
+ | |||