Certain data becomes more valuable when displayed on a map. To display this data, GIS objects are used. A GIS object is a point, line, or shape that represents geographical information. ArcGIS is an application that provides maps and GIS objects.

In Relatics, you can use GIS objects provided by ArcGIS in feature layers to display relevant project data on a map. To do so, you need to configure an external type element and create an interface.

Prepare ArcGIS for Relatics^*

1. In the environment administration, click on Application authentications.
2. Click on New key. This opens a dialog wherein you can configure the authentication client.
3. In the field Name give a relevant name for the ArcGIS key.
4. In the field API select ArcGIS. The dialog will now update and show the fields to be filled out.
5. In the field Username, provide the username of the ArcGIS account that has access to the featurelayer.
6. In the field Password, provide the password belonging to the Username of the ArcGIS account.
7. In the field Enterprise URL, leave this field empty when using an ArcGIS online account. When using an ArcGIS enterprise account provide the URL of the domain.
8. Click on Create. Relatics will check if the connection to the ArcGIS you just integrated is working.

Use the Test configuration button to validate whether the configured key can be successfully authenticate by ArcGIS.

Note:

• Make sure the ArcGIS account does not have multi-factor authentication enabled. If this is the case, the authentication will not work.

Give workspace access to ArcGIS authentication client^*

1. In the environment administration, navigate to and click on the ArcGIS access key containing the data you want to integrate into a workspace.
2. Check if Status is set to enabled. If it is set to disabled, click on the icon, and in the following dialog, toggle Status to enabled. Press Update.
3. Link the access key to the desired workspace by pressing the icon next to Workspaces with permission and selecting it from the dialog. Press Update.

Integrate ArcGIS client into workspace^**

1. Create a new external type element.
2. Navigate to the  application integration tab on the left side of the workspace.
3. Click on New interface, located at the top of the table Interface for synchronizing with an external application. This opens a dialog in which you can configure the ArcGIS interface.
4. In the field Name, give the ArcGIS interface you are about to integrate a relevant name.
5. In the field Type element, select the external type element you created in step 1.
6. In the field Setup, select Optimized for ArcGIS.
7. In the field Key to access external application, select the name of the ArcGIS authentication client.
8. In the field Feature layer URL, provide the name of the URL to the feature layer. The URL can be found in the ArcGIS Location Platform, and should look like:
   https://<ArcGIS service>.arcgis.com/<ArcGis account id>/arcgis/rest/services/<layer name>/FeatureServer/<number>
9. Click on Create.

Map an externally managed property to the ArcGIS feature layer value^**

1. Add a type property with the ownership in an external application to the type element with external ownership.
2. Navigate to the  Application integration tab on the left side of the workspace.
3. Open the detail page of the ArcGIS interface by clicking on the row.
4. Click on  Add property mapping. This opens The dialog New property mapping.
5. In the field Mapped from, select the ArcGIS field you want to map.
6. In the field Property, select the type property of your type element.
7. Click on Create.

* In the environment, the administration role of your user must be set to administrator to enable this feature.
** In the workspace, the user type of your user must be set to power user to enable this feature.