JIRA basic usage sharing

jira All scripts in groovy grammar

1. obtain Field Value

1.1 Get... In the current page Field Value

def systemField = getFieldByName("Field Name")
def value = systemField.getValue() 

1.2 Get current issue Of other pages in Field Value

import org.apache.log4j.Level
import org.apache.log4j.Logger
import com.atlassian.jira.issue.MutableIssue
import com.atlassian.jira.component.ComponentAccessor

def log = Logger.getLogger("data-api")
log.setLevel(Level.INFO)

MutableIssue issue = (MutableIssue) getUnderlyingIssue()
def optionName = ComponentAccessor.customFieldManager.customFieldObjects.findByName("Field Name")
def optionValue = issue.getCustomFieldValue(optionName)
log.info("request term name is:" + optionValue)

1.3 Get radio / Multiple choice values

1. stay Behavious Initialize first . Do the following → 2.1 step
2. Yes, multiple choice / Select a single field to operate , Find the field , Click on Add

3. Code in the coding area , Here's the picture

import org.apache.log4j.Level
import org.apache.log4j.Logger
import com.atlassian.jira.issue.MutableIssue
import com.atlassian.jira.component.ComponentAccessor

def isSystemField = getFieldById(getFieldChanged())
def Value = isSystemField.getValue()

2. The radio or multi-select

1.Jira Administrator account login , Click on the pinion , choice Manage apps

2. Enter into Behaviours, Query according to the following syntax

2.1 Document reference

ScriptRunner for jira Server: https://docs.adaptavist.com/sr4js/latest/features/behaviours/behaviours-examples/select-list-conversions.

// The radio 
getFieldByName("TextFieldA").convertToSingleSelect([ // <1>
    ajaxOptions: [
        url : getBaseUrl() + "/rest/scriptrunner-jira/latest/issue/picker",
        query: true, // keep going back to the sever for each keystroke
 
        // this information is passed to the server with each keystroke
        data: [
            currentJql  : "project = SSPA ORDER BY key ASC", // <2>
            label       : "Pick high priority issue in Support project", // <3>
            showSubTasks: false, // <4>
 
            // specify maximum number of issues to display, defaults to 10
            // max : 5,
        ],
        formatResponse: "issue" // <5>
    ],
    css: "max-width: 500px; width: 500px", // <6>
])

//  multi-select 
getFieldByName("TextFieldC").convertToMultiSelect([
    ajaxOptions: [
        url           : getBaseUrl() + "/rest/scriptrunner/latest/custom/eventTypes",
        query         : true,
        formatResponse: "general"
    ]
])

2.2 function script

1. First of all, the script should be Mapping
Let the script know , This function Corresponding Project and issue type

2. combination UI Test the interface

2.3 see log

1. find Built-in script

2. Slide to the bottom

3. choice jira log

3. Call outside Api

Official document link : https://scriptrunner.adaptavist.com/4.3.5/jira/behaviours-conversions.html#_walkthrough_pick_from_jira_issues.

3.1 Package external api, find Rest Endpoints

import com.onresolve.scriptrunner.runner.rest.common.CustomEndpointDelegate
import groovy.json.JsonBuilder
import groovy.transform.BaseScript
import groovyx.net.http.ContentType
import groovyx.net.http.HTTPBuilder
import groovyx.net.http.Method

import javax.ws.rs.core.MultivaluedMap
import javax.ws.rs.core.Response

@BaseScript CustomEndpointDelegate delegate

githubRepoQuery(httpMethod: "GET") {
     MultivaluedMap queryParams -> 

    // Here for Behaviours in api Passed parameters 
    def query = queryParams.getFirst("query") as String

    def rt = [:]
    if (query) {
    
        def httpBuilder = new HTTPBuilder("https://api.github.com")
        def repos = httpBuilder.request(Method.GET, ContentType.JSON) {
    
            uri.path = "/search/repositories"
            // Assign a value 
            uri.query = [q:"$query in:name", sort: "stars", order:"desc"]
            headers."User-Agent" = "My JIRA" 

             response.failure = {
     resp, reader ->
                 log.warn("Failed to query GitHub API: " + reader.text)
             }
        }

        def repoNames = repos["items"]*."full_name"
        rt = [
            items: repoNames.collect {
     String repo ->
                [
                    value: repo,
                    html : repo.replaceAll(/(?i)$query/) {
     "<b>${it}</b>" }, 
                    label: repo,
                ]
            },
            total: repos["total_count"],
            footer: "Choose repo... (${repoNames.size()} of ${repos["total_count"]} shown...)"
        ]
    }

    return Response.ok(new JsonBuilder(rt).toString()).build();
}

=> external api The packaging format of
Be careful ： The three properties are the display of drop-down , Click OK to display and the value of this field

3.2Behaviours call Endpoints, Generally, it is a single choice / multi-select

getFieldByName("TextFieldB").convertToMultiSelect([ 
    ajaxOptions: [
        url : getBaseUrl() + "/rest/scriptrunner/latest/custom/githubRepoQuery", 
        query: true, // keep going back to the sever for each keystroke
        minQueryLength: 4, 
        keyInputPeriod: 500, 
        formatResponse: "general", 
    ]
])

3.3UI Interface tests , The picture is for reference only

3.4 Multi level linkage , Fuzzy query through the contents of the input box

// An highlighted block
var foo = 'bar';

4.jql Inquire about Jira issue

1. Get into issue Query interface

2. Regular query
Select the corresponding issue The state of OK La

3. Execute statement query

link : Official query statement document reference .

Demo：jql language
note： The time is only mm / DD / yyyy , No seconds 
project = aaaa and type = done and epic = ''

5. encapsulation Jira Service

take your time , Don't worry