242
Управление изменениями с использованием ClearQuest Новичков Александр Новичков Александр www.cmcons.com [email protected] [email protected]

Управление изменениями с использованием ClearQuest

  • Upload
    gisela

  • View
    115

  • Download
    15

Embed Size (px)

DESCRIPTION

Управление изменениями с использованием ClearQuest. Новичков Александр www.cmcons.com [email protected]. Часть 1. Введение. Процесс управления изменениями. Контролируемая обработка запросов (поручения, отчеты о выполнении, ошибки…) в соответствии с заранее определенным процессом - PowerPoint PPT Presentation

Citation preview

Page 1: Управление изменениями с использованием  ClearQuest

Управление изменениями с

использованием ClearQuest Новичков АлександрНовичков Александр[email protected]@cmcons.com

Page 2: Управление изменениями с использованием  ClearQuest

Часть 1.Введение

Page 3: Управление изменениями с использованием  ClearQuest

Процесс управления изменениямиПроцесс управления изменениями

• Контролируемая обработка запросов (поручения, отчеты о выполнении, ошибки…) в соответствии с заранее определенным процессом

• Работа с различными типами запросов• Настраиваемый набор атрибутов и состояний запросов на

изменения• Формирование отчетов произвольного образца• Создание разнообразных графиков (текущее состояние,

статистика, тенденции)• Автоматическое уведомление исполнителей о ходе

обработки запросов по электронной почте• Контроль и внесение изменений через Интернет• Широкие возможности по адаптации

• Инструмент поддержки процесса управления изменениями – IBM Rational ClearQuest

Page 4: Управление изменениями с использованием  ClearQuest

Понятие запроса на изменениеПонятие запроса на изменение

• Запрос на изменение– Это любое требование изменить артефакт или процесс

• Виды запросов на изменения:– Требование исправить ошибку (Defect);– Требование изменить функционал (EnhancementRequest);– Требование выполнить работу (Activity, Task).

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

– Анализ запроса;– Принятие решения;– Выполнение;– Контроль;– Закрытие запроса.

Page 5: Управление изменениями с использованием  ClearQuest

Основные задачиОсновные задачи

• Сбор запросов на изменения.• Хранение запросов в базах данных.• Приведение в действие системы

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

запросов.• Мониторинг запросов на изменения.• Анализ общего состояния системы

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

Page 6: Управление изменениями с использованием  ClearQuest

Связь запроса на изменения с Связь запроса на изменения с требованиями (требованиями (requirements)requirements)

• Требование (requirement) описывает свойство системы или условие, которому должна удовлетворять система;

• Запрос на изменение (change request) - это требование внести изменение в систему, чтобы она удовлетворяла определенным свойствам или условиям;

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

• Требования могут возникать как результат анализа запросов на изменения.

Page 7: Управление изменениями с использованием  ClearQuest

Управление изменениями в Управление изменениями в RUPRUP

• Имеется два тесно связанных процесса: управление конфигурацией и управление изменениями.

• Инструмент управления конфигурацией – ClearCase, инструмент управления изменениями – ClearQuest.

C3B5A4

A1 B1 C1

CRCR

.EXE

Change Request M anagem ent (CRM )

M easurem ent

Configuration M anagem ent (C M )

Page 8: Управление изменениями с использованием  ClearQuest

Компоненты Компоненты ClearQuestClearQuest

• ClearQuest – инструмент пользователя• CleatQuest Designer – инструмент

администратора• CQ Web – инструмент пользователя для

работы через Интернет• CQ Maintenance Tool – утилита для

настройки работы с базой данных (репозиторием)

• CQ Export – утилита экспорта данных• CQ Import – утилита импорта данных

Page 9: Управление изменениями с использованием  ClearQuest

Четыре области модификации Четыре области модификации ClearQuestClearQuest

1. Процесс: Модель процессов.

1. Данные: Таблицы баз данных.

2. Представление данных: Формы.

3. Анализ данных: Запросы, Таблицы, Отчеты.

Page 10: Управление изменениями с использованием  ClearQuest

Интеграция Интеграция ClearQuest ClearQuest с продуктами с продуктами RationalRational

• Для организации интегрированного процесса разработки, тестирования и сопровождения ПО, имеется возможность интегрировать ClearQuest с другими продуктами Rational Software:– Интеграция с RequisitePro позволяет связывать

запросы на изменения с требованиями, которые эти изменения затрагивают;

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

Page 11: Управление изменениями с использованием  ClearQuest

Часть 2.Планирование управления

запросами на изменение

Page 12: Управление изменениями с использованием  ClearQuest

Назначение и состав процесса Назначение и состав процесса управления запросами на измененияуправления запросами на изменения

• Основные задачи процесса CRM (Change Request Management):

– Улучшение качества продукта или услуги;– Повышение степени удовлетворенности пользователей;– Организация рабочего процесса, вовлекающего различные рабочие

группы.

• Основные действия, выполняемые в процессе CRM:– Инициация запроса;– Назначение исполнителей и сроков;– Выполнение запроса;– Проверка выполнения;– Формальное закрытие запроса (если необходимо).

• Важные составляющие процесса CRM:– Совместный доступ к информации о запросах на изменения;– Выделение ресурсов для выполнения запросов;– Принятие единой модели процесса.

Page 13: Управление изменениями с использованием  ClearQuest

Планирование процесса Планирование процесса CRMCRM

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

• В рамках системы должны быть доступны следующие ресурсы:– Принятие решений по процессу обработки запросов;– Экспертиза принятия решений по запросам;– Возможность оценки результатов выполнения

запросов.

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

Page 14: Управление изменениями с использованием  ClearQuest

Порядок ввода в действие процесса Порядок ввода в действие процесса CRMCRM

1. Определите область действия процесса управления запросами на изменение.

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

3. Постройте модель процесса.

4. Определите основных исполнителей и последовательность их действий.

5. Подготовьте план ввода в действие.

6. Запустите систему CRM

Page 15: Управление изменениями с использованием  ClearQuest

Основные элементы модели процессаОсновные элементы модели процесса CRMCRM

• Диаграмма состояний запросов;• Набор правил обработки запросов;• Унифицированная форма ввода информации;• Критерии прекращения обработки запроса;• Процедура рассмотрения поступающих запросов;• Поддержка взаимодействия участников процесса;• Оценка полученных результатов;• Система показателей (метрик), характеризующих

процесс исполнения.

Page 16: Управление изменениями с использованием  ClearQuest

Диаграмма действий типового процесса Диаграмма действий типового процесса CRMCRM

Page 17: Управление изменениями с использованием  ClearQuest

Диаграмма состояний типового процесса Диаграмма состояний типового процесса CRMCRM

Page 18: Управление изменениями с использованием  ClearQuest

Основные участники процесса Основные участники процесса CRMCRM

• Инициатор (Submitter)– Лицо, инициировавшее запрос

• Комитет управления изменениями(CCB - Change Control Board)

– Орган, анализирующий поступившие запросы и определяющий способ их обработки

• Исполнитель (Solution Provider)– Специалист, выполняющий запрос

• Тестировщик (Tester)– Специалист, оценивающий правильность выполнения запроса

• Заинтересованное лицо (Stakeholder)– Лицо, заинтересованное в результате выполненной работы

Page 19: Управление изменениями с использованием  ClearQuest

Обработка запроса на изменение в Обработка запроса на изменение в Rational Unified Process (RUP)Rational Unified Process (RUP)

Page 20: Управление изменениями с использованием  ClearQuest

Содержание плана ввода в действие Содержание плана ввода в действие процесса процесса CRMCRM

• Классификация запросов на изменения;• Определение процедуры интеграции CRM в рабочий

процесс разработки;• Рассмотрение альтернативных способов снижения

частоты возникновения повторяющихся запросов;• Обеспечение возможности расширения процесса;• Правила пересмотра модели процесса;• Определение процедуры поддержания

согласованности информации.

Page 21: Управление изменениями с использованием  ClearQuest

Ключевые критерии успешной работы Ключевые критерии успешной работы системы системы CRMCRM

• Возможность обработки различных видов запросов;

• Возможность доступа в систему из любого места и в любое время;

• Возможность модификации системы при изменении процесса или правил обработки запросов;

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

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

Page 22: Управление изменениями с использованием  ClearQuest

При организации процессаПри организации процесса CRM CRM необходимо принять во внимание:необходимо принять во внимание:

• Существование унаследованной системы отслеживания ошибок;

• Соответствие выбранной СУБД масштабам процесса;

• Сложность интеграции CRM в установленные производственные процессы;

• Краткосрочное и долгосрочное сопровождение;• Дальнейшее развитие и технологическое

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

Page 23: Управление изменениями с использованием  ClearQuest

Модификация системы Модификация системы CRMCRM

• Существенная модификация:– Поставляемая модель процесса CRM не соответствует

установленной практике;– Имеются другие виды запросов, которые необходимо

включить в систему;– Необходимо ввести новые правила управления CRM.

• Незначительная модификация:– Добавление новых полей описания запросов;– Изменение формата экранных форм;– Изменение интерфейса.

Page 24: Управление изменениями с использованием  ClearQuest

Контроль модификации системы Контроль модификации системы CRMCRM

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

• Документируйте внесенные изменения при выполнении существенной модификации;

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

• Старайтесь избегать частых модификаций, чтобы минимизировать вмешательство в работу установленных процессов CRM

Page 25: Управление изменениями с использованием  ClearQuest

ЗаключениеЗаключение

• Внедрение системы CRM требует четкого понимания ее назначения;

• Процесс обработки запросов на изменения – дело всей проектной команды;

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

• Система CRM – эффективный механизм решения проблем.

Page 26: Управление изменениями с использованием  ClearQuest

Часть 3.Функции пользователя

Page 27: Управление изменениями с использованием  ClearQuest

Платформы Платформы ClearQuest, ClearQuest, доступные доступные пользователюпользователю

• Clear Quest Windows Client– Windows NT, Windows 2000– Windows 95, 98, Me– Solaris– HPUX

• Clear Quest Internet Web Client– Microsoft Internet Explorer– Netscape Navigator

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

Page 28: Управление изменениями с использованием  ClearQuest

Вход в системуВход в систему

• При входе в ClearQuest пользователь:– Выбирает базу данных, к которой будет

подключаться;– Вводит свое имя (логин);– Вводит пароль.

Page 29: Управление изменениями с использованием  ClearQuest

Структура рабочего окна Структура рабочего окна ClearQuestClearQuest

Рабочая область (выборки данных).

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

Общие (public) выборки видны всем пользователям.

Выборки бывают трех видов:•обычные выборки•отчеты•графики.

Меню и панель инструментов

Место вывода результатов отработки выборок данных (форм, отчетов, графиков)

Page 30: Управление изменениями с использованием  ClearQuest

Типы записей Типы записей ClearQuestClearQuest

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

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

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

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

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

Page 31: Управление изменениями с использованием  ClearQuest

Ввод новой записи (инициация запроса)Ввод новой записи (инициация запроса)

Нажмите стрелку рядом с кнопкой "New Defect" панели инструментов, затем выберите нужный тип записи

ИЛИ

Выберите в меню пункт "Actions/New", затем выберите нужный тип записи

Page 32: Управление изменениями с использованием  ClearQuest

Формы Формы ClearQuestClearQuest

• В ClearQuest можно использовать разные формы для ввода новой записи и для просмотра существующих записей

• Форма ввода новой записи называется формой инициации (submit form) и обычно содержит небольшое количество полей

• Форма просмотра (record form) содержит все атрибуты записи

• Можно использовать одну форму как для инициации, так и для просмотра записей

Page 33: Управление изменениями с использованием  ClearQuest

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

Поля, обязательные

для заполнения, выделены

красным цветом.

Вкладки, содержащие

обязательные поля, отмечены

красным квадратом

перед именем

Кнопка Values (только в форме инициации) позволяет избегать повторного ввода данных при последовательных инициациях записей. Пункты "Save as Default" и

"Load Default" выполняют запоминание заполненных полей и загрузку запомненных значений в новую форму

Page 34: Управление изменениями с использованием  ClearQuest

Часто используемые вкладки формЧасто используемые вкладки форм

Вкладка "History" содержит информацию об истории изменений

записи

Вкладка "Notes" позволяет вводить заметки при выполнении действий

над записью. Введенные заметки сохраняются в поле "Notes Log" и

редактированию не подлежат

Вкладка "Attachments" позволяет присоединять к записи файлы.

Присоединенные файлы хранятся в базе данных и извлекаются для просмотра или редактирования

кнопкой "Open"Кнопка "Save As" позволяет извлечь и сохранить файл вложения на диск

Page 35: Управление изменениями с использованием  ClearQuest

Просмотр записейПросмотр записей

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

Page 36: Управление изменениями с использованием  ClearQuest

Выполнения действия над записьюВыполнения действия над записью

Нажмите стрелку справа от кнопки "Change State" панели

инструментов

ИЛИВыберите в меню пункт

"Actions", затем выберите из списка нужное действие

ИЛИ

Нажмите кнопку "Actions" в форме просмотра записи, затем выберите из списка

нужное действие

Page 37: Управление изменениями с использованием  ClearQuest

Завершение действия над записьюЗавершение действия над записью

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

Page 38: Управление изменениями с использованием  ClearQuest

