latest

Terms and Definitions

Useful terms and definitions for AutoBlocks for Jira are provided in this topic.

Essentials

  • Block - A graphical representation of a chunk of code used to build and configure automations. Blocks in a workspace are inactive until connected to a trigger command.

  • Events - This tab shows you a log of events that have triggered in your workspace, including save history, errors, warnings, and other important messages. You can use filters to view events that occurred in the last few minutes, hours, days, weeks, months, and even years.

  • Toolbox - The collection of blocks you can use to configure your automations. Simply drag blocks from the toolbox onto the workspace and snap them together. Click and drag a block downward to break blocks apart. Unneeded blocks on the workspace can be dragged into the trash or back into the toolbox.

  • Timeline - A historical timeline appears in each workspace and tracks versions of the automation, which aids in reviews for deployment. For example, one can use the timeline to view only what was changed since a workspace was last approved/deployed. You can also use the timeline to revert and branch a workspace to a previous version.

  • Trash - A place you can drag a block or a set of blocks to delete it from the workspace.

  • Workspace - The white canvas where you put together blocks that tell Jira what to do and when to do it. At the bottom of the workspace is a trashcan where you can drag and dispose of unnecessary blocks. Zoom-in, zoom-out, and recenter viewing options are also available. Workspace may also refer to the entire automation (set of blocks), especially in discussions of exporting/importing and the review-for-deployment process.

Triggers

Triggers are a block type that can be used to activate and run your configured automation. Triggers added to the workspace remain inactive until a workspace is saved and installed.

  • Manual - A trigger block that activates only when you physically click on it. When you click a manual trigger, the Events tab opens to show you the automation progress.

  • When this workplace is installed - A listener trigger that runs your automation only when your workspace transitions from uninstalled to installed.

  • When this workplace is uninstalled - A listener trigger that runs your automation only when your workspace transitions from installed to uninstalled.

  • When an issue is [created] as [variable] - A listener trigger that runs your automation only when an issue is changed, based on the values you choose.

Projects

  • Create Project - A block that can be used to create a project within your Jira instance.

  • Delete Project - A block that can be used to delete a project within your Jira instance.

  • Create Component - A block that can be used to create a component for a specific Jira project in your instance.

  • Create Version - A block that can be used to create a version for a specific Jira project in your instance.

Issues

  • Create Issue - A block that can be used to create a new issue in a specific project within your Jira instance.

  • Update Issue - A block that can be used to update an issue in a specific project within your Jira instance.

  • Create Subtask - A block that can be used to create a sub-task for a specific issue within your Jira instance.

  • Link Issues - A block that can be used to link specific issues together within your Jira instance.

  • get issues linked [from/to] with link type - A block that can be used to gather issues linked to or from an issue, specified by link type.

  • workflow action - A block that can be used to move an issue through its workflow by applying a specific operation, e.g. In Progress, Reopen, or Close.

  • link type [action] - A block that defines a link’s relationship to another issue. Options are based on link types established in your Jira project.

  • Add Comment - A block that can be used to add a comment to an issue.

Fields

  • get from - A block that can be used to get specific information from something else, e.g. the Key of an issue or the Owner of a project.

  • set to - A block that can be used set a specific field’s value on an issue, e.g. setting or changing the Summary field value.

  • add to - A block that can be used to add items to specific issue fields, e.g. adding a component to an issue’s Components field.

  • remove from - A block that can be used to remove items from specific issue fields, e.g. removing a component from an issue’s Components field.

  • issue type - A block that specifies issue type, e.g. Bug or Story.

  • status - A block that that specifies issue status, e.g. In Progress or Resolved.

  • resolution - A block that specifies issue resolution, e.g. Fixed or Done.

  • priority - A block that specifies issue priority, e.g. low or high.

JQL

  • Issue Search - A block that can be used to perform a JQL (Jira Query Language) search for specific issues that match your criteria.

Text & Numbers

  • text block - This block can be used to create text.

  • number block - This block can be used to create a number.

  • create text with - Create a piece of text by joining together any number of items.

  • print - This block writes the specified text, number, or other value to the events log.

Logic

  • if…​ do - A block which can do a series of subsequent actions if the input condition is true.

  • comparison block - A block that compares two inputs. You can select from all ranges of comparisons, such as =, <, >, =/=, etc.

  • logic operations - If and, return if both inputs are true. If or, return if at least one of the inputs is true.

  • not - A negator block that finds an input’s opposite boolean value. Returns true if the input is false and returns false if the input is true.

  • true or false - A block used to represent boolean values true or false.

  • null - A block that represents a null (no assigned value).

Lists

  • create empty list - Create an empty list with any number of items.

  • create list with - A block that can be used to create a singular list using the combined input from many different lists.

  • for each [variable] in - This block allows you to iterate over a collection of items and perform an operation associated with each item. For example, you could use this block to change the priority of each issue returned from an issue search.

  • filter list retaining [variable] where expression - This block allows you to remove (filter out) items from a collection that don’t match a specific criteria.

  • transform [variable] in list using expression - This block allows you to modify an item in a collection using a specific expression/block.

  • [any] [variable] in list matches expression - This block allows you to check to see whether a specific item that matches your criteria is within a specific collection.

  • list [contains] item - This block allows you to check to see whether a collection of items contains a specific item.

  • list is empty - A block that can be used to check if a list is empty or not. Returns a boolean value of true if the list is empty and returns false if the list is not empty.

  • length of list - A block that can be used to determine how many items are in a list. Returns a number representing how many items the list contains.

Utilities

  • Send Email - This block sends an email with all of the input specifications.