ArcMap

Configuring the Roadway Characteristics Editor (RCE) web application

Several properties can be configured in the Roadway Characteristics Editor (RCE) web application. Open the config.json file in the EventEditor web folder on the web server to modify and deploy.

Configuring the RCE web application is one of the steps (step 8 of 9) of the deployment process. Ensure that all steps before this are completed before continuing with configuring the RCE web application.

RCE configuration properties

PropertiesDescription

webmap

Specifies the unique ID or URL to an authored web map hosted on ArcGIS Online or the web server. After authoring a web map and sharing it publicly, the contents can be accessed directly by a URL.

For example, if the web map is hosted on ArcGIS Online, log in with your global account and browse to My Content. Click the title of the web map you are interested in to get more details. At this point, the URL looks like the following format: http://www.arcgis.com/home/item.html?id=<webmapID>.

For example: http://www.arcgis.com/home/item.html?id=1dcf369089804329946e3b3abf385251.

Ensure the web map is shared with everyone (public).

Copy only the ID portion of the URL as the web map ID value for the configuration. 

"webmap": "1dcf369089804329946e3b3abf385251",

If the web map is hosted on a server, the URL looks similar to the following: http://<HostName>/RoadwayCharacteristics/rwc.json, where rwc.json is the text file that contains the web map definition.

"webmap": "http://<Host Name>/RoadwayCharacteristics/rwc.json",

geometryServiceUrl

Specifies the URL to a geometry service. By default, the configuration file contains a link to the geometry service hosted on ArcGIS Online, but it can be configured to refer to any geometry service hosted on any other ArcGIS for Server instance.

banner

  • label
  • labelColor
  • backgroundColor

Specifies the banner label text, and label color and banner color. Below is the format for the banner label.

<Specified banner text here> - Esri Roads and Highways <version>
  • label—Banner label text. Only the prefix of the banner label can be changed. The default value is Roadway Characteristics Editor (RCE).
  • labelColor—Banner label color. The default color is e8e8e8.
  • backgroundColor—Banner color. The default color is 2f2f2f.

"banner": {
        "label": "My Roadway Characteristics Editor",
        "labelColor": "#e8e8e8",
        "backgroundColor": "#2f2f22"
    }

The color is specified as #RRGGBB in HTML hexadecimal color codes.

proxyUrl

Specifies the relative URL to the proxy page on the web server.

"proxyUrl": "proxy/proxy.ashx",

qcChecks

  • recordsPerPage

Specifies a setting for the Check Events widget.

recordsPerPage—Specifies the number of records per page within the results table for the Check Events widget.

versioning

  • allowReconcileAndPost
  • allowChangeVersions
  • allowCreateVersions
  • allowDeleteVersions
  • allowReconcileAndPost—Specifies whether the Reconcile & Post widget is visible to the user
  • allowChangeVersions—Specifies whether a user can change the geodatabase version.
  • allowCreateVersions—Specifies whether a person can create a new geodatabase version.
  • allowDeleteVersions—Specifies whether a person can delete an existing geodatabase version.
"versioning": {
        "allowReconcileAndPost": false,
        "allowChangeVersions": false,
        "allowCreateVersions": false,
        "allowDeleteVersions": false
    },

dataReviewer

  • serviceUrl
  • executeBatchJobUrl
  • productionWorkspace
  • batchJobWaitTime
  • recordsPerPage

Specifies the setting for Data Reviewer capability in the RCE. For more information, see Integrating Data Reviewer for Server. These are optional configuration settings if Data Reviewer integration is required.

  • serviceUrl—Data Reviewer map service URL.
  • executeBatchJobUrl—Data Reviewer geoprocessing service URL.
  • productionWorkspace— A path to a .sde connection file of the production workspace, the geodatabase of the data to be validated.
  • batchJobWaitTime—Specifies the amount of time, in milliseconds, to wait before time-out for batch job requests.
  • recordsPerPage—Specifies the number of records per page within the results table for the Reviewer Table widget.

