Legacy versioned URLs of Workflow SaaS will target the latest version on July 17th, 2024

This notice only applies to users of the Geocortex Viewer for HTML5 and the Workflow Web AppBuilder widgets that have configured their applications to use a versioned Workflow URL.

By default, the Geocortex Viewer for HTML5 (GVH) and the Workflow Web AppBuilder (WAB) widget load various JavaScript resources from the Workflow SaaS environment at https://apps.vertigisstudio.com/workflow/latest/...

Note the "/latest/" segment in the URL. This refers to the latest version of the software. The Workflow SaaS environment also currently hosts all previous releases at URLs with explicit version numbers. For example:

• https://apps.vertigisstudio.com/workflow/5.0.0/...
• https://apps.vertigisstudio.com/workflow/5.1.0/...

In GVH and the WAB widget it was possible for administrators to use a specific version of Workflow rather than the default/latest version. This required specific manual configuration of a versioned Workflow URL.

• In GVH you would configure the “REST App Settings - Workflow 5 URL” setting.
• In WAB you would hand-edit the widget’s widget.js source file.

What is changing?

• On July 17th, all version specific URLs will be rerouted to return the content of the latest version.

Does this change affect me? Probably not.

• Less than 1% of the network traffic we receive targets a specific version. In the last six months only versions 5.26.0 and 5.28.0 were used.
• By default, GVH and WAB target the latest version so unless you manually changed it you are already on the latest.
• Even if you are using a fixed version, Workflow releases are highly backwards compatible, so the risk of a breaking change is low.

What can I do to test my environment in advance?

1. Verify whether you have changed the “REST App Settings - Workflow 5 URL” setting or widget.js.
2. Update any fixed version URLs to use “/latest/” rather than “/5.x.x/”.

What happens if I do nothing?

• Your environment will automatically start using the latest version.

Why is VertiGIS making this change?

• It is important to get all users onto software versions that receive security fixes.
• Based on usage statistics we can see that use of these fixed versions is very rare.
• The fixed versions are only used by applications built on the legacy 3.x ArcGIS API for JavaScript which will be retired on July 1, 2024.