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

ГОСТ 19.505-79

Группа Т55

МЕЖГОСУДАРСТВЕННЫЙ СТАНДАРТ

Единая система программной документации

РУКОВОДСТВО ОПЕРАТОРА

Требования к содержанию и оформлению

Unified system for program documentation. Operation’s guide. Requirements for contents and form of presentation

МКС 35.080     

Дата введения 1980-01-01

Постановлением Государственного комитета CCCР по стандартам от 12 января 1979 г. N 74 дата введения установлена 01.01.80

ИЗДАНИЕ (январь 2010 г.) с Изменением N 1, утвержденным в сентябре 1981 г. (ИУС 11-81).

Настоящий стандарт устанавливает требования к содержанию и оформлению программного документа «Руководство оператора», определенного ГОСТ 19.101-77.

Стандарт полностью соответствует СТ СЭВ 2096-80*.

(Измененная редакция, Изм. N 1).

 1. ОБЩИЕ ПОЛОЖЕНИЯ

1.1. Структура и оформление программного документа устанавливаются в соответствии с ГОСТ 19.105-78.

Составление информационной части (аннотации и содержания) является обязательным.

1.2. Руководство оператора должно содержать следующие разделы:

назначение программы;

условия выполнения программы;

выполнение программы;

сообщения оператору.

В зависимости от особенностей документа допускается объединять отдельные разделы или вводить новые.

(Измененная редакция, Изм. N 1).

 2. СОДЕРЖАНИЕ РАЗДЕЛОВ

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

2.2. В разделе «Условия выполнения программы» должны быть указаны условия, необходимые для выполнения программы (минимальный и (или) максимальный состав аппаратурных и программных средств и т.п.).

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

2.2, 2.3. (Измененная редакция, Изм. N 1).

2.4. (Исключен, Изм. N 1).

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

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

(Измененная редакция, Изм. N 1).

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

(Введен дополнительно, Изм. N 1).

Ниже представлен пример (образец) документа «Руководство пользователя«, разработанного на основании методических указаний РД 50-34.698-90.

Данный документ формируется IT-специалистом, или функциональным специалистом, или техническим писателем в ходе разработки рабочей документации на систему и её части на стадии «Рабочая документация».

Для формирования руководства пользователя в качестве примера был взят инструмент Oracle Discoverer информационно-аналитической системы «Корпоративное хранилище данных».

Ниже приведен состав руководства пользователя в соответствии с ГОСТ. Внутри каждого из разделов кратко приведены требования к содержанию и текст примера заполнения (выделен вертикальной чертой).

Разделы руководства пользователя:

1. Введение.
2. Назначение и условия применения.
3. Подготовка к работе.
4. Описание операций.
5. Аварийные ситуации.
6. Рекомендации по освоению.

1. Введение

В разделе «Введение» указывают:

1. область применения;
2. краткое описание возможностей;
3. уровень подготовки пользователя;
4. перечень эксплуатационной документации, с которой необходимо ознакомиться пользователю.

2. Назначение и условия применения Oracle Discoverer Plus

В разделе «Назначение и условия применения» указывают:

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

3. Подготовка к работе

В разделе «Подготовка к работе» указывают:

1. состав и содержание дистрибутивного носителя данных;
2. порядок загрузки данных и программ;
3. порядок проверки работоспособности.

4. Описание операций

В разделе «Описание операций» указывают:

1. описание всех выполняемых функций, задач, комплексов задач, процедур;
2. описание операций технологического процесса обработки данных, необходимых для выполнения функций, комплексов задач (задач), процедур.

Для каждой операции обработки данных указывают:

1. наименование;
2. условия, при соблюдении которых возможно выполнение операции;
3. подготовительные действия;
4. основные действия в требуемой последовательности;
5. заключительные действия;
6. ресурсы, расходуемые на операцию.

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

5. Аварийные ситуации

В разделе «Аварийные ситуации» указывают: 1. действия в случае несоблюдения условий выполнения технологического процесса, в том числе при длительных отказах технических средств; 2. действия по восстановлению программ и/или данных при отказе магнитных носителей или обнаружении ошибок в данных; 3. действия в случаях обнаружении несанкционированного вмешательства в данные; 4. действия в других аварийных ситуациях.

6. Рекомендации по освоению

В разделе «Рекомендации по освоению» указывают рекомендации по освоению и эксплуатации, включая описание контрольного примера, правила его запуска и выполнения.

ФЕДЕРАЛЬНОЕ АГЕНТСТВО ПО ТЕХНИЧЕСКОМУ РЕГУЛИРОВАНИЮ И МЕТРОЛОГИИ

ГОСТР

ИСО/МЭК 25051-2017

Информационные технологии Системная и программная инженерия

Требования к качеству готового к использованию программного продукта (RUSP) и инструкции по тестированию

(ISO/IEC 25051:2014, Software engineering — Systems and software Quality Requirements and Evaluation (SQuaRE) — Requirements for quality of Ready to Use Software Product (RUSP) and instructions for testing, IDT)

Издание официальное

Москва

Стандартинформ

2017

ГОСТ Р ИСО/МЭК 25051—2017

Предисловие

1    ПОДГОТОВЛЕН Обществом с ограниченной ответственностью «Информационно-аналитический вычислительный центр» (ООО ИАВЦ) на основе собственного перевода на русский язык англоязычной версии стандарта, указанного в пункте 4

2    ВНЕСЕН Техническим комитетом по стандартизации ТК 22 «Информационные технологии»

3    УТВЕРЖДЕН И ВВЕДЕН В ДЕЙСТВИЕ Приказом Федерального агентства по техническому регулированию и метрологии от 26 мая 2017 г. № 448-ст

4    Настоящий стандарт идентичен международному стандарту ИСО/МЭК 25051:2014 «Системная и программная инженерия. Оценка и требования к качеству программного обеспечения и систем (SQuaRE). Требования к качеству готового к использованию программного продукта (RUSP) и инструкции по тестированию» (ISO/IEC 25051:2014 «Software engineering — Systems and software Quality Requirements and Evaluation (SQuaRE) — Requirements for quality of Ready to Use Software Product (RUSP) and instructions for testing», IDT).

ИСО/МЭК 25051 разработан подкомитетом ПК 7 «Системная и программная инженерия» совместного технического комитета СТК 1 «Информационные технологии» Международной организации по стандартизации (ИСО) и Международной электротехнической комиссии (МЭК).

Наименование настоящего стандарта изменено относительно наименования указанного международного стандарта для приведения в соответствие с ГОСТ Р 1.5-2012 (пункт 3.5).

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

5    ВВЕДЕН ВПЕРВЫЕ

6    Некоторые положения международного стандарта, указанного в пункте 4. могут являться объектом патентных прав. ИСО и МЭК не несут ответственности за идентификацию подобных патентных прав

Правила применения настоящего стандарта установлены в статье 26 Федерального закона от 29 июня 2015 г. № 162-ФЗ «О стандартизации в Российской Федерации». Информация об изменениях к настоящему стандарту публикуется в ежегодном (по состоянию на 1 января текущего года) информационном указателе «Национальные стандарты», а официальный текст изменений и поправок — в ежемесячном информационном указателе «Национальные стандарты». В случае пересмотра (замены) или отмены настоящего стандарта соответствующее уведомление будет опубликовано в ближайшем выпуске ежемесячного информационного указателя «Национальные стандарты». Соответствующая информация, уведомление и тексты размещаются также в информационной системе общего пользования — на официальном сайте Федерального агентства по техническому регулированию и метрологии в сети Интернет (www.gost.nj)

© Стандартинформ.2017

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

ГОСТ Р ИСО/МЭК 25051—2017

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

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

5.1.7    Качество продукта — совместимость

5.1.7.1    Описание продукта должно содержать сообщения о совместимости с учетом сосуществования и оперативной совместимости. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

Примечание — В качестве таких ссылок может быть указано следующее:

—    наименование программного и (или) аппаратного обеспечения (сервер, платформа и пр.);

—    версия;

—    определенная операционная система.

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

5.1.8    Качество продукта — удобство использования

5.1.8.1    Описание продукта должно содержать в соответствующих случаях сообщения об удобстве его использования, принимая во внимание возможности узнаваемости, обучаемости, работоспособности. защиты от ошибок пользователя, эстетики интерфейса пользователя и доступности. Эти сообщения должны быть указаны таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

Примечание — В качестве таких интерфейсов могут выступать:

—    командная строка;

—    меню;

—    окно;

—    функциональная клавиша.

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

Примечание — Это могут быть:

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

—    знания в технической области.

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

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

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

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

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

Примечание — В качестве таких мер защиты могут выступать:

—    программируемые даты истечения сроков эксплуатации;

—    интерактивные напоминания об оплате используемых копий.

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

5.1.9    Качество продукта — надежность

5.1.9.1 Описание продукта должно содержать сообщения о надежности с учетом завершенности, удобстве его использования, отказоустойчивости и возможности восстановления. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

7

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

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

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

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

5.1.10    Качество продукта — безопасность

5.1.10.1    Описание продукта должно содержать сообщения о безопасности с учетом конфиденциальности. целостности, предотвращения отказов, отчетности и подлинности. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

5.1.11    Качество продукта — удобство сопровождения

5.1.11.1    Описание продукта должно содержать сообщения об удобстве сопровождения с учетом модульности, возможности повторного использования, возможности анализа, возможности внесения изменений и проведения тестирования. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

Примечание — Информация об обслуживании может быть следующей:

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

—    мониторинг непредвиденных сбоев и существенных условий;

—    мониторинг эксплуатационных индикаторов, таких как журналы, экраны оповещений;

—    мониторинг локальных данных, управляемых приложением.

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

Примечание — Условия могут быть следующими:

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

—    изменение алгоритмов расчета;

—    настройки интерфейса;

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

5.1.12    Качество продукта — мобильность

5.1.12.1    Описание продукта должно содержать сообщения о мобильности с учетом пригодности к адаптации, возможности установки и замены. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

Примечания

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

2    Такими системами могут быть:

—    операционные системы;

—    элементы процессора, в том числе сопроцессоры.

—    обьем основной памяти.

—    типы и размеры периферийных хранилищ;

—    карты расширений;

—    устройства ввода и вывода.

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

—    системное программное обеспечение и прочее ПО.

5.1.12.3    В описании продукта должна содержаться информация о процедуре установки.

8

ГОСТ Р ИСО/МЭК 25051—2017

5.1.13    Качество использования — эффективность

5.1.13.1    Описание продукта должно содержать сообщения об эффективности. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

5.1.14    Качество использования — производительность

5.1.14.1    Описание продукта должно содержать сообщения о производительности. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

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

5.1.15    Качество использования — удовлетворенность

5.1.15.1    Описание продукта должно содержать сообщения о качестве использования в контексте удовлетворенности с учетом полезности, доверия, удовольствия от работы и удобства. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

5.1.15.2    Описание продукта должно содержать определенные контактные данные поставщика для целей гарантии удовлетворенности пользователя продукта.

5.1.16    Отсутствие рисков

5.1.16.1    Описание продукта должно содержать сообщения о качестве использования в контексте отсутствия рисков с учетом снижения экономических рисков, рисков возникновения угрозы здоровью, а также экологических рисков. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

5.1.17    Покрытие

5.1.17.1    Описание продукта должно содержать сообщения о качестве использования в контексте покрытия обстоятельств с учетом полноты среды и гибкости. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

5.2    Требования к документации пользователя

Примечание — Информация, указанная на упаковке согласно ИСО/МЭК 9127 «Программная инженерия. Документация пользователя и информация, указанная на упаковке», может использоваться в качестве исходных данных для создания документации пользователя.

5.2.1    Доступность

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

5.2.2    Содержание

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

5.2.3    Идентификация и указатели

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

5.2.3.2    RUSP идентифицируется по обозначению изделия.

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

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

5.2.4    Полнота

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

9

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

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

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

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

Примечание — Для получения дополнительной информации см. приложение А.

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

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

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

5.2.4.8    Если документация пользователя предоставляется в нескольких частях, по меньшей мере, в одном элементе должен присутствовать список всех частей.

5.2.5    Корректность

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

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

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

5.2.6    Последовательность

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

