CLOUD How to configure an automatic transition based on the Return code of SAP Transport Panel

As Reporter of an issue you normally want to know, when a change is ready on production. To integrate this information into a Jira status, we recommend an automatic transition based on the return code of the transports.

Transition: READY FOR PRODUCTION → IN PRODUCTION

When a transport is imported on a productive system the return code is sent back to Jira.
- The Return code field in Jira contains the highest code of all transports related to the issue (from the update of the transport via SAP).
- When a Return code of 0 or 4 is present in the issue the import step in SAP was successful.
A Jira automation rule is triggered when the Return code of an issue changes and then automatically sets the issue from the status READY FOR PRODUCTION to the status IN PRODUCTION depending on the field content (see app dependencies: Requirements, Installation & Setup).

Even in the best teams, it may be the case that transports have to be reworked and these transports have to be reimported. So that an existing Return code does not trigger an automatic transition again, the Return code field is emptied before the new import step.

Transition: All → READY FOR PRODUCTION

The Clear Return code post function empties the Return code field in Jira in a Transition to the Status READY FOR PRODUCTION (see app dependencies: Requirements, Installation & Setup).

Content

Step-by-Step Guide

Automatic transition to In production

Add an automatic transition to In production with Jira Automation based on the return code in the Original transport management workflow.

Further information → Jira Cloud Automation

Step	Procedure	Example
1	In a Jira project, navigate to Project settings (cog wheel in the left side menu) → Automation → Create rule Automation is only available for company managed projects.
2	Select the trigger Field value changed and select the Return code in the Fields to monitor for changes field. Then click Next.
3	Add an If: Add a condition and then select JQL condition. Put the following into the input field: CODE `"Return code" = 0 or "Return code" = 4` Optional: Trigger the Automation for specific Status Adjust the JQL condition so that it also contains the relevant status for the automatic transition. This means that no error is triggered for the upcoming transition, if the return code was returned with a different status. However, you have to keep in mind that this JQL should also be changed if the name of a status changes. Alternatively, you can also work with the status IDs. Further information → Atlassian documentation: JQL fields CODE `status in ("Planned for import", "Ready for Production") AND ("Return code" = 0 OR "Return code" = 4)` Then click Next.
4	Now add an THEN: add an action component and search for Transition issue. In the Destination status select IN PRODUCTION. Then click Next.
5	Save and turn on your automation rule via click on Turn on rule . In the Rule name field you can set a descriptive name like "Transition to Production when return code successful".
6	Finally click on Turn on rule to finish the rule.

Empty Return code field

Empty the Return code field in a transition to Ready for production with the Clear return code post function.

Step

Procedure

Example

1

In Jira, navigate to Admin Menu (cog wheel) → Issues → Workflows → SAP Transport Panel: Original transport management workflow → Edit → Diagram View

2

Your are now in the tab Post Functions. Click on Add post function.

Select the function Clear return code post function → click on Add.

3

The final sequence should look like the example on the right.

Don't forget to publish the draft.