Filtering Objects and Jobs

You can perform advanced filtering on projects, data objects, and jobs using the filter bars above the table of results. This feature is displayed at the top of the Monitor tab but is hidden by default on the Manage tab and Projects page. You can display or hide the filter bar by toggling the filters icon in the top right corner.

The filter bar lets you to specify different criteria on which to filter your data. You can combine multiple different filters for greater control over your results.

To use this feature, first choose the field you want to filter your data by, then enter your filter criteria. For example, select the "Name" filter then search for "NA12878". The filter activates when you press enter or click outside of the filter bar.

Filtering Projects

The following filters are available for projects, and can be added by selecting them from the "Filters" dropdown menu.

• Billed to: The user or org ID that the project is billed to, for example, "user-xxxx" or "org-xxxx". When viewing a partner organization's projects, the "Billed to" field is fixed to the org ID.

• Project Name: Search by case insensitive string or regex, for example, "Example" or "exam$" both match "Example Project"

• ID: Search by project ID, for example, "project-xxxx"

• Created date: Search by projects created before, after, or between different dates

• Modified date: Search by projects modified before, after, or between different dates

• Creator: The user ID who created the project, for example, "user-xxxx"

• Shared with member: A user ID with whom the project is shared, for example, "user-xxxx" or "org-xxxx"

• Level: The minimum permission level to the project. The dropdown has the options Viewer+", "Uploader+", "Contributor+", and "Admin only". For example, "Contributor+" filters projects with access CONTRIBUTOR or ADMINISTER

• Tags: Search by tag. The filter bar automatically populates with tags available on projects

• Properties: Search by properties. The filter bar automatically provides properties available on projects

Filtering Objects

The following filters are available for objects. Filters listed in italics are not displayed in the filter bar by default but can be added by selecting them from the "Filters" dropdown menu on the right.

• Search scope: The default scope is "Entire project", but if you know the location of the object you are looking for, limiting your search scope to "Current Folder" allows you to search more efficiently.

• Object name: Search by case insensitive string or regex, for example, NA1 or bam$ both match NA12878.bam

• ID: Search by object ID, for example, file-xxxx or applet-xxxx

• Modified date: Search by objects modified before, after, or between different dates

• Class: such as "File", "Applet", "Folder"

• Types: such as "File" or custom Type

• Created date: Search by objects created before, after, or between different dates

• Tags: Search by tag. The filter bar automatically populates with tags available on objects within the current folder

• Properties: Search by properties. The filter bar automatically provides properties available on objects within the current folder

When filtering on anything other than the current folder, results appear from many different places in the project. The folders appear in a lighter gray font and some actions are unavailable (such as creating a new workflow or folder), but otherwise functionality remains the same as in the normal data view.

Filtering Jobs and Analyses

The following filters are available for executions. Filters listed in italics are not displayed in the filter bar by default but can be added to the bar by selecting them from the "Filters" dropdown menu on the right.

• Search scope: The default displays root executions only, but you can choose to view all executions (root and subjobs) instead

• State: for example, Failed, Waiting, Done, Running, In Progress, Terminated

• Name: Search by case-insensitive string or regex, for example, "BWA" or "MEM$" both match "BWA-MEM". This only matches the name of the job or analysis, not the executable name.

• ID: Search by job or analysis ID, for example, "job-1234" or "analysis-5678"

• Created date: Search by executions created before, after, or between different dates

• Launched by: Search by the user ID of the user who launched the job. The filter bar shows users who have run jobs visible in the project

• Tags: Search by tag. The filter bar automatically populates with tags available on the visible executions

• Properties: Search by properties. The filter bar automatically provides properties available on executions visible in the project

• Executable: Search by the ID of executable run by the executions in question. Examples include app-1234 or applet-5678

• Class: for example, Analysis or Job

• Origin Jobs: ID of origin job

• Parent Jobs: ID of parent job

• Parent Analysis: ID of parent analysis

• Root Executions: ID of root execution

Multi-Word Queries in Filters and Searches

When filtering on a name, any spaces expand to include intermediate words. For example, filtering by "b37 build" also returns "b37 dbSNP build".

Filtering by Date

Some filters allow you to specify a date range for your query. For example, the "Created date" filter allows you to specify a beginning time ("From") and/or an end time ("To"). Clicking on the date box opens a calendar widget which allows you to specify a relative time in minutes, hours, days, weeks, months, or an absolute time by specifying a certain date.

For relative time, specify an amount of time before the access time. For example, selecting "Day" and typing 5 sets the datetime to 5 days before the current time.

Alternatively, you can use the calendar to represent an exact (absolute) datetime.

Setting only the beginning datetime ("From") creates a range from that time to the access time. Setting only the end datetime ("To") creates a range from the earliest records to the "To" time.

A filter with a relative time period updates each time it is accessed. For example, a filter for items created within two hours shows different results at different times: items from 9am at 11am, and items from 2pm at 4pm. For consistent results, use absolute datetimes from the calendar widget.

Filtering by Tags and Properties

Tags

To search by tag, enter or select the tags you want to find. For example, to find all objects tagged with "human", type "human" in the filter box and select the checkbox next to the tag.

Unlike other searches where you can enter partial text, tag searches require the complete tag name. However, capitalization doesn't matter. For example, searching for "HUMAN", "human", or "Human" all find objects with the "Human" tag. Partial matches like "Hum" do not return results.

Properties

Properties have two parts: a key and a value. The system prompts for both when creating a new property. Just like tags, properties allow you to create your own common attributes across multiple projects or items and find them quickly and easily. When searching for a property, you can either search for all items that have that property, or items that have a property with a certain value.

To search for all items that have a property, regardless of the value of that property, select the "Properties" filter (not displayed by default), enter the property key, and click Apply. To search for items that have a property with a specific value, enter that property's key and value.

The keys and values must be entered in their entirety. For example, entering the key sample and the value NA does not match objects with {"sample_id": "NA12878"}.

Any vs. All Queries

Some filters allow you to select multiple values. For example, the "Tag" filter allows you to specify multiple tags in the dialog. When you have selected multiple tags, you have a choice whether to search for objects containing any of the selected tags or containing all the selected tags.

Given the following set of objects:

• Object 1 (tags: "human", "normal")

• Object 2 (tags: "human", "tumor")

• Object 3 (tags: "mouse", "tumor")

Selecting both "human" and "tumor" tags, and choosing to filter by any tag returns all 3 objects. Choosing to filter by all tags returns only Object 2.

Clearing All Filters

Click the "Clear All Filters" button on the filter bar to reset your filters.

Saving Filters

If you wish to save your filters, active filters are saved in the URL of the filtered page. You can bookmark this URL in your browser to return to your filtered view in the future.

Bookmarking a filtered URL saves the search parameters, not the search results. The filters are applied to the data present when accessing the bookmarked link. For example, filters for items created in the last thirty days show items from the thirty days before viewing the results, not the thirty days before creating the bookmark. Results update based on when you access the saved search.