5.2.7    Понятность

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

5.2.7.2    Понимание документации пользователя облегчается предоставлением структурированного списка документов.

5.2.8    Качество продукта — функциональная пригодность

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

5.2.9    Качество продукта — совместимость

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

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

Примечание — В качестве таких ссылок могут быть указаны:

—    название программного и (или) аппаратного обеспечения.

—    версия;

—    определенная операционная система.

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

Ю

ГОСТ Р ИСО/МЭК 25051—2017

5.2.10    Качество продукта — возможность использования и (или) обучения

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

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

5.2.11    Качество продукта — возможность использования и (или) эксплуатации

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

5.2.11.2    За исключением карточек и кратких справочных руководств, в документации пользователя должно содержаться оглавление или список тем. а также указатель.

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

5.2.12    Качество продукта — надежность

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

5.2.13    Качество продукта — безопасность

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

5.2.14    Качество продукта — удобство сопровождения

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

5.2.15    Качество использования — эффективность

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

5.2.16    Качество использования — производительность

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

5.2.17    Качество использования — удовлетворенность

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

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

5.2.18    Качество использования — отсутствие рисков

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

5.2.19    Качество использования — покрытие

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

5.3    Требования к качеству программного обеспечения

5.3.1    Качество продукта — функциональная пригодность

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

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

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

11

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

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

Примечание — Пример: два одинаковых действия должны давать одинаковый результат.

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

5.3.2    Качество продукта — уровень производительности

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

Примечание — Отправка сообщений пользователю во время ожидания не имеет смысла.

5.3.3    Качество продукта — совместимость

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

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

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

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

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

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

5.3.4 Качество продукта — доступность для использования

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

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

Примечани е — Доступность для понимания может быть обеспечена:

—    правильной терминологией;

—    графическими элементами;

—    предоставлением справочной информации;

—    предоставлением справочной системы;

• четким и легко читаемым текстом или графическими материалами;

—    хорошо распознаваемым на слух аудиоматериалом.

Что касается доступности для использования, сторонам соглашений, заключаемых на базе настоящего стандарта, рекомендуется изучить возможности применения последних версий стандартов серии ИС09241. В частности, разделов 1.2.10—17 стандарта серии ИСО 9241 иИСО 25062.

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

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

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

Примечание — В качестве таких сообщений могут выступать:

—    подтверждения;

—    запросы от программного обеспечения;

—    информация;

—    предупреждения.

12

ГОСТ Р ИСО/МЭК 25051—2017

Содержание

1    Область применения……………………………………………1

2    Соответствие требованиям……………………………………….2

3    Нормативные ссылки…………………………………………..2

4    Термины, определения и сокращения………………………………….2

4.1    Термины и определения……………………………………….2

4.2    Сокращения……………………………………………..2

5    Требования к RUSP……………………………………………5

5.1    Требования к описанию продукта………………………………….5

5.2    Требования к документации пользователя…………………………….5

5.3    Требования к качеству программного обеспечения………………………..9

6    Требования к документации по тестированию…………………………….11

6.1    Общие требования…………………………………………14

6.2    Требования к плану тестирования…………………………………14

6.3    Требования к описанию процедуры тестирования……………………….16

6.4    Требования к результатам тестирования…………………………….17

7    Инструкции по оценке соответствия требованиям…………………………..18

7.1    Общие принципы………………………………………….18

7.2    Предварительные условия для оценки соответствия требованиям………………18

7.3    Мероприятия по оценке соответствия требованиям………………………18

7.4    Процесс оценки соответствия требованиям…………………………..19

7.5    Отчет об оценке соответствия требованиям…………………………..19

7.6    Контроль оценки соответствия требованиям…………………………..20

Приложение А (справочное) Рекомендации по оценке RUSP в приложениях, имеющих критическое

значение для ведения бизнеса или обеспечения безопасности……………21

Приложение В (справочное) Порядок использования настоящего стандарта…………….24

Приложение ДА (справочное) Сведения о соответствии ссылочных международных стандартов

национальным стандартам………………………………25

Библиография………………………………………………..26

Введение

