Roadway Characteristics Editor deployment guide

To deploy the Roadway Characteristics Editor and supporting dataset, follow the steps below.

Note:

It is strongly recommended that you follow the steps in the order outlined.

1. Install Esri Roads and Highways for Server.

   For more information, see Installing Esri Roads and Highways for Server.

2. Create a map document (MXD) with the appropriate routes, event layers, and (optionally) redline layer using ArcGIS for Desktop and Esri Roads and Highways for Desktop.

   You can include the redline layer in the same map document or you can create a different map document just for redline. For more information, see Deploying redline routes. Make sure the redline feature class has its m- and z-values disabled.

3. Publish the map document with ArcGIS for Server and enable the Esri Roads and Highways for Server linear referencing capability.

   Assign the map service an appropriate name. This name will be displayed in the Roadway Characteristics Editor table of contents.

   Note:

   Prior to publishing your web map, you must remove all time definition filters from internal event layers, LRS Networks, intersection feature classes, and calibration points. Time filters can be added and removed on your desktop. To learn more, see Setting the time view for LRS data. The time setting in Roadway Characteristics Editor only applies to Roads and Highways layers. Other layers published in the Roadway Characteristics Editor map will not be impacted or changed as a result of the user changing the time view.

4. In step 2, if you have chosen to create a different map document for redline, publish the map document with ArcGIS for Server and enable feature access. To enable feature access, see Deploying redline routes.
5. Author a web map that includes the map services created in the previous steps and the appropriate basemaps.
6. Using Windows Explorer, browse to and copy the contents of <Installation location>\Server\Web\RoadwayCharacteristics into the web folder of the web server.

   For example, in Internet Information Services (IIS), the web folder may be located at C:\inetpub\wwwroot\RoadwayCharacteristics.

   Note:

   The actual location of the IIS wwwroot directory could differ on your server machine. Use the IIS Management Console to obtain the location of the IIS wwwroot directory.

   Note:

   Make sure all the .NET / ASP.NET features are enabled and installed for IIS. This can be done with the windows Server Manager console.

7. Open the configuration (config.json) file within the RoadwayCharacteristics web folder and modify it to use the web map and geoprocessing services created from previous steps. Optionally, you can choose to change some default administrative settings such as user authentication, map selection symbology, and attribute sets while modifying the configuration file. Use the following guides to deploy: Adding DGN and DWG data: Deployment guide, Producing attribute sets, and Deploying redline routes.
8. Optionally add the following configurations to the Roadway Characteristics Editor:
   • Enable security on ArcGIS Server to secure the map services being used within the Roadway Characteristics Editor web application.
   • Validate and correct your organization's event data by integrating ArcGIS Data Reviewer for Server with the Roadway Characteristics Editor web application.

Event IDs when adding or editing events

The Roadway Characteristics Editor requires an Event ID column in each of the event layers it is configured to edit. When new events are created by the Roadway Characteristics Editor, an event ID must be provided for each record. The Roadway Characteristics Editor can generate and provide event IDs if the Event ID column is a string and greater than 32 characters in length. It will generate a globally unique identifier (GUID) as a string and use that.

If the Event ID column is not a string greater than 32 characters, the application will not specify an event ID. If the database is not configured to generate a value, a null value will be stored. You can provide an event ID by placing this column in the attribute set used for the edit and provide a value, but this approach is not recommended because you would need to provide an event ID for each and every record, and the value must be unique.

Note:

If a null value is stored for an event ID, Roadway Characteristics Editor will not support editing the record.