что такое jira и confluence
Обучающее руководство. Использование Confluence Cloud вместе с Jira Software Cloud
Confluence и Jira являются мощными инструментами и по отдельности, а вместе они способны полностью преобразить совместную работу над проектами, разработку программного обеспечения, отслеживание принятия ключевых решений в команде и многое другое. Объединить Confluence и Jira можно разными способами, и здесь описано, с чего можно начать работу.
Если вы используете вариант Confluence Data Center или Confluence Server, узнайте из этого документа (на английском языке), как использовать приложения Jira вместе с Confluence.
Интеграция Confluence и Jira Software
Инструмент Jira специально разработан, чтобы командам было проще планировать и отслеживать работу по проекту. Если объединить его с Confluence, вы получите возможность упорядочивать все идеи, содержимое и файлы, которые создаете вместе с командой, по мере того как задуманное претворяется в жизнь.
Установив связь между проектом Jira Software и разделом Confluence, где находится вся документация по проекту, вы избавитесь от необходимости в совместно используемых дисках и папках с файлами. Поиск необходимого станет невероятно простым. Давайте же приступим к делу!
Подключение раздела Confluence к проекту Jira
Это первый шаг к интеграции Confluence и Jira.
Отлично! Теперь вы можете просматривать, создавать и редактировать страницы в Jira.
Добавление ярлыка Jira на страницу Confluence
Ярлыки позволяют легко переключаться между продуктами.
Теперь вы можете с легкостью переходить в свой проект Jira, нажимая ярлык в левой боковой панели. Использовать ярлыки может любой пользователь, но только администраторы сайта могут создавать новые ярлыки в разделе Confluence.
Добавление ярлыка Confluence в проект Jira
Администраторы могут добавить ярлык Confluence в проект Jira.
Теперь вы сможете переключаться между проектом Jira и связанным разделом Confluence в мгновение ока. Установив связь между проектом Jira и страницей Confluence, вы будете видеть важные уведомления Jira (например, об обмене файлами, упоминаниях и комментариях) в разделе уведомлений Confluence. Ни одно важное уведомление Jira не останется незамеченным, даже если вы с головой уйдете в работу в Confluence.
См. пошаговые инструкции в этом видео:
Использование встроенных страниц Confluence в Jira
Если проект Jira подключен к разделу Confluence, вы можете просматривать, редактировать и создавать страницы Confluence, не покидая продукт. Это формирует более интегрированный интерфейс страниц проектов в Jira и сводит к минимуму количество переключений контекста.
Просматривать страницы просто. Перейдите в «Страницы проектов» и выберите страницу, чтобы открыть ее во встроенном окне, не переключаясь на Confluence.
Чтобы добавить новый контент из пункта «Страницы проектов», вы можете создать его из пустой страницы Confluence либо с помощью шаблона Confluence, и все это — в Jira Software.
С помощью встроенных страниц в Jira также можно редактировать страницы Confluence. Для этого в пункте «Страницы проектов» наведите курсор на страницу и нажмите появившийся значок карандаша для внесения правок.
Создавайте задачи JIRA из Confluence
Задачу или эпик Jira можно создать непосредственно в Confluence. Чтобы создать задачу, выполните следующие действия.
Задача будет автоматически добавлена страницу Confluence и в выбранный проект Jira.
Точно так же вы можете создавать задачи Jira из контента в Confluence. Для этого выделите на странице в режиме просмотра любой текст и выберите «Создать задачу», чтобы создать задачу Jira.
См. пошаговые инструкции в этом видео:
Добавление задач Jira на страницы Confluence
Большинству людей не хочется постоянно тратить время на переключение между приложениями. К счастью, благодаря интеграции Jira и Confluence отслеживать задачи Jira без труда можно прямо в Confluence. Даже если вы проводите целый день в Confluence или Jira, у вас всегда перед глазами будет необходимый контекст с возможностью отслеживания. Благодаря этому эффективность команды изо дня в день повышается.
Отслеживание задач Jira непосредственно в Confluence
Просто вставьте ссылку Jira на страницу Confluence. На вашей странице Confluence автоматически появится динамическая ссылка на задачу Jira. После публикации страницы в ссылке отобразится идентификатор и название задачи, категория задачи (эпик, задание и т. д.) и ее статус в рабочем процессе («Предстоит сделать», «В процессе», «Завершено» и т. д.).
На странице задачи Jira в разделе «Страницы Confluence» появится ссылка на страницу Confluence.
Отображение динамического списка задач Jira на странице Confluence
Чтобы отобразить список задач Jira на странице Confluence, выполните следующие действия.
Выбирая задачи Jira для добавления на страницу, можно выполнить поиск по существующим задачам, создать новую задачу или выбрать одну из недавно просмотренных. Возможности поиска весьма широки: вы можете искать по ключу задачи, URL-адресу, ссылке Jira, JQL-запросу, простому тексту или фильтру. Фильтры позволяют значительно сэкономить время. Создайте фильтр для группы задач или выполните поиск по сохраненным фильтрам из Jira.
Теперь вы можете выбрать формат, в котором задачи Jira должны отображаться на странице: должна выводиться таблица со списком задач или только количество задач, относящихся к поисковому запросу. Созданная таблица является динамической и будет уточняться при каждом обновлении страницы Confluence.
См. пошаговые инструкции в этом видео:
Добавление «сборщика» задач Jira
Чтобы еще лучше усовершенствовать процесс создания задач, создайте «сборщик» задач Jira.
С помощью «сборщика» задач можно без труда встроить форму Jira в страницу или веб-сайт Confluence. После настройки и размещения на странице Confluence «сборщик» появится в виде кнопки, при нажатии которой отображается форма создания задачи Jira. Любой пользователь, который имеет право просматривать страницу Confluence, может нажать кнопку, внести данные в персонализированную вами форму и создать заявку Jira для проекта Jira, связанного с разделом или страницей Confluence.
«Сборщик» задач Jira идеально подходит для сбора информации от клиентов. С его помощью сотрудники организации могут регистрировать баги или проблемы во время разработки версии приложения для внутреннего использования, а сотрудникам, работающим в Confluence, будет проще и быстрее создавать заявки в Jira, и это не приведет к помехам в их рабочем процессе.
Добавление дорожной карты Jira в Confluence
Вы можете добавить макрос Jira Roadmap (в том числе макрос для Advanced Roadmaps), который позволяет встроить на страницу Confluence дорожную карту, обновляющуюся в режиме реального времени. Это позволит держать команду в курсе происходящего, предоставляя контекст для запланированной работы, актуальные статусы и многое другое. Вы сможете найти все необходимое в одном месте, не переключаясь в другое приложение и не занимаясь копированием и вставкой содержимого вручную.
Создание отчетов Jira в Confluence Cloud
Отслеживание прогресса, результатов и решений не всегда проходит просто, как по шаблону. Когда дело касается множества заинтересованных лиц и команд, важно уметь доносить информацию до их сведения эффективными способами. Благодаря шаблону «Отчет Jira» отчитаться о работе, выполняемой в рамках проектов Jira, становится проще простого. Сообщайте информацию о ходе работы над текущим релизом или предоставляйте статический лог изменений, из которого можно узнать о различиях между последними релизами.
Сначала нужно создать страницу Confluence с помощью шаблона Jira Report. Выберите проект, по которому необходимо отчитаться, и шаблон автоматически создаст уже настроенную страницу с отчетом о статусе. В отчет будут автоматически добавлены круговые диаграммы, составленные на основе информации в полях вашего проекта, таких как «приоритет», «тип задачи» и др. Вы можете настроить свой отчет, выбрав другие поля для использования в отчете.
С помощью отчетов Jira заинтересованные лица получат общее представление о прогрессе команды, сделав всего лишь несколько щелчков мышью. Представив информацию для всех заинтересованных лиц наглядно и доступно, команда может сосредоточиться на насущных делах и быстрее завершить работу.
Использование JIRA и Confluence в большом проекте
Начало нового проекта как правило сопровождается решением массы организационных вопросов: как будут взаимодействовать участники проекта, где будут храниться документы и как будет построено их согласование, как будут ставить задачи и выдавать поручения… В каждой компании, у каждого руководителя проектов, уже есть заготовки и предпочтения. Но всегда полезно посмотреть, как это делают другие. Поэтому предлагаю познакомиться с примером из практики, который вышел весьма удачным.
Для организации работы проектной команды необходим единый информационный центр, с помощью которого решаются следующие задачи:
Портал проекта — Confluence
Confluence — это удобный и продвинутый wiki движок от компании Atlassian. Он позволяет организовать внутренний интернет портал и дать доступ к нему всем пользователям — для редактирования или для чтения.
Проектный портал содержал все проектные материалы, часть которых мы сделали в виде иерархии страниц.
Верхний уровень иерархии — это этапы проекта. На каждом этапе создали страницы-ключевые задачи этапа. Причем на каждой странице — описание задачи, каково ее содержание, зачем она необходима, кто ее выполняет, приложены шаблоны документов.
Все контрактные документы, которые должны сдаваться в качестве результатов проекта, выкладывали на соответствующую страницу в Word, Excel или pdf. Таким образом все проектные материалы, были в одном месте, структурированы, и не было путаницы с версиями.
Масса полезной информации мы организовали в виде специальных страниц. Например, для большой команды крайне популярной является контактная карта, на которой у нас был список проектной команды по группам, с фотографиями и данными участников.
Страница со ссылками на экземпляры системы поддерживались системными администраторами. Там же была схема эволюции технической инфраструктуры — когда какие экземпляры появлялись и выводились из эксплуатации.
Процедуры и регламенты
Собрание всех инструкций и проектных регламентов на портале, в актуальном и удобном для чтения виде позволяет экономить на объяснениях новым участникам и бороться с отговорками «не прочитал, не нашел, не видел». Когда вопрос все-таки возникает, можно выслать ссылку на страничку, чтобы не пересылать документ и тратить время на его поиск. Версия — всегда актуальная, т.к. обновление происходит непосредственно на портале.
Риски и открытые вопросы
Мы вели на портале риски и открытые вопросы. На каждый риск или вопрос мы заводили отдельную страницу, по заранее созданному шаблону. На странице риска, кроме обязательных названия и классификаторов, было подробное описание содержания, последствий, а также план действий со сроками и ответственными, и статус риска. Примерно так же были организованы открытые вопросы.
Специальная страница автоматически собирала список страниц с рисками, образуя таким образом реестр рисков.
Просматривая список можно перейти на соответствующую страницу, прочитать описание риска и посмотреть план действий по нему.
План действий может представлять из себя простой текст, задачу в Confluence или ссылку на задачу в JIRA.
Рассмотрим варианты, которые можно использовать, которые позволяют напоминать о действиях участникам и контролировать их исполнение.
Задача в Confluence — это отдельная сущность, которую можно добавить на страницу. Напоминание о задаче высвечивается для пользователя, когда он входит на портал, значком в правом верхнему углу. Кликнув по этому значку пользователь переходит к списку своих поручений. Когда задача выполнена, он ставит галочку, и статус задачи меняется за завершенный.
Однако так же точно можно снять галочку и задача опять становится не выполненной. Поэтому такая система выглядит не очень надежно и контроль за поручениями в этом случае слабый.
Второй вариант — использование для поручений задач в JIRA. Непосредственно со страницы проектного портала можно создать задачу в JIRA, назначить ответственного и установить срок исполнения. Для этого мы сделали специальный макрос, срабатывающий по кнопке Создать поручение.
В отличие от предыдущего варианта эта задача может быть настроена так, чтобы ее мог закрыть только ответственный, отличный от исполнителя, что дает хороший контроль ее выполнения.
Практика, которой мы придерживались, помогала нам сохранять все решения, которые мы принимали на совещаниях. В ходе каждого совещания мы вели протоколы непосредственно на портале проекта. В начале каждого совещания мы создавали новую страницу протокола на основании шаблона, и записывали основные моменты по ходу обсуждения. В конце формулировали решение и план действий.
Если кто-то после совещания хотел уточнить текст протокола, тот мог это сделать прямо на страничке портала, и было видно, кто и когда какие изменения внес. Протокол считался согласованным сразу после совещания, это экономило массу времени.
JIRA — Система для ведения списков, поручений, задач
JIRA создана как система регистрации и исполнения запросов на обслуживание. Однако она может быть использована для ведения любых реестров и управления любыми задачами.
В нашем проекта мы использовали JIRA для контроля исполнения поручений, ведения разработок и отслеживания задач по конвертации данных.
Ведение разработок с помощью JIRA подробно описано в статье Управление разработками. Здесь я расскажу о контроле поручений и интеграции с Confluence.
Для создания задачи JIRA из Confluence достаточно выделить текст, навести курсор на выделенный текст и нажать кнопку в контекстном меню, чтобы вызвать экран JIRA для создания задачи.
На странице протокола появится ссылка на задачу, а в задаче JIRA будет ссылка на страницу в Confluence.
Таким образом мы можем переходить между этими двумя системами, с одной стороны, чтобы уточнить состояние и историю исполнения поручения, а с другой — посмотреть контекст и причину возникновения задачи.
Интеграция между системами также помогала нам отслеживать списки открытых вопросов, связанными с разработками.
В конце проекта, когда остался список критичных разработок, которые необходимо было закрыть для завершения проекта, мы организовали его в виде таблицы на странице портала проекта, в одной из ячеек которой была ссылка на разработку в JIRA. Кроме номера задачи там отображается и текущий статус. Просматривая список мы можем видеть, какие задачи еще не закрыты, в каком состоянии они находятся, и при необходимости можем перейти к ней, чтобы увидеть всю историю и переписку по ней.
Работа с JIRA требует определенной квалификации и опыта. Здесь я описал некоторые варианты использования, однако на самом деле их гораздо больше. Прелесть в том, что можно начать с самых базовых вещей, и это уже будет работать, а затем развивать систему по мере приобретения опыта и понимания потребностей.
Кроме Confluence, в интеграции с JIRA, мы также использовали BitBucket, также продукт Atlassian — репозиторий разработок, позволяющий отслеживать версии кода. Для этих же целей на другом проекте использовали бесплатный SVN.
Множество плагинов позволяет расширять функциональность системы, в частности, для интеграции с MS Project или реализации диаграммы Гантта непосредственно в JIRA.
Большое количество вариантов использования может стать препятствием для тех, кто берется за использование этих инструментов в первый раз. В этом случае можно воспользоваться опытом других проектов, которых великое множество, либо начать с самого простого.
Организация проектного пространства с помощью JIRA и Confluence доказало свою эффективность и удобство. Ключевые преимущества — это удобство, надежность и широчайшие возможности для адаптации. На наших проектах такая системам стала стандартом де факто.
Кастомизация JIRA и Confluence с помощью плагинов
Практически все организации, где необходимо вести документацию и управлять бизнес-процессами, сталкиваются с необходимостью выбора и настройки софта, который облегчает эти процессы. JIRA и Confluence от компании Atlassian Software достаточно популярны на российском рынке. Однако в своей дефолтной конфигурации они не могут решить все задачи, стоящие перед организацией – ведь у каждого своё видение процессов работы. Кроме того требования кастомизировать JIRA растут по мере использования продукта.
Я работаю разработчиком JIRA/Confluence в Mail.Ru Group, и хочу поделиться опытом написания плагинов JIRA и Confluence: что можно сделать, как сделать и о чём нужно не забыть.
О чем я расскажу
Здесь будет опубликовано несколько постов, посвященных разработке различных компонентов. Плагины и исходный код можно найти здесь.
Пользовательские поля
Итак, начнём с пользовательских полей. Поля являются базовой единицей данных в JIRA. Они содержат данные требований (issues). Поля в JIRA в целом можно разделить на две основные категории: системные поля и пользовательские поля. К системным полям относятся различные формы, такие как текстовые поля, раскрывающиеся списки и другие. На практике базовой функциональности часто не хватает, и нам требуется программировать свои пользовательские поля (например, поле вычисляющее сумму других полей или количество комментариев).
Первый плагин (Query Issues Custom Fields) – это список, значения которого – ключи требований (issues), которые выбираются из настроенного запроса поиска (JQL). Значение списка – номера требований (issue keys).
Таким образом, значения обновляются автоматически каждый раз при редактировании и просмотре поля. Готовый плагин находится тут.
Итак, мы хотим разработать плагин, который можно использовать для различных проектов, его просто использовать, и он работает на всех версиях JIRA.
Чтобы реализовать первое требование, нам следует организовать хранилище данных плагина, где мы сможем сохранять запрос (JQL) и другие настройки для разрабатываемого пользовательского поля. Чтобы хранить запрос поиска (JQL) целесообразно использовать контейнер данных для плагинов (com.atlassian.sal.api.pluginsettings.PluginSettings). Следует заметить, что при таком выборе у нас не будет проблем с переносимостью плагина на другие версии JIRA. Кроме того, если использовать использовать библиотеку сериализации Java-объектов (например, XStream) для представления объекта в виде строки, мы сможем хранить данные любой структуры. Чтобы использовать хранилище, необходимо добавить следующие строки в файл конфигурации плагина atlassian-plugin.xml:
а также определить интерфейс, выполняющий требуемые манипуляции,
После чего определённый менеджер данных можно использовать в любых сервлетах и расширениях стандартных Jira компонентов, например так:
Также хорошей практикой будет реализовать административную страницу настройки плагина. На странице имеет смысл распечатать список всех полей управления проектами и снабдить страницу контролами для настройки поля. Класс реализующий административную страницу лучше сделать наследником от com.atlassian.jira.web.action.JiraWebActionSupport. Пример класса – ru.mail.jira.plugins.lf.QueryFieldsConfig. Чтобы подключить к плагину, достаточно добавить в atlassian-plugin.xml следующие строки:
Более подробно, как реализовывать URL-действия (actions) JIRA, можно посмотреть здесь.
Кроме того следует помнить, что административную страницу следует защитить от XSRF-атак. Подробнее об этом читать здесь.
Если мы не можем решить, каким образом мы будем отображать наше поле, то за основу можно взять простое текстовое поле (ru.mail.jira.plugins.lf.LinkerField) и расширить его. По текстовым полям невозможно строить диаграммы и собирать статистику, но этот функционал можно реализовать самим: ru.mail.jira.plugins.lf.LirkerFieldSearcher, ru.mail.jira.plugins.lf.LirkerFieldCustomFieldValueProvider, ru.mail.jira.plugins.lf.LirkerFieldSearchInputTransformer и ru.mail.jira.plugins.lf.LirkerFieldCustomFieldRenderer.
После этого нам остаётся только запрограммировать внешний вид для редактирования и представление: edit-linkerfield.vm и view-linkerfield.vm.
Хочу заметить, что если вы не знаете как запрограммировать представление, то советую посмотреть как реализованы стандартные поля: webapp/WEB-INF/classes/templates/plugins/fields.
Данный подход можно использовать для реализации пользовательских полей любой сложности. Например, таким образом можно реализовать colorpicker, список из вычисляемых полей, формулы и так далее.
Обработчики событий
Второй плагин, который я хочу прокомментировать – JIRA MRIM Listener. Это плагин отправляет в Агент Mail.Ru оповещения о событиях в JIRA. Чтобы создать подобный плагин, достаточно реализовать всего один обработчик событий. Вот шаблон класса:
Исходный код тут. Стоит заметить, что для фильтрации событий здесь можно использовать хранилище данных плагина, подобное рассмотренному в предыдущем примере. Используя обработчик событий, можно создавать связанные требования, подписывать вложенные файлы, отправлять HTTP запросы и многое другое.
Вместо заключения
Тем, кто интересуется разработкой, но ещё никогда этим не занимался, я хочу порекомендовать книгу – JIRA Development Cookbook и следить за свободными плагинами на https://marketplace.atlassian.com/vendors/37127.
Вот, собственно и всё, о чем я хотел вам рассказать. Если у вас появились вопросы или вы хотите поделиться своими соображениями по поводу JIRA и Confluence, буду рад пообщаться с вами в комментах. Кроме того, если у вас есть идеи свободного плагина – пишите, сделаю или помогу с реализацией.
Интеграция Jira + Confluence. Зачем это нужно?
Jira и Confluence — отличное комбо для проджект менеджмента и самоорганизации
Интеграция Jira и Confluence
Jira и Confluence — отличные продукты от Atlassian для проджект менеджмента и самоорганизации. Но что будет, если объединить их? Ничего сверхъестественного не произойдет, зато ваша команда получит одну из наилучших комбинаций инструментов от Atlassian. Хотите узнать, почему?
Объединив Jira и Confluence, вы получите единый информационный портал, в котором можно хранить все. С легкостью переключаясь между Jira и Confluence с помощью кнопки Jira links, вы значительно ускорите свой воркфлоу. Вам больше не придется выискивать важный документ на электронной почте или в Google Drive, ведь любой тиммейт будет иметь доступ ко всей необходимой информации прямо в Confluence. Все идеи и контент из Confluence будет связан с заданиями и тикетами из Jira, и работа команды станет более эффективной.
Jira link в Confluence
Используя Jira и Confluence вместе для разработки ПО, например, можно отслеживать все свои задачи Jira, и собирать все данные по ним в портале Confluence. Еще одно преимущество интеграции — возможность создания задачи Jira напрямую со страницы портала проекта Confluence, назначив ответственного за нее и установив срок исполнения. Такая двусторонняя связь значительно облегчит работу вашей команде.
Link в документ Confluence на Jira ticket
Отлично налаженная коммуникация между сотрудниками — залог продуктивной работы всей команды. Сам Atlassian признает, что 66% пользователей, у которых есть и Jira и Confluence, очень рады, что теперь благодаря коммуникации внутри системы все шаги в проекте становятся прозрачными для каждого.
Создание и организация единой базы знаний также поможет в развитии инцидент менеджмента. Благодаря шаблонам статей по траблшутингу вы не будете терять свое драгоценное время. А сделав базу знаний публичной для пользовательского портала, дав активным пользователям доступ по ссылкам, неважно, есть ли у них самих Confluence или нет — ваша команда значительно продвинется в решении тикетов и инцидентов. Благодаря готовым статьям по траблшутингу, они смогут быстро найти, как разрешить какую-либо распространенную проблему.
Интеграция Jira и Confluence поможет в настройке коммуникации не только внутри команды, но и между вами и вашими заказчиками. Благодаря такому проектному порталу у вас будет меньше шансов упустить важные детали, а скорость работы и продуктивность повысятся соответственно.Правильно настроив роли в Jira и Confluence, ваши заказчики смогут видеть относящиеся к ним проекты, но при этом не будут иметь доступ к персональным страницам ваших сотрудников. Прозрачность проекта для заказчика гарантированно обеспечит его доверие к вам и вашей работе.
Активное и уверенное использование Jira и Confluence всей командой
Интеграция JIRA и Confluence прекрасно справится с организацией единого информационного портала для ваших проектов, который уже доказал свою эффективность. Ключевые преимущества совместной работы этих двух инструментов — это удобство, надежность и огромные возможности для адаптации.
Активное и уверенное использование Jira и Confluence всей командой, и особенно звеном менеджеров — это главный фактор успеха. Конечно, вы можете попробовать интегрировать Jira и Confluence самостоятельно при помощи многочисленных туториалов, но для начинающих пользователей Atlassian это может показаться довольно сложным процессом. Вы также можете обратиться в Polontech. Наши эксперты Atlassian произведут быструю интеграцию Jira и Confluence, не отвлекая вас от рабочих процессов.
Наши авторы
Профессионалы, работающие с Sony, NASA, Сбербанк, МТС, Nokia и многими другими компаниями. Спикеры на конференциях, авторы статьей