Второе издание ИСО/МЭК 25051 прекращает действие и заменяет первое издание ИСО/МЭК 25051:2006, которое было технически пересмотрено. Это издание также включает в себя Техническую поправку ИСО/МЭК 25051:2006/Кор. 1:2007.

Основные изменения заключаются в следующем:

—    исправлены заголовки на английском и французском языках;

—    внесены изменения в определение готового к использованию программного продукта (RUSP). область его применения и соответствующие примеры;

—    достигнута гармонизация с текущей серией стандартов SQuaRE.

ИСО/МЭК 25051 является составной частью серии международных стандартов SQuaRE, которая состоит из следующих разделов;

—    Управление качеством (ИСО/МЭК 2500п);

—    Модель качества (ИСО/МЭК 2501 п);

—    Измерение качества (ISO/IEC 2502п);

—    Требования к качеству (ИСО/МЭК 2503п);

—    Оценка качества (ИСО/МЭК 2504п);

—    Расширения (ИСО/МЭК 25050—ИСО/МЭК 25099).

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

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

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

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

ИСО/МЭК 25051:2006 разработан на основе ИСО/МЭК 9126-1:2001 и заменяет ИСО/МЭК 12119:1994. Второе издание ИСО/МЭК 25051 представляет собой версию ИСО/МЭК 25051:2006. пересмотренную с целью соответствия ИСО/МЭК 25010:2011. который заменил модель качества ИСО/МЭК 9126-1:2001.

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

IV

НАЦИОНАЛЬНЫЙ СТАНДАРТ РОССИЙСКОЙ ФЕДЕРАЦИИ

Информационные технологии

Системная и программная инженерия

ТРЕБОВАНИЯ И ОЦЕНКА КАЧЕСТВА СИСТЕМ И ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ (SQuaRE)

Требования к качеству готового к использованию программного продукта (RUSP)

и инструкции по тестированию

Information technologies. Systems and software engineering.

Systems and software Quality Requirements and Evaluation (SQuaRE).

Requirements for quality of Ready to Use Software Product (RUSP) and instructions for testing

Дата введения — 2018—03—01

1 Область применения

Настоящий стандарт применяется к готовому к использованию программному продукту (RUSP). Сокращение «RUSP» в настоящем стандарте используется как определение, означающее «готовый к использованию программный продукт».

Примечания

1    Ниже приводится неисчерпывающий список примеров RUSP: текстовые процессоры, таблицы. ПО для управления базами данных, графические пакеты. ПО для работы с встроенными техническими, научными или интерактивными функциями, ПО для управления персоналом, продажами, приложения для смартфонов, бесплатное ПО и веб-приложения, такие как программы для создания веб-сай тов и (или) веб-страниц.

2    Протраммное обеспечение с открытым исходным кодом не относится к RUSP.

Настоящий стандарт устанавливает:

a)    требования к RUSP;

b)    требования к документации по тестированию RUSP. включая план тестирования, описание тестов и их результатов.

Примечание — Набор документов для тестирования называется документацией по тестированию;

c)    инструкции по оценке соответствия RUSP.

В стандарт также входят рекомендации в отношении RUSP. критически важные для безопасности и ведения бизнеса.

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

Целевая аудитория настоящего стандарта включает:

a)    поставщиков, которые:

1)    определяют требования к RUSP:

2)    оценивают собственные программные продукты на предмет соответствия заявленным характеристикам:

3)    выпускают декларации соответствия (см. ИСО/МЭК17050):

4)    обращаются за сертификатами или знаками соответствия (см. Руководство 23 ИСО/МЭК);

b)    сертифицирующие органы, которые могут устанавливать схемы сертификации (международные. региональные или национальные) (см. Руководство 28 ИСО/МЭК):

Издание официальное

c)    испытательные лаборатории, которые должны следовать соответствующим инструкциям в ходе тестирований для выдачи сертификата или знака соответствия (см. ИСО/МЭК 17025);

d)    организации для аккредитации регистрирующих или сертифицирующих органов и лабораторий тестирования;

e)    потенциальных приобретателей, которые могут:

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

2)    осуществлять поиск сертифицированного RUSP;

3)    проверять соответствие требованиям иными способами;

