Настройки атрибутов и полей
Данный модуль предназначен для управление видимостью, возможностью редактирования, обязательностью, значениями по умолчанию и другими характеристиками встроенных (системных) и пользовательских атрибутов. Вы можете менять их порядок отображения и описание. Указанные настройки будут использоваться при отображении форм, списков и досок.
Кликните на названии поля, либо выберите поле для настройки в кнопке "Поля формы", расположенной слева внизу формы.
| Название настройки | Назначение настройки |
|---|---|
| Значение по умолчанию |
В качестве значения по умолчанию у ссылочных атрибутов можно указывать запрос поиска. Это позволяет выбрать значение по умолчанию, соответствующее некоторой логике работы приложения. Также, при помощи фигурных скобок можно использовать подстановку значений атрибутов связанных сущностей, по аналогии с тем, как задаются выражения для вычисляемых атрибутов. Пример выражения для формирования значения по умолчанию для поля Текст у требований:
Первое выражение возвращает содержание шаблона по умолчанию для типа требования. Если шаблон не задан, то вычисляется второе выражение: среди шаблонов текстов текущего проекта выбирается шаблон по умолчанию для требований и используется его содержание. |
| Ограничение |
Для ссылочных атрибутов вы можете указать запрос, который будет использоваться в качестве фильтра. Это можно использовать для ограничения выборки в выпадающих списках. Например, предлагать к выбору только текущие итерации, незавершенные сборки, требования только конкретных типов и т.п. В запросе, в качестве правого выражения можно использовать формулу. Система вычисляет формулу и полученное значение использует для формирования запроса на ограничение выборки. Таким образом, можно реализовать зависимость между полями на форме. Например, указав Тип задачи, ограничить выборку из возможных Исполнителей.
Здесь мы ограничиваем список Исполнителей на основе проектной роли исполнителя, которая должна соответствовать роли в проекте, заданной для типа задачи. Указали Тип задачи = Анализ, система покажет исполнителей с ролью, соответствующей данному типу задачи и т.д. |
| Регулярное выражение |
Чтобы потребовать от пользователя заполнять значение поля в строго определенном формате, используйте регулярные выражения. Регулярное выражение начинается с символа "^", обозначающего начало строки, и заканчивается символом "$", обозначающим окончание строки. Примеры регулярных выражений:
|
| Видимость (условие) | Если атрибут должен отображаться только при определенных значениях других полей, например, только если Тип = Ошибка, вы можете задать условие для видимости поля. Условием является запрос поиска. Если запрос поиска выполняется и возвращает пустое множество, то атрибут становится невидимым на форме, иначе, атрибут отображается. |
| Обязательность (условие) | По аналогии с Видимостью вы также можете управлять обязательностью заполнения поля, в зависимости от значений других полей, заданных на форме артефакта. |
Группы позволяют расширять метаданные атрибута, позволяя системе использовать атрибуты в различных частях интерфейса.
| Название группы | Назначение группы |
|---|---|
| trace | Атрибут отображается на вкладке "Трассировка" |
| deadlines | Атрибут отображается на вкладке "Сроки" |
| display-name | Значение атрибута подставляется в название проектного артефакта, отображаемое в ссылках |
| tooltip | Атрибут отображается на всплывающей подсказке, при наведении на ИД проектного артефакта |
| hours |
Значение атрибута представляет собой единицы времени, таким образом, в интерфейсе автоматически будет использовано представление в виде 2д 3ч и т.п. |
| alternative-key | Все атрибуты сущности с этой группой входят в альтернативный ключ. Такой ключ используется для определения уникальности записи, в том числе при импорте данных из Excel, чтобы обновить существующую запись, вместо ее создания. |
Основные настройки полей могут быть перекрыты настройками для конкретных состояний или переходов, которые задаются на формах состояний и переходов.
Полный перечень всех настроек, с возможность удаления и редактирования вы можете найти в модуле "Поля форм" в настройках проекта:
Вы можете разработать PHP-скрипт, который проверяет правильность заполнения поля, в зависимости от любых необходимых условий. Если условие выполняется, то скрипт должен вернуть true, если нет, то false. При сохранении карточки артефакта, либо изменении значения данного поля, система выполнит скрипт и проверит условие. В зависимости от результата, операция либо будет успешной, либо система сообщит о нарушении условия валидации для поля. Функциональность валидации доступна, при наличии лицензии модуля "Скриптовая автоматизация" и настроенных правах на этот модуль. Результаты работы скриптов можно отслеживать в Административном разделе, в модуле PHP-скрипты.
Идентификация проектных артефактов
Вы можете сформировать собственную схему идентификации артефактов, отличную от той, что используется в системе по умолчанию. Для этого необходимо открыть настройки атрибута "UID" и задать там формулу для вычисления значения по умолчанию.
В качестве формулы для вычисления идентификатора требования необходимо записать выражение по примеру из описания. Вот несколько вариантов пользовательской идентификации требований:
- {Тип требования.Краткое название,R}.{Id} - в начале ИД требования будет указано краткое название его типа, например, СТ.123
- {Тип требования.Краткое название,R}-{IdProject} - Значение поля "IdProject" заполняется автоматическим счетчиком в рамках проекта. В каждом проекте счетчик начинается с 1. Таким образом, вы можете получить такие идентификаторы: БТ-1, СТ-2 и т.п.
- {Тип требования.Краткое название,R}-{IdType} - Значение поля "IdType" заполняется счетчиком для каждого типа требования. Таким образом, вы можете получить такие идентификаторы: БТ-1, СТ-1 и т.п.
- {Тип требования.Краткое название,R}-{IdHierarchy} - Значение поля "IdHierarchy" заполняется счетчиком в рамках иерархии (документа), то есть счетчик будет увеличиваться для каждого следующего дочернего элемента внутри документа.
- {Тип требования.Краткое название,R}-{IdParent} - Значение поля "IdParent" заполняется счетчиком в рамках родительского раздела, то есть счетчик будет увеличиваться для каждого следующего дочернего элемента внутри одного раздела.
Вы можете формировать идентификатор с использованием дополняющих нулей, например, задав выражение {Id,6} система будет формировать идентификатор в виде 000001, 000002 и т.д.