> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/workflows/designing-workflows/processes/process-execution/upgrading-your-scripts-for-collibra-2024-02-compatibility.md).

# Upgrading your scripts for Collibra 2024.02 compatibility

We are upgrading the Collibra workflow engine to use Jakarta EE, starting with Collibra version 2024.02. The Jakarta EE APIs (`jakarta.*`) have a different package structure than Javax EE APIs (`javax.*`), causing workflow scripts that use `javax.*` functions to fail after the upgrade.

## Recommendations

To keep all of your workflows running smoothly after the upgrade:

* You must update [your workflows](#Custom) that use Javax EE `javax.*` functions.
* You must restart [running workflows](#Running) that are impacted by this change if there are still tasks to be executed that use Javax EE `javax.*` functions.

{% hint style="danger" %}
Do not publish updated workflows with Jakarta EE `jakarta.*` functions before the 2024.02 release.
{% endhint %}

### Custom workflows

You must update your scripts if you have workflow script tasks or scripts stored in the **groovy-lib** directory that use Javax EE `javax.*` functions by replacing `javax.*` with `jakarta.*`.

{% hint style="warning" %}
The **javax** packages that are part of the Java SDK are not impacted by this change and they require no update. Some commonly used **javax** Java SDK packages are:

* javax.net
* javax.crypto
* javax.script
* javax.xml.parsers
* javax.swing
* javax.management
* javax.imageio
* javax.xml.validation
  {% endhint %}

{% hint style="info" %}
To help with this transition, we have identified a number of commonly used classes that you don't need to change starting with Collibra version 2024.02 and that are supported until Collibra version 2024.05:

* javax.ws.rs.core.UriBuilder
* javax.xml.bind.DatatypeConverter.printBase64Binary
* javax.mail.\*
* javax.activation.\*
* javax.servlet.http.Cookie
  {% endhint %}

### Running workflow instances

When you publish a new version of a workflow and there is a running instance of the same workflow, the running workflow continues to use the old version until it completes. If there is a Javax EE `javax.*` function that still needs to be executed and that is not compatible with Jakarta EE, the workflow fails.

After you have identified and published the workflows that require an update, check if any of the workflows that are currently running need to be restarted:

{% stepper %}
{% step %}
[View the running workflow instances](/workflows/managing-workflows-in-collibra/view-running-workflow-instances.md).
{% endstep %}

{% step %}
Delete the workflow instance if required.
{% endstep %}

{% step %}
Restart the updated workflow.
{% endstep %}
{% endstepper %}

## Additional resources

* [Collibra Support](https://support.collibra.com)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/workflows/designing-workflows/processes/process-execution/upgrading-your-scripts-for-collibra-2024-02-compatibility.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.