Authoring a web map for Event Editor

The Event Editor gets its map definition of which layers to use from 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 can be 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 within the Event Editor.

1. Log into Portal for ArcGIS or ArcGIS Online.

   When you log in to ArcGIS Online for the first time, you will need to create an account.

2. 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 the 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.

   Nota:

   If you want to support redline routes, enable Feature Access.

   Nota:

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

3. Once you have created a web map and added all required layers, click Save.
4. Enter the following information for the web map:
   • Title
   • Tags
   • Summary
5. Choose a folder in My Content to store the web map.
6. Click Save.

   See Save maps for more information.

7. After the web map is created, you need to know the web map ID because it will be used in the other steps of the Event Editor deployment process.
   1. Click My Content.
   2. Click the title of the web map to open the item details.

      The URL for the item details web page will be 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 might be the best approach.

1. Open a web browser and enter the web map definition URL in the address bar. The URL for the web map definition should 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.

2. Copy the entire contents of the web page and paste it into a text file.
3. Rename the text file to have a .json extension.

   You can use any name for the .json file.

4. Copy the file to the web folder containing the Event Editor web app on the web server.

   For example, in Internet Information Services (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 that can be found within the Event Editor web app.

1. Using Windows Explorer, browse to the sample web map at $INSTALL_DIR$\Server\Web\EventEditor\sample_webmap.json.
2. 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, the basemap, operational layers, and extent.

Nota:

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

3. At a minimum, some of the items within the operationalLayers configuration section need to be modified 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.

   For more information on authoring a web map, see Using URL parameters.

4. Copy the file to the web folder containing the Event Editor web app on the web server.

   For example, in Internet Information Services (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.