Query JSON and Apply a regular expression deprecation FAQ

We have made changes and improvements to the Query JSON and Apply a regular expression actions. Read through this FAQ to better understand how this may impact you.

What is changing with the Query JSON and Apply a regular expression actions?

To support ease of configuring and testing the Query JSON and Apply a regular expression actions, new versions of the actions are now available. The existing Query JSON and Apply a regular expression actions are being deprecated April 30, 2020.

The new version of the Query JSON and Apply a regular expression actions run on the .NET expression engine, which is more common and widely-used as opposed to the versions being deprecated, which run using Ruby.

As a step to making the actions easier to configure and test, you can now validate the expressions. If you click the Check expression button in the configuration panel of the new Query JSON and Apply a regular expression actions, you will be taken to the Apply a regular expression in the Nintex platform tools where you can validate the expressions.

Important change in Apply a regular expression

The previous Apply a regular expression action was not returning the correct results, specifically with the Replace operation; as a workaround, users were manipulating the response to achieve what was expected.

In the new version of Apply a regular expression, this is no longer required.

What are Nintex platform tools?

The Nintex platform tools provide users the capability to quickly check expressions instead of executing the workflow to test the actions.

How can I determine if my workflows are impacted?

Your workflows will be impacted if you have any workflows that contain Query JSON or Apply a regular expression actions, that were configured before September 24th, 2019.

When you edit your workflow, we will automatically assess whether any deprecated actions exist; these workflows will be identified with a warning banner on the Designer page.

If you do not have any workflows that contain Query JSON or Apply a regular expression actions, no further action is required.

How do I fix my workflows?

Before April 30, 2020, you will need to apply the following steps to all workflows that use Query JSON and/or Apply a regular expression actions:

  1. Identify a workflow that contains Query JSON and/or Apply a regular expression actions. Edit the workflow.
  2. In the Designer, deprecated actions are identified with a warning. Open an action that has been marked with a warning.
  3. Take note of your action configuration. Make the appropriate adjustments to convert the expressions from Ruby to .NET.
  4. In the action toolbar, search for Query JSON or Apply a regular expression. All search results will only display the newest version of the action.
  5. Drag on a new action and configure the action with the new .NET expression.
  6. Delete the old version of the action.
  7. Repeat the previous steps for all marked Query JSON or Apply a regular expression actions in the workflow.
  8. Publish your workflow.

Repeat this for all workflows containing a Query JSON or Apply a regular expression action.

If you need more guidance on identifying workflows that may be affected, contact Nintex Support.

What happens if the actions are deprecated and I still have published workflows using the old versions of the actions?

On April 30, 2020, we will deprecate the old versions of Query JSON and Apply a regular expression actions. If you have not updated these actions before the deprecation date, your workflows will begin to fail.

What do I do if I have further questions or need assistance with this change?

Contact Nintex Support to ask any questions or to schedule a call.