Working with Push Notifications

The Push Notification Framework helps in disseminating and consolidating notifications from events in the PeopleSoft system in real time. When you login to the PeopleSoft system, you can see your notifications in the Notifications panel. On desktop browsers and device widths greater than 1280 pixels, the Notifications panel is open by default on your fluid homepages. On device widths of 1280 pixels or less, such as on a smartphone, and on all transaction pages, the Notifications panel is available by clicking the Notifications button in the header. The system continues to update notifications as they occur in real time while you are working on your tasks and even as you’re working on notifications themselves.

This example illustrates the fields and controls on the Notifications panel - Actions section. You can find definitions for the fields and controls later on this page.

Notifications panel - Actions section

This example illustrates the fields and controls on the Notifications panel - Alerts section. You can find definitions for the fields and controls later on this page.

Notifications panel - Alerts section

Field or Control

Description

Refresh Button

Refreshes the Notification window to add all new notifications. The Refresh button displays a blue dot when a new notification arrives.

Notifications_Actions Button

The Notification menu includes these links:

Actions

Select this section to see a list of all of your actionable items.

Alerts

Select this section to see all of your informational alerts (non-actionable items).

More button

Click a link to open the transaction for that notification.

Mark Complete

Click this button to mark the action as complete and remove it from the Notifications panel. For more information, see the Marking an Action as Complete section later in this topic.

Alert link title

For certain alerts, you can click the alert link to view more information.

Dismiss Button

Dismisses an alert. This button is displayed only for alerts in the Alert section.

Note: Notifications are generated in the language of the notification approver, which is specified on the General tab of the User Profiles page (PeopleTools, Security, User Profiles, User Profiles). For example, if the notification approver's language is set to English, the notifications will be displayed in English. When a notification is generated, the notification remains in that language and does not change to reflect the user's language preferences or current session language.

Marking an Action as Complete

You can mark selected actionable notifications as complete and remove them from the Notifications panel without navigating to the transaction page by clicking the Mark Complete button. This option is available in the Actions section of the Notification panel on the homepage as well as on the View All Notifications page. After you mark the item as complete, it disappears from the Notifications panel and is displayed as 'Completed' in the Notifications List in the View All Notifications page.

When you select more than one actionable notification in the View All Notifications page, an Actions button becomes available on the page. Select this button and then select Mark as Completed to perform a bulk action and mark all the selected notifications as complete.

The following image illustrates the 'Mark Complete' option in the View All Notifications page.

View All Notifications page - Mark Complete

Note: This feature is available for selected actionable notifications only.

See SetCategory.

Use the two-panel action view to view and act on all of your actionable notifications.

Navigation:

From the Notifications panel, Notifications Menu button > View Actions in Panel link

This example illustrates the fields and controls on the two-panel action view.

Notifications Two-panel Action View

The action view uses the master/detail architecture to display a master list of your actionable items in the left panel while displaying the notification target content on the right. You can act directly on this target content—for example, to approve, deny, or take any other action appropriate to the transaction. To navigate in the action view, click a notification listed in the left panel to display it on the right. Alternatively, use the Previous in List and Next in List navigation buttons to navigate sequentially through your list of actionable items.

Because the action view is a master/detail component, some transactions are presented to you different from the preceding example:

  • If the transaction cannot be displayed directly within the action view, then you will be presented with the following message:

    The notification source can’t be directly displayed within this area. Click on the link below to navigate to target notification:
    Notification Target

    Click the Notification Target link to open the notification in a new browser window.

  • If the transaction includes its own inner left panel, the list of notifications is initially collapsed so that the inner left panel of the target transaction is displayed. To redisplay your list of notifications, click the Notifications tab to slide out the outer left panel. See Working with the Slide-out Left Panel for more information.

Use the View All Notifications page to review all of your actions and alerts together.

Navigation:

From the Notifications panel, Notifications Menu button > View All Notifications link

This example illustrates the fields and controls on the View All Notifications page. You can find definitions for the fields and controls later on this page.

View All Notifications page

In the left panel, you can filter the list of notifications by:

  • Notification name

  • Category type

  • Message state

  • Priority

Select one or more notifications, and then select an item from the Actions menu:

  • Mark the notifications as read.

  • Mark the notifications as unread.

  • Mark the notifications as dismissed (available for alerts only).

Click the Open Action View link to open the two-panel action view. See Using the Two-Panel Action View for information. Click the View Archived Notifications link to view your archived notifications. See the following section.

Archived Notifications

Use the View Archived Notifications page to view notifications that have been archived by your system administrator.

Navigation:

On the View All Notifications page, click the View Archived Notifications link.

This example illustrates the fields and controls on the View Archived Notifications page.

View Archived Notifications page

Use the Notifications Settings page to personalize the Notifications panel.

Navigation:

In the Notifications panel, click the Notifications Settings button > Settings.

This example illustrates the fields and controls on the Notifications Settings page. You can find definitions for the fields and controls later on this page.

Notifications Settings page

Field or Control

Description

Display Full Notification Text

Select this option if certain notifications are truncated when displayed in the Notifications panel.

Number of Actions

Enter the maximum number of actions to be displayed in the Notifications panel.

Note: If the number of actions exceeds this value, a View All link is displayed to allow you to view all of your notifications on the View All Notifications page.

Number of Alerts

Enter the maximum number of alerts to be displayed in the Notifications panel.

Note: If the number of alerts exceeds this value, a View All link is displayed to allow you to view all of your notifications on the View All Notifications page.

Advanced Notification Settings

Click to open the Notifications page in My Preferences, where you can personalize how you wish to receive your notifications.

When you personalize your notifications, you can select among the notification options that have been configured for each notification type. When the options are available, you can select to receive notifications in the Notification panel (in-app), in email, or by text message. You can also personalize which pop-up notifications you wish to receive. The following table provides links to additional topics for personalizing the Notifications panel and your notifications.

Topic

See

Personalizing the Notifications panel.

See the preceding information in this topic for more information.

Personalizing whether the Notifications panel is displayed on your homepages by default.

Managing Fluid Homepages

  • Providing consent to receive text messages.

  • Personalizing the notification options for each notification type.

Personalizing Notifications

Specifying an email address for receiving notifications.

Setting Up Your System Profile

Note: The location to define your email address can differ by PeopleSoft application pillar. See the documentation for your PeopleSoft application for more information.

Specifying a phone number for receiving text messages.

“Notifications” section in Specifying General Settings in My Preferences

Note: The location to define your phone number can differ by PeopleSoft application pillar. See the documentation for your PeopleSoft application for more information.

Personalizing pop-up notifications.

“Pop-up Notification” section in Specifying General Settings in My Preferences

The system sends notifications automatically as part of standard workflow routings. You can also send notifications from fluid components by using the Notify link from the Actions menu of a fluid component.

The Notify feature is based on the notification configuration framework and supports three types of notifications:

  • In-App (the Notifications panel)

  • Email

  • Text

You can use the Notify option to send notifications to other users.

To use the Notify feature, an administrator must enable the Notify check box on the Fluid tab (Component Properties dialog box in Application Designer) of the component from where you want to send the notification. See Administering Notifications and Setting Component Properties for Fluid Components.

Note: The Notify option is not available for Activity Guide because Activity Guide has its own mechanism to notify.

To access the Notify page, select the Notify link from the Actions menu of a fluid component.

This example illustrates the fields and controls on the Notify page.

Notify page

Field or Control

Description

Primary Message

Enter your own comments. The message text is sent in the language of the sender.

The Primary Message will be displayed in the in-app notification in the Notifications panel and in the subject of the text notification.

Email Subject

Enter the topic or a brief description of the email. The default value is the description of the component from which the notification is invoked, but you can edit it.

Email Body

Includes the primary message to be delivered in the email. Displays the contents of the Primary Message field by default.

Edit Email

Select this link to edit the contents of the Email Body.

When you select this link, the Copy Primary Message and Available Binds links are displayed.

Type

Select the type for the recipients list.

  • Email ID

  • Phone Number

  • Role Name

  • User ID

Send To

Select the sender ID of the recipient.

The following example illustrates the Notify page with the Edit Email option selected.

Notify page with the Edit email option selected

Field or Control

Description

Email Body

Includes the primary message to be delivered in the email.

Displays the contents of the Primary Message field by default.

You can edit the content and add bind variables to the Email Body to send a personalised email.

Copy Primary Message

This link is displayed when you select the Edit Email link. Select the Copy Primary Message link to copy the contents of the Primary Message to the Email Body.

Available Binds

This link is displayed when you select the Edit Email link. Select the Available Binds link to display a list of bind variables that you can use within your Email Body to send a personalised email.

  • %Recipient% - Describes the recipient user ID.

  • %Sender% - Describes the sender user ID.

  • %SenderEmail% - Describes Email ID of the sender.

  • %URL% - Describes the url of the underlying transaction page.

You can configure your fluid notification settings to receive your notifications in-app, as an email, or as a text notification.

Receiving in-App Notifications

In-App notifications are actionable notifications that appear in the Notifications panel on the homepage. The notification text is the content defined in the Primary Message field on the Notify page. See Sending Ad Hoc Notifications from Fluid Components. The notification also contains a link to the underlying transaction page from where the notification is invoked. You can select this link to access the transaction page and take any required action.

The following image illustrates in-app notifications delivered in the Notifications panel on the homepage.

Receiving an In-App Notification

Receiving Email Notifications

When you receive an email notification, the notification typically includes a link to the PeopleSoft page where you will perform the necessary work. Depending on your business processes, you may need to notify a colleague or supervisor that you have completed the work.

The following example illustrates a notification received by email from a fluid component. In this example, bind variables %Recipient%, %URL%, and %Sender% were used to pick up the details of the recipient, the url of the transaction page, and the sender respectively.

Receiving an Email Notification

Receiving Text Notifications

A text notification contains the Primary Message defined in the Notify page as well as the link to the underlying transaction page from where the Notify option is invoked. See Sending Ad Hoc Notifications from Fluid Components. Select the link to access the transaction page and take any required action.