Тэги Jelly

Jelly - это скриптовый и шаблонный язык из проекта Apache Джакарты. Он похож на Ant, в том, что скрипты являются XML, и каждый тег сопоставляется с классом Java, но имеет более сложную внутреннюю модель конвейера для взаимодействия тегов, подобно JSP taglib. Более подробную информацию см. на сайте Jelly.

 

JIRA поставляется с несколькими тегами Jelly, реализующими основные операции в JIRA. Это обеспечивает скриптовый интерфейс для JIRA. Существует много возможных применений для тегов JIRA Jelly, наиболее распространенным из которых является импорт данных в JIRA из других систем и автоматизация общих административных задач (см. примеры ниже).

Включение Jelly

Поддержка Jelly JIRA по умолчанию отключена, поскольку Jelly, в принципе, позволяет запускать произвольный код Java на сервере под учетной записью Tomcat. В некоторых средах это может считаться угрозой безопасности, в зависимости от того, кому разрешено настраивать и запускать сценарии Jelly (требуется разрешение «Системные администраторы JIRA»). Мы рекомендуем использовать Jelly только тогда, когда вы абсолютно не можете обойтись без него и отключите поддержку Jelly, когда вам это больше не нужно.

Чтобы включить Jelly, установите системное свойство jira.jelly.on при запуске сервера приложений. Свойства системы устанавливаются с параметрами в java-команду, например. java -Djira.jelly.on = true ... (Этот параметр можно установить в файле setenv.sh (Linux) или setenv.bat (Windows) в папке / bin)

 

Как установить это свойство зависит от вашего сервера приложений. Например, установите переменную среды JAVA_OPTS = -Djira.jelly.on = true или при запуске JIRA в качестве службы задайте параметр JVM службы.

Запуск скрипта Jelly

Чтобы запустить скрипт для Jelly один раз:

1. Войдите в систему как пользователь с глобальным разрешением «Системные администраторы JIRA».
2. Выберите шестеренка> Система. Выберите Расширенно> Jelly Runner, чтобы открыть страницу Jelly Runner.

Комбинация клавиш: 'g' + 'g' + наберите 'jel'

3. Вставьте скрипт Jelly в текстовую область.

Периодически запускайте скрипт Jelly:

• Настройте службу следующим классом:

com.atlassian.jira.jelly.service.JellyService

Ограничение  Jelly

Чтобы удалить интерфейс для вставки скриптов в:

1. Отредактируйте atlassian-jira / secure / admin / views / jelly_runner.jsp
2. Добавьте отключенный атрибут в текстовое поле, например.<ui: textarea label = "text ('admin.jellyrunner.jelly.script.xml')" name = "'script'" rows = "'40'" cols = "'80'" disabled = "true" />

Это предотвращает вставку текста в страницу Jelly Runner. Обратите внимание, что это только изменение интерфейса, и все же возможно запустить скрипты Jelly, отправив HTTP-запрос с нужным контентом.

Написание сценария Jelly

JIRA: AddActorsToDefaultProjectRole

JIRA: AddActorsToProjectRole

JIRA: AddComment

JIRA: AddComponent

JIRA: AddFieldToScreen

JIRA: AddPermission

JIRA: AddUserToGroup

JIRA: AddVersion

JIRA: AssignIssue

JIRA: AttachFile

JIRA: CreateCustomField

JIRA: CreateGroup

JIRA: CreateIssue

JIRA: CreatePermissionScheme

JIRA: CreateProject

JIRA: CreateProjectRole

JIRA: CreateUser

JIRA: DeleteProjectRole

JIRA: GetDefaultRoleActors

JIRA: GetProjectRole

JIRA: GetProjectRoleActors

JIRA: IsProjectRoleNameUnique

JIRA: LinkIssue

JIRA: Login

JIRA: RemoveActorsFromDefaultProjectRole

JIRA: RemoveActorsFromProjectRole

JIRA: RemoveUser

JIRA: RunSearchRequest

JIRA: SelectComponentAssignees

JIRA: TransitionWorkflow

JIRA: UpdateProjectRole

Скрипты обычно имеют форму:

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<!--
Добавьте свой собственный Jelly XML здесь
-->
</JiraJelly>

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

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib">
<!--
    Добавьте свой собственный Jelly XML здесь
-->
</JiraJelly>

В дополнение к тегам JIRA вы можете использовать теги из электронной почты, http, soap, sql и core Jelly taglib. В случае необходимости пользователь может добавить больше.

 

Многие Jelly-теги JIRA устанавливают контекстные переменные, поэтому последующие теги могут ссылаться на их вывод путем разыменования контекстной переменной (например, $ {jira.new.username}). Другие теги позволяют явно указывать имя переменной для хранения некоторого вывода, например, <jira: CreateUser> имеет параметры issueKeyVar и issueIdVar:

<jira:CreateIssue project-key="TP" summary="Issue One" issueKeyVar="issuekey" issueIdVar="issueid"/>
Raised issue ${issuekey} with id ${issueid}

Обратите внимание, что переменная устанавливается только после закрытия тега, а не внутри тега.

Обратите внимание: из-за этой интерполяции переменной, если ваш текст содержит что-либо вида $ {something}, вам нужно избежать этого как $$ {something}, чтобы предотвратить «переменную», которая была расширена до пустой строки.

При указании значения атрибута обратите внимание, что следующие специальные символы должны быть избегаемы.

 

Список доступных в настоящее время тегов:

JIRA: AddActorsToDefaultProjectRole

Этот тег добавит «участников» к членству по умолчанию для данной роли проекта. Актеры могут быть определены как группы или пользователи, т. е. вы можете добавить как пользователей, так и группы в роль проекта.

Атрибуты

Примеры

Добавление списка пользователей или групп по умолчанию в роль проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddActorsToDefaultProjectRole projectroleid="1" actors="fred,admin,tom"
 actortype="atlassian-user-role-actor" />
</JiraJelly>

JIRA: AddActorsToProjectRole

Этот тег добавит «участников» к заданной роли проекта для конкретного проекта. Актеры могут быть определены как группы или пользователи, т. е. Вы можете добавить как пользователей, так и группы в роль проекта.

Атрибуты

 

Примеры

Добавление списка пользователей или групп в роль проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddActorsToProjectRole projectroleid="1" actors="jira-administrators,jira-users"
projectkey="MKY" actortype="atlassian-group-role-actor" />
</JiraJelly>

jira:AddComment

This function adds a comment to an Issue.

Атрибуты

Примеры

Создать комментарий

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddComment comment="Issue comment" issue-key="ABC-1"
groupLevel="admin-group"/>
</JiraJelly>

Создать задачу и комментарий

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
  <jira:CreateIssue project-key="TP" issueType="Bug" summary="Issue summary" issueKeyVar="key"/>
  <jira:AddComment issue-key="${key}" comment="A comment on ${key}"/>
</JiraJelly>

JIRA: AddComponent

Добавляет компонент в проект.

 

Атрибуты

 

Примеры

Создать компонент

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddComponent project-key="ABC" name="Comp 1" description="Comp 1 description"/>
</JiraJelly>

Создание компонента в проекте

<JiraJelly xmlns: jira = "желе: com.atlassian.jira.jelly.JiraTagLib">
<jira: CreateProject key = "ABC" name = "A Project" lead = "logged-in-user">
<jira: AddComponent name = "Comp 1" />
</ JIRA: CreateProject>
</ JiraJelly>

Создание компонента с помощью  ведущего компоненты

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddComponent project-key="ABC" name="Comp 1" description="Comp 1 with lead" componentLead="user-name"/>
</JiraJelly>

JIRA: AddFieldToScreen

Добавляет поле к определенной вкладке на экране. Можно также указать, в какую позицию вставить поле.

Атрибуты

 

Примеры

Добавление полей на экран

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<!-- Adds 'description' field to the 'Field Tab' on 'Default Screen' -->
<jira:AddFieldToScreen fieldId="description" screen="Default Screen" tab="Field Tab"/>

<!-- Adds 'duedate' field to same screen as above. duedate is inserted in position 1 -->
<jira:AddFieldToScreen fieldId="duedate" screen="1" tab="0" fieldPosition="1"/>
</JiraJelly>

Создание нового пользовательского поля и добавление  его на экран

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateCustomField fieldType="cascadingselect"
fieldScope="issuetype"
fieldName="Issue cascadingselect Bug"
issueType="Bug"
description="Bank have requested Y2K fixes to be sent as an EBF."
searcher="cascadingselectsearcher"
customFieldIdVar="customField"
>
<jira:AddCustomFieldSelectValue value="Parent 1" />
<jira:AddCustomFieldSelectValue value="Parent 2">
<jira:AddCustomFieldSelectValue value="Child 1" />
<jira:AddCustomFieldSelectValue value="Child 2" />
</jira:AddCustomFieldSelectValue>
<jira:AddCustomFieldSelectValue value="Parent 3" />
</jira:CreateCustomField>

<jira:AddFieldToScreen screen="Default Screen" fieldId="${customField.getId()}"/>
</JiraJelly>

JIRA: AddPermission

Предоставляет разрешения в пределах схемы разрешений. Часто вложен в тег JIRADOC: CreatePermissionScheme.

Атрибуты

 

Примеры

Предоставить разрешения для пользователей jira и jira-разработчиков в новой схеме разрешения

(См. Также сценарии JIRADOC: пример)

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
  <jira:CreatePermissionScheme name="New Permission Scheme">
    <jira:AddPermission group="jira-users" permissions="Browse,Create,Comment,Attach" type="group"/>
    <jira:AddPermission group="jira-developers" permissions="Move,Assignable,Link,ViewVersionControl" type="group"/>
  </jira:CreatePermissionScheme>
</JiraJelly>

Репортерам задач предоставить возможность редактировать / удалять свои собственные задачи, в новой схеме разрешения

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib">
  <jira:CreatePermissionScheme name="New Permission Scheme">
    <jira:AddPermission type="reporter" permissions="Delete, Edit"/>
  </jira:CreatePermissionScheme>
</JiraJelly>

Сделать проекты с использованием схемы разрешений по умолчанию видимыми для определенных пользователей

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib">
  <jira:AddPermission schemeId="0" permissions="Browse" type="user" user="johnc"/>
  <jira:AddPermission schemeId="0" permissions="Browse" type="user" user="ebf"/>
</JiraJelly>

Предоставление групповому селектору членов пользовательских полей  способность назначать / быть назначенной задачу(ей).

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
  <jira:AddPermission schemeId="10164" type="groupCF" groupCF="customfield_10000"
                      permissions="Assign,Assignable" />
</JiraJelly>

JIRA: AddUserToGroup

Делает пользователя членом группы. Добавляет имя пользователя и / или имя группы в контекст, если это указано.

 

Атрибуты

 

Имя пользователя задается в контексте, если указано в теге. Имя группы устанавливается в контексте, если указано в tag.h4. Примеры

 

Добавить пользователя в группу

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddUserToGroup username="new-user" group-name="new-group"/>
</JiraJelly>

Добавить нового  пользователя в группу

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateUser username="new-user" password="password" confirm="password"
fullname="Full name" email="test@test.com">
<jira:AddUserToGroup group-name="new-group"/>
</jira:CreateUser>
</JiraJelly>

Добавить пользователя в новую группу

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateGroup group-name="new-group">
<jira:AddUserToGroup username="new-user"/>
</jira:CreateGroup>
</JiraJelly>

Добавить нового пользователя в новую группу

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateUser username="new-user" password="password" confirm="password"
fullname="Full name" email="test@test.com"/>
<jira:CreateGroup group-name="new-group">
<jira:AddUserToGroup/>
</jira:CreateGroup>
</jira:CreateUser>
</JiraJelly>

JIRA: AddVersion

Добавляет версию в проект.

Атрибуты

 

Примеры

Создать версию

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:AddVersion project-key="ABC" name="Ver 1"/>
</JiraJelly>

Создание версии в проекте

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateProject key="ABC" name="A Project" lead="logged-in-user">
<jira:AddVersion name="Ver 1"/>
</jira:CreateProject>
</JiraJelly>

JIRA: AssignIssue

Назначает задачу пользователю.

Атрибуты

Примеры

Создание и назначение задачи

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
  <jira:CreateIssue project-key="TST" summary="My Issue summary" issueKeyVar="keyvar"/>
  <jira:AssignIssue key="${keyvar}" assignee="testuser"/>
</JiraJelly>

JIRA: AttachFile

Прикрепляет файл к проблеме.

 

Атрибуты

 

Примеры

Добавление вложения

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
  <jira:AttachFile key="TST-1" filepath="/tmp/somefile" option="override"/>
</JiraJelly>

JIRA: CreateCustomField

Тег создает новое пользовательское поле. Только специальные пользовательские поля могут быть добавлены с помощью тегов Jelly.

Атрибуты

 

Примеры

Создание каскадного пользовательского поля

jira: subtag AddCustomFieldSelectValue может использоваться для добавления значений для избранных списков. Они также могут быть вложены для каскадных списков выбора.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateCustomField fieldType="cascadingselect"
fieldScope="issuetype"
fieldName="Issue cascadingselect Bug"
issueType="Bug"
description=" Банк запросил исправления Y2K для отправки в виде EBF "
searcher="cascadingselectsearcher"
> 
<jira:AddCustomFieldSelectValue value="Parent 1" />
<jira:AddCustomFieldSelectValue value="Parent 2">
<jira:AddCustomFieldSelectValue value="Child 1" />
<jira:AddCustomFieldSelectValue value="Child 2" />
</jira:AddCustomFieldSelectValue>
<jira:AddCustomFieldSelectValue value="Parent 3" />
</jira:CreateCustomField>
</JiraJelly>

jira: CreateGroup

Создает группу в JIRA.

Атрибуты

 

Примеры

Создать группу

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateGroup group-name="new-group"/>
</JiraJelly>

jira: CreateIssue

Этот тег создает новую задачу в JIRA и помещает идентификатор задачи в контекст.

Атрибуты

 

Примеры

Создать проблему

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateIssue project-key="ABC" assignee="-1" summary="Issue summary">
<!-- other jelly tags -->
</jira:CreateIssue>
</JiraJelly>

Создать задачу из проекта

Этот пример более сложный, поскольку для проекта требуется создать схему разрешения до того, как задача может быть создана.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateProject key="ABC" name="A Project" lead="logged-in-user">
<jira:CreatePermissionScheme name="admin-scheme">
<jira:AddPermission permissions="Assignable,Browse,Create,Assign"
<type="group"/>
<jira:SelectProjectScheme/>
</jira:CreatePermissionScheme>
<jira:CreateIssue summary="Issue summary">
<!-- other jelly tags -->
</jira:CreateIssue>
</jira:CreateProject>
</JiraJelly>

Создать задачу с  значениями пользовательских полей

Используйте subtag jira: AddCustomFieldValue

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateIssue project-key="ABC" summary="Issue summary">
<jira:AddCustomFieldValue id="customfield_10000" value="field value"/>
<jira:AddCustomFieldValue name="Environment Select list" value="Windows XP"/>

<!-- For Cascading Selects : Note also that the value for cascading selects is the optionId-->
<jira:AddCustomFieldValue id="customfield_10001" value="Parent Option Id" />
<jira:AddCustomFieldValue id="customfield_10001" value="Child Option Id" key="1" />

<!-- For Version Pickers and Single Version Pickers : Note also that the value for version pickers is the versionId-->
<jira:AddCustomFieldValue id="customfield_10002" value="Version Id"/>

<!-- For Multi Selects -->
<jira:AddCustomFieldValue id="customfield_10003" value="Value 1" />
<jira:AddCustomFieldValue id="customfield_10003" value="Value 2" />

<!-- For Multi User Pickers : Note also that the value for multi user pickers is a comma separated list of users-->
<jira:AddCustomFieldValue id="customfield_10004" value="User 1,User 2" />

</jira:CreateIssue>
</JiraJelly>

Использование атрибута name устарело. Хотя он будет работать в версии 3.0, его использование не рекомендуется.

Заметка:

• Чтобы просмотреть <customFieldId>,

1. Перейдите в раздел Администрирование -> Поля задач -> Пользовательские поля
2. Наведите курсор на ссылку «Настроить» пользовательского поля
3. Вы можете просмотреть <customFieldId> в строке состояния вашего браузера

• Чтобы просмотреть «Идентификатор родительской опции» и «Идентификатор дочерней опции» для «Каскадный выбор полей»,

1. Перейдите в раздел Администрирование -> Поля задач -> Пользовательские поля -> Настроить -> Изменить опции -> Изменить
2. Вы можете просмотреть <selectedParentOptionId> («Идентификатор родительской опции») и <selectedValue> («Идентификатор дочерней опции») в строке состояния вашего браузера

jira: CreatePermissionScheme

Создает схему разрешений

Атрибуты

 

Контекстные переменные

 

jira: CreateProject

Этот тег создает новый проект в JIRA и помещает id проекта в контекст.

Атрибуты

 

Контекстные переменные

 

Примеры

Создать проект

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateProject key="ABC" name="A Project" lead="a-user">
<!-- other jelly tags -->
</jira:CreateProject>
</JiraJelly>

jira: CreateProjectRole

Этот тег создаст роль проекта с заданным именем и описанием.

Атрибуты

Контекстные переменные

 

Примеры

Создание новой роли проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
     <jira:CreateProjectRole name="lion-tamer" description="tames the lions">
     ${jelly.role.id} ${jelly.role.name} ${jelly.role.description}
</jira:CreateProjectRole>
</JiraJelly>

jira: CreateUser

Создает пользователя в JIRA и помещает свое имя пользователя в контекст.

Атрибуты

 

 

 

Контекстные переменные

 

Примеры

Создать пользователя

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateUser username="new-user" password="password" confirm="password"
fullname="Full name" email="test@test.com"/>
</JiraJelly>

jira: DeleteProjectRole

Этот тег удалит роль проекта с данным идентификатором.

Атрибуты

 

Примеры

Удаление роли проекта от JIRA

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:DeleteProjectRole projectroleid="1" confirm="true" />
</JiraJelly>

jira: GetDefaultRoleActors

Этот тег будет возвращать объект ProjectRoleActors для данной роли проекта для конкретного проекта. Этот объект несет членов роли проекта, то есть пользователей и / или групп. Чтобы получить коллекцию пользователей в этом объекте, используйте выражение $ {roleactors.users}, где roleactors - это имя переменной объекта. Для получения дополнительной информации о объекте RoleActors обратитесь к API JIRA.

Атрибуты

 

Примеры

Возврат списка участников роли и повторение пользователей в каждом из этих участников.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib" xmlns:core="jelly:core">
<jira:GetDefaultRoleActors projectroleid="1" var="roleactors" >
<core:forEach var="actor" items="${roleactors.users}">
 ${actor.name}
</core:forEach>
</jira:GetDefaultRoleActors>
</JiraJelly>

jira: GetProjectRole

Этот тег вернет роль проекта с данным идентификатором.

Атрибуты

 

Примеры

Возврат роли проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
 <jira:GetProjectRole projectroleid="1" var="role" >
 ${role.name}
</jira:GetProjectRole>
</JiraJelly>

jira: GetProjectRoleActors

Этот тег будет возвращать объект ProjectRoleActors для данной роли и проекта. Этот объект является заполнителем для внутренних членов роли проекта, то есть пользователей и / или групп. Чтобы получить коллекцию пользователей в этом объекте, используйте выражение $ {roleactors.users}, где roleactors - это имя переменной объекта. Для получения дополнительной информации о объекте RoleActors обратитесь к API JIRA.

Атрибуты

 

Примеры

Вернуть список пользователей для данного объекта «актеры роли»

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib" xmlns:core="jelly:core">
<jira:GetProjectRoleActors projectkey="MKY" projectroleid="1" var="roleactors" >
<core:forEach var="actor" items="${roleactors.users}">
${actor.name}
</core:forEach>
</jira:GetProjectRoleActors>
</JiraJelly>

jira: IsProjectRoleNameUnique

Этот тег вернет «true» или «false», чтобы вы знали, есть ли уже роль проекта с данным именем.

Атрибуты

 

Примеры

Определение уникальности роли проекта.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:IsProjectRoleNameUnique name="unique name" var="isUnique" >
 ${isUnique}
</jira:IsProjectRoleNameUnique>
</JiraJelly>

jira: LinkIssue

Этот тег создает ссылку из одной задачи в другую.

Атрибуты

 

Примеры

Создать связь между двумя существующими задачами

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:LinkIssue key="TST-1" linkKey="TST-2" linkDesc="duplicates"/>
</JiraJelly>

Создайте две задачи и соедините их        

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:CreateIssue project-key="HSP" assignee="-1" summary="Issue summary 1" reporter="admin" issueKeyVar="issuekey1"/>
<jira:CreateIssue project-key="NDT" assignee="-1" summary="Issue summary 2" reporter="admin" issueKeyVar="issuekey2"/>
<jira:LinkIssue key="${issuekey1}" linkKey="${issuekey2}" linkDesc="duplicates"/>
</JiraJelly>

jira:Login

Этот тег регистрирует пользователя в JIRA с использованием имени пользователя и пароля. Используйте этот тег, когда вы запускаете скрипт Jelly таким образом, чтобы вы не вошли в систему (например, если вы используете JellyService вместо использования Jelly Runner) или если вы хотите запустить скрипт Jelly как другой пользователь к тому, с которым вы вошли в систему.

Атрибуты

 

Контекстные переменные

 

Примеры

Войдите в систему с именем пользователя и паролем и установите в контекст

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:Login username="misc-user" password="password">
<!-- other jelly tags -->
</jira:Login>
</JiraJelly>

jira: RemoveActorsFromDefaultProjectRole

Этот тег удалит список участников роли (то есть пользователей и / или групп) из членства по умолчанию для данной роли проекта.

Атрибуты

 

Примеры

Удаление списка групп из роли проекта по умолчанию

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:RemoveActorsFromDefaultProjectRole projectroleid="1"
actors="jira-administrators, jira-users" actortype="atlassian-group-role-actor" />
</JiraJelly>

jira: RemoveActorsFromProjectRole

Этот тег удалит список ролевых актеров из заданной роли проекта для данного проекта.

Атрибуты

 

Примеры

Удаление списка групп из роли проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
 <jira:RemoveActorsFromProjectRole projectroleid="1"
 actors="jira-administrators, jira-users" projectkey="MKY"
 actortype="atlassian-group-role-actor" />
</JiraJelly>

jira: RemoveUser

Удаляет существующего пользователя JIRA своим именем пользователя

Атрибуты

 

Примеры

Удалить пользователя

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:RemoveUser name="existing-user"/>
</JiraJelly>

jira: RunSearchRequest

Этот тег запускает запрос на поиск JIRA с использованием предопределенного фильтра.

Примечание: Этот тег возвращает GenericValue для каждой пзадачи, которая соответствует поисковому запросу.

GenericValue состоит из пар ключ-значение, например:

[GenericEntity:Issue]
[created,2007-11-01 15:51:25.0]
[summary,Testing]
[component,null]
[workflowId,12530]
[timeoriginalestimate,null]
[fixfor,null]
[type,2]
[timespent,null]
[environment,Windows]
[resolution,null]
[status,1]
[updated,2007-11-01 15:51:25.0]
[timeestimate,null]
[id,11540]
[key,TSTA-5]
[duedate,null]
[description,Test]
[project,10063]
[reporter,admin]
[security,null]
[votes,0]
[assignee,null]
[priority,3]

Чтобы получить значение, например. , вы можете вызвать gv.getString («ключ»). Полную информацию см. в API-интерфейсе OFBiz GenericValue.

Атрибуты

 

Примеры

Выполнение запроса на поиск и повторение с помощью ключей возвращаемых задач

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib" xmlns:core="jelly:core">
<jira:RunSearchRequest filterid="10524" var="issues" size-var="issuecount"/>
<core:forEach var="issue" items="${issues}">
${issue.key}
</core:forEach>
</JiraJelly>

jira: SelectComponentAssignees

Выбирает представителей по умолчанию для вновь созданных задач компонента.

Атрибуты

 

Примеры

Выберите представителя компоненты

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib">
<jira:SelectComponentAssignees project-key="ABC" componentName="Comp 1" assigneeType="componentLead"/>
</JiraJelly>

jira: TransitionWorkflow

Обратите внимание: этот тег недоступен в 3.3 и 3.3.1 - подробности см. в JRA-7690.

Этот тег выполняет переход рабочего процесса по задаче.

Имейте в виду, что если вы указываете пары атрибутов / значений полей в теге Jelly, эти поля ДОЛЖНЫ находиться на экране перехода с соответствующим рабочим процессом. Если поле отсутствует на экране, значение не будет задано по задаче. Например, если вы хотите установить атрибут разрешения в своем Jelly XML, ваш переход должен иметь связанный с ним экран, который включает в себя поле разрешения на этом экране.

 

Атрибуты

 

Примеры

Выполнение перехода рабочего процесса

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:TransitionWorkflow key="TST-6" user="testuser" workflowAction="Resolve issue"
resolution="fixed" fixVersions="version 1,version 3" assignee="-automatic-"
comment="Test comment" groupLevel="jira-developers" />
</JiraJelly>

jira: UpdateProjectRole

Этот тег обновит имя и описание для данного идентификатора роли проекта.

Атрибуты

 

Примеры

Обновление роли проекта

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">
<jira:UpdateProjectRole projectroleid="123" name="unique name"
description="my project role is nice" />
</JiraJelly>

 

Бета-теги

Существует также несколько тегов BETA, которые не были полностью протестированы или задокументированы. Следующий список содержит теги и атрибуты, которые могут быть переданы им:

 

• AddIssueSecurity
  • schemId (обязательно)
  • security (обязательно)
  • type (обязательно)
• AddIssueSecurityLevel
  • name (обязательно)
  • description (обязательно)
  • Output
    • issue.scheme.level.id
  • CreateIssueSecurityScheme
    • name (обязательно)
    • description (обязательно)
    • Output
      • issue.scheme.id
    • LoadManager
      • var (переменная для ввода менеджера)
      • manager (имя менеджера, например IssueManager)
    • LoadProject
      • var (переменная для ввода проекта)
      • project-name (название проекта)
    • RemoveGroup
      • name (обязательно)
    • RemovePermissionScheme
      • schemId (обязательно)
      • confirm (обязательно)
    • RemoveProject
    • pId (обязательно)
    • SelectProjectScheme
      • projectKey (обязательно)
      • permission-scheme (название схемы разрешения) или
      • issue-scheme (название схемы безопасности задачи)
    • StringContains
      • value (Строка для просмотра)
      • possiblyContains (String, чтобы искать)
      • doContain (true или false), если значение содержит possiblyContains == doesContain, внутренняя часть тега выполняется.

Если вам нужна дополнительная информация о том, как использовать бета-теги, прочитайте источник и / или отправьте сообщение в Atlassian Answers для JIRA.

 

Примеры скриптов

Создание нового проекта

Для правильного разбиения проектов необходимо, чтобы для каждого проекта была  схема разрешений, а для групп проекта - распределение разрешений. Создание нового проекта может быть трудоемким процессом. Следующие примеры скриптов Jelly автоматизируют это:

Этот скрипт может использоваться для общедоступного проекта:

<?xml version="1.0"?>
<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib" xmlns:j="jelly:core">

<j:set var="name" value="Test Project"/>
<j:set var="key" value="TEST"/>
<j:set var="lowerkey" value="test"/>
<j:set var="lead_username" value="joe"/>
<j:set var="lead_password" value="joe"/>
<j:set var="lead_fullname" value="Joe Bloggs"/>
<j:set var="lead_email" value="joe@example.com"/>
<j:set var="url" value="http://example.com/TestProj"/>

<jira:CreateUser username="${lead_username}" password="${lead_password}" confirm="${lead_password}"
fullname="${lead_fullname}" email="${lead_email}"/>
<jira:CreateGroup group-name="${lowerkey}-developers">
 <jira:AddUserToGroup username="${lead}"/>
</jira:CreateGroup>

<jira:CreateProject key="${key}" name="${name}" url="${url}" lead="${lead_username}">
<jira:CreatePermissionScheme name="${name} permissions">
<jira:AddPermission type="reporter" permissions="Close"/>
<jira:AddPermission group="jira-administrators" permissions="Close,Delete" type="group"/>
<jira:AddPermission group="jira-users" permissions="Create,Edit,Comment,Link,Attach" type="group"/>
<jira:AddPermission group="${lowerkey}-developers"
permissions="Project,ScheduleIssue,Move,Assign,Assignable,Resolve,Close,Work" type="group"/>
<jira:AddPermission group="Anyone" permissions="Browse,ViewVersionControl"/>
<jira:SelectProjectScheme/>
</jira:CreatePermissionScheme>
</jira:CreateProject>
</JiraJelly>

Этот сценарий более сложный, с несколькими группами для каждого проекта:

<?xml version="1.0"?>
<!-- This script handles some of the administrative chores required when adding
a new project to JIRA. It creates the project, groups, permission scheme, and gives
groups the relevant permissions in the permission scheme. -->
<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib" xmlns:j="jelly:core">

<!-- Name of the project to create -->
<j:set var="name" value="Jelly Test Project"/>
<!-- Key for the new project -->
<j:set var="key" value="TEST"/>
<!-- Existing user who will become the project lead (default assignee) -->
<j:set var="admin" value="admin"/>

<jira:CreateGroup group-name="${key}-users"/>
<jira:CreateGroup group-name="${key}-developers"/>
<jira:CreateGroup group-name="${key}-managers"/>
<jira:CreateGroup group-name="${key}-bizusers"/>
<jira:CreateGroup group-name="${key}-qa"/>

<jira:CreateProject key="${key}" name="${name}" lead="${admin}">
<jira:CreatePermissionScheme name="${key} Permission Scheme">
<jira:AddPermission type="reporter" permissions="Edit"/>
<jira:AddPermission type="assignee" permissions="Resolve"/>
<jira:AddPermission group="jira-administrators" permissions="Project,Delete" type="group"/>
<jira:AddPermission group="${key}-users" permissions="Browse,Create,Comment,Attach" type="group"/>
<jira:AddPermission group="${key}-developers" permissions="Move,Assignable,Link,ViewVersionControl"
    type="group"/>
<jira:AddPermission group="${key}-managers" permissions="Edit,Assign,Assignable,Resolve,Close,Delete"
    type="group"/>
<jira:AddPermission group="${key}-bizusers" permissions="Assignable" type="group"/>
<jira:AddPermission group="${key}-qa" permissions="Assignable" type="group"/>
<jira:AddPermission group="opsmgrs" permissions="Browse,Edit,Assignable,Comment" type="group"/>
<jira:AddPermission group="dba-user-group" permissions="Browse,Assign,Assignable,Comment" type="group"/>
<jira:AddPermission group="help-desk-group" permissions="Browse,Assign,Assignable,Comment" type="group"/>
<jira:AddPermission group="webadmin-group" permissions="Browse,Assign,Assignable,Comment" type="group"/>
<jira:AddPermission group="unix-admin-group" permissions="Browse,Assign,Assignable,Comment" type="group"/>
<jira:SelectProjectScheme/>
</jira:CreatePermissionScheme>
</jira:CreateProject>
</JiraJelly>

Для списка проектов выполните конкретную операцию.

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

<?xml version="1.0"?>
<!-- Jelly script to create 'support' group per project -->
<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib" xmlns:util="jelly:util" xmlns:j="jelly:core">
<util:tokenize var="projects" delim=",">ARM,QWI,DWI,DBOR,DBSQ,LYX,MMM,MOI,TPAI,SEP,AMR,SLA,TP,TRBC,YRD</util:tokenize>
<j:forEach var="proj" items="${projects}">
<jira:CreateGroup group-name="${proj}-support"/>
<jira:AddUserToGroup username="jeff" group-name="${proj}-support"/>
</j:forEach>
</JiraJelly>

Создавать пользователя, задачу и назначать задачу пользователю

Следующий сценарий создает пользователя (называемый новым пользователем), создает новую задачу, добавляет пользователя в группу разработчиков jira и назначает задачу пользователю. Он иллюстрирует использование контекстных переменных.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">

<jira:CreateUser username="new-user" password="password" confirm="password" 
    fullname="Full name" email="test@test.com"/>
Username is ${jelly.new.username}
 <jira:CreateIssue project-key="TP" summary="New issue summary" issueKeyVar="ik"/>
 <jira:AddUserToGroup username="new-user" group-name="jira-developers"/>
 <jira:AssignIssue key="${ik}" assignee="${jelly.new.username}"/>

</JiraJelly>

Назначение и запуск

Здесь мы создаем задачу, назначаем ее «bob» (кто должен быть в jira-developers) и начинаем работу:

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.JiraTagLib">

 <jira:CreateIssue project-key="TP" summary="New issue" issueKeyVar="ik"/>
 <jira:AssignIssue key="${ik}" assignee="bob"/>
 <jira:TransitionWorkflow key="${ik}" user="bob" workflowAction="Start Progress" />
</JiraJelly>

Перемещение нерегламентированных задач в состояние «Неактивное»

Когда JIRA используется для взаимодействия с клиентами, этот сценарий полезен для поиска задач, которые ожидают ответа клиента, и на какое-то время не ответили. Он переводит такие проблемы в состояние «Неактивное».Вы обычно вызываете этот скрипт периодически с помощью Jelly Service.

<JiraJelly xmlns:jira="jelly:com.atlassian.jira.jelly.enterprise.JiraTagLib" xmlns:core="jelly:core" xmlns:log="jelly:log" >
<jira:Login username="customersupport" password="XXXXXX">
        <log:warn>Running Inactivate issues service</log:warn>
        <core:set var="comment">This issue has not been updated for 5 business days.

If you have an update, please use "Add Comments For Vendor" action to let us know. 
If you need more time to gather information please let us know and we will 'freeze' this issue. 
If you have no other questions, please Close this issue.

If no update is received in the next 5 business days, this issue will be automatically closed.

Thank you,

  The Support Team</core:set>
        <core:set var="workflowStep" value="Mark Inactive" />
        <core:set var="workflowUser" value="customersupport" />

        <!-- Run the SearchRequestFilter -->
        <jira:RunSearchRequest filterid="11505" var="issues" />

        <core:forEach var="issue" items="${issues}">
                <log:warn>Inactivating issue ${issue.key}</log:warn>
                <jira:TransitionWorkflow key="${issue.key}" user="${workflowUser}" workflowAction="${workflowStep}" comment="${comment}"/>
        </core:forEach>
</jira:Login>
</JiraJelly>

Где

• workflowStep - это название перехода рабочего процесса, например «Закрыть задачу», «Начало прогресса», так же, как они отображаются в левом меню на экране задач.
• workflowUser - это пользователь для запуска перехода как
• filterid - это идентификатор сохраненного поиска (фильтра), который обнаруживает, что задачи должны быть инактивированы (перешли). Этот идентификатор можно найти по URL-адресу фильтра на вкладке «Управление» в разделе «Найти задачи».

Инструмент JIRA инструментарий (Toolkit) полезен в сочетании с этим скриптом, чтобы найти задачи, ожидающие ответа клиента.

 

По материалам Atlassian JIRA Administrator's Guide: Jelly Tags