CQ Web: CQ Web: Просмотр результатов выборкиПросмотр результатов выборки

Переход к форме

просмотра осуществляется

по ссылке в списке (номеру

записи)

Page 39: Управление изменениями с использованием  ClearQuest

CQ Web: CQ Web: Работа с формамиРабота с формами

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

Page 40: Управление изменениями с использованием  ClearQuest

Структура выборки данных (Структура выборки данных (Query)Query)

Вкладка "Result set" содержит результат выполнения выборки

данных

Вкладка "Display editor" определяет поля, включаемые в список результата выборки

Вкладка "Query editor" позволяет определить

фильтры, ограничивающие выбираемые записи

Page 41: Управление изменениями с использованием  ClearQuest

Создание выборки данных (1)Создание выборки данных (1)

Выбирается пункт меню "Query/New Query"

Из появившегося списка выбирается требуемый тип записи

Запускается мастер создания выборки. На его первом экране можно выбрать существующую выборку для переопределения (кнопка "Browse"), или начать создание новой выборки

Page 42: Управление изменениями с использованием  ClearQuest

Создание выборки данных (2)Создание выборки данных (2)

Последовательно заполняются экраны определения выводимых полей и фильтров

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

выводятся на экран

Page 43: Управление изменениями с использованием  ClearQuest

Создание выборки данных (3)Создание выборки данных (3)

• Сохранение выборки производится выбором пункта меню "File/Save As" и вводом имени выборки

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

• При необходимости можно вывести на печать записи выборки, выбрав пункт меню "File/Print Grid"

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

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

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

Page 44: Управление изменениями с использованием  ClearQuest

Просмотр записей, инициированных в Просмотр записей, инициированных в текущей сессии работытекущей сессии работы

Выберите пункт меню "Query/Recently Submitted"

В появившемся списке выберите нужный тип записи

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

Page 45: Управление изменениями с использованием  ClearQuest

Виды графовВиды графов

Временные (aging) графики содержат данные, связанные со временем.

Пример: "возраст" дефектов по состояниям

Графики распределения (distribution) показывают распределение записей по значениям их характеристик.Пример: Распределение количества дефектов по приоритетам

Графики тенденций (trend) показывают динамику изменения характеристик

записей.Пример: Еженедельное распределение

количества дефектов по приоритетам

Дополнительные сведения об объектах графиков могут быть получены щелчком мыши по объекту (функция drill down)

Page 46: Управление изменениями с использованием  ClearQuest

Создание графика (1)Создание графика (1)

1. Выберите пункт меню "Query/New Chart"

2. В появившемся списке выберите тип записи

3. Выберите вид графика (распределение, тенденции, временной)

4. На одном или нескольких экранах (в

зависимости от типа графика) определите его

характеристики

Page 47: Управление изменениями с использованием  ClearQuest

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

График можно сохранить, выбрав пункт меню "File/Save".

Таблицу результатов запроса (Grid) и График (Chart) можно вывести на печать, выбрав пункт меню "File/Print ...", экспортировать в файл, выбрав пункт меню "File/Export ..."

Если перед выбором указанных пунктов меню щелкнуть мышью по таблице с результатами отработки запроса, то печататься и экспортироваться будет эта таблица. Пункты меню будут называться "File/Print Grid" и "File/Export Grid";Если перед выбором указанных пунктов меню щелкнуть мышью по графику (картинке), то печататься и экспортироваться будет график. Пункты меню будут называться "File/Print Chart" и "File/Export Chart";Как и другие выборки данных, графики можно сохранять ("File/Save") и перетаскивать мышью в требуемые папки рабочего пространства.

Page 48: Управление изменениями с использованием  ClearQuest

Отчеты Отчеты ClearQuestClearQuest

• Отчеты ClearQuest имеют следующую структуру:– Формат отчета (Report Format) определяет

внешний вид (форматирование) отчета;– Выборка данных (Query) поставляет данные для

отчета;– Отчет (Report) объединяет выборку данных и

формат для получения собственно отчета.

• Для создания и изменения формата отчета используется продукт Crystal Reports компании Seagate (специальная лицензия "Crystal Reports for Rational" поставляется вместе с ClearQuest).

• Для выполнения отчетов (без изменения формата) Crystal Reports не требуется.

Page 49: Управление изменениями с использованием  ClearQuest

СозданиеСоздание формата отчета (формата отчета (11))1. Создайте выборку данных для отчета;2. Выберите пункт меню "Query/New Report Format";3. Выберите тип записи в появившемся списке;4. Добавьте в правую часть экрана поля, которые нужно включить в отчет;

5. Нажмите кнопку "Author Report" для перехода в Crystal Reports. ClearQuest формирует сведения об исходных данных для отчета и передает их в Crystal Reports. (Авторизация формата должна также проводиться при его модификации.)

Page 50: Управление изменениями с использованием  ClearQuest

Создание формата отчета (Создание формата отчета (22))переход в переход в Crystal ReportsCrystal Reports

• Crystal Reports получает при запуске сформированный автоматически в ClearQuest отчет, который затем будет храниться в ClearQuest в виде встроенного объекта, не требующего для своего выполнения наличия Crystal Reports.

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

Page 51: Управление изменениями с использованием  ClearQuest

Создание формата отчета (Создание формата отчета (33)) настройка опций настройка опций Crystal ReportsCrystal Reports

• Выберите пункт меню "File/Options";

• Установите следующие опции (название опции дается парой <Вкладка формы.Опция>):– Layout.Start With = Fit Width;– Reporting.Date-time field = Keep Date-Time Type;– Reporting.Save Data With Report = Off;– Database.Case-Insensitive SQL Data = On;

• Отключите опцию "File/Save Data With Report" главного меню;

• Сохраните установленные опции, нажав кнопку "OK"

Page 52: Управление изменениями с использованием  ClearQuest

Создание формата отчета (4)Создание формата отчета (4) форматирование отчета в форматирование отчета в Crystal ReportsCrystal Reports

• Выберите пункт меню "Insert/Database Field"

• Из появившегося окна перетащите мышью поля на поверхность отчета в нужные разделы. Переданные из ClearQuest поля находятся в разделе "Database Fields/<Название_отчета>_ttx"

• Закончите форматирование отчета (порядок работы с Crystal Reports смотрите в оперативной подсказке к этому продукту)

Page 53: Управление изменениями с использованием  ClearQuest

Создание формата отчета (Создание формата отчета (55)) завершение форматирования завершение форматирования

• Просмотрите вид отформатированного отчета, выбрав пункт меню "File/Print Preview"

• Сохраните формат отчета, не меняя его имени ("File/Save"), закройте Crystal Reports ("File/Exit")

• Вернувшись в окно редактирования формата отчета ClearQuest, нажмите кнопку "OK"

• В появившемся окне с сообщением "Commit report format changes to database"нажмите кнопку "OK"

• В рабочей области в папке "Personal Queries" появится новый формат отчета. Введите для него требуемое название. Если необходимо, перетащите созданный формат в нужную папку рабочей области

Page 54: Управление изменениями с использованием  ClearQuest

Создание отчетаСоздание отчета

• Выберите пункт меню "Query/New Report";• В появившемся окне выберите формат отчета и выборку данных;

• Запустите отчет, нажав на кнопку "OK".Результаты отчета будут выведенына экран;

• Для сохранения созданного отчета выберите пункт меню "File/Save", либо закройте окно с результатами отчета и в открывшемся окне сохранения введите имя отчета.

Page 55: Управление изменениями с использованием  ClearQuest

Просмотр результатов отчетаПросмотр результатов отчета

• Выполнение отчета производится:– Двойным щелчком мыши по символу

отчета в рабочей области;– Выбором отчета в рабочей области, затем

нажатием кнопки "Run Report";– Выбором пункта меню "Query/Run".

• Результаты отчета выводятся в правой части экрана.

• Выполненный отчет (отформатированные данные) можно:

– Вывести на печать;– Экспортировать в несколько форматов.

Кнопки для вывода на печать и экспорта выполненного отчета

Page 56: Управление изменениями с использованием  ClearQuest

Часть 4.Схемы и пакеты

Page 57: Управление изменениями с использованием  ClearQuest

Схема Схема ClearQuestClearQuest

•Модель процесса•Поля•Формы•Коды хуков (hooks)

Схема CQ представляет собой хранилище, определяющее конфигурацию приложения ClearQuest

Page 58: Управление изменениями с использованием  ClearQuest

Репозиторий схем и базы данных Репозиторий схем и базы данных пользователяпользователя

Запись 1

CQ Designer ClearQuest

Репозиторий схем

База данных пользователя

Схема А версия 1

Схема А версия 2

Экземпляр схемы А варианта 1

Запись 2Запросы на измененияЗапись 3

Page 59: Управление изменениями с использованием  ClearQuest

Версии схемВерсии схем

Схема А, в1

Схема А, в2

Схема А, в3

Схема Б, в1

Схема Б, в2

Репозиторий схем

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

Page 60: Управление изменениями с использованием  ClearQuest

ПакетПакет

• Спецификация процесса• Поля• Формы• Специальные хуки• Запросы, диаграммы и отчеты

Пакет ClearQuest – набор системных конфигураций и настроек для какого-либо свойства или функции.В поставку ClearQuest входит набор пакетов для реализации наиболее типичных функций (работы с электронной почтой, журналирования изменений, интеграции с другими продуктами Rational и т.д.)

Page 61: Управление изменениями с использованием  ClearQuest

Взаимосвязь между схемами и пакетамиВзаимосвязь между схемами и пакетами

• Одна схема определяет одно приложение CRM, а пакет-одну функцию или свойство;

• Пакеты – функционально обособленные метаданные, которые хранятся отдельно от схем;

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

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

Page 62: Управление изменениями с использованием  ClearQuest

Предопределенные схемы Предопределенные схемы ClearQuestClearQuest

• Blank - минимальная конфигурация для построения схемы "с нуля";

• Common – содержит метаданные, общие для всех схем (кроме Blank);

• Defect Tracking – типовое приложение отслеживания дефектов;

• Analyst Studio – интеграция с Analyst Studio;• Development Studio - интеграция с Development Studio;• Test Studio- интеграция с Test Studio;• Unified Change Management - интеграция с UCM;• Enterprise - интеграция с Enterprise Studio.

Page 63: Управление изменениями с использованием  ClearQuest

Предопределенные типы записей Предопределенные типы записей ClearQuestClearQuest

• Записи с состояниями– Defect (ошибка)– Enhancement Request (запрос на развитие)– BaseCMActivity (базовая задача конфигурационного управления)– UCMUtilityActivity (утилита UCM)

• Записи без состояний– Users (пользователи)– Groups (группы)– History (история)– Attachments (вложения)– Email_Rule (правила оповещения)– Repoproject (проект из репозитория Rational)– Requirement (требование)– Project (проект)– Customer (заказчик)– UCM_Project (UCM - проект)

Page 64: Управление изменениями с использованием  ClearQuest

ПакетыПакеты,, доступные в доступные в ClearQuest (1)ClearQuest (1)

• Пакеты общего назначения– Attachments (Приложения)– Email (Электронная почта)– History (История)– Notes (Заметки)– Resolution (Выполнение)

• Пакеты, предназначенные для отслеживания ошибки– Project (Проект)– Customer (Заказчик)

• Пакеты, предназначенные для интеграции c UCM– BaseCMActivity (базовая задача конфигурационного управления)– UCMPolicyScripts (Скрипты UCM)– UnifiedChangeManagement (унифицированное управление

изменениями)

Page 65: Управление изменениями с использованием  ClearQuest

Пакеты доступные в Пакеты доступные в ClearQuest (2)ClearQuest (2)

• Пакеты, предназначенные для интеграции с Rational Suites– Repository– PQC– TeamTest– RequisitePro– Enhancement Request

• Пакеты, предназначенные для интеграции со средствами конфигурационного управления– Clear Case– VisualSourceSafe

Page 66: Управление изменениями с использованием  ClearQuest

Схема Схема DefectTrackingDefectTracking

• Записи с состояниями– Defect

• Записи без состояний– Email-Rule, Customer, Project

• Основные встроенные пакеты– Customer, Email, Project, Resolution

• Область применения– Отслеживание ошибок в процессе разработки

программного обеспечения

Page 67: Управление изменениями с использованием  ClearQuest

Схема Схема AnalystStudioAnalystStudio

• Записи с состояниями– Defect, EnhancementRequest

• Записи без состояний– Email-Rule, Requirement, RepoProject

• Основные встроенные пакеты– Email, Enhancement Request, Repository, RequisitePro, Resolution

• Область применения– Использование с Rational Suite Analyst Studio в управлении

требованиями

Page 68: Управление изменениями с использованием  ClearQuest

Схема Схема DevelopmentStudioDevelopmentStudio

• Записи с состояниями– Defect, EnhancementRequest

• Записи без состояний– Email-Rule, Requirement, RepoProject

• Основные встроенные пакеты– Email, Enhancement Request, Repository, RequisitePro, Resolution

• Область применения– Использование с Rational Suite Development Studio в разработке

программного обеспечения

Page 69: Управление изменениями с использованием  ClearQuest

Схема Схема TestStudioTestStudio

• Записи с состояниями– Defect, EnhancementRequest

• Записи без состояний– Email-Rule, Requirement, RepoProject

