6.5.2.1. Submitting a change request

A change request can be submitted by a Registry Contributor using specific modules depending on the nature of the request:

  1. Lists module for any type of request

  2. Explorer and Change Requests modules for any type of requests, except requesting for a new Geo-Object to be added

Submitting a request to add a new Geo-Object

A request to add a new Geo-Object can only be submitted by a Registry Contributor through the working version of the list for the relevant Geo-Object Type. This means that the Registry Contributor must have the curation role for that Geo-Object Type in order to submit such a request.

  1. Navigate to the Lists and Spatial Data module either from the homepage or the burger menu.\

  2. Click on the Geo-Object Type for which a new Geo-Object should be added:\

  3. Open the list set for which you want to submit a change request.\

  4. Open the working version of the list for one of the instances of the list set.\

  5. Once the list opens, click the Add Geo-Objects button in the top right.\

  6. If you have selected a Geo-Object Type Group (health facility for example), a dropdown menu will appear once you click on the Add Geo-Objects button. In this menu, select the Geo-Object Type for which you would like to submit a request to add a Geo-Object.\

  7. The Geo-Object creation view opens, with the panel on the left, allowing you to set the period of existence, the attributes, the parents in the concerned hierarchies, and the geometry of the new Geo-Object.\

  8. Start by specifying the period of existence (start and end date) of the Geo-Object and keeping the validity as "Valid”.\

  9. From there you can fill the information for the other tabs (Attributes, Hierarchies and Geometry). Please refer to the list of attributes that are mandatory when adding a new Geo-Object to proceed (this should be documented in the relevant data dictionary for the Geo-Object Type). Notes: (1) The temporal validity for the first instance of each attribute will have the same start and end date as the existence period specified under step 8. (2) The geometry of the Geo-Object can either be defined during the process described here or added by importing a shapefile (see section 6.5.1.1).

  10. Provide a reason for submitting the change request in the field at the bottom of the panel\

  11. Click the Submit A Change Request button. This results in the creation of the change request, which you can consult in the Change Requests module by clicking the View change request button in the message that appears.\

Submitting a change request for an existing Geo-Object

Submitting a change request to modify an existing Geo-Object can be done in four steps by the Registry Contributor with the curation mandate over the relevant Geo-Object Type:

  1. Open the Geo-Object in the editing view

  2. Capture the information you would like modify

  3. Specify the reason for submitting a change request

  4. Submit the change request

The Geo-Object-specific editing view can be reached by the Registry Contributor through three different modules in GeoPrism Registry:

  • Change Requests

  • Lists and Spatial Data

  • Explorer

The following subsections describe how to reach the editing view through each of these modules.

Reaching the Geo-Object editing view through the Change Requests module

This is the fastest way to reach the Geo-Object editing view when the Registry Contributor knows for which Geo-Object they want to submit a change request, without having to first look at the list.

  1. You will find the Submit a new change request section at the bottom of the screen that opens.\

  2. In this section, select the Geo-Object Type, specify the date for which you want to view the information associated with the Geo-Object, and the name of the Geo-Object (note: the options from which to choose will appear as you start typing the name of the Geo-Object and you can then choose from these options).\

  3. Click the View Geo-Object button. This will open the Geo-Object editing view.\

Reaching the Geo-Object editing view through the Lists and Spatial Data module

The Registry Contributor can choose this option when they are looking at a list for one of the Geo-Object Types for which they have the curation mandate, and see something that needs to be modified, completed or updated.

  1. Navigate to the Lists and Spatial Data module.\

  2. Click on the Geo-Object Type for which you need to submit a change request.\

  3. Open the list set for which you want to submit the request.\

  4. Open the working version of the list for one of the instances of the set.\

  5. In the list that has opened, search for the Geo-Object for which you want to submit a change request (for example by using the search functionality attached to each attribute).\

  6. This will open the Geo-Object on a map with a pop-up.\

  7. Click on the Edit button in the pop-up. This will open the editing view for the Geo-Object\

Reaching the Geo-Object editing view through the Explorer module

The Geo-Object editing view can be reached in two ways when using the Explorer module:

  1. By following an approach similar to the Change Request module. In this case, the Registry Contributor will use the search bar in the upper left of the Explorer module. Please note that this functionality does not require for the Geo-Object Type to be specified and does not give access to the dropdown of options as the name of the Geo-Object is being typed. As such, it might return a large number of Geo-Objects of different types.

  2. By accessing the Geo-Object editing view while looking at the spatial data for a specific Geo-Object Type over which the Registry Contributor has the curation mandate.

The following steps allow you to reach the editing view of a Geo-Object while looking at its geometry:

  1. In the Explorer module, with the layer for the Geo-Object Type of interest already displayed, click on the Geo-Object for which you want to submit a change request. This will display a pop-up for that Geo-Object.\

  2. Click the Edit button in the pop-up box. This will open the Geo-Object editing view:\

Capturing and submitting a change request to modify a Geo-Object

Once the Registry Contributor has reached the Geo-Object editing view through one of the channels described in the previous section, they can fill in and then submit a change request to modify an existing Geo-Object

To start this process, the Registry Contributor has to click on the Edit button located at the bottom of the Geo-Object panel (seeing the button might require to scroll down quite significantly depending on the number of attributes the Geo-Object has):\

From there, the Registry Contributor will be able to fill in and submit a change request for the Geo-Object, for the following changes:

  • Changing its period of existence

  • Changing its validity

  • Modifying the temporal validity (start/end date) of an attribute, parent in a hierarchy or the geometry

  • Adjusting the value of an attribute, parent in a hierarchy or geometry without changing the temporal validity of the information

  • Adding or deleting an instance of information for a given attribute, hierarchy, geometry or period of existence

To change the period of existence of a Geo-Object:

  1. Change the start or end date of the period of existence (note the orange frame that now appears around the Exist section in the panel, the current value appearing below the field for which the value has been changed, and the red dot appearing in the other tabs):\

  2. Adjust the temporal validity (start and end date) of the information captured in the other tabs to match the new period of existence of the Geo-Object. Once this is done, the dots on all the tabs will have turned orange\

  3. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  4. This results in the creation of the change request, which you can consult in the Change Request module by clicking on the View change request button in the message that appears.\

To change the validity of a Geo-Object:

  1. In the Validity section of the tab, change the value for the validity from "Valid" to "Invalid" (note the orange frame that now appears around the Validity section in the panel and the current value appearing below the field. In this case no dots appear for the other tabs as setting the Geo-Object as invalid has no impact on this information):\

  2. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  3. This results in the creation of the change request, which you can consult in the Change Request module by clicking the View change request button in the message that appears.\

To modify the temporal validity (start/end date) of an attribute, parent in a hierarchy or of the Geo-Object geometry:

  1. Open the relevant tab for the type of information you’d like to change the temporal validity for (attribute, hierarchical information or geometry):\

  2. Scroll to the instance of a(n) attribute/hierarchical information/geometry value you would like to change the temporal validity for. Adjust the start and end date for the instance using the designated date pickers. Also adjust the validity period of other instances of the same attribute/hierarchical information/geometry to remove any temporal validity overlaps and ideally gaps as well.\

  3. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  4. This results in the creation of the change request, which you can consult in the Change Request module by clicking the View change request button in the message that appears.\

To adjust the value of an attribute, parent in a hierarchy or geometry without changing the temporal validity of the information:

  1. Open the relevant tab for the type of information you’d like to change the value for (attribute, hierarchical information or geometry):\

  2. Scroll to the instance of a(n) attribute/hierarchical information/geometry value you would like to change. Adjust the attribute/hierarchical information/geometry.\

  3. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  4. This results in the creation of the change request, which you can consult in the Change Request module by clicking the View change request button in the message that appears.\

To add an instance of a given attribute, hierarchy or geometry or period of existence:

  1. Open the relevant tab for the type of information you’d like to add an instance for (attribute, hierarchical information or geometry).\

  2. Scroll to the attribute/hierarchical information/geometry value you would like to add an instance for and click on the + New instance link. In case this link is not visible, ensure ‘view all periods’ is toggled in the history bar.\

  3. Fill in the new instance with a value and provide a validity start and end date. Also adjust the validity period of other instances of the same attribute/hierarchical information/geometry to remove any temporal validity overlaps and ideally gaps as well. When adding instances of hierarchical information, the validity period must be entered first so GeoPrism Registry will only provide parent Geo-Objects that are valid for that period as options.\

  4. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  5. This results in the creation of the change request, which you can consult in the Change Request module by clicking the View change request button in the message that appears.\

To delete an instance of a given attribute, hierarchy or geometry or period of existence:

  1. Open the relevant tab for the type of information you’d like to delete an instance for (attribute, hierarchical information or geometry).

  2. Scroll to the attribute/hierarchical information/geometry value you would like to delete an instance for and click on the x button to the right of the instance. In case multiple instances are not visible, ensure ‘view all’ is toggled in the history bar. The to-be-deleted instance can be reversed by clicking on the reverse icon.\

  3. Specify the reason for submitting the change request in the Reason field and click the Submit A Change Request button.\

  4. This results in the creation of the change request, which you can consult in the Change Request module by clicking the View change request button in the message that appears.\

Change requests in the Change Request module can be edited by clicking on the Edit button at the bottom.\

Users can then directly edit their requested changes, in a similar fashion to in the Geo-Object editing view.

For change requests that require official documentation as evidence for the change, reference documents can be uploaded in the change request. While still in edit mode of the change request, click on Choose File under Reference Documents to browse for a file to attach, and click upload. Multiple documents can be attached to a change request.

Click on Update to finish editing the change request.\

Last updated