Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

Launch harness action with dt parameter



User noticed is that if the user input (property) contains the "&" character anywhere in the parameter passed to data transform to launch a harness, an error is seen on the screen and the logs.

They noticed that this only happens if the launch action is configured as "New Document".

If that changes to "Popup Window", they do not see the error on the screen.

Error Messages

"There has been an issue; please consult your system administrator" and errors in the logs.

Steps to Reproduce

Design Time Configuration

An user input (autocomplete or text) control in a case say "Employee". On the Actions tab of the control, user has Event 1 as "Enter" key, action = Launch harness. Requirement is to pass the user input to the new harness, so as part of launching the harness we have a data transform that
takes a parameter. They pass the property of the control as parameter to the data transform.

Run-time Configuration

1. Log into the enviroment where above above use-case is implemented.
2. Launch CaseManager Portal
3. Click on New to create a new case. That is, "Employee" for an example.
4. Enter "&" in the "Employee Type" text input field.
5. Press "Enter". Observe issue.

Root Cause

A defect in Pegasystems’ code or rules,

Whenever there is a "&" in the DT parameter ( with property reference), then the URL is breaking due to parital encoding.

Need to encode the property reference value as well.


Apply Hfix-34227.

Hfix contains below changes:

Added ShowHarnesswrapper condition in the corrrectactionargs function call to encode the params in PZPEGA_UI_EVENTS.JS file

Suggest Edit

Published July 21, 2017 - Updated October 8, 2020

Did you find this content helpful? Yes No

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us