"dataReviewer": {
    	"serviceUrl": "http://<server name>:6080/arcgis/rest/services/reviewer/MapServer",
    	"executeBatchJobUrl": "http://<server name>:6080/arcgis/rest/services/ExecuteBatchJob/GPServer",
     "productionWorkspace":"c:\\arcgisserver\\data\\arcsde_connection_file.sde"
     "batchJobWaitTime": 60,
    	"recordsPerPage": 25
}

Advanced propertiesDescription

portalUrl

The portal URL configured to use with the RCE. This could be an ArcGIS Online or Portal for ArcGIS URL.

This is used in portalGroup of the basemaps configuration

"portalUrl" : "http://www.arcgis.com/",

basemaps

  • portalGroup
    • owner
    • title
    • id
  • layers
    • url
    • title

Apart from the default custom basemap configured in webmap, you can add multiple custom basemaps to the RCE using the following methods:

  • Using an ArcGIS Online or Portal for ArcGIS group
  • Using the basemap layers URL

If an ArcGIS Online or Portal for ArcGIS group is configured, then, the default ArcGIS Online basemaps group will not be used. These are optional configuration settings.

  • portalGroup—Specifies a public portal group, which includes the basemaps that you want to use. You need to provide the owner and title of the group or ID of the group. The portal configured in the portalUrl is used. You need to configure the portalUrl to use this configuration.
  • owner—Specifies the owner on the group.
  • title—Specifies the title of the group from the ArcGIS Online or Portal for ArcGIS.
  • id—Specifies the ID of the group.
  • layers—Specifies the list of URL and title.
  • title—Specifies the title of the group.

"basemaps" : {
         "portalGroup" :{
                   "owner":"adminuser@yourorg.com",
                   "title':"<Basemap group title to find the group>",
                   "id':"<Basemap group id to find the group>"
        } ,
         "layers:  [
              {
                    "url": "http://server/arcgis/rest/map/MapServer",
                    "title": "<The title to display>"
               }, 
               ...  (any number of layer JSON blocks)            
         ]
    },

bingMapskey

Specifies the bing maps key to be used by your bing base maps. If you have used bing map as a default basemap in the webmap or configured it in the basemaps widget, then you need to provide this key.

For more information, see Adding bing maps as basemaps.

"bingMapsKey": "<your bing maps key acquired from microsoft>",

security

  • enabled
  • tokenServer
  • tokenExpiration

Esri Roads and Highways for Server supports secure login via the ArcGIS Server Security configuration on the published map service with linear referencing capability. This security is provided via the token service. These are optional configuration settings.

  • enabled—Specifies whether token authentication is enabled for the web application.
  • tokenServer—Specifies the host name of the server that has the ArcGIS token service. If enabled is set to false, this property is ignored.
  • tokenExpiration—Specifies the duration that a token is valid, in minutes. 

"security": {
        "enabled": false,
        "tokenServer": "http://roadsandhighwayssample.esri.com/arcgis",
        "tokenExpiration": 30
    },

addData

  • cad
    • uploaderUrl
    • gpServiceUrl

Specifies the URL for the Add Data tools. See more in Adding DGN and DWG data: Deployment guide. These are optional configuration settings if the Add Data tools are not intended to be used.

  • uploaderUrl—Specifies the relative URL to the upload proxy file.
  • gpServiceUrl—Geoprocessing service URL that you have published for uploading DWG or DGN files. 

"addData": {
        "cad": {
            "uploaderUrl": "proxy/upload.ashx",
            "gpServiceUrl": "http://yourserver/arcgis/rest/services/ConvertCADToFeatureDataset/GPServer/Convert CAD to Feature Dataset"
        }
    }

uploader

  • maxUploadBytes
  • serverTimeout

