Notice of upcoming breaking changes to two Workflow activity packs

This post describes upcoming breaking changes to the ArcGIS Maps SDK for JavaScript and ArcGIS Utility Network REST API Workflow activity packs that are scheduled to be released on May 1st, 2024.

This only applies to you if ALL of the following are true:

• You are using one of the following affected activity packs:
  • ArcGIS Maps SDK for JavaScript (workflow-activities-arcgis-core)
  • ArcGIS Utility Network REST API (workflow-activities-utility-network)
• You manually registered the activity pack using a https://unpkg.com/... URL that does not specify a version number. For example:
  • https://unpkg.com/@vertigis/workflow-activities-arcgis-core/activitypack.json
  • https://unpkg.com/@vertigis/workflow-activities-utility-network/activitypack.json
    as opposed to a URL with an explicit version number like:
  • https://unpkg.com/@vertigis/workflow-activities-arcgis-core@1.10.0/activitypack.json
  • https://unpkg.com/@vertigis/workflow-activities-utility-network@4.0.1/activitypack.json
  • Note: If you registered the activity pack using the Activity Packs panel in Workflow designer it automatically uses URLs with explicit version numbers, so you won't be affected.
• You are using the activity pack in one of the following application versions:
  • VertiGIS Studio Web version 5.21 or older
  • Experience Builder Workflow Widget version 1.4.0 or older

The solution is to:

1. Update your activity pack registrations to use URLs with explicit version numbers.
   1. Navigate to the activity pack registration portal item.
   2. Select the Settings tab.
   3. Update the URL property to reference an explicit version of the activity pack.
2. Open each workflow that uses the affected activity packs in Workflow designer and save it.

This change will take effect May 1st, 2024.

What is the reason for the breaking change?
Back in Workflow version 5.31 (January 2023) the Workflow NPM package was renamed from @geocortex/workflow to @vertigis/workflow. VertiGIS Studio Web 5.22 (and newer) and the Experience Builder Workflow Widget 1.5.0 (and newer) are aware of this change and treat the two packages as synonymous which has preserved backwards compatibility up to now. However, to allow these activity packs to use the latest and greatest capabilities in Workflow we must update them to reference the latest version of @vertigis/workflow. When we release that update on May 1st, 2024, those older versions of Web and the ExB widget will fail if they try to run a workflow containing these activity packs that now depend on the @vertigis/workflow package.