Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Preparing additional association fields for publishing

Updated on May 4, 2022

Ensure that your remote application can correctly publish your additional association fields to Pega Process Fabric Hub by configuring the pyPF_SetRequest data transform in your remote application. For example, you can publish a case participant additional field that passes information about the case participant's email address.

Note: You can add association fields if your remote application uses Pega Process Fabric Hub Connector for Pega Platform version 8.6 which is compatible with Pega Process Fabric Hub version 2.1. For more information about Pega Process Fabric Hub connector components, see Pega Marketplace.
Before you begin:
  • Create or use existing properties that you want to pass as fields to Pega Process Fabric Hub. For more information, see Properties.Note: As a best practice, create additional properties and configure the pyPF_SetRequest data transform before you register your application to Pega Process Fabric Hub. If your business scenario requires adding custom fields to a registered application, stop the sync between the application and Pega Process Fabric Hub, configure additional fields, and then start the sync with Pega Process Fabric Hub. For more information, see Managing applications in Pega Process Fabric Hub.
  • Ensure that you prepare your Pega Process Fabric Hub and your remote system for publication. For more information, see Preparing for extending your data model with additional fields.
After you install the Pega Process Fabric Hub Connector component, your remote application includes multiple instances of the pyPF_SetRequest data transform that apply to different classes. The instance that you select depends on the class that stores your custom data model fields.
  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the Data Model category, and then click Data Transform.
  3. In the list of data transform instances, open the pyPF_SetRequest data transform that applies to the class that contains your additional fields:
    • To edit a data transform for fields that you store in the Link-Association-Follow class, open the pyPF_SetRequest data transform that applies to the Link-Association-Follow class.
    • To edit a data transform for fields that you store in a class that is different from the Data-Party-Operator class, open the pyPF_SetRequest data transform that applies to the Data-Party-Operator class.
    • To edit a data transform for fields that you store in the System-Queue-PPF-Connect-Association class, open the pyPF_SetRequest data transform that applies to the System-Queue-PPF-Connect-Association class.
  4. Copy the data transform into your application ruleset:
    1. On the rule form header, click Save as.
    2. On the Save as Data Transform form, in the Context section, in the Add to ruleset list, select your application ruleset.
    3. Click Create and open.
  5. On the Pages & Classes tab, click Add item.
  6. In the Page name field, enter RequestPage.custom.
    RequestPage.custom is a page that stores additional properties to pass to Pega Process Fabric Hub.
  7. In the Class field, enter $NONE.
  8. On the Definition tab, click Add a row.
  9. In the Action column of the new row, select Update Page.
  10. In the Target column, enter RequestPage.custom.
  11. In the new row that is displayed, in the Action column, select Set.
  12. In the Target column, select the field that you want to publish to Pega Process Fabric Hub.For example: To add a field that represents the email address of a case participant, enter .email.
  13. In the Source column, enter a value that you want to assign to the field.For example: To display the email address, enter "Participant email address".
    Note: The values that you add can be constants or autopopulated fields.
  14. Optional: To add more fields, repeat steps 8 to 13.
  15. Click Save.

Mapping additional association fields

For the correct publication and display of your additional association fields in Pega Process Fabric Hub, ensure that you map properties that correspond with the fields between your remote application and Pega Process Fabric Hub by configuring the appropriate data transform.

For example, in your remote application, you can create an .email property that corresponds with the field that stores the email that is related to the case association. Then, in Pega Process Fabric Hub, you create a .Email property that can accept data from your remote application and that you can use to display the email address at run time. Finally, you map the property from your remote application to the property in Pega Process Fabric Hub.
Before you begin: In Pega Process Fabric Hub, create properties that match properties in your remote application. Matching properties can have different names in both applications. Ensure that the properties are of the scalar, page list, or page group type and that you store the properties in the PPF-Data-Ext-Association-Participant class. For more information, see Properties and Configuring page, page group, and page list properties. You configure the PopulateAdditionalFields data transform in the PPF-Data-Ext-Association-Participant class in Pega Process Fabric Hub.Note: Configuration of the PopulateAdditionalFields data transform applies to properties of the scalar, page list, or page group type. If your properties use advanced logic, copy and then modify the PopulateAdditionalFields activity that applies to the PPF-Data-Ext-Association-Participant class. Modifications to the PopulateAdditionalFields activity depend on your unique business scenario. For more information, see Configuring steps in an activity.
  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the Data Model category, and then click Data Transform.
  3. In the list of data transform instances, click the PopulateAdditionalFields data transform that applies to the PPF-Data-Ext-Association-Participant class.
  4. Copy the data transform into your ruleset:
    1. On the rule form header, click Save as.
    2. On the Save as Data Transform rule form, in the Context section, in the Add to ruleset list, select a ruleset to store the data transform.
    3. Click Create and open.
  5. On the Definition tab, click Add a row.
  6. In the Action column, select Set.
  7. In the Target column, enter the property that you store in Pega Process Fabric Hub.For example: Enter .Email.
  8. In the Source column, enter the property that you store on the RequestPage.custom data page in your remote application.For example: Enter .email.
  9. Optional: To add more properties, repeat steps 5 to 8.
  10. Click Save.
  11. Optional: To perform an operation by using default or additional fields after saving an association field, override the PPF-Link-Association-Participant.PostSaveExtension activity and then add your logic based on your business requirements.
    For more information, see Configuring steps in an activity.
  12. Optional: To perform an operation by using default or additional fields after you delete an association field, override the PPF-Link-Association-Participant.PostDeleteExtension activity and then add your logic based on business requirements.
    For more information, see Configuring steps in an activity.

Optional: Validating additional association fields

If your business scenario requires restricting input in additional association fields, you can validate the properties that correspond with the fields. As a result, you ensure that case participant associations in Pega Process Fabric Hub are error-free and meet your business requirements.

For example, you can create a property that stores an email address related to a case participant, and then create validation to ensure that users provide the email address in a valid format.

To provide validation for case fields, you configure the ValidateAdditionalFields validate rule, or if your properties use advanced validation logic, the ValidateAdditionalFields activity. You then configure the MapToAPIFields decision table that applies to the PPF-Data-Ext-Association-Participant class. The validate rule and the activity store conditions for validation, as well as the MapToAPIFields decision table, map the properties from your remote application to the properties from Pega Process Fabric Hub.

As a result, Pega Process Fabric Hub can display error messages that include property names from the remote application so that you can quickly identify and investigate a property that fails validation.

  1. Provide validation for assignment fields:
    ChoicesActions
    Use standard validation logic for your properties and configure the ValidateAdditionalFields validate rule.
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the Process category, and then click Validate.
    3. In the list of validate rule instances, click the ValidateAdditionalFields validate rule that applies to the PPF-Data-Ext-Association-Participant class.
    4. On the validate rule form, click Save as.
    5. On the Save as Validate rule form, in the Context section, in the Add to ruleset list, select a ruleset to store the validate rule, and then click Create and open.
    6. On the Validate tab, create validation for your properties with required conditions.
    7. On the Validate form, click Save.
    Use advanced validation logic for your properties and configure the ValidateAdditionalFields activity.
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the Technical category, and then click Activity.
    3. In the list of activity instances, click the ValidateAdditionalFields activity that applies to the PPF-Data-Ext-Association-Participant class.
    4. On the activity rule form, click Save as.
    5. On the Save as Activity form, in the Context section, in the Add to ruleset list, select a ruleset to store the activity, and then click Create and open.
    6. Modify the validation method for your property.
      Modifications of the ValidateAdditionalFields activity depend on your unique business scenario. For more information, see Configuring steps in an activity.
    7. On the ValidateAdditionalFields activity rule form, click Save.
  2. Configure the MapToAPIFields decision table:
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the Decision category, and then click Decision Table.
    3. In the list of decision table instances, click the MapToAPIFields decision table that applies to the PPF-Data-Ext-Association-Participant class.
    4. On the decision table rule form, click Save as.
    5. On the Save as Decision Table form, in the Context section, in the Add to ruleset list, select the ruleset in which to store the decision table, and then click Create and open.
    6. On the Table tab, in the field name column, enter the property from Pega Process Fabric Hub that you want to validate.
    7. In the Return column, enter the matching property from your remote application.
    8. Optional: To map more properties, on the toolbar, click Insert Row After, and then repeat steps 2.f and 2.g.
    9. Click Save.

Optional: Displaying additional association fields

Incorporate your additional association fields in reports and then use the reports in your landing pages, which helps users manage the cases. For example, you can create additional fields that correspond with the email address of a case participant, and then add the fields to the GetResolvedCases and GetUnresolvedCases report definitions. As a result, Pega Process Fabric Hub displays your additional fields on the My Cases landing page.

You add custom case fields to reports by configuring the GetResolvedCases and GetUnresolvedCases report definitions that apply to the PPF-Work-Case class and a MyCasesTable section. You perform the configuration in the system that hosts Pega Process Fabric Hub.

  1. Configure the GetResolvedCases report definition:
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the Reports category, and then click Report Definition.
    3. In the list of report definition instances, click the GetResolvedCases report definition that applies to the PPF-Work-Case class.
    4. In the rule form header, click Save as.
    5. On the Save as report definition form, in the Context section, in the Add to ruleset list, select a ruleset to store the report definition.
    6. On the Query tab, click Add column.
    7. In the Column source column, enter the property from Pega Process Fabric Hub that you want to display.
      Note: Ensure that you start the property name with .Custom. For example, to add a field that stores the email address of a case participant, enter .Email.
    8. In the Column name column, enter a label for the field that you want to use in reports.For example: Enter Participant email address.
    9. Optional: To add more properties, repeat steps 1.f through 1.h.
    10. On the Pages & Classes tab, in the Page name field, enter MyCasesTable.
    11. Click Save.
  2. Configure the GetUnresolvedCases report definition:
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the Reports category, and then click Report Definition.
    3. In the list of report definition instances, click the GetUnresolvedCases report definition that applies to the PPF-Work-Case class.
    4. Repeat steps 1.d through 1.k.
  3. Configure the MyCasesTable section:
    1. In the navigation pane of Dev Studio, click Records.
    2. Expand the User Interface category, and then click Section.
    3. In the list of section instances, click the MyCasesTable section that applies to the PPF-Work-Case class.
    4. On the rule form header, click Save as.
    5. On the Save as section form, in the Context section, in the Add to ruleset list, select a ruleset to store the report definition, and then click Create and open.
    6. On the Design tab, click a column in the table next to which you want to display an additional field, and then, on the toolbar, click either Insert column before selected or Insert column after selected, based on your requirement.
    7. Double-click the header of the new column, and then, in the Cell Properties dialog box, in the Value field, enter a label for the new column.For example: Enter Email Address.
    8. Click Submit.
    9. Double-click the cell in the new column, and then, in the Cell Properties dialog box, in the Property field, enter the additional assignment property from Pega Process Fabric Hub.For example: Enter .Custom.Email
      For more information about configuring sections, see Section form - Completing the Design tab.
    10. Click Submit.
    11. Optional: To add more fields, repeat steps 3.f through 3.j.
    12. Click Save.

  • Previous topic Preparing additional case fields for publishing
  • Next topic Optional: Displaying additional fields in Swagger

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

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

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us