Power Scripts Product Tour

This topic provides an overview of the main navigation elements of the Power Scripts app.

You can access the Power Scripts app from the Power Plugins Configuration left menu section on the Manage Apss page of your Jira Administration panel.

  • The SIL Manager menu opens the tool where you write and store your scripts.

  • The Script Templates page offers out-of-the-box scripts you can customize and use without writing code.

  • The sub-sections of the Power Apps Config menu provide you with quick access to the most used configurations.

  • The Power Suite page contains all the other apps and connectors in the toolkit.

The screenshot below shows the Power Plugins Configuration menu section in the Jira Administration panel.

A screenshot of the Manage apps page showing the Power Plugins Configuration menu section.
The Power Plugins Configuration menu section

Let’s look at each menu section and learn more about the core functionalities of the Power Scripts app.


The SIL Manager

The SIL® Manager is a scripting console where you write, modify, organize, test/debug, and execute your scripts.

To open the SIL Manager:

  1. In the Jira Administration settings menu, select Manage apps.

  2. In the side menu, click SIL Manager.

Screenshot shows how to open the SIL Manager in the Jira console.
The SIL Manager

The SIL Manager is straightforward and easy to navigate. It consists of several components.

 

What is this?

What can I do?

 

What is this?

What can I do?

 

In the left side of the SIL Manager, you have the Files panel, which contains two main directories:

  • silprograms, where you organize and store your scripts and related files;

  • a settings folder called kepler.

  • Create file folders.

  • Organize your scripts, files, and programs by grouping them in different folders.

  • Open the scripts you want to modify or run.

  • Save the script you’re working on. Alternatively, you can use the Save (icon-save.png) icon located on the main menu toolbar.

  • Use the Search field to locate specific scripts.

  • Collapse or expand the Files panel by clicking the vertical Files icon.

 

The Power Scripts editor is the central and largest panel in the SIL Manager. This is where you do the actual scripting.

  • Create or modify your saved scripts.

  • The name of the file you’re working on is shown at the top left corner of the editor.

  • When you start typing, the SIL manager offers prompts for your script.

 

When working in the editor, you use the main menu toolbar to perform different actions or accomplish certain tasks.

  • Use the File drop-down menu to create new folders and files and access the SIL manager settings.

  • Use the Edit drop-down menu to search for specific text in the script, find and replace specific text, or go to a specific row and column in the script.

  • Use the Insert drop-down menu to add a condition in your script.

  • Use the Snippets drop-down menu to insert a snippet into your code. Snippets are small ready-to-edit sections of code that can be inserted into a larger script.

  • Use the Window drop-down menu to switch between full-screen and regular mode.

  • Use the Run drop-down menu to set the Default Script Context, which can be a specific Jira issue or global.
    The Run menu also lets you check, run, or debug the script you’re working on. To do this, you can also use the Check (icon-check.png), Run (icon-run.png ), and Debug (icon-debug.png) icons on the main menu toolbar.

 

The tabs at the bottom of the SIL Manager display scripts-related data.

  • The Editor console displays output for some of the scripts that you run.

  • The Server log tab opens the actual Jira server log, where you can view Power Script errors.

  • The Event viewer displays event data for the scripts you run or check. For more information about an event, click its Show details link.

As you can see in the screenshots above, each tab that you open contains additional menu icons situated in the right corner of the panel. Use these icons to perform actions specific to the panel you’ve opened. For example, in the Editor console you can copy the output, download it to a file or clear the results.

 

The vertical tabs on the right provide access to additional panels where you can create and manage SIL-specific variables and aliases and access the Power Scripts documentation.

  • You can use the Persistent variables panel to create and assign values to variables that are not part of Jira, but are stored in the database.

  • You can use the SIL Aliases panel to create aliases for custom fields created in Jira. You can then use the aliases instead of the Jira issue keys.

Persistent variables and SIL aliases are part of the advanced Power Scripts functionality.

  • In the SIL Help panel, you can open the online Power Scripts product documentation or use the search field to access the in-product help content.


Script Templates

Script templates are customizable scripts that you can use immediately without any coding. A simple interface generates the script based on your needs. Script templates are designed to support beginner Power Script users with some of the most commonly used types of scripts. For ease of use, script templates are organized into categories.

To browse the Script Templates:

  1. Go to Manage apps, and in the Power Plugins Configuration section, click Script Templates.

  2. Select a category.

  3. Click a script template to open it.

If you are just starting with Power Scripts, you can browse and read through the available script templates. All script templates follow a similar structure.

  1. Under the template's name, you can see a short description of the script action.

  2. Use the drop-down menus to set the context for the script–where and how it will be applied.

  3. Some script templates require additional values or parameters.

  4. The SIL code preview displays the script based on the options, parameters, and values you provide.

  5. Once the script is generated in the SIL code preview panel, you can run it immediately by clicking Apply Action.
    Alternatively, copy and paste the code into the SIL Manager.

To learn how and when to use script templates, see the feature's documentation.


Power Apps Config

In some cases, your scripts need additional configurations in order to run properly on the Jira instances that you manage. You can access and manage these configurations on the Power Apps Config page.

  1. Go to Manage apps, and in the Power Plugins Configuration section, click Power Apps Config.
    You can access some of the most used configurations nested under the Power Apps Config menu link.

  2. Select a configuration group from the top-level menu.

The Power Scripts configuration menu has some specific configurations related to the Power Scripts app. If you install another Power Suite app, its configurations will be added to this menu.

  1. Select a specific configuration from the sub-menu.

  2. To create a configuration, provide the required values and parameters in the configuration settings panel.


Power Suite

In addition to Power Scripts, the Power Suite toolkit has additional apps and connectors.

To view and/or install Power Suite apps and connectors:

  1. Go to Manage apps, and in the Power Plugins Configuration section, click Power Suite.

  2. The dashboard lets you see which apps have already been installed.
    In this example, it’s just Power Scripts.

  3. To install a new app, click Try it.
    You are automatically redirected to the Atlassian Marketplace, where you can start a free trial or purchase the app.