This content has been archived.

How to change auto-generated tab labels of work items in Dynamic Containers


In your PRPC 6.3 SP1 Case Manager portal, application users open one Dynamic Container to work with multiple work items. The work items display on tabs automatically labeled with the values of their respective work identifiers. By design, Dynamic Containers render multiple documents in a tab group, and each new work item is rendered in a separate tab that is created at runtime. However, if the auto-generated tab labels using pyID are too cryptic for application users, you may want to use the Suggested Approaches to rename them to display plain-language labels.


Auto-generated tab labels C-2, PO-99, T-185 can be more effective for business users if you re-label them Claim Process, Purchase Order, and Time Off, respectively.

Suggested Approaches

To change the text of tab labels auto-generated for a Dynamic Container, choose one of three approaches:

  • Call the function setLabel() in pega_ui_doc.js to set the label for your work item tab.

Setting the label in the UserWorkForm HTML fragment applies the tab name to all work types.

user work form html source setLabel

runtime output Search or Add Customer Request

  • As an alternative, set the label field to restrict it to a particular harness.

Setting the label on a harness will affect only that particular harness.

For example, the script shown below has been written in a custom section that is included in a New harness. You can also do this for Perform and Confirm harnesses that will appear as tabs.

section header setLabel

new harness layout

new work label Email Address

  • As a third alternative, specify the tab label by referencing a property value from the clipboard, as shown in this example:

user workform setLabel Clipboard property

Additional Information

User interface features in PRPC 6.3

How to add custom tab formats to your application skin

Suggest Edit

33% found this useful

Have a question? Get answers now.

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