Тестирование (ФАК)

Техническая информация о программном средстве (УСЛ)

Использование программного средства (ОБ)

Ввод в действие программного средства (ОБ)

Функциональное описание программного средства (ОБ)

Компоненты пакета (ОБ)

Обозначение пакета (ОБ)

Справочная документация (ОБ)

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

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

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

6.1.1. Наименование и код пакета (ОБ)

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

6.1.2. Вариант (УСЛ)

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

6.1.3. Версия (УСЛ)

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

6.1.4. Даты (ОБ)

Должны быть приведены даты публикации оригинала и текущей версии.

6.1.5. Изготовитель или торгующая организация (ОБ)

Должны быть приведены наименование и адрес изготовителя или организации, продающей программный пакет.

6.1.6. Ключевые слова (ФАК)

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

6.1.7. Язык (ФАК)

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

6.2.1. Поставляемые элементы (ОБ)

Должны быть перечислены и обозначены по наименованиям и количеству все физические элементы пакета (например, диски, кассеты, руководства и т.д.).

При необходимости, должно быть определено содержание физических элементов (например, программное обеспечение на дисках или кассетах, документы, включенные в руководства, и т.д.).

6.2.2. Сопутствующие объекты (УСЛ)

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

6.3.1. Назначение и область применения (ОБ)

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

Должны быть даны примеры области применения программного средства.

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

6.3.2. Условия эксплуатации (ОБ)

а) Требования к техническим средствам (ОБ)

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

b) Требования к программным средствам (УСЛ)

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

c) Требования к коммуникациям (УСЛ)

Должны быть определены связные интерфейсы с другими системами.

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

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

d) Другие требования (УСЛ)

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

6.3.3. Характеристики (УСЛ)

a) Рабочие характеристики (УСЛ)

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

b) Размер программы (ФАК)

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

c) Скорость обработки (ФАК)

Должна быть представлена информация о скорости обработки (например, скорость компиляции, время сортировки, скорость обмена, время поиска, время отклика).

6.3.4. Ограничения (УСЛ)

Должны быть определены любые ограничения по использованию программного средства или его компонентов.

Должно быть указано, защищено ли программное средство от копирования.

6.3.5. Защита (УСЛ)

Должны быть описаны любые защитные средства, позволяющие пользователю защищать программное средство или его компоненты и данные от несанкционированного доступа.

Должны быть также описаны любые способы проверки и средства дублирования данных.

6.4.1. Ввод в действие (ОБ)

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

6.4.2. Создание дублирующих копий (УСЛ)

Должно быть приведено описание того, как создавать дублирующие копии программного средства, если дублирующие копии допускаются.

6.4.3. Модификация программного средства (УСЛ)

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

Должна быть приведена полная информация об использовании программного средства, охватывающая:

a) подготовку к использованию;

b) входные команды и данные;

c) функции программного средства;

d) вывод результатов;

e) сообщения об ошибках и отказах, корректирующие и восстанавливающие действия.

Подготовка, ввод, обработка, вывод и ошибки могут быть описаны пофункционально или объединенно, как удобнее.

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

6.5.1. Загрузка программного средства (ОБ)

Должны быть приведены инструкции по загрузке программного средства в ЭВМ. Когда требуются предварительные действия, такие как загрузка операционной системы, должны быть приведены соответствующие инструкции или дана ссылка на соответствующую документацию.

6.5.2. Управляющие инструкции, команды или языковые правила (ОБ)

a) Управляющие инструкции и команды (ОБ)

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

b) Выходные сообщения (ОБ)

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

c) Правила языка программирования (УСЛ)

Для компиляторов должны быть описаны правила языка путем ссылки на соответствующую документацию (например ИСО 7185 для языка ПАСКАЛЬ).

6.5.3. Данные (ОБ)

a) Входные данные (УСЛ)

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

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

b) Вспомогательные данные (УСЛ)

Должны быть описаны любые вспомогательные данные, требуемые для работы программного средства, например словарь для программы обработки текста.

c) Выходные данные (ОБ)

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

d) Промежуточные данные (УСЛ)

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

e) Ограничения на данные (УСЛ)

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

f) Хранение данных (УСЛ)

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

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

6.5.4. Обработка (УСЛ)

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

6.5.5. Ошибки и сбои (ОБ)

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

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

6.6.1. Язык (УСЛ)

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

Должно быть установлено, приняты ли какие-либо исключения для стандарта на язык.

6.6.2. Принципы и алгоритмы решения задач (ФАК)

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

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

6.6.3. Структура программного средства (ФАК)

Должна быть описана организация элементов программного средства (например, программ, модулей, сегментов, общих областей памяти).

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

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

Дата добавления: 2014-01-03