0 конечных пользователей, которые могут извлекать преимущества из программных продуктов более высокого качества;

д) организации;

1)    при создании сред управления и технического оснащения на базе требований к качеству и методов, изложенных в настоящем стандарте;

2)    при управлении и совершенствовании собственных процессов по обеспечению качества «и управления персоналом»;

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

2    Соответствие требованиям

RUSP соответствует настоящему стандарту, если;

a)    обладает свойствами, приведенными в разделе 5;

b)    протестирован в соответствии с документацией по производственному тестированию, которая соответствует требованиям раздела 6;

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

1)    не нарушают заявленный уровень качества;

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

Раздел 7 и приложение А носят справочный характер.

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

3    Нормативные ссылки

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

ISO/IEC 25000 Systems and software engineenng — Systems and software Quality Requirements and Evaluation (SQuaRE) — Guide to SQuaRE (Системная и программная инженерия. Требования к качеству систем и программного обеспечения и их оценка (SQuaRE). Руководство по SQuaRE)

ISO/IEC 25010 Systems and software engineenng — Systems and software Quality Requirements and Evaluation (SQuaRE) — System and software quality models (Системная и программная инженерия. Требования к качеству систем и программного обеспечения и их оценка (SQuaRE). Модели качества систем и программного обеспечения)

4    Термины, определения и сокращения

4.1 Термины и определения

Для целей, предусмотренных настоящим стандартом, используются следующие термины и определения:

2

ГОСТ Р ИСО/МЭК 25051—2017

4.1.1

приобретатель, приобретающая сторона (acquirer): Заинтересованная сторона, которая приобретает или получает продукт или услугу от поставщика.

Примечание — Приобретателем может являться одно из следующих лиц: покупатель, клиент, владелец, заказчик.

(ИСО/МЭК 12207:2008]

4.1.2

несоответствие (anomaly): Любое состояние, не соответствующее ожиданиям, основанным на спецификациях требований, проектной документации, стандартах и пр. либо на чьем-либо восприятии или опыте.

(ИИЭР Std 1044—2009]

4.1.3    функция администрирования приложения (application administration function): Функция, выполняемая пользователем, включая установку, конфигурирование, резервирование приложения, обслуживание (внесение исправлений и модернизация) и удаление.

4.1.4

оценка соответствия (conformity evaluation): Систематический анализ того, насколько продукт, процесс или услуга соответствуют указанным требованиям.

(ИСО/МЭК Guide 2:2004]

4.1.5    отчет об оценке соответствия требованиям (conformity evaluation report): Документ, описывающий проведение и результаты оценки RUSP.

Примечание — Адаптация из ИИЭР610.12—1990.

4.1.6    готовый к использованию программный продукт, RUSP (Ready to Use Software Product, RUSP): Программный продукт, доступный для любого пользователя за плату или без нее и готовый к использованию без дополнительной разработки.

Примечания

1    8 определение RUSP входят:

—    описание продукта (включая всю информацию, указанную на упаковке, спецификацию, информацию с интернет-сайта и пр.);

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

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

2    Программное обеспечение в основном состоит из программ и данных.

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

4.1.7

конечный пользователь (end user): Физическое лицо, которое в конечном итоге извлекает преимущества из функциональности готового к использованию программного продукта.

Примечание — Конечный пользователь может быть штатным оператором программного продукта или случайным пользователем, например человеком со стороны.

(ИСО/МЭК 25000:2005]

ошибка (fault): Неверный шаг. процесс или определение данных в компьютерной программе. (ИИЭР Std 610.12—1990]

4.1.8

3

4.1.9

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

