Attachments

hasAttachments

CAUTION: You will need to reindex before you can use this function.

Find all issues on your instance with attachments.

hasAttachments()

Optionally, you can use the first argument to specify the attachment file extension.

hasAttachments([file extension])

You can also use an additional argument to specify the number of attachments.

hasAttachments([file extension], [number of attachments])

Examples

As a system administrator I am in charge of creating new users on our instance. For a new user to be created, the request must have a PDF approval form attached. I want to create a filter to only see new user request tickets that have a PDF of a new user request approval form attached.

issueFunction in hasAttachments("pdf")

I want to only see tickets that have exactly seven attachments of type PDF

issueFunction in hasAttachments("pdf", "7")

I want to only see tickets that have more than three attachments of type PDF

issueFunction in hasAttachments("pdf", "+3")

I want to only see tickets that have less than five attachments of type PDF

issueFunction in hasAttachments("pdf", "-5")

If I want to filter by number of attachments but I do not want to specify the attachment type, I can use an empty string as the first argument. The following will filter tickets with more than five attachments of any type

issueFunction in hasAttachments("", "+5")

fileAttached

CAUTION: You will need to reindex before you can use this function.

Find issues by attributes of their attachments.

fileAttached(attachment query)

The following predicates are supported:


Name	Argument Type
by - attached by this user	username or user function, eg currentUser()
after - attached after date	date or date expression, or date function, eg startOfDay(), lastLogin()
before - attached before date	date or date expression, or date function eg startOfDay(), lastLogin()
on - attached on date	date or date expression, or date function

Tip: Using standard JQL functions as an argument type is supported.

Example

I am in charge of uploading invoices as attachments to tickets in our finance project. I spot a mistake in my spreadsheet and I want to find all tickets I have added invoices to in the past week so I can delete and re-attach all invoices.

issueFunction in fileAttached("after -1w by currentUser()")