Adapt a Geocortex Viewer for HTML5 to Work with On-Premises Workflow

By default, Geocortex Viewer for HTML5 viewers load VertiGIS Studio Workflow resources from the cloud. If you have installed VertiGIS Studio Workflow on premises, you can adapt a viewer to load resources from your on-premises installation by modifying Workflow URLs in the viewer's configuration files.

To adapt a Geocortex Viewer for HTML5 viewer to work with your on-premises Workflow installation:

  1. In your Geocortex Essentials installation, locate the configuration files for the viewer that you want to adapt.

    By default, the configuration files are here:

    C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\Default\REST Elements\Sites\[site_name]\Viewers\[viewer_name]\VirtualDirectory\Resources\Config\Default\

    where [site_name] is the name of the site that [viewer_name] belongs to.

    The configuration files are called:

    • Desktop.json.js
    • Tablet.json.js
    • Handheld.json.js

  2. Edit a configuration file as an administrator.

  3. To find the URLs to replace, search for apps.vertigisstudio.com.

    The string that contains the URL is:

    "https://apps.vertigisstudio.com/workflow/latest/dist/hosts/gvh/loader.js!"

    There are two instances of the URL, one in the libraries section and the other in the WorkflowHost module. To point a viewer at your installation, you must change both instances.

  4. In both instances of the URL, replace this:

    apps.vertigisstudio.com/workflow/latest

    with this:

    [host.domain.com]/[virtual_path]

    where [host.domain.com] is the fully qualified name of your server and [virtual_path] is the virtual path that you specified on the Post Installer's IIS Settings panel. The default virtual path is /vertigisstudio/workflow.

    The resulting strings should look something like this:

    "https://myserver.myorganization.com/vertigisstudio/workflow/dist/hosts/gvh/loader.js!"

    Be sure to include the exclamation point at the end of each URL.

  5. Save the file.

  6. Repeat these steps for each configuration file that you use.

    The configuration files that you modified now point to your on-premises installation of VertiGIS Studio Workflow.

  7. If you have additional viewers that you want to adapt, repeat this procedure for each viewer.