# Create Filter

> `UiPath.Jira.Activities.CreateFilter`

`UiPath.Jira.Activities.CreateFilter`

The **Create Filter** activity uses the [Jira API](https://bitbucket.org/farmas/atlassian.net-sdk/src/e2082af34475bd126f466ecd582501e090febc5e/docs/how-to-use-the-sdk.md) to create a new filter (**Filter**).

The activity outputs a filter object (**Filter**) that is created using the (**Filter Name**) and (**JQL**) input parameters.

## How it works

The following steps are an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the [Setup](https://docs.uipath.com/activities/other/latest/legacy-integrations/jira-setup) steps.
2. Add the [Jira Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/jira-scope) activity to your project.
3. Add the **Create Filter** activity inside the **Jira Scope** activity.
4. Create and enter a `String` and a `Filter Name` variable for the Input properties.
5. Create and enter a `String` and a `JQL` variable for the Input properties.
6. Create and enter a `Filter` and a `Filter` variable for the Output properties.

## Properties

### Common

* **Continue On Error** - This field only supports boolean values (True, False). The default value in this field is False. As a result, if this field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
* **DisplayName** - The display name of the activity. This field supports only strings or `String` variables.

### Input

* **Filter Name** - The name of the filter you wish to create. This field supports only strings or `String` variables.
* **JQL** - The JQL used to filter issues. This field supports only strings or `String` variables. JQL stands for JIRA Query Language (not to be confused with Java Query Language). See [this page](https://confluence.atlassian.com/jirasoftware/blog/2015/06/search-jira-like-a-boss-with-jql) for more information.

### Misc

* **Private** - If selected, the values of variables and arguments are no longer logged at Verbose level.

### Options

* **Filter Description** - A description of the filter. This field supports only strings or `String` variables.

### Output

* **Filter** - A **Filter** object. This field supports only `Filter` variables.

### Sharing

* **Projects** - A list of projects with which to share this filter. Enter a `String[]` or `String[]` variable. This field is only valid when Share With includes Project.
* **Share With** - Permits access to this filter to a subset of users. Allowed values: Global, Logged In Users, Project. You can choose one, several, or all of the options.
