Using the Release API in scripts
Release has an API that you can use to manipulate releases and tasks. You can access the API from Jython Script tasks and from Release plugin scripts. This is an example of a simple Jython script in a Script task. It uses a script to add a comment to the task.
- Go to the release overview and click New release (because this is a simple example, you can create an empty release that is not based on a template).
- In the release properties, set the Release Name to Script example.
- Click Create to create the release.
- In the release flow editor, click the name of the first phase and change it to Test.
In the Test phase, add two tasks:
- A Jython Script task called Add a comment
- A Gate task called Check result
Click the Add a comment task and add the following Script:
task = getCurrentTask() comment = Comment() comment.setComment("Hello World!") taskApi.commentTask(task.id, comment)
Close the task and click Start Release.
The Add a comment task fails. Click the task to see the reason for failure in the Comments section:
This message indicates that you must specify the user name under which to run the script. This is because the API gives you access to releases and tasks, so Release needs to check the user’s credentials to verify if certain operations are allowed.
- Close the task and select Properties from the Show menu.
Enter your user name and password in the Run automated tasks as user and Password boxes.
Note: For a production configuration, it is recommended that you create a global “script runner” user that can be used for this purpose, rather that using your own credentials.
- Click Save to save the release properties.
- Select Release flow from the Show list.
Open the Add a comment task and click Retry.
The task succeeds and the release waits at the Gate task, giving you time to inspect the script result.
Open the Add a comment task and check the Comments section for the “Hello World!” comment:
The first line of the sample script uses the
getCurrentTask() method to get a reference to the task that is currently executing (the Add a comment Jython Script task) and store it in a variable called
task = getCurrentTask()
To set a comment on the task, the script uses the
taskApi.commentTask endpoint. The
commentTask method takes the task ID and a
Comment object as parameters. The
Comment object is a simple wrapper around a string.
comment = Comment() comment.setComment("Hello World!")
The script calls the
commentTask() method to add the comment to the task:
Note: For any call to an API endpoint, such as
releaseApi, you must set the Run automated tasks as user property on the release. The scripts will be executed with the permissions that that user has on that particular release.