Setup

Applies to: Jira Cloud; Jira Data Center

After installing and enabling the plugin, please make sure the following is true:

1. The JQL Filter Query of the board where you plan to use the plugin is ordered by Rank:

   The “Sort by any field” plugin relies on the of issues in your Jira board being ordered by Rank to function correctly. This is because it modifies the existing ranking rather than introducing a separate sorting logic. To ensure compatibility, your board’s JQL filter query must include an ORDER BY Rank ASC clause. This ensures that modified ranking is visible on your board.

   • How to check your board’s filter query:

     1. Navigate to your Jira board.
     2. Click on “Board” in the top right corner, then select “Configure”.
     3. In the “General and filter” section, locate the “Filter Query” field.
     4. Verify that the query ends with `ORDER BY Rank ASC`. If it doesn’t, add this clause to the end of your existing query.

   • Example: If your current filter query is project = FOO, modify it to project = FOO ORDER BY Rank ASC.

   • Why this is important: Without this explicit ordering, the plugin might produce unexpected sorting results or not function as intended.

2. Users of the plugin have the ‘Schedule Issues’ permission:

   This permission is essential for users to interact with and modify the order of issues on the board. “Schedule Issues” grants the ability to:

   • Re-rank issues by dragging and dropping.

   • Use the plugin’s features to sort issues based on different fields.

   • How to grant the ‘Schedule Issues’ permission:

     1. Navigate to your Jira project settings.
     2. Go to “Permissions”.
     3. Edit the permission scheme associated with your project.
     4. Grant the 'Schedule Issues' permission to the relevant user groups or roles that will be using the plugin.

By ensuring these prerequisites are met, you can seamlessly integrate the “Sort by any field” plugin into your Jira workflow and leverage its powerful sorting capabilities.