Введение в метод и модель вариантов использования приведено в статье «Варианты использования (статья не восстановлена после взлома блога)» цикла «Методы сбора требований» и детальнее описано в статье «Построение модели вариантов использования«.
Общепринятая структура описания/спецификации варианта использования (ВИ):
Имя;
- Идентификатор;
- Краткое описание;
- Актёры:
- Главные и второстепенные актёры;
- Инициирующие и участвующие актёры.
- Предусловия;
- Основной поток;
- Альтернативные потоки;
- Постусловия;
- Специальные требования.
А теперь рассмотрим каждый из разделов подробнее.
- Имя ВИ – короткое и емкое наименование, чтобы четко и однозначно понимать назначение ВИ.
- Идентификатор ВИ – неизменен, в отличие от имени.
- Краткое описание ВИ – абзац в 2-3 строки, в котором изложена цель ВИ.
- Актёры, вовлеченные в ВИ:
- Главные актёры – инициируют ВИ;
- Второстепенные актёры – взаимодействуют с ВИ во время его исполнения.
- Предусловия – условия, которые должны быть выполнены до начала ВИ; ограничения на состояние системы.
- Основной поток (ОП) – диалог актёра и системы; всегда начинается с действия главного актёра. Действия записываются в активном залоге с прямым порядком слов, например, «Пользователь выбирает строку в таблице А». Небольшое простое ветвление основного потока допустимо, т.к. может сократить количество альтернативных потоков. Полезные вопросы для уточнения формулировки действия:
- Кто именно?
- Что именно?
- Когда именно?
- Где именно?
- Альтернативные потоки (АП) – обрабатывают ошибки, ветвления, прерывания, исключения основного потока. Могут быть описаны отдельно или в конце описания ВИ. Не могут иметь альтернативных потоков. Для поиска АП нужно на каждом шаге ОП искать возможные альтернативные действия, ошибки, а также прерывания, которые могут случиться как на данном шаге ОП, так и в любой момент. Количество альтернативных потоков необходимо свести к минимуму:
- вариант 1: выбрать только самые важные альтернативные потоки;
- вариант 2: для группы очень схожих альтернативных потоков документировать только один, как образец, а для остальных по необходимости добавить примечания об отличиях.
- Постусловия – состояние системы после окончания ВИ; должны выполняться обязательно. Если АП возвращается в ОП, то его постусловия добавляются к постусловиям ОП.
- Специальные требования – текстовое описание требований, не отраженных в сценариях ВИ, в т.ч. нефункциональные требования.
Если наполнение какого-либо из разделов описания ВИ отсутствует, то следует писать в нем «Нет» – это показывает, что вопрос был проработан.