Службы

Служба - это класс, который периодически запускается в JIRA. Поскольку служба работает внутри JIRA, она имеет возможность использовать весь JIRA API, и, поскольку она написана на Java, она может использовать любые библиотеки Java.

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

Написание новой службы?

Если вы не распространяете встроенную службу JIRA, вам следует настоятельно рассмотреть возможность написания новой службы с помощью API SAL. Дополнительную информацию см. В нашем учебнике по плагинам - Планирование событий через SAL.

Регистрация службы(info)

Для персонализированных служб убедитесь, что ваш класс обслуживания находится в пути к классам, где JIRA может его видеть. Лучшими местоположениями обычно являются <jira-application-dir> / WEB-INF / classes или <jira-application-dir > / WEB-INF / lib внутри вашего каталога установки JIRA (в виде файлов JAR).

Чтобы настроить службу JIRA, выполните следующие шаги:

  1. Войдите в систему как пользователь с глобальными разрешениями системных администраторов JIRA.
  2. Выберите > «Система» (System). Выберите «Дополнительно» (Advanced)> «Службы» (Services ), чтобы открыть страницу, отображающую все настроенные службы.

Комбинация  клавиш: g + g + начать вводить службы

  1. В форме «Добавить службу» (Add Service) внизу страницы заполните следующие поля:
  • Имя (Name) - описательное имя для этой службы.
  • Класс (Class) - полное имя класса вашей службы. Вероятно, это будет форма com.atlassian.jira.service.services.type.TypeService

См. Пример служб для предоставленных имен классов служб.

Чтобы использовать один из встроенных классов служб JIRA, сначала нажмите ссылку «Встроенные службы» (Built-in Services), чтобы развернуть список классов служб ,  а затем щелкните имя определенного класса в списке. Полноценное имя класса встроенной службы  будет добавлено в поле «Класс» (Class) .

  • Расписание (Schedule) - как часто выполняется служба. Конкретные интервалы могут быть настроены для каждой частоты:

  1. После заполнения полей в форме «Добавить службу» (Add Service) нажмите кнопку «Добавить службу» (Add Service). Откроется страница «Изменить службу» (Edit Service), где вы можете настроить параметры новой службы.

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

  1. После завершения оставшихся параметров на странице «Изменить службу» (Edit Service) нажмите кнопку «Обновить» (Update), чтобы сохранить параметры новой службы.

Редактирование свойств службы

Чтобы изменить свойства службы, выполните следующие шаги:

  1. Войдите в систему как пользователь с глобальными разрешениями системных администраторов JIRA.
  2. Выберите >  «Система» (System). Выберите «Дополнительно» (Advanced)> «Службы» (Services), чтобы открыть страницу, отображающую все настроенные службы.

Комбинация клавиш: g + g + начать вводить службы.

  1. Нажмите ссылку «Изменить» (Edit), связанной со службой, свойства которой вы хотите изменить.

Например, чтобы изменить интервал отправки электронной почты из JIRA, отредактируйте службу очереди сообщений (Mail Queue Service) и измените значение задержки (Delay) по умолчанию на 1 минуту.

Удаление службы

Чтобы удалить службу , выполните следующие шаги:

  1. Войдите в систему как пользователь с глобальными разрешениями системных администраторов JIRA.
  2. Выберите > «Система» (System). Выберите «Дополнительно» (Advanced)> «Службы» (Services), чтобы открыть страницу, отображающую все настроенные службы.

Комбинация клавиш: g + g + начать вводить службы

  1. Нажмите ссылку «Удалить» (Delete), связанную с службой, которую вы хотите удалить.

Встроенные службы

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

Экспорт службы

Служба экспорта полезна для периодической резервной копии JIRA. Он экспортирует все данные из JIRA при каждом запуске в каталог, поставляемый в качестве параметра. Файлы экспорта имеют временную метку, поэтому служба может действовать как резервная система.

Чтобы протестировать эту службу, добавьте службу в класс com.atlassian.jira.service.services.export.ExportService. JIRA настраивает ExportService в новых установках JIRA (после завершения мастера настройки). Следовательно, вы можете обнаружить, что у вас она уже есть.

Этот класс можно найти в следующем каталоге расширенного исходного архива JIRA (который может быть загружен клиентами JIRA с https://my.atlassian.com):<source-installation-directory>/jira-project/jira-components/jira-core/src/main/java/com/atlassian/jira/service/services/export

Служба Jelly

Jelly- это язык сценариев, который позволяет автоматизировать задачи в JIRA. Служба Jelly периодически запускает скрипт Jelly. Например, вы можете использовать это для периодического запуска поискового запроса (request), просмотра результатов и добавления комментария, изменения состояния задачи (см. Примеры Jelly).

Если вы планируете писать пользовательскую службу, часто альтернативный сценарий Jelly может быть проще.

Этот класс можно найти в следующем каталоге расширенного исходного архива JIRA (который может быть загружен клиентами JIRA с https://my.atlassian.com):<source-installation-directory>/jira-project/jira-components/jira-core/src/main/java/com/atlassian/jira/jelly/service

Службы почтового обработчика

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

Пользовательские службы

Если вы являетесь разработчиком JIRA, который хочет написать свой собственный JIRA-сервис, обратите внимание, что классы JIRA Service должны расширять com.atlassian.jira.service.JiraService. Большинство из них делают это, расширяя com.atlassian.jira.service.AbstractService или еще один специализированный подкласс.

 

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