Configure District Energy Data Management

It turns ArcGIS into a system for district energy organizations to easily inventory their assets and keep information up to date. It provides simple to use interactive system maps and dashboards for office and field staff, and increases collaboration.

The District Energy Data Management solution can be configured to meet specific needs in your organization. The sections below outline some administrative tasks to update and manage the solution to fit your organization's needs.

Load data

In some cases, you may need to load existing data into the solution before sharing the maps or applications. Review the maps or applications provided with the solution and determine what, if any, source data you want to load. District Energy Data Management also includes a data model to store information about typical district energy system assets. To explore the schema, view the data dictionary.

Tip:

If you do have to load data into the solution, you may want to develop a source-target matrix to track how your source data will be loaded into the target layer or layers used in the solution.

Depending on the format of your source data, you may choose to append your source data to the new layers. Once you have determined what source data must be loaded, complete one of the data loading workflows below:

Use the Append tool

In ArcGIS Pro, the Append can be used to append multiple input datasets to an existing target dataset. Input datasets can be point, line, or polygon feature classes.

To append features to the target layer or layers using the Append tool, complete the steps below:

  1. In ArcGIS Pro, sign in to your ArcGIS organization.
  2. To open the District Energy Data Manager project, click Open another project, click My Content under Portal, double-click the District Energy Data Management folder, and click District Energy Data Manager.
  3. Add your existing source layers to a new map. To add the target feature layers from the DistrictEnergySystem feature service, click My Content under Portal, double-click the District Energy Data Management folder, and add the DistrictEnergySystem feature service to the map.
  4. On the Analysis tab, in the Geoprocessing group, click Tools to open the Geoprocessing pane.
  5. In the search bar, type Append and click to open the Append tool.
  6. Add your existing district energy data from the map to the Input Datasets parameter.
  7. For Target Datasets, use the DistrictEnergySystem features in the map.
  8. In the Schema Type parameter, use the drop-down menu to choose Use the Field Map to reconcile schema differences to perform field mapping.
  9. Update your field mapping and click Run.
  10. Repeat this process as needed to load all your existing data into the target district energy schema.

Use the Data Loading Tools

The Data Loading toolbox can be used in ArcGIS Pro to streamline loading data from a source to a target dataset and provide the ability to perform in-process data transformation. Setup the Data Loading toolbox before getting started with the steps below.

  1. Open the District Energy Data Manager project.
  2. On the Project tab, click Python to access the Python Package Manager.
  3. Under Project Environment, click Manage Environments.
  4. Click Clone Default Clone to clone your default environment.
  5. Click the Active button for the new environment, and click OK.
  6. Restart ArcGIS Pro to allow your environment changes to take effect.
  7. In the Python Package Manager, click Add Packages to see the Python packages available for installation.
  8. Click Refresh Refresh to update the list of available packages.
  9. In the Search box, type dltsolutions to find the Data Loading Tools toolbox.
  10. Select the dltsolutions package and click the drop-down arrow to update the version.
  11. Click Install.

    The Install Package dialog box appears.

  12. Review the terms and conditions and check the box to agree.
  13. Click Install to install the package.
  14. Once the installation is complete, close ArcGIS Pro.

    The Data Loading Tools toolbox is now installed. The next time you start ArcGIS Pro, you can access it from the geoprocessing toolboxes.

  15. Review An overview of the Data Loading toolbox to learn more about the tools and how to use them to load data into the DistrictEnergySystem layers.

Configure the District Energy Data Manager ArcGIS Pro project

The District Energy Data Manager project includes a District Energy Data Manager map with broken links.

  1. In ArcGIS Pro, sign in to your ArcGIS organization.
  2. To open the District Energy Data Manager project, click Open another project, click My Content under Portal, double-click the District Energy Data Management folder, and click District Energy Data Manager.
  3. In the Catalog pane, expand Maps and double-click District Energy Data Manager to open the map.
  4. In the Contents pane, click the red exclamation point Error next to the Map Notes layer.

    The Change Data Source dialog box appears.

  5. Click My Content under Portal, double-click the District Energy Data Management folder, double-click the MapNotes_managing feature service, and double-click the Map Notes layer.
  6. In the Contents pane, click the red exclamation point Error next to the Pump layer.

    The Change Data Source dialog box appears.

  7. Click My Content under Portal, double-click the District Energy Data Management folder, double-click the DistrictEnergySystem_editing feature service, and double-click the Pump layer.

    The data source is repaired for the remaining layers.

  8. In the Contents pane, right click the District Energy Data Manager map and click Properties.
  9. Click the Coordinate Systems tab. In the XY Coordinate Systems Available section select the coordinate system that matches the layers in the map.
    Note:

    Ensure the coordinate system of the map matches that of the feature layers deployed in the solution. If these do not match there may be discrepancies in what units are displayed in the map.

  10. Click Save to save the project.

Add members to groups in your organization

Included with District Energy Data Management are four groups designed to help managers organize their members based on their privileges and their work. The solution includes the following groups: District Energy Editors, District Energy Field Users, District Energy Map Notes Managers, and District Energy Office Users.

To add members to the groups, complete the following steps:

  1. In a browser, sign in to your ArcGIS organization.
    Verify that you have privileges to manage member groups before continuing.
  2. Click Groups at the top of the site.
  3. Click the name of the group to open the group details pages.
  4. On the Settings tab, edit and update the properties of the group, including access, sharing properties, and group ownership.
  5. Click the Overview tab and click Invite users.
  6. Select the members you want to add and click Add to group.
  7. Repeat steps 3 through 6 for each group you need to add members to.

The provided groups are intended to be utilized by members with a minimum of the following user types in order to fully use the provided maps and apps:

Group nameUser type

District Energy Editors

  • Editor
  • GIS Professional Basic with ArcGIS Pro (minimum of one license recommended)

District Energy Field Users

  • Mobile Worker

District Energy Map Notes Managers

  • Editor

District Energy Office Users

  • Editor

Set the default map extent to your service territory

When the District Energy Data Management solution is deployed into your organization, it uses the map default set in your organization. If this property has not been set, you may want to quickly update a few maps and apps to your service territory manually to avoid having to pan and zoom to your area each time you open a map. Follow the steps below to update the initial extent of the maps and apps provided with this solution.

  1. In a browser, sign in to your ArcGIS organization.
  2. To set the default map extent for the District Energy Viewer application, browse to the District Energy Viewer item page and click Edit Application.
  3. On the Map tab, zoom the map to the desired extent and click Use current map view under Set initial extent. Click Save.
  4. Repeat steps 2 and 3 to set the default map extent for the District Energy Editor and District Energy Map Notes Manager applications.
  5. To set the default map extent for the District Energy Asset Collector map, open the District Energy Asset Collector map.
  6. Zoom the map to the desired extent and save it.
  7. Repeat steps 5 and 6 for the District Energy Mobile Viewer map.

Configure the dashboard

When you deploy the District Energy Data Management solution to your organization you have the option to change spatial reference. If you selected a spatial reference with a linear unit other than meters, you will need to revise the dashboard by completing the following steps.

  1. In a browser, sign in to your ArcGIS organization.
  2. To set the default map extent for the District Energy Dashboard application, browse to the District Energy Dashboard item page and click Edit Dashboard.
  3. Navigate to the Pipes tab and click the configure button Configure on the Transmission Main indicator.
  4. On the Data tab, toggle-on the value conversion switch to expose the conversion settings. Change the Factor setting to the correct conversion.

    The dashboard Factor setting is configured to convert meters to other units. Learn more about how to Convert Values.

  5. On the General tab, click edit to modify the description. Update the description to the correct unit.
  6. Click Done to save your changes.
  7. Repeat steps 3 and 6 for each of the indicators on the Pipes tab.
  8. Click the save button Save.