Toast notifications

A toast notification is a small pop-up window that is displayed at the bottom of the screen. It provides feedback about an action that occurs in the background. Ideally, the toast notification is visible for 5-6 seconds and does not block the information behind it. While the toast notification is visible on the screen, the user can interact with the application normally.

For a project created in Pega Robot Studio, use toast notifications to inform end users that all the automated actions performed behind the scene are successfully complete. Add toast notifications to an automation to indicate the background process and its result.

To add a toast notification component to an automation, drag the component from the Utilities > Messages section of the Toolbox to the automation surface. Doing so creates the toast notification as a local object for use in only the current automation. To add a toast notification to the project, switch to the Globals tab and drag the component to the Globals table. Doing so creates a global object that you can use in every automation of the project.

To add a toast notification to your automation, drag the component from the Locals or Globals section of the Palette and select the Show method. Enter the message that is displayed to users and choose a severity icon to indicate an Info, Warning, or Error type message.

In the following automation example, customer data is imported from a file to a Lookup Table for further processing, and the toast notification confirms a successful data transfer.

Screenshot showing a part of automation that uses a Toast Notification, an the message displayed by Pega Robot Studio.

Users do not have to interact with the toast notification, but they can dismiss it by clicking the Close icon if needed.

Configuration of a toast notification

Use the property grid to define the display settings of a toast notification:

Parameter	Description
Name	Enter an internal name for the component.
Alignment	Specify where the notification is displayed on the screen.
Background color	Choose the background color for the notification.
Display time	Specify the amount of time, in milliseconds, that the notification should remain visible.
Exit style	Select whether the notification should fade away or immediately disappear
Text color	Choose the color of the text.

While you can use toast notification as a local object within an automation, add a toast notification to the Global Container and adjust the display settings in its property grid to have consistent formatting for all notifications in your project. You can add a formatted toast notification to each automation by adding a Show method from the Globals section of the Palette.