Promptsets containing ampersands and post processing fail to evalutate correctly

Document ID : KB000084601
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
U00021719 Syntax error in object 'JOBS.AMPERSAND', line '00000'. 'U01001308 Variable 'NAME2' has not yet been defined.'.

 A Workflow contains one job (JOBS). The job contains a Prompt Set. The Prompt Set contains on input-field for text. In the task properties of the job in the workflow, this value is filled with a string containing an ampersand &:

0EM0N000001i5kb.png

The job only pints this value in its script:

0EM0N000001i5kg.png

In the Postscript, there is only one exclamation mark !:

0EM0N000001i5kl.png

Trying to execute this, it fails:

0EM0N000001i5kq.png

For details see problem directory, RunIds in screenshot above. The error in the JOBS is:

U00021719 Syntax error in object 'JOBS.AMPERSAND', line '00000'. 'U01001308 Variable 'NAME2' has not yet been defined.'.

As you see in the error message above, the inserted name NAME1&NAME2 was cut at the &.

If you enter the name with three & (you escape it), the behavior changes:

0EM0N000001i5kv.png

For details see problem directory, RunIds in screenshot above. It fails with:

FAULT_POST_PROCESSING - Error in post processing.

But if you remove the post processing in the JOBS

0EM0N000001i5l0.png

it works with &&&:

0EM0N000001i5l5.png

For example, a name with an & cannot be passed correctly to the job from a Prompt Set. A workaround is to escape it with &&. However, as soon there is anything in the Post Script (as you see in the example it's only an exclamation mark), the job fails.

The documentation here deals with ampersand: https://docs.automic.com/documentation/webhelp/english/AWA/12.0/DOCU/12.0/AWA%20Guides/help.htm#AE_AWA_Source/Script/ucacvb.htm. and states, a second & for escaping should be sufficient. But is shows nowhere, that in such a case three ampersands are necessary. But then it only works as long as you use no post script.

Cause:
Cause type:
Defect
Root Cause: Using two ampersands (&&) characters did not work in post-process. Escaping a & character works for promptset values and can be used for normal script execution but lead to an error in post-process: "U00021719 Syntaxfehler in Objekt 'JOBS.1', Zeile '00000'. 'U01001308 Variable 'VAR' has not yet been defined.'."
Resolution:
Update to a fix version listed below or a newer version if available.

Fix Status: In Progress

Fix Version(s):
Automation Engine 12.2.0 - Planned release date: 2018-06-19
Automation Engine 12.1.1 - Available
Automation Engine 12.0.4 - Available
Automation Engine 11.2.7 - Available
Automation Engine 11.1.8 - Available
Additional Information:
Workaround :
Use a third ampersand and no post processing.