Layer Mapping in WebOffice – VertiGIS Support

Introduction

This chapter provides a brief description of the process for correctly assigning layers.

Description

If you want to create a new ArcGIS layer in an existing ArcMap or ArcGIS Pro project to integrate it into an existing WebOffice project, or if you make a change to the layer and want to apply it to the project configuration, you must first perform the layer mapping. This process serves to align the themes or rather layers present in the WebOffice project configuration with those found either in the corresponding ArcGIS document (MXD or APRX), which must be open simultaneously with WebOffice Author Standalone (WOAS), or they can be retrieved via the REST interface in ArcGIS Server.

To validate such changes, first republish the Map Service or Feature Service to ArcGIS Server, or use the WebOffice Author Standalone (WOAS) to establish a connection via the Connector Extension to the ArcMap or ArcGIS Pro document containing the layer.

For ArcMap-based services, see: Connection to ArcMap
For ArcGIS Pro-based services, see: Connection to ArcGIS Pro

Note: When you publish or overwrite the service against ArcGIS Server, you generally do not need to reload the WebOffice project resources (via SynAdmin).

Then switch to WOAS and open the Layer Mapping. You can do this either via the "Extras" menu item or by clicking the first icon at the bottom left of the blue bar in WOAS.

Validating a new Layer in an existing Project

The "ArcMap / ArcGIS Pro / HTTP" column shows the layer’s name in ArcGIS. The "Project Configuration" column shows the current name of the layer in the open project configuration. In a completely new layer, the field in the "Project Configuration" column will be empty. Here, you must select the same layer name from the dropdown menu as in the "ArcMap / ArcGIS Pro / HTTP" column, but with the additional label "(New)" at the end of the name (see image below; in this instance it is "Neu", because the screenshot is in German).

Validating a new Layer Name in an existing Project

If a layer is already part of a project and you have only changed the layer’s name, you must proceed differently. As a reminder: The "ArcMap / ArcGIS Pro / HTTP" column shows the layer’s name in ArcGIS. This means it is the current or correct name of the layer, provided there is an active connection to the ArcGIS document (via Connector) or the service has been updated on the ArcGIS server.

When you then open the Layer Mapping, you will see the current name in the left column. The name change has taken effect. In the right-hand "Project Configuration" column, you must select the name of the service stored in the project configuration - that is, the name it currently still has in the project.

Warning: Do not select the new layer name with the suffix "(New)" here. Doing so would result in you reselecting the layer, and it would be reassigned to the existing links. This would cause all existing configurations to be lost, e.g., if the layer is configured in the TOC or for queries, is integrated as an editing layer, etc.

Example

Layers in the TOC of the ArcMap document before the name change:

Layers in the ArcMap document's TOC after the name change:

After overwriting the existing service with ArcGIS Server, you will see the layers that are no longer available in the open project configuration when you open the Layer Mapping (see image below).

It may take a while for the newly published or overwritten service to load when you select it from the "Service" bar at the top of the Layer Mapping. Once it has loaded, the new layer names will appear in the left column "ArcMap / ArcGIS Pro / HTTP", while empty rows will appear in the right column "Project Configuration" (see image below). The names must now be reassigned here, as the layer names have changed in the REST interface.

More specifically, you must now select the layer names stored in the project configuration on the right-hand side. In the example below, this would be "U-Bahn-Plan". This will be assigned to the new layer name, in this case "U-Bahn-Plan_4326” Do not select "U-Bahn-Plan_4326 (New)".