Difference between revisions of "Editing locations in the location catalog"

From InfoEx Help Information
Jump to navigation Jump to search
(Functionality tested by)
(Step-by-step description)
Line 32: Line 32:
 
{{Issue|Sometime the menu options in the location tree do not seem to be enabled.<br/>''Workaround'': Leave the location catalog page and return to it or completely restart the browser. |IssueWithImage|841|Sept. 22, 2013}}
 
{{Issue|Sometime the menu options in the location tree do not seem to be enabled.<br/>''Workaround'': Leave the location catalog page and return to it or completely restart the browser. |IssueWithImage|841|Sept. 22, 2013}}
 
|-
 
|-
|class="StepNum" | 5.  
+
|class="StepNum" | 5.
|
+
|Edit any of the information in the fields at the top of the pop-up window:
 +
* '''Name''' (required): Full name of the location
 +
* '''Abbreviation''' (required): Abbreviation to be used for the location in the tabular InfoEx reports.
 +
* Description: Detailed description of the location
 +
* External ID: The external ID of a location is required if your operation submits their observations from an external database system via the API (see [[How to submit observation to the InfoEx via the CAAML 3.0.3 API]] for more information). The external ID is also required for location that already existed in the legacy CAAML driven InfoEx and have historic observation associated with them.
 +
* Elevation (weather site only): Elevation of weather site in meters.
 +
{{Note|Since locations are primarily referred to by name in the InfoEx system, it is not advisable to create multiple location of the same type with the same name. However, the system currently does not explicitly check for it.|NoteNoImage}}
 +
|-
 +
|class="StepNum" | 6.
 +
|Add an appropriate geometry to the location. See [[Location types and symbology]] for details on the supported geometries for the different location types.
 +
 
 +
There are currently two options for adding geometries to a location:
 +
* '''Entering the geometry directly using the available drawing tools'''.<br/>See [[Entering the geometry of a location using the available drawing tools]] for more details on this method.
 +
* '''Importing the geometry from a Google Earth KML file'''.<br/>See [[Importing the geometry of a location from a KML file]] for more details on this method.
 +
{{Issue|Drawing directly in the Google Earth map has not been implemented yet|IssueNoImage|132|Sept. 22, 2013)}}
 +
|-
 +
|class="StepNum" | 7.
 +
|Click on {{ButtonGrey|Add}} to add the new location to the location tree of the operation. This will close the pop-up window and add the new location to the location tree.
 +
{{Issue|Even though the information for the new location is committed to the system, the pop-up window does not always close.<br/>''Workaround'': After clicking on {{ButtonGrey|Add}}, click on {{ButtonGrey|Cancel}} to close the window.|IssueNoImage|795|Aug. 24, 2013}}
 +
{{Issue|The main Google Earth map currently does not instantly update after any edits to the location catalog.<br/>''Workaround'': To see the newly added location, exit the location catalog page of the application (e.g., go to reports) and come back to the location catalog page to refresh it.|IssueNoImage|831|Sep. 22, 2013}}
 +
|}
 
|}
 
|}
  

Revision as of 20:02, 21 October 2013

REQUIREMENTS
Permission Operation Administrator or higher
Connectivity Online only

This document describes how to edit locations in the location catalog of your operation.

Background

The ability to edit locations and delete obsolete location from your from the location tree of an operation should allow users to main a clean catalog of relevant location at all time. However, please note that the editing locations affects all observations that have ever been associated with the given location. For example, if you change the location of a weather site, all associated historic observations will be moved to the new location. Similarly, when you change the name of a ski run, all of the associate historic avalanche observation will then be associated with the new name of the ski run.

We recommend the following guidelines for the maintenance of your location catalog:

  • Editing is appropriate for minor changes in the attributes (e.g., fixing of typos, name changes, minor adjustments of their geometries) of location that still represent the same piece of terrain. This approach will ensure that that time series (e.g., long-time observations at a weather site with a changing name) will be maintained.
  • If the geometry of a location changes considerable, it would be better to delete the location and create a new location under the same name. This approach will ensure that all observations associated with this location are displayed at their appropriate locations.

Step-by-step description

1.
Fig. 1: Administration menu for operation administrator
Select the Location Catalog from the administration menu (cog wheel) in the top left corner of the screen (Fig. 1). To have access to this menu item, you need to be either an operation administrator or a super user.
2.
Fig. 2: Location catalog screen
This will get you to the location catalog screen of the application (Fig. 2). Please note that depending on your connectivity and the size of your location catalog, it might take a while to start Google Earth and load your entire location catalog. The location catalog screen shows your location hierarchy tree on the right and a Google Earth map on the right.
ISSUE The system currently does not provide the user with any progress information about the loading of the location catalog.
JIRA: -834 (Aug. 26, 2013)
3. Expand the location hierarchy tree on the right as required by clicking on the little plus (+) signs left of locations that contain other locations.
ISSUE The order of locations within the location tree is currently somewhat random, which make it difficult to navigate through large location trees. It is intended that the locations within each location parent would eventually be sorted by location type and name to make navigation easier.
Workaround: See Searching for a location in your location catalog.
JIRA: -832 (Sept. 22, 2013)
4.
Fig. 3: Location edit popup window
Right click on the the location you would like to edit. This will open a small menu with an edit option. Select the edit option. This will open a pop-up window with a second Google Earth map that contains the existing information of the location and a maps that will immediately zoom to the area of the location (Fig. 3).
ISSUE Sometime the menu options in the location tree do not seem to be enabled.
Workaround: Leave the location catalog page and return to it or completely restart the browser.
JIRA: -841 (Sept. 22, 2013)
5. Edit any of the information in the fields at the top of the pop-up window:
  • Name (required): Full name of the location
  • Abbreviation (required): Abbreviation to be used for the location in the tabular InfoEx reports.
  • Description: Detailed description of the location
  • External ID: The external ID of a location is required if your operation submits their observations from an external database system via the API (see How to submit observation to the InfoEx via the CAAML 3.0.3 API for more information). The external ID is also required for location that already existed in the legacy CAAML driven InfoEx and have historic observation associated with them.
  • Elevation (weather site only): Elevation of weather site in meters.
NOTE Since locations are primarily referred to by name in the InfoEx system, it is not advisable to create multiple location of the same type with the same name. However, the system currently does not explicitly check for it.
6. Add an appropriate geometry to the location. See Location types and symbology for details on the supported geometries for the different location types.

There are currently two options for adding geometries to a location:

ISSUE Drawing directly in the Google Earth map has not been implemented yet
JIRA: -132 (Sept. 22, 2013))
7. Click on Add to add the new location to the location tree of the operation. This will close the pop-up window and add the new location to the location tree.
ISSUE Even though the information for the new location is committed to the system, the pop-up window does not always close.
Workaround: After clicking on Add, click on Cancel to close the window.
JIRA: -795 (Aug. 24, 2013)
ISSUE The main Google Earth map currently does not instantly update after any edits to the location catalog.
Workaround: To see the newly added location, exit the location catalog page of the application (e.g., go to reports) and come back to the location catalog page to refresh it.
JIRA: -831 (Sep. 22, 2013)

|}

Related documents

  • Link to relate document 1
  • Link to relate document 2

Functionality tested by

  • Oct. 21: Pascal Haegeli / QA Server / Test Version 0.31.00