Skip To Content

Frequently asked questions

What are the licensing requirements for ArcGIS Maps for SharePoint?

ArcGIS Maps for SharePoint requires a level 2 membership in an ArcGIS Online organization plan or ArcGIS Enterprise deployment to work with ArcGIS and interact with the map. You can sign up for a free ArcGIS Online trial. Public ArcGIS Online accounts are not supported.

While users can view the map as guests without needing to sign in, these users have limited access to the map: in addition to viewing publicly shared ArcGIS Maps for SharePoint content and publicly shared ArcGIS content, guest users can pan and zoom the map, turn layers on and off, and view pop-ups, but most functionality is restricted to viewing only.

After upgrading to ArcGIS Maps for SharePoint 4.2, you may experience problems configuring SSS or generating an encryption key.

In some instances, after upgrading ArcGIS Maps for SharePoint from 4.1 to 4.2, the following configuration errors may occur:

  • The Use Secure Store Service (SSS) to encrypt credentials option in the configuration pane is not available.
  • The Generate your own encryption key option does not generate an encryption key.

To resolve these issues, de-activate and re-activate the app. Do the following:

Prerequisite: You must be a SharePoint site collection administrator to access the ArcGIS Maps for SharePoint administration menu and configure the app.

  1. Browse to the Site Settings page of the site.
  2. Under the Site Collection Administration heading, click Site collection features.

    The Site collection features page lists all the features available for your site collection and their activation status.

  3. Locate the ArcGIS Maps for SharePoint feature and click Deactivate.

    A confirmation page appears.

  4. Click Deactivate this feature to confirm.
  5. On the Site collection features page, click Activate to re-activate the feature.
  6. Return to the Site settings page and click ArcGIS Maps for SharePoint Administration > App configuration.
  7. Configure the app.

When running the ArcGIS Maps Locate workflow, the fields do not appear on the Choose the columns with location information page.

This issue can occur with Portal for ArcGIS 10.2.1 through 10.4.1 on Linux servers. If this occurs, ensure that the geocoding service used is shared with everyone.

The ArcGIS Maps Locate workflow does not complete successfully when using a custom geocoder and ArcGIS Enterprise.

To successfully run the ArcGIS Maps Locate workflow in Portal for ArcGIS 10.3 through 10.4.1 or in ArcGIS Enterprise 10.5 and later, configure the geocoder service according to the If the service is not from a federated server and requires credentials section in the Configure utility services topic in your ArcGIS Enterprise documentation.

How can I use Esri GeoEnrichment services?

Esri GeoEnrichment services provide demographic and contextual data for features in your map. GeoEnrichment requires a subscription to ArcGIS Online or configuration of GeoEnrichment on your installation of ArcGIS Enterprise.

How do I connect to services in a firewalled environment?

Why does ArcGIS Maps for SharePoint store properties in configuration lists?

Some shared properties used across ArcGIS Maps for SharePoint components are stored in lists at the site collection and site level to provide flexibility and ease of use in configuration. Exposing the properties in lists accommodates scenarios where it is appropriate to allow nonadministrative users to configure these properties and scenarios where these should only be editable by administrators. Users of ArcGIS Maps for SharePoint components do not need edit rights to the configuration lists. Additionally, using lists for configuration provides an intuitive, easy-to-use user interface (UI) that will be familiar to most SharePoint users.

I created a new site collection within a web application that has ArcGIS Maps for SharePoint, but the components and configuration lists are not available.

ArcGIS Maps for SharePoint is not automatically activated when you create a new site collection. For new site collections, browse to the Site settings page, click Site collection features, and activate the ArcGIS Maps for SharePoint feature. This makes all the functionality included with ArcGIS Maps for SharePoint available on the site collection.

Can I use existing lists with latitude-longitude data?

SharePoint lists can contain numerical columns that store the geographic location of each item as latitude and longitude coordinates. To geocode such lists so they can display on the ArcGIS Maps web part, add the ArcGIS Location field to the list and specify the latitude-longitude fields when setting the location field's properties.

How do I import Excel spreadsheets for use with ArcGIS Maps for SharePoint?

See Prepare SharePoint data for information on importing Excel spreadsheets to SharePoint.

Error message: Your browser configuration does not support sending secured content. Your sign-in was canceled to ensure password safety.

This happens when using an older version of Internet Explorer (IE8) that uses a proxy page hosted through http (as is done with ArcGIS Maps for SharePoint). ArcGIS Maps for SharePoint provides a configuration setting, AllowSignInOverHttpProxy, which is set to False by default. This setting prevents the user's password from being transmitted over http, which is not secure, instead of https. This setting can be changed to True if it is acceptable to send a password over http instead of https.

To change the configuration setting, do the following:

  1. Open the Configuration settings page by typing the following URL in your browser's address field: <your site collection root>/lists/esri maps configuration settings.
  2. In the AllowSignInOverHttpProxy entry, click the More button More and choose Edit item.
  3. Change the value to True and click Save.

In SharePoint 2010, you receive one of the following error messages:

  • An invalid ArcGIS Portal URL was entered. Please verify the URL.
  • Unable to access the authentication service.
  • Your Workflow failed: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.
  • Your Workflow failed: Generating request token failed. System.Exception: Generating token request failed.

This error message is specific to SharePoint 2010 and is the result of a certificate error in SharePoint. To resolve this error message, download the certificate and add it to the SharePoint server using the steps below:

Download the certificate

Note:

You may need elevated permissions (Run As Administrator) to copy the certificate.

  1. Browse to https://www.arcgis.com (or the portal you are using). Ensure you use https.
  2. Click the Security Report icon (padlock) in the URL address bar.
  3. Click View certificates on the Website Identification window that appears.
  4. Click the Certification Path tab on the Certificates window.
  5. Select DigiCert and click View certificate.

    Important: Be sure to select the root certificate (DigiCert), not one of the sub-entries; you need the entire contents of the package.

  6. Click the Details tab on the Certificates window.
  7. Click Copy to File to start the Certificate Export Wizard.
  8. On the first page of the Certificate Export Wizard, click Next.
  9. Select the Base-64 encoded X.509 (.cer) option and click Next.
  10. Save the file to a known location on disk and click Next on the Certificate Export Wizard.
  11. Click Finish. A message appears stating that the export was successful.

Import the certificate to SharePoint

  1. Open SharePoint Central Administration in a browser, with elevated permissions (Run As Administrator).
  2. Click Security and click Manage Trust under the General Security heading.
  3. Click New, specify a name, and browse to the root certificate you saved in the previous steps.
    Note:

    Do not delete the existing local certificate.

  4. Click OK. The certificate in now added to the SharePoint server instance.

Users who are not signed in to a SharePoint site see a 403 (Forbidden) error when trying to view a page that contains an ArcGIS Maps web part.

If you have a public-facing site collection that doesn't require users to sign in, if pages within that site collection contain ArcGIS Maps web parts, you must enable anonymous access for the SharePoint site, and enable ArcGIS Maps guest access for users to be able to view the map.

Tip:

As a best practice, it is recommended that you use a dedicated SharePoint web application to serve public-facing site collections.

To enable anonymous access in your SharePoint site collection, do the following:

  • Enable SharePoint anonymous access on the web application level
  • Enable SharePoint anonymous access on the site collection level

Enable SharePoint anonymous access on the web application level

You must be a SharePoint farm administrator to complete these tasks.

  1. From SharePoint Central Administration, under Application Management, click Manage Web Applications.

    The Web Applications page opens, listing available applications.

  2. From the list, click the web application for which you want to enable anonymous access and, on the ribbon, click Authentication Providers.

    A window appears, showing the authentication providers available per zone. In a basic scenario, only the Default zone is listed.

  3. Click Default.

    The Edit Authentication window opens.

  4. Check the Enable Anonymous Access checkbox and clear the Require Use Remote Interfaces permissions box if it is checked.
  5. Scroll to the bottom of the window and click Save. Close the Edit Authentication window and exit SharePoint Central Administration.
  6. Open SharePoint Management Shell with elevated permissions (Run as Administrator).
  7. To allow users to add SharePoint data to an ArcGIS Maps web part, run the following script, replacing the values in brackets with the URL of your web application:
    $webapp = Get-SPWebApplication <"http://myWebApplication">
    $webapp.ClientCallableSettings.AnonymousRestrictedTypes.Remove([microsoft.sharepoint.spweb], "GetSebwebsForCurrentUser")
    $webapp.ClientCallableSettings.AnonymousRestrictedTypes.Remove([microsoft.sharepoint.splist], "GetItems")
    $webapp.ClientCallableSettings.AnonymousRestrictedTypes.Remove([microsoft.sharepoint.splist], "GetChanges")
    $webapp.Update()

Enable SharePoint anonymous access on the site collection level

You must be a SharePoint site collection administrator to complete these tasks.

  1. Navigate to one of the site collections you created under the configured web application and open the Site Settings page.
  2. Under the Users and Permissions section, click Site permissions.
  3. From the ribbon, click Anonymous Access.

    The Anonymous Access configuration window opens.

  4. From the Anonymous users can access options, choose Entire Web Site.
  5. Clear the Require Use Remote Interfaces permission check box and click OK.

    A new group named Anonymous Users appears on the site permissions list. After these configurations are complete, anonymous users that are unknown to both SharePoint and ArcGIS will be able to view ArcGIS Maps.

Error message: Could not load file or assembly, Microsoft.SqlServer.Types, Version=11.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91, or one of its dependencies.

When running the workflow to connect to external data, you may encounter the error message, Could not load file or assembly Microsoft.SqlServer.Types, Version=11.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91, or one of its dependencies. This error message can occurs on systems with SQL Server, which does not always provide version 11 of the Microsoft.SqlServer.Types assembly. Follow the steps below to install version 11 of the Microsoft.SqlServer.Types assembly to the Global Assembly Cache (GAC) of the SharePoint server machine.

  1. Download the Microsoft SQL Server 2012 SP1 Feature Pack from http://www.microsoft.com/en-us/download/details.aspx?id=35580.
  2. When prompted to choose the download, select ENU\x86\SQLSysClrTypes.msi or ENU\x64\SQLSysClrTypes.msi, depending on whether the server is 32 bit (x86) or 64 bit (x64).
  3. Save the file to the server machine and run it.
  4. Restart IIS.

Error message: Failed to load Extension pack manifest file. Verify that the JSON content is valid.

Manifest files must be saved with UTF-8 encoding. If you receive this message when adding an extension pack, check to see if the file was saved with Byte Order Marker (BOM). If it was, remove the BOM using an advanced text editor such as Notepad++ and save the file.

Use UTF-8 encoding for manifest file