(ИИЭР Std 610.12—19901

4.1.10

критерии прохождения или непрохождения (pass/fail criteria): Правила принятия решений о том. пройдено ли или не пройдено элементом или функцией программного обеспечения некое испытание.

(ИИЭР Std 829.12—1998)

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

4.1.12    идентификация продукта (product identification): Название программного продукта, версия, модификация и дата выпуска.

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

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

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

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

4.1.15

тестовая среда программного обеспечения (software test environment): Средства, оборудование. программное обеспечение, встроенные программы, процедуры и документация, необходимые для проведения квалификации или иного тестирования программного обеспечения.

(ИСО/МЭК/ИИЭР 24765:2010)

4.1.16

поставщик (supplier): Юридическое или физическое лицо, заключающее соглашение с приобретателем о поставке продукта или услуги.

Примечания

1    В качестве «поставщика» может также выступать подрядчик, производитель, продавец или разработчик.

2    Иногда приобретатель и поставщик могут входить в одну организацию.

(ИСО/МЭК 12207:2008)

4.1.17

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

(ИИЭР Std 610.12—1990)

4.1.18

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

(ИИЭР Std 610.12—1990)

ГОСТ РИСО/МЭК 25051—2017

4.1.19    документация потестированию (test documentation): Набор документации, относящейся к мероприятиям по тестированию.

4.1.20    цель тестирования (test objective): Определенный набор характеристик программного обеспечения, измеряемых при определенных условиях путем сравнения фактического режима работы с требуемым.

Примечание — Адаптация ИИЭР Std 610.12—1990.

4.1.21    план тестирования (test plan): Документ, описывающий покрытие, метод, ресурсы и график намеченных мероприятий по тестированию.

Примечание — Адаптация ИИЭР Std 610.12—1990.

4.1.22

процедура тестирования (test procedure): Подробные инструкции по настройке, выполнению и анализу результатов для определенного контрольного примера.

(ИИЭР Std 610.12—1990)

4.1.23

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

(ИИЭР Std 610.12—1990)

4.1.24    описание тестирования (testing description): Описание условий проведения тестирования (т. е. процедуры тестирования).

4.1.25

пользователь (user): Частное лицо или группа лиц, пользующихся RUSP в процессе эксплуатации.

Примечание — Роль пользователя и роль оператора может быть одновременно или последовательно возлагаться на одно и то же частное лицо или организацию.

(ИСО/МЭК 12207:2008)

4.1.26    документация пользователя (userdocumentation): Информация, поставляемая вместе с программным обеспечением для помощи пользователям в работе с ним.

4.2 Сокращения

RUSP — готовый к использованию программный продукт;

СМ — управление конфигурацией;

SQA — гарантия качества программного обеспечения;

SQC — контроль качества программного обеспечения.

5 Требования к RUSP

5.1    Требования к описанию продукта

Примечание — Информация, указанная на упаковке согласно ИСО/МЭК 9127 «Программная инженерия. Документация пользователя и информация, указанная на упаковке», может использоваться в качестве исходных данных для создания описания продукта.

5.1.1    Доступность

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

5.1.2 Содержание

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

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

5.1.2.3    Описание продукта не должно содержать внутренних противоречий.

5

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

5.1.3 Идентификация и указатели

5.1.3.1    В описании продукта отображается уникальный идентификатор.

5.1.3.2    RUSP идентифицируется по обозначению изделия.

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

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

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

5.1.3.6    В описании продукта должно указываться, предлагается ли поддержка RUSP.

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

5.1.4    Преобразование данных

5.1.4.1    Все упомянутые в описании продукта функции должны классифицироваться в соответствии с требованиями к качеству характеристик программного обеспечения (см. 5.3.2—5.3.9).

5.1.5    Качество продукта — функциональная пригодность

5.1.5.1    Если это применимо, описание продукта должно содержать сообщение о функциональной пригодности с учетом функциональной полноты, функциональной правильности и функционального соответствия. Это сообщение должно быть изложено таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

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

Примечания

1    Такими критическими дли пользователя дефектами могут быть:

—    потеря данных;

—    зависание.

2    Для получения дополнительной информации см. ИСО/МЭК 15026.

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

Примечание — Такими ограничениями могут быть:

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

—    длина ключей;

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

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

—    минимальный размер выборки.

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

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

5.1.6    Качество продукта — уровень производительности

5.1.6.1    Описание продукта должно содержать сообщения об уровне производительности с учетом характера изменений во времени, использования ресурсов и возможности системы. Эти сообщения должны быть изложены таким образом, чтобы можно было продемонстрировать подтверждаемые свидетельства соответствия на основе ИСО/МЭК 25010.

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

Примечание — Такими условиями могут быть;

• конфигурации системы;