App launchers are used to trigger workflows or open applications. The app launcher is typically triggered by a map user selecting the launcher tool: in some circumstances, app launchers can be triggered directly from a web request with no map selection. This is referred to as Launch by URL.

The Launch by URL feature is often used when opening an ArcGIS Experience Builder app from your business system. The app launcher uses information from your business system to open the map with the correct configuration for the required operation.

Enabling Launch by URL

From an App launcher configuration, navigate to the Launch by URL section and turn on the switch.

When turned on, a URL will be shown. Click on the copy icon to copy the URL to your clipboard.

Sending Parameters

If your App Launcher requires parameters (which it probably will), the example URL will show you how to include your data as part of the URL.

For example, the URL might look like this …

https://connect.geovonic.com/us/api/launch/028013cc?request-id={{request-id}}&user={{user}}

When calling the URL you should replace the parts shown in curly brackets with your data. For example …

https://connect.geovonic.com/us/api/launch/028013cc?request-id=abc123&user=GARY

Disabling for Widget Users

By default any App Launcher linked to a feature layer will appear in the Geovonic Connect widget if the map includes the layer. If you only want to use the Launch by URL option and exclude it from the map, this can be done when authoring your application in the widget properties.