Configure an ArcGIS Workflow Manager JavaScript Viewer 4.3—Workflow Manager for Server

Available with Workflow Manager license.

Configure application settings

The JavaScript Viewer can be customized to use authentication and custom maps by configuring the application and map settings. To configure an application, and map and proxy settings, modify the deployed js/app/WorkflowManager/config/AppConfig.js file.

The following table lists the various application settings that can be configured:


Application setting	Description
app.ServiceRoot	Specifies the REST URL of the Workflow Manager service.
app.AuthenticationMode	Specifies whether to use ArcGIS Server token authentication, Portal for ArcGIS authentication, Windows authentication, or no authentication. Note: Portal for ArcGIS authentication is available in ArcGIS Workflow Manager for Server 10.3.1 and later.
app.TokenService	Specifies the URL of the ArcGIS token service. Applicable only if AuthenticationMode is set to Token authentication.
app.PortalURL	Specifies the URL of Portal for ArcGIS. Applicable only if AuthenticationMode is set to Portal authentication.
app.Appld	Specifies the application ID of the viewer after it is registered with Portal for ArcGIS. Applicable only if AuthenticationMode is set to Portal authentication.
app.DefaultUser	Specifies the default user name for the web application. Note: The user must be a valid Workflow Manager application user.
app.AutoLogin	Specifies to automatically log in the default user when the application is opened. Note: This applies only when no authentication is used and a valid Workflow Manager user is set as the default user.
app.DefaultQuery	Specifies the default query upon launch of the application using the query path. The query path includes all the container names indicating the hierarchy, separated by backslashes.
app.jobLOILayer	Configuration for the dynamic Location of Interest (LOI) map service. The LOI map service is comprised of the Point of Interest (POI) feature class (optional) and Area of Interest (AOI) feature class with the feature classes being the topmost layers. url—Specifies the REST URL of the LOI map service POILayerID—(Optional) Layer ID of the POI feature layer within the map service AOILayerID—Layer ID of the AOI feature layer within the map service Note: Support for a new POI feature class was added to ArcGIS Workflow Manager for Server at 10.4.
proxy.url	Specifies the location of the proxy.
geometryServiceURL	Specifies the location of the ArcGIS geometry service.

Configure map settings

If you wish to use different basemaps than the default basemaps you can configure the map settings. You can configure the basemap toggle with tiled map services. Refer to the BasemapToggle widget for supported basemap types.

For dynamic map service support, configure the custom basemap section of the configuration file.

Note:

The following table lists the various map settings that can be configured:


Map setting	Description
map.basemapToggle	Specifies the properties for the basemap toggle widget. The widget only supports tiled map services. isEnabled—Specifies whether or not to enable a map toggle for selecting basemaps. showArcGISBasemaps—Specifies whether or not to use ArcGIS Online basemaps in the basemap toggle. If this property is set to false, custom basemaps will have to be configured defaultBasemap—Specifies the ID of the basemap to use as the default basemap nextBasemap—Specifies the ID of the basemap to use as the secondary basemap in the basemap toggle. customBasemaps – Specifies the basemaps to be displayed in the basemap toggle instead of ArcGIS Online basemaps.
map.customBasemaps	Specifies the properties for a non-tiled map service to be used as the application’s basemap. This configuration is used when the basemapToggle option is unavailable. type—Specifies the type of the non-tiled map service. Supported types include map-image and imagery properties.id—Specifies the ID of the map service properties.url—Specifies the REST URL of the map service properties.opacity—Specifies the opacity of the map service Note: Other property configurations are available. Refer to the appropriate map service layer configuration for options.
map.initialExtent	Specifies the application's AOI map extent on log in.
map.search	Specifies the application's search controls for the map. zoomLevel—Specifies the zoom scale to use for the result if there is no associated zoom scale for the result. customSources—Specifies the custom locator sources to use to find search results. If no custom sources are specified, the default locator sources will be used.

Configure proxy settings

If you are using proxy, configure the proxy setting.

Configure the proxy settings for the application. Modify the deployed proxy/proxy.config file.

The following table lists the proxy setting that can be configured.


Proxy setting	Description
serverUrl	Specifies the Workflow Manager Server REST endpoint. Change myserver to the hostname of your ArcGIS Server.

Set up a localized viewer for supported languages

Workflow Manager JavaScript Viewer supports the following additional languages:

Chinese (Simplified): zh-CN
Italian: it
Russian: ru
Spanish: es
Turkish: tr

To configure a supported language, complete the following steps:

Open the deployed index.html (or index.aspx) file.
Remove ‘//’ (uncomment) from the locale you want to use with the application.
For example:
```
locale: es
```
Note:
Only one language can be configured at a time.
Save index.html (or index.aspx).

The JavaScript viewer will open in the locale selected in the deployed index.html (or index.aspx) file.

Feedback on this topic?

Configure application settings

Note:

Note:

Note:

Note:

Configure map settings

Note:

Note:

Configure proxy settings

Set up a localized viewer for supported languages

Note:

In this topic