У меня на курсах по тестированию REST API и автоматизации в Postman есть задание — получить задачу из Jira (метод Get issue) и вывести на консоль некие поля, например:
- флаг, является ли связанная задача сабтаском
- имя автора аттача
Так вот. Не все до этого работали с Jira, и уж тем более не щупали её api. Описание в целом неплохое, но там нет перечисления всех полей, которые возвращаются в ответе, с их описанием. Поэтому я немного поясню.
Что такое задача / подзадача
Jira — это баг-трекер. Туда заводят задачи на разработку или баги, найденные в процессе тестирования. Задачи бывают разных типов (задача, баг, epic, и так далее) и в документации называется общим словом issue. То есть баг — это тоже issue.
У задачи бывают подзадачи. Это дочерние задачи к текущей задаче. Сложно... Давайте на примере. Заказчик пришел и хочет переделать страницу отчетности. А для этого нужно:
- Сделать макет — его делает дизайнер.
- Разработать новый фронт по макету — это делает разработчик фронта.
- Доработать бекенд, если нужно — это уже другой разработчик делает.
Можно делать всё внутри одной задачи, но так легко запутаться — какой статус, кто сейчас работает над задачей, а кто нет? Поэтому проще разбить её на подзадачи, и для каждой сделать своего исполнителя.
В Jira есть возможность создавать подзадачи, выглядит это примерно так (внешний вид может меняться, jira постоянно развивается):
Термины
Так вот! Родительская задача — это task (с англ «задача», но так и говорят в разговорной речи — таск, таска). А подзадачи — subtask (сабтаск).
В api сама задача будет всё равно issue, а вот её дочки — subtask-и.
Любые вложения в задачу (файл, картинка...) — называются attach (в переводе «прикреплять», мы прикрепляем файл к задаче. В разговоре тоже так и говорят — аттач)
Ну и в каждой задаче есть большой набор полей — название, описание, автор, дата создания и прочая, прочая... И все они возвращаются в методе Get issue =)
Как найти нужное поле в API
Как понять, что ты нашел правильное поле? Да очень просто, ориентируйтесь на графический интерфейс:
1. Открыли задачу в графическом интерфейсе, открыли ответ от api (его можно скопировать и вставить в блокнот, например, но поиск будет и в постмане работать, в других инструментах наверное тоже).
2. В графическом интерфейсе посмотрели на нужное поле. Ну, скажем, название сабтаска.
3. Нашли его в ответе api через поиск
4. Посмотрели на теги вокруг — похоже на правду? Если результатов поиска несколько, то опираемся на теги, чтобы найти нужное место.
Ну и всё, вы нашли нужное поле! И даже без документации, которая подсвечивает, что именно вот это — некий флаг в сабтаске. Да, если просто искать флаг или «true», результатов будет много. Но можно же найти нужный сабтаск и посмотреть его поля:
- нашли по уникальному полю типа названия
- почитали теги вокруг
- нашли нужный по логике
Для этого достаточно уметь читать тело ответа и знать на школьном уровне английский. С английским поможет любой переводчик, а для чтения тела ответа вот полезные ссылочки:
Удачных поисков 😀
PS — статья написана в помощь студентам моих курсов по тестированию REST API и автоматизации в Postman
Мой муж развелся со мной без всякой причины, но я все еще люблю его и ищу помощи, чтобы вернуть его. Я сказала его сестре помочь мне умолять его, но он не послушал ее. Мой друг познакомил меня с заклинателем, который помог когда она переживала подобную ситуацию, я сначала отнесся к ней скептически, но отчаянно нуждался в помощи, поэтому связался с заклинателем, который смог примирить нас после 7 месяцев разлуки с помощью приворота. Если у вас проблемы в отношениях или браке, доктор Аджайи остановится у вас поздно, я говорю это, потому что я получил пользу от его великой работы. свяжитесь с WhatsApp +2347084887094 или по электронной почте: drajayi1990@gmail.com
ОтветитьУдалитьВсе спасибо вам, доктор Уэйл, я ценю то добро, которое вы сделали для всей моей семьи. Вы действительно лучший человек, чтобы вернуть улыбки на лица людей. Доктор Уэйл, ваша работа подлинная и настоящая. Если вы наткнетесь на это свидетельство и задаетесь вопросом, почему я хвалю этого человека, поверьте мне, этот человек лучший в решении всех проблем в отношениях и браке и т. д. Доктор Уэйл может починить разрушенный дом. Он был тем человеком, который помог мне наладить мой брак, который разваливался. Моя жена не ладила друг с другом, у нас всегда были проблемы, мы всегда воюем друг с другом, но с помощью доктора Уэйла мы теперь живем в мире как одна большая семья. Также не стоит забывать, что ДОКТОР УЭЙЛ помог нашей подруге семьи восстановить брак после того, как ее муж ушел к другой женщине. ДОКТОР УЭЙЛ был хорошим человеком, который помог вернуть ее мужа у подруги на стороне. ВЫ, читающие это сейчас, если у вас возникли проблемы с браком, здоровьем или другие супружеские проблемы, ДОКТОР УЭЙЛ — лучший человек, к которому можно обратиться, чтобы ваши переживания развеялись. Вы можете связаться с ним через WhatsApp/Viber/Telegram: +2347054019402 ИЛИ по электронной почте: drwalespellhome@gmail.com
ОтветитьУдалить