Skip to main content

Circumstancing Rules on a single variable

2 Tasks

30 mins

Visible to: All users
Intermediate Pega Platform 8.7 Dev/Designer Studio English
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.


TGB sends an email to a candidate to extend an offer of employment. TGB company policy gives the candidate 72 hours to respond to the offer. However, Canadian regulations require that a company allow five business days for a resident of Canada to respond to an offer.

Customize a version of the offer letter email to send to Canadian candidates to inform the candidate about the response time frame of five business days.

  • Create a circumstanced version of the OfferLetter correspondence rule.
  • For a circumstancing condition, test whether the value of the Country Code property (.Candidate.pyCountryCode) is CAN.
Note: The five-day Canadian regulation is included for challenge purposes only.

The table below provides the credentials you need to complete the challenge.

Role User name Password
Senior System Architect SSA@TGB pega123!
Note: Your practice environment may support the completion of multiple challenges. As a result, the configuration shown in the challenge walkthrough may not match your environment exactly.


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

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

Challenge Walkthrough

Detailed Tasks

1 Create a circumstanced version of the Offer Letter correspondence rule

  1. In Dev Studio, open the Candidate case type.
  2. Select the Send Offer Letter step.
  3. Select and open the Offer Letter correspondence template.
    Tip: In the pop-up, select the OfferLetterEmail rule.
  4. Click Save as > Specialize by circumstance.
  5. Configure the circumstancing rule as seen in the following image.
    Circumstanced Property
  6. Create and open the Correspondence: Offer letter rule form to edit the text.

2 Define the behavior for the circumstance

  1. Update the text of the email to read as follows:

    Dear <<.Candidate.pyFullName>> ,

    We are pleased to offer you the position <<.Position.JobTitle>>, reporting to <<.Position.Manager>>, at a starting salary of <<.OfferedSalary>>.

    Please inform us of your intention to either accept or reject this offer within five business days.

    We are excited to have you join our organization and look forward to working with you. If you have any further queries, please do not hesitate to contact us.



  2. Save your changes to the circumstanced rule.

Confirm your work

  1. Create a new Candidate case.
  2. On the Collect Personal Details form, in the 3-letter country code field, enter CAN.
  3. Complete the remaining required fields on the form and click Submit.
  4. Advance the case to the Screening stage. 
  5. In the Stakeholders section of the case, confirm that the candidate is listed as a stakeholder to ensure the email can be routed to the candidate.
    ​   ​challenge-single-circumstance-verify-stakeholders
  6. Advance the case to the Offer stage, past the Manager Approval step.
    Tip: You may need to refresh the case to display the email attachment.
  7. Open the attached email and verify that the content matches the circumstanced version of the rule. Ensure that the attached email mentions that the candidate has five business days to accept or reject the offer.

  8. Close the Candidate case.

This Challenge is to practice what you learned in the following Module:

Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

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 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