Skip to main content

commented

Overview​

The commented function allows you to search for issues that have comments matching specific criteria, such as content, author, or time period.

Syntax​

issue in commented("subquery", "author", "start_date", "end_date", "content")

Parameters​

  • subquery (required): A valid JQL query that defines the set of issues to evaluate
  • author (optional): The display name of the comment author (partial match, case-insensitive)
  • start_date (optional): The start date in format "yyyy/MM/dd HH:mm" or "yyyy/MM/dd"
  • end_date (optional): The end date in the same format as start_date
  • content (optional): Text to search for in comment body (partial match, case-insensitive)

Supported Operators​

  • in - issues matching the criteria
  • not in - issues not matching the criteria

Examples​

Finding issues with comments in a date range​

issue in commented("project = SER", "", "2023/01/01", "2023/05/01")

Finding issues with comments by a specific user​

issue in commented("project = SER", "John Smith", "2023/01/01", "2023/12/31")

Finding issues with comments containing specific text​

issue in commented("project = SER", "", "2023/01/01", "", "urgent")

Finding issues without comments in a date range​

issue not in commented("project = SER", "", "2023/01/01")

Finding issues with comments by user containing specific text​

issue in commented("project = SER", "John", "", "", "approved")

Performance Considerations​

  • The function analyzes all comments from issues matching the JQL subquery
  • Large numbers of comments may increase processing time
  • Use specific subqueries and date ranges to improve performance

Error Handling​

The function will return an error if:

  • Invalid date formats (must be "yyyy/MM/dd HH:mm" or "yyyy/MM/dd")
  • Invalid JQL queries
  • changedBy - Search for issues where fields were updated
  • transitionedBy - Search for issues transitioned to a specific status