Getting started with Power Scripts™ for Jira cloud

The following table contains pages of Power Scripts for Jira cloud that you might use the most in the beginning, their purpose and instructions on how to access them.

PageNotesHow to access
Getting startedUse this page whenever you are stuck with the scripts and want a quick tip.
  1. Go to Settings > Add-ons > Manage Add-ons.
  2. Locate Power Scripts.
  3. Click Getting Started.
Power Scripts AdministrationHere you can configure the basic parameters of SIL.
  1. Go to Settings > Add-ons > Manage Add-ons.
  2. Locate Power Scripts.
  3. Click Configure.
SIL ManagerSIL Manager page contains SIL editor and is a central point where you develop your scripts. For all scripts that reside in the virtual directories, this tool offers all the power of SIL at your crafty fingertips.Click SIL Manager from Jira home, yup, it's that easy.
SIL editor in the workflow post-functionsIn addition to writing your scripts on the SIL Manager page, you can also create them in the SIL editor when you add a SIL post-function in your project workflow settings.
  1. Go to your project settings.
  2. Select Workflows and add a SIL workflow post-function.

Where to begin

You can start developing your scripts in several ways:

  1. Start on the SIL Manager page
  2. Start in the project workflows
    1. select an existing script or 
    2. write a new one

To demonstrate these options, we will show them on a simple example: assigning a ticket to the current user when the ticket is transitioned from "In Progress" to "Done".

Writing a new script in the SIL Manager

  1. Click SIL Manager from Jira home.
    You can create a new script within a new file or folder.
  2. To create a new script within new file, right click the silprograms folder and select New File.



  3. Give a name to your new script.
  4. Write the script in the SIL editor. Click Check to validate the syntax.



  5. Click Save.

That's it. Your script is saved and now you can add it to the project workflow.

Adding an existing script to the project workflow

  1. From Jira home, go to Settings > Projects.
  2. Click the necessary project and click Settings.
  3. Click Workflows and then Edit in the Actions column.



  4. Display the workflow as Text. In the Transitions column, select a transition you'd like the script to work for. The Step Name(id) column represents ticket original status and the Transitions(id) column represents where the ticket will go to. For our example we go from "In Progress" to "Done".

  5. Click the Post Functions tab and click the Add post function link.



  6. Select SIL Post function and click Add.
  7. Select use an existing script, unmodified and click Next.



  8. Select a script that you already created, click Next, and then Add.



  9. To save changes, click Publish Draft.


  10. In the dialog that appears, select whether you'd like to backup project copy. Click Yes and Publish.

That's it. (smile)

You can transition the tickets in your project to "Done" and they will automatically get assigned to Admin.

Adding a new script from the project workflow

  1. In the same way as in the instructions for the new script, add a SIL post-function for the project.
  2. Select create a new script and click Next.



  3. Name your script and select the directory where to store it. Click Next.
  4. Write your script. Click Check to validate syntax. Click Next to save the script and then click Add.

     

  5.  To save changes, click Publish Draft.
  6. In the dialog that appears, select whether you'd like to backup project copy. Click Yes and Publish.


That's it. (smile)