Display Assignment or Notification Count on App Center Cards

Introduction

This Knowledge Base article explains how to display assignment (notification) counts on application cards in the Joget App Center. Using the Assignment Count Hash Variable plugin, assignment counts can be retrieved dynamically and displayed per application, providing users with better visibility into pending work items directly from the App Center.

This article also outlines the supported approach for retrieving assignment counts across apps and clarifies the scope of hash variables when working with multiple applications.

How does it work?

Joget provides a supported mechanism to retrieve assignment counts using the Assignment Count Hash Variable plugin. This plugin enables counting assignments for the logged-in user across:

• Applications
• Processes
• Activities
• Assignment statuses (running or completed)

The retrieved counts can then be displayed on App Center application cards using List Builder formatting.

Install Assignment Count Hash Variable Plugin

1. Download the latest version of the Assignment Count Hash Variable (v8.0.2 or later) plugin from the Joget OSS GitHub repository.

2. Go to System Settings > Manage Plugins.

3. Upload and install the plugin.

Configure the App Center App List

1. Open the App Center, click App Composer to open the App Center App Composer page.

2. Under List Builder, open App List.

3. Drag and drop the apps.id element into the card.

   

4. Select the apps.id column.

5. Set Formatter to BeanShell Formatter.

6. Use the following script:

   import org.joget.apps.app.service.AppUtil;
   
   return AppUtil.processHashVariable(
       "#loggedInUser.runningCount[" + value + "]#",
       null,
       null,
       null
   );
   

      This script retrieves the number of running assignments for the logged-in user based on the current application ID.

Customize Assignment Count Display (Optional)

You may customize how the assignment count appears on the App Center card by:

• • Wrapping the count in HTML for badge-style display.

  • Applying custom CSS in the App Center theme.

  • Conditionally hide the badge when the count is zero.

Counting Assignments by App, Process, or Activity

The Assignment Count Hash Variable plugin supports refined counting using additional parameters.

Available Hash Variable Syntax

Count all running assignments

#loggedInUser.runningCount#

Count assignments by application

#loggedInUser.runningCount[appId=APP_ID]#

Count assignments by application and process

#loggedInUser.runningCount[appId=APP_ID&processDefId=PROCESS_DEF_ID]#

Count assignments by application, process, and activity

#loggedInUser.runningCount[appId=APP_ID&processDefId=PROCESS_DEF_ID&activityDefId=ACTIVITY_DEF_ID]#

Count completed assignments

#loggedInUser.completedCount#