Change status and assignee of Jira ticket
Overview
This self-service guide facilitates transitioning the status and assignee of a Jira ticket from Port using Port's self service actions. With this, you can manage ticket (issue) status without leaving Port.
Prerequisites
-
Port's GitHub app needs to be installed.
-
In your GitHub repository, go to Settings > Secrets and add the following secrets:
JIRA_API_TOKEN
- Jira API token generated by the user.JIRA_BASE_URL
- The URL of your Jira organization. For example, https://your-organization.atlassian.net.JIRA_USER_EMAIL
- The email of the Jira user that owns the Jira API token.PORT_AUTH_CLIENT_ID
- Your portclient id
How to get the credentials.PORT_AUTH_CLIENT_SECRET
- Your portclient secret
How to get the credentials.
-
Optional - Install Port's Jira integration learn more
Jira IntegrationThis step is not required for this example, but it will create all the blueprint boilerplate for you, and also ingest and update the catalog in real time with your Jira Issues.
-
In Case you decided not to install the Jira integration, you will need to create a blueprint for the Jira issue in Port.
Jira Issue Blueprint
GitHub Workflow
Create the file .github/workflows/change-jira-ticket-status-and-assignee.yml
in the .github/workflows
folder of your repository.
We recommend creating a dedicated repository for the workflows that are used by Port actions.
GitHub Workflow
Port Configuration
- Head to the self-service page.
- Click on the
+ New Action
button. - Choose the
Jira Issue
blueprint and clickNext
. - Click on the
{...} Edit JSON
button. - Copy and paste the following JSON configuration into the editor.
Change status of a Jira ticket (Click to expand)
- Click
Save
.
Now you should see the Change Jira ticket status and assignee
action in the self-service page. 🎉
Let's test it!
- Head to the Self Service hub
- Click on the
Change Jira ticket status and assignee
action - Choose the jira ticket you want to change the status and assignee for (In case you didn't install the Jira integration, it means you don't have any Jira tickets in Port yet, so you will need to create one manually in Port to test this action)
- Select the new status
- Enter the name of the assignee or their email address
- Click on
Execute
- Done! wait for the ticket's status and assignee to be changed in Jira
Congrats 🎉 You've changed a ticket status and its assignee in Port 🔥
More Self Service Jira Actions Examples
- Report a bug in Jira using Port's self-service actions
- Open Jira issues with automatic labels
- Open/close JIRA issues for entities with violated scorecard rules
- Add a comment to a Jira ticket using Port's self-service actions