Skip to main content

changedBy

Overview​

The changedBy function allows you to search for issues where fields were updated within a given time period, optionally filtered by the user who made the updates. This is useful for tracking field changes, monitoring updates, and generating reports based on field modifications.

Syntax​

issue in changedBy("subquery", "fieldName", "start_date", "end_date", "user")

Parameters​

  • subquery (required): A valid JQL query that defines the set of issues to evaluate
  • fieldName (optional): The name of the field to check for updates. If empty, any field change will be matched
  • 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
  • user (optional): The username or display name of the person who made the update

Supported Operators​

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

Examples​

Finding issues where any field was updated within a date range​

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

Finding issues where Description was updated within a date range​

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

Finding issues where Priority was updated by a specific user​

issue in changedBy("project = SER", "Priority", "2023/01/01", "2023/12/31", "jsmith")

Finding issues updated since a specific date​

issue in changedBy("project = SER", "", "2023/06/01 10:00")

Finding issues not updated by a specific user​

issue not in changedBy("project = SER", "", "2023/01/01", "2023/12/31", "jsmith")

Performance Considerations​

  • The function analyzes all changelogs from issues matching the JQL subquery, which may take significant time to complete
  • Using specific date ranges can improve performance
  • Including a username filter can significantly reduce the number of issues to process

Error Handling​

The function will return an error if:

  • Invalid field names are specified
  • Invalid date formats (must be "yyyy/MM/dd HH:mm" or "yyyy/MM/dd")
  • Non-existent users are specified
  • Invalid JQL queries
  • transitionedBy - Search for issues transitioned to a specific status
  • commented - Search for issues with specific comment criteria