App configuration
There are three main app properties: map, widgetOnScreen, and widgetPool. The following table describes the attributes for app configuration.
Attributes | Description |
---|---|
theme | Object. Theme has three properties:
|
httpProxy | String. This can be proxy.jsp, proxy.php, or proxy.asp, depending on the web server. The default is true. httpProxy has the following properties:
|
portalUrl | String. If the viewer integrates with the portal, set the portal URL here. |
appId | String. Required for OAuth 2 login. |
logo | String. URL points to the logo file. |
title | String. The title of the app. |
subtitle | String. The subtitle of the app. |
links | Sets links to other resources. Each link has two properties: URL and label. |
map | See the map's configuration. |
WidgetOnScreen | Object. Can contain some widgets and widget groups. All the widgets and groups in this object load when the app starts. See Widget on-screen configuration. |
widgetPool | Object. Can contain some widgets and widget groups. All the widget groups in this object will not load by default. These widgets are controlled by controller widgets, which can read this configuration while starting and closing the widgets by sending messages to the app. See Widget pool configuration. |
isWebTier | Optional—Boolean. Determines whether web-tier authentication is used for the ArcGIS Enterprise portal. The default is false. |
geometryService | String. The URL of the geometry service used by widgets and the web map. If not set, it reads from the portal. |
wabVersion | String. The app's configuration version. |
loadingPage | Optional—Object. Only valid in the developer edition. Any property changes on the object do not affect the loading page. The configuration of the loading page is saved in it, and the code of the loading page is generated when the app is saved. |
mobileLayout | Object—Defines the app layout on a mobile device. Currently the app switches to mobile mode when the browser's width and height are less than 600 pixels. The content of the property is the same as the app configuration except that it only contains the position of the on-screen widget and group. To define the position of the widget and group, see the Create the layouts section in Create a theme. If a widget or group is not defined in mobileLayout, it will use the position defined in app config. |
templateConfig | Optional—Object. Only valid for the template and template app. It stores the template configuration and has the same properties as ArcGIS Online templates. See Add configurable parameters to templates. |
isTemplateApp | Boolean. Determines whether the app is created from a template. |
authorizedCrossOriginDomains | Array. Stores portal or server domains that use web-tier authentication. Caution:By default, Web AppBuilder reads the value of authorizedCrossOriginDomains from your portal and saves it in the app config file. If you want to change the value of authorizedCrossOriginDomains in the config file, go to your portal organization page and make the update. App config will sync the change when you save the app. |
appProxies | Array. The array of proxy items for specific URLs. Each proxy item contains the following parameters:
|
layoutDefinition | Object. Defines the layout of the on-screen widget and map. If this property does not exist, use jimu.js/layoutManagers/AbsolutePositionManager, which is the layout manager that Web AppBuilder has been using. It has the following two properties:
|
dataSource | Object. Defines the data sources in the app. There are two data sources: widget data source and extra data source.
|
keepAppState | Optional - Boolean. If true, the current map extent and the layer visibility will be kept before you leave the app so you can see the same map extent and layer visibility when open the app next time. |