User Guide
- Gia Jgarkava
After configuration, the notifications bar will be visible on the Customer Portal for the projects where the plugin is activated (see Configuration for more details):
By default, the notifications bar is minimized and can be expanded by clicking it:
The number on the notification bar shows the number of unread notifications. This number is updated immediately, when the notification is received, no refresh is necessary.
The notifications plugin shows the following information per each notification:
Who did the action
Which action was performed
Date and time of the action
Request summary
Request key
Request status
Action results (e.g. added comment, status change, etc.)
The dot on the right side of the notification indicates unread status. By clicking the dot, certain notification status is changed to “read“ and “unread” (the dot is greyed out).
When the plugin is expanded, received notifications will be immediately added to the list, without the need to reload the page.
Due to the limitation of the corresponding REST API, some customer user names may not be displayed when mentioned in the comment and only the account ID might be visible:
By toggling the “Show only unread“ toggle, the list will display only unread messages. The “Mark all as read“ button will change the status for all the messages to 'read'.
The notifications list is based on the lazy loading pattern and more notifications are visible only after scrolling down the list (see this Wiki article for more details: Lazy loading - Wikipedia).
In the case of Jira notification, by clicking the notification anywhere, the corresponding request will be opened in the same tab. Click on an “Open in a new tab“ button, if you want to open the request in a new tab:
Clicking the Confluence notification will always open the page in a new tab.
Depending on the user role, the request will be opened either in the Customer Portal view (for Portal users) or in JSM view (for Agents). Notifications from Confluence do not have a new tab button, as the default action when clicking the link is to open the document in a new tab.
Notification filters
You can narrow the list of visible notifications by using the following filters:
All
All the notifications will be visible.
Created by me
Only the notifications related to the user-created requests will be visible, i.e. where the current user is a reporter.
I am participant
Only the notifications related to the requests where the user is added as a participant will be visible
My organizations
Only the notifications related to the requests with the organizations where the user belongs to and is a reporter will be visible.
Waiting for my approval
Only the notifications regarding the approvals waiting for the user will be visible.
If the request reporter is empty the approval request will be delivered in the following format: “Anonymous is awaiting approval“.
Confluence
Only notifications from the Confluence will be visible.
Notifications will only be shown for the requests, the visibility of which is allowed by the issue security level (if applied). All the notifications sent before 09-Nov-2024 will be still visible in spite of the issue security level setting.
Responsive
The notifications bar is compatible with the responsive UI for mobile devices. All the actions are available and the bar features are identical to the web version, but tailored for mobile devices:
