О полном описании вариантов использования

Спецификация (описание) вариантов использования – это текстовое структурированное описание последовательности действий актера и реакции системы на эти действия. Кроме этого спецификация вариантов использования может содержать в себе и другие разделы.

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

· инициатор,

· краткое описание,

· требования,

· нормальный ход варианта использования (состоящий из двух разделов: Действия актера и отклик системы),

· альтернативный ход варианта использования,

· точки расширения.

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

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

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

· просмотреть краткое описание варианта использования;

· просмотреть требования, которым вариант использования соответствует;

· представить себе актера, взаимодействующего с системой, его действия по отношению к ней (добавить эти действия в левую колонку таблицы);

· представить себе, что делает система (добавить эти действия в правую колонку таблицы), при этом рассматривать эти действия в контексте воздействий актера. Нумерация через десяток используется и здесь по тем же соображениям, что для требований и номеров вариантов использования.

Завершим описание процедуры специфицирования нормального хода варианта использования несколькими рекомендациями:

· Один шаг в варианте использования – это атомарное действие актера или системы, т.е. каждый шаг должен содержать элементарные действия, неподдающиеся дальнейшему разбиению. Не следует в описании шага варианта использования остерегаться использовать обороты «Причем,…», «Следует обратить внимание, …» и так далее, которые описывают некую специфику данного шага.

· В описании вариантов использования необходимо придерживаться терминологии, определенной в глоссарии. Если есть необходимость употребить какой-то термин, которого нет в глоссарии, то необходимо его сначала туда включить, а затем использовать.

· При описании вариантов использования следует использовать естественный язык, т.е. правильными являются фразы типа «Система создает новый товар», «Система отображает список продавцов, у которых не установлен признак «Удален»» и так далее, но не правильными являются фразы типа «Система вставляет в таблицу Items новую запись, соответствующую новому товару».

· В совокупности все варианты использования системы не должны оставлять белых пятен в работе системы. После описания вариантов использования всегда должна быть предоставлена возможность ответа на вопросы типа «Что будет если...», «Как пользователь управляет этим» или «Какие поля будут в отчете?» и так далее.

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

Раздел альтернативный ход варианта использования описывает шаги, которые могут быть выполнены, при ненормальном течении варианта использования. Например, если актер отказывается от своих действий, если происходит какая-либо ошибка, если ничего не найдено и в других случаях, которые как-то могут повлиять на нормальный ход варианта использования.

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

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

Раздел точки расширения. Если по отношению к варианту использования есть варианты использования находящиеся с ним в отношении расширения, это значит, что в варианте использования почти наверняка можно легко выделить точку расширения. Точка расширения – это место, в котором происходит расширение варианта использования другим вариантом использования.

Шаг Полное описание вариантов использования этапа Анализ завершим примерами.