Versions Compared

Old Version 4

changes.mady.by.user TZR

Saved on

compared with

New Version Current

changes.mady.by.user TZR

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This feature is restricted to Jira Administrators and Dashboard Folder Plugin AdministratorsFolders Administrator only

This is the main page to configure the Folders and the Dashboard within the Folders.

...

Navigate to Dashboard Folders

  1. Click Settings → Issues on the top right hand corner

  2. Click Dashboard Folders under Dashboard Folders Configuration section on the left panel

...

  1. Image Added

Alternatively, you can use the keyboard shortcut if you are Jira Administrator:

  1. Key 'g' + 'g' consecutively on any Jira page

  2. Type Dashboard Folders in the search box

  3. Click Dashboard Folders

...

  1. Image Added

Dashboard Folders Page

The main Dashboard Folders page allows the admin to:

  • View the Dashboard Folders hierarchy 

  • Add or Delete Folders

  • Edit each Folder details

  • Manage each Folder contents (Dashboard)

  • Toggle Dashboard and Permission Folder Details view (on this page)

  • Search Folder/Dashboard (on this page)

...

S/N

User Action

Description

1

Toggle Dashboard

Toggle button to display the list of Dashboard

for

within each folder

Image Removed
Image Added
2

Toggle Folder Permission

Toggle button to display the "Viewer" permission for each folder

Image Removed
Image Added
3

Add Folder

Adds

Add a sub-folder to the current selected folder

Refer to

Add/Edit

https://akeles.jira.com/wiki/spaces/DFOLDER/pages/7300415489/Configure+Dashboard+Folders#Add%2FEdit-Folder

4

Edit Folder 

Edit the current selected folder "Name" and "Viewer" permission

Refer to

Add/Edit

https://akeles.jira.com/wiki/spaces/DFOLDER/pages/7300415489/Configure+Dashboard+Folders#Add%2FEdit-Folder

5

Manage Folder

Manage the Dashboard in the current selected folder

Refer to

Manage

https://akeles.jira.com/wiki/spaces/DFOLDER/pages/7300415489/Configure+Dashboard+Folders#Manage-Folder

6

Delete Folder

Delete the current selected folder

Add/Edit Folder

From each Folder, administrator can add new sub-folder to it or edit the details of the existing Folder (except for the "Home" folder).

  • Adding new Folder:

    Image RemovedImage Added

  • Editing a Folder:

    Image RemovedImage Added

Field

Description

Folder Name

The name of the Folder.

Folders will be displayed

in the natural sort order of the Folder Name. Panel
panelIconIdatlassian-light_bulb_on
panelIcon:light_bulb_on:
panelIconText:light_bulb_on:
bgColor#FFFAE6
Tip:

by the Ordering Type configured, which by default is set to alphabetical order.

Tip

Tip: if you do not want to manage the ordering, try prefix the Folder Name with a

number to order them differently

number so that it will be alphabetically sorted by this prefix number

e.g. 1. General, 2. Teams, 3. Departments

Image Removed
Image Added

Viewers

This is the selected list of viewers that can view this Folder. 

Refer to Select Viewers field below on how to select the list of viewers.

For groups/project roles, click on the × icon on each label to remove the selected group/project role.

Image Removed
Image Added

Select Viewers

Select the permissible groups of user that can view this Folder. 

  • If a folder is not visible to a user, all it's sub-folders will also be hidden from the user

  • Visibility of the Dashboard in each Folder will still adhere to the viewer permission set on each Dashboard

  • A folder will not be shown to user if it has no visible Dashboard or sub-folders within it

Refer to the next table for the different types of Viewers.


Anchor
folder_viewers
folder_viewers
Folder Viewers can be set to one of the following types:

Type

Description

Private

  • This is the default type

  • Only Jira Administrators and Dashboard Folders Administrators can view

Public

  • This allows anyone to view the Folder, including users that are not logged in

    • For users not logged in: this is only applicable to Jira instance set to "Public" mode and the Folder contains Dashboard shared to the public

Logged in users

  • This allows any logged in user to view the Folder

Shared to Group/Project

  • This allows user in the selected group(s) and project role(s) to view the Folder

  • After selecting the group(s) or project role(s), click on "+ Add" button to add the selection to "Viewers"

  • For Dashboard Folders Administrators, they can only add/remove  

    • Group(s) that they belong to

    • Project(s) where they have browse or administrator permission for

Image Removed
Image Added

Manage Folder

From each Folder, administrator can edit manage the Dashboard within it and the ordering of the Sub-folder.

...

Field

Description

Dashboard Ordering

Refer to https://akeles.jira.com/wiki/spaces/DFOLDER/pages/7300415489/Configure+Dashboard+Folders#Sub-Folder%2FDashboard-Ordering-Type

Dashboard

The Dashboard to be filled into the current Folder

Alias Name (Optional)

An alias name for the Dashboard within the current Folder

Image Removed
Image Added

This alias name will appear in the top menu bar Dashboards dropdown and also on the side bar when viewing a Dashboard

The Dashboard will be sorted by the Ordering Type set.

If the ordering type is not manual, the system will automatically sort in

natural

  • Shorten or "Rename" Dashboard name so that it is easier to find or understand

    • Sort the Dashboard by prefixing number to the alias name

    alphabetical order by the alias name (if applicable) followed by Dashboard name

    This is useful to help:

    An alias name can help to:

    • simplify Dashboard name without changing the actual Dashboard name

    • promote generic Dashboards that are placed into multiple Folders using different alias name that are relevant to the Folder

    • reorder the Dashboard position – actual Dashboard name is shown in brackets

    Image Removed
    Image Added

    Without Alias Name

    With Alias Name

    Image AddedImage Added
    Image AddedImage Added
    Image AddedImage Added

    Remarks (Optional)

    Allows administrator to leave a short note to other administrators

    This field has a character limit of 255 characters

    Sub-Folder Ordering

    Refer to https://akeles.jira.com/wiki/spaces/DFOLDER/pages/7300415489/Configure+Dashboard+Folders#Sub-Folder%2FDashboard-Ordering-Type

    Sub-Folder/Dashboard Ordering Type

    From Dashboard Folder v2.1.0 onwards, admin can set the Ordering Type of the Dashboard and Sub-Folder within a Folder.

    ...

    Ordering Type consist of the following modes:

    Ordering Type

    Description

    Manual

    • Admin can drag and drop an item (dashboard or folder) to the desired position

    • Any newly added dashboard/folder will automatically be added to the end of the list

    • Any edit to an item name will not change the position of the list

    Automatic (A - Z)

    • Item (Dashboard or Folder) is automatically sorted by alphanumeric order

    • Any newly added or edited item will automatically be adjusted to the alphanumeric order in the list

    • This is the default type when a Folder is first created

    Reverse (Z - A)

    • Item (Dashboard or Folder) is automatically sorted by reverse alphanumeric order

    • Any newly added or edited item will automatically be adjusted to the reverse alphanumeric order in the list

    The Ordering Type can be set to different mode for the Dashboard and the Sub-Folder within each Folder:

    • Dashboard Ordering

    • Sub-Folder Ordering

    ...

    Panel
    panelIconIdatlassian-warning
    panelIcon:warning:
    bgColor#FFEBE6

    If your instance has migrated from Dashboard Folder v1.x to v2.0.0 before, the original item ordering set in v1.x might not be re-migrated.

    Contact our support help@akeles.com for assistance.