ГОССТАНДАРТ РОССИИ - ПАКЕТЫ ПРОГРАММ Требования к качеству и тестирование

3.1.2 Обозначения и указания

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

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

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

Примечание - Наименование и адрес не обязательно включать в текст описания продукта, достаточно поставить на документ штамп (печать) соответствующего дилера.

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

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

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

- процессоры, включая сопроцессоры;

- объем основной (оперативной) памяти;

- типы и объемы (памяти) периферийных запоминающих устройств;

- расширяющие платы;

- оборудование ввода и вывода;

- сетевое оборудование;

- системные и прочие программные средства.

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

Формулировка «(или любое другое…, если оно совместимо)» может быть приведена в описании продукта, если предварительно было определено конкретное техническое или программное средство. Формулировка «или модернизированная версия, если она совместима» может быть приведена, если предварительно в описании продукта была определена соответствующая версия продукта. Может быть приведена формулировка «от версии X до версии Y», а формулировка «от версии X» приводиться не должна.

Примечание - Формулировка «от версии X» позже может стать ошибочной, например, при появлении версии Х+3, под которой пакет программ будет работать со сбоями.

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

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

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

Примечание - Указывать форматы носителей (например, форматы дискет) нет необходимости, потому что набор возможных форматов определяется необходимой системой (см. 3.1.2 f).

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

Должно быть указано, будет или не будет предлагаться поддержка при эксплуатации продукта

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

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

Для каждой функции (особенно для ее опции или варианта) должно быть четко установлено, является ли она частью:

- продукта;

- расширения продукта, полностью описанного в описании продукта;

- расширения продукта, на которое дана ссылка в описании продукта;

- не гарантируемого (не обязательного) приложения.

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

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

- минимальные или максимальные значения;

- длины ключей;

- максимальное число записей в файле;

- максимальное число критериев поиска;

- минимальный объем выборки.

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

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

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

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

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

- проверки достоверности исходных данных;

- защита против серьезных последствий ошибки пользователя;

- восстановление при ошибках.

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

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

- знание соответствующей технической области;

- знание операционной системы;

- знания, получаемые в результате специального обучения;

- знание языков, отличных от языка, на котором написано описание продукта.

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

Примечание - Данное требование строже, чем аналогичное требование 6.1.7 ГОСТ Р ИСО 9127 [13], согласно которому указание языка является необязательным.

Если продукт может настраиваться (адаптироваться) пользователем, то должны быть указаны инструментальные средства для проведения такой настройки и условия их применения. Например:

- изменение параметров;

- изменение алгоритмов вычислений;

- назначение функциональных клавиш.

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

- техническая защита от копирования;

- запрограммированные даты окончания использования продукта;

- интерактивные напоминания об оплате за копии.

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

Примечание - Такая информация может быть описана в соответствии с рекомендациями, приведенными в ИСО 9241-11 [16].