Skip to main content

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

Sending automatic emails from cases

Updated on March 29, 2022

By using email, you can share information about a case with stakeholders and case participants. Add the Send Email shape to your business process, to control the number of recipients and the message format. For example, you can inform stakeholders about the approval of a job candidate in a hiring process.


When your application sends an email, the system updates the pxSendDateTime property on the pxCorrSummary work page that belongs to pyWorkPage. Such updates might cause issues with refreshing a case at run time. To prevent errors, the pyEnableCorrSummary when rule is set to false by default, and the system does not update the pxSendDateTime property. If your business scenario requires updating the pxSendDateTime property, in Dev Studio set the pyEnableCorrSummary when rule to true.

  1. Add the Send Email shape to the life cycle of your case:
    1. In the navigation pane of App Studio, click Case types, and then click the case type that you want to open.
    2. In the Case life cycle section, in a stage, click StepMoreAutomationsSend email.
    3. Click Select.
  2. In the Step properties pane, identify the email recipients:
    • To send the email to one recipient, in the Send to list, select Email address, and then enter the email address of a user who wants to receive information about your case.
    • To send an email to more than one recipient, enter the email addresses and separate them with commas.
    • To send the email based on the value of a field, in the Send to list, select Field, and then select the name of a field that stores an email address.
    • To send the email based on the value of a user reference, in the Send to list, select User reference, and then select the name of a user reference from your data model.

      At run time, this field stores information about one user only.

    • To send the email to a group of stakeholders, in the Send to list, select Participant, and then select the name of a work party that defines a person, or a part of organization that is a participant of your case.
  3. Optional: To add more recipients, click Add recipient, and then repeat step 2.
  4. Optional: To send a shared email message to all recipients, select the Send a common email to all recipients check box.
    If you leave the Send a common email to all recipients unchecked, an application sends separate email messages to each recipient and the recipients cannot view email addresses of other recipients.
  5. In the Subject field, enter the title of the email by entering a string expression.
    You can reference field names in the title to make it more dynamic and meaningful, for example, “The case “+.pyID + “ has been assigned to you”.
  6. In the Message content section, define the email content by clicking Compose, and then editing the message in the rich text editor:
    Compose your own message
    1. Enter and style the text by using the rich text editor toolbar.
      For example: You can create a numbered list or emphasize text with bold font.
    Populate your email message with text from a template
    1. In the Compose message window, click Choose template.
    2. Click a template that you want to use.
    3. Click Select.
      After the template text appears in your email message, you can edit this content.
    Include the value of a field from your case in your email
    1. In the rich text editor, position the text cursor in the place where you want to add a property.
    2. On the toolbar, click the Insert property icon.
    3. Select a property that you want to use.
      For example: You can reference the first and last name in a greeting, or embed a project milestone date within a sentence.
      Tip: To prevent word clusters in your message, include a space before and after your property reference.
    Provide instant access to the case from your email
    1. In the rich text editor, position the text cursor in the place where you want to add a link.
    2. On the toolbar, click the Link icon.
    3. Select the Link to current case check box.
    4. Enter the display text and title for the link.
    5. Click OK.
  7. Click Done.
  8. Optional: To add attachments to the email, select the Include attachments check box, and then select the files that you want to upload:
    Include all case attachments
    1. Select All case attachments.
    Include only specific case attachments
    1. Select Choose attachments.
    2. select a category or a field that stores the attachments.
      Categories store groups of attachments with the same business classification, while fields store single attachments.
    3. Optional: To add multiple attachments, click Add attachment, and ten select another category or field.
  9. Click Save.
Result: At run time, when a case reaches the Send Email step, an application sends an email that you create to the recipients that you select.

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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us