• Основные встроенные пакеты– Email, Enhancement Request, Repository, RequisitePro,

TeamTest, Resolution

• Область применения– Использование c Rational Suite Test Studio в процессе

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

Page 70: Управление изменениями с использованием  ClearQuest

Схема Схема UnifiedChangeManagement (UCM)UnifiedChangeManagement (UCM)

• Записи с состояниями– Defect, BaseCMActivity, UCMUtilityActivity

• Записи без состояний– Email-Rule, UCM-Project

• Основные встроенные пакеты– BaseCMActivity, Email, Resolution, UCMPolicyScripts,

UnifiedChangeManagement

• Область применения– Использование Rational UCM для управления изменениями и

конфигурациями программного обеспечения

Page 71: Управление изменениями с использованием  ClearQuest

Схема Схема EnterpriseEnterprise

• Записи с состояниями– Defect, BaseCMActivity, UCMUtilityActivity,

EnhancementRequest

• Записи без состояний– Email-Rule, Requirement, UCM-Project, RepoProject

• Основные встроенные пакеты– BaseCMActivity, Email, Enhancement Request, PQC,

Repository, RequisitePro, Resolution, TeamTest, UCMPolicyScripts, UnifiedChangeManagement

• Область применения– Использование Rational Suite Enterprise для управления

всем процессом создания программного обеспечения.

Page 72: Управление изменениями с использованием  ClearQuest

Процедура применения пакета к схемеПроцедура применения пакета к схеме

1. Проинсталлируйте пакет на машину, используемую администратором CQ (обычно все пакеты инсталлируются вместе с ClearQuest)

2. Загрузите пакет в схему

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

4. Проверьте схему после применения пакета

5. Обновите версию схемы и базу данных пользователя

Page 73: Управление изменениями с использованием  ClearQuest

Изменения, вносимые при загрузке Изменения, вносимые при загрузке пакетапакета

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

• Во время активизации типа записи:– Добавляются или модифицируются поля, действия, состояния,

формы, хуки типа записи– Запускаются специфичные для пакета проверки схемы

• Во время создания или обновления базы данных пользователя:

– Добавляются запросы, специфические для данного пакета

Page 74: Управление изменениями с использованием  ClearQuest

Модификация Модификация ClearQuest (1)ClearQuest (1)

• Что Вы можете делать:– Использовать существующую версию схемы для

создания новой схемы;

– Применять пакеты для расширения функций схемы;

– Создавать или изменять:• Поля и действия для типов записей • Состояния типов записей с состояниями• Формы инициализации и просмотра записей• Коды хуков для расширения процесса управления

изменениями• Связи с внешними программами• Выборки данных, графики, отчеты.

Page 75: Управление изменениями с использованием  ClearQuest

Модификация Модификация ClearQuest (2)ClearQuest (2)

• Чего Вы не можете делать:– Вернуться к предыдущей версии схемы или

удалить внесенные (check-in) в репозиторий модификации;

– Отменить применение пакета к схеме;

– Изменить или уничтожить:• Относящиеся к установленным пакетам типы записей;• Поля и действия, предназначенные только для чтения;• Функции программного интерфейса (API) Clear Quest.

Page 76: Управление изменениями с использованием  ClearQuest

Часть 5.ClearQuest Designer

Page 77: Управление изменениями с использованием  ClearQuest

Основные функции Основные функции ClearQuest DesignerClearQuest Designer

• ClearQuest Designer - графический интерфейс пользователя, позволяющий:– Просматривать, проектировать и изменять схемы в

репозитории;– Создавать базу данных тестирования для проверки

измененной схемы перед ее регистрацией в репозитории;

– Создавать новую базу данных пользователя;– Обновлять базу данных пользователя в соответствии

с новыми версиями измененной схемы;– Создавать и изменять список пользователей и права

доступа.

Page 78: Управление изменениями с использованием  ClearQuest

Модифицируемые элементы схемыМодифицируемые элементы схемы

• Чтобы расширить функции, выполняемые базовой схемой, Вы можете:– Применять пакеты;– Определять типы записей;– Конструировать модель процесса, включая действия и

состояния;– Устанавливать поля и их поведение;– Проектировать формы;– Разрабатывать коды хуков и скриптов для расширения или

автоматизации функций;– Строить семейства типов записей.

Page 79: Управление изменениями с использованием  ClearQuest

Термины Термины ClearQuest (1)ClearQuest (1)

• Record type Таблица (СУБД)(Тип записи)

• Field Определение столбца (Поле) (таблицы)

• Data type Приемлемый формат(Тип данных) данных

• Field behavior Параметры ввода значения (Поведение поля) столбца

• Record Строка таблицы(Запись) (экземпляр типа записи)

• Form Формат инициации(Форма) или просмотра записи

Page 80: Управление изменениями с использованием  ClearQuest

Термины Термины ClearQuest (2)ClearQuest (2)

• Record type family Группа записей с общими (Семейство типов полями длязаписей) осуществления выборки

данных• State Положение записи

(Состояние) в ее жизненном цикле• State type Категория состояний,

(Тип состояния) определяемая для реализации

некоторых функций пакетов• Action Возможное действие

(Действие) пользователя по обработкезаписи

• Hook, Script Код, обеспечивающий(Хук, Скрипт) автоматизацию

специализированных функций

Page 81: Управление изменениями с использованием  ClearQuest

Вход в Вход в ClearQuest DesignerClearQuest Designer

• При входе в ClearQuest Designer пользователь вводит свое имя (логин) и пароль

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

Page 82: Управление изменениями с использованием  ClearQuest

Выбор схемы для работыВыбор схемы для работы

• После ввода имени пользователя и пароля появляется экран выбора схемы для редактирования или просмотра

• Появление этого экрана можно отключить с помощью флажка "Show this wizard at startup" в нижней части экрана

При выборе схемы из списка и нажатии кнопки "Далее", схема извлекается из репозитория для редактирования (check-out) и загружается в CQ Designer. Если схема уже находится в состоянии редактирования, то она просто загружается в CQ Designer.

Чтобы загрузить схему для просмотра (без модификации), нужно выбрать опцию "View a version of an existing schema" в верхней части экрана, затем выбрать схему и нажать кнопку "Далее".

Нажав кнопку "Отмена", вы попадете в CQ Designer без загрузки какой-либо схемы. В этом режиме открыть схему можно через пункты меню.

Page 83: Управление изменениями с использованием  ClearQuest

Пользовательский интерфейс Пользовательский интерфейс ClearQuest ClearQuest DesignerDesigner

Инструментальная панель (Toolbox)

Рабочая область (Workspace) - древовидное

представление структуры схемы

Область вывода результатов

проверки схемы (Validation Output)

Строка состояния (Status Bar)

Изображение перечисленных областей можно включать и отключать через пункт меню "View"

Page 84: Управление изменениями с использованием  ClearQuest

Рабочая область Рабочая область ClearQuest DesignerClearQuest Designer

Рабочая область содержит 6 папок:• Schema Properties - свойства схемы;• Record Types - Спецификации типов

записей с состояниями;• Record Types - Stateless - Спецификации

типов записей без состояний;• Record Type Families - семейства типов

записей;• Global Scripts - Глобальные скрипты

схемы;• Dynamic List Names - Динамические

списки имен.

Page 85: Управление изменениями с использованием  ClearQuest

Свойства схемыСвойства схемы

• В настоящей версии ClearQuest свойства схемы содержат один параметр - язык скриптов (Perl или Basic);

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

Page 86: Управление изменениями с использованием  ClearQuest

Структура записи с состояниямиСтруктура записи с состояниями

• Fields - спецификация полей типов записи;

• States and Actions - спецификация процесса обработки записи в терминах состояний и действий;

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

• Record Scripts - скрипты, относящиеся к типу записи в целом (скрипты, относящиеся к отдельным полям и действиям, размещены в других разделах ClearQuest).

Формы определения спецификаций вызываются двойным щелчком мыши по соответствующему разделу структуры записи

Page 87: Управление изменениями с использованием  ClearQuest

Таблица полейТаблица полей

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

контекстного меню, вызываемого щелчком правой кнопкой мыши по заголовку поля "Field Name" (эта функция работает во всех табличных спецификациях);

• Спецификация полей одинакова для всех типов записей (с состояниями и без состояний);

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

Page 88: Управление изменениями с использованием  ClearQuest

Матрица переходов состоянийМатрица переходов состояний

Матрица содержит состояния типа записи и переходы между ними;

Между двумя любыми состояниями может быть не более одного перехода;

Каждое действие (переход) может иметь несколько исходных состояний, но только одно целевое состояние;

Порядок работы с состояниями будет рассмотрен позже.

Page 89: Управление изменениями с использованием  ClearQuest

Таблица действийТаблица действий

Таблица действий определяет возможные операции над типом записи;

Спецификация действий одинакова для всех типов записей (с состояниями и без состояний);

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

Page 90: Управление изменениями с использованием  ClearQuest

Поведение полейПоведение полей

Таблица поведения определяет порядок ввода значения поля в каждом состоянии;

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

Read Only - Только чтение; Mandatory - Значение обязательно; Optional - Значение необязательно; Use Hook - Поведение поля определяется кодом хука

(динамически).

Page 91: Управление изменениями с использованием  ClearQuest

Дизайнер экранной формыДизайнер экранной формы

Вызывается двойным щелчком мыши по значку формы в рабочей области

Панель элементов управления позволяет создавать на форме различные элементы управления для представления полей

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

Панель инструментов позволяет выравнивать положение и размеры полей

Page 92: Управление изменениями с использованием  ClearQuest

Структура типа записи без состоянийСтруктура типа записи без состояний

Fields - спецификация полей типов записи (аналог. типу записи с состояниями);

Actions - спецификация действий над записью (аналог. типу записи с состояниями);

Behaviors - поведение полей. Порядок ввода значения поля (аналог. типу записи с состояниями, но нет зависимости от состояний);

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

Forms - формы инициации и просмотра записей (аналог. типу записи с состояниями);

Record Scripts - скрипты, относящиеся к типу записи в целом (аналог. типу записи с состояниями).

Формы определения спецификаций вызываются двойным щелчком мыши по соответствующему разделу структуры записи

Page 93: Управление изменениями с использованием  ClearQuest

Уникальный ключ типа записи без Уникальный ключ типа записи без состояниясостояния

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

Page 94: Управление изменениями с использованием  ClearQuest

Структура семейства типов записейСтруктура семейства типов записей

Members - Члены семейства. Входящие в семейство типы записей;

Fields - Поля. Общие поля семейства типов записей, по которым можно производить выборки данных. Поля семейства должны иметь одно и то же название и тип данных в каждом типе записи, входящем в семейство.

Процедура создания семейств типов записей будет рассмотрена позже

Page 95: Управление изменениями с использованием  ClearQuest

Установка пакета: запуск Установка пакета: запуск помощникапомощника

• Выберите пункт меню "Package/Package Wizard"

Выберите пакет, который желаете установить. Нажав кнопку "More Packages", можно получить дополнительный список пакетов

Нажмите кнопку "Далее"

Page 96: Управление изменениями с использованием  ClearQuest

Установка пакета: Выбор схемыУстановка пакета: Выбор схемы

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

Нажмите кнопку "Далее"

Page 97: Управление изменениями с использованием  ClearQuest

Установка пакета: Активация записиУстановка пакета: Активация записи

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

Нажмите кнопку "Далее"

Page 98: Управление изменениями с использованием  ClearQuest

Установка пакета: Спецификация типов Установка пакета: Спецификация типов состоянийсостояний

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

Нажмите кнопку "Готово". Установка пакета завершается Установка пакета всегда сопровождается созданием новой

версии схемы. Если схема находится в состоянии редактирования (check-out), ClearQuest перед установкой пакета предложит зарегистрировать (check-in) схему в репозитории

Рекомендуется не удалять из репозитория версии схем, появившихся в результате установки пакета.

Page 99: Управление изменениями с использованием  ClearQuest

Типовые шаги модификации схемыТиповые шаги модификации схемы

1. Создайте новую версию схемы (check-out);2. Внесите изменения, например, добавьте новое

поле или измените формат формы;3. Проверьте измененную схему с помощью

тестовой базы данных;4. Зарегистрируйте (check-in) новую версию

схемы в репозитории;5. Обновите пользовательские базы данных,

чтобы в них стали доступны внесенные в схему изменения.

Page 100: Управление изменениями с использованием  ClearQuest

Проверка схемыПроверка схемы

• Выберите пункт меню "File/Validate". В нижней части экрана в специальное окно будут выведены результаты проверки.

• При необходимости отменить внесенные в схему изменения, выберите пункт меню "File/Undo Check Out". Если эти изменения уже были опробованы в тестовой базе данных, то необходимо удалить эту базу данных.

• Если проверка схемы завершилась без ошибок и внесенные изменения успешно опробованы в тестовой базе данных, зарегистрируйте новую версию схемы в репозитории, выбрав пункт меню "File/Check In".

• Текущая работа над новой версией схемы может быть сохранена выбором пункта меню "File/Save Work". Это сохранение не сопровождается регистрацией схемы в репозитории или отменой внесенных изменений.

Page 101: Управление изменениями с использованием  ClearQuest

Зачем нужна тестовая база данныхЗачем нужна тестовая база данных

