ArcGIS is a geographic information system (GIS) software developed by Esri (Environmental Systems Research Institute). It is used for mapping, spatial analysis, and data visualization to help users understand geographic relationships and patterns. Our built-in ArcGIS connector allows you to connect our platform with your ArcGIS account to seamlessly use your geographical data in any of your forms or reports.


In this article

  • Adding
  • Authenticating
    • Public
    • User Account
    • App
    • API Key
  • Troubleshooting

Adding


The Data Hub area of the platform is where you can add connections for connectors. Navigate the side menu to Data Hub > Connections.


On the Connections page:

  • Click the ADD CONNECTION button in the top-right-hand corner to bring up a list of connections.
  • Click on the ArcGIS option as shown in the screenshot below:

Authenticating


For detailed instructions on how to authenticate with ArcGIS, we suggest you consult their online documentation for details. In this section, we'll outline the four possible authentication options that are available through our integration with ArcGIS. These are:


  • Public
    Allows access without requiring authentication.
  • User Account
    This option allows you to authenticate your connection using the same ArcGIS username and password you use to access the ArcGIS login portal.
  • App
    Authenticates using OAuth2.0.
  • API Key
    Authenticates using an API key. This requires an Enterprise Account, not an ArcGIS Online account.


Public

This is the simplest authentication to configure, as it doesn't require any authentication. This option should be used if you intend to access only publicly shared maps and layers, ArcGIS online public content, open data portals, and public web applications and dashboards.

User Account


The User Account authentication option in ArcGIS is designed for scenarios where access to maps, data, and GIS services needs to be restricted to specific users or groups. To use this option, select the "User Account" option from the dropdown and enter the username and password that you use to authenticate on the main ArcGIS portal.

Once you select the "User Account" authorization option and click "Save", the page will reload, giving you the option to "Authorize" your connection. Click the "Authorize" button as shown in the screenshot above to login to your ArcGIS account, an ArcGIS login modal window will load as shown in the screenshot below.



Log in to the ArcGIS account you wish to link to this connection. If your login is successful, you will see the word "Connected", signifying a successful connection, as shown in the screenshot below.


App


It is beyond the scope of this article to show you the various ways of creating an app in ArcGIS. We will show you how to retrieve the details necessary to authenticate your connection to your app.


In the "My Content" area of the ArcGIS portal, find the application you wish to authenticate against in your list of content. Click the three dots at the end of the line item to show the context menu, and then click on "View Details," as shown in the screenshot below.



After you click "View Details", the next page that loads will have the details you need to be able to authenticate your ArcGIS app connection. Scroll down the page to see the credentials you need (Client ID and Client Secret), as shown in the screenshot below.

API Key


This authentication option requires an Enterprise account and is out of scope for this document, which deals exclusively with integrations with ArcGIS Online. If you have access to your developer credentials, then you will be able to access your API Key. Use that to authenticate the connection with your enterprise account.

Troubleshooting


At this stage, we don't have any known issues or caveats we need to notify you of. If you encounter any issues with your integration, please do contact our support department for assistance and we'll be glad to help.