Specifies the limit for the file upload operation. It is used by the Add Data tools. These are optional configuration settings if the Add Data tools are used.

  • maxUploadBytes—Specifies the maximum size, in bytes, for the file to be uploaded using the RCE. This size should be in sync with your web server's file upload limit.
  • serverTimeout—Specifies the amount of time, in milliseconds, to wait before time-out for an upload request.

"uploader": {
        "maxUploadBytes": 10485760,
        "serverTimeout": 10000
    }

checkEventStartDate

Specifies whether the Start Date in the Add Point Events and Add Linear Events widgets can be set to a date prior to the start date for the selected route.

"checkEventStartDate": true

excludeFields

Specifies a list of fields to be excluded from Identify, Measure Identify, Select Events by Attributes, and Advanced Route Find search results.

"excludeFields": [ "shape", "shape.len", "shape_len", "shape_length", "st_length(shape)", "shape.stlength()", "shape_area"],

search

  • recordsPerPage
  • geocoder
    • url
    • displayFieldName
    • resultFieldNames
    • useCurrentToken
    • token

Specifies the setting for find/search capability in the RCE.

  • recordsPerPage—Specifies the number of records per page within the results table for Find Route and Find Addresses.
  • geocoder—Specifies the single-line geocoder service you want to use for Find Addresses. These are optional configuration settings.

"search": {
        "recordsPerPage": 10,
        "geocoder": {
            "url": "http://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
            "displayFieldName": "Match_addr",
            "resultFieldNames": ["Addr_type", "Score"],
            "useCurrentToken": false,
            "token": ""
        }
    }

selectEventsByAttribute

  • excludeFields
  • maxUniqueRecordCount

Specifies the setting for the Select by Attributes widget.

excludeFields—Specifies the list of fields to exclude from the Selecting events by attribute widget. Administrators can choose to exclude certain fields that are not intended to be edited.

maxUniqueRecordCount—Specifies the maximum number of unique values for the Get Unique Values tool.

"selectEventsByAttribute": {
        "maxUniqueRecordCount": 1000
    }

eventAttributes

  • recordsPerPage
  • errorCellColor
  • editedCellColor
  • nonEditableCellColor

Specifies the settings anywhere the RCE allows users to edit the cell, such as with the Event Attributes, Attribute Set, Split Events, and Merge Events widgets.

  • recordsPerPage—Specifies the number of records per page within the results table.
  • errorCellColor—Specifies the background color of a cell that has failed data validation as you edit.
  • editedCellColor—Specifies the background color of a cell that has been edited.
  • nonEditableCellColor—Specifies the background color of a noneditable cell within the table.

"eventAttributes": {
        "recordsPerPage": 10,
        "errorCellColor": "#ff9999",
        "editedCellColor": "#ffff99",
        "nonEditableCellColor": "#eeeeee"
    },
results grid

selectionSymbols

Specifies the style, color, width, size, and outline of all feature selections made on the map.

"selectionSymbols": {
        "line": { "style": "solid", "color": "#00ffff", "width": 3 },
        "point": { "style": "diamond", "color": "#00ffff", "size": 12, "outline": { "style": "solid", "color": "#008080", "width": 2 } },
        "fromMeasure": { "style": "cross", "color": "#008000", "size": 14, "outline": { "style": "solid", "color": "#00c000", "width": 3 } },
        "toMeasure": { "style": "x", "color": "#ff0000", "size": 12, "outline": { "style": "solid", "color": "#ff0000", "width": 3 } }
    }

Types of line symbols include solid, dash, dot, dashdot, and dashdotdot.

Types of point symbols include circle, square, x, cross, and diamond.

The color is specified as #RRGGBB in HTML hexadecimal color codes.

snapSymbol

Specifies the style, color, width, size, and outline of the point symbol during snapping. 

"snapSymbol": 
{ "style": "cross", "color": "#ff0000", "size": 16, 
"outline": {"style": "solid", "color": "#ff0000", "width": 3}
 },

Types of point symbols include circle, square, x, cross, and diamond.

Types of line symbols include solid, dash, dot, dashdot, and dashdotdot.

