Getting started with Power Scripts (Cloud)

This page will help you get started with the product and in case you need any additional assistance, do not hesitate to reach out to us or email us at products@cprime.com.

Where to begin

You can work with the scripts in several ways:

1. Write a new script from the SIL Manager page
2. Go to the project settings > Workflows and 
   1. select an existing script or 
   2. write a new one.

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

Write a new script via the SIL editor directly

1. Click SIL Manager from Jira home.
2. You have several options: to create a new script within new file or folder, or to use the already existing script.
   
   
   
   
3. To create a new script within new file perform the right click on the silprograms folder. Select New File.
   
   
   
   
4. Give a name to your new script.
   
   
   
   
5. Write the script. In our example we write script to see the changes on issue description and assignee while status transition. Click Check to confirm the syntax.
   
   
   
   
6. Click Save to finish configuration.
   
   
   
   
7. To use script in post function follow Adding an existing script via the workflow steps.
   
   
8. That's it.

Adding an existing script via the workflow

1. Go to Settings > Projects > Projects > My project > Workflows.
2. Click Edit in the Actions column.
   
   
   
   
3. Display it as Text. From the diagram view pick up transition you'd like the script works for. For example, to go from 'To do' to 'In Progress', 'In Progress' to 'Done' and so on.
   Note: Step Name(id) column represents where to start from, Transitions(id) column represents where you go to.
   
   
   
   
4. For the Step Name In Progress click Done in Transition column to define a post function for 'In progress to Done' change.
   
   
5. Click the Post Function tab and click the Add post function link on the right side of the screen.
   
   
   
   
6. Select SIL Post function. Click Add.
   
   
   
   
7. Select use an existing script, unmodified from the bulleted list. Click Next.
   
   
   
   
8. Select the script you created beforehand. Scroll down and click Next. Click Add.
   
   
   
   
9. Changes will not be implemented until the created draft is published. Click Publish Draft.
   
   
   
   
10. Warning message will appear to check if you'd like to backup project copy. Click Yes and Publish.
    
    
    
    
11. That's it. You can see the transition changes now in your issues.
    
    
    
    

Adding a new script from the project workflow

1. Go to Settings > Projects > Projects > My project > Workflows.
2. Click Edit in the Actions column.
   
   
   
   
3. Display it as Text. Pick up transition you'd like the script works for. For example to go from 'To do' to 'In Progress', 'In Progress' to 'Done' and so on.
   Note: Step Name(id) column represents where to start from, Transitions(id) column represents where you go to.
   
   
   
   
4. For the Step Name To Do click In Progress in Transition column to define a post function for 'To do to In Progress' change.
   
   
5. Click the Post Function tab and click the Add post function link on the right side of the screen.
   
   
   
   
6. Select SIL Post function.
   
   
   
   
7. Select create a new script from the bulleted list. Click Next.
   
   
   
   
8. Put file name, let's say 'Test script from to-do to in-progress'. Select silprograms directory. Scroll down to click Next.
   
   
   
   
9. Write your script. For instance, to change issue description or assignee during transition. Click Check to confirm the syntax is correct and Next to save the settings.
   
   
   
   
10. Click Add to proceed.
    
    
    
    
11. Changes will not be implemented until the created draft is published. Click Publish Draft.
    
    
    
    
12. Warning message will appear to check if you'd like to backup project copy. Click Yes and Publish.
    
    
    
    
13. That's it. You can see the transition changes now in your issues.
    
    

+ link for currentUser() routine

+ give 1-2 script examples and a few links as examples for the routines

...

UI elements

Power Scripts Getting started page

To access the Getting started page:

1. Go to Settings > Add-ons > Manage Add-ons.
2. Locate Power Scripts.
3. Click Getting Started.

Power Scripts Administration page

To access this page:

1. Go to Settings > Add-ons > Manage Add-ons.
2. Locate Power Scripts.
3. Click Configure.

Here you can configure the basic parameters of SIL. All fields on this page are required.

Power Scripts Status page

Power Scripts - status page showing you:

• Status - shows you the status of the app. Here you can see the error if something went not as expected, for example of a connection wasn't established.
• The maximum number of users as detected from the engine. This is not your license tier!
• The number of postfunctions per second handled by the engine - 
  
• Reset status - 
• Adjust status - the size of the machine you use will be adjusted to your usage

SIL Manager page

SIL 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

To ensure for convenient script writing and text editing, this page has the following useful features:

• syntax highlighting, 
• autocomplete, 
• you can check your scripts
• Source file management across all defined trees 

Features in Power Scripts for Jira Cloud

With the beta release, a handful of features is available already and at a reduced pricing, and many more are coming along too!

	Feature / Area	PS Server	PS Cloud
1	Add, edit, delete SIL scripts
2	Harness the power of Jira without programming knowledge
3	SIL post-functions
4	Event listeners		in our roadmap!
5	Sync with remote systems		in our roadmap!
6	Workflow viewer
7	Schedule scripts to run on an interval or as a CRON job		in our roadmap!
8	JQL Support		in our roadmap!
9	LDAP support
10	Routines		and many more coming soon!

Pricing

Power Scripts for Jira (cloud) is available with the Early Bird promotional pricing during the first three months and the price will increase. Enjoy the low prices now!