Script versioning

Use the script versioning feature of ION Scripting to manage script versions and update data flows without interruption.

A script can have multiple versions, each containing different code. Input and Output Variable properties, including name, data type, and count, cannot be changed between versions to maintain compatibility.

A script version has one of these statuses:

  • Draft
  • Approved

When a script is created, it is in Draft status. Draft versions can be used in modeled data flows, but they prevent flow activation. Approve all scripts used in a data flow before activating the flow.

Note:  Activated data flows always use the latest approved version of a script. When a new version is approved, data flows do not require reactivation. After the current run of the previous version completes, subsequent runs use the newly approved version.

Before you can approve a draft version, it must be valid. A script is valid when:

  • The script contains code.
  • Input and Output Variable names are declared.
  • Library dependencies do not have an error status.
  • The runtime of the script and all libraries matches the Python compatible runtime version.
Note:  ION Scripting does not validate syntax, programming errors, or stylistic issues in the code.

On the modeling page, the Versions widget displays all available versions. The currently open version is highlighted. When you open a script from the Overview page, the latest version is displayed by default. To review a previous version, select it in the Versions widget.

The Versions widget displays these details for each version:

  • Script version number
  • Script version status
  • Python compatible runtime version
  • Last updated date and time
  • Last updater's username

Click the Check mark icon to approve a draft version. The status changes from Draft to Approved.

Approved versions are read-only. You can modify the test input and run tests.

To modify an approved version, create a new draft version. You can create a draft from any approved version.

On an approved version, click the Edit icon to create a new draft. Each new draft increments the version number. Deleted version numbers are not reused.

To delete a version, click the Trash icon in the Versions widget. You cannot delete the currently open version or the last approved version. The delete action is permanent and does not require saving.