The color is specified as #RRGGBB in HTML hexadecimal color codes.

snapMaxLayers

Specifies the maximum number of layers that can be enabled for snapping. A value of 0 means only one layer can be enabled.

"snapMaxLayers": 1

snapMaxScale

Specifies the maximum scale that snapping is supported. A value of 0 means snapping is supported at all scales.

"snapMaxScale": 0

attributeSets

  • folder

Custom attribute sets can be added to the RCE by adding attribute set files to the attributeSets folder located in the RCE folder. Additionally, you can modify the config.json file to use a custom folder created in the RCE folder.

"attributeSets": {
    	"folder": "attributeSets"
    }

folder—Specifies the name of the attribute sets folder.

attributeSetsEditing

  • showEventIDField
  • showLayerNames

Specifies the default behavior of attribute set while configuring it and using it.

  • showEventIDField—Specifies whether you want to show an event ID field on the Attribute set configuration dialog box. Valid values are true and false.
  • showLayerNames—Specifies the default if you want to show the layer name while attibuting events in the Add Linear Widget as well as in the Attribute set configuration. Valid values are true and false.

"attributeSetEditing": {
        "showEventIDField": false,
        "showLayerNames": false
    },

addPointEvents

  • showEventIDField
  • saveToDominantRoute

Specifies whether you want to show an event ID field in the Add Point Event widget.

  • showEventIDField—Valid values are true and false.
  • saveToDominantRoute—Add point events to dominant route.

"addPointEvents": {
        "showEventIDField": false
    },

conflictPrevention

  • hideTransferButtons

Specifies whether you want to show the transfer lock buttons in the Locks Table widget. Allow Lock Transfer in ALRS properties needs to be enabled to transfer locks. For more information, see Enabling conflict prevention in the ALRS.

"conflictPrevention": {
    	"hideTransferButtons": false
    },

hideTransferButtons—Valid values are true and false.

addLinearEvents

  • retireOverlaps
  • mergeCoincident
  • preventInvalidMeasures
  • saveToDominantRoute

Specifies whether you want the Retire overlaps, Merge coincident events, and Prevent measures not on route check boxes checked or unchecked by default in the Add Linear Event widget. 

"addLinearEvents": {
        "retireOverlaps": false
        "mergeCoincident": false
        "preventInvalidMeasures": false
    },

  • retireOverlaps—Valid values are true and false.
  • mergeCoincident—Valid values are true and false.
  • preventInvalidMeasures—Valid values are true and false.
  • saveToDominantRoute—Add line events to dominant route.

redline

  • autoDetection
  • layerId

You can have a separate map service with feature access enabled for the redline. This configuration is optional.

You can configure your redline layer in two ways.

  • autoDetection — If the redline layer name is same as it present in the geodatabase i.e. you have not changed the layer name in the map document used to publish the map service, then, the application auto detects the redline layer using the name from any of the operational layers that you have configured in the webmap.

    Valid values are true and false.

  • layerId — Another option is to configure the map service as the first operational layer in the webmap and then providing the layer id number for the redline layer.

"redline": {
        "autoDetection": true,
        "layerId": 0
    },

wkidList

  • label
  • wkid/wkt

Configure a well-known ID (WKID) or well-known text (WKT) to specify the spatial reference of point event coordinates when adding point events by coordinate location or adding linear events by coordinate location. More than one WKID or WKT can be configured. This configuration is optional. 

"spatialReferenceList": [          
	{"label": "GCS_North_American_1983", "wkid": 4269},          
	{"label": "GCS_WGS_1984", "wkt": 'GEOGCS["GCS_WGS_1984", 
	DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]], 
	PRIMEM["Greenwich",0.0], UNIT["Degree",0.0174532925199433]]'} 
]

  • label—Specifies the name of the spatial reference.
  • wkid—Specifies the WKID of the spatial reference.
  • wkt—Specifies the WKT of the spatial reference.