Authoring a web map for Event Editor—ArcGIS Pipeline Referencing Server

Available with Location Referencing license.

ArcGIS Event Editor gets its map definition from the layers used in a web map. Web maps are maps that can be authored and hosted on ArcGIS Online or on an on-site deployment of Portal for ArcGIS. To clarify the basic deployment steps of the Event Editor, a copy of a web map is placed into the Event Editor web deployment folder.

The following sections describe the three options for hosting the web map.

Using a web map on Portal for ArcGIS or ArcGIS Online

Web maps are authored using Portal for ArcGIS or ArcGIS Online. You can choose to add the data layers (map service) you intend to use, change the extent, select a basemap from the basemap gallery, include a description of the map, and save it as your own item for use in Event Editor.

Sign in to Portal for ArcGIS or ArcGIS Online.

When you sign in to ArcGIS Online for the first time, you will need to create an account.
Create a web map with linear referencing capability on Portal for ArcGIS or ArcGIS Online.

Add at least one map service that contains the LRS Network layers and linear and point event layers that you want to edit as layers in the web map. Optionally, you can also add basemaps or any reference layers as layers in the web map. Make sure the Linear Referencing capability is enabled on this map service.
Note:
If you want to support redline routes, enable Feature Access.

Note:

Event Editor supports map service, feature service, and image service layers.

Note:
If your redline is z- or m-enabled (or both), ensure that the Apply default to features with z-values during publishing option is enabled.
Once you have created a web map and added all required layers, click Save.
Enter the following information for the web map:
- Title
- Tags
- Summary
Choose a folder in My Content to store the web map.
Click Save.

Learn more about saving maps
After the web map is created, note the web map ID, as it is used in other Event Editor deployment process steps.
1. Click My Content.
2. Click the title of the web map to open its item details page.
  
  The URL for the item details web page is in the following format: http://www.arcgis.com/home/item.html?id=<webmapID>. The web map ID is the 32-character string at the end of the URL.
  
  For example, https://www.arcgis.com/home/item.html?id=1dcf369089804329946e3b3abf385251.

Copying a web map from ArcGIS Online as a local file

If you have an ArcGIS Online account and your organization restricts members from sharing items outside the organization, copying the web map onto the web server is a valid approach.

Open a web browser and enter the web map definition URL in the address bar. The URL for the web map definition must have the following syntax: http://www.arcgis.com/sharing/content/items/<your web map ID>/data?f=pjson.

For example, the following URL retrieves the web map definition for the New York sample data hosted on ArcGIS Online: https://www.arcgis.com/sharing/content/items/1dcf369089804329946e3b3abf385251/data?f=pjson.
Copy the entire contents of the web page and paste it into a text file.
Rename the text file using a .json extension.

You can use any name for the .json file.
Copy the file to the web folder containing the Event Editor web app on the web server.

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

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

Using a web map as a local file on the web server

As an alternative to authoring the web map using ArcGIS Online, you can author web maps directly by modifying the URL parameters in the sample web map found in the Event Editor web app.

Browse to the sample web map at $INSTALL_DIR$\Server\Web\EventEditor\sample_webmap.json.

Using a text editor, open the sample web map (sample_webmap.json) file.

{
  "operationalLayers": [{
    "id": "LRS_map_service",
    "title": "LRS map",
    "url": "http://pipelinereferencingsample.esri.com/ArcGIS/rest/services/pipelinereferencing/NewYork/MapServer",
    "visibleLayers": [ 0, 1, 2, 3 ]
  }],
  "baseMap": {
    "baseMapLayers": [
      {
        "id": "World_Light_Gray_Base",
        "url": "http://services.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Base/MapServer"
      },
      {
        "id": "World_Light_Gray_Reference",
        "isReference": true,
        "visibility": true,
        "url": "http://services.arcgisonline.com/ArcGIS/rest/services/Canvas/World_Light_Gray_Reference/MapServer"
      }
    ],
    "title": "Basemap"
  },
  "version": "1.6"
}

URL parameters allow you to define the contents of a map, for example, a basemap, operational layers, and extent.

Note:

Event Editor supports map service, feature service, and image service layers.

At a minimum, you must modify the following items in the operationalLayers configuration section to use your data.
1. Change the URL parameters to point to the URL of the map service with linear referencing capability that you have published.
2. Change the visibleLayers parameters to include the layer ID of the layers that you would like to be visible by default.
Learn more about using URL parameters while authoring a web map
Copy the file to the web folder containing the Event Editor web app on the web server.

For example, in IIS, the web folder may be located at C:\inetpub\wwwroot\EventEditor.

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

Feedback on this topic?