JQL Keywords Synchronization
The metadata that we store against each issue is automatically updated asynchronously whenever an issue is updated. This means that your search results may be out-of-date for a second or two after you edit an issue.
When ScriptRunner for Jira Cloud is installed an initial synchronization must be performed by an administrator. Although the administrator initiates the synchronization process, the issues are accessed as the ScriptRunner user.
To carry out the initial synchronization on the JQL Keywords Sync page:
- Navigate to the JQL Keywords Sync page from the Jira Administration menu by selecting Apps→ScriptRunner→JQL Keywords Sync.
- Click the Sync All Issues button, as shown below:
The keywords sync stops If you close this page whilst the sync is in progress. You can resume the initial sync at a later date by visiting this page and clicking on the Sync All Issues button. Search results for queries that use these keywords will be incorrect until an initial sync has been completed.
A list displays containing metadata that is stored for each issue, including:
a list of the link types (e.g. Blocks) for linked issues
the number of issue links
a list of link names (e.g. "is cloned by") for linked issues
number of attachments on the issue
list of file extensions from attachments
the date on which the first attachment was added to the issue
date on which the last (most recent) attachment was added to the issue
list of username that added attachments to the issue
number of subtasks of the issue
list of project roles that worklogs were restricted to
list of user groups that worklogs were restricted to
number of comments on the issue
date of the first comment on the issue
date of the last (most recent) comment on the issue
list of all dates on which comments were added to the issue
list of usernames that have added comments to the issue
list of project roles that comments have been restricted to
list of user groups that comments have been restricted to
the username of the person who last (most recent) made a comment on the issue
the project role that the last (most recent) comment was restricted to
the user group that the last (most recent) comment was restricted to
Permissions
The ScriptRunner user can only see comments and worklogs from the following groups:
jira-code-users
jira-servicedesk-users
jira-software-users
Search results will be incorrect if the ScriptRunner user does not have permission to view:
Edit all issues (edit permission is required to store the additional metadata).
All comments, including those restricted to a particular group/role.
All worklogs, including those restricted to a particular group/role.
If worklogs and comments are restricted to a role, ensure the role is assigned to the group the ScriptRunner user belongs to under Project Settings.