Jira и Confluence — широко используемые инструменты в области управления проектами и разработки программного обеспечения. Jira известна своими возможностями отслеживания проблем, а Confluence — это рабочее пространство для совместной работы для обмена и организации информации, связанной с проектом. Одним из распространенных требований является создание таблицы в Confluence, которая отображает дочерние задачи из Jira. В этой статье мы рассмотрим несколько способов достижения этой цели, а также приведем примеры кода.
Метод 1: макрос задачи Jira
Confluence предоставляет встроенный макрос задачи Jira, который можно использовать для отображения дочерних задач в формате таблицы. Просто добавьте макрос на свою страницу Confluence и настройте его для отображения дочерних задач из конкретного проекта Jira или фильтра. Вот пример использования макроса:
{jiraissues:project=PROJKEY |columns=key,summary,assignee,duedate}
Метод 2: REST API Jira
Если вы предпочитаете большую гибкость и возможности настройки, вы можете получить дочерние задачи с помощью REST API Jira, а затем отформатировать данные в таблицу в Confluence. Вот пример использования Python и библиотеки requests
:
import requests
jira_url = 'https://your-jira-instance/rest/api/2/search'
jira_user = 'your-username'
jira_pass = 'your-password'
params = {
'jql': 'project = PROJKEY AND parent is not EMPTY',
'maxResults': 50
}
response = requests.get(jira_url, auth=(jira_user, jira_pass), params=params)
data = response.json()
table = '| Key | Summary | Assignee |\n|-----|---------|----------|\n'
for issue in data['issues']:
key = issue['key']
summary = issue['fields']['summary']
assignee = issue['fields']['assignee']['displayName']
table += f'| {key} | {summary} | {assignee} |\n'
# Now you can insert the 'table' variable into your Confluence page using appropriate Confluence API or tools.
Метод 3: Язык запросов Jira (JQL)
Язык запросов Jira (JQL) позволяет выполнять расширенные запросы для поиска проблем на основе различных критериев. Вы можете использовать JQL для фильтрации и отображения дочерних проблем в Confluence. Вот пример запроса JQL, который извлекает дочерние проблемы для конкретной родительской проблемы:
project = PROJKEY AND parent = PARENT-KEY
Просто замените PROJKEY
на ключ вашего проекта Jira и PARENT-KEY
на ключ родительской задачи.
Создание таблицы дочерних задач Jira Confluence можно выполнить различными методами. Встроенный макрос Jira Issue обеспечивает простое и быстрое решение, а Jira REST API и JQL предлагают больше гибкости и возможностей настройки. Выберите метод, который лучше всего соответствует вашим требованиям, и легко интегрируйте его в рабочий процесс управления проектами.