Skip To Content

Configure a disconnected deployment for the JavaScript Viewer 3.19

Available with Workflow Manager license.

When deploying the JavaScript Viewer in a disconnected environment when there is no Internet connection available, or Internet access is prohibited by your organization, referenced sources need to be replaced with locally available sources.

Deployment in disconnected environments

The following need to point to local resources:

  • ArcGIS API for JavaScript
  • ArcGIS services
    • Maps
    • Geometry service
    • Locator services
  • Third-party software
Tip:

For more information on how to configure the resources and services in a disconnected portal, see Configure a disconnected deployment.

ArcGIS JavaScript API

Complete the following steps to determine, download, and modify the version of ArcGIS JavaScript API to be used:

  1. Determine the version of ArcGIS API for JavaScript in use by the application from the index.html file.
  2. Download the appropriate version of ArcGIS API for JavaScript and deploy it to your web server.
  3. Note:

    If deploying the JavaScript Viewer to Portal for ArcGIS, ArcGIS API for JavaScript comes preinstalled at /portal/jsapi/jsapi/. If the version of the JavaScript API is not compatible with the version used in the application's index.html file, you may need to download and install the appropriate version.

  4. Modify the deployed index.html file and replace the references shown below with locally installed versions.

    Replace the first example below with one of the two that follow it:

    <link rel="stylesheet" href="//js.arcgis.com/[version]/esri/css/esri.css"> 
    <script type="text/javascript" src="//js.arcgis.com//[version]/"></script>
    <link rel="stylesheet" href="//[your-server].[domain]/jsapi/esri/css/esri.css"> 
    <script type="text/javascript" src="//[your-server].[domain]/jsapi/"></script>
    <link rel="stylesheet" href="//[your-server].[domain]/portal/jsapi/jsapi/esri/css/esri.css"> 
    <script type="text/javascript" src="//[your-server].[domain]/portal/jsapi/jsapi/"></script>

ArcGIS services

Modify the deployed js/app/WorkflowManager/config/AppConfig.js file to reference local services.

Map services

Specify the properties for the basemap gallery widget for use with your offline maps. The widget only supports tiled map services. The following information allows you to update the map section with your offline maps:

Basemap galleryDescription
map.basemapGallery

Specifies the properties for the basemap gallery widget for use with your offline maps. The widget only supports tiled map services.

For more information on supported types that include tiled base maps, see BasemapLayer class.

  • isEnabled—Specifies whether to enable a map gallery for selecting basemaps.
  • showArcGISBasemaps—Set to false since ArcGIS Online basemaps are not available offline.
  • defaultBasemap—Update your custom basemap name.
  • customBasemaps—Update to your local basemap services. Remove streets, hybrid, and topographic basemaps that are references to ArcGIS Online services. The following is an example:

    customBasemaps : [
      {
        id: “localbasemap",
        title: "localbasemap",
        layers: [{
          url: "https://[hostname].[domain]/arcgis/rest/services/[localbasemap]/MapServer"
        }],
        thumbnailUrl: "js/widget/gis/BasemapGallery/images/localbasemap.jpg"
      }
    ]

Custom basemapDescription
map.customBasemap

Specifies the properties for a nontiled map service to be used as the application’s basemap. This configuration is used when the basemap gallery option is unavailable.

  • type—Specifies the type of the nontiled map service. Supported types include mapimage and imagery.
  • url—Specifies the REST URL of the map service.
  • options.id—Specifies the ID of the map service.
  • options.opacity—Specifies the opacity of the map service.
Note:

Other property configurations are available. Refer to the appropriate map service layer configuration for options.

Geometry service

Use geometryServiceURL to update to a local geometry service installed with ArcGIS Server, for example, http://[hostname].[domain]/arcgis/rest/services/Utilities/Geometry/GeometryServer.

Locator services

The default locator service is configured to use ArcGIS Online and is not available for disconnected deployments. You'll need to provide your own locator services in a disconnected deployment.

DescriptionLocator service
locatorSources

[your customized locator services]

For more information, see the Search widget's sources property.

Third-party software

The JavaScript Viewer uses the online Font Awesome font and CSS toolkit. You need to download the toolkit and deploy it locally for disconnected environments.

  1. Download Font Awesome version 3.2.1.
  2. Unzip and copy the folder to the deployment directory of your web application, for example, C:\Inetpub\wwwroot\wmviewer\font-awesome\ArcGIS\Portal\apps\workflow\font-awesome.
  3. Modify the deployed index.html file.
  4. Replace the online Font Awesome reference with any of the following locations:

    Replace the first example below with one of the two that follow it:

    <link rel="stylesheet" type="text/css" href="//netdna.bootstrapcdn.com/font-awesome/3.2.1/css/font-awesome.css">
    <link rel="stylesheet" type="text/css" href="//[hostname].[domain]/wmviewer/workflow/font-awesome/css/font-awesome.css">
    <link rel="stylesheet" type="text/css" href="//[hostname].[domain]/portal/apps/workflow/font-awesome/css/font-awesome.css">