Skip To Content

Configuring the Event Editor web app

Several properties can be configured in the Event Editor web app. Open the config.json file in the EventEditor web folder on the web server to modify and deploy.

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

Event Editor 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, sign in with your global account and browse to My Content. Click the title of the web map to view more details. At this point, the URL has the following format: https://www.arcgis.com/home/item.html?id=<webmapID>.

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

Copy the webmap value for the configuration.

"webmap": "1dcf369089804329946e3b3abf385251",

If the web map is hosted through Portal for ArcGIS, navigate to content and select the web map from the list of items in your portal. The URL has the following format: http://<HostName>/<PortalWebAdaptorName>/item.html?id= <webmapID>.

For example: http://<HostName>/<PortalWebAdaptorName>/item.html?id= 7e133f430cc4d95897647581f23d819

Copy the webmap ID value for the configuration.

"webmap": "f7e133f430cc4d95897647581f23d819",

If the web map is hosted on a server. the URL has the following format: http://<HostName>/EventEditor/sample_webmap.json, where sample_webmap.json is the text file that contains the web map definition.

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 Server instance.

In ArcGIS Server Manager, click Utilities > Geometry to view the Geometry page, then click Capabilities to view the geometry service URL.

banner

  • label
  • labelColor
  • backgroundColor

Specifies the banner label text, and label color and banner color. The following 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 Event Editor.
  • labelColor—Banner label color. The default color is e8e8e8.
  • backgroundColor—Banner color. The default color is 2f2f2f.

"banner": {
        "label": "My Event 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.

Note:

You should not change or remove this proxy URL from the configuration file.

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

qcChecks

  • recordsPerPage

Specifies a setting for the Check Events widget.

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

versioning

  • allowReconcileAndPost
  • allowChangeVersions
  • allowCreateVersions
  • allowDeleteVersions

Legacy:

The visible configuration parameter, to show the Reconcile & Post widget was deprecated as of the Roads and Highways 10.4 release. Please update your configuration file to use the allowReconcileAndPost configuration parameter.

  • allowReconcileAndPost—Specifies whether the Reconcile & Post widget is visible to the user.
  • allowChangeVersions—Specifies whether a person can change the geodatabase version.
    Note:

    The version needs to be public before you can change it.

  • allowCreateVersions—Specifies whether a person can create a new geodatabase version.
    Note:

    The new geodatabase version that is being created uses the user credentials from the published map service and the access level of the newly created version is public.

  • 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 Event Editor.

Learn more about integrating Data Reviewer for Server

The following are optional configuration settings if Data Reviewer integration is required:

  • serviceUrlData Reviewer map service URL.
  • executeBatchJobUrlData Reviewer geoprocessing service URL.
  • productionWorkspace— A path to a .sde connection file of the production workspace, the geodatabase of the data to be validated.
    Note:

    This parameter only has to be configured if the Reviewer workspace and the LRS are in different databases.

  • 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 in 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 Event Editor. This could be an ArcGIS Online or Portal for ArcGIS URL.

This is used in portalGroup of the basemaps configuration and as the URL to access for the web map content.

An example ArcGIS Online portal URL:

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

An example portalURL:

"portalUrl" : "https://<HostName>/<PortalWebAdaptorName",

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 Event Editor using the following methods:

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

ArcGIS tiled map services and ArcGIS dynamic map services are supported as a basemap.

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 used by Bing basemaps. If you have used a Bing map as a default basemap in the webmap or configured it in the basemaps widget, you need to provide this key.

Learn more about adding Bing maps as basemaps

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

security

  • maxSessionTimeMinutes
  • portalAppId

Esri Roads and Highways for Server supports a secure sign in via Portal for ArcGIS or ArcGIS Online on the published map service that has linear referencing capability. This security is provided via OAuth 2.0. Configuring secure sign in using Portal for ArcGIS or ArcGIS Online allows these apps to handle security and identity authentication for Event Editor. Only users that have been added to your Portal for ArcGIS or ArcGIS Online account will have proper credentials to authenticate and access Event Editor.

The following configuration settings are required.

  • maxSessionTimeMinutes—Specifies the duration, in minutes, before an Event Editor session logs out. Set the value to -1 to never be logged out.
  • portalAppId—Specifies the app ID after the Event Editor has been registered with either Portal for ArcGIS or ArcGIS Online. If the type is set to “none”, then this property is ignored.

    Learn more about Portal for ArcGIS or ArcGIS Online for Event Editor

"security": {
        "maxSessionTimeMinutes": 10080,
        "portalAppId": "Rr1sZV3VN89rXtLO"
    },

addData

  • cad
    • uploaderUrl
    • gpServiceUrl

Specifies the URL for the Add Data tools.

Learn more about adding DGN and DWG data

The following 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
  • uploadTimeoutSeconds

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 Event Editor. This size should be in sync with your web server's file upload limit.
  • uploadTimeoutSeconds—Specifies the amount of time, in milliseconds, to wait before time-out for an upload request.

"uploader": {
        "maxUploadBytes": 10485760,
        "uploadTimeoutSeconds": 60
    }

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 the Event Editor search capability.

  • recordsPerPage—Specifies the number of records per page in 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 Event Editor allows users to edit the cell, such as in the Event Attributes, Attribute Set, Split Events, and Merge Events widgets.

  • recordsPerPage—Specifies the number of records per page in 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 in 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 using 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 using 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 Event Editor by adding attribute set files to the attributeSets folder located in the EventEditor folder. Additionally, you can modify the config.json file to use a custom folder created in the Event Editor 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 or false.
  • showLayerNames—Specifies the default if you want to show the layer name while attributing events in the Add Linear Events widget as well as in the Attribute set configuration. Valid values are true or 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 or 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.

Learn more about enabling conflict prevention in the LRS

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

hideTransferButtons—Valid values are true or 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 or false.
  • mergeCoincident—Valid values are true or false.
  • preventInvalidMeasures—Valid values are true or 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 the same as the redline feature class name (including prefix), the app auto detects the redline layer from the operational layers that you have configured in the webmap.
    Note:

    If autoDetection is set to true the layerID value will be ignored.

    Valid values are true or false.

    Note:

    The comparison between the layer name and the redline feature class is case sensitive.

  • layerId — Another option is to configure the map service as the first operational layer in the webmap and then provide 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.