Мы в Mail.ru Group вкладываем много сил в развитие продуктов компании Atlassian и, в частности, Jira. Благодаря нашим усилиям свет увидели плагины My Groovy, JS Includer, My Calendar, My ToDo и другие. Все эти плагины мы развиваем и активно используем внутри компании.

Мы получаем массу запросов от смежных подразделений по внедрению новых фич. Иногда это выливается в новые плагины, но чаще мы решаем поставленные задачи используя уже существующие плагины, так как большинство повседневных задач ими легко покрываются.

Для проведения экскурсий в офисе нужно было предусмотреть создание запросов с проверкой пересекающихся экскурсий. Для тестировщиков — сделать механизм отслеживания этапов тестирования с ответственным за выполнение. Техподдержка хотела получить автоматический доступ к базе знаний.

Сегодня я расскажу, как путем комбинирования плагинов удалось решить эти задачи.

Запрос от «экскурсоводов»

Инструменты:

• My Calendar
• JS Includer

Проблема

В офисе Mail.ru Group много «экскурсоводов», которые договариваются с гостями и затем ставят задачи на АХО. Иногда случается так, что несколько экскурсий могут образоваться в одно и тоже время — тогда по офису одновременно ходят несколько групп, либо одному экскурсоводу отказывают, и он идет передоговариваться с гостями.

Решение

1. Появление в задаче «слотов» (даты и времени из набора свободных вариантов) для выбора при создании заявки на экскурсию На день — 3 слота. Например:
   • 9:00-10:00
   • 17:30-18:30
   • 20:00-21:00

   Если слот был выбран в другой задаче, нельзя предлагать его для выбора в новой. Также нужна возможность убрать слоты из выбора руками (в случае, например, когда экскурсии в офисе невозможны в принципе).

2. Появление календаря, формируемого из свободных и занятых слотов, который можно расшарить на экскурсоводов.

Реализация

Шаг 1: добавляем необходимые поля на экран создания запроса.

Для этого создадим поле «Дата» типа Date и поле «Время экскурсии» типа Radiobutton для выбора одного значения из 3 вариантов (9:00-10:00; 17:30-18:30; 20:00-21:00).

Шаг 2: создаем календарь.

Делаем новый календарь. Нацеливаем через JQL его на наш проект с экскурсиями,
указываем Event start созданное ранее поле «Дата», а так же добавляем в отображение созданное ранее поле «Время экскурсии».

Сохраняем календарь. Теперь наши экскурсии можно просматривать в календаре.

Шаг 3: ограничиваем создание экскурсий и добавляем баннер с ссылкой на календарь.

Чтобы этого добиться, потребуется JS, который будет отслеживать изменение в поле «Дата». Когда выбрана дата, мы должны подставить ее в jql-функцию и получить все запросы на эту дату, затем узнаем какое время занято и прячем эти варианты на экране, чтобы лишить возможности выбрать занятое время.

Когда нет запросов

Когда есть 2 запроса на 9 утра и на 20 вечера

(function($){ /*    Пояснение:     Дата — customfield_19620    Время экскурсии — customfield_52500    Опции поля «Время экскурсии»:    9:00-10:00 — 47611    17:30-18:30 — 47612    20:00-21:00 — 47613 */  /*    Сначала добавляем проверку значения в поле дата.    Весь дальнейший код будет внутри этого блока. */    $("input[name=customfield_19620]").on("click change", function(e) {        var idOptions = [];        var url = "/rest/api/latest/search";  /*    Если «Дата» не выбрана, то скрываем выбор времени. */        if (!$("#customfield_19620").val()) {            $('input:radio[name=customfield_52500]').closest('.group').hide();        } /*    Иначе берем значение из поля даты и переводим в удобный для подстановки в jql вид, так же выводим на экран все значения времени. */        else {            var temp = $("#customfield_19620").val();            var arrDate = temp.split('.');            var result = "" + arrDate[2].trim() + "-" + arrDate[1].trim() + "-" + arrDate[0].trim();            $('input:radio[name=customfield_52500][value="-1"]').parent().remove();            $('input:radio[name=customfield_52500]').closest('.group').show();            $('input:radio[name=customfield_52500][value="47611"]').parent().show();            $('input:radio[name=customfield_52500][value="47612"]').parent().show();            $('input:radio[name=customfield_52500][value="47613"]').parent().show(); /*    Затем подставляем в jql. */            var params = {                jql: "issuetype = Events and cf[52500] is not EMPTY and cf[19620] = 20" + result,                fields: "customfield_52500"            }; /*    Далее в полученном JSON находим все запросы и скрываем использованное в них время с экрана. */            $.getJSON(url, params, function (data) {                var issues = data.issues                for (var i = 0; i < issues.length; i++) {                    idOptions.push(issues[i].fields.customfield_52500.id)                }                for (var k = 0; k < idOptions.length; k++) {                    $('input:radio[name=customfield_52500][value=' + idOptions[k] + ']').parent().hide();                }            });        }    }); /*    Добавляем баннер с ссылкой на календарь. */    $('div.field-group:has(#customfield_19620)').last().before(`        <div id="bannerWithInfo" class="aui-message info">            <p class="title">            Как работать с календарем            </p>            <p>Выберите дату планируемой экскурсии</p>            <p>Затем выберите время экскурсии из доступных вариантов</p>            <p>По ссылке ниже вы можете посмотреть запланированные экскурсии в календаре</p>        <p><a href='https://jira.ru/secure/MailRuCalendar.jspa#calendars=492' target="_blank">Календарь экскурсий</a></p>        </div>            `); })(AJS.$); 

Запрос от тестировщиков

Инструмент:

• My Groovy

Проблема

В запросе нужно настроить отображение этапов тестирования с указанием ответственного за задачу сотрудника. Должно быть видно, что этап еще не завершен, либо этап завершен (и кто его проводил).

Решение

Настроить поле типа scripted field на отображение этапов тестирования и связать с workflow, записывать в ответственных за этап автора перехода.

Реализация

1. Создаем поле «Ход выполнения» типа scripted field.
2. Создаем поля типа UserPicker, соответствующие этапам тестирования.

   Для примера определим следующие этапы и создадим поля UserPicker с теми же названиями:

   • Базовая информация собрана
   • Локализовано
   • Логи собраны
   • Воспроизведено
   • Ответственный найден

3. Настраиваем workflow так, чтобы на переходах заполнялись ответственные.

   Например переход «Локализовано» записывает currentUser в поле UserPicker «Локализовано».

4. Настраиваем отображение при помощи scripted field.

Заполняем блок groovy:

import com.atlassian.jira.component.ComponentAccessor import com.atlassian.jira.config.properties.APKeys  baseUrl = ComponentAccessor.getApplicationProperties().getString(APKeys.JIRA_BASEURL) colorApprove = "#D2F0C2" colorNotApprove = "#FDACAC" return getHTMLApproval()  def getHTMLApproval(){    def approval = getApproval()    def html = "<table class='aui'>"    approval.each{k,v->        html += """<tr>            <td ${v?"bgcolor='${colorApprove}'":"bgcolor='${colorNotApprove}'"}>${k}</td>                        <td ${v?"bgcolor='${colorApprove}'":"bgcolor='${colorNotApprove}'"}>${v?displayUser(v):""}</td>                        </tr>"""    }    html += "</table>"    return html }  def displayUser(user){    "<a href=${baseUrl}/secure/ViewProfile.jspa?name=${user.name}>${user.displayName}</a>" }  def getApproval(){    def approval = [:] as LinkedHashMap    if (issue.getIssueTypeId() == '10001'){ //Тип запроса - Тестирование        approval.put("Базовая информация собрана", getCfValue(54407))        approval.put("Логи собраны", getCfValue(54409))        approval.put("Воспроизведено", getCfValue(54410))        approval.put("Ответственный найден", getCfValue(54411))        approval.put("Локализовано", getCfValue(54408))    }    return approval }  def getCfValue(id){    ComponentAccessor.customFieldManager.getCustomFieldObject(id).getValue(issue) }

В блоке velocity выводим $value. Получаем такой результат:

Запрос от техподдержки

Инструменты:

• JS Includer
• My Groovy

Проблема

У техподдержки есть своя база знаний на Confluence. Нужна возможность отображать связанные с проблемой статьи из базы знаний в запросе Jira. Так же нужен механизм поддержки базы в актуальном состоянии — если статья не была полезной, нужно поставить запрос техническому писателю в Jira на написание актуальной статьи. При закрытии запроса должны остаться только статьи относящиеся к запросу. Ссылки могут быть видны только техподдержке.

Решение

При выборе определенного типа обращения в Jira (поле каскадного типа) в запросе должны отображаться статьи с Confluence, которые ему соответствуют в отдельном поле с wiki разметкой.

Статья при успешном использовании выбирается как актуальная с помощью отметки чекбокса.

При решении задачи, если оно не описано в прикрепленной статье, должна создаваться задача в Jira с типом «Документация», связанная с текущим запросом.

Реализация

Шаг 1: подготовка

1. Создаем поле Text Field (multi-line) с wiki разметкой — Links.
2. Создаем поле типа Select List (cascading) — «Тип обращения».

   Для примера используем следующие значения:

   • ACCOUNT
   • HARDWARE
3. Заготовим лейблы для статей, которыми будем связывать статьи на Confluence с запросами в Jira:
   • Изменение членства в группах AD — officeit_jira_изменение_членства_в_группах_ad
   • Подписка/отписка от рассылки — officeit_jira_подписка_отписка_от_рассылки
   • Предоставление доступа к папке — officeit_jira_предоставление_доступа_к_папке
   • Сброс пароля от доменной УЗ — officeit_jira_сброс_пароля_от_доменной_уз
   • Сброс пароля от почты — officeit_jira_сброс_пароля_от_почты
   • Выдача временного оборудования — officeit_jira_выдача_временного_оборудования
   • Выдача новой техники — officeit_jira_выдача_новой_техники
   • Замена жесткого диска и установка системы с нуля — officeit_jira_замена_жесткого_диска_и_установка_системы_с_нуля
   • Замена жесткого диска с переносом информации — officeit_jira_замена_жесткого_диска_с_переносом_информации
   • Замена неисправного/устаревшего оборудования — officeit_jira_замена_неисправного_устаревшего_оборудования

   Далее необходимо создать статьи на Confluence, проставить им лейблы.

4. Подготавливаем workflow.

   Тип обращения будем заполнять при создании.

   Links добавляем на отдельный экран и помещаем на переход в закрыть (в примере переход называется «Check actual Links»), запоминаем id перехода (необходимо в дальнейшем для настройки js).

Шаг 2: MyGroovy post-function (добавляем статьи в запрос)

/* Пояснение:  Тип обращения — customfield_40001 Links — customfield_50001 */  /* Указываем куда, под кем и как будем подключаться. */  def usr = "bot" def pas = "qwerty" def url = "https://confluence.ru" def browse = "/pages/viewpage.action?pageId="  /* Добавляем методы */  def updateCustomFieldValue(issue, Long customFieldId, newValue) {    def customField = ComponentAccessor.customFieldManager.getCustomFieldObject(customFieldId)    customField.updateValue(null, issue, new ModifiedValue(customField.getValue(issue), newValue), new DefaultIssueChangeHolder())    return issue } def getCustomFieldObject(Long fieldId) {    ComponentAccessor.customFieldManager.getCustomFieldObject(fieldId) } def parseText(text) {    def jsonSlurper = new JsonSlurper()    return jsonSlurper.parseText(text) } def getCustomFieldValue(issue, Long fieldId) {    issue.getCustomFieldValue(ComponentAccessor.customFieldManager.getCustomFieldObject(fieldId)) }  /* Указываем скрипту, как соотносить типы обращения с лейблами. */  def getLabelFromMap(String main, String sub){    def mapLabels = [            "ACCOUNT": [                    "Изменение членства в группах AD"        :["officeit_jira_изменение_членства_в_группах_ad"],                    "Подписка/отписка от рассылки"        :["officeit_jira_подписка_отписка_от_рассылки"],                    "Предоставление доступа к папке"        :["officeit_jira_предоставление_доступа_к_папке"],                    "Сброс пароля от доменной УЗ"            :["officeit_jira_сброс_пароля_от_доменной_уз"],                    "Сброс пароля от почты"                :["officeit_jira_сброс_пароля_от_почты"]            ],            "HARDWARE": [                    "Выдача временного оборудования"        :["officeit_jira_выдача_временного_оборудования"],                    "Выдача новой техники"                :["officeit_jira_выдача_новой_техники"],                    "Замена жесткого диска и установка системы с нуля":["officeit_jira_замена_жесткого_диска_и_установка_системы_с_нуля"],                    "Замена жесткого диска с переносом информации":["officeit_jira_замена_жесткого_диска_с_переносом_информации"],                    "Замена неисправного/устаревшего оборудования":["officeit_jira_замена_неисправного_устаревшего_оборудования"]            ]    ]    def labels = mapLabels[main][sub]    def result = ""     if(!labels){        return ""    }     for (def i=0;i<labels.size;i++){        if(i<labels.size-1){            result += "\"" +labels[i]+ "\","        }else{            result += "\"" +labels[i]+ "\""        }    }    result = URLEncoder.encode(result, "utf-8")    return result }  /* Берем значение поля — тип обращения. */  def wikiLinkFieldId = 50001L def requestTypeFieldValue = getCustomFieldValue(issue, 40001)  if(!requestTypeFieldValue){    return "required field is empty" }  def mainType = requestTypeFieldValue.getAt(null).toString() def subType = requestTypeFieldValue.getAt('1').toString()  /* Получаем необходимые для запроса лейблы, формируем ссылку для итоговой записи в виде: [TEST изменение сетевых доступов 1 (Изменение членства в группах AD)|https://confluence.ru/pages/viewpage.action?pageId=500001]. */  String labels = getLabelFromMap(mainType,subType)  if(labels==""){    return "no avalible position on LabelMap" }  def api = "/rest/api/content/search?cql=label%20in(${labels})" def URL = (url+api)  def wikiString = ""  def resp = "curl -u ${usr}:${pas} -X GET ${URL}".execute().text def result = parseText(resp) def ids = result.results.id def title = result.results.title  for (def i=0;i<ids.size;i++){    wikiString += "[${title[i]}|${url+browse+ids[i]}]\n" }  updateCustomFieldValue(issue,wikiLinkFieldId,wikiString) return "Done" 

Шаг 3: JS-скрипт

/* Пояснение:  Переход — Check actual Links id перехода — 10 Links — customfield_50001 */  (function($){       /*    Вначале объявляем переменные, с которыми будем работать, прячем ненужное от посторонних глаз и делаем проверку что код будет выполняться для нужного нам перехода.    */       var buttonNewArticle = 'Необходима новая статья';    var buttonDeleteUnchecked = 'Сохранить отмеченные';    var buttonNewArticleTitle = 'Автоматически будет создан таск на новую статью';    var buttonDeleteUncheckedTitle = 'Все неотмеченные статьи будут удалены.';    var avalibleTransitions = [10];    var currentTransition = parseInt(AJS.$('.hidden input[name^="action"]').val());       if(avalibleTransitions.indexOf(currentTransition)==-1){        console.log('Error: transition ' + currentTransition + ' is not avalible');        return;    }       var customFieldId = 50001;    var labelTxt = 'Выберите актуальные статьи';    var idname = 'cblist';    var checkboxCounter = 'cbsq';    var text = '<div class="field-group"><label for="'+idname+'">' + labelTxt +'</label><div id="'+idname+'"></div></div>'    AJS.$('.field-group label[for^="customfield_'+customFieldId+'"]').parent().hide();    AJS.$('.field-group label[for^="comment"]').parent().hide();    $('.jira-dialog-content div.form-body').prepend(text);       /*    Далее пишем следующие функции:    */       /*    renameButtonNeedNewArticle и renameButtonDeleteUnchecked — меняем кнопку « Закрыть» в зависимости от того выбраны ли статьи или нужно создать новую    addCheckbox — рисуем чекбокс напротив каждой статьи.    */       function arrayToString(arrays) {        return arrays.join('\n');    }       function renameButtonNeedNewArticle() {        $('#issue-workflow-transition-submit').val(buttonNewArticle);        $('#issue-workflow-transition-submit').attr("title",buttonNewArticleTitle);    }       function renameButtonDeleteUnchecked() {        $('#issue-workflow-transition-submit').val(buttonDeleteUnchecked);        $('#issue-workflow-transition-submit').attr("title",buttonDeleteUncheckedTitle);    }       function addCheckbox(array) {        var value = array.join('|');        var name = array[0].replace('[','');        var link = array[1].replace(']','');        var container = $('#'+idname);        var inputs = container.find('input');        var id = inputs.length+1;        $('<input />', { type: 'checkbox', id: checkboxCounter+id, value: value }).appendTo(container);        $('<label />', { for: checkboxCounter+id, text: ' '  }).appendTo(container);        $('<a />', { href: link, text: name,target: "_blank" }).appendTo(container);        $('<br>').appendTo(container);    }       /*    Меняем отображение при загрузке экрана на то, что нам нужно:    */       renameButtonNeedNewArticle();       $(document).ready(function() {        var val = AJS.$('#customfield_'+customFieldId+'').val();        AJS.$('#customfield_'+customFieldId+'').val('');        if(val==""){return;}        var i = val.split('\n');        i.forEach(function( index ) {            if(index == ""){return;}            var link = index.split('|');            addCheckbox(link);        });    });       /*    Отслеживаем выбранные чекбоксы и формируем итоговое значение для поля Links.    */       $('#'+idname+' input[type="checkbox"]').change(function() {        var prevalue = [];        AJS.$('#'+idname+' input:checkbox:checked').each(function(){            prevalue.push(this.value);        });        AJS.$('#customfield_'+customFieldId+'').val(arrayToString(prevalue));        if(prevalue.length<1){            renameButtonNeedNewArticle();        }else{            renameButtonDeleteUnchecked();        }    }); })(AJS.$);

Так выглядит наш переход до обработки JS.

Так выглядит переход после обработки.

И так, если выбрана одна или несколько статей.

После выполнения перехода поле Links будет перезаписано новым значением.

Шаг 4: MyGroovy post-function (создаем запрос на новую статью)

На переходе Check actual Links пишем скрипт, который создает запрос с типом «Документация», если в поле Links нет значений.

В заключение

Эти решения не появились бы без активного участия коллег — в первую очередь тех, кто активно пользуется готовыми инструментами или сталкивается в своей работе с задачами, которые нужно автоматизировать. Часто оказывается, что интересная задача — это уже половина решения: далее нужно лишь подобрать инструмент, который наиболее эффективно, просто и легко (для конечного пользователя) удовлетворяет поставленным запросам. Теперь, возможно, у вас появились вопросы и предложения, которые могли бы сделать представленные плагины ещё лучше — пишите в комментариях.