Главная Теоретический материал Лабораторные работы Задачи Тесты Контакты

Узбекское Агентство
Связи и Информатизации



Ташкентский Университет Информационных Технологий


Кафедра
«Программное обеспечение информационных технологий»

Направления:

5521900Информатика и
информационные технологии,
5523500Защита информации,
5523600Электронная коммерция,
5811200Сервис (информационный сервис),
5811300Сервис (электронные и
компьютерные технологии),
5320200Информатика и
библиотековедение,
5140900Профессиональное образование
(по направлению
информатика и
информационные технологии).


Преподаватель дисциплины



Доцент
Чернев Дмитрий Алексеевич

Документ «Внешняя спецификация»

Документ «Внешняя спецификация» является дальнейшим развитием документа «Соглашение о требованиях» и отражает результаты внешнего проектирования программного обеспечения. У нас принято называть этот документ «Техническим проектом». В последнее   время   этот документ   стали   чаще   называть   «Эскизным проектом».

Документ «Внешняя спецификация» содержит описание внешних функций проекта и ожидаемого поведения разрабатываемого продукта с точки зрения внешнего  по отношению к нему наблюдателя — пользователя.

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

— название и краткое описание программного изделия;

— функциональную схему системы;

— организацию диалога программного изделия с пользователем;

— описание меню, подменю, действий функциональных клавиш;

— все  экранные формы или протокольные экранные сообщения;

— сообщения, выдаваемые пользователю во время проведения сеанса работы программного изделия и ответы на них;

— сообщения об ошибках;

— подсказки пользователю, организация помощи;

— структуру и организацию баз данных;

— описание и подготовку входных данных;

— выходные печатные формы;

— другие внешние сопряжения программного изделия.          

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

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

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

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

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

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

В работе Parnas DL Technigue for software module specification with examples. Д.А. Парнас предложил следующий метод, состав­ления спецификации на программный модуль.

1. Информация о структуре вызывающего модуля не должна содержать  во внешней спецификации на вызываемый модуль.

2. Внешняя спецификация должна быть написана на понятном пользователю и производителю  языке для уменьшения вероят­ности возможных недоразумений.

3. Модули должны быть построены таким образом, чтобы при необходимости внешних изменений в одном из них не приходилось бы изменять связанные с ним модули и процедуры.

4. Рецензент внешней спецификации должен считать, что будут реализованы    только    те    свойства,    которые    определены    в    спецификации.

Например, если  во внешней спецификации без дополнительных оговорок написано, что «параметр А может принимать любое значение в пределах от 3 до 14», то он вправе предположить, что дробные числа, такие, как 5,71  допустимы, а граничные значения 3 и 14 недопустимы. Недопустимыми являются также числа 123, 0, 29999, 3.001, 115.

5. Ограничения должны быть полностью и точно определены, но причину возникновения    этих    ограничений    указывать   не   обязательно.

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

6. Проверка корректности и полноты внешней спецификации должна проводиться еще до начала программирования.

Всегда целесообразно перед программированием организовывать рассмотрения этого документа пользователями или их представителями для утверждения и одобрения.

 


Назад


Главная Теоретический материал Лабораторные работы Тесты Контакты