Цель интеграции IBM Rational Portfolio Manager и IBM Rational ClearQuest - связать детализацию деятельностей процесса разработки в ClearQuest с планированием и отслеживанием проекта в Rational Portfolio Manager; такая интеграция помогает в выполнении следующих задач:
Импорт и синхронизация записей ClearQuest в Rational Portfolio Manager в форме суммарных задач, задач и элементов программы работ;
Обеспечение руководителей проекта более отчетливым представлением и пониманием деятельностей процесса разработки, способствующим более эффективному управлению проектом и планированию пропускной способности ресурсов. Это достигается за счет автоматизации извлечения информации о статусе или состоянии из ClearQuest и обновлении соответствующих актуальных данных задачи в Rational Portfolio Manager;
Внедрение более передовых методов управления с использованием более детализированного отслеживания проекта без внесения существенных изменений в имеющиеся процессы и методы;
Создание ситуации, при которой роли используют наиболее подходящие для них инструменты (например, руководитель проекта работает с Rational Portfolio Manager, а разработчик - с ClearQuest);
Автоматизация обновлений элементов программы работ в Rational Portfolio Manager, в том числе создание, изменение и удаление из связанных записей ClearQuest.
Это первая из четырех статей серии, рассказывающей об интеграции этих двух программных продуктов. В ней мы сосредоточимся на настройке параметров секции отображения задач Task Mapping профиля ClearQuest в Rational Portfolio Manager. Во второй статье описывается настройка компонента Scope Mapping в профиле ClearQuest и настройка макета для проекта (Project), задачи (Task) и элемента программы работ (Scope Element). В третьей статье речь пойдет об интеграции инструментов Rational Portfolio Manager и ClearQuest. В последней статье серии мы рассмотрим установку и настройку параметров связующего ПО, которое необходимо для поддержки данной интеграции.
Цель настройки параметров Rational Portfolio Manager - создание отображения между элементами Rational Portfolio Manager и типами записей ClearQuest. В отображении определяется, какая информация будет совместно использоваться этими двумя инструментами. В подавляющем большинстве случаев общие ресурсы из ClearQuest используются в Rational Portfolio Manager, хотя часть информации из Rational Portfolio Manager тоже видима в ClearQuest. Описанные отображения касаются четырех (4) областей в описании (Description) Rational Portfolio Manager:
портлет Information;
портлет Attributes;
портлет ClearQuest Integration;
портлеты RTF.
В ClearQuest предусмотрена вкладка RPM Integrations. Эта вкладка отображает информацию из Rational Portfolio Manager. В предыдущих версиях Rational Portfolio Manager эта же информация отображается на другой вкладке, которая называется RPM Schedule. Если вы перешли на версию 7.1 с уже установленной и использовавшейся интеграции версии 7.0.x.x, у вас будут присутствовать обе вкладки. До начала работы следует ознакомиться с необходимыми условиями описываемой интеграции.
Ниже перечислены основные необходимые условия для осуществления и использования описанной интеграции:
Чтобы использовать интеграцию с ClearQuest, у вас должен быть установлен инструмент Rational Portfolio Manager 7.1 или более поздней версии. Версия 7.1 стала доступной широкому кругу пользователей 29 июня 2007 г.;
В качестве сервера приложений должна быть установлена одна из следующих программ: IBM WebSphere (версии 5.x, 6.x или более поздние) или Apache Tomcat (версии 5.0, 5.5 или более поздние);
На сервере должно быть развернуто связующее ПО Rational Portfolio Manager;
Должен быть установлен инструмент ClearQuest.
Поддерживаются следующие версии ClearQuest:
2003.06.15;
2003.06.16;
7.0.0;
7.0.1 или более поздние.
Должны быть установлены следующие компоненты ClearQuest:
Сервер баз данных ClearQuest;
Клиентская установка ClearQuest для Windows;
Web-клиент ClearQuest;
Конструктор ClearQuest Designer.
Для ClearQuest (и использования в описываемой интеграции) поддерживаются следующие типы баз данных:
IBM DB2;
Oracle.
К локальной реплике ClearQuest необходимо применить пакет Rational Portfolio Manager-ClearQuest (если вы работаете с IBMRational ClearQuest MultiSite);
В установке ClearQuest должны присутствовать следующие изменения (мы подробно рассмотрим их в одной из следующих статей данной серии):
Создан тип записи RPMCQOwner;
Специально для целей нашей интеграции создан пользователь ClearQuest.
Интеграция Rational Portfolio Manager и ClearQuest в версии 7.1 была дополнена новыми функциями. Знание возможностей интеграции в версиях от 7.0.2.2 до 7.0.5.5 (далее - версии 7.0.x) поможет вам разобраться в изменениях, реализованных в версии V7.1. В первом варианте этой интеграции:
Интеграция могла быть запущена из Rational Portfolio Manager на следующих уровнях:
проектное предложение (Proposal);
проект (Project);
суммарная задача (Summary Task).
Любая сохраняемая запись ClearQuest, имеющая поле owner (владелец), могла быть импортирована в Rational Portfolio Manager независимо от ее типа;
Все импортированные типы записей в Rational Portfolio Manager становились задачами (Task) (то есть они не могли быть импортированы как типы элементов программы работ);
Синхронизацию можно было запустить только из Rational Portfolio Manager, и только пользователем (то есть допускалась только синхронизация вручную);
Чтобы выполнить синхронизацию в среде ClearCase MultiSite, API в Rational Portfolio Manager находит главную запись (master record) (используя доступ ко всем репликам, которые были предварительно определены в System Administrator) и обновляет текущую запись;
В случае конфликтов определяется приоритетность выполнения;
В зависимости от настройки объектов в Rational Portfolio Manager (Proposal, Project или Summary Tasks) возможны два сценария интеграции:
по продолжительности (%Duration Complete);
по трудозатратам (Actuals).
Изменения состояния управляются через ClearQuest;
При создании экземпляров записей ClearQuest в Rational Portfolio Manager владелец определяется по информации, указанной в поле Owner в ClearQuest:
если в этом поле в ClearQuest указан владелец, то этот пользователь в Rational Portfolio Manager становится Task Responsible (Ответственным за выполнение задачи);
если поле Owner не заполнено, то ответственным за выполнение задачи в Rational Portfolio Manager становится пользователь, который выполняет операцию импорта (до назначения ответственным за выполнение задачи нового ресурса).
В Rational Portfolio Manager V7.1 появились следующие изменения:
Все сохраняющие состояние типы записей Rational ClearQuest могут быть импортированы в Rational Portfolio Manager в виде следующих объектов:
Tasks (Задачи);
Summary Tasks (Суммарные задачи);
Scope Elements (Элементы программы работ).
Задачи в Rational Portfolio Manager можно экспортировать в Rational ClearQuest на основании отображения, определенного в Rational Portfolio Manager;
Способ экспорта учитывает отображения задач Task Mappings в профиле, ассоциируемом с данным проектом или проектным предложением.
В Rational Portfolio Manager можно настроить запуск синхронизации по расписанию.
Если вы не обладаете правами разработчика, вы не можете просматривать установленные в схеме пакеты, но это не помешает вам проверить, корректный ли пакет интеграции был установлен в базе данных Rational ClearQuest. Для этого выполните следующие действия:
Запустите ClearQuest, выбрав из меню команды Start > Program Files > IBM Rational > IBM Rational ClearQuest > ClearQuest;
Выполните вход с именем пользователя и пароля учетной записи, обладающей правами для доступа к базе данных;
Выберите один из типов запросов, разрешенных для этой интеграции, и выполните его (например, запрос All Defects);
В результатах этого запроса выделите одну из записей:
После этого должна стать доступной вкладка RPM Integration. Перейдите на эту вкладку;
Если версия пакета ClearQuest - 1.3, то форма для этой таблицы будет состоять из трех секций. Нижняя секция (содержащая поле Parent record id), показанная на рисунке 2, была добавлена именно в этой версии.
Наша проверка корректности пакета RPMCQIntegration, примененного к схеме и базе данных ClearQuest, прошла успешно, и теперь мы можем приступить к настройке Rational Portfolio Manager. Чтобы использовать интеграцию, в Rational Portfolio Manager следует выполнить следующие действия:
Создать профиль (профили) интеграции ClearQuest;
Создать макеты для различных элементов, содержащих информацию интеграции ClearQuest;
Выполните вход в Rational Portfolio Manager с именем пользователя и паролем учетной записи, обладающей правами администратора, а затем нажмите кнопку Sign in, как показано на рисунке 3:
По окончании загрузки приложения найдите в навигационном дереве элемент Application Administration. Примечание: возможно, дерево развернуто не полностью. Если это так, воспользуйтесь полосой перехода над деревом и разверните дерево, как показано на рисунке 4. Нажмите и отпустите левую кнопку мыши на элементе Application Administration.
Можно также нажать кнопку Application Administration, если вы не хотите использовать полосу перехода (см. рисунок 4). Эта кнопка расположена сразу же под отображаемым фрагментом навигационного дерева. Чтобы найти нужную кнопку, подведите к ней указатель мыши, и вы увидите подсказку с ее именем. Нажмите кнопку Application Administration (эта кнопка обычно крайняя справа, как показано на рисунке 5):
На вкладке General рабочей области Application Administration (первая вкладка слева) введите URL Web-сервиса ClearQuest. URL сохраняется в секции ClearQuest Integration в нижней части вкладки. Чтобы найти это поле, возможно, вам придется воспользоваться полосой прокрутки, расположенной справа. Это поле нельзя редактировать непосредственно (хотя может показаться, что можно). Сначала нужно нажать кнопку с многоточием (…) справа от этого поля, как показано на рисунке 6:
После того как вы нажмете эту кнопку, откроется диалоговое окно ClearQuest Integration; введите URL Web-сервиса ClearQuest в поле WebService Address и нажмите кнопку OK, как показано на рисунке 7:
Воспользуйтесь стрелкой прокрутки вправо (она находится в правом верхнем углу приложения), чтобы найти вкладку ClearQuest Integration, показанную на рисунке 8. Эта вкладка - крайняя справа в списке вкладок;
Вкладка ClearQuest Integration имеет две вложенные вкладки: Mapping Profile (профиль отображения) и Integration Settings (параметры интеграции). В этой статье мы рассмотрим вкладку Mapping Profile . На вкладке Mapping Profile присутствуют две основных секции. Одна из них, Task Mappings, предназначена для настройки отображения задач, другая, Scope Element Mappings - для настройки отображения элементов программы работ. Если вы хотите добиться большей гибкости при работе с обеими вкладками, рекомендуем заполнять для каждого профиля обе секции;
Для этого вы сначала должны создать категорию Category, которая может включать несколько профилей. Перетащите при помощи мыши пиктограмму Category в левую панель, как показано на рисунке 10:
Перетащив категорию, введите имя в поле Name, а затем нажмите клавишу Enter;
Теперь необходимо создать профиль. Для этого перетащите мышью пиктограмму профиля Profile в только что созданную категорию, как показано на рисунке 11. Инструмент поможет вам определить, где именно следует разместить категорию. Чтобы проверить правильность размещения, посмотрите на указатель мыши прежде, чем отпустить пиктограмму:
если он выглядит следующим образом, то
вы правильно разместили профиль по отношению к категории. Убедитесь, что размещаете профиль в нужной категории, если их больше одной. Теперь можно отпустить левую кнопку мыши.
если указатель: выглядит так, как на следующем рисунке, то
вы еще не нашли правильное место, в котором можно отпустить левую кнопку мыши. Продолжайте перемещать профиль, пока указатель мыши не примет вид, указывающий на то, что правильное положение для профиля найдено. После этого можно отпустить левую кнопку мыши.
Приложение зарезервирует место для профиля, как показано на рисунке 11:
Введите имя для профиля в поле Name. Нам нужно имя, которое будет точно отражать тип создаваемого профиля. В примере на рисунке 12 выбрано имя CQTasks and SE;
Нажмите клавишу Enter. НЕ устанавливайте флажок в расположенном рядом поле Publish;
После создания профиля в главном окне становятся активными кнопки Add и Remove (см. рисунок 12):
Это позволит вам (как администратору) добавлять или удалять типы записей, которые были определены в ClearQuest. Незаметно для пользователя Rational Portfolio Manager динамически выполняет запрос к схеме ClearQuest, чтобы определить, какие типы записей доступны. Ниже для примера перечислено несколько типов записей:
Defects;
Change Requests;
Enhancement Requests;
Test Cases;
Test Plans.
Вы можете наблюдать и другие типы записей, в зависимости от особенностей проекта вашей схемы ClearQuest.
Выделив тип записи (в нашем примере, Defect), перейдите в следующее поле и из раскрывающегося списка выберите элемент, который будет соответствовать Task Name в Rational Portfolio Manager, как показано на рисунке 14. В нашем примере выбрано имя задачи Headline;
Перейдите в поле Resource Name, это следующее поле справа, и воспользуйтесь раскрывающимся списком для выбора режима назначения ресурсов в Rational Portfolio Manager (см. рисунок 15). Здесь доступны два варианта: Owner и Submitter. Owner предназначается для ресурса, который был назначен процессом оценки (это целиком зависит от ваших процессов управления изменениями) владельцем записи. Submitter предназначается для ресурса, который создает запись в ClearQuest. В этом примере используется поле Owner.
Затем необходимо заполнить поле % Complete. В этом поле указывается процент выполнения по состоянию записи в любой данный момент времени в ClearQuest. Такие состояния создаются и контролируются в ClearQuest. Их значения используются, если выбран сценарий duration-based;
Чтобы вызвать соответствующее диалоговое окно, нажмите и отпустите левую кнопку мыши в поле % Complete. Рядом с полем появится кнопка с многоточием, нажмите ее; откроется диалоговое окно RPM % Complete, показанное на рисунке 16. (По умолчанию для всех состояний (States) отображается значение 0%.)
Эти процентные значения должны определяться и согласовываться с инвесторами и пользователями до начала реализации. В нашем примере используются значения, показанные на рисунке 17:
Эти значения взяты только для примера и не могут быть рекомендованы для использования в конкретной реализации. Добавив значения для каждого состояния ClearQuest, нажмите кнопку OK. Следующее поле используется для того, чтобы отобразить некоторые поля ClearQuest в поля Rational Portfolio Manager. Пользовательские поля представляют собой короткие текстовые поля, которые могут отображать не более 400 байт текста. Эти поля хорошо подходят для отображения такой информации, как название запланированной итерации или идентификатор. Эти поля не рекомендуется использовать как отображения многострочных полей (например, Notes Log, Description или CQTMTNotesLogs);
Нажмите и отпустите левую кнопку мыши на ярлыке Custom Fields, после этого рядом появится кнопка с многоточием. Нажмите эту кнопку; откроется диалоговое окно RPM Custom fields, показанное на рисунке 18.
В диалоговом окне RPM Custom fields отображается список доступных в схеме ClearQuest полей без учета их типа (например, short string, integer и т. д.). Примечание: эти поля создаются как пользовательские поля и в Rational Portfolio Manager. Они отображаются на вложенной вкладке >Fields вкладки Custom Field (эта вкладка находится на том же уровне, что и вкладка ClearQuest Integration) (рисунок 19);
В диалоговом окне Application Adminstration на вложенной вкладке Fields вкладки Custom Fields разверните категории WBS/Scope и ClearQuest_Integration_WBS_Task, как показано на рисунке 19:
По умолчанию в диалоговом окне RPM Custom fields не выделено ни одно из полей. При помощи полосы прокрутки справа просмотрите весь список полей, которые доступны для выбора. Старайтесь выбирать такие поля, которые определены как short strings или numeric;
Выберите поля ClearQuest, содержимое которых вы хотели бы видеть в представлении Rational Portfolio Manager Description для задачи, которая будет создана при импорте этого типа записи из ClearQuest, а затем нажмите кнопку OK, как показано на рисунке 20.
Затем необходимо заполнить RTF-поля. Поля RTF предназначены для хранения текстовых данных в формате Rich Text Format. Для каждого типа задачи (или суммарной задачи) доступны десять (10) таких полей. Поля RTF могут содержать до 32 Кбайт текста; эти поля следует использовать для отображения многострочных текстовых полей, таких как Status Update или Description;
После щелчка по полю RTF рядом с ним появляется кнопка с многоточием. Если нажать на эту кнопку, откроется диалоговое окно RPM RTF fields, показанное на рисунке 21:
Поля, описанные в столбце RTF Field Label, определяются в Rational Portfolio Manager администратором. Они находятся на вкладке Datafields > RTF, показанной на рисунке 22. Эта вкладка находится на том же уровне, что и вкладка ClearQuest Integrations (отношение между этими двумя вкладками такое же, как и для вкладок Custom Fields и ClearQuest Integrations).
Если этот список вас не удовлетворяет (RTF Field Label), вам придется определить нужные поля RTF до создания профиля.
Чтобы закончить отображение для этих полей, нажмите и отпустите левую кнопку мыши в столбце ClearQuest Fields для того значения RTF Field index, которое вы хотите задать. Откроется раскрывающееся меню;
При помощи линейки прокрутки, расположенной справа от этого списка, найдите поле ClearQuest, которые вы хотите использовать, как показано на рисунке 23;
Нажмите и отпустите левую кнопку мыши на этом имени поля. Выбранное значение появится в столбце ClearQuest Fields;
Таким же образом нужно указать значения для всех полей RTF. Если такие поля нужны вам и для Tasks, и для Summary Tasks, вам придется ввести информацию для двух типов индексов, как показано на рисунке 24:
Определив все отображения, нажмите кнопку OK, чтобы закрыть диалоговое окно. Мы закончили работу с секцией отображения задач Task Mapping для одного типа записей (см. рисунок 25).
Если нужно определить и другие типы записей, вам придется повторно выполнить эти инструкции для каждого такого типа записи (начиная с шага 7 в разделе Создание профиля интеграции).
При разработке профилей необходимо иметь в виду два момента.
После того как вы опубликовали профиль и приступили к его использованию, вы больше не сможете вносить в этот профиль изменения (в том числе, вы не сможете увидеть ваши настройки, нажимая левой кнопкой мыши в полях). Если подвести к полю указатель мыши, можно увидеть фрагмент списка, как показано на рисунке 26.
Примечание: Ширину столбца в этом представлении можно увеличить (см. рисунок 25), это позволит увидеть все содержимое столбца. Далее, можно воспользоваться горизонтальной полосой прокрутки для просмотра каждого поля, как показано на рисунке 27. Рекомендуется до публикации и использования профиля документировать его в какой-либо форме, например в виде снимка экрана или списка;
В Rational Portfolio Manager версий 7.0.x и V7.1.x любому проекту можно назначить только один профиль. Это означает, что если вы хотите ассоциировать несколько типов записей из ClearQuest с одним и тем же проектом, то профиль должен содержать отображение задач для каждого типа записей. Когда все отображения задач (Task Mappings) будут готовы, профиль может выглядеть примерно так, как на рисунке 28.
Мы закончили работу с секцией Task Mappings Все результаты работы будут сохранены даже в том случае, если вы закроете приложение. Важно: ни один пользователь, включая вас, не может обращаться к этому профилю, чтобы назначить его проекту до тех пор, пока профиль не опубликован. Любые изменения в готовых отображениях, а также добавление новых Task Mappings возможны только до публикации профиля и ассоциирования его с проектным предложением или проектом.
Мы успешно настроили секцию Task Mapping на вкладке ClearQuest Integration в Rational Portfolio Manager. Это дает нам возможность импортировать типы записей ClearQuest, определенные в профиле, в задачи или суммарные задачи Rational Portfolio Manager. Кроме того, мы сможем выполнять экспорт из Rational Portfolio Manager в предварительно заданные типы записей ClearQuest.
В приведенном примере мы создали отображение задач (Task Mapping) для типа записи defect. Воспользовавшись нашими инструкциями, вы сможете создать несколько отображений задач, которые будут удовлетворять вашим требованиям. Как показывает рисунок 28, вы не ограничены одним типом записи на профиль. Это дает вам необходимую гибкость в прикреплении различных типов записей ClearQuest к любому проекту с учетом требований конкретного процесса. Вы также не ограничены в количестве используемых профилей, хотя необходимо иметь в виду информацию из раздела "Работа с профилями".
Создание профиля еще не закончено, поэтому в следующей статье этой серии мы расскажем о том, как закончить работу над профилем (в том числе, поработаем с секциями Scope Mapping и Resource Mapping), а также о том, как его опубликовать. Часть 3 данной серии статей посвящена настройке макета Description View для проекта, задачи и элемента программы работ.
Благодаря такой настройке вы (как руководитель проекта) получите возможность просматривать данные ClearQuest, которые были сделаны видимыми через профиль (профили); это обеспечит легкий доступ к данным разработки.