• Это единственный способ проверить функциональность новой схемы перед тем как внести необратимые изменения в пользовательские базы данных;

• Тестовая база данных– это пользовательская база данных, которая использует текущую версию схемы. Работа с ней ничем не отличается от обычной работы, за исключением того, что тестовая база данных может использовать версию схемы, не зарегистрированную (check-in) в репозитории;

• Проверка изменений схемы в тестовой базе данных дополняет проверку (validate) схемы в CQ Designer.

Page 102: Управление изменениями с использованием  ClearQuest

Установка тестовой базы данныхУстановка тестовой базы данных

• При открытой схеме, выберите пункт меню "Database/Set Test Database...";

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

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

Page 103: Управление изменениями с использованием  ClearQuest

Создание пользовательской базы Создание пользовательской базы данных: Ввод имениданных: Ввод имени

• Выберите пункт меню "Database/New Database". Этот пункт активен только при отсутствии открытой в CQ Designer схемы.

• В появившемся экране введите логическое имя базы данных и комментарий. Логическое имя может содержать не более 5 символов и будет использоваться как префикс идентификаторов всех записей базы данных.

Page 104: Управление изменениями с использованием  ClearQuest

Создание пользовательской базы Создание пользовательской базы данных: Определение типаданных: Определение типа

• Определите тип базы данных (vendor);

• Для выбранного типа базы данных определите необходимые параметры.

Page 105: Управление изменениями с использованием  ClearQuest

Создание пользовательской базы Создание пользовательской базы данных: Задание временных параметровданных: Задание временных параметров

• Задайте временные параметры:– Timeout задает время отсутствия активной работы пользователя,

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

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

Page 106: Управление изменениями с использованием  ClearQuest

Создание пользовательской базы Создание пользовательской базы данных: Выбор версииданных: Выбор версии

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

Нажмите кнопку "Готово". Пользовательская база данных будет создана в указанном вами месте.

Page 107: Управление изменениями с использованием  ClearQuest

Обновление базы данных пользователяОбновление базы данных пользователя

• Для применения к пользовательской базе данных новой версии схемы выберите пункт меню "Database/Upgrade Database";

• Выберите базу данных, которую хотите обновить;• Выберите версию схемы, которую хотите применить к

базе данных.

Page 108: Управление изменениями с использованием  ClearQuest

Просмотр описаний пользовательских Просмотр описаний пользовательских баз данныхбаз данных

• Выберите пункт меню "View/Database Summary"

• Появившееся окно содержит список пользовательских баз данных, содержащий следующие атрибуты:– Database - логическое имя базы данных;– Schema Name - имя схемы базы данных;– Schema Version - версия схемы базы данных;– Physical Database - физическое размещение базы данных;– Database Version - версия базы данных;– Comment - комментарий, введенный при создании базы

данных.

Page 109: Управление изменениями с использованием  ClearQuest

Часть 6Настройка ClearQuest –

модель процесса

Page 110: Управление изменениями с использованием  ClearQuest

Реализация процесса управления Реализация процесса управления запросами на изменениязапросами на изменения

• Набор состояний (для типов записей с состояниями) определяет основные стадии жизненного цикла запроса на изменение;

• Группа действий определяет возможные операции и правила их выполнения (для типов записей с состояниями - в каждом состоянии);

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

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

• Механизм типов состояний позволяет делить состояния на категории.

Page 111: Управление изменениями с использованием  ClearQuest

Модель процесса обработки дефектовМодель процесса обработки дефектов

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

Submitted

Postponed

Assigned Opened Resolved Closed

Duplicated

postpone

postpone postpone

assign

assign open

reject

resolve validate

close

duplicateduplicateunduplicate

Page 112: Управление изменениями с использованием  ClearQuest

Модификация: Добавление нового Модификация: Добавление нового состояниясостояния

Submitted

Postponed

Assigned Opened Resolved Closed

Duplicated

postpone

postpone postpone

assign

assign open

reject

resolve validate

close

duplicate

duplicate

unduplicate add_info open

Need_Info

Добавляется новое состояние "Need_Info". В это состояние будут переводиться открытые дефекты, для обработки которых требуется получение дополнительной информации.

Page 113: Управление изменениями с использованием  ClearQuest

Процедура добавления нового состоянияПроцедура добавления нового состояния

1. Создайте новую версию схемы путем извлечения (check-out) схемы из репозитория;

2. Добавьте новое состояние в матрицу переходов состояний;

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

4. Проверьте изменения в тестовой базе данных;5. Зарегистрируйте (check-in) новую версию схемы в

репозитории;6. Обновите пользовательскую базу данных.

Page 114: Управление изменениями с использованием  ClearQuest

Создание новой версии схемыСоздание новой версии схемы

• Запустите CQ Designer. В окне открытия схемы выберите схему "Enterprise". Нажмите кнопку "Далее";

• Если у вас отключен автоматический запуск помощника, окно выбора схемы можно вызвать через пункт меню "File/Open Schema";

• В появившемся окне комментария нажмите кнопку "Готово".

Page 115: Управление изменениями с использованием  ClearQuest

Добавление нового состоянияДобавление нового состояния

• В матрице переходов состояний для записи "Defect":– Щелкните правой кнопкой мыши по пустой строке и выберите из

контекстного меню пункт "Add State";– или– Выберите пункт "Edit/Add State" главного меню;

• Введите имя нового состояния (Need_Info).

Page 116: Управление изменениями с использованием  ClearQuest

Добавление нового действияДобавление нового действия

• В матрице действий для записи "Defect":– Щелкните правой кнопкой мыши по пустой строке и выберите из

контекстного меню пункт "Add Action";– или– Выберите пункт "Edit/Add Action" главного меню;

• Введите имя нового действия (Add_info).

Page 117: Управление изменениями с использованием  ClearQuest

Задание параметров действияЗадание параметров действия

На вкладке "State" определите целевое состояние (Destination State) = "Need_Info";

В списке исходных состояний (Source States) включите флажок слева от состояния "Opened";

Текст, введенный во вкладке "Help Text", будет являться текстом подсказки для создаваемого действия в экранах ClearQuest;

Закройте окно нажатием кнопки в верхнем правом углу.

Page 118: Управление изменениями с использованием  ClearQuest

Модификация параметров Модификация параметров существующего действиясуществующего действия

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

в появившемся контекстном меню выберите "Action Properties";– или– Установите курсор на нужное действие и выберите пункт

"Edit/Action Properties" главного меню.

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

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

Page 119: Управление изменениями с использованием  ClearQuest

Изменения в матрице переходов Изменения в матрице переходов состояниясостояния

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

В данном случае выбранное действие "Open" будет переводить дефект из состояния "Need_Info" в состояние "Opened".

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

Page 120: Управление изменениями с использованием  ClearQuest

Параметры состоянияПараметры состояния

• Для модификации существующего состояния, при открытой матрице переходов состояний:

Выполните щелчок правой кнопкой мыши по названию состояния и в появившемся контекстном меню выберите "Properties";

или Установите курсор на нужное состояние и выберите

пункт "Edit/Properties" главного меню.• Вкладка "State Types" экрана свойств состояния

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

• Вкладка "Default Action" определяет для состояния действие по умолчанию.

Page 121: Управление изменениями с использованием  ClearQuest

Доступные типы действийДоступные типы действий

• SUBMIT (Инициация) - ручной ввод новой записи в базу данных;• IMPORT (Импорт) - импорт записи в базу данных;• MODIFY (Модифицикация) - внесение изменений в существующую

запись;• DELETE (Удаление) - удаление записи из базы данных;• CHANGE_STATE (Изменение состояния) - перевод записи в другое

состояние;• DUPLICATE (Дублирование) - объявление записи дубликатом

другой записи;• UNDUPLICATE (Отмена дублирования) - отмена объявления

записи дубликатом другой записи;• BASE (Базовое) - действие выполняется при выполнении других

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

• RECORD_SCRIPT_ALIAS (Алиас для скрипта записи) - действие вызывает выполнение скрипта записи.

Page 122: Управление изменениями с использованием  ClearQuest

Дополнительная информация о Дополнительная информация о состояниях и действияхсостояниях и действиях

• При создании новой записи с состояниями, она имеет единственное состояние "Submitted" и два действия: Submit типа SUBMIT и Import типа IMPORT;

• Действия типа SUBMIT всегда имеют целевое состояние "Submitted" и не имеют исходного состояния;

• Действия типа IMPORT не имеют привязки к состояниям;• Минимум требований к типу записи – это наличие одного

действия типа SUBMIT и одного действия типа IMPORT. В противном случае, возникнет ошибка при проверке схемы;

• По умолчанию, все действия доступны любому пользователю (установка доступа - ‘All Users’).

Page 123: Управление изменениями с использованием  ClearQuest

Состояния, типы состояний и пакетыСостояния, типы состояний и пакеты

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

• Пакеты применяют данные правила к типам состояний, а не к самим состояниям;

• При установке пакета зависящие от состояний правила проверяются после назначения типов состояний;

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

Page 124: Управление изменениями с использованием  ClearQuest

Установка типов состояний в помощнике Установка типов состояний в помощнике установки пакетаустановки пакета

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

Page 125: Управление изменениями с использованием  ClearQuest

Часть 7Настройка ClearQuest:

поля и формы

Page 126: Управление изменениями с использованием  ClearQuest

Доступные типы данных в Доступные типы данных в ClearQuestClearQuest

Тип ОписаниеSHORT_STRING Строка символов. Максимальная

длина строки – настраиваемое свойство поля

MULTILINE_STRING Многострочный текст. Размер текста не ограничен

INT Целое число (SQL integer)DATE_TIME Дата и Время (SQL Date and Time)ATTACHMENT_LIST Объекты (файлы),

присоединенные к записи запроса на изменение

REFERENCE Ссылка на записьREFERENCE_LIST Список ссылок на записи (ссылка

на список записей)

Page 127: Управление изменениями с использованием  ClearQuest

Элементы управления форм для типов Элементы управления форм для типов данных данных ClearQuestClearQuest

• Имеется два способа разместить поле на форме:• Выбрать управляющий элемент (control) из панели

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

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

Тип данных Элемент управления по умолчанию

SHORT_STRING Text Box

MULTILINE_STRING Text BoxINT Text BoxDATE_TIME Text Box

ATTACHMENT_LIST Attachment

REFERENCE Drop-down List Box

REFERENCE_LIST Parent/Child List View

Page 128: Управление изменениями с использованием  ClearQuest

Формы Формы ClearQuestClearQuest

• Формы ClearQuest обеспечивают пользовательский интерфейс для ввода информации;

• Для каждой записи вы можете активизировать две формы: Инициации (submit) и Просмотра (record)– Пользователи ClearQuest создают запросы на изменение

при помощи формы инициации;– Пользователи ClearQuest просматривают запросы на

изменение в базе данных при помощи формы просмотра; – Требуется хотя бы одна форма для каждого типа записи.

Если есть только одна форма, то она используется и для инициации, и для просмотра.

Page 129: Управление изменениями с использованием  ClearQuest

Исходный вид форм Исходный вид форм ClearQuestClearQuest

• ClearQuest использует стандартный формат форм с вкладками (tabs);

• Каждая форма должна иметь хотя бы одну вкладку;• Шаблон формы имеет две вкладки и кнопки:

– OK, Cancel, Values - для формы инициации;– Apply, Revert, Print Record, Actions - для формы просмотра.

Page 130: Управление изменениями с использованием  ClearQuest

Процедура настройки полей и формПроцедура настройки полей и форм

• Для добавления нового поля и размещения его в форме необходимо:– Извлечь схему из репозитория (check-out);– Добавить новое поле в таблицу полей типа записи;– Изменить формат формы - добавить новое поле на

одну из вкладок;– Проверить внесенные изменения (validate);– Проверить работу с помощью тестовой базы данных;– Зарегистрировать (check-in) новую версию схемы в

репозитории;– Обновить базу данных пользователя, чтобы

включить в нее новое поле и измененную форму.

Page 131: Управление изменениями с использованием  ClearQuest

Добавление поля в таблицу полейДобавление поля в таблицу полей

• Загрузите таблицу полей нужного типа записи;

• Выберите пункт меню "Edit/Add Field"или вызовите контекстное меню щелчком правой кнопкой мыши по столбцу названия поля пустой записи, затем выберите "Add Field";

В появившемся окне определите параметры поля: Field Name - Название поля; DB Column Name - Название столбца базы данных. Это

поле ClearQuest заполняет автоматически, и пользователь изменить его не может;

Type - Тип поля, выбираемый из списка допустимых типов ClearQuest. Для некоторых типов полей может потребоваться ввести дополнительные данные (например, для текстовой строки - максимальную длину, для ссылки - целевой тип записи и т.д.);

Help Text - Текст подсказки для поля в формах ClearQuest; Visible in Query - флажок, включающий/отключающий

видимость поля в выборках данных.

Page 132: Управление изменениями с использованием  ClearQuest

Спецификация поведения полейСпецификация поведения полей

• Обязательность наличия значений поля задается для каждого состояния в таблице поведения (Behaviors).

• Для типа записи с состояниями поведение поля задается для каждого состояния.

• Столбец "Default Behavior" определяет значение по умолчанию, которое будет присваиваться вновь создаваемым состояниям.

• Допустимые значения:– MANDATORY - Обязательное. Пользователь должен ввести значение

(если оно отсутствует);– OPTIONAL - Необязательное;– READONLY - Только чтение;– USE_HOOK - Использовать хук. Код хука динамически определит

поведение поля.

Page 133: Управление изменениями с использованием  ClearQuest

Об удалении полейОб удалении полей

• Когда вы удаляете поле, оно физически не удаляется из базы данных ClearQuest– Пользователи могут включать удаленное

поле в выборки данных, если для поля установлен флажок ‘Visible in Query’;

– Если вы попытаетесь создать новое поле с таким же именем, то ClearQuest выдаст сообщение о том, что данное поле уже существует.

Page 134: Управление изменениями с использованием  ClearQuest

Добавление управляющего элемента в Добавление управляющего элемента в формуформу

• Двойным щелчком по пиктограмме формы в рабочей области вызовите редактор формы;

• В списке полей выберите и перетащите на поверхность формы нужное поле. CQ Designer подберет для поля наиболее подходящий элемент управления;

• Двойным щелчком по элементу управления вызовите экран описания его свойств.

Если вы хотите использовать для поля другой элемент управления, то следует сначала разместить этот элемент управления на форме (пользуясь панелью

элементов управления), а затем в экране описания свойств назначить элементу управления отображаемое поле

Page 135: Управление изменениями с использованием  ClearQuest

Свойства элемента управления:Свойства элемента управления:Вкладка Вкладка “General”“General”

• На вкладке "General" задается название (Label), отображаемое поле базы данных (Field Name), размер и позиция (Size and position).

• Символ быстрого доступа (для вызова через клавишу <Alt>) может быть определен помещением перед ним знака &. На форме символ быстрого доступа в названии управляющего элемента выделяется подчеркиванием.

Page 136: Управление изменениями с использованием  ClearQuest

Свойства элемента управления:Свойства элемента управления:Вкладка Вкладка “Extended”“Extended”

На вкладке "Extended" определяются дополнительные параметры элемента управления:

Password/no echo style - скрытие вводимых символов, как при вводе пароля;

Multi Line - возможность ввода нескольких строк;

Vert Scrol Bar, Horz Scrol Bar - добавление вертикальной и горизонтальной полос прокрутки;

Auto Vert Scrol Bar, Auto Horz Scrol Bar - автоматическая прокрутка при достижении курсором границ поля.

Page 137: Управление изменениями с использованием  ClearQuest

Свойства элемента управления:Свойства элемента управления:Вкладка Вкладка “Date/Time”“Date/Time”

На вкладке "Date/Time" определяются параметры форматирования даты и времени:

Date, Time - включение/отключение части поля, содержащей дату и время;

Date Formats, Time Formats - перечень допустимых форматов представления даты и времени (в основном берется из настроек панели управления Windows);

Page 138: Управление изменениями с использованием  ClearQuest

Свойства элемента управления:Свойства элемента управления:Вкладка Вкладка “Context Menu Hooks”“Context Menu Hooks”

На вкладке "Context Menu Hooks" выбираются скрипты записи (record scripts), которые будут запускаться из контекстного меню элемента управления (вызываемого щелчком правой кнопкой мыши).

Список "Available" содержит перечень существующих для данного типа записи скриптов;

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

Page 139: Управление изменениями с использованием  ClearQuest

Элемент управленияЭлемент управления“Push Button” (“Push Button” (кнопка)кнопка)

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

• Некоторые элементы управления ClearQuest содержат кнопки для выполнения операций с данными элементами управления;

• Например, элемент управления "Parent/Child", наряду с элементом просмотра списка записей, включает три кнопки:

– Add - добавить в список существующую в базе данных запись;– Remove - удалить запись из списка;– New - создать новую запись в базе данных и добавить ее в список.

Page 140: Управление изменениями с использованием  ClearQuest

Создание связей между записямиСоздание связей между записями

• Для связывания записи с одной другой записью базы данных используется поле типа REFERENCE и элемент управления "Combo Box"

Пользователь "назначен для исправления" Дефекта

• Для связывания записи с несколькими другими записями базы данных используется поле типа REFERENCE_LIST и элемент управления "Parent/Child".

Задание "разбивается на несколько" Подзадач

Page 141: Управление изменениями с использованием  ClearQuest

Связывание записей элементом Связывание записей элементом управления управления “Parent/Child”“Parent/Child”

• Создайте поле с типом данных REFERENCE_LIST;• Разместите на форме элемент управления

"Parent/Child", связанный с данным полем (можно просто перетащить поле из списка полей на поверхность формы в редакторе форм);

• Пользователи ClearQuest смогут просматривать связанные (дочерние) записи в списке, а также добавлять, удалять или создавать новые записи с помощью кнопок "Add", "Remove" и "New".

Page 142: Управление изменениями с использованием  ClearQuest

Создание управляющего элемента Создание управляющего элемента “Parent/Child”“Parent/Child”

• После перетаскивания на форму поля типа REFERENCE_LIST и автоматического создания редактором форм элемента управления "Parent/Child", можно определить отображаемые в списке поля целевой записи перетаскиванием их из списка полей редактора форм в заголовок списка.

• Это же можно сделать, щелкнув правой кнопкой мыши по заголовку списка и выбрав "Add Column" из появившегося контекстного меню.

• Удалять поля из заголовка списка можно выбором пункта "Delete Column" из контекстного меню поля.

Page 143: Управление изменениями с использованием  ClearQuest

Установка тестовой базы данныхУстановка тестовой базы данных

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

• Работа с тестовой базой данных инициируется выбором пункта меню "File/Test Work" или нажатием кнопки "Test Work" инструментальной панели;

• Определение базы данных, используемой в качестве тестовой, производится выбором пункта меню "Database/Set Test Database". В появившемся окне выбирается база данных (она должна быть создана ранее), логин и пароль для запуска ClearQuest. Если пароль не задан, экран логина будет выводиться при каждом запуске ClearQuest (это бывает удобно для проверки работы с разными логинами).

Page 144: Управление изменениями с использованием  ClearQuest

Регистрация версии схемы в Регистрация версии схемы в репозиториирепозитории

• После проверки внесенных модификаций, новая версия схемы регистрируется в репозитории выбором пункта меню "File/Check In". Система проверит корректность схемы и, при отсутствии ошибок, предложит ввести комментарий для новой версии схемы, затем внесет версию в репозиторий

Page 145: Управление изменениями с использованием  ClearQuest

Проверка корректности схемыПроверка корректности схемы

• ClearQuest проверяет корректность схемы в следующих случаях:– Выбор пункта меню "File/Validate" или нажатие кнопки

"Validate" на панели инструментов;– Перед проведением работы с тестовой базой данных;– Перед регистрацией версии схемы в репозитории.

• Примеры выполняемых проверок:– Неправильное использование ключевых слов;– Уникальность имен для полей и действий;– Назначение типов данных полям и определение их

поведения для каждого состояния записи;– Наличие целевого типа записи для всех ссылок (полей

типа REFERENCE и REFERENCE_LIST);– Исходное и конечное состояния для всех действий,

связанных с изменением состояния;– Наличие уникальных ключей для всех записей без

состояний.

Page 146: Управление изменениями с использованием  ClearQuest

Обновление пользовательской базы Обновление пользовательской базы данныхданных

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

• Обновление вызывается выбором пункта меню "Database/Upgrade Database", указанием базы данных, затем версии схемы.

Page 147: Управление изменениями с использованием  ClearQuest

Семейство типов записейСемейство типов записей

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

• Семейство типов записей имеет три ключевых компонента:– Имя– Набор записей– Набор общих полей;

• Семейство типов записей не обладает состояниями, действиями, формами или скриптами;

• Семейство типов записей не имеет собственно записей.

Page 148: Управление изменениями с использованием  ClearQuest

Создание семейства типов записейСоздание семейства типов записей

• Выберите пункт меню "Edit / Add Record Type/Family". В появившемся окне введите название семейства;

• В рабочей области в разделе "Record Type Families" раскройте структуру созданного семейства, вызовите контекстное меню раздела "Members", выберите пункт "Add";

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

Page 149: Управление изменениями с использованием  ClearQuest

Определение полей семейства типов Определение полей семейства типов записейзаписей

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

Page 150: Управление изменениями с использованием  ClearQuest

Выборки данных из семейства типов Выборки данных из семейства типов записейзаписей

• В ClearQuest пользователь может создавать выборки данных из семейства типов записей аналогично выборкам из одного типа записи

Page 151: Управление изменениями с использованием  ClearQuest

Часть 8Модификация ClearQuest –

хуки и скрипты

Page 152: Управление изменениями с использованием  ClearQuest

Область модификацииОбласть модификации

• Использование скриптов и хуков ClearQuest позволяет модифицировать следующие области:1. Процесс;2. Данные;3. Представление данных;4. Анализ данных;

Page 153: Управление изменениями с использованием  ClearQuest

Что собой представляют хуки Что собой представляют хуки ClearQuest?ClearQuest?

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

• Хуки делают поведение объектов ClearQuest изменяемым;

• Типы хуков определяют степень модифицируемости ClearQuest;

• Языки для написания хуков – VB Script и Perl. Описание языка VB Script можно загрузить с сайта компании Microsoft;

• Хуки используют прикладной программный интерфейс (API) ClearQuest. Описание API устанавливается вместе с CQ Designer.

Page 154: Управление изменениями с использованием  ClearQuest

Ключевые объекты прикладного Ключевые объекты прикладного программного интерфейса программного интерфейса (API) CQ(API) CQ

HookChoices EventObjectOleMailMsg

Logon

History-relatedobjects

EntityDef

QueryDef

Session

ResultSet

DatabaseDescription

Entity

Attachment-relatedobjects

Entity-related objects Query-related objects

Page 155: Управление изменениями с использованием  ClearQuest

Объекты Объекты Session Session и и EntityDefEntityDef

• Для осуществления доступа в базу данных ClearQuest из внешних приложений, вы должны:– Получить объект Session; – Использовать метод Logon для начала работы с базой

данных ClearQuest;– Использовать объект Entity для доступа к записи в таблице

базы данных ClearQuest.

Session

Entity

Row

База данных ClearQuest

logon

Page 156: Управление изменениями с использованием  ClearQuest

Объекты Объекты Entity Entity и и EntityDefEntityDef

• Структура объекта Entity определяется соответствующим объектом EntityDef (тип записи);

• Объект EntityDef может быть с состояниями или без состояний;

• Каждый объект Entity содержит значения всех полей одной записи данных;

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

Page 157: Управление изменениями с использованием  ClearQuest

Наиболее часто используемые методы Наиболее часто используемые методы API ClearQuestAPI ClearQuest

SetFieldValue Устанавливает значение указанного поля

GetFieldValue Возвращает объект FieldInfo для указанного поля

AddItem Добавляет новый элемент в список выбора, который создается хуком CHOICE_LIST

GetValue Возвращает значение объекта FieldInfo в виде строки

GetEntity Получает указанную запись как текущий объект Entity

GetSession Получает указанную сессию как текущий объект Session

GetUserLoginName Возвращает имя, которое было использовано при логине в текущей сессии

Page 158: Управление изменениями с использованием  ClearQuest

Основные свойства Основные свойства VBScriptVBScript

• Интерпретация (без компиляции);• Использует управляющие элементы COM;• Слабо типизирован:

– Присутствует только один тип переменных – Variant– Вы не должны объявлять переменную перед ее

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

Dim SessionSet Session = GetSession

Возвращает объект

Page 159: Управление изменениями с использованием  ClearQuest

Переменные Переменные VBScriptVBScript

• Переменная типа Variant может хранить данные любого типа. VBScript определяет тип данных переменной, когда она используется. Например,

– Целочисленное сравнение

– Строковое сравнение

– Если Var пуста, а вы пытаетесь выполнить сравнение, то получите сообщение об ошибке.

If Var = 6 then

If Var = ‘’6’’ then

Page 160: Управление изменениями с использованием  ClearQuest

Хуки типов Хуки типов Field Field и и ActionAction

Field Hook Types• Choice List• DefaultValue• Permission• Validation• ValueChanged

Action Hook Types• AccessControl• Initialization• Validation• Notification• Commit• Record Script

Page 161: Управление изменениями с использованием  ClearQuest

Описание хуков типа Описание хуков типа FieldField

Тип ОписаниеDefaultValue Устанавливает исходное значение поля

во время инициации (Submit)Permission Динамически определяет доступ к полю

ChoiceList Возвращает список выбора дополнительных опций для поля

ValueChanged Синхронизирует значения полей после внесения изменений

Validation Подтверждает изменения содержимого поля непосредственно после их внесения

Page 162: Управление изменениями с использованием  ClearQuest

Выбор опции для хука типа Выбор опции для хука типа FieldField

• Для задания хука выберите нужную ячейку таблицы полей. В правой части ячейки появится стрелка выбора значений. Выберите "SCRIPTS", затем язык программирования - BASIC или PERL.

• ClearQuest запускает редактор скрипта.

Page 163: Управление изменениями с использованием  ClearQuest

Редактор скриптов Редактор скриптов (Script Editors)(Script Editors) для для кода хуковкода хуков

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

• Пользователь редактирует код хука, затем выбирает пункт меню "Hooks/Compile". ClearQuest проверяет синтаксическую правильность кода, выдавая обнаруженные ошибки в окно вывода результатов проверки. (Реальной компиляции кода не происходит - все скрипты интерпретируемы).

Page 164: Управление изменениями с использованием  ClearQuest

Пример хука «Пример хука «PermissionPermission»»

• Данный хук делает обязательным заполнение поля "Resolution" для состояний типа "Resolved"

Function resolution_Permission(fieldname, username) ' fieldname As String ' username As String ' resolution_Permission As Long ' record type name is Defect ' field name is Resolution

If GetFieldValue("Resolution_Statetype").GetValue() = "Resolved" then Resolution_Permission = AD_MANDATORY else Resolution_Permission = AD_OPTIONAL End if

End Function

Page 165: Управление изменениями с использованием  ClearQuest

Хук «Хук «Choice ListChoice List»»

• Хук "Choice List" динамически формирует список для выбора значения поля;

• Экран определения свойств хука вызывается через контекстное меню хука и позволяет включить или отключить два параметра-флажка:– Recalculate Choice List (вычислять список) - хук формирования списка

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

– Limit to List (ограничить списком) - пользователь не может вводить значения поля, не содержащиеся в списке выбора (список выбора не содержит пустой строки, после выбора которой можно вручную ввести любое значение поля).

Page 166: Управление изменениями с использованием  ClearQuest

Пример зависимого поляПример зависимого поля

• Список выбора значений поля "OS_Version" зависит от значения поля "Platform"

Windows NT ServerWindows NT WorkstationWindows 95

4.04.0 SP3

Platform

OS_Version

Необходимо включить флажок "Recalculate Choice List" для поля "OS_Version", так как список должен обновляться после каждого изменения поля "Platform"

Page 167: Управление изменениями с использованием  ClearQuest

Dim oldvalueDim currvalue

old_value = GetFieldOriginalValue (‘’Platform’’) . GetValue ()curr_value = GetFieldValue (‘’Platform’’) . GetValue ()

If (oldvalue<>currvalue) then dim Platform set Platform = GetFieldValue (‘’Platform’’) select case Platform. GetValue () case ‘’Windows NT Workstation’’

choices.AddItem (‘’3.51’’)choices.AddItem (‘’4.0’’)choices.AddItem (‘’4.0 SP2’’)choices.AddItem (‘’4.0 SP3’’)

case ‘’Windows NT Server’’choices.AddItem (‘’4.0’’)choices.AddItem (‘’4.0 SP3’’)

case ‘’Windows 95’’choices.AddItem (‘’Win95’’)

end select

Page 168: Управление изменениями с использованием  ClearQuest

Зависимые поля в Зависимые поля в ClearQuest WebClearQuest Web

• ClearQuest использует JavaScript на web-клиенте, чтобы обеспечить работу зависимых полей;

• Для каждого поля, имеющего зависимые поля, вы должны явно сообщить ClearQuest Web, какие это поля:1. Выберите управляющий элемент поля в форме ClearQuest

Designer;2. Щелкните правой кнопкой мыши и выберите в контекстном

меню "Properties" для просмотра свойств управляющего элемента;

3. Используйте вкладку "Web Dependent Fields", чтобы указать зависимые поля.

Page 169: Управление изменениями с использованием  ClearQuest

Спецификация зависимых полей в Спецификация зависимых полей в ClearQuest WebClearQuest Web

• Зависимые поля должны быть помещены в список "Selected" в правой части формы

Возможность определять зависимые поля существует только для следующих элементов управления: Drop-Down List Box, Drop-Down

Combo Box, Combo Box.

Page 170: Управление изменениями с использованием  ClearQuest

Динамические списки выбораДинамические списки выбора(Dynamic Choice Lists)(Dynamic Choice Lists)

• Динамические списки выбора (Dynamic Choice Lists) позволяют их содержимому динамически изменяться:– Пользователи могут добавлять или модифицировать

содержимое динамических списков выбора из любого клиента ClearQuest;

– Изменения, вносимые в динамический список выбора, не требуют редактирования схемы;

– Несколько полей, независимо от их типов данных, могут использовать один и тот же динамический список.

Page 171: Управление изменениями с использованием  ClearQuest

Создание динамического списка выбора Создание динамического списка выбора в в ClearQuest DesignerClearQuest Designer

• Вызовите контекстное меню папки "Dynamic List Names" рабочего пространства CQ Designer, выберите "Add";

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

• В таблице полей типа записи для поля, которое должно использовать созданный динамический список, установите значение столбца "Choice List" в "Dynamic List";

• В появившемся экране определения параметров списка выберите нужный динамический список и установите требуемое значение флажка "Limit to list". Установка флажка "Recalculate Choice list" для динамического списка значения не имеет.

Page 172: Управление изменениями с использованием  ClearQuest

Определение содержания динамического Определение содержания динамического спискасписка

• В ClearQuest (не CQ Designer) выберите пункт меню "Edit/Named Lists", выберите нужный динамический список.

• В появившемся окне щелкните правой кнопкой мыши по любому месту в области ввода, выберите из контекстного меню пункт "Add". В активизировавшемся поле введите допустимое значение для выбора.

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

• Окончив формирование списка, нажмите кнопку "OK".• При вводе значений в поля, связанные с данным списком,

можно выбирать введенные значения.

Page 173: Управление изменениями с использованием  ClearQuest

Хуки типа Хуки типа ActionAction

Тип ОписаниеAccessControl Устанавливает права пользователя

на выполнение действияInitialization Выполняется на начальной стадии

действияValidation Проверяет корректность

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

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

Notification Выполняется после фиксирования изменений в базе данных

Record Script Используется для запуска скрипта типа Record

Page 174: Управление изменениями с использованием  ClearQuest

Модифицирование хуков типа Модифицирование хуков типа ActionAction

• Произведите двойной щелчок по значку "Actions" нужного типа записи в рабочей области. Появится таблица хуков типа "Action";

• Щелкните по ячейке нужного хука. Появится меню опций, зависящее от типа хука.

Page 175: Управление изменениями с использованием  ClearQuest

Выбор опции для хука «Выбор опции для хука «Access ControlAccess Control»»

• ALL USERS - все пользователи имеют право выполнить действие;

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

• SCRIPTS - скрипт динамически определит возможность для пользователя выполнить действие.

Page 176: Управление изменениями с использованием  ClearQuest

Пример хука «Пример хука «Access ControlAccess Control»»

Function swbug_AccessControl (actionname, actiontype, username)`actionname As String`actiontype As Long`username As String`swbug_AccessControl As Boolean`action = close

Dim cur_user `Who the current user is Dim is_ok `Whether user can add Info to this bug

cur_user = GetSession().GetUserLoginName()

If cur_user = ‘’pat’’ Then is_ok = TRUE Else is_ok = False End if swbug_AccessControl = is_ok

End Function

Page 177: Управление изменениями с использованием  ClearQuest

Пример хука «Пример хука «ValidationValidation»»

• В настоящем примере хук "Validation" используется для получения поля, содержащего последовательные идентификаторы для записи одного проекта:– Создан новый тип записи без состояния "IDCounter",

содержащий два поля:• Поле ‘project’ в качестве уникального ключа;• Поле ‘last_id’ в качестве счетчика для отслеживания идентификации

последней записи, инициированной для проекта.

– Когда инициируется новая запись, хук "Validation" действия инициации (Submit) осуществляет:

• Увеличение значения поля ‘last_id’ записи "IDCounter" для проекта, к которому относится инициируемая запись;

• Ввод значения поля ‘’Consecutive_ID" инициируемой записи, хранящего последовательный идентификатор этой записи в рамках проекта.

Page 178: Управление изменениями с использованием  ClearQuest

Действие последовательных Действие последовательных идентификаторовидентификаторов

12

MyProjProject

Consecutive_Id

Тип записи "Defect"Тип записи "IDCounter"

MyProj

12Last_Id

Project

Page 179: Управление изменениями с использованием  ClearQuest

Хук "Хук "ValidationValidation" для реализации " для реализации последовательных идентификаторовпоследовательных идентификаторов

Dim IDEntityDim MySessionDim IDCounterObject

Set MySession = GetSessionSet IDEntity = MySession.GetEntity (‘’IDCounter’’, ‘’MyProj’’)Set IDCounterObject = IDentity.GetFieldValue (‘’LastID’’)

`Increment the LastID field of MyProj recordMySession.EditEntity IDentity, ‘’Modify’’IDEntity.SetFieldValue ‘’LastID’’, IDCounterObject .GetValue() + 1IDEntity.ValidateIDEntity.Commit

`Update the Consecutive_ID field with the same valueSetFieldValue ‘’Consecutive_ID’’, IDCounterObject .GetValue() + 1

Page 180: Управление изменениями с использованием  ClearQuest

Порядок исполнения хуков Порядок исполнения хуков типа "типа "FieldField"" ии ""ActionAction""

• При выполнении действия хуки исполняются в следующем порядке:– "Access Control" action hook;– "Initialization" action hook;– "Default Value" field hooks (только для SUBMIT &

IMPORT);– "Permission" field hooks (для каждого поля);– "Value Changed" field hooks (для каждого поля);– "Validation" field hooks (для каждого поля);– "Choice List" field hooks (для полей со списком);– "Validation" action hook;– "Commit" action hook;– "Notification" action hook.

Page 181: Управление изменениями с использованием  ClearQuest

Скрипты записи (Скрипты записи (Record scripts) Record scripts) и и Глобальные скрипты (Глобальные скрипты (Global scripts)Global scripts)

• Скрипты записи исполняются в контексте одного типа записи– Могут вызываться из хуков типа "Field", "Action" и других

скриптов записей;– Обычно инициируются управляющими элементами для

выполнения специфических процедур.

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

"Field", "Action", скриптов записи и глобальных скриптов). Механизм непосредственного вызова глобального скрипта отсутствует.

Page 182: Управление изменениями с использованием  ClearQuest

Инициация скрипта записи кнопкойИнициация скрипта записи кнопкой((Push Button)Push Button)

1. Вызовите редактор форм в ClearQuest Designer;2. Щелкните правой кнопкой мыши на элементе управления и выберите

"Properties" в контекстном меню;3. Выберите вкладку "Extended" формы свойств;4. Для поля ‘Click Hook’ выберите скрипт записи, который будет

выполняться при нажатии кнопки;5. Если вы хотите активизировать данную функцию в ClearQuest Web,

установите флажок ‘Click Hook’ в секции "Enable for Web" справа;

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

Page 183: Управление изменениями с использованием  ClearQuest

Исполнение скрипта записи с помощью Исполнение скрипта записи с помощью управляющего элемента управляющего элемента Combo BoxCombo Box

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

1. Вызовите редактор форм в ClearQuest Designer;2. Щелкните правой кнопкой мыши на элементе управления Combo Box

и выберите "Properties" в контекстном меню;3. Во вкладке "Context Menu Hooks" выберите скрипты записи, которые

должны запускаться из контекстного меню элемента Combo Box.

Позже, при работе пользователя в ClearQuest, при щелчке правой кнопкой мыши на элементе Combo Box, появится контекстное меню, содержащее выбранные скрипты записей.

Page 184: Управление изменениями с использованием  ClearQuest

Скрипты записи на языке Скрипты записи на языке VBScriptVBScript

• Все скрипты записи имеют аналогичный синтаксис:– Скрипт записи является функцией (не процедурой);– При вызове скрипта записи из хука можно передать

ему параметр с данными любого типа (тип параметра - Variant);

– Если хук записи возвращает данные, то они возвращаются как тип Variant.

Function RecordTypeName_ScriptName (param)`input param As Variant`output RecordTypeName_ScriptName As Variant[Код скрипта]

End Function

Page 185: Управление изменениями с использованием  ClearQuest

События управляющих элементов формСобытия управляющих элементов форм

• Когда скрипт записи инициируется управляющим элементом формы, ClearQuest передает объект EventObject в качестве параметра:– Данный объект содержит информацию о типе события,

инициировавшего вызов скрипта;– Различные управляющие элементы инициируют различные

события.

Тип элемента управления

Значение параметраДоп. информация

Push Button AD_BUTTON_CLICK имя кнопки

Combo Box AD_CONTEXTMENU_ITEM_SELECTION

Page 186: Управление изменениями с использованием  ClearQuest

Пример скрипта записиПример скрипта записи

Function Defect_AssignEngineer (param)`param as Variant `This hook responds to changes in the current component and `assigns the defect to the lead engineer for that component.

eventType = param.EventTypeIf eventtype = AD_BUTTON_CLICK Then `Get the lead person for the given component

componentObj = param.ObjectItemleadName = componentObj.GetFieldValue (‘’component_lead’’).GetValue

`Put that person’ s name in the component_ref fieldSetFieldValue "component_ref", leadNameDefect_AssignEngineer = 1

Elseif eventType = AD_CONTEXTMENU_ITEM_CONDITION Then Defect_AssignEngineer = 0

End ifEnd Function

Пример показывает скрипт записи, запускаемый нажатием кнопки и выбором в контекстном меню.

Когда хук вызывается нажатием кнопки, он устанавливает значение поля "component_ref".

Если хук вызывается из контекстного меню, он ничего не делает.

Page 187: Управление изменениями с использованием  ClearQuest

Глобальные скриптыГлобальные скрипты

• Глобальные скрипты представляют собой процедуры, которые вызываются из хуков полей, действий и из скриптов записи.

• Глобальные скрипты не имеют предопределенного синтаксиса.

• Пользователь должен определить:– Является ли глобальный скрипт функцией или процедурой;– Значение и тип параметров, принимаемых и

возвращаемых глобальным скриптом.

Page 188: Управление изменениями с использованием  ClearQuest

Пример глобального скриптаПример глобального скрипта

Function IsInGroup (groupname)`groupName As String`IsInGroup As Bool

Set curSession = GetSessiongroupList = curSession.GetUserGroups

IsInGroup = False

For Each group in groupListIf group = groupname Then

IsInGroup = TrueExit For

End IfNext

End Function

Пример показывает глобальный скрипт, который определяет, входит ли пользователь в указанную группу пользователей. Если входит, скрипт возвращает TRUE, если не входит – FALSE.

Page 189: Управление изменениями с использованием  ClearQuest

Инструменты отладки кодов хуков и Инструменты отладки кодов хуков и скриптовскриптов

• ClearQuest Designer hook compiler– Утилита обнаружения синтаксических ошибок, вызываемая из

главного меню CQ Designer.

• DBWin32– Утилита вывода на экран отладочной информации при вызове

функции "OutputDebugString".

• Функция Msgbox– Вывод сообщения в окно.– Данная функция срабатывает на том компьютере, где располагается

репозиторий. Исполнение хука прекращается до нажатия кнопки OK. – Для вывода сообщений пользователю из кода следует использовать

метод OutputTextMessage объекта Session - он срабатывает на компьютере клиента.

• Internet Explorer 4.0 Debugger.• Microsoft Development Studio VBScript debugger.

Page 190: Управление изменениями с использованием  ClearQuest

Установка отладчикаУстановка отладчика

• Выполните следующие шаги для установки отладчика VBScript:– Установите MS Internet Explorer версии 4.0 или

выше;– Установите MS Internet Explorer Debugger.

• Если у вас установлен пакет Microsoft Development Studio, можно использовать входящий в него отладчик VBScript debugger.

Документацию и отладчик VBScript можно загрузить из Интернетапо адресу htpp://www.microsoft.com/scripting/

Page 191: Управление изменениями с использованием  ClearQuest

Процедура отладкиПроцедура отладки

1. Запустите утилиту DBWin32 из установочной директории ClearQuest. Поместите функцию OutputDebugString в том месте кода, где должно появляться отладочное сообщение.

2. Выполните хук или скрипт.

3. При возникновении ошибки исполнение скрипта остановится, и начнет работать отладчик.

Page 192: Управление изменениями с использованием  ClearQuest

Планирование использования хуков и Планирование использования хуков и скриптовскриптов

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

• Выбирайте подходящие типы хуков и скриптов;

• Пользуйтесь уже созданными кодами;

• Не забывайте осуществлять отладку;

• Если ClearQuest Web – основной тип клиента, проверяйте модификации в web-браузерах, чтобы обеспечить корректное поведение приложения в контексте Интернета.

Page 193: Управление изменениями с использованием  ClearQuest

Часть 9Электронная почта

Page 194: Управление изменениями с использованием  ClearQuest

Электронная почта в Электронная почта в ClearQuest WebClearQuest Web

• Уведомление по электронной почте:– Используется для уведомления пользователей о

действиях ClearQuest, таких как инициация нового запроса или изменение значения поля.

• Инициация/модификация запросов по электронной почте:– Используется для инициации нового запроса или

модификации имеющегося запроса.

Page 195: Управление изменениями с использованием  ClearQuest

Инструменты обработки почтыИнструменты обработки почты

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

– Если сообщение не соответствует требуемому формату, запрос будет отклонен, а сообщение будет переадресовано администратору.

• Email Dynamic Link Library (DLL) предоставляет функции для получения и отправления электронных сообщений через сервер электронной почты.

• Электронная почта ClearQuest поддерживает стандарты SMTP/POP3 и MAPI.

Page 196: Управление изменениями с использованием  ClearQuest

Настройка уведомлений по электронной Настройка уведомлений по электронной почтепочте

1. Убедитесь в том, что в схеме репозитория установлен пакет Email;

2. Настройте работу электронной почты на клиентских компьютерах для Windows-клиентов ClearQuest. Порядок настройки описан в руководстве пользователя;

3. Отредактируйте реестр Windows на Web-сервере для активизации уведомлений по электронной почте для Web-клиентов ClearQuest. Порядок настройки описан в руководстве по инсталляции;

4. Пользуясь ClearQuest, определите правила уведомления по электронной почте, создав соответствующие записи типа Email_Rule.

Page 197: Управление изменениями с использованием  ClearQuest

Правило уведомления:Правило уведомления:вкладка ‘вкладка ‘Rule ControlRule Controlss’’

Общие сведения о правиле:• Name – имя правила;• Record – тип записи, для которого создается правило;• Fields to Check for Change – поля, изменение которых активизирует правило;• Filter Query – выборка, ограничивающая анализируемые данные;• Active Rule – флажок активации/деактивации правила;• Operator - оператор связывания условий срабатывания правила:

– Задаваемого в поле "Fields to Check for Change";– Определяемого параметрами вкладки Action Controls".

Page 198: Управление изменениями с использованием  ClearQuest

Правило уведомления:Правило уведомления:вкладка вкладка ‘Action Control‘Action Controlss''

Дополнительные условия, ограничивающие срабатывание правила:• Actions – действия;• Action types – типы действий;• Source States – исходные состояния действий;• Destination States – целевые состояния действий.

Page 199: Управление изменениями с использованием  ClearQuest

Правило уведомления:Правило уведомления:вкладка ‘вкладка ‘Display FieldsDisplay Fields’’

Содержание уведомления:• From Address – адрес отправителя;• Subject – список полей, значения которых помещаются в тему

уведомления;• Fields to Display – список полей, значения которых помещаются в тело

уведомления;• Include Entire Defect – флажок, включение которого приводит к помещению

в тело уведомления всех полей записи;• Show Previous Values – флажок, при включении которого в уведомлении

показываются также старые значения полей (до выполнения действия).

Page 200: Управление изменениями с использованием  ClearQuest

Правило уведомления:Правило уведомления: вкладка ‘вкладка ‘To Addressing InfoTo Addressing Info’’

Адресаты уведомления:• To Users – список пользователей ClearQuest, которым будет отправлено

уведомление;• To Groups – список групп пользователей ClearQuest, которым будет

отправлено уведомление;• To Addresses (Fields) – список полей, хранящих адреса, по которым будет

направлено уведомление;• To Addresses (text) – список явно указанных адресов, по которым будет

отправлено уведомление.

Page 201: Управление изменениями с использованием  ClearQuest

Правило уведомления:Правило уведомления: вкладка ‘вкладка ‘CC Addressing InfoCC Addressing Info’’

Адресаты копии уведомления:• CC Users – список пользователей ClearQuest, которым будет отправлена копия

уведомления;• CC Groups – список групп пользователей ClearQuest, которым будет

отправлена копия уведомления;• CC Addresses (Fields) – список полей, хранящих адреса, по которым будет

направлена копия уведомления;• CC Addresses (text) – список явно указанных адресов, по которым будет

отправлена копия уведомления;• CC Actioner - флажок, при включении которого копия уведомления будет

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

Page 202: Управление изменениями с использованием  ClearQuest

Модификация формы инициации Модификация формы инициации Email_RuleEmail_Rule

Форма инициации и просмотра типа записи "Email-Rule" может быть модифицирована в ClearQuest Designer, аналогично формам других типов записей.

Page 203: Управление изменениями с использованием  ClearQuest

Настройка Настройка EmailEmail: Выбор протокола: Выбор протокола

• В Windows-клиенте ClearQuest настройка параметров электронной почты производится следующим образом:– Выберите в меню "View / Email Options";– Установите флажок "Enable E-mail Notification";– Выберите протокол, который использует ваша система

электронной почты. ClearQuest поддерживает протоколы SMTP и MAPI.

Page 204: Управление изменениями с использованием  ClearQuest

Настройка Настройка EmailEmail: : Ввод данных о почтовом сервереВвод данных о почтовом сервере

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

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

Page 205: Управление изменениями с использованием  ClearQuest

Часть 11Установка и обновление

ClearQuest

Page 206: Управление изменениями с использованием  ClearQuest

Информация по установке Информация по установке ClearQuestClearQuest

• Информация по установке и настройке ClearQuest находится в следующих документах:– Introducing Rational ClearQuest;– Release notes (readme.htm);– Installing Rational ClearQuest;– Administering Licenses for Rational Software.

• Перечисленные документы (кроме Release notes) поставляются в бумажной копии, а также имеются в электронном виде на диске с документацией.

Page 207: Управление изменениями с использованием  ClearQuest

Процедура установки Процедура установки ClearQuestClearQuest

1. Настройте СУБД, в которой будут создаваться базы данных ClearQuest: MS Access, SQL Server, SQL Anywhere, Oracle, DB2;

2. Настройте сервер лицензий Rational и получите ключ лицензии ClearQuest;

3. Установите ClearQuest, используя программу установки Rational Setup;

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

5. Настройте ClearQuest для подключения к созданному репозиторию.

Подробное описание установки ClearQuest и настройки всех СУБД приведено в руководстве по инсталляции

Page 208: Управление изменениями с использованием  ClearQuest

Процедура установки Процедура установки ClearQuestClearQuest WebWeb

1. Установите web-сервер Microsoft Internet Information Server (IIS) версии 4.0 или выше;

2. Установите ClearQuest на web сервере (необходимо включить установку серверных компонент, которые по умолчанию не устанавливаются);

3. Сконфигурируйте виртуальную директорию для работы с ClearQuest;

4. Настройте анонимного пользователя для работы с web-страницами ClearQuest;

Более подробное описание настройки ClearQuest Web было рассмотрено в модуле 9 "ClearQuest Web и ClearQuest E-mail"

Page 209: Управление изменениями с использованием  ClearQuest

Инструменты управления лицензиямиИнструменты управления лицензиями

• Rational License Key Administrator– Ведение учетных записей Rational– Лицензии и адреса для их обновления– Ключи лицензий– Настройки файлов лицензий

• FLEXlm License Manager– Управление сервером лицензий– Файлы журналирования– Базовая диагностика

• Globetrotter Lmtools – Детальная диагностика

Подробное описание управления лицензиями продуктов Rational приведено в документе Administering Licenses for

Rational Software

Page 210: Управление изменениями с использованием  ClearQuest

Виды лицензий продуктов Виды лицензий продуктов Rational Rational SoftwareSoftware

Node-LockedLicense

Серверлицензий

Start Up License

В период действия временной лицензии должны быть

запрошены постоянные лицензии

FloatingLicense

FloatingLicense

FloatingLicense

FloatingLicense

Временная лицензия(поставляется с продуктом)

Срок действия 30 дней

Лицензия, привязанная к одному компьютеру

Лицензия для использования продукта на

любом компьютере сети

Page 211: Управление изменениями с использованием  ClearQuest

Виды лицензий Виды лицензий ClearQuestClearQuest

• ClearQuest– Лицензия "node-locked"– Лицензия "floating"

• ClearQuest Web– Использует обычные floating-лицензии - одну на

каждого присоединенного пользователя

• Ограниченный ClearQuest Web– Пользователи могут инициировать запросы на

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

Page 212: Управление изменениями с использованием  ClearQuest

Процедура обновления Процедура обновления ClearQuestClearQuest

1. Создайте архивные копии существующих баз данных ClearQuest;

2. Полностью удалите (деинсталлируйте) все предыдущие версии ClearQuest;

3. Установите последнюю версию ClearQuest;

4. Выполните процедуру обновления с помощью утилиты "ClearQuest Maintenance Tool" (см. следующий слайд).

Page 213: Управление изменениями с использованием  ClearQuest

Утилита "Утилита "ClearQuest Maintenance ToolClearQuest Maintenance Tool""

• Используется для управления репозиториями схем ClearQuest и обновлением версий баз данных;

• Всегда инсталлируется вместе с ClearQuest.

Page 214: Управление изменениями с использованием  ClearQuest

Опции утилиты "Опции утилиты "ClearQuest Maintenance ClearQuest Maintenance ToolTool""

– Connect to an Existing schema repository: Выбор репозитория схем, к которому будут подключаться при запуске ClearQuest и ClearQuest Designer.

– Create a new schema repository: Создание нового репозитория. Вместе с репозиторием можно создать пробную базу данных с некоторым исходным наполнением.

– Upgrade schema repository and/or user database(s): Обновление репозитория схем и связанных с ним баз данных. Базы данных можно обновлять выборочно, по мере необходимости.

– Move an existing schema repository: Физическое перемещение репозитория схем (в другое место и/или в СУБД другого производителя). Реально, создается новая копия, а старая копия блокируется. Удалять физические данные нужно вручную. Пользовательские базы данных перемещаются из ClearQuest Designer.

– Update Schema Repository Location: Внесение корректной информации о размещении в репозиторий, который был перемещен вручную.

Page 215: Управление изменениями с использованием  ClearQuest

Создание нового репозитория схемСоздание нового репозитория схем

• В утилите "ClearQuest Maintenance Tool" выберите опцию "Create a new schema repository";

• В окне свойств репозитория выберите вендора (тип СУБД) и введите информацию о базе данных (специфическую для каждого вендора). Нажмите "Далее".

Page 216: Управление изменениями с использованием  ClearQuest

Создание пробной базы данныхСоздание пробной базы данных

• В окне "Create Sample Database" выберите схему репозитория и введите логическое имя базы данных. (Если вы не хотите создавать опытную базу данных, сбросьте флажок "Create sample database").

• В экране параметров базы данных выберите вендора и введите информацию о базе данных (специфическую для каждого вендора). Нажмите "Далее".

Page 217: Управление изменениями с использованием  ClearQuest

Сохранение свойств репозитория в Сохранение свойств репозитория в файлефайле

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

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

Нажатие кнопки "Готово" завершает

создание репозитория

Page 218: Управление изменениями с использованием  ClearQuest

Конвертация баз данных Конвертация баз данных ClearQuestClearQuest

• Конвертация репозитория схем– Использование ClearQuest Maintenance Tool для

перемещения репозитория или смены вендора (опция "Move an existing schema repository").

• Конвертация пользовательской базы данных– Использование ClearQuest Designer, пункт меню

"Database".

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

Page 219: Управление изменениями с использованием  ClearQuest

Часть 13Импорт. Экспорт

Page 220: Управление изменениями с использованием  ClearQuest

Причины использования импорта и Причины использования импорта и экспорта в экспорта в ClearQuestClearQuest

• Конвертация записей запросов на изменения из других инструментов в систему ClearQuest;

• Реорганизация существующего репозитория схем и пользовательских баз данных ClearQuest;

• Перенос данных между базами данных ClearQuest;

• Альтернативный способ архивирования данных.

Page 221: Управление изменениями с использованием  ClearQuest

Экспорт и импорт форм в Экспорт и импорт форм в ClearQuestClearQuest

• В ClearQuest Designer вы можете экспортировать форму из любого типа записи;

• Экспортируемый файл имеет формат Visual Basic Form (.frm);• Используйте ClearQuest Designer для импорта

экспортированных файлов ClearQuest в другие схемы;• Экспортированный файл ClearQuest может быть

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

• Экспорт формы производится выбором "Export Form" из контекстного меню значка формы в рабочей области ClearQuest Designer;

• Импорт формы производится выбором "Import Form" из контекстного меню папки "Forms" требуемого типа записи в рабочей области ClearQuest Designer.

Page 222: Управление изменениями с использованием  ClearQuest

Экспорт и импорт информации о Экспорт и импорт информации о пользователях пользователях ClearQuestClearQuest

• Инструмент администрирования пользователей ClearQuest Designer (User Administrator Tool) может производить экспорт и импорт информации о пользователях;

• При экспорте информация о пользователях и группах пользователей помещается в текстовый файл (пароли пользователей при этом шифруются);

• При импорте информации о пользователях, она перезаписывает имеющиеся данные;

• После импорта информации о пользователях необходимо обновить базы данных.

Page 223: Управление изменениями с использованием  ClearQuest

Экспорт/импорт выборок и отчетов Экспорт/импорт выборок и отчетов ClearQuestClearQuest

• Выборки данных и форматы отчетов могут экспортироваться/импортироваться в ClearQuest;

• Файл экспортируемой выборки имеет формат Seagate Crystal Query (.qry);

• Файл экспортируемого отчета имеет формат Crystal Report (.rpt);

• Файлы экспортируемых выборок и отчетов могут быть импортированы в другую базу данных ClearQuest;

• Могут быть экспортированы в файлы различных форматов (без возможности импорта):– Результаты выполнения выборки (grid);– Графики;– Результирующие отчеты.

Page 224: Управление изменениями с использованием  ClearQuest

Экспорт и импорт записей запросов на Экспорт и импорт записей запросов на изменениеизменение

• ClearQuest Export Tool выполняет экспорт записей запросов на изменения;

• ClearQuest Import Tool выполняет импорт внешних записей запросов на изменения в базу данных ClearQuest;

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

• Форматом экспорта и импорта данных ClearQuest является текстовый файл CSV (comma separated values) - значения полей помещаются в двойные кавычки и разделяются запятыми.

Page 225: Управление изменениями с использованием  ClearQuest

……

Page 226: Управление изменениями с использованием  ClearQuest

Часть 13Интеграция ClearQuest

Page 227: Управление изменениями с использованием  ClearQuest

Интеграция Интеграция ClearCase ClearCase и и ClearQuestClearQuest

• Основной функцией интеграции ClearCase и ClearQuest является установление связи между изменениями проектных материалов, произведенными под управлением ClearCase, и запросами на изменение, хранящимися в базе данных ClearQuest;

• Эта связь устанавливается во время извлечения (check out) или регистрации (check in) версий артефактов в версионном хранилище;

• В ClearQuest каждая запись запроса на изменение может быть связана с набором изменений артефактов в ClearCase;

• В ClearCase каждая версия артефакта может быть связана с одним или несколькими запросами на изменение в ClearQuest.

Page 228: Управление изменениями с использованием  ClearQuest

Конфигурирование интеграцииКонфигурирование интеграцииClearCaseClearCase//ClearQuestClearQuest

• Перед тем как связывать версии артефактов ClearCase с запросами на изменение ClearQuest, вы должны настроить интеграцию CC/CQ:– В схему ClearQuest должен быть установлен пакет ‘ClearCase’;– Должны быть определены параметры интеграции при помощи

утилиты "ClearQuest Integration Configuration", которая устанавливается с пакетом ClearCase (файл cqconfig.exe).

• При настройке параметров интеграции можно обязать пользователей ClearCase при внесении изменений в версионное хранилище устанавливать связь этих изменений с запросами на изменения в базе данных ClearQuest.

Page 229: Управление изменениями с использованием  ClearQuest

Утилита конфигурации интеграцииУтилита конфигурации интеграцииClearCaseClearCase//ClearQuestClearQuest

Page 230: Управление изменениями с использованием  ClearQuest

Просмотр связей наборов изменений с Просмотр связей наборов изменений с запросами на изменениязапросами на изменения

• В ClearQuest наборы на изменения, связанные с запросом на изменение, показаны на вкладке "ClearCase", которая появляется в форме просмотра записи после установки пакета "ClearCase";

• Для просмотра запросов на изменения, связанных с набором версий хранящихся в версионном хранилище артефактов, используется утилита "ClearQuest Integration Query", устанавливаемая вместе с пакетом ClearCase (файл cqquery.exe).

Page 231: Управление изменениями с использованием  ClearQuest

Настройка интеграции Настройка интеграции UCM/ClearQuestUCM/ClearQuest

• В схему ClearQuest должен быть установлен один из следующих пакетов:

– BaseCMActivity,– UCMPolicyScripts,– UnifiedChangeManagment;

• В репозитории схем ClearQuest имеется две предопределенных схемы, совместимые с UCM:

– Unified Change Management,– Enterprise;

• Создайте базу данных пользователя на основе UCM-схемы. Убедитесь в том, что пользователи ClearCase имеют к этой базе данных доступ типа "Active User";

• Сконфигурируйте UCM-проект(ы) в PVOB (Project Versioned Object Base) для работы с ClearQuest;

• Создайте представления (views) для работы в UCM-проекте ClearQuest.

Для более полной информации по интеграции UCM / ClearQuest смотрите руководство по инсталляции ClearQuest

Page 232: Управление изменениями с использованием  ClearQuest

Базовые компоненты модели Базовые компоненты модели UCMUCM

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

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

• Задачи (Activities) - задачи, выполняемые разработчиками. Задачи создаются заранее и назначаются руководителем проекта.

• Набор изменений (Change set) - набор версий артефактов (файлов, директорий, и т.д.), созданных в результате выполнения задачи.

• Проект (Project) - набор потоков.

Page 233: Управление изменениями с использованием  ClearQuest

Модель типов состояний в Модель типов состояний в ClearQuest ClearQuest (UCM)(UCM)

• Состояния записи ClearQuest, активизированной для UCM, относятся к одной из следующих категорий (типов состояний):

WAITING

READY

ACTIVE

COMPLETE

Работа над задачей еще не началась. В этом состоянии должно иметься действие по умолчанию, переводящее запись в состояние типа READY, ACTIVE или WAITING;

READY. Задача назначена исполнителю, но работа еще не началась. В этом состоянии должно иметься действие по умолчанию, переводящее запись в состояние типа ACTIVE или READY. Если имеется действие, переводящее запись в состояние WAITING, то в состоянии WAITING должно иметься действие по умолчанию, возвращающее запись в состояние READY;

ACTIVE. Пользователь уже приступил к работе, но еще не завершил ее;

COMPLETE. Работа либо завершена, либо была отменена и не выполнялась.

Page 234: Управление изменениями с использованием  ClearQuest

Категории состояний типа записи Категории состояний типа записи DefectDefect

Submitted[W]

Assign[R]

Opened[A]

Resolved[C]

Duplicated[C]

Postponed[W]

Closed[C]

Для интеграции с UCM каждое состояние должно быть отнесено к одной из категорий: [W] – Waiting, [R] – Ready, [A] – Active, [C] - Complete

Page 235: Управление изменениями с использованием  ClearQuest

Модель состояний типа записи Модель состояний типа записи BaseCMActivityBaseCMActivity

Submitted[W]

Active[A]

Ready[R]

Complete[C]

Assign

Activate

Complete

Postpone

Postpone

Reopen

Page 236: Управление изменениями с использованием  ClearQuest

Выборки данных, предназначенные для Выборки данных, предназначенные для работы по технологии работы по технологии UCMUCM

• Существует ряд выборок, заранее определенных для интеграции UCM/CQ:

– Подкаталог UCMSystemQueries:• UCMCustomQuery1

– Подкаталог UCMUserQueries:• ActiveFoProject• ActiveForStream• ActiveForUser• MyToDoList• UCMProjects

Page 237: Управление изменениями с использованием  ClearQuest

Использование интеграцииИспользование интеграции UCM/CQ UCM/CQ

• ClearQuest:– Руководитель проекта инициирует один или несколько UCM-

проектов (projects) и действий (activities);– Каждое действие связано с одним UCM-проектом и

назначается одному пользователю (Owner);– Когда пользователь входит в систему ClearQuest, выборка

"MyToDoList" покажет назначенные ему действия. Пользователь может выбрать действие для работы и перевести его в состояние "WorkOn".

• ClearCase:– Разработчик выбирает действие при выполнении операции

check out и изменяет состояние действия во время поставки (delivery) измененного артефакта;

– Интегратор проверяет наборы изменений перед созданием и назначением новой базовой линии (baseline).

Page 238: Управление изменениями с использованием  ClearQuest

Интеграция Интеграция ClearQuest ClearQuest и и Visual Source Visual Source Safe (VSS)Safe (VSS)

• В схему репозитория должен быть установлен пакет "VisualSourceSafe";

• Для настройки интеграции VSS/CQ используется утилита "cqvss.exe", которая находится в установочной директории ClearQuest. Данная утилита предлагает заполнить серию экранов настройки интеграции VSS/CQ;

• При извлечении (check out) и регистрации (check in) файла в версионном хранилище, пользователь VSS может связать с версией файла набор записей из базы данных CQ (запросов или заданий, при выполнении которых создана данная версия файла);

• В утилите "cqvss.exe" пользователь может создать "снимок" связей (association snapshot) файлов и запросов на изменения. Затем можно просматривать изменения произведенные после создания "снимка".

Page 239: Управление изменениями с использованием  ClearQuest

Ограничения интеграцииОграничения интеграции

• Интеграция CC/CQ и интеграция VSS/CQ не могут использоваться в одной и той же схеме ClearQuest– Утилита cqvss.exe не может работать со схемами,

имеющими интеграцию CC/CQ;

• Интеграция UCM/CQ и интеграция CC/CQ могут использоваться в одной и той же схеме ClearQuest, но не с одним и тем же проектом.– Действия (activities) не могут быть связаны одновременно с

версиями файлов CC и VSS;– Ветви UCM (branches) не могут участвовать в интеграции

CC/CQ.

Page 240: Управление изменениями с использованием  ClearQuest

Интеграция Интеграция ClearQuest ClearQuest с продуктамис продуктами RationalRational

• Для организации интегрированного процесса разработки, тестирования и сопровождения ПО, имеется возможность интегрировать ClearQuest с другими продуктами Rational Software:– Интеграция с RequisitePro позволяет связывать

запросы на изменения с требованиями, которые эти изменения затрагивают;

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

Page 241: Управление изменениями с использованием  ClearQuest

Средства интеграции Средства интеграции ClearQuestClearQuestс продуктами с продуктами RationalRational

• Поставляемые с ClearQuest схемы, предназначенные для интеграции с продуктами Rational:

– AnalystStudio;– DevelopmentStudio– TestStudio– Enterprise

• Поставляемые с ClearQuest пакеты, предназначенные для интеграции с продуктами Rational:

– BaseCMActivity– ClearCase– PQC– Repository– RequisitePro– RequisitePro Supplement– TeamTest– UCMPolicyScripts– UnifiedChange Management (UCM)

• Rational Administrator используется для установки связей между базами данных разных продуктов Rational.

Page 242: Управление изменениями с использованием  ClearQuest

Спасибо за внимание [email protected]

http://www.cmcons.com