Skip to main content

Tools

Tools are no-code bulk operations that you run from the Script Master Tools page in Jira or Confluence. Each tool shows you what it will change before it writes anything.

Applies to: Script Master for Jira and Script Master for Confluence Β· Cloud

You open the page from Apps > Script Master Tools in the left sidebar. In Confluence, it's listed under Your apps. It lists the tools an admin has made available to you. Admins set that per tool on the Tools tab in Script Master: see Set who can use each tool.

Jira tools​

Script Master for Jira has two tools.

ToolWhat it does
Bulk Set ResolutionSets or clears the resolution on work items selected by JQL.
Copy Custom Field ValuesCopies values from one custom field to another on work items selected by JQL.

The Script Master Tools page in Jira with the Bulk Set Resolution and Copy Custom Field Values tiles

Confluence tools​

Script Master for Confluence has seven tools. The two that delete data start out Disabled.

ToolWhat it does
Clone SpaceCreates a space holding a copy of another space's page tree.
Replace LabelSwaps one label for another on pages, blog posts and attachments.
Add Label to Parent PagesLabels every ancestor of a page.
Add Label to Child PagesLabels every descendant of a page.
Insert Content into PagesAdds a storage-format snippet to many page bodies.
Delete AttachmentsMoves matching attachments to the space trash.
Delete Attachment VersionsDeletes old versions from attachment history.

The Script Master Tools page in Confluence with a tile for each available tool

How a run works​

Every tool follows the same steps, so the screen reads alike whichever one you pick.

  1. Set it up. Choose what the run targets and what it changes. Confluence tools work on spaces, a page tree or a CQL query. Jira tools work on a JQL query.
  2. Check. Select the tool's check button, such as Check pages or Check work items. The tool reads and counts, and writes nothing.
  3. Review. Read the report. It says how many items matched, whether the run reached the 5,000-item cap, and anything that blocks it. Most tools also list the items.
  4. Run. Select the action button, such as Replace label. The tool works through the items one at a time and shows a counter. A summary replaces the form when the run ends.

If you change a search field after a check, the report goes away and you check again. That way a run never uses a stale list. Select Edit to change the form and keep your values, or Clear form to start over.

note

Tools run in your browser. Keep the tab open until the summary appears.

Before you run a tool​

  • Jira or Confluence permission: whatever the change itself needs. A tool runs as you, so it changes only what you could change by hand.
  • App permission: the tool has to be available to you. See Set who can use each tool.