8. Способы документирования требований. Привести пример требования, задокументированного по каждому из способов.

Инженерия требований сосредоточена на задачах обнаружения, выявления, разработки, анализа, надежной верификации требований, а также на валидации, выражении, документировании требований и управлении требованиями и является одним из ключевых элементов системной инженерии.

При составлении документа, содержащего требования, следует тщательно соблюдать баланс между двумя аспектами:

1) документ с требованиями должен быть удобным для чтения;

2) набор требований должен быть технологичным, то есть удобным для работы с требованиями.

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

Документация, относящаяся к требованиям, может быть весьма объёмной. В таких ситуациях важным фактором управления сложностью становится понятная и чётко определённая структура документов, содержащих описание полного набора требований.

Организация требований в правильную структуру может помочь: минимизации количества требований; лучшему пониманию больших объёмов информации; быстрому нахождению наборов требований по заданным критериям; выявлению пропусков и дублирований; устранению конфликтов между требованиями; управлению итерациями (например, для отложенных требований); исключению ненужных требований; оценке требований; повторному использованию требований в нескольких проектах. Обычно документы имеют иерархическую структуру с разделами и подразделами нескольких уровней. Иерархии представляют собой структуры, удобные для классификации, и одним из способов структурирования документа является использование системы заголовков разделов для категоризации пунктов требований. При таком подходе положение пункта требований в документе соответствует основной или первичной классификации.

Если требования выводятся из моделей, где используется иерархия, то одну из иерархий, полученных в результате моделирования, можно использовать в качестве структуры заголовков для документа, содержащего требования. В дополнение к описаниям требований документы могут включать разнообразные технические и нетехнические тексты, способствующие лучшему пониманию требований, например: вспомогательная информация, которая позиционирует требования с учетом контекста; внешний контекст, описывающий объемлющую систему, часто называемый «предметной областью»; определение области применения требований (что «внутри» и что «снаружи»); определения терминов, используемых в формулировках требований; описания, связывающие различные разделы документа; описания заинтересованных сторон; краткие обзоры моделей, применяемых для определения происхождения требований; ссылки на другие документы.

Простой текстовой формы не вполне достаточно для определения требования, каждое требование должно также включать иную информацию о его классификации и статусе. Чтобы упорядочить текст, содержащий требование, следует предусмотреть дополнительные информационные «атрибуты», привязанные к требованию. Подобные атрибуты позволяют структурировать информацию, касающуюся каждого отдельного требования, что дает возможность упростить ее обработку, фильтрацию, сортировку и т. п.

Использование ясного, логически непротиворечивого языка заметно упрощает определение различных типов требований. Самый простой пример – использование слова «должен» как ключевого слова для обозначения в тексте приоритета требования.

Обычно требование конкретной возможности имеет следующую форму:

Если некоторые аспекты той или иной характеристики или ограничения связаны исключительно с описываемым требованием, то их также можно включить в текст, например, в такой форме:

Например, следующее требование возможности включает в себя характеристику и ограничение: Дежурный оператор должен быть способен: запустить ракету в течение 3 секунд после обнаружения цели радаром в условиях волнения моря до 7 баллов.

Как правило, требования к ограничениям записываются в следующей форме:

Пример: Водитель машины скорой помощи не должен попадать в ситуацию, вынуждающую нарушать национальные правила дорожного движения.

Вот пример описания функции с показателем функционирования:

Пример: Система связи должна поддерживать телефонные соединения не менее чем 10 абонентов при отсутствии внешнего электропитания.

В другом примере описывается ограничение на периодичность действия:

Пример: Кофеварка должна готовить горячий напиток каждые 10 секунд. Обсуждение этой темы будет продолжено в следующем разделе.

Требование может ссылаться на общий для всего документа экземпляр шаблона, а данные, помещаемые в поля шаблона, могут быть собраны как атрибуты конкретного требования.