App launchers in Geovonic Connect enable you to pass information about selected map features to a third-party application for further processing. Optionally, they can open the third-party application within the user’s current context.
ArcGIS Experience Builder Launcher
The ArcGIS Experience Builder Launcher is used to open an Experience Builder app with some features (one or many) selected and the map zoomed to the selected feature(s). This launcher is designed to be called using the Launch by URL option – usually not from the Geovonic Connect widget (although it can be called from the widget if required).
Example use case: Your business system wants to open a map to show the location of a property or asset that the user is looking at.
Configuring the Launcher
Launcher Type: ArcGIS Experience Builder
The fully qualified URL of your Experience Builder app. Query parameters can be included in the URL.
Features Data Source
The name of the data source in your Experience Builder app, that relates to the layer containing your selected features.
You can find the name of the data source by enabling the Data selection option under the Manage URL status settings and then making a selection on the map. The data source name will appear in the browser’s location bar.
Map Widget ID
The ID of the map widget in your Experience Builder app.
You can find the name of the data source by enabling the Map option under the Manage URL status settings and then moving the map. The map widget ID will appear in the browser’s location bar.
Feature Layer URL
The web service URL for the feature layer containing your selected features. This is used to query the layer to find the extent of your selected features.
The URL typically ends in something like /FeatureServer/0 and can be found on the item details page of your layer in the ArcGIS portal.
Feature ID Attribute
The name of the attribute on your feature layer that contains the values you will be passing from your business system. The attribute name should be selected using the [+] button to ensure it is formatted correctly.
To use an attribute called ASSET_ID, the correct format will be {{f.ASSET_ID}}.
App Client ID and Secret
If your feature layer is public (shared with everyone), the App Client ID and Secret are not required. If your layer is not public, you must provide an App Client ID and Secret belonging to the user who owns the feature layer.
Instructions for creating an App in your ArcGIS portal can be found here.
Calling the ArcGIS Experience Builder Launcher
When creating the launcher you must enable the Launch by URL option. Once enabled, you will be shown a URL to be used to open Experience Builder.
The URL will end with ?features={{features}}. You should replace the {{features}} with your list of one or more IDs that match those in the Feature ID Attribute you have configured. The list of IDs is comma-separated.
If you are sending in asset IDs of ABC123 and XYZ987, the full URL will end with ?features=ABC123,XYZ987.