Support Article
Launch Harness action - Key field not built as documented
SA-3311
Summary
The Developer Help for the "Key" field when using a 'Launch Harness' action in an action set states that it should be set to the 'Key' (pxInsName) of the instance to be opened, whereby the "Class Name" property would also be used to uniquely identify the instance to be opened. However, when configured, the UIActionDisplayHarness activity fails because it omits the "Class Name" component from the DB lookup.
Error Messages
A NullPointerException is returned as the instance could not be located in the database, given the omission of the classname portion of the database's unique key.
Relevant stack trace from logs:
2014-10-07 07:25:00,876 [tp-bio-8080-exec-131] [TABTHREAD2] [ ] [uraUnitTest:01.01.01] ( internal.access.DatabaseImpl) ERROR your_URL.com|127.0.0.1senior1 - Cannot open the requested instance 'ORG10': class or class group "ORG10" does not exist.
2014-10-07 07:25:00,884 [tp-bio-8080-exec-131] [TABTHREAD2] [ ] [uraUnitTest:01.01.01] (splayHarness._baseclass.Action) ERROR your_URL.com|127.0.0.1 senior1 - Error opening page
com.pega.pegarules.pub.database.BadClassDefinitionException: Class ORG10 does not exist
From: (H2D00CD0F1F734A34E7D180F263B87E52:127.0.0.1)
at com.pega.pegarules.data.internal.access.DatabaseImpl.open(DatabaseImpl.java:4593)
at com.pega.pegarules.data.internal.access.DatabaseImpl.open(DatabaseImpl.java:4527)
at com.pegarules.generated.activity.ra_action_uiactiondisplayharness_8d3bda3fbad18b72e991c8cfb228b822.step5_circum0(ra_action_uiactiondisplayharness_8d3bda3fbad18b72e991c8cfb228b822.java:554)
at com.pegarules.generated.activity.ra_action_uiactiondisplayharness_8d3bda3fbad18b72e991c8cfb228b822.perform(ra_action_uiactiondisplayharness_8d3bda3fbad18b72e991c8cfb228b822.java:137)
Steps to Reproduce
1. Get the pxInsName of an instance to open in a harness on the clipboard (for example, through a Data Page)
2. Configure an action set on a property or control that uses the Launch Harness action.
3. Use "New Document", configure the Class Name according to the class of the instance in #1, and configure the Key as per the pxInsName (as described specifically in the Developer Help).
4. At runtime, perform the action that launches the harness.
Root Cause
The root cause of this problem is an error in product documentation. Original reported documentation bug is resolved in Pega 7.1.7.
Resolution
User is expected to use just the pzInsKey to correct the problem. The relevant documentation is scheduled to be fixed in a future release of Pega 7.
Published January 31, 2016 - Updated October 8, 2020
Have a question? Get answers now.
Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.