Skip to main content


Adding a custom tool

Suggest edit Updated on June 30, 2021

This procedure uses the example scenario from Adding a subsection for similar tools.

  1. Right-click the handle (blue dot) of the Comment row for the section that you want to add tools to and click Add Sibling Below.

  2. Add a new page row.

    1. In the Action column, select Append and Map to.

    2. In the Target column, enter .pyRulesAndToolsList.

    3. In the Relation column, select a new page.

  3. Complete four Set rows for the top-level expandable section. In the Action column, select Set and then enter the following:

    RowTarget column valueSource column valueNote: Be sure to include the quotation marks
    1.pyNoteThe tooltip text to be displayed in Access Manager; a short description of the tool function.

    For example:"Retrieve number of items in worklist."

    2.pyPrivilegeThe privilege name.

    For example:"CanUseWorklistCounter"

    3.pyClassNameThe privilege class name.

    For example:"@baseclass"

    4.pyLabelThe tool function name to be displayed on Access Manager.

    For example:"Worklist items counter"

  4. Save the data transform.

For example:

The preceding example creates a custom tools section with a subsection for Worklist tools, as shown in the following figure:

Custom tools section with Worklist tools subsection

This data transform renders a section in Access Manager as shown in the following figure. (Refresh the display to see the changes.)

Access Manager section with Worklist tools subsection

In Access Manager, secure the tool. For more information, see Editing tools authorization for a single access group.
Did you find this content helpful? YesNo

Have a question? Get answers now.

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

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us