Skip to main content

Home

Suggest edit
Updated on March 14, 2022
Applicable to Cosmos React applications

The Home landing page provides the user with a quick overview of your application. You can populate the home page with out-of-the-box widgets, as well as fields and views that best meet the needs of your business.

Unlike a traditional Pega Platform dashboard that the end user can customize, the Home page in a Cosmos React application is a curated experience. Consequently, it is the application designers who specify what users see when they log in.

You can add the following widgets to the home page:

App announcements
Displays a welcome banner for the user. You can modify the text and the background of the announcement, as well as the destination of the action button.

For more information, see Configuring the Home page welcome banner.

Pulse
Displays a message feed.
To do
Displays list of open cases assigned to the user.
Sample landing page
The landing page includes three widgets: Pulse, To do, and App announcements.

Configuring the Home page welcome banner

Applicable to Cosmos React applications

Send a customized message to your users by configuring the welcome banner on the Home page of your application with the App announcement widget. For example, you can configure the banner to display a bulleted list of the latest changes to the application.

  1. Open the App announcement widget:
    1. In the navigation pane of App Studio, click Channels.
    2. In the Current channel interfaces section, click the icon that represents the portal whose App announcement widget you want to configure.
    3. On the portal page, on the Content tab, click the Landing pages category.
    4. In the Landing pages pane on the left side of the screen, click Home.
    5. In the Edit page: Home pane, in the row that holds the App announcement widget, click Configure App announcement.
  2. In the Header text field, enter the title of your message.
  3. In the Description field, enter the text of your message.
  4. In the What's New link field, enter the address of the web page that you want to open when the user clicks the What's New button on the banner.
  5. In the Image URL field, enter the address of the image that you want to use as the banner's background.
    The field accepts external links or images that are provided in the data:image format with base64 encoding.
  6. Click Submit.
  7. Provide text for the details bullet points:
    1. In the header of your workspace, click the Switch Studio menu, and then click Dev Studio.
    2. In the Dev Studio search field, search for and open the pyInitAnnouncements data transform.
      The system sources the bullet points in your announcement from the D_pyAnnouncements data page. The pyInitAnnouncements data transform populates D_pyAnnouncements with content.
    3. On the Definition tab of the pyInitAnnouncements data transform, in the Source column, enter the text for the bullets.For example: In this scenario, the pyInitAnnouncements data transform contains three actions, each representing a bullet. You can remove the bullets or add new ones by copying the existing configuration.
      Sample bullet configuration
      The pyInitAnnouncement data transform contains three actions which add a new page to the .pxResults target, and set the .pyLabel text.
    4. On the ruleform, click Save.
For example: The following message banner represents a sample configuration:
Sample App anouncement widget
The banner displays a short message and three bullets.

Configuring the Todo widget

Help your users quickly identify the highest priority tasks by setting up a Todo widget. The widget provides users with a list of tasks from their worklist or the work queue to which they belong.

  1. Open the Todo widget:
    1. In the navigation pane of App Studio, click Channels.
    2. In the Current channel interfaces section, click the icon that represents the portal whose Todo widget you want to configure.
    3. On the portal page, on the Content tab, click the Landing pages category.
    4. In the Landing pages pane, click Home.
    5. In the Edit landing page: Home pane, in the row that holds the Todo widget, click Configure Todo.
  2. In the Header text field, enter the label for the widget.
  3. In the Include work from section, define which assignments are displayed in the widget:
    • To display assignments from the worklist of the user, select the My worklist checkbox.
    • To display assignments of all team members in the workgroup of the user, select the Worklist of Team Members checkbox.
    • To display assignments from work queues that are mapped to the user in the operator record, select the Work Queues checkbox.

      For more information about configuring work queues, see Creating a work queue.

For example: Display assignments from the worklist and work queues of the user by selecting the My worklist and Work queues checkboxes.

Sample widget configuration
The My worklist and Work queues checkboxes are selected

Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us