Redmine

h1. Отслеживание задач

Оригинал: [[RedmineIssues|RedmineIssues v.28]]

{{>toc}}

Заведение и отслеживание задач является основной областью действий Redmine. Задача привязана к определенному проекту, принадлежит определенному пользователю, может быть связана с определенной версией и т.д.

h2. Просмотр задач

На странице просмотра задачи вы можете увидеть текущее состояние работы над задачей и что уже сделано в процессе решения задачи. Сообщения отображаются в хронологическом порядке, начиная от самых старых и заканчивая самыми новыми. Можно цитировать сообщения других, а также редактировать свои.

h3. Связанные задачи

Связывание задач позволяет разработчикам избавиться от дублированных задач путем их объединения друг с другом, либо обозначить последовательность решения задач.

При связывании задач можно установить различные варианты отношений. На данный момент они следующие:

* *связана с* - Просто добавляет ссылку на другую задачу

* *дублирует* - Связывает задачи так, что при закрытии задачи оригинала - будет закрыта и задача дубликат

     Например, если задача B *дублирует* задачу A:

     - закрытие B оставит A открытой

     - закрытие A автоматически закроет B

* *дублируется* - Обратное от *дублирует*

     Например, если задача A *дублируется* задачей B:

     - закрытие B оставит A открытой

     - закрытие A автоматически закроет B

* *блокирует* - Связывает задачи так, что закрытие блокированной задачи невозможно, пока не будет закрыта задача-блокиратор

     Например, если задача B *блокирует* задачe A,

     A не сможет быть закрыта, пока не закрыта B.

* *блокируется* - Обратное от *блокирует*

* *предыдущая* - Связывает задачи, определяя порядок их выполнения, где задача A должна быть завершена за x дней до того как задача B должна быть запущена

     Например, если задача A *предыдущая* задаче B, 

     вы не сможете установить дату начала 

     задаче B равную или меньше

     дате окончания задачи A.

* *следующая* - Обратное от *предыдущая*

     Например, если задача B *следующая* задаче A (например A заканчивается 21.04, а B начинается 22.04)

     и вы устанавливаете +2 дня к окончанию задачи А,

     то даты начала и окончания задачи B сдвинуться на +2 дня тоже.

!rus_redmine-related-issues.png!

Администраторы могут установить [[RusRedmineRoles#Права-доступа|Права доступа]] пользователей для добавления и редактирования таких отношений.

h3. Наблюдатели

Показать список всех пользователей, которые следят за этой задачей. При обновлении задачи, данным пользователям будут разосланы уведомления.

Если вы администратор проекта, к которому привязана задача, то вы можете редактировать список наблюдателей. Чтобы добавить пользователя в список, необходимо нажать на ссылку "Добавить" и в появившейся форме из выпадающего списка выбрать пользователя и нажать на кнопку "Добавить" ниже.

!rus_redmine-watchers.png!

Администраторы могут установить [[RusRedmineRoles#Права-доступа|Права доступа]] пользователей, чтобы добавлять/удалять наблюдателей.

h3. Связанные редакции

Если администратор указал [[RedmineSettings#Referencing-issues-in-commit-messages|Ключевые слова для поиска]], то при использовании разработчиком этих слов или слова комментарий к коммиту будет отображен на странице задачи в блоке Связанные редакции (в основном справа от первого ответа).

!redmine-associated-revision.png!

h2. Adding a new issue

People can create a new issue when they meet the [[RedmineRoles|roles and permissions]] configured by the Redmine Administrator ([[RedmineRoles#Permissions|Role: Issue Tracking > Add Issues]]).

When creating a new issue, one of the most important items is the [[RedmineIssueTrackingSetup#Trackers|tracker field]], which defines the nature of the issue. By default, Redmine comes with three different trackers: _bug_, _feature_, and _support_.

h2. Updating an existing issue

(TODO: describe and upload a screen-shot of update panel)

To edit the issue, Click _Update_ link (having a pencil icon) at the top or the bottom of the issue page:

!RedmineEditIssue_Update_Link.png!

Depending you your role permissions (see [[RedmineRoles|roles and permissions]]), you will see a complete or a limited set of editable issue properties.

h2. Editing an existing issue's Subject or Description

In order to edit an existing issue, your role has to have the [[RedmineRoles#Permissions|Issue Tracking > Edit Issues]] right in the the [[RedmineRoles|roles and permissions]] configuration. 

This right gives you a _(More)_ link after the Change Properties section title in the "Update issue" panel.

# Open the issue

# Click _Update_ link (having a pen icon) at the top or the bottom of the issue page. 

# See *Change properties* dialog with the _(More)_ link (see a screenshot below).

# Clicking on the _(More)_ link will bring-up an editable copy of the Subject and Description of the issue.

p=. !RedmineEditIssue_More_Link_new_location.png!

h2. Subtasks

Subtasks (#443) are introduced in Redmine version#14. They are integrated in r3573, r3574, r3576, r3577 and refined in r3618. They are fixed in r3593, r3633, r3677 and r4061.

Subtask related changes for Parent issues are made in r3617, r3671, r3821 and r3869.

You can [[RedmineIssues#Updating-an-existing-issue|update an issue]] and access the [[RedmineIssues#Editing-an-existing-issues-Subject-or-Description|"More"-link]] to (re)set the "Parent task" field. This can be used to "convert" a normal issue into a subtask, move a subtask from one parent to another, or convert a subtask to a normal issue.

TODO, extend (please keep the revision info above for referencing while this TODO is current).