Метки и комментарии
Метки и комментарии
Назначение
Сервис обеспечивает маркировку объектов тегами и обсуждение рабочих вопросов прямо в карточках системы. Включает теги (Tag) и комментарии (Comment) в Dinext, а также расширение комментариев .
Цели и задачи
- Прикреплять теги к документам для категоризации и фильтрации.
- Обсуждать документ в разделе комментариев в карточке.
- Разделять комментарии на внутренние и видимые клиенту (при поддержке).
- Упоминать пользователей (@user) для привлечения внимания.
- Использовать расширенные возможности комментариев при установке.
Для кого
- Все пользователи, работающие с документами и обсуждениями.
- Сотрудники поддержки (комментарии по обращениям, видимость клиенту).
- Руководители и участники проектов при обсуждении задач и решений.
- Администраторы при настройке тегов и прав на комментарии.
Основные понятия
- Тег (Tag) — метка для группировки и поиска документов; один документ может иметь несколько тегов.
- Комментарий (Comment) — запись в ленте обсуждения документа; может быть тип «Комментарий» (внутренний) или «Информация для клиента» (shared) в зависимости от версии.
- Упоминание (@user) — привлечение внимания пользователя; он может получить уведомление о комментарии.
- Dinext — расширение комментариев (редактирование, ответы, форматирование и т.д. по README приложения).
Основные сущности / объекты
- Tag — теги.
- Comment — комментарии в карточках.
- Dinext — расширение комментариев (README).
Основные сценарии / процессов
Добавление тегов к документу
- Открыть документ; в области тегов (или в форме) нажать «Добавить тег».
- Выбрать существующий тег из списка или ввести новый (если разрешено создание тегов).
- Сохранить; документ будет находиться по фильтру по этому тегу в списках.
- Использовать теги для группировки (срочно, клиент X, проект Y и т.д.).
Написание комментария
- В карточке документа открыть раздел «Комментарии» или «Обсуждение».
- Ввести текст; при необходимости упомянуть пользователя (@имя_пользователя).
- Выбрать тип: только для внутренних или «Shared»/«Для клиента», если комментарий должен быть виден на портале.
- Отправить; комментарий появится в ленте и при настройке может отправить уведомление упомянутому пользователю.
Работа с расширенными комментариями
- При установленном приложении доступны дополнительные возможности: ответ на комментарий, редактирование, форматирование и т.д. .
- Использовать их по тем же сценариям обсуждения документов.
Правила и ограничения
- Право на добавление комментариев обычно следует из права на чтение документа; право на удаление/редактирование своих комментариев может быть ограничено.
- Теги могут быть общими для всех или создаваться только администратором в зависимости от настроек.
- Комментарии, помеченные как видимые клиенту, отображаются в портале заказчика по связанному документу (например, Issue); не размещайте в них внутреннюю информацию.
Результаты / отчетность
- Лента комментариев по документу с датой и автором.
- Список документов с фильтром по тегу.
- Уведомления упомянутым пользователям при настройке.
Типовые вопросы и ошибки (FAQ)
Как сделать комментарий видимым заказчику?
В форме комментария выбрать тип «Shared» или «Информация для клиента» (формулировка зависит от версии). Такие комментарии отображаются в портале по обращению/документу.
Кто может создавать новые теги?
Зависит от настроек: в некоторых конфигурациях любой пользователь с правом на теги может создавать тег при вводе нового имени; в других создание тегов ограничено администратором. Проверьте права на тип документа Tag.
Почему упомянутый пользователь не получил уведомление?
Убедитесь, что в системе настроено уведомление на событие «Comment» или «Mention» и что канал доставки (email или система) доступен. Проверьте настройки уведомлений и профиль пользователя.