В этом уроке вы добавите новое раскрывающееся меню к своей надстройке JIRA Software Server. Этот раскрывающийся список появится в правом верхнем углу доски Agile рядом с выпадающим списком Board. Это делается через плагин (добавлено в JIRA Agile 6.6.50).
Чтобы добавить это новое раскрывающееся меню, вы создадите новый веб-раздел. Расположение веб-раздела будет jira.agile.board.tools. Затем вы добавите веб-элемент или веб-панель внутри веб-раздела. Это оно! Смотрите скриншот ниже, чтобы посмотреть, как он выглядит.
Снимок экрана: пример веб-раздела с веб-панелью в jira.agile.board.tools.
РИСУНОК
Об этих инструкциях
Вы можете использовать любую поддерживаемую комбинацию ОС и IDE для создания этого плагина. Эти инструкции были написаны с использованием редактора Sublime Text в Mac OS X. Если вы используете другую среду IDE и / или ОС, вы должны использовать эквивалентные операции для своей конкретной среды.
Этот учебник был последний раз проверен с помощью JIRA 6.5-OD-07 и JIRA Agile 6.7.6.
Шаг 1. Создайте веб-раздел в своем plugin.xml
Ваш веб-раздел должен выглядеть примерно так:
<web-section location="jira.agile.board.tools" key="my.custom-board-tool-section" weight="10">
<label key="gh.board.tools.reference.button"/>
<condition class="com.atlassian.greenhopper.client.web.condition.BoardModeCondition">
<param name="mode">work</param>
</condition>
</web-section>
Шаг 2. Добавьте веб-панель, которая будет помещена в ваш новый веб-раздел.
Ваша веб-панель должна выглядеть примерно так:
<web-panel key="board-tools-webpanel" location="my.custom-board-tool-section" weight="100">
<resource name="view" type="velocity" location="templates/board-tools-webpanel.vm" />
<context-provider class="com.atlassian.jira.plugin.webfragment.contextproviders.DefaultVelocityContextProvider" />
</web-panel>
Шаг 3. Создайте шаблон скорости, который будет отображаться внутри веб-панели
В шаблоне доступны три контекстных параметра. Это $ board.id, $ board.type, $ board.screen.
Параметр mode - это перечисление со следующими возможными значениями:
- план, привязанный к странице «Закладка»
- работа, привязанная к странице Active Sprints
- отчет, который привязан к странице «Отчеты»
<div> We are viewing a board with id $board.id in $board.screen mode. </div>
Параметры контекста также могут использоваться в ссылках веб-элементов, как показано ниже:
<web-item section="my.custom-board-tool-section" key="my-custom-web-item" weight="10">
<label key="gh.rapid.operations.configure"/>
<link>/secure/RapidView.jspa?rapidView=${board.id}</link>
</web-item>
(Необязательно) Добавить условия
Вы можете добавить условие, чтобы веб-раздел отображался только в том случае, если доска находится в определенном режиме. Следующий код показывает пример, где веб-раздел отображается только на плате Active Sprints / Kanban. См. Скриншот ниже для примера этого.
Примечание. Возможные значения параметра режима - это план, работа и отчет.
<condition class="com.atlassian.greenhopper.client.web.condition.BoardModeCondition">
<param name="mode">work</param>
</condition>
Скриншот: Обзор активных спринтов с раскрывающимся списком, предоставляемым плагином
РИСУНОК
Поздравляем! Вы только что добавили раскрывающийся список на доске Agile в своем дополнении Connect.
По материалам Atlassian JIRA Server Developer Adding a dropdown to an agile board