Page tree
Skip to end of metadata
Go to start of metadata

插件为拥有附件issue提供了JQL函数

Alias

Equivalent havingAttachments JQL

Result

issue in attContent("word")issue in havingAttachments("content: word")returns list of issues which have an attachment, which contains a 'word' inside file content
issue in attName("sample")issue in havingAttachments("sample")all issues that have attachment with name 'sample'
issue in attType("pdf")issue in havingAttachments("type:pdf") all issues with 'pdf' attachments


Advanced function - havingAttachments

The add-on provides havingAttachments("query") JQL function, where syntax of the query is a bit similar to Google or Bing search engine query syntax, for example:

  • issue in havingAttachments("word") - returns list of issues which have an attachment, which contains a word inside file content;
  • issue in havingAttachments("\"multi-word text\"") - all issues with attachments with a multi-word text in their file contents;
  • issue in havingAttachments("text1 OR text2") - all issues with attachments with either text1 or text2 somewhere in their file contents;
  • issue in havingAttachments("text1 text2") - same as issue in havingAttachments("text1 OR text2") - this is the main difference from Google query syntax - here space means not and but or;
  • issue in havingAttachments("text1 AND text2") - all issues with attachments with both text1 and text2 somewhere in their file contents;
  • issue in havingAttachments("content:text") - same as issue in havingAttachments("text");
  • issue in havingAttachments("type:pdf") - all issues with pdf attachments;
  • issue in havingAttachments("name:workflow OR type:png") - all issues that have attachment with name workflow or with png file extension;
  • issue in havingAttachments("name:summary AND type:txt") - all issues that have attachment with name summary and with txt file extension;
  • issue in havingAttachments("\"search attachment for JIRA add-on\" AND name:article01") - all issues that have an attachment containing search attachment for JIRA add-on text and the attachment file is named article01 (without the extension);
  • issue in havingAttachments("") or just issue in havingAttachments() - returns list of issues which have at least one attachment (with any contents).

In general, you can use any Lucene query, with the following fields available:

  • content, which searches inside attachment file contents. It's the default field if you don't specify any field explicitly.
  • name, which searches by names of the attachment files excluding file extensions;
  • type, which searches by file extensions (pdf, doc, txt, xls, odt, ods, xml, html, ...)

Wildcards

Two wildcards (* and ?) can be used in search terms. Wildcards will not work if you search for phrase like: havingAttachments("\"multi-word text\""). Wildcards are ignored when used in phrases.

  • " * " is used for multiple characters wildcard search: tes*, te*t. Term can't start with *, it can be used at the end or in the middle of search term.
  • "?" is used for single character wildcard search: tes?, te?t. Term can't start with ?, it can be used at the end or in the middle of search term.
  • No labels