Module Diff

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

«Что изменилось в этом модуле с последней базовой линии?» – один из самых частых вопросов перед рецензией, выпуском или аудитом. DOORS Next умеет сравнивать конфигурации, но на большом модуле сравнение идёт долго, а результат трудно просматривать.

Module Diff отвечает на этот вопрос прямо в ELM Mini Dashboard рядом с модулем. Выберите базовую линию текущего потока или другой поток или базовую линию того же компонента, и виджет перечислит каждое добавленное, удалённое, изменённое или перемещённое требование с текстом до и после. Виджет только читает. В DOORS Next ничего не меняется.

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

• Сравнение большого модуля с базовой линией занимает слишком много времени, поэтому его пропускают или делают в самом конце.
• Рецензентам приходится искать несколько изменённых требований среди тысяч неизменённых.
• Перемещённые требования и изменения структуры легко пропустить.
• Для рецензий изменений и аудитов нужен перечень изменений, который трудно собрать вручную.

Польза

• Быстро: другая конфигурация читается пакетами, а от текстов сохраняются только короткие отпечатки, поэтому даже большие модули сравниваются быстро.
• Один список: добавленные, удалённые и изменённые требования в порядке модуля, с заголовками для ориентации, или все требования через All artifacts.
• До и после: откройте требование, чтобы увидеть старый и новый текст построчно, имя, тип артефакта, место в модуле и то, что вы выбрали для сравнения: связи по типам связей, теги, комментарии и атрибуты.
• Легко просматривать: заголовки выделены в списке и сворачиваются квадратиком +/−, а поиск и списки над ним сужают список по тексту, типу артефакта или заголовкам.
• В обе стороны: Swap сразу меняет направление сравнения, ничего не читая заново.
• И структура: требования, перенесённые в другую главу, со сменой порядка или уровня, отмечаются как перемещённые.
• Готово к рецензии или аудиту: сравнение выгружается в Excel в том же формате, что и любой журнал SmarterWidgets, с итогами и названиями обеих конфигураций.
• Безопасно для всех: виджет только читает, поэтому им может пользоваться каждый в любое время.

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

1. Откройте модуль. В разделе Compare поле From показывает конфигурацию, в которой вы работаете. В To выберите базовую линию или поток для сравнения: сначала базовые линии этого потока, затем другие потоки и базовые линии компонента. Swap меняет направление сравнения.
2. В Attributes to compare нажмите Change и отметьте, что сравнивать: Primary Text (Contents), Tags, Comments, атрибуты, например статус или приоритет, и типы связей, или Select all. Имя, тип артефакта и место в модуле сравниваются всегда.
3. Нажмите Compare module. Индикатор выполнения показывает ход работы; остановить можно в любой момент.
4. Результат показывает число добавленных (только в To), удалённых (только в From), изменённых и неизменённых требований. Differences перечисляет изменения под их заголовками; поле поиска и списки над ним сужают список по тексту, типу артефакта или заголовкам, а All artifacts показывает все требования.
5. Откройте требование, чтобы увидеть текст до и после построчно и его атрибуты рядом. Show in module переходит к нему.
6. Log рядом с результатом (или значок загрузки у Differences) сохраняет сравнение в Excel для рецензии или аудита.

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

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