Permissions
Administer Easy Agile TeamRhythm access to Jira projects/boards
When the Easy Agile TeamRhythm app is installed, the User Story Map and Retrospective options will appear in the project sidebar. The app will be available for all Jira Software boards: Scrum, Kanban, and (on Jira Cloud only) team-managed projects.
Block app access using a Data security policy on Jira Cloud
On Jira Cloud only, Atlassian’s new app access rules can prevent Easy Agile TeamRhythm from accessing or showing in specific Jira projects.
This is configured using a Data security policy, which can be configured by an Organization Admin. This allows you to select:
The Jira projects you’d like to restrict access to; and
The App access Policy rule.
If you have Atlassian Access, you’ll be able to choose which apps you block using an allowlist or a blocklist.
Otherwise, you’ll only be able to block all apps. This means that using a Block app access rule to restrict Easy Agile TeamRhythm will block other apps as well.
Multi-project boards and app access
Easy Agile TeamRhythm provides a User Story Map for each Jira board. A Jira board might contain issues from more than one project. Learn more about multi-project boards in Easy Agile TeamRhythm here.
Blocking access to one project in a multi-project will cause some issues on the board to be missing. Users will see a message when this is caused by an App access rule.
Restricted projects will appear as an option when quick creating issues. However, the app will fail to create the issue and the user will be directed to Jira’s Create issue form. The created issue will not appear on the User Story Map.
Is it possible to restrict the Easy Agile TeamRhythm app to certain Jira projects?
On Jira Cloud, you may be able to use a Data security policy; see “Block app access using a Data security policy on Jira Cloud” above.
On Jira Data Center (and Jira Server), it is not possible to enable/disable the app on specific Jira projects or boards.
On Data Center and Server versions of the app, it is possible to hide one or both of the icons from the project sidebar in ALL Jira projects. See “Can I remove both of the app icons from the Project sidebar?” below.
Can I disable the Retrospective page of Easy Agile TeamRhythm?
On Jira Cloud, it is not currently possible to hide the Retrospective part of the app.
On Jira Data Center (and Jira Server) only, a Jira Administrator can configure modules for the app to hide the app icons.
This is available from version 12.0.0 and later.
For DC or Server versions of the app, it is possible to remove all methods of navigating to the Retrospective page of Easy Agile TeamRhythm. This includes:
The Retrospective icon in the project sidebar; and
The Retrospective tab in the header of Easy Agile TeamRhythm (pictured).
In-app header tabs for User story map and Retrospective pages
To do this, find and disable the relevant app module(s). This is found in Jira’s global settings → Manage apps → Easy Agile TeamRhythm for JIRA → expand “### of ### modules enabled”:
"Retrospective Navigation In App (eausm-enable-retrospective-in-app-navigation)”
“Retrospective in the global project nav (global-sidebar-plan-retrospective)”
“Retrospective (easy-agile-retrospective)”
Manage apps in Jira settings: the modules option
Can I remove both of the app icons from the Project sidebar?
On Jira Cloud, you may be able to use a Data security policy; see “Block app access using a Data security policy on Jira Cloud” above.
On Jira Data Center (and Jira Server) only, a Jira Administrator can configure modules for the app to hide the app icons.
If you wish for only some teams to use the Easy Agile TeamRhythm app, you may wish to remove the “User Story Map” and “Retrospective” icons from the project sidebar.
Because this will hide the app icons on all Jira projects, we recommend saving a link to the app pages for any projects where you do wish to use the app. We suggest adding a Project shortcut in Jira to the User Story Map and/or Retrospective page for each project where you wish to use the app.
To hide icons, find and disable the relevant app module(s). This is found in Jira’s global settings → Manage apps → Easy Agile TeamRhythm for JIRA → expand “### of ### modules enabled”:
To remove both “User Story Map” and “Retrospective” icons, disable the following modules:
“easy-agile-user-story-maps Icon css (eausm-icon)”
“Storymap in the global project nav (global-sidebar-plan-storymap)”
“Retrospective in the global project nav (global-sidebar-plan-retrospective)”
If you wish to remove only the Retrospective option, see Can I disable the Retrospective page of Easy Agile TeamRhythm? above.
Can I change the position of the User Story Map icon in the Project sidebar?
This is only available when using the app on Jira Data Center or Jira Server.
Jira Administrator permission is required for this configuration.
The position of the User Story Map icon can be changed by altering the script in the Announcement banner.
To move the icon to, in this example, below the Reports icon, add the following code snippet to the Announcement Banner:
<script type="text/javascript">
$(function() {
AJS
.$("[data-link-id='com.atlassian.jira.jira-projects-plugin:report-page']")
.parent()
.after(
AJS.$("[data-link-id='com.kretar.jira.plugin.user-story-map:easy-agile-story-map']")
.parent()
)
});
</script>If you're not actively using the announcement banner, we recommend also adding the following CSS style to hide the announcement banner as it otherwise unnecessarily bumps out whitespace at the top of every page:
<style>
#announcement-banner {
display: none;
}
</style>User permissions
Jira’s Permissions configuration controls what users can access in Easy Agile TeamRhythm. Users will never be able to change Jira data using the app if they do not have permission to do the same action in Jira.
Users will need access to a Jira board to view the User Story Map and Retrospective for that Jira board.
Users will be able to view, create and edit issues only if they have the relevant permissions in Jira. This is configured in the Permissions Scheme used in each Jira project.
Easy Agile TeamRhythm adds a User Story Map page for each Jira board; a board may contain more than one project. Permissions will be applied to issues based on what Jira project the given issue is in.
Learn more about administering permissions in Jira Cloud or Jira Data Center.
On Data Center and Server app versions 8.5.0 and lower, users without Create issue permission will get an error message “An unexpected error occurred”.
This can be fixed by updating the app to version 8.6.0 or later, or by granting Create issue permission to the user. See more details about this error here.
The app does not add new permissions options to Jira.
It is possible to restrict permission to view a Retrospective created in the app. Learn more about configuring retrospective permissions in Private Retrospectives.