Skip To Content

Work in a disconnected environment

ArcGIS Enterprise is a repository for location-based data on your organization's network. Your ArcGIS Enterprise portal is an alternative to cloud-based hosting and provides access to all your organizational data on-site behind your firewall. ArcGIS Maps for Office works with ArcGIS Enterprise in much the same way that it does with ArcGIS Online, although some features are not available on the portal—specifically those related to an outside internet connection. For example, a layer showing a live data feed from ArcGIS Online (such as traffic information) will not work on ArcGIS Enterprise because the data requires an active internet connection. Additionally, if you plan to geocode lines or polygons, you must configure ArcGIS Enterprise to do so. For more information, see Configure your own geocode service in the ArcGIS Enterprise help.

Note:

ArcGIS Maps for Office supports ArcGIS Enterprise 10.3 or later; earlier versions are not supported.

To start working with ArcGIS Maps for Office with ArcGIS Enterprise, you need to do the following:

  • Host the resource files required by ArcGIS Maps for Office on your ArcGIS Enterprise portal.
  • Set your ArcGIS Maps for Office ArcGIS connection to point to your ArcGIS Enterprise portal instance.

Note:

ArcGIS Maps for Office currently only supports ArcGIS Enterprise configured using HTTPS.

Host the resource files

To use ArcGIS Maps for Office with ArcGIS Enterprise in your organization, you need to host the JavaScript and other resource files required by ArcGIS Maps for Office on your ArcGIS Enterprise portal.

Depending on the version of your ArcGIS Enterprise portal instance and the operating system on which it is installed, there are different ways to do this.

Note:

To have localized ArcGIS Maps for Office help on your portal, you must download and install the Portal Resources for the desired language. To have help available in multiple languages, download and install the Portal Resources for each language.

Windows

If you're using ArcGIS Enterprise 10.5 or later on a Windows server, install Portal Resources for ArcGIS Maps for Office directly on your portal. This is a one-time installation on the computer or server hosting your ArcGIS Enterprise portal instance. This installer also supports Portal for ArcGIS 10.3–10.4.1. This is the recommended method when possible.

  1. Browse to the ArcGIS Maps for Office download page.
  2. In the Is this for an ArcGIS Enterprise implementation? section, click Yes.
  3. From the ArcGIS Enterprise operating system drop-down menu, choose Windows.
    Download form for ArcGIS Enterprise on Windows
  4. Complete the form, providing your name, email address, company, and industry.
  5. Check the box to agree to Esri's privacy statement.
  6. Optionally choose to receive email updates from Esri.
  7. Click Submit.

    The download page appears with links to download the add-in and the resource files package.

    ArcGIS Maps for Office download links for ArcGIS Enterprise on Windows
  8. Download the ArcGIS Maps for Office installer and follow the installation instructions described in Install on a single computer.
  9. Click the ArcGIS Maps for Office Resources for Portal for ArcGIS 10.3 or higher link to download the executable.
  10. Run the installer on the Windows computer hosting your organization's ArcGIS Enterprise portal instance.
  11. Accept all default options to allow the installer to copy the necessary files to your portal.
  12. Set your ArcGIS connection.

Linux

For portals on operating systems other than Windows, you must manually host the files on the network.

Note:

You must be a system administrator to perform these tasks. You must have the permissions required to modify files on the computer running the ArcGIS Maps for Office portal web resources and the ability to host and make changes to a web server on your network.

