Available for an ArcGIS organization licensed with the Indoors extension.
ArcGIS Indoors includes support for launch actions to third-party apps directly from the info panel in Indoor Viewer. These launch actions enable Indoors organizations to easily integrate information from other business systems. A launch action can be configured to open a web page or native mobile app. This allows users to submit incidents or requests against a selected item in Indoors. Users can view information regarding a selected item from Indoors and automatically populate form fields with updated information using a web page or mobile app.
URL syntax
Launch actions are enabled by URLs, and the syntax must follow common URL conventions. For example, special characters in the arguments must be URL encoded, and the argument or value pairs must be separated with standard URL conventions.
For Indoors, values must be contained in curly brackets and match the following syntax:
?arg={Layer.Attribute}&arg={Attribute}
Note:
The layer is optional and if not included, it defaults to the currently selected item in Indoors. Many use cases require the passing of attributes from a different layer in the map or scene. This is supported with the layer operator. Arguments and values are not case sensitive.
See the following samples.
Single value
?Name={KNOWNAS}&building={facility_name}&space={Units.Name}
Multiple values
?center={shape.y},{shape.x}
Value from another feature class
&site={FACILITIES.SITE_ID}
Pass value to a specific field
&field:room={units.name}
Supported argument and value formats
The launch action URL can support either passing a value with a generic argument (field={Units.UNIT_ID}) or pointing the value at a specific field in the Survey123 form (field:room={Units.Name}).
In addition, multiple arguments can be listed together, and text can be entered among them.
Example
https://<MySurveyURL>?Name={knownas}&office=office%3A%20{units.NAME}&loc={shape.x},{shape.y},{shape.z}
Integration with Survey123
Survey123 is included with your license of Indoors. In the absence of any other supported work order or ticketing system, launch actions can be configured to use Survey123.
To customize the experience of the action button with Survey123, append valid argument or value pairs onto the URL.
Example: Base URL for default behavior
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal
Example: Custom
This example overrides the default room input with the name field from the Units layer.
https://survey123.arcgis.com/share/surveyformGUID?portalUrl=https://myportal.myorg.com/portal?field:room={Units.NAME}
Example: Launch the Survey123 native app on mobile devices
"url": "arcgis-survey123://?itemID=surveyformGUID&portalUrl=https://myportal.myorg.com/portal&field:comments={Units.NAME}"
Note:
Be careful when using URLs specific to native mobile apps when configuring launch actions for use in Viewer as these are not supported for desktop users. Using a native app URLs when defining launch actions should be limited to workflows supporting the native Indoors apps or Viewer accessed from a mobile browser.
Integration with third-party systems
The action button can also be configured to open a third-party URL and pass attribute values to it, provided that the third-party system supports URL configurable forms or parameters to drive actions upon launch. In this case, use a URL that calls the system in the Indoors app configuration with an appropriate URL for the integrated system. Some common uses are linking to third-party work order management systems or asset management systems.
Consider the following when working with third-party systems:
- The field: operator may be different.
- Web forms that support URL arguments may require additional configuration.
- Consult the integrated system documentation for details on whether and how this works.
Note:
In some cases, depending on the business system being used, some characters may not be supported, such as the # or + characters.
Integration with work order management systems
Indoors supports launching external asset and work order management systems. The action button on the info panel inViewer can be configured to open either a web form or third-party native app to be used to record new information such as incidents or requests associated with a space, asset, or other item in Indoors or open an existing work order in a third-party work order management app.
Indoors supports passing work order and Indoors layer attributes as a query string in the URL. The syntax must follow the URL schema for Indoors and work order app system to support launching.
The attribute value must be enclosed in curly brackets and match the following syntax:
?arg={Work order Attribute}&arg={Layer.Attribute}
The following are additional syntax samples:
Single value from work order layer
?arg={workorderid}
Multiple values from work order layer
?arg={workorderid}&arg={priority}
Value from work order and Indoors layer
?arg={workorderid}&arg={Layer.Attribute}
ServiceNow URL
The following sample passes the work order number as a parameter and opens an existing work order:
https://<MyServerURL>/nav_to.do?uri=task.do?sysparm_query=number={workorderid}
See more examples of configuring launch actions for ServiceNow.
Set the launch action configuration string
Launch actions can be configured for Viewer in multiple ways. A valid JSON configuration string can be specified in the Indoors Configuration table in ArcGIS Pro.
Launch actions can also be set in the configurator on the portal when an app is created from the Indoor Viewer template. In this scenario, if the launch action string is present in the Indoors Configuration table, it provides the default values for launch actions. Any changes made in the configurator panel overrides settings in the Indoors Configuration table.
Once app launch actions have been configured in the Viewer configurator, they can be exported for use in ArcGIS Indoors for iOS and ArcGIS Indoors for Android.