Administrator guide

Overview

The app provides opportunities for administrators to create notifications that are sent to all logged in users on the instance.

Notification is shown as a modal dialog in the middle. This message is shown only one time and user provides a response to this notification. Once user responded, modal dialog closes and does not appear for this user again. Notification appears when user opens an issue or a dashboard.

How to open the app?

You can access the list of notifications, where you provided an answer, if you open Notificatons for Jira from the Apps dropdown in the top menu.

image-20241113-141417.png

Home page

Once you open the app, you will see home part.

Once you open the app, you will see home part. In this view you can see name of the app in the top left corner. In the top right corner you will see buttons to create a new notification or three dots with the options to read documentation or to contact support.

image-20241113-142740.png

You will see left menu with the list of notifications created to other people (Notifications to others), and which you are permitted to see. As an admin you can see all global announcements, created by other admins, and all project announements.

The second tab is used to review your answers (My responses).

Notifications to others: you can see table with existing notifications. If there are not any notifications, you will see empty space.

My responses: please kindly refer to User guide

Reviewing statisics

To access the statistics, please kindly click on Statistics button in te top right corner near Create notification button.

You will get the list of all replies to notifications you are permitted to see. This list contains all the replies, but ou can filter the list to get necessary information. You can filter by users, notification names, or select a time frame, when users provided their responses.

To clear all applied filters, please click on clear filters button on the right side.

If you would like to change or to partially remove your choice, please click on x icon near your selection.

To close Statistics page, please click on Back to home on the top right corner.

Managing existing notifications

If you have any notifications, you will see the table that contains following columns:
Name - shows name of the notification. It is an internal name and not a notification header, that is shown to user.
Enabled - contains toggles. Here you can enable or disable notifications without opening edit of the notification. Please note that only enabled notifications are shown to users.
Project - contains scope, where announcement will be displayed.
Notification author - contains user, who created this notification. If there are some notifications created by another admins, you will also see them in the list.
Notifications audience - type of notification. Will be always Project.
Options - contains three dots near each notification and has following options: Edit and Delete. Please read more about each option below.

Edit a notification

To edit a notification, please kindly click on three dots in Options column near desired notification. You will see drop-down list, please click on Edit.

You will be redirected to steps, where you can change any field. Please kindly apply desired changes on General or Display options steps and clicking on Next button navigate to the last step that is called Review and click on Save. Once you save your updated notification, you will be redirected to the home view.

Delete a notification

To remove a notification, please kindly click on three dots in Options column near desired notification. You will see drop-down list, please click on Delete.

Creating a notification

To create a new notification, please kindly click on Create notification in the top right corner in the home page.

Overview of the process

After you click on this option, you will be redirected to steps, where you can define some content for your notification.

To access documentation or to contact support please click on three dots in the top right corner.

If you click “Back to home page“, you will be redirected back to the main page with the list of created notifications.

Also, you can change the name of notification. This name will be shown to you in the ist of notifications and on the statistics page. To change the name, please click on default notification name, that is shown next to “Notifications for Jira /” in the top left corner.

General

Below you can see the steps to create notification. On the first step, that is called General, please select notification type. You can select between modal dialog in the screen center and a flag in the bottom left corner.

If flag is selected, flag type can be selected in the field below.

Please note, that if you select modal dialog type, this notification will be shown in issues or on dashboard only. So, this notification will be shown, when user opens an issue from the selected scope.

Please note, that if you select flag type, flag will not close after 8 seconds (as Jira standard flags). They will appear as long as it is pending for user’s answer

On General tab you can also add header of your notification and body of your information. After that please click on Next.

Display rules

On the second step that is called Display rules you can set which buttons will be shown to users. Please choose either 1 button or 2 buttons and type accept button text or accept and decline buttons text. Please click Next.

Scope

On the Scope tab you can select if you would like to create a project or a global notification. Project notification can be edited by project admin. Project admin can also access statistics of responses of project announcements. If you would like to create a notification, which can be edited and reviewed by admins, please create a global announcement. Audience (global or project) can be selected in Audience radio buttons section.

Below please select project where your notification will be shown. For global notification you may leave this field empty, and for project announcment there should be at least one selected project.

Also, you can select target users, who will see the notification.

Please select During selected period in Display time, if you would like to limit display of the notification, so it is shown during the selected period.

 

 

Review

On Review step you can see overall information about rules how your notification will be shown and you can also leave this notification enabled, so users can get them, or you can switch toggle OFF, and your notification will not be shown now.

To save the notification, please click Save below. You will be redirected to home view, where you will see created notification.

To review the notification, please click on Preview in a new tab. Your notification will be opened in a new tab.