To manually host the files on your network, do the following:

  1. Install and configure a web server such as IIS or Tomcat.

    This will be used to host the files needed for use by ArcGIS Maps for Office on your local network.

  2. Browse to the ArcGIS Maps for Office download page.
  3. In the Is this for an ArcGIS Enterprise implementation? section, click Yes.
  4. From the ArcGIS Enterprise operating system drop-down menu, choose Linux.
    Download form for ArcGIS Enterprise on Linux
  5. Complete the form, providing your name, email address, company, and industry.
  6. Check the box to agree to Esri's privacy statement.
  7. Optionally choose to receive email updates from Esri.
  8. Click Submit.

    The download page appears with links to download the add-in and the resource files package.

    ArcGIS Maps for Office download links for ArcGIS Enterprise on Linux
  9. Click the link to download either the ZIP file or the TAR file and extract the contents.

    The download package contains a folder named office.

  10. On your web server, create a virtual directory named ArcGISMapsWebRootContents.
  11. Create a set of subfolders named resources/arcgismapsforoffice/.
  12. In the new folder, create a subfolder that corresponds to the version of ArcGIS Maps for Office you're installing; for example, name the folder 5.0.
  13. Copy the office folder from the extracted ZIP file and paste it into the new folder on your portal machine.

    For example: ArcGISMapsWebRootContents/resources/arcgismapsforoffice/5.0/office

  14. On your ArcGIS Maps for Office client machine, open a file explorer and browse to the following location:

    C:\Program Files(x86)\ArcGISMaps\Office

  15. Using a standard text editor, open the following file:

    ESRI.ArcGIS.Mapping.OfficeIntegration.Excel.dll.config

  16. Change the ArcGISMapsWebRoot value to point to your ArcGISMapsWebRootContents folder on your web server (for example, <add key="ArcGISMapsWebRoot" value="https://localhost/ArcGISMapsWebRootContents/resources/arcgismapsforoffice/5.0/office"/>). Save the file.
  17. Repeat the previous step for the ESRI.ArcGIS.Mapping.OfficeIntegration.PowerPoint.dll.config file located in the same folder. Save the file and exit the text editor.

    Note:

    If a user opens Excel or PowerPoint before you complete the ArcGIS Maps for Office configuration, the changes made to the Program Files(x86) folder won't work. In this case, delete the configuration files from the roaming directory for the user (for example, C:\Users\<username>\AppData\Roaming\ArcGIS Maps). The next time Excel and PowerPoint are started, ArcGIS Maps for Office will detect that the files are missing and copy the correct files into the roaming directory.

  18. Set your ArcGIS connection.

Set your ArcGIS connection

To connect ArcGIS Enterprise to ArcGIS Maps for Office, you need the following information about your portal:

  • ArcGIS Enterprise portal server URL
  • Name of web adaptor

For example, say your ArcGIS Enterprise portal server URL is https://myPortal.example.com, and your administrator configured your web adaptor to be arcgis. In this case, the URL to your ArcGIS Enterprise portal would be https://myPortal.example.com/arcgis. By default, the web adaptor for the portal is arcgis, but it can be changed by your organization's administrator. If you are unsure of what to use as your web adaptor, ask your ArcGIS Enterprise administrator.

Note:

ArcGIS Maps for Office currently only supports ArcGIS Enterprise configured using HTTPS.

When you install ArcGIS Maps for Office for the first time, the installation wizard prompts you to define your connection settings. In the text box next to My ArcGIS Portal, provide the URL to your ArcGIS Enterprise portal instance as described above.

To change the ArcGIS Maps for Office configuration, do the following:

  1. Start Microsoft Excel or PowerPoint. Click the File tab on the ribbon to display the Backstage view.
  2. Click ArcGIS Maps.

    The ArcGIS Maps Configuration settings page appears.

    Settings for ArcGIS Maps

    By default, ArcGIS Maps for Office uses ArcGIS Online (https://www.arcgis.com).

  3. In the ArcGIS Connection text box, provide the URL to your ArcGIS Enterprise portal instance.

    Note:

    Depending on the security policy in your organization, your web browser may try to block the login page. If the login page is blocked, add the website to the Trusted Sites list in the browser settings.

  4. Restart ArcGIS Maps for Office to apply the changes.
  5. Restart Excel (or PowerPoint), click the ArcGIS Maps tab on the ribbon, and click Sign In to log in.