This article explains how map layers created in ArcGIS can be integrated directly into Clarity Human Services.
Two methods are available for adding map layers into Clarity Human Services:
- Uploading map layers from a computer, as described in our Configuring Map Layers article.
- Importing or adding map layers directly from ArcGIS, as described in this article.
The following types of ArcGIS map layers can be imported or added to Clarity Human Services:
- Feature Service
- Vector Tile Service
- Map Service
- Feature Collection
- GeoJson
- CSV
Entering ArcGIS Credentials
Before a user can add or import a new map layer directly from ArcGIS, the user’s ArcGIS credentials must be entered into Clarity:
- Navigate to SETUP > SETTINGS.
- Click Integrations in the Advanced Options sidebar.
- The MANAGE INTERACTIONS page appears. Click EDIT for the ArcGIS API.
- The EDIT INTEGRATION page appears. Click ADD NEW INTEGRATION USER.
- On the ADD INTEGRATION USER page, enter the ArcGIS login credentials for the user.
- Click SAVE CHANGES.
Importing Map Layers
Click the Edit icon next to the user’s name on the EDIT INTEGRATION page.
The EDIT INTEGRATION USER page appears. Click IMPORT LAYERS.
The system will automatically request ArcGIS using the user’s credentials and will import all the layers visible to that user.
Note: An error message stating "Could not fetch portal items for user" will be displayed in the following situations:
-
The user entered an incorrect ArcGIS username/password into Clarity.
OR -
There are no layers in the user's ArcGIS gallery to import (or no layers are shared with the user).
Additional information on interacting with ArcGIS data can be found here.
Adding Map Layers
Click the Edit icon next to the user's name on the EDIT INTEGRATION page.
The EDIT INTEGRATION USER page appears. Click ADD NEW LAYER.
The ADD LAYER page appears.
Complete the fields:
Status: Turn the toggle on to indicate that the layer is active; leave the toggle off for an inactive layer.
Layer ID, type, URL, and Owner: The information needed to complete these fields can be found by navigating to your Gallery in ArcGIS and clicking the View details link for the layer.
Title: Enter the name of the layer.
Thumbnail: The thumbnail URL is not used anywhere in Clarity Human Services; however, it is a required field on this page, so enter any value you like for this field.
Access: Select the option that describes the visibility of this layer within your “organization” (your group of users within ArcGIS):
- “Private”: Only the user who created/owns the layer has access to it.
- “Shared”: A user (inside or outside of your organization) shared this layer with you.
- “Organization”: Any user within your organization has access to this layer.
- “Public”: Everyone can see the layer (even users out of your organization or guests without any credentials).
Click SAVE CHANGES.
The layer will appear on your EDIT INTEGRATION USER page, and can be edited or deleted as needed.
Add or import any additional layers as needed.
The layers you add/import will then be available for use in the LOCATION tab and Outreach module.
Tip: Instead of manually ADDING individual layers, you may find it more efficient to IMPORT all of the layers that are visible to you in ArcGIS, and then delete any of the imported layers that you do not wish to show in Clarity.
Published: 05/28/2024