Skip to end of banner
Go to start of banner

How to use setSharescope action in Jira Command Line Interface (CLI)

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

This article explains how to set the scope of a filter in Jira to either Global or Private using Jira Command Line Interface (CLI)

Instructions

  1. The setShareScope action in Jira Command Line Interface allows the filters to be available to either Global or Private.
  2. Before creating a filter in Jira, set the scope of the filter using the action setShareScope as given in the below example.

    --action setShareScope --value Global

    The above action will default the filter share scope for the current user to GLOBAL.

  3. Now, create a filter using createFilter action as given in the below example.

    --action createFilter --name filterforTSboard --jql "project = TESTER01 ORDER BY Rank ASC"

    The above action creates a filter named "filterforTSboard" for the Jira project "TESTER01".

  4. To verify the filter permissions from Jira UI, log in to Jira as an administrator. 
  5. From the top navigation bar, click on Issues, from the dropdown select manage filters as shown in the screenshot below.
  6. As the below screenshot indicates, the filter "filterforTSboard" has no restrictions and can be viewed by any logged-in user.
  7. Similarly, the filters can be restricted by setting the scope to "PRIVATE". Refer to the sample action given below for the same.

    --action setShareScope --value private
    --action createFilter --name filterforTSboard-1 --jql "project = TESTER01 ORDER BY Rank ASC"
  8. The filter "filterforTSboard-1" will be set as private in Jira as shown in the below screenshot.


It is recommended to test this scenario in a non-production environment, or, run the action with the --simulate parameter to verify the behavior before deploying.

  • No labels