Hey, you made it!

Welcome to AutoBlocks for Jira, Adaptavist's visual programming environment for non-programmers! AutoBlocks helps you automate Jira processes in a powerful, accessible way. There's so much to show you!

We've assembled a brief tutorial to teach you AutoBlocks basics. The tutorial is made up of four parts, each of which you can complete in 5 to 15 minutes.

Note: We strongly recommend you complete the tutorial on a test instance.

Block Talk

AutoBlocks can do a lot, but let's start with the basics to get you up and running. In the four tutorial parts that follow, we'll build your knowledge not only to help you use the program in increasingly advanced ways, but also so you can better envision the efficiencies you can gain with AutoBlocks.

Essential Spaces

  • Workspace - The empty 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.

  • 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.

  • 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.

Part 1: Creating Your First AutoBlocks Project

Follow these steps to use the workspace to create a project and add some issues to it.

  1. Click Create Workspace.
  2. Click Triggers, and drag a Manual trigger onto the workspace.
    See the play button on the trigger? Later, you will click it to run the automation you build. Triggers remain inactive until a workspace is saved and installed, which you'll learn about later.
  3. Click Projects, and drag a Create Project block onto the workspace.
    Create Projectnamekeydescriptionproject templatestructuresasnew_project_1
    Blocks on the workspace that aren't attached to a trigger are inactive.
  4. Drag the Create Project block up to the trigger to connect the two pieces together. The block becomes active when it's attached to the trigger.
  5. Change the key value in the Create Project block.

    Note: The values for name and key must not match.

  6. Set project template to Task Management.

Titling and Saving a Project

Before you add issues to the project, title and save the workspace.

  1. Click [Workspace Name], and name the workspace.
  2. Press Enter to save the project title.
    You can change the title any time.
  3. Click Save in the upper-right corner of the screen.
    Saving doesn't kick off automation in a Jira project, but it saves what you've created in AutoBlocks so you can reload the page without losing work.

Adding Issues

Now that the project is saved, let's add blocks to populate the project with issues.

  1. Click the Issues section of the toolbox.
  2. Drag a Create Issue block onto the workspace, and connect it to the bottom of the Create Project block.
  3. Update the project value in the Create Issue block to match the key value specified in the Create Project block.
    You can also edit summary and description information.
  4. Click Save.

Installing and Verifying Your AutoBlocks Project

  1. Click the toggle switch in the upper-right corner to install the workspace.

    Toggle On

    The manual trigger becomes active now that you've saved and installed the workspace.

  2. Click play on the Manual trigger block to execute the block chain you've built.

  3. Click the Events tab and review the events.
    You should see messages similar to this:

2 minutes ago Created project: Foo

Done! Now what?

Congratulations! You've just automated the process of creating a project and putting an issue in it. In Part 2 of the tutorial, we'll build on this example and show you more ways to work with AutoBlocks.

Part 2: Reworking a Workspace