Skip to main content


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

Multiple entity intake

Updated on March 23, 2021

The multiple entity intake feature enables you to capture information about multiple persons in a single step.

Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide Pega Government Platform Implementation Guide

For many applications, there is always a need to capture information of all the family members as part of a single step. For each person, you can mention a relationship (for example, parent, child, grand parent, and so on).

While capturing the details of a person, you can either select an existing person in the system or create a new person.

A part of the case life cycle section that shows how to add the multiple entity
                    intake component.

Multiple entity intake components

For multiple persons feature, Pega Government Platform offers components that you can use from App Studio for the following scenarios.

Manage multiple persons (flow)
Use to capture the details of multiple persons: person ID, role, salutation, first name, last name, email, country, and address. This flow also validates the information added. After submission, the person details are persisted to the person table.
Capture multiple persons details (flow action)
Use to capture details of multiple persons: person ID, role, salutation, first name, last name, email, country, and address.
Persist multiple persons (flow)
Use to persist new persons details to person table.
Multiple persons RO (section)
Use to display the list of persons captured.

Implementing multiple entity intake

Add the multiple entity intake component when you build a case type. Many government applications require you to capture details of multiple persons as a part of the intake process, for example, multiple nominees, multiple beneficiaries, and so on.

Configuring and extending multiple entity intake in a single screen

Configure and extend the multiple entity intake feature in a single screen.

  1. Log in to Pega Government Platform as an administrator.
  2. In the header of your workspace, click the Switch Studio menu, and then click App Studio.
  3. In the navigation pane of App Studio, click Case types.
  4. From the Case types column, click a case type, or click the New button to create a new case type.
  5. In the Case life cycle section, click Stage, and then enter a name in the text box.
  6. Hover over process, and then click +STEPMoreProcessesManage multiple persons.
  7. Click the Select button.
  8. In the Parameters section, in the Label box, enter a title for the component, for example, Dependent details.
  9. In the Routing details area, select an operator:
    • To route the assignment to the current operator, click Current operator.
    • To specify a user or operator to whom you want to route this assignment, click Specific user, and then, in the User field, select a user or enter a property in the work class that supplies a specific operator ID at run time.
    • To route the assignment to a specific work queue, click Work queue, and then, in the Queue field, select a work queue name or enter a property in the work class that supplies a specific work queue at run time.
  10. Click Save.

Adding new fields to the intake screen

Update the BasicPersonDetails (PegaPS-Data-Entity-Person) report definition to add new fields to the intake screen for each person that is captured.

  1. Log in to Pega Government Platform as an administrator.
  2. In the header of your workspace, click the Switch Studio menu, and then click App Studio.
  3. In the navigation pane of App Studio, click Case types.
  4. From the Case types column, click Add person.
  5. In the Case life cycle section, click Stage, and then enter a name in the text box.
  6. Hover over process, and then click +STEPMoreProcessesManage person with basic details.
  7. Click Save and run.
  8. Click the Edit form icon to configure the view.
  9. Click the section to which you want to add a field.
  10. Click the Add icon.
  11. Expand Fields, and then click the Add to view icon.
  12. Click Submit.

Updating relationship list values

Add new or update the existing values of the relationship list.

  1. In the navigation panel of Dev Studio, click Data types.
  2. Click Data typesOption map.
  3. Click the Records tab.
  4. Click the filter for the Field name / Group column.
  5. In the Search Text box, enter PersonPerson and then click Apply.

    A list of all the possible values for the relationships appears.

  6. Click a record to open it, and update it as required.
  7. If you want to add a new record, click Add record.
  8. Click Save.
    Part of the Option map data type that shows adding or customizing a
                            record.

Configuring and extending multiple entity intake in separate screens

Configure and extend the multiple entity intake feature in separate screens.

The following are the supported components.

  • Manage person with basic details
  • Manage person with complete details
  1. Log in to Pega Government Platform as an administrator.
  2. In the header of your workspace, click the Switch Studio menu, and then click App Studio.
  3. In the navigation pane of App Studio, click Case types.
  4. From the Case types column, click a case type, or click the New button to create a new case type.
  5. In the Case life cycle section, click Stage, and then enter a name in the text box.
  6. Hover over process, and then click +STEPMoreProcessesManage person with basic details.
  7. Click the Select button.
  8. Click Save.
  9. Capturing the details of another person

  10. Click the Data model tab, and then click the Add field button.
  11. In the Field name field, enter the name for the field, for example, Father.
  12. In the Type list, select Embedded data.
  13. In the Data object list, select Person.
  14. Click the Single record button, and then click Submit.

  15. Click the Workflow tab and configure the process that you added.

    Entity ID
    Enter or select the Entity ID of Father if it is available so that the component automatically gets the details from SOR and fills the appropriate fields. If this is left blank, a new entity is created with all the details submitted.
    Include in MyCases
    Select this if you want to show the current case in MyCases of the entity.
    Person Page
    Select the property of the Person type into which you must capture the details of the father and add quotes at both ends, for example, “.Father”. The details are captured into the Father property.
    Label
    Provide an instruction to the user, for example, Enter father details.

Extending multiple entity intake in separate screens

To add new fields to the screens, update BasicPersonInfo or PersonDetails (PegaPS-Data-Entity-Person) based on the component used.

For more information on adding new fields to screens, refer to Adding new fields to the intake screen.

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