Dot Notation Not Allowed in Job Variable Names

Breaking Change

This breaking change applies to the Platform 6 feature release.

The naming convention for job variables has changed in the Itential platform. Workflow job variable names can no longer contain the period character (.). Additionally, users can no longer run workflows which violate this rule. The correct form to use is shown below.

Naming Format

❌ INVALID: my.invalid.variable.name

✅ VALID: my_valid_variable_name

Note that in exported workflow documents, variable names are not presented in the same fashion as in the Workflow Canvas. The variable will include the job variable prefix $var.job., which includes dot notation. In this context, a valid equivalent to the example above would look like this: $var.job.my_valid_variable_name.

What should I do?

• If you have exported a workflow that includes dot notation in the job variable name, you may still import the workflow, but you will be required to change the variable name before you can run it.

• If you are upgrading your environment and there are existing workflows in the database that contain dot notation in the variable name, the upgrade may fail and throw an error. You will need to modify the variable name to meet naming requirements to ensure there is no dot notation.

• If you experience any issues, need assistance or require more information, please contact the Itential Customer Support Team.

Related Reading

• Naming Conventions