Prepare the Workflow Widget for Experience Builder

To use Experience Builder apps to host workflows, you must first prepare the widgets. You only need to do this one time, and then you can use the widgets in as many apps as you want.

VertiGIS Studio Workflow supports two editions of Experience Builder. The way that you prepare the widgets depends on the edition of Experience Builder you use:

Follow the instructions for the edition of Experience Builder you use:

Register the Widgets with Experience Builder Enterprise Edition

To register a widget with Experience Builder Enterprise Edition, create an application item in your portal that points to the widget's manifest.json file.

After you have registered the widgets, share the widget items with other Workflow authors in your organization. This allows them to configure their Experience Builder apps to run workflows. If the widgets are not shared, the other authors will not see the widgets in Experience Builder.

If you would like to host the widget on your own server download the vertigis-studio-workflow-experience-builder-widget-ENTERPRISE.zip widget from here and follow these steps.

To register the Workflow widgets with Experience Builder Enterprise Edition:

  1. Sign in to Portal for ArcGIS as an administrator.

  2. In Content, click Add Item and select Application. The New Item window opens.

  3. Configure the item:

  4. Set the Application Type to Experience Builder widget.

  5. In the Manifest URL box, enter the URL to the manifest.json file for the widget you want to register.

    You can either use the copy of the manifest.json file in your local Workflow deployment or, if your portal has Internet access, you can use the public copy: https://static.vertigis.com/exb-widgets/workflow/[version]/manifest.json

    You can find the public URL for the version you wish to use here

    Example configuration for a Workflow widget's manifest in Portal for ArcGIS

  6. Click Next.

  7. Enter a meaningful title in the Title box, for example: VertiGIS Studio Workflow

  8. Click Next.

You should see a new item in your content list. You will see the widget in Experience Builder Enterprise Edition at the bottom of the widget panel under the Custom section.

Download and Deploy the Widget to Experience Builder Developer Edition

The VertiGIS Studio Workflow widget allows you to use ArcGIS Experience Builder Developer Edition to host and run workflows.

To prepare the widget for Experience Builder Developer Edition, download the widget and then copy it to your Experience Builder installation.

This procedure assumes that you have already installed Experience Builder, which you can download here. Follow these instructions to install it.

To download and deploy the Workflow widget:

  1. Download the vertigis-studio-workflow-experience-builder-widget-DEVELOPER.zip widget from here/.

  2. Locate the root of your Experience Builder installation in Windows Explorer.
    By default, the root is called ArcGISExperienceBuilder.

  3. Extract the widget zip file to the root. The widget will automatically move to the correct folder location within your Experience Builder installation.

    The widget is stored in the Experience Builder folder: \[root]\client\your-extensions\widgets.

    • If the widget is 2.0 or later, proceed to step 4.
    • If the widget is earlier than 2.0, proceed to step 5.
  4. Navigate to the widget folder using the command cd \[root]\client\your-extensions\widgets\workflow, and run npm i to install the widget dependencies.

  5. Restart the Experience Builder client and server services.
    The Workflow widget appears in the Experience Builder Widgets panel.

    If you see this error: x failed to resolve only because it was resolved as fully specified, follow the instructions under the Update Webpack section in the README.md file found in the vertigis-tools folder at the root of your project.

You will see the widget in Experience Builder Enterprise Edition at the bottom of the widget panel under the Custom section.