Skip to main content
close Search
Close search


Queuing a task for background processing

3 Tasks

30 mins

Visible to all users
Beginner Pega Platform 8.2 English


To reduce errors and complaints with payroll processing, the Human Resources department allows employees of TGB to enroll in direct deposit. When employees enroll, their paycheck is automatically deposited into their checking account when the accounting department processes the company payroll.

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

Role Operator ID Password
Senior System Architect SSA@TGB rules

Your assignment

Add a step to the case life cycle to queue the creation and sending of an email once the user completes a Payroll Setup case.

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

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

Detailed Tasks

1 Create a Run in background step

  1. In Dev Studio, configure the Payroll Setup case type to look like the following image.
    Enrollment stage


    2 Configure a standard queue to send an email when processing the queued item

    1. In the contextual properties panel for the Run in Background step, use the information in the following table to configure a standard queue type to run the UploadToPaymentProcessor activity.

      Field Value
      Type of queue Standard
      Activity name UploadToPaymentProcessor
      Lock using Primary page
      Alternate access group  
      Audit note upload to payment processor and send confirmation email
      The activity must already exist prior to the configuration of a standard queue processor. This UploadToPaymentProcessor activity sends an email by using the call method.
      Standard queue
      By default the queue processor uses the access group of the user who queued the item.
    2. Save the queue processor rule.

    3 Confirm your work

    Verify the email is queued

    1. Create a new Payroll Setup case.
    2. Complete the Collect employee information form by using a valid email address.
      Employee info
    3. Click Submit
    4. Advance the case to the Complete enrollment stage.
    5. Click Actions > Review selections > Submit to complete the case with a Resolved-Completed status.
    6. Click the Audit tab and locate the audit note you entered for the Run in Background step to verify the standard queue processor ran.

      Refresh the case after 1-2 minutes to see the audit note and the email sent by the activity.
      Payroll set up
    7. From Admin Studio, click the Queue processors tile to view the list of queue processors.
      admin studio
    8. Verify that there are no broken processes and that the Ready to process column is zero to confirm the case step processed.
      Standard process
      The Processed in the last hour column may reflect the standard queue item you just ran; however, the field may also reflect other background processes occurring in the system at the same time.

    If you are having problems with your training, contact Pega Academy technical support.

    Did you find this content helpful?

    Want to help us improve this content?

    Suggest an edit

    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