Что обозначает связь mentioned in
Связывание задач
Связывание задач (Issue linking) позволяет создать связь между двумя существующими задачами на одном или разных серверах JIRA. Например:
(Ваш администратор JIRA может настраивать типы связей, которые вам потребуется создать.)
Связывание задач также позволяет:
Связи задачи в пределах задачи выглядят следующим образом:
Скриншот: раздел «Связи задачи» (Issue Links) в пределах задачи
Примечание: Решенные задачи (то есть задачи с установленной резолюцией) отображаются зачеркнутым шрифтом, например, DEMO-1.
Создание связи между задачами, находящимися на одном и том же сайте JIRA
Для того, чтобы создать связь между задачами, находящимися на одном и том же сайте JIRA, необходимо выполнить следующие шаги:
1. Откройте задачу, которую вы хотите связать с другой задачей на том же сайте JIRA.
2. Выберите «Дополнительно» (More)> «Связь» (Link), чтобы отобразить диалоговое окно «Связь» (Link).
Комбинация клавиш ‘.’ + Начать вводить ссылку
3. Убедитесь, что элемент «Задача JIRA» (JIRA Issue) выбран в левой части диалогового окна, а затем выберите тип связи из раскрывающегося списка «Эта задача» (This issue).
Если ваш системный администратор JIRA настроил полностью взаимные связи приложений между сайтом JIRA и другим сервером, выпадающий список «Сервер» (Server) может появиться над списком «Эта задача» (This issue). Если это так, убедитесь, что ваш сайт JIRA появился или был выбран из списка серверов.
4. В поле «Задачa» (Issue) укажите задачу(и), связанную с вашей просматриваемой / выбранной задачей. Есть два способа сделать это:
Если вы ранее просматривали задачу, вы можете быстро найти эту задачу, введя первые несколько букв ключа задачи (или часть резюме), которые будут отображаться в раскрывающемся списке «автозаполнение» для выбора.
5. Необязательно: добавьте комментарий (Comment), чтобы описать, почему вы связываете эти задачи.
6. Нажмите кнопку «Связь» (Link) в нижней части диалогового окна.
Создание связи между задачами, находящимися на разных сайтах JIRA
Чтобы создать этот тип связи, системный администратор JIRA должен был настроить полностью взаимные связи приложений между сайтом JIRA и другим сайтом JIRA, содержащим задачи, с которыми вы хотите установить связь.
Эта функция недоступна в Облаке Atlassian
Для того, чтобы создать связь между задачами, находящимися на разных сайтах JIRA, выполните следующие шаги:
1. Откройте задачу, которую вы хотите связать с другой задачей.
2. Выберите «Дополнительно» (More)> «Связь» (Link), чтобы отобразить диалоговое окно «Связь» (Link).
комбинация клавиш: ‘.’ + Начать вводить ссылку
3. Убедитесь, что элемент «Задача JIRA» (JIRA Issue) выбран в левой части диалогового окна.
Примечание:
Это поведение означает, что связки на приложения, настроенные между вашим сайтом JIRA и удаленным сайтом JIRA, используют аутентификацию OAuth.
4. Если ваш сайт JIRA подключен к нескольким удаленным сайтам JIRA, выберите соответствующий сайт JIRA из раскрывающегося списка «Сервер» (Server).
5. Выберите тип связи из раскрывающегося списка «Эта задача» (This issue).
6. Введите в поле «Задача» (Issue) ключ задачи, находящейся на удаленном сайте JIRA, на которую вы хотите установить ссылку. Кроме того, вы можете искать задачи, находящиеся на удаленном сайте JIRA, нажав на ссылку «поиск задачи» (search for an issue), которая открывает всплывающее окно «Найти задачи JIRA» (Find JIRA issues).
Вы можете ссылаться на любую задачу на удаленном сайте JIRA, к которой у вас есть доступ на этом сайте.
7. Установите флажок «Создать взаимную связь» (Create reciprocal link), чтобы создать дополнительную связь на удаленную задачу, на которую вы ссылаетесь, назад к вашей задаче. Например, если вы создаете тип связи блоков для удаленной задачи, то обратная связь, сгенерированная при удаленной задаче, будет заблокирована по типу связи обратно к вашей локальной задаче.
8. Необязательно: добавьте комментарий (Comment), чтобы описать, почему вы связываете эти задачи.
9. Нажмите кнопку «Связь» (Link) в нижней части диалогового окна.
Исправление проблем
Проблема: Если вы выбрали флажок «Создать взаимную связь» (Create reciprocal link), но после нажатия кнопки «Связь» (Link) выяснилось, что обратная связь с удаленной задачи JIRA на вашу задачу JIRA не была создана. Скорее всего, ваш системный администратор JIRA создал только одностороннюю связь с вашего сайта JIRA на удаленный сайт JIRA.
Решение: Попросите администратора системы JIRA полностью настроить взаимные связи приложений между сайтом JIRA и удаленным сайтом JIRA.
Проблема: Допустим, вы попытались создать обратную связь, но получили следующее сообщение:
«Взаимная связь задачи « XYZ-123 » с этой задачей не была создана, так как удаленный сервер JIRA возвратил следующую ошибку: No Link Issue Permission (Нет разрешения связи на задачу) для задачи« XYZ-123 ». (Где «XYZ-123» является ключом к задаче на удаленном сайте JIRA),
потому что взаимная связь на удаленном сайте JIRA не будет создана, так как учетная запись пользователя, с помощью которой вы прошли аутентификацию на удаленном сайте JIRA (см. выше: шаг 3), не имеет разрешения проекта «Связывание задач».
Решение (Solution):
Если вы не запрашиваете аутентификацию во время авторизации, сначала попробуйте очистить файлы cookie браузера и повторите процедуру еще раз.
Создание связи со страницей Confluence
Чтобы создать этот тип ссылки, системному администратору JIRA необходимо настроить ссылку приложения между сайтом JIRA и сайтом Confluence, содержащим страницы, на которые вы хотите установить ссылку.
Для того, чтобы создать связь со страницей Confluence, выполните следующие шаги:
1. Откройте задачу, которую вы хотите связать с другой задачей.
2. Выберите «Дополнительно» (More)> > (Link), чтобы отобразить диалоговое окно «Связь» (Link).
Комбинация клавиш: ‘.’ + Начать вводить ссылку (Link)
3. Нажмите опцию «страница Confluence» (Confluence Page) в левой части диалогового окна.
Этот опция недоступна, если системный администратор JIRA не настроил связь на приложение между сайтом JIRA и сайтом Confluence.
4. Если между сайтом JIRA и другими сайтами Confluence настроено несколько связей на приложения, выберите подходящий сайт Confluence из выпадающего списка «Сервер» (Server).
5. Укажите страницу Confluence, которая будет связана с вашей просматриваемой задачей. Есть два способа сделать это:
Если вам будет предложено получить авторизацию, вам может потребоваться войти на сайт Confluence, который позволит вашему сайту JIRA получить доступ к сайту Confluence от имени вашей учетной записи на сайте Confluence.
Это поведение означает, что связь на приложения, настроенные между вашим сайтом JIRA и удаленным сайтом Confluence, используют аутентификацию OAuth.
6. Необязательно: добавьте комментарий (Comment), чтобы описать, почему вы связываете эти задачи.
7. Нажмите кнопку «Связь» (Link) в нижней части диалогового окна.
Исправление проблем
. Проблема: Если связь со страницей Confluence, которую вы создаете, показывает: «Не удалось загрузить задачу JIRA» или, если вы попытались найти страницу Confluence, но получили следующее сообщение:
«Не удалось получить доступ к контенту на сайте Confluence, потому что функция «Удаленный API» сервера Confluence отключена». Системный администратор Confluence должен включить эту функцию «Удаленный API» для успешного доступа JIRA к этому контенту».
в результате JIRA не смогла связаться с сервером Confluence:
Решение:
Попросите администратора системы Confluence включить функцию удаленного API (XML- RPC и SOAP) (Remote API (XML-RPC & SOAP), поскольку эта функция Confluence по умолчанию отключена. Подробнее см. «Включение удаленного API» в документации Confluence.
Создание связи с любой URL веб-страницей
Для того, чтобы создать связь с любой URL веб-страницей, выполните следующие шаги:
1. Откройте задачу, которую вы хотите связать с другой задачей.
2. Выберите «Дополнительно» (More)>«Связь» (Link), чтобы отобразить диалоговое окно «Связь» (Link).
Комбинация клавиш: ‘.’ + Начать вводить ссылку (Link)
3. Нажмите опцию «Веб-связь» (Web Link) в левой части диалогового окна.
4. Укажите URL- адрес веб-страницы, с которой вы хотите установить связь.
5. Укажите текст связи (Link Text), который будет отображаться в разделе «Связи задачи» (Issue Links) на странице «Просмотр задачи» (View Issue) и будет связан с гиперссылкой на ваш URL-адрес.
6. Необязательно: добавьте комментарий (Comment), чтобы описать, почему вы связываете эти задачи.
7. Нажмите кнопку «Связь» (Link) в нижней части диалогового окна.
Удаление связи
Для того, чтобы удалить связь с задачей в пределах задачи, выполните следующие шаги:
Поиск связанных задач
Вы можете искать задачи, связанные с конкретной задачей. Для получения дополнительной информации, см. документацию по расширенному поиску.
Помните, что эта функция не распространяется на задачи на удаленном сервере JIRA.
Поиск задач в JIRA (простым языком). Часть 2: Продвинутый поиск
Структуру JQL-запросов без примеров сложно понять специалистам, не знакомым ранее с JIRA.
Мы уже успели рассказать про быстрый и базовый поиск. Теперь же прейдем к самому мощному из трех методов — к продвинутому поиску.
В этом режиме вы можете указывать критерии, которые нельзя задавать в остальных предыдущих двух режимах (например, сортировку ORDER BY). Но придётся освоить создание структурированных запросов с помощью JIRA Query Language (JQL).
А если вы находитесь в режиме «базового» поиска, нажмите кнопку «Продвинутый»
1. Создание JQL-запросов
Простейший запрос на JQL состоит из поля, за которым следует оператор, а затем одно или несколько допустимых значений для этого поля. Например:
Такой запрос поможет найти все задачи проекта «YAT». Здесь использовано поле «project», оператор эквивалента «=» и допустимое значение «YAT».
Более сложный запрос может выглядеть так:
project = «YAT» AND assignee = currentuser()
Так мы отберём все задачи проекта «YAT», назначенные на текущего пользователя
(то есть на вас). В запросе содержатся: логический оператор «AND», поле «assignee» для отбора задач по текущему пользователю, оператор эквивалента «=» и функция «currentuser()», возвращающая имя текущего пользователя системы.
При создании запроса в режиме «продвинутого» поиска JIRA показывает список всех возможных операторов для поля запроса.
Также JIRA показывает список доступных значений для полей «AffectedVersion«, «FixVersion«, «Components«, кастомных полей формата «Version» и выпадающих списков.
При использовании в поиске полей формата «User» JIRA позволяет найти необходимого пользователя по его фамилии.
Вы можете использовать круглые скобки в сложных JQL-запросах. Например, если хотите найти все разрешенные задачи в проекте «SysAdmin», а также все задачи (любого статуса, любого проекта), назначенные в настоящее время системному администратору (admin), то можете использовать круглые скобки, обозначая приоритет логических операторов в запросе.
(project=SysAdmin AND status=resolved) OR assignee=admin
В JQL есть зарезервированные символы.
Внимание!
Также в JIRA есть зарезервированные слова.
Если в тексте поиска упомянуто одно из перечисленных ниже слов, этот текст нужно выделить либо двойными кавычками («. «), либо одинарными (‘. ‘).
Список зарезервированных слов:
| A | «abort», «access», «add», «after», «alias», «all», «alter», «and», «any», «as», «asc», «audit», «avg» |
| B | «before», «begin», «between», «boolean», «break», «by», «byte» |
| C | «catch», «cf», «char», «character», «check», «checkpoint», «collate», «collation», «column», «commit», «connect», «continue», «count», «create», «current» |
| D | «date», «decimal», «declare», «decrement», «default», «defaults», «define», «delete», «delimiter», «desc», «difference», «distinct», «divide», «do», «double», «drop» |
| E | «else», «empty», «encoding», «end», «equals», «escape», «exclusive», «exec», «execute», «exists», «explain» |
| F | «false», «fetch», «file», «field», «first», «float», «for», «from», «function» |
| H | «having» |
| I | «identified», «if», «immediate», «in», «increment», «index», «initial», «inner», «inout», «input», «insert», «int», «integer», «intersect», «intersection», «into», «is», «isempty», «isnull» |
| J | «join» |
| L | «last», «left», «less», «like», «limit», «lock», «long» |
| M | «max», «min», «minus», «mode», «modify», «modulo», «more», «multiply» |
| N | «next», «noaudit», «not», «notin», «nowait», «null», «number» |
| O | «object», «of», «on», «option», «or», «order», «outer», «output» |
| P | «power», «previous», «prior», «privileges», «public» |
| R | «raise», «raw», «remainder», «rename», «resource», «return», «returns», «revoke», «right», «row», «rowid», «rownum», «rows» |
| S | «select», «session», «set», «share», «size», «sqrt», «start», «strict», «string», «subtract», «sum», «synonym» |
| T | «table», «then», «to», «trans», «transaction», «trigger», «true» |
| U | «uid», «union», «unique», «update», «user» |
| V | «validate», «values», «view» |
| W | «when», «whenever», «where», «while», «with» |
2. Использование шаблонов для поиска по тексту
Специальные символы могут быть использованы для определения шаблонов поиска по тексту. Рассмотрим несколько примеров:
| Знак | Область применения и описание | Пример |
|---|---|---|
| ? | «?» используется для замены одного символа в шаблоне. Например, написание слов «text» и «test» отличается одним символом. Для поиска обоих вариантов достаточно задать шаблон: te?t | summary |
«te?t»
нуля или нескольких символов. Например, для отбора текста
«Windows», «Win95» или «WindowsNT» можно использовать
шаблон: win*
Для отбора текста «Win95» или «Windows95»
можно использовать шаблон: wi*95
» может быть использована для задания
нечетких поисковых шаблонов. В этом случае символ «
»
подставляется в конце нужного слова. Например,
чтобы найти термин, орфографически похожий на «roam»,
используйте шаблон: roam
В результате могут быть найдены слова «foam» или «roams».
3. Логические операторы JQL
| Оператор | Описание | Пример |
|---|---|---|
| AND | Логическая операция «И», соединяющая два или несколько условий. Используется для уточнения условий отбора. | project = «YAT» and status = «Оpen» — отобрать все задачи проекта «YAT» в статусе «Open» |
| OR | Логическая операция «ИЛИ», соединяющая два или несколько условий. | reporter = demo_1 or reporter = demo_2 — отобрать все задачи проекта, автором которых является пользователь demo_1 или пользователь demo_2. |
| NOT | Для реверсирования результата логического условия. | not assignee = demo_1 — отобрать все задачи, исполнителем которых не является пользователь demo_1. |
| ORDER BY | Сортировать по. |
По умолчанию будет использоваться собственный порядок,
применяемый для этого поля. Вы можете переопределить направление сортировки —
по возрастанию («asc») или убыванию («desc»).
отобрать все задачи, у которых пустые поля «Due date» (Срок исполнения),
отсортировать результаты выборки по полю «Created» (Создано).
duedate = empty order by created, priority desc —
отобрать все задачи, у которых пустые поля «Due date» (Срок исполнения),
отсортировать результаты выборки по полю «Created» (Создано)
в собственном порядке, затем по полю «Priority» (Приоритет)
в убывающем порядке.
| Оператор | Описание | Пример |
|---|---|---|
| = | Эквивалент. |
Используется для задания
критерия полного соответствия.
либо можно использовать запись
NOT reporter = demo_1
Используется для создания выражений
с полями формата «Version»,
формата дата-время и числовых полей.
duedate > now()
Используется для создания выражений
с полями формата «Version»,
формата дата-время и числовых полей.
duedate >= «2008/12/31»
created >= «-5d»
currentLogin()
Внимание
Самая ранняя не выпущенная версия определяется порядком, а не датами.
Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях»), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
Unreleased
Version(project)
earliestUnreleased
Version
(ABC)
fixVersion =
earliestUnreleased
Version
(ABC)
Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата даты-времени.
где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).
Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 день.
Внимание
Самая последняя выпущенная версия определяется порядком, а не датами.
fixVersion =
latestReleased
Version(ABC)
Внимание
LinkType чувствителен к регистру.
(issueKey)
linkedIssues
(issueKey,linkType)
(ABC-123,
«is duplicated by»)
Используется для создания выражений с полями «Reporter» (Автор), «Assignee» (Исполнитель), «Voter», «Watcher» и кастомными полями формата «User».
(Group)
in membersOf(QA)
Для отбора задач JIRA Service Desk, требующих согласования текущего пользователя или уже согласованных текущим пользователем.
Применяется к полям типа «Approvals».
myApproval()
Для отбора задач JIRA Service Desk, требующих согласования текущего пользователя.
Применяется к полям типа «Approvals».
myPending()
created >
startOfDay
(«-3d») – задачи,
созданные за
последние три дня.
Month()
Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата дата-время.
где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).
Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 месяц.
created > startOfMonth
(«+14d») — задачи,
созданные с пятнадцатого
числа текущего месяца.
Week()
Используется в выражениях с полями
«Created» (Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата даты-времени.
где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).
Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 неделя.
created >
startOfWeek
(«-1») — задачи,
дата создания которых
старше начала
прошлой недели.
Year()
Используется в выражениях с полями
«Created»
(Создано),
«Due Date»
(Срок исполнения),
«Resolved»
(Дата решения),
«Updated» (Обновлено), кастомными полями формата дата-время.
где inc —
опциональный
инкримент
(±)nn(y|M|w|d|h|m).
Если спецификатор единицы
измерения времени опущен,
по умолчанию используется
естественный период функции,
т. е. 1 год.
created >
startOfYear
(«-1») — задачи,
дата создания
которых старше
начала прошлого года.
IssueTypes()
IssueTypes()
subtask
IssueTypes()
Versions()
Применяется для создания выражений с полями «AffectedVersion» (Проявляется в версиях), «FixVersion» (Исправлено в версиях), кастомными полями формата Version.
используется
для отбора задач
по всем проектам.
unreleased
Versions
(project)
unreleased
Versions(ABC)
Issues()
votedIssues()
Issues()
watchedIssues()
Надеюсь, что разбор продвинутого режима поможет вам при поиске задач.
Пользуйтесь и не теряйтесь 😉