Связь кода и задач

Ручное прикрепление веток и запросов на слияние к задачам

1. Создайте новую задачу, в рамках которой будет разработана фича.

2. Перейдите в раздел репозитория Код, создайте новую ветку для разработки фичи, внесите в нее изменения. Далее создайте из данной ветки запрос на слияние.

3. Связать уже существующую задачу и запрос на слияние можно двумя способами:

   • на странице Задачи в блоке Разработка выберите созданный ранее запрос(ы) на слияние и привяжите его к задаче. При этом автоматически привяжется и соответствующая ветка;
   • на странице Запроса на слияние в блоке Задачи выберите созданную ранее задачу(и) и привяжите ее к запросу. Привязать задачу к запросу можно в процессе создания запроса или после создания.

Автоматическое прикрепление веток и запросов на слияние к задачам

1. Перейдите в настройки репозитория, в разделе настроек «Задачи» включите функциональности:

   • автоприкрепление по названию ветки;
   • автоприкрепление по названию запроса на слияние.

2. Создайте еще одну задачу. Запомните код созданной задачи — его можно взять из адресной строки браузера, находясь на странице Задачи. Он будет иметь вид TSKSTR-007.

   Создайте в разделе «Код» еще одну ветку и укажите в ее имени код задачи. Например, feature_TSKSTR-007. Создайте запрос на слияние данной ветки с веткой master. При создании запроса обратите внимание, что имя запроса на слияние по умолчанию содержит в себе имена сливаемых веток, и, как следствие в данном случае, — код задачи. Не меняйте имя запроса на слияние.

   После успешного создания запроса на слияние перейдите к созданной ранее задаче TSKSTR-007. Обратите внимание, что в блоке Разработка автоматически прикреплены созданная ветка и запрос на слияние.

Использование регулярных выражений в коммитах для автоматического прикрепления

1. Перейдите в настройки репозитория, в разделе настроек Задачи включите функциональность Автоприкрепление по сообщению коммита. Обратите внимание, что появилось поле ввода маски кода задач в коммитах — Регулярное выражение для автоприкрепления. Данное поле позволяет вызвать окно со справочной информацией, а также примеры шаблонов маскирования кодов задач в сообщениях коммитов. Из приведенных примеров примените вариант \w+/{taskCode}, обратите внимание что, поле для регулярного выражения заполнилось указанным примером. Сохраните изменения.

2. Создайте новую задачу в данном репозитории. Запомните код созданной задачи, его можно взять из адресной строки браузера, находясь на странице задачи. Он будет иметь вид TSKSTR-010

3. Перейдите в раздел Код, создайте новую ветку для разработки фичи, произведите в ней нужные наработки. Название ветки не имеет значения. При фиксации изменений укажите в качестве сообщения коммита следующую строку Refactoring f/TSKSTR-010, где TSKSTR-010 — код задачи, взятой из предыдущего шага. Зафиксируйте изменения.

4. Вернитесь на страницу задачи TSKSTR-010, обратите внимание, что ветка привязалась автоматически. Создайте запрос на слияние данной ветки и ветки master. Название запроса на слияние не имеет значения. Вернитесь в задачу, обратите внимание, что вновь созданный запрос на слияние также прикреплен к задаче