Before You Start

This initial tutorial guides you through creating a sample project, finding ScriptRunner within Jira, and creating resources you will need for later activities.

Create a Sample Project

Walk through the following steps to create a sample project you can use for the rest of the tutorials:

You have the option to create a scrum software development project or a process management project.

  1. From the top ribbon, click Projects, and then click Create Project.

  2. In the Create Project window, select Create Sample Data at the bottom of the window.

    The Create Sample Data option highlighted in the Create Project screen.

  3. Select the type of project you want to create, and then click Next. TIP: We recommend creating a scrum software development project or a project management project for these activities.

  4. Enter your Name, Key, and Project Lead details.

  5. When you are all set, click Submit to create your project.

Voila! You get a project created with sample data so you can work with different scenarios in the labs. In this example, we created a Scrum software development project called Demonstration Project Scrum, and we see issues in a sample sprint and the backlog of the project.

An example Backlog for the newly created project.

Review Manage Apps Page

In this quick activity, you access the ScriptRunner app to view information. Knowing where to go for this information is important if you are managing ScriptRunner or need to contact Adaptavist support for help with ScriptRunner.

  1. From the Administration menu, select Add-ons.

  2. On the Manage Apps page, under Atlassian Marketplace, click Manage Apps.

  3. Under User-Installed Apps, click to expand Adaptavist ScriptRunner for Jira. Review information about ScriptRunner. This information includes versions, license details, links to documentation, and modules enabled.

(Optional) Create Resources for Activities

This exercise ensures that you have the resources needed for different activities if you plan to complete all the tutorials. If you want to follow the instructions but use your own data, you can do so.

ActivityResources Needed

Aggregate JQL Search

Create four issues with work logged and remaining estimates.

Script Condition - All Sub-Tasks Must be Resolved

Create an issue with a few sub-tasks. Example:

Main Issue: Upgrade Server Subtasks:

  • Identify current state and desired state on server

  • Perform upgrade

  • Test upgrade and confirm state is correct

Script Post-Function - Assign an Issue for Review

Create a workflow that includes:

  • Upgraded as a status, replacing the Resolved status before Done.

  • Upgrade Issue transition

This workflow needs to be associated with the correct project as well. In our example, we use the Virtual Tour Server Management project.

Create a Simple Behaviour

Create a custom field called Customer Type (Select List) with the following options:

  • Small Business - For-Profit

  • Large Business - For-Profit

  • General Training License

Create a Select List with Other

Create a two custom fields:

  1. Favorite Fruit - Select List

    • Apples

    • Bananas

    • Other

  2. Favorite Fruit (Other) - Single Line Text Field

Fast-track transition an issue

Create workflow that includes some type of review status. This could be:

  • Review

  • In Review

  • Waiting for Approval

What’s Next?

After you have finished the activities above you are ready to get started with the rest of the tutorials:

On this page