Skip To Content

Configuring disconnected deployment for Custom Chart Builder

Available with Standard or Advanced license.

Available with Production Mapping license.

Available with Maritime Charting license.

You can deploy Custom Chart Builder (CCB) in a disconnected environment. This is necessary if there is no internet connection available or internet access is prohibited by your organization. Referenced sources must be replaced with locally available sources.

Note:

Registering the portal is required only for custom product types where sign-in capability is needed to add data layers to your map.

Registering your CCB app in portal

Use the following steps to add data from your portal:

  1. Register your web app and get the App ID.
    Note:

    At 10.8.1, skip this step if your web app is configured for the Fixed Product type. For the Custom Product type, this is an optional setting. If you want to activate sign-in capability and need to add data from your organization's account, this step is required.

    You can also register your web app through your portal

  2. Browse to C:\inetpub\wwwroot\ccb\js, if you are using Internet Information Server (IIS).
  3. For all Microsoft Windows operating systems, choose one of the following:

    • Windows 7 and earlier—Choose Windows Explorer.
    • Windows 8 and later—Choose File Explorer.

  4. Open the ccbconfig.js file and update the appId with the information you created in step 2.
  5. Click Save.

Updating JavaScript files

The following steps allow you to register your web app in your portal:

  1. Browse to the CCB folder in your web root folder. For example, browse to C:\inetpub\wwwroot\ccb if you are deploying your web app using Internet Information Server (IIS).
  2. In the widgets\AddData folder, open Widget.js.
  3. Update the portalUrl variable to https://portalserver.domain.com/arcgis.
  4. Click Save.
  5. In the widgets\LayerList folder, open Widget.js.
  6. In the appConfig section, update the portalUrl to https://portalserver.domain.com/arcgis.
  7. Click Save.
  8. In the js folder, open SignInButton.js.
  9. Uncomment // portalUrl: "https://portalserver.domain.com/arcgis", and update the portalUrl.
  10. Click Save.

Setting ArcGIS API for JavaScript

  1. Sign in to ArcGIS for Developers using your credentials.
  2. Browse to and download ArcGIS API for JavaScript 3.28.

    The extracted library is located on your local machine at <downloaded location>\arcgis_js_v328_api\arcgis_js_api\library.

  3. Create an arcgis_js_api folder at C:\inetpub\wwwroot\ccb\js if you are using IIS to deploy your web app.
  4. Copy the entire extracted library folder to C:\inetpub\wwwroot\ccb\js\arcgis_js_api\.
  5. Open the init.js file (at C:\inetpub\wwwroot\ccb\js\arcgis_js_api\library\3.28\3.28\) in a text editor.
  6. Browse through the .js file and replace https://[HOSTNAME_AND_PATH_TO_JSAPI]dojo with https://gisserver.domain.com/ccb/js/arcgis_js_api/library/3.28/3.28/dojo.
  7. Click Save and close the init.js file.
  8. Open the dojo.js file (at C:\inetpub\wwwroot\ccb\js\arcgis_js_api\library\3.28\3.28\dojo\) in a text editor.
  9. Browse through the .js file and replace https://[HOSTNAME_AND_PATH_TO_JSAPI]dojo with https://gisserver.domain.com/ccb/js/arcgis_js_api/library/3.28/3.28/dojo.
  10. Click Save and close the dojo.js file.
  11. Browse to the index.html file at C:\inetpub\wwwroot\ccb. Change the following style sheet paths:
    • Browse through the index.html file and replace //js.arcgis.com/3.28/dojo/resources/dojo.css with js/arcgis_js_api/library/3.28/3.28/dojo/resources/dojo.css.
    • Browse through the index.html file and replace //js.arcgis.com/3.28/dijit/themes/claro/claro.css with js/arcgis_js_api/library/3.28/3.28/dijit/themes/claro/claro.css.
    • Browse through the index.html file and replace https://js.arcgis.com/3.28/esri/css/esri.css with js/arcgis_js_api/library/3.28/3.28/esri/css/esri.css.
  12. Change the ArcGIS API for JavaScript path.

    Browse through the index.html file and replace http://js.arcgis.com/3.28/ with js/arcgis_js_api/library/3.28/3.28/init.js.

  13. Click Save and close the index.html file.

Setting Bootstrap

Complete the following steps to set Bootstrap:

  1. Download Bootstrap 3.1.1.

    The bootstrap.js and bootstrap.min.js files are in download path\bootstrap-3.1.1\bootstrap-3.1.1\dist\js on your local machine upon extraction.

  2. Create a bootstrap folder at C:\inetpub\wwwroot\ccb\js.
  3. Copy the bootstrap.js and bootstrap.min.js files to the bootstrap folder you created.
  4. Browse to the index.html file at C:\inetpub\wwwroot\ccb.
  5. Change the path for bootstrap from //netdna.bootstrapcdn.com/bootstrap/3.1.1/js/bootstrap.min.js to js/bootstrap/bootstrap.min.js.
  6. Click Save and close the index.html file.

Setting jQuery

Complete the following steps to set jQuery:

  1. Create a jQuery folder at C:\inetpub\wwwroot\ccb\js.
  2. Download and save the jquery-3.1.0.min files.
  3. Move the extracted files to the jQuery folder you created.
  4. Browse to the index.html file at C:\inetpub\wwwroot\ccb.
  5. Change the jquery-3.1.0.min file path from https://ajax.googleapis.com/ajax/libs/jquery/3.1.0/jquery.min.js to js/jQuery/jquery-3.1.0.min.js.
  6. Click Save and close the index.html file.

Updating basemaps

For more information about creating a map service and publishing it to the server, see FAQ: Can basemaps be used without an internet connection? on the support site.

Once the URL is generated, you must set the basemap to be the URL in the ccbconfig.js and ccbconfig_i18n.js files at C:\inetpub\wwwroot\ccb\js\.

basemap: https://gisserver.domain.com/arcgis/rest/services/yourBaseMap/MapServer,
Note:

While publishing a basemap, choose the Using tiles from a cache option on the Caching tab to draw a map service.

Updating a geometry service

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

  1. Sign in as a server manager by launching https://gisserver.domain.com/arcgis/manager.
  2. Browse to Services > Site(root).
  3. Click Utilities.
  4. Start Geometry Service.
  5. Browse through the ccbconfig.js and ccbconfig_i18n.js files at C:\inetpub\wwwroot\ccb\js\.
  6. Replace the geometryServiceUrl from https://tasks.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer with https://gisserver.domain.com/acgis/rest/services/Utilities/Geometry/GeometryServer.
  7. Click Save and close the ccbconfig.js and ccbconfig_i18n.js files.

Updating a locator service

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

  1. Browse to the ccbconfig.js and ccbconfig_i18n.js files at C:\inetpub\wwwroot\ccb\js\.
  2. Replace the geometryServiceUrl from https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer with the custom locator service URL.
  3. Click Save and close the ccbconfig.js and ccbconfig_i18n.js files.