Primary Text Manager

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

Текст многих артефактов часто нужно изменить одинаково: пометка статуса вроде «DRAFT:» в начале, примечание вроде «(TBC)» в конце, одна и та же стандартная фраза везде или вовсе никакого текста, потому что после импорта он перенесён в атрибуты или новые артефакты.

DOORS Next позволяет делать это только по одному артефакту в редакторе форматированного текста. Primary Text Manager делает это для всего модуля или выделения за один запуск и меняет только основной текст: артефакты сохраняют идентификаторы, атрибуты, связи и место в модуле.

Какие проблемы решает

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

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

• Четыре изменения в одном виджете: очистить текст, добавить префикс, добавить суффикс или заменить его своим текстом.
• Меняется только текст. Имя, атрибуты, связи и структура модуля остаются в точности прежними.
• Один щелчок для всего модуля: подтвердите один раз, и каждый артефакт, которому нужно изменение, его получит; остальные пропускаются.
• Никогда дважды: уже имеющийся префикс или суффикс не добавляется повторно, а заголовки по умолчанию защищены.
• Целые модули за один запуск, без ограничения в 200 артефактов для выделения, и отчёт в Excel с каждым текстом до и после.

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

1. В Settings нажмите Change, в What to do выберите Empty, Add prefix, Add suffix или Replace text, введите текст и нажмите Done.
2. Откройте модуль. В разделе Apply оставьте Whole module и нажмите плитку действия, например Add prefix. Прочитайте подтверждение, где сказано, что будет записано, и подтвердите красной кнопкой.
3. Виджет изменяет весь модуль за один проход. Во время прогона виден ход работы, остановить можно в любой момент; в конце блок результата показывает, сколько артефактов обработано, изменено, не требовало изменений или завершилось ошибкой, а Log скачивает отчёт об изменениях.
4. Чтобы изменить только некоторые артефакты, выделите их в DOORS Next и выберите Selection: строка под плиткой показывает, сколько изменится и какие останутся как есть. Нажмите плитку и подтвердите.

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

• Запускайте Primary Text Manager в наборе изменений (change set), чтобы его можно было отменить, если результат не устроит.
• Префикс или суффикс добавляется точно так, как введён, вместе с пробелами, и получает форматирование первого или последнего абзаца. Артефакты без текста не получают ни префикса, ни суффикса.
• Чтобы снова добавить префикс или суффикс там, где он уже есть, или добавить его и в пустые тексты, отметьте Change even if no change is needed в Settings.
• Изображения и другие файлы никогда не изменяются. Снимите флажок Leave headings as they are в Settings, только если заголовки тоже должны измениться.