Preserving Exchange Cluster Mappings Using the DB Editor
Use tools in the DB Editor to preserve active field mappings when updating exchange clusters.
Tutorial resources
These downloadable resources will be used to complete this tutorial:
Step-by-step:
Once you have created a GIS exchange cluster in anticipation of updating a model, you may need to update the exchange cluster to use a new GIS database. Instead of using the GIS Gateway, you can use a tool in the DB Editor to preserve the active field mappings. By editing the updated GIS data path using this method, the GIS field mapping will not be reset, which is what happens when you select a new GIS data source inside an existing GIS exchange cluster.
- Open the appropriate .aprx file in ArcGIS Pro.
- From the ribbon, InfoWater Pro tab, Project panel, click Initialize.
In this example, the GIS exchange cluster has already been configured for new pipe creation. To update the GIS exchange cluster:
- From the InfoWater Pro ribbon, Edit panel, select DB Editor.
- In the DB Editor, Data Table, select Advanced Application Data (for Advanced Users) > GIS Gateway Cluster.
- Click OK.
- In the DB Editor, expand the Database column width to view full file paths.
- In the Database column, adjacent to the PIPE_UPDATE exchange cluster, double-click the PIPE_UPDATE file path.
- Then right-click it and select Copy.
- In the Database column, double-click the PIPES file path.
- Then, right-click it and select Paste.
- Click Save.
- Click Exit.
To verify the changes:
- On the ribbon, InfoWater Pro tab, Edit panel, click GIS Gateway.
- In the GIS Gateway dialog, GIS Exchange Cluster section, select PIPES > Edit.
Note: In the GIS Exchange Cluster dialog, the GIS Data Source now displays the updated file path set in the DB Editor.
- In the Field Mapping tab, review the Networks/GIS Data Field Mapping list to verify that the field mapping remains in place: GIS Fields COMMENT, INSTALL_YR, MATERIAL, LENGTH, and DIAMETER should all be present.
By updating the file path in the DB Editor, these field mappings from the PIPE_UPDATE cluster are preserved. If the GIS data source were updated directly within the Exchange Cluster dialog, all the field mappings would be cleared, and all the fields would need to be remapped.
- Click OK to exit the Exchange Cluster dialog.
- Click Close to exit the GIS Gateway.