Configure Launch Links

From version 5.2 of GXM, it is possible to open a GXM app from within an external application, for example another GIS application. In addition, you can also use a launch URL to run a workflow and pass in specific parameters so that the GXM app opens in a specific state, for example, showing a specific feature with directions to that feature.

If you plan to run a workflow when the app opens, you need to configure a Triggerable workflow to use in the Launch Link before you create the link itself.

You can run a single workflow at start up and the workflow must be registered with the app. You register a workflow by

Create a Launch Link to a Specific App

You can create a launch link to any GXM app under Deploy by clicking the icon beside the Development, Testing, Staging or Production stage of that app. The launch link is different for each stage of the app just as there is a specific copy of the web map and the app for each stage.

To create a launch link to a specific app:

  1. Open or create an app in Geocortex Mobile Designer and click Deploy.

    If you have unsaved changes, you will be asked to save the app.
  2. Beside the stage of the app that you want to create a link to, click the icon, and then click Get Launch Link.

    The App Launch Link window opens. The name of the window changes to reflect whether you are linking to a Development, Testing, Staging or Production app.

  3. You can do any of the following:

Register a Workflow to Run with a Launch Link

If you plan to run a workflow with a launch link, the workflow must exist before you can add it to the launch link URL. You also need to register the workflow with the specific app in Mobile Designer in Launch Link Workflows component. When you register the workflow, you can give it a specific icon and title that appears in the GXM app when the workflow runs.

It is important to know whether the workflow you plan to use does, or does not, use a Display Form. If the workflow uses a display form, you must turn on Contains Forms when you register the workflow, or the GXM app will display an error and will not open.

To register a launch link workflow:

  1. Create or open an app in Geocortex Mobile Designer.

  2. In the Configure Components panel, click Launch Link Workflows.

  3. In the Launch Link Workflows panel, click +Add Workflows.

    The Select Items window opens and by default, lists the workflows that the current user has created - My Content.

    To display workflows created and shared by others in your organization, change the filter to Shared With Me.

    To search for a specific workflow by name, enter a part of the name, and then click Search.

  4. Click a workflow in the list, and then click Select.

    The workflow is listed in the Launch Link Workflows panel.

  5. Click a workflow to open the Workflow panel, where you can do any of the following:
  6. Click File | Save.

    The workflow is registered and you can now go to Deploy and create a launch link that includes this workflow.

Create a Launch Link That Includes a Workflow

Once you have registered your workflow, you can create a launch link that uses it.

To create a launch link containing a workflow:

  1. Open or create an app in Geocortex Mobile Designer and click Deploy.

    If you have unsaved changes, you will be asked to save the app.
  2. Beside the stage of the app that you want to create a link to, click the icon, and then click Get Launch Link.

    The App Launch Link window opens. The name of the window changes to reflect whether you are linking to a Development, Testing, Staging or Production app.

    Because you have registered a workflow with the app, the Workflow to run is a drop-down list from which you can select the workflow you want.

  3. Click the down arrow in the Workflow to run drop-down list and select the workflow you want to run when this launch link is activated.

    For other settings to apply in the App Launch Link, see Create a Launch Link to a Specific App.

    The launch link and workflow are ready for you to include in an app.

© 2019 Latitude Geographics Group Ltd. All Rights Reserved.

Documentation Version 5.2