---
schema_version: "1"
id: 2de4dbe3a8abd317ad32c23c9819928fb261c064e81fe8fa3d40d74f36849307
title: Set Up a Native GIS Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/mfs_native_gis_connector_setup.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.mfs_native_gis_connector_setup.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c329cc0045456436f126ec07b5ac5eb2f9b847502a7bb128c5a1ce73c80d0a96
description: To view Salesforce objects on the map, define a connector to automatically sync the Salesforce data with the relevant ArcGIS hosted feature layer. Map Salesforce objects and fields with ArcGIS layers, and define how often the connector should run. To update data at different intervals, you can create multiple connectors for each type of sync interval.
products:
  - Field Service
release: "264"
---
# Set Up a Native GIS Connector

To view Salesforce objects on the map, define a connector to automatically sync the Salesforce data with the relevant ArcGIS hosted feature layer. Map Salesforce objects and fields with ArcGIS layers, and define how often the connector should run. To update data at different intervals, you can create multiple connectors for each type of sync interval.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong> Edition with the Asset Service Lifecycle Management add-on license, or in <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d24828e72">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d24828e72 ">To set up connectors:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d24828e72 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

A connector pushes synced records to ArcGIS as a reference layer, so mobile workers view them on the map even when the records aren’t primed on the device through Briefcase. The app makes reference-layer records available through the ArcGIS SDK instead. To learn how connectors compare to related objects, see [Data Layers for Native GIS](https://help.salesforce.com/s/articleView?id=service.mfs_native_gis_data_layers.htm&release=264.0.0&type=5 "Plot Salesforce data on Native GIS maps in the Field Service mobile app. On the Data Layers tab in Field Maps Settings, set up a connector to sync data to ArcGIS as a reference layer, or map related objects directly from Salesforce without syncing.").

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_field_service-264-0-0-production-enus/3f7dceb9-dd70-454a-b49e-bbb4526a158d/images/icon_note.png)

Note The connector creates and updates the records modified since the last sync, based on the Last Modified field on the record. During its initial run, the connector processes all changes from the previous 7 days.

1. From Setup, find and select **Field Maps Settings**.
2. Open the **Data Layers** tab.
3. In the **Connectors** section, click **New Connector**.
4. Enter a name and select the authentication record that you created.
5. Click **Next**.
6. Click the ![Plus icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_field_service-264-0-0-production-enus/3f7dceb9-dd70-454a-b49e-bbb4526a158d/support_field_service/images/dc_plus.png) icon and select an object that you want to sync. For example, Work Order, Work Order Line Item, Account, Location, Asset, or any custom objects that you’ve defined.
7. You can define filters to update data for records containing specific values.
    
    1. From **Filter By**, select the field to use to update ArcGIS.
    2. Define the criteria and a value.
    3. Define more fields as required.
    4. Add filter logic to define how and when to apply the filters, using AND and OR logic.
    
    ![New Connector](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_field_service-264-0-0-production-enus/3f7dceb9-dd70-454a-b49e-bbb4526a158d/support_field_service/images/mfs_gis_new_connector.png)
8. Under **Feature Layer Details**, define the details of the ArcGIS feature layer and the specific layer you want to connect to.
    1. For Feature Layer URL, navigate to the feature layer in your ArcGIS account and copy the URL.
    2. For Layer ID, enter 0 if your feature layer has only 1 layer. If it has multiple layers, open the layer and extract the value that appears after the sublayer query param in the browser’s URL. For example, if the layer’s browser URL is:
        
        https://sfsesri.maps.arcgis.com/home/item.html?id=bb42fdb05a46406c8082b9cb0a4ca526&sublayer=2,
        
        the Layer ID is 2.
    3. Click **Get Fields** and make sure that you see Assign Object Fields to Feature Layer Fields and Assign Geometry Fields. If you receive an error, make sure that you’ve set up the authentication record correctly.
9. Under Assign Object Fields to Feature Layer Fields, you can map an object field to the equivalent field in the layer’s table in ArcGIS.
    
    ![Assign Objects](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_field_service-264-0-0-production-enus/3f7dceb9-dd70-454a-b49e-bbb4526a158d/support_field_service/images/mfs_gis_new_connector1.png)
10. Assign the Geometry types to an object field, which must contain a value.
    1. For polygons and lines, choose a text field, which includes a GeoJSON format.
    2. For points, choose a field of geolocation type.
    3. Click **Next**.
11. Set the connector’s status to **Active**.
12. Under Send connector data, define how often to sync Salesforce data with ArcGIS.
13. Save your changes.

**Considerations**

- Before reference-layer records appear in the app, set up Briefcase for the object and prime at least one record. The app then primes the remaining reference-layer records through the ArcGIS SDK, not through Briefcase.
- When mobile workers tap a reference-layer record on the map, they see the record’s Salesforce details and can create or update it.
- You can configure up to three connectors and push up to 150 million records from Salesforce to ArcGIS within a 24-hour period. You can push up to 10,000 records in a single update.
- Make sure that mobile workers have access to the records that the connector pushes to ArcGIS. A record can appear on the map even if the mobile worker doesn’t have permission to view it in Salesforce.
- To avoid data conflicts, don’t send the same records to multiple feature layers.
- The Native GIS Connector treats Salesforce as the source of truth and syncs one way. The connector doesn’t detect changes that you make directly in ArcGIS. If you update a record in both Salesforce and ArcGIS, the next connector run overwrites the ArcGIS changes with the Salesforce values. If you delete a record in ArcGIS but the record still exists in Salesforce, the next connector run doesn’t push the record again, because the connector resyncs only records whose Last Modified date in Salesforce has changed.
- To restore a record that you deleted in ArcGIS but that still exists in Salesforce, edit the Salesforce record so its Last Modified date is updated, and then wait for the next connector run.
- The connector retains historical data for a maximum of 30 days.
- The connector doesn’t update the map in real time. Reference-layer records appear or change on the map only after the connector’s next scheduled push to ArcGIS.
- The connector adds and updates records in ArcGIS but never deletes them. A record that no longer matches the connector’s filter, such as a work order that’s now Completed, stays on the map until you delete it in Salesforce. For data that changes often, plan to either delete stale records regularly in ArcGIS or use feature layers scoped to a time period that you replace on a schedule.

**Troubleshooting**

- When a connector job fails, you can send yourself an email using Salesforce Flows, which can provide details that can help you troubleshoot issues. See [Sending Emails from a Flow](https://help.salesforce.com/s/articleView?id=platform.automate_flow_build_example_send_email_from_a_flow.htm&type=5&language=en_US). Choose **Gis Provider Connector Object Job Run** as the object whose records trigger the flow when they’re created, updated, or deleted.
- Optionally, if a connector job fails, you can fix the missing records manually in ArcGIS portal. You can also clone the connector and run it, then reuse the original connector after the clone finishes. Before you clone, set the Salesforce record ID field as unique in the ArcGIS feature layer to prevent duplicate records, and note that the initial run of the cloned connector processes only the previous 7 days of Salesforce changes.