Skip To Content

Configure utility services

Default administrators and those with the appropriate privileges can configure the portal to use services to perform various tasks, including printing, geocoding, geometric calculations, spatial analysis, routing, and more. These are referred to as utility services. To learn more about these services, see Utility services.

The way you configure utility services for your portal depends on the service and where it originates.

Types of utility services

Use the following links to see a description of the utility services you can use in your portal. Once you decide which utility services you want to use, proceed to the instructions to configure utility services with your portal.

Printing

If you have a base deployment or a federated server for your portal, a print service is configured with the organization by default.

If you do not, you can add the following types of print services:

  • An ArcGIS Server preconfigured print service: https://webadaptorhost.domain.com/webadaptorname/rest/services/Utilities/PrintingTools/GPServer/Export%20Web%20Map%20Task
  • A custom ArcGIS Server print service: https://webadaptorhost.domain.com/webadaptorname/rest/services/folder/servicename/GPServer/TaskName

Asynchronous print services are not supported.

Geometry

You can add the following types of geometry services:

The preconfigured geometry service included with all ArcGIS Server sites is stopped by default. You must explicitly start the service before you can access its URL, which will be in the format https://webadaptorhost.domain.com/webadaptorname/rest/services/Utilities/Geometry/GeometryServer.

A custom ArcGIS Server geometry service URL is in the format https://gisserver.domain.com:6443/arcgis/rest/services/folder/servicename/GeometryServer.

GeoEnrichment

You can add the ArcGIS GeoEnrichment Service from ArcGIS Online to your portal. To use this service, you must provide credentials for an ArcGIS Online organizational account that has credits associated with it.

The ArcGIS Business Analyst web app leverages GeoEnrichment as a utility service in the portal to create sites, reports, infographics, and more. GeoEnrichment capabilities are provided with ArcGIS Business Analyst Enterprise and can be configured in the portal by following the steps below:

  1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.
  2. At the top of the site, click Organization and click the Settings tab.
  3. Click Utility services.
  4. Scroll to the GeoEnrichment section and click the edit button.
  5. Paste the URL of the GeoEnrichment service into the field, for example, https://webadaptor.domain.com/arcgis/rest/services/DefaultMap/geoenrichmentserver.
  6. Click Save.
Note:

The offline data included with ArcGIS Business Analyst Enterprise will support GeoEnrichment with data associated with analysis locations in the United States only. An Esri Services engagement is needed for support with international data.

Hydrology

You can add the ArcGIS Online Hydrology service to your portal. To use this service, you must provide credentials for an ArcGIS Online organizational account.

Orthomapping Elevation

This service is used by the Ortho Maker web app, from initial image collection creation to block adjustment and final product creation. For Ortho Maker users, if your portal is not connected to the internet, or if you have higher-resolution data you want to use with the app, you can publish an orthomapping elevation service and add its service URL here. If you do not have your own orthomapping elevation service and your portal's users have access to the internet, add the ArcGIS Online Orthomapping Elevation service.

Elevation

The portal uses two elevation services: an elevation utility service for analysis and an elevation service used in Scene Viewer.

For analysis, you can add the ArcGIS Online World Elevation services to the portal. To use these services, you must provide credentials for an ArcGIS Online organizational account. Alternatively, you can configure a custom elevation utility service to use if the portal is not connected to the internet.

For Scene Viewer, if the portal is not connected to the internet or you have higher-resolution data you want to use for the Scene Viewer elevation service, you can set a custom elevation service in the organization settings.

Directions and routing

See Routing utility service to learn more about the types of routing services that can be configured with a portal. For instructions, see Configure routing services.

Geocoding

You can configure multiple geocode services with a portal. The following types of geocode services are supported:

The ArcGIS World Geocoding Service is configured as a geocoding utility service by default. If you want to geocode tables of addresses, configure one of the following as an additional geocoding utility service:

  • An ArcGIS Server geocode service for which the Batch Geocoding operation is enabled.

    The URL for a geocode service from an ArcGIS Server is in the format https://webadaptorhost.domain.com/webadaptorname/rest/services/folder/servicename/GeocodeServer.

  • The ArcGIS World Geocoding Service from ArcGIS Online.

    To configure the ArcGIS World Geocoding Service as a geocoding utility service, go to the ArcGIS Online tab and check the Geocode check box under Configure Utility Services. Be aware that the ArcGIS Online credentials you provide must have privileges in ArcGIS Online to geocode, and that using this service consumes ArcGIS Online credits.

A locator is used to search for and locate addresses and places on a map. You can specify locators that members of your organization can access. You can add a locator by referencing the URL of your own locator or by pointing to an existing locator item in the organziation.

Note:

If you specify one or more locator views along with ArcGIS World Geocoding Service, users may see multiple matching suggestions when searching for locations. To ensure an optimal publishing and geosearch experience, configure batch geocoding and geosearch as appropriate when configuring locators for your organization.

To add a locator, complete the following steps:

  1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.
  2. At the top of the site, click Organization and click the Settings tab.
  3. Click Utility services.
  4. In the Geocoding section, click Add locator and do one of the following:
    • Select From URL and enter the URL to the locator—for example, https://webadaptorhost.domain.com/webadaptorname/rest/services/World/GeocodeServer.
    • Select From Existing Locator and select the locator item you want. Only locators shared with your organization or with the public are available for selection.
  5. For Locator Name, enter the name you want to appear in the drop-down menu of locators on the site (for example, in Map Viewer).
    Tip:

    Choose a descriptive name for the locator—for example, Restaurant Locator.

  6. For Placeholder Text, enter a hint that will appear in the input box on the site.
    Tip:

    Make the hint as clear as possible—for example, Enter a restaurant name.

  7. Check the appropriate boxes if you want to allow geosearch and batch geocoding.
  8. Configure the number of threads for batch geocoding and click OK to save your changes. This number should be less than the number of instances available for the service. To adjust the number of instances for your published geocode service, go to ArcGIS Server Manager. The option to configure the number of threads for batch geocoding is not available for the ArcGIS World Geocoding Service or for locator views. For more information about batch geocoding threads, see Best practices for portal batch geocoding.
  9. Click Save.
  10. Repeat the process to add additional locators.
  11. Manage the locators in the following ways:
    • To edit an existing locator, click the More options button More options next to the locator and click Edit. Make your updates and click Save.
    • To delete an existing locator, click the More options button More options next to the locator and click Delete.
    • To reorder how the locators appear in the geosearch drop-down menu on the site, drag the locator up or down to the correct position.
Tip:

To reset locators to the default locator, delete the URL and click Save. When you refresh the page, you see the default URL. If your portal needs to delete a locator item in the future, you must remove it from the list before deleting the item.

Symbols

Add a symbols service from a federated or hosting server.

Legacy:

Before ArcGIS Enterprise 11.0, the hosting server's symbol service was automatically set as the organization's symbols utility service.

Configure utility services

How you configure utility services depends on where the service originates. Follow the instructions specific to the origin of the service that you will configure as a utility service for the portal.

Note:

If the portal accesses any of the utility services over HTTPS, but the ArcGIS Server site on which the utility service runs uses a certificate that is either self-signed or issued by an internal Certificate Authority, you must configure the portal to trust that certificate. For instructions on how to do this, see Configure the portal to trust certificates from your certifying authority.

If the service is from a federated server

  1. On the ArcGIS Server site that you have federated with the portal, start the services that you want to configure as utility services.

    You can do this by signing in to ArcGIS Server Manager with a portal member account with administrator privileges. Server Manager is typically available through a URL such as https://gisserver.domain.com:6443/arcgis/manager.

    The ArcGIS Server preconfigured print and geometry services are stopped by default.

  2. Sign in to the portal as a member of the default administrator role or a custom role with administrative privileges to manage utility services.
  3. Locate the service that you want to configure as a utility service and share it.

    How you share a service depends on who needs to use the functionality the service provides. For example, if you want anyone who connects to the portal to see thumbnails and print maps, share the print service with Everyone. If you want to allow your portal members to geocode locations, but you don't want anonymous users to do this, share the geocode service with the portal organization. If you want to restrict the use of analysis tools that require GeoEnrichment to the members of specific groups, share the GeoEnrichment service with those groups only.

  4. Open the details page of the service item and copy the URL at the bottom of the Overview tab.
  5. Open the Organization page of the portal and click the Settings tab.
  6. Click Utility services.
  7. Scroll to the appropriate utility service section and click the edit button.
  8. Paste the URL and, if necessary, append the task name to the service if it is a print service or route service.

    See the sections on specific utility services above for details.

  9. Click Save.

If the service is not from a federated server and requires credentials

  1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.
  2. Follow the steps to add an item from a URL. You must enable the option to Store credentials with service item.

    Because this is a secure service, you must provide credentials to access it. Type a valid username and password to access the service.

  3. Once the item is created for the service, share it with those who need to access the service.

    How you share a service depends on who needs to use the functionality the service provides. For example, if you want anyone who connects to the portal to see thumbnails and print maps, share the print service with Everyone. If you want to allow organization members to geocode locations, but you don't want anonymous users to do this, share the geocode service with the organization. If you want to restrict the use of analysis tools that require GeoEnrichment to the members of specific groups, share the GeoEnrichment service with those groups only.

  4. Copy the URL at the bottom of the Overview tab on the service item's details page.
  5. Open the Organization page of the portal and click the Settings tab.
  6. Click Utility services.
  7. Scroll to the appropriate utility service section and click the edit button.
  8. Paste the URL and, if necessary, append the task name to the service if it is a print service or route service.

    See the sections on specific utility services above for details.

  9. Click Save.

If the service is not from a federated server and does not require credentials

  1. Verify that you are signed in as a member of the default administrator role or a custom role with administrative privileges to manage utility services.
  2. At the top of the site, click Organization and click the Settings tab.
  3. Click Utility services.
  4. Scroll to the appropriate utility service section and click the edit button.
  5. Paste the URL and, if necessary, append the task name to the service if it is a print service or route service.

    See the sections on specific utility services above for details.

  6. Click Save.
  7. Repeat these steps as necessary to configure other services as your utility services.
Tip:

To reset the utility services back to their default URLs, delete the URL for each utility service you have configured and click Save. When you return to the Utility Services page, the URLs will be reset to their defaults.