Лекция №10

Лекция №14

ГОСТ Р ИСО/МЭК 12119:1994, Информациоян’,я техяологю Пакеты программных средств. Требования к качеству и испытаяш’ В этом стандарте установлены требования к качеству пакетов про)IММ и инструкции по их испытаниям на соответствие заданным сбованиям. Понятие «пакет программных средств» фактически 1 о>iществляется с более общим понятием «программный продукт», рлссматриваемым как совокупность программ, процедур и правил, н )ставляемых нескольким пользователям для общего применения нии функционирования. Каждый пакет программ должен иметь

исание продукта и пользовательскую документацию.

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

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

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

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

1ЮДУКТ в «Описании продукта» и пользовательской докумен.нщи. Требования к программам и данным в основном сводятся

1 утверждению необходимости соответствия реальных свойств

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

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

• требования к описанию продукта. В частности, требования, со‚Л НО которому описание продукта должно содержать конкретную информацию, а все приводимые в нем формулировки должны быть проверяемыми (контролируемыми) и корректными;

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

• требования к любым программам и данным, входящим в состав пакета программ.

Описание продукта. Описание продукта

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

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

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

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

1. Общие требования к содержанию.

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

З. Функциональные возможности.

4. Надежность.

5. Практичность.

6. Эффективность.

7. Сопровождаемость и мобильность.

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

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

• быть внутренне непротиворечивьим. Каждый термин должен иметь один и тот же смысл по всему документу;

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

указания и обозначения:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. обзор функций.

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

продукта;

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

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

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

2. Граничные значения.

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

описании продукта. Например:

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

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

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

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

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

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

З. Защита.

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

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

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

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

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

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

1. Интерфейс пользователя. Должен быть назван тип интерфейса пользователя, например:

• строка команд;

• меню;

• окна;

• функциональная клавиша;

• функция подсказки и др.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Программы и данные

Функциональные возможности

1. Установка (инсталяция).

1 если установка пакета может быть выполнена пользователем,

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

i соответствующих сообщений.

2. Реализация функций.

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

соответствующих средствах, с соответствующими характеристиками и данными, в рамках граничных значений, заданных

.,м же.

З. Правильность.

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

4. Непротиворечивость.

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

руктурированы.

Надежность

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

Это требование должно одинаково удовлетворяться в случях, когда:

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

• имеют место попытки реализации возможности вне заданы ограничений;

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

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

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

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

Практичность

1. Поояiяносяь.

Запросы, сообщения и результаты выполнения программ д’

жньт быть понятными, например:

• путем соответствующего выбора терминов;

• путем графических представлений;

• путем представления исходной информации;

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

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

2. Простота обозрения.

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

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

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

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

* одтверждение приема;

* ‘апросьг от программ;

* 1 редупреждения;

• iообщения об ошибках.

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

• 1 iфавитно-цифровые поля и левостороннее выравнивание;

• поля и правостороннее выравнивание;

• расположение в таблицах десятичных точек или запятых на щной вертикальной линии;

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

• иютветствующее распознавание полей, использование которых язательно;

казание ошибок ввода непосредственной засветкой на входном экране;

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

З. Простота использования.

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

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

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

Эффективность, сопровождаемость, мобильность (переносимость)

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

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

Найти на этой странице