Структура описания/спецификации варианта использования

Введение в метод и модель вариантов использования приведено в статье «Варианты использования (статья не восстановлена после взлома блога)» цикла «Методы сбора требований» и детальнее описано в статье «Построение модели вариантов использования«.

Общепринятая структура описания/спецификации варианта использования (ВИ):

Имя;

  • Идентификатор;
  • Краткое описание;
  • Актёры:
    • Главные и второстепенные актёры;
    • Инициирующие и участвующие актёры.
  • Предусловия;
  • Основной поток;
  • Альтернативные потоки;
  • Постусловия;
  • Специальные требования.

А теперь рассмотрим каждый из разделов подробнее.

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

Если наполнение какого-либо из разделов описания ВИ отсутствует, то следует писать в нем «Нет» – это показывает, что вопрос был проработан.

Оставить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *