Attribute Composer

Что это и зачем

Многие атрибуты в проекте требований не несут новой информации: они в фиксированном виде повторяют то, что у артефакта уже есть. Короткая метка из идентификатора и приоритета, заголовок, повторяющий название раздела, ключ с типом артефакта, копия текста требования в виде простого текста для отчёта или выгрузки. Сегодня такие поля заполняют вручную, артефакт за артефактом, либо оставляют пустыми, потому что ни у кого нет на это времени.

Attribute Composer заполняет их за один прогон. Вы один раз собираете правило (части значения и их порядок), а виджет записывает результат в выбранный атрибут для всех артефактов модуля или только для выделенных, предварительно показав, что именно получит каждый артефакт.

Какие задачи решает

• Атрибуты, которые должны следовать соглашению об именовании («ID / Приоритет / Имя») и расходятся при ручном вводе.
• Поля, остающиеся пустыми у тысяч артефактов, потому что заполнять их по одному нереально.
• Текст требования, нужный как простой текст в отдельном атрибуте, для выгрузок, отчётов или внешних инструментов.
• Дважды введённые значения: изменение исходного атрибута никогда не доходит до копии.
• Невозможность увидеть до сохранения, что на самом деле запишет массовое обновление.

Преимущества

• Одно правило на целый модуль: части в выбранном вами порядке: атрибуты любого типа, имя, идентификатор, тип артефакта, текст требования как простой текст и ваш собственный текст, например разделители.
• Предварительный просмотр до записи: каждый артефакт с текущим и новым значением рядом.
• Безопасно по умолчанию: заполняются только пустые атрибуты, пока вы не попросите перезапись; пустой результат никогда не записывается, а уже верное значение не сохраняется повторно.
• Аккуратный результат: пустая часть уходит вместе со своим разделителем, поэтому «ID / / Имя» не получится.
• Многоразовые правила: их можно сохранить под именем и загрузить снова, когда та же задача повторится.
• Подтверждение: отчёт об изменениях в Excel перечисляет каждый артефакт со значением до и после.

Как пользоваться

1. Откройте модуль в DOORS Next. В разделе Rule нажмите Change и выберите Target attribute: текстовый атрибут, числовой, если значение — число, атрибут-перечисление, если значение — одна из его меток, атрибут да/нет или даты либо имя артефакта.
2. Соберите значение в Parts, in order кнопками Add attribute и Add text: каждая часть — это атрибут, имя, идентификатор, тип артефакта, текст требования как простой текст или ваш собственный текст, например разделитель. Переставляйте части стрелками; строка под ними показывает получившееся правило.
3. Оставьте включенными или выключите Skip empty parts и Only fill empty targets (если выключить, существующие значения перезаписываются), выберите Artifact type, если меняться должен только один тип, и нажмите Done.
4. В разделе Write выберите Whole module или Selection (артефакты, выделенные в DOORS Next) и нажмите Find. Список показывает новое значение каждого артефакта, который изменится; в раскрытой строке видны атрибут, текущее и новое значение и Show in module.
5. Нажмите Write, прочитайте подтверждение и нажмите Write N values. По окончании блок результата показывает, сколько значений записано, уже были верными, пропущено или не удалось записать; Log скачивает отчет об изменениях в Excel, а неудачные артефакты можно повторить из того же блока.
6. Чтобы пропустить поиск для всего модуля, нажмите Write, не нажимая сначала Find: после подтверждения правило применяется к каждому артефакту модуля за один проход, а числа появляются в конце.

Полезно знать

• Всегда работайте в наборе изменений: отказ от него — единственный способ вернуть прежние значения.
• Перечисления записываются своими метками (несколько значений — через запятую), пользователи — именами, даты — в формате год-месяц-день (YYYY-MM-DD).
• Текст требования записывается как простой текст: абзацы, пункты списков и строки таблиц становятся строками, форматирование теряется.
• Сохранённые правила персональны: они остаются в вашем браузере, не передаются коллегам и не хранятся на сервере.
• Очень длинное значение не записывается; предел меняется в настройках виджета.
• На очень больших модулях прогон можно остановить, перезагрузить страницу и продолжить с того же места с тем же правилом.