Skip to main content
close Search
Close search


Designating a relevant record

7 Aufgaben

30 Min.

Für alle Benutzer sichtbar
Anfänger Pega Platform 8.2 English


The Human Resources (HR) department wants to allow HR business partners to update the start date for an employee while the onboarding case is open. If the start date changes, both the employee and the manager receive a confirmation email.

The following table provides the credentials you need to complete the exercise.

Role Operator ID Password
Senior System Architect SSA@TGB rules

Your assignment

Create a process to allow an HR business partner to update the start date for an employee. Create the process in Dev Studio so that you have more control over which records are made available to developers in App Studio. Configure the process with:

  1. An assignment shape with the preconfigured flow action AdjustStartDate. The flow action references a preconfigured section that has a read-only field that displays the current start date and an editable field where the HR business partner can set a new start date.
  2. A step to send an email to the employee. Create an email correspondence that contains the following text:
    As discussed in our telephone conversation, your start date has changed from <<.Employee.StartDate>> to <<.NewStartDate>>.
  3. A data transform to set the value of the employee start date using the value of the new start date, then to delete the new start date from the clipboard.

Add the process to the Relevant Records list to make the process available in App Studio. In App Studio, add the process as a case-wide optional action for the Onboarding case type.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Genaue Übungsschritte

1 Designate a relevant record

Follow these steps to create a process flow from Dev Studio:

  1. From Dev Studio, click Create > Process > Flow.
  2. In the Create Flow window, in the Label field, enter Update Start Date.
  3. Set the context to the Onboarding case.
  4. Click Create and open to create the Update Start Date process flow.

2 Configure an assignment shape to edit the start date

Follow these steps to configure the assignment shape Update Start Date, in which an HR business partner can update the start date for an employee:

Note: The flow rule includes an assignment shape labeled Update Start Date by default.
  1. Right-click the connector between the assignment shape and the end shape.
  2. Click View Properties to open the connector properties.
  3. In the Connector section, in the Flow action field, select AdjustStartDate.

    flow action
  4. Click Submit.

3 Configure a Send Email step to notify the employee of the start date change

Follow these steps to add and configure a Send Email step to notify the employee of the start date change:

  1. In the flow rule, click the plus then Automations > Send email to add a Send email shape.
  2. Double-click the shape to begin configuration.
  3. In the Automation details section, configure the shape to send the email to the .Employee.pyEmail1 field.
  4. Enter the email subject as Start date change confirmation.
  5. From the Message drop-down list, click Correspondence to compose an email correspondence.
  6. In the Correspondence template field, enter UpdateStartDate, then click the crosshairs icon to create a correspondence rule.
  7. On the Create Correspondence form, in the Correspondence Type field, enter or select Email, then click Create and open to create the rule.
  8. In the text field, enter the email body as specified in the Your assignment section. Insert properties for the employee start date and new start date.
  9. Click Save to finish composing the email content.
  10. Return to the Update Start Date flow rule.
  11. Click Submit to complete the Send Email step configuration.

    Image of Automation Details popup
  12. Adjust the connectors so that the connector from Update Start Date leads to Send email.
  13. Add a connector from Send email shape to the end shape.


4 Configure a data transform to set the new start date

Follow these steps to create a data transform to update the Employee Start Date to match the New Start Date, then remove the New Start Date from the clipboard:

  1. Click Create > Data Model > Data Transform to create a new data transform.
  2. In the Label field, enter the name of the data transform as Adjust Start Date to New Date.
  3. Set the context to the Onboarding case.
  4. Click Create and open to create the data transform.
  5. In the Definition tab, in the first step of the data transform, set the .Employee.StartDate equal to .NewStartDate.
  6. Add a second step to the data transform to remove .NewStartDate from the clipboard.

    adjust start date
  7. Click Save to save the data transform.
  8. Return to the Update Start Date flow rule.
  9. Double-click the connector between the Send email step and the end shape.
  10. In the Set properties section, select the Apply data transform radio button.
  11. Select the data transform AdjustStartDateToNewDate.

    transform connector
  12. Click the Submit to complete the configuration on the connector.

5 Designate the process as a relevant record

Follow these steps to designate the Update Start Date process as a relevant record and make the process available in App Studio:

  1. From the flow rule, click the Actions menu and select Mark as relevant record.

    Image of Mark as Relevant selection
  2. Click Save to save the flow rule.

6 Add the process to the Onboarding case type

Follow these steps to add the Update Start Date to the Onboarding case type as an optional action:

  1. Switch to App Studio.
  2. In the Onboarding case life cycle, click Optional actions.
  3. Below Case wide actions, click + Action > More > Processes to locate the Update Start Date process.

  4. Click Update Start Date > Select.
  5. Click Save to finish adding the Update Start Date process to the Onboarding case type.

    optional action

7 Confirm your work

Follow these steps to test the Update Start Date process:

  1. Create a new Onboarding case, making a note of the case ID.
  2. From the Collect Employee Info view, fill out the required fields, including Start date, and advance the case.
  3. From the Actions menu, click Add Work > Update Start Date.
  4. From the Adjust Start Date view, specify a new date in the New start date field.

    Image of Adjust Start Date
  5. Click Submit.
  6. In the Onboarding case, open the Start date change confirmation email and verify that the EmployeeStartDate and NewStartDate properties are properly populated.
  7. From the bottom-right corner, click the Gear icon and open the Clipboard tool.
  8. In the Clipboard tool, ensure the Thread matches the Onboarding case ID.
  9. Navigate to User Pages > pyWorkPage (TGB-HRApps-Work-Onboarding).
  10. Verify that NewStartDate value is not present.
    Image of NewHireStartDate not in Clipboard
  11. Navigate to User Pages > pyWorkPage (TGB-HRApps-Work-Onboarding) > Employee (TGB-HRApps-Data-Employee.
  12. Verify that StartDate has the updated value.
    Image of HireStartDate updated in Clipboard

In der folgenden Mission verfügbar:

Wenn bei Ihrer Schulung Probleme auftreten, wenden Sie sich an den technischen Support der Pega Academy..

Fanden Sie diesen Inhalt hilfreich?

Möchten Sie uns dabei helfen, diesen Inhalt zu verbessern?

Änderung vorschlagen

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

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice