Shared Groovy Scripts

This document details the Shared Groovy scripts feature of JMWE. Using this you can define global Groovy scripts that will be available from any Groovy script written in the Groovy console, post-functions, conditions and validators. This is useful for reusing complex/lengthy scripts across multiple workflow transitions. It is available under JMWE administration pages.

On this page:

1 Create a Shared Groovy Script
2 Edit a Shared Groovy Script
3 Delete a Shared Groovy Script
4 Shared Groovy Scripts best practices
5 Use cases for Shared Groovy scripts
- 5.1 Add Days to Date excluding weekends
- 5.2 Check for attachments with a specific extension during a transition

Create a Shared Groovy Script

To create a shared Groovy script:

Go to JMWE administration pages
Click on Shared Groovy Scripts
Click on New shared script
Enter the name of this shared script in Shared script name. This name can be used as the name of the Class that will contain all methods and data members defined in the script.
Enter an optional description in Description.
Input a valid Groovy script in Groovy script. It is strongly recommended to wrap any (static) method in a class.
Click on Save.

Edit a Shared Groovy Script

To edit a Shared Groovy script:

Go to JMWE administration pages
Click on Shared Groovy Scripts
Click on Edit for the specific Shared Groovy Script
Modify the script.
Click on Save.

Delete a Shared Groovy Script

To delete a Shared Groovy script:

Go to JMWE administration pages
Click on Shared Groovy Scripts
Click on Delete for the specific Shared Groovy Script
Confirm the action.
The Shared Groovy Script gets deleted.

It is strongly recommended to remove the references to the Shared Groovy Script in any workflow extension before deleting it.

Shared Groovy Scripts best practices

Defining a static method

In this example, we will create a simple static method plusOne in a shared Groovy Script named Functions. Note, the name of the shared script becomes the name of a class.

static int plusOne(int i) {
  return i+1;
}

You can use this in a Groovy script section of any workflow extension (e.g. a Scripted Groovy Operation post-function) like this:

return Functions.plusOne(1)

When you test this script in the Groovy editor against any issue the tester will return 2

Defining an explicit class

In this example, we will create a shared script named GreetMe with the script:

class GreetMe{
  String aString = "Hello"
  String sayIt() {
    return aString;
  } 
}

You can use this in a Groovy script section of any workflow extension (e.g. a Scripted Groovy Operation post-function) like this:

When you test this script in the Groovy editor against any issue the tester will return Hello

Defining multiple classes inside a single shared script

In this example, we will create a shared script named MyClasses with the script:

You can use this in a Groovy script section of any workflow extension (e.g. a Scripted Groovy Validator) like this:

When you test this script in the Groovy editor against any issue the tester will return true

Defining a service with access to global variables and functions

The global variables and functions that can be used in any Groovy script defined in a workflow extension are not available directly in shared Groovy scripts. The easiest approach to be able to access them is to define a class that will contain all the desired methods (non-static) and to pass the globals to that class. This will be like a "Service". For example:

And you can then use this "Service" from the main script:

Use cases for Shared Groovy scripts

Add Days to Date excluding weekends

Create a shared Groovy script that adds a certain number of days to a date excluding weekends

Create a shared groovy script, AddDaysExcludingWeekends, with the following script
Save it.

You can use this in a post-function to set a Date-time picker field. For example Set a Date time picker field to the Due date plus 5 days, excluding weekends. The script in the post-function will be:

Check for attachments with a specific extension during a transition

Create a shared validator that checks for attachments of a specific extension were added to the transition screen

Create a shared groovy script, AttachmentValidator, with the following script:
Save it.

Now you can use this in Scripted Groovy validator across transitions to validate the attachments added on the transition screen. Add the Scripted Groovy validator and call the method passing the issue variable and extension as parameters.

JMWE for Jira Server and Data Center

Our new Appfire Documentation Space is now live!