Structure Writer

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

В модуле DOORS Next место требования (в какой главе оно находится, какой у него номер, где оно стоит в документе) видно только в представлении модуля. Как только артефакты попадают в представление по нескольким модулям, экспорт, фильтр, отчёт или другой инструмент, этот контекст теряется. Командам, пришедшим из DOORS 9, к тому же не хватает привычных документных идентификаторов вроде «SRS-1234».

Structure Writer копирует структуру в атрибуты, и она путешествует вместе с артефактом. Для каждого артефакта модуля он может записать путь по родительским главам («1 Введение > 1.2 Область»), форматированный идентификатор из префикса, идентификатора артефакта и суффикса («SRS-001234-A») и номер, растущий в порядке модуля, для сортировки. Вы сами выбираете, какие из трёх значений нужны и в какой атрибут попадает каждое.

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

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

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

• Три значения за один прогон: путь в иерархии, форматированный идентификатор и порядковый номер, каждое необязательно и каждое в своём атрибуте.
• Гибкий путь: каждый уровень как номер раздела и название, только номер, только название, идентификатор или идентификатор и название, со своим разделителем, с самим артефактом или без него.
• Целые модули, быстро: без ограничения в 200 артефактов; структура читается один раз, значения сохраняются пакетами.
• Сначала проверка: для выделения плитка Write показывает, сколько артефактов изменится, а подтверждение – сколько путей, ID и номеров будет записано; уже верные значения никогда не сохраняются повторно.
• Остаётся верным: после перестройки структуры запустите виджет снова, и обновятся только изменившиеся значения.
• Подтверждение: отчёт об изменениях в Excel с каждым значением до и после.

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

1. В разделе Rules включите нужные значения и выберите целевой атрибут каждого: путь в иерархии (формат уровня и разделитель), форматированный идентификатор (префикс, суффикс, дополнение нулями) и порядковый номер (начало и шаг).
2. При необходимости ограничьте прогон одним типом артефакта, пропустите заголовки или заполняйте только пустые атрибуты (Additional settings).
3. Откройте модуль, выберите Whole module и нажмите Write: прочитайте подтверждение и нажмите Write values. Значения записываются во весь модуль за один проход, сохраняются только действительно изменившиеся.
4. Или выделите несколько артефактов в модуле и выберите Selection: плитка Write показывает, сколько из них изменится; нажмите Write и подтвердите кнопкой Write values. Их пути и номера всё равно берутся из всего модуля.
5. Результат показывает число записанных, уже верных, пропущенных и не сохранённых артефактов; Log сохраняет отчёт об изменениях, если нужна запись.

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

• Всегда работайте в наборе изменений: по умолчанию существующие значения перезаписываются, потому что значения следуют за структурой. Включите «Only fill empty targets», чтобы сохранить значения, введённые вручную.
• Значения атрибутов принадлежат артефакту, а не его месту: артефакт, использованный в модуле дважды, получает значения своего первого места, а артефакт, используемый и в другом модуле, – значения модуля, в котором виджет запускали последним.
• У артефактов верхнего уровня нет родительской главы, поэтому путь они получают только тогда, когда включён сам артефакт.
• Порядковый номер считает только записываемые артефакты в порядке их следования в модуле.
• В очень больших модулях можно остановить прогон, перезагрузить страницу и продолжить с места остановки с теми же настройками.