Перечислите по пунктам детализированные функциональные требования, которые связаны с этой особенностью. Здесь должны быть представлены определенные характеристики ПО, чтобы пользователь мог задействовать эту функцию или реализовать варианты использования. Опишите, как продукт должен реагировать на ожидаемые ошибки, неправильный ввод информации или неверные действия. Присвойте каждому функциональному требованию уникальное имя.
Требования к внешнему интерфейсу
По мнению Richard Thayer (2002), «требования к внешнему интерфейсу определяют оборудование, ПО или элементы баз данных, с которыми система или компонент должны взаимодействовать...» Информация этого раздела позволяет вам быть уверенным, что система будет должным образом взаимодействовать с внешними компонентами. Если у разных частей продукта разные внешние интерфейсы, вставьте подобный раздел в детализированные требования для каждой такой части.
Выработка согласованного решения, касающегося внешнего и внутреннего интерфейса системы, признана наилучшим приемом в области разработки ПО (Brown, 1996). Вставьте подробные описания компонентов данных и элементов управления интерфейса в словарь данных. В сложной системе с множеством подкомпонентов следует использовать раздельные спецификации для интерфейсов или спецификацию системной архитектуры (Hooks и Farry, 2001). В документацию по интерфейсу можно включить ссылки на материал из других документов. Например, ссылка на спецификацию программного интерфейса другого приложения (API) или на руководство по работе с устройством, где перечислены коды с ошибками, которые устройство может отправить ПО.
| Войны интерфейсов Две команды разработчиков ПО объединились для создания флагманского продукта Datum Corporation. Команда, отвечающая за базу знаний, создала ядро сложного интерфейса на C++, а команда, отвечающая за приложения, реализовала пользовательский интерфейс на Microsoft Visual Basic. Обе подсистемы взаимодействовали между собой посредством API. К сожалению, команда, отвечающая за базу знаний, периодически модифицировала API, в результате систему не удавалось собрать и запустить на выполнение должным образом. Команде, отвечающей за приложения, потребовалось несколько часов, чтобы распознать каждую проблему и определить основную причину — изменение API. Эти изменения не согласовывались, не доводились до сведения всех заинтересованных в проекте лиц и не были координированы с соответствующими модификациями в коде, написанном на Visual Basic. Интерфейс скрепляет компоненты вашей системы, включая пользователей, поэтому необходимо документировать детали интерфейса и синхронизировать модификации в процессе контроля за изменениями вашего проекта. |
Интерфейсы пользователя
Опишите логические характеристики каждого пользовательского интерфейса, который необходим системе. Некоторые из них перечислены здесь:
· ссылки на стандарты графического интерфейса пользователей или стилевые рекомендации для семейства продукта, которые необходимо соблюдать;
· стандарты шрифтов, значков, названий кнопок, изображений, цветовых схем, последовательностей полей вкладок, часто используемых элементов управления и т.п.; конфигурация экрана или ограничения разрешения;
· стандартные кнопки, функции или ссылки перемещения, одинаковые для всех экранов, например кнопка справки;
· быстрые клавиши;
· стандарты отображения сообщений;
· стандарты конфигурации для упрощения локализации ПО;
· специальные возможности для пользователей с проблемами со зрением.
Детально документируйте детали пользовательского интерфейса, такие, как конфигурации определенных диалоговых окон, в отдельной спецификации пользовательского интерфейса, а не в спецификации требований к ПО. Конечно, добавить еще одну точку зрения на требования полезно, но необходимо подчеркнуть, что эти модели не являются официальными планами экрана. Если в спецификации требований к ПО говорится об улучшении существующей системы, то стоит включить в документ изображения экранов в том виде, как они будут реализованы. Для разработчиков уже заданы ограничения существующей системой, поэтому можно заранее представить, как будут выглядеть измененные, а, возможно, и новые экраны.
Интерфейсы оборудования
Опишите характеристики каждого интерфейса между компонентами ПО и оборудования системы. В описание могут входить типы поддерживаемых устройств, взаимодействия данных и элементов управлений между ПО и оборудованием, а также протоколы взаимодействия, которые будут использоваться.
Интерфейсы ПО
Опишите соединения продукта и других компонентов ПО (идентифицированные по имени и версии), в том числе базы данных, операционные системы, средства, библиотеки и интегрированные коммерческие компоненты. Укажите назначение элементов сообщений, данных и элементов управления, обмен которыми происходит между компонентами ПО. Опишите службы, необходимые внешним компонентам ПО, и природу взаимодействия между компонентами. Определите данные, к которым будут иметь доступ компоненты ПО. Если механизм предоставления общего доступа к данным должен быть реализован определенным способом, например в качестве глобальной области данных, то укажите его как ограничение.