Automating your service project

You’re viewing Legacy automation

We’ve renamed Automation to Legacy automation after introducing new automation engine to Jira Data Center. The page you’re viewing describes original automation rules that have been part of Jira Service Management since the beginning. You can still use them and your existing automation rules will keep working. We recommend, however, that you switch to the more powerful Automation.

To check out the new Automation, see Automate your project.

Create automation rules to perform actions in your service project based on specific triggers and conditions. For example, you can set an automation rule that alerts an agent when a high priority issue is created. Or, service project can reopen an issue if your customer comments on it after its been resolved.

On this page:

Set up a preset automation rule

If your automation rules involve priorities and you're using filters in your service project, make sure these filters include all the priorities defined in the associated priority scheme. See Associating priorities with projects for more details.

To set up an automation rule:

  1. In your service project, select Project settings > Legacy automation.
  2. Select Add rule.
  3. Select a preset rule from the list, then select Next. The rule configuration screen appears.
  4. Edit the rule name and description as needed. The rule name appears on the main automation settings page, so select a name that explains what it does. 
  5. Edit and update any fields that appear in the configuration dialog.
  6. Select Save.

Your service project comes with preset rules that you can use to set up automation. Here are the preset rules that come out-of-the-box: 

Preset rules

Transition on comment

When a comment is added to an issue, this rule automatically transitions the issue so it's clear who it's waiting on.

Reopen on customer comment

When a comment is added to a resolved issue, this rule will reopen the issue.

Be aware of urgent issues

This rule alerts you (via an @mention) to urgent issues when they are raised, so you can address them immediately.

Keep on top of SLAs

This rule alerts you (via an @mention) when a serious issue is about to breach one of your SLAs.

Set customer expectations

This rule lets your customers know when to expect a response based on the priority of their ticket, by adding a prepopulated comment to the issue.

Update when a linked issue changes

This rule will add a comment to related issues, when the status of an issue changes. 

Triage requests sent by email

This rule updates issues received by email with the correct request type, based on keywords present in the request summary or description.


Edit preset automation rules

To edit a preset rule:

  1. In your service project, select Project settings > Legacy automation.
  2. Select Edit next to the rule in your automation list to see how it's configured.
  3. Select the WHEN, IF, or THEN fields to change your rule's trigger, conditions, or resulting actions. Use Tips for customizing this rule for suggestions on what to enter in these fields.
  4. Select Save to publish your changes.



Create a custom automation rule

To create a custom automation rule:

  1. In your service project, select Project settings > Legacy automation.
  2. Select Add rule.
  3. Select Custom rule from the list, then select Next. The rule configuration screen appears.
  4. Give your custom rule a name and a description.
  5. Configure your rule by defining the WHEN, IF, and THEN fields. 
  6. Select Save.

Here are the rule sets that are allowed in the automation engine:

WHENIF (optional)THEN
Comment added

Issue matches a certain filter

Comment visibility is internal or external

User type is a customer or agent

Comment contains a key phrase

Add comment, either internal or external

Alert user to prompt a specific user or users via an @mention

Archive issue to remove it from search results, queues, the customer portal, and all other places it previously appeared. You can access archived issues through direct links, and restore if needed. Learn more

Auto-approve/decline to approve/decline a request based on your IF field

Edit request type to change the request type (Because request types are mapped to specific issue types, automation isn't able to change issue types. Be sure your request types are the same issue type before applying this rule)

Edit issue to select and change a field in your issue, like assignee or priority, as well as Jira supported custom fields (see Jira administration > Issues > Custom fields).

Send email to create an email notification.

Transition issue to change its position in the workflow

Webhook to send a POST request.




Comment edited

Issue matches a certain filter

Comment visibility is internal or external

User type is a customer or agent

Comment contains a key phrase

Issue is created

Issue matches a certain filter

User type is a customer or agent

Issue resolution is changed

Issue matches a certain filter

User type is a customer or agent

Resolution change is either set or cleared

Status changed

Issue matches a certain filter

User type is a customer or agent

Status change visible to customer

A linked issue is transitioned

Link type matches a certain type of link (for example, is related to or blocks)

Issue matches a certain filter

Linked issue matches a certain filter

User type is a customer or agent

Request participant added

Issue matches a certain filter

User type is a customer or agent

Organization added to issue

Issue matches a certain filter

User type is a customer or agent

Approval required

Issue matches a certain filter

User type is a customer or agent

SLA time remaining

Select the SLA and goal status that triggers the event

Issue matches a certain filter


Customize automation webhooks

Jira Service Management webhooks let you send information to third party web services without the need for a third party app. For example, you can post a message in a Slack channel when a major incident occurs.

Read Send alerts with Jira Service Management webhooks to learn more.


Rule run options

Select Options in the rule’s configuration page to change the behavior of how a rule runs, as shown in the image below:

Run rule as: By default, rules run as the person who created the project. Alternatively, you can run rules as the person who triggers the rule. For example, if a rule responds to a customer, then you might want the comment to be from the agent who is working on the request, not from the person who created the project. In this case, you would want to set the Run rule as to User who triggered the rule. Make sure the person you choose has permission to complete all the actions taken by the rule.

Triggered by other rules: By default, rules can trigger other rules. In some cases, you might need to disable this to prevent two rules from triggering each other infinitely.

To change the default Run as user, go to Legacy automation > Change default event user. Make sure the person you choose has permission to perform all the actions that you might try to automate in all your rules.


Disable an automation rule

To disable an automation rule:

  1. Go to Project settings > Legacy automation.
  2. Select Edit next to the rule in your automation list. The rule configuration screen appears.
  3. Unselect the Enable rule checkbox (at the bottom) and select Save.

Disabled rules appear in your automation list with a DISABLED badge.


Last modified on Jun 6, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.