Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

Use cases for validators

Owned by Radhika Vijji. (Unlicensed)
Last updated: Dec 24, 2020 by David Fischer
3 min read

This section has use cases that help you in understanding the usage of Validators provided by JMWE.

On this page:

Build-your-own (scripted) Validator

This validator can be used to perform validation with a Jira expression. Based on the result of the expression, the user is either allowed or blocked to transition to the destination status.

Sample use cases:

 Prevent the employee from applying for a leave if the employee is in the 3 month probation period

  • Add the Build-your-own (scripted) validator to the Apply leave transition.

    • Write the following script in Jira expression field

      !! issue.customfield_12116 && new CalendarDate(issue.customfield_12116).plusMonths(3) > new Date().toCalendarDate()

    • Configure the error message: Cannot apply for a leave

Force users to select both the parent and child values for a cascading select field

  • Add the Build-your-own (scripted) validator to the transition.

    • Write the following script in Jira expression field

      !!issue.customfield_10400 && !!issue.customfield_10400.value && !!issue.customfield_10400.child

    • Note customfield_xxxxx is the id of the Cascading select field

    • Configure the error message: Input values for both the child and parent of the cascading field

Field required Validator

This validator can be used to conditionally perform a validation to ensure that the specified field has a value during a transition.

Sample use cases:

Force users to provide Fix Version/s only when the resolution is Fixed

  • Add the Field required validator to the Resolve transition.

  • Input the following script in Validator scope section

    issue.resolution.name != "Fixed"

 Prevent the user from progressing on the Bug it is not assigned

  • Add the Field required validator to the Start Progress transition.

  • Select the Assignee field

  • Select the Conditional validation option

  • Input the following script in Validator scope section

  • Configure the error message: Assign the issue

Linked Issue(s) validator

This validator can be used to ensure that issues linked to the current issue have certain characteristics

Sample use cases:

Prevent creation of more than 5 subtasks for a parent issue of "Story" issue type

  • Add the Linked Issue validator to the Create transition.

  • Select the issue link type is Subtask of from the Issue Link Type field.

  • Select the issue type Story from the Issue Type field.

  • Select the option "Every linked issue must satisfy the condition below"

  • Input the Jira expression:

  • Add the error message, "You cannot create more than 5 subtasks"

Linked Issues Status validator

This validator can be used to ensure that the current issue's linked issues are in one of the selected statuses. 

Sample use cases:

 Block the transition of the Epic to Closed status, if its stories aren't closed.

 Prevent creation of new subtasks to the parent if the parent is in "Resolved" or "Closed" or "Rejected" status