Это вторая статья цикла, посвященная интеграции IBM Rational Portfolio Manager и IBM Rational ClearQuest. В ней мы остановимся на настройке параметров вкладки Scope Mapping профиля Rational ClearQuest в Rational Portfolio Manager и на взаимном отображении ресурсов ручным и автоматическим способом. В статье также объясняется использование интеграции в инструментах Rational Portfolio Manager и ClearQuest. В следующей статье мы расскажем о том, как настроить макет для типов Project, Task и Scope Element. В последней статье серии мы рассмотрим установку и настройку параметров связующего ПО, которое необходимо для поддержки данной интеграции.
Выбор профиля
- Выполните вход в Rational Portfolio Manager с именем пользователя и паролем учетной записи, имеющей полномочия на администрирование приложений, а затем нажмите кнопку Sign in (см. рисунок 1):
Рисунок 1. Диалоговое окно входа в Rational Portfolio Manager
- В навигационном меню найдите категорию Application Administration, нажмите и отпустите левую кнопку мыши (возможно, придется развернуть меню при помощи полосы перехода);
Чтобы развернуть категории, можно также нажать следующую кнопку (см. рисунок 3).
Рисунок 3. Подсказка с именем кнопки Application Administration
- При помощи стрелки прокрутки вправо в правом верхнем углу диалогового окна перейдите на вкладку ClearQuest Integration (см. рисунок 4). На момент написания данной статьи это самая крайняя вкладка справа;
Рисунок 4. Вкладка ClearQuest Integration в окне Application Administration
- Перейдите на вкладку ClearQuest Integration (см. рисунок 5);
Рисунок 5. Вкладка ClearQuest Integration в окне Application Administration
Вкладка ClearQuest Integration имеет две вложенные вкладки: Mapping Profile (Профиль отображения) и Integration Settings (Параметры интеграции). По умолчанию обычно отображается вкладка Mapping Profile.
- Разверните категорию, которую мы создали в процессе изучения первой статьи. В нашем примере она получила имя Profiles2;
- Нажмите левой кнопкой мыши на профиле, который мы начали созадавать в первой статье (его имя - CQTask and SE, см. рисунок 6).
Рисунок 6. Профили Profile CQTasks и SE на вкладке ClearQuest Integration 
Отображение элементов программы работ
Секция Scope Element Mapping появилась в Rational Portfolio Manager версии 7.1. С ее помощью можно отобразить типы записей Rational ClearQuest в элементы программы работ Rational Portfolio Manager. Rational Portfolio Manager включает следующие элементы программы работ:
- Defect (Дефект);
- Change Request (Запрос на изменение);
- Issue (Проблема);
- Risk (Риск);
- Requirement (Требование);
- Service Request (Запрос сервиса);
- Action (Операция).
В зависимости от имеющихся процессов можно использовать часть элементов, все элементы или не использовать элементы вообще; в любом случае вам нужно будет отобразить различные элементы программы работ в типы записей ClearQuest. Для этого используется секция Scope Element Mappings в профиле ClearQuest Integration.
- Нажмите кнопку Add в секции отображения элементов программы работ Scope Element Mappings (см. рисунок 7);
Рисунок 7. Кнопка Add в секции Scope Element Mappings
В секцию Scope Element Mappings будет добавлена новая строка. Первое поле для типа записи Record Type заполняют при помощи раскрывающегося списка выбора, в котором представлены все типы записей, доступные для данной схемы ClearQuest (см. рисунок 8). Тип записи по умолчанию в данном списке всегда отображается первым.
Рисунок 8. Раскрывающийся список выбора в секции Scope Element Mapping
- Чтобы найти нужный тип записи, воспользуйтесь полосой прокрутки. В примере на рисунке 9 выбран элемент Defect;
- Для вывода раскрывающегося списка выбора в следующем поле, Scope Element Type, установите в это поле указатель мыши, а затем нажмите и отпустите левую кнопку мыши;
- Выберите из списка тип элемента Rational Portfolio Manager. При помощи этого действия мы отображаем данный элемент в выбранный тип записи. В примере на рисунке 9 стрелка указывает тип элемента программы работ Defect. После выбора он отобразится в данном поле;
Рисунок 9. Раскрывающийся список Scope Element Type в секции Scope element mapping
Затем необходимо заполнить поле Standard Fields. Оно содержит список обязательных и необязательных полей. Перед именем обязательного поля имеется символ звездочки (*). До тех пор, пока обязательные поля не будут заполнены, вы не сможете задать отображение полей.
- Для доступа к этому полю нажмите и отпустите левую кнопку мыши в поле Standard Fields;
- Когда появится кнопка с многоточием (...), нажмите ее, чтобы вывести на экран диалоговое окно Rational Portfolio Manager Standard Fields (Стандартные поля Rational Portfolio Manager) (рисунок 10);
Рисунок 10. Диалоговое окно Rational Portfolio Manager Standard Fields
В открывшемся диалоговом окне все поля будут незаполненными. Каждое поле содержит раскрывающийся список всех полей, доступных для данного типа записи ClearQuest (рисунок 11).
- При помощи этих контекстных меню заполните два обязательных поля и одно из необязательных полей;
Рисунок 11. Раскрывающийся список в диалоговом окне Rational Portfolio Manager Standard Fields
В примере, показанном на рисунке 12, заполнены все поля. Это не рекомендация, а пример, показывающий, какой тип информации можно использовать. Если дополнительно установить флажок в нижней части окна, URL записи ClearQuest будет помещен в портлет Rational Portfolio Manager Documents. В данном примере флажок установлен.
Рисунок 12. Заполненное диалоговое окно Rational Portfolio Manager Standard Fields
- Заполнив все обязательные и необязательные поля, нажмите кнопку OK. Теперь поле в отображении будет содержать эту информацию;
- Следующее поле должно выглядеть знакомым, потому что оно содержит уже знакомое нам имя Custom Fields. Кроме того, оно содержит те же данные. Чтобы перейти к этому полю, нажмите и отпустите левую кнопку мыши в области Custom Fields. Нажмите появившуюся кнопку с многоточием для вывода на экран диалогового окна для этих полей (рисунок 13);
Рисунок 13. Диалоговое окно Custom Fields в Rational Portfolio Manager
- Это диалоговое окно заполняется точно так же, как диалоговое окно Task Mapping. Не забывайте, что пользовательские поля могут содержать лишь небольшие объемы данных, поэтому установите флажок в поле short string или numeric (см. рисунок 14). Для отображения более длинных текстовых полей можно использовать портлет RTF Fields (rich text format) в следующем столбце отображения;
Рисунок 14. Заполненное диалоговое окно Custom Fields в Rational Portfolio Manager
- Установив флажки во всех полях, которые, по вашему мнению, должны отображаться в Rational Portfolio Manager, нажмите кнопку OK;
Имя последнего столбца, который необходимо заполнить - RTF Fields. Это поле также выглядит знакомым, потому что оно аналогично полю RTF fields в секции Task Mapping. Поле содержит 10 имен портлетов. Эти поля определяются на вложенной вкладке RTF вкладки Datafields в Rational Portfolio Manager.
- Разверните тип элемента объема работ (в нашем примере развернут элемент Defect), чтобы вывести на экран список портлетов RTF (см. рисунок 15). Если портлет не определен, как портлет 10 в столбце Rank (рисунок 15), вы не сможете задать отображение на этот портлет в отображении профиля ClearQuest;
Рисунок 15. Развернут элемент Datafields > RTF > Defect
- Чтобы перейти к этому полю, нажмите и отпустите левую кнопку мыши в поле RTF Fields;
- Нажмите появившуюся кнопку с многоточием , чтобы вывести на экран диалоговое окно Rational Portfolio Manager Scope RTF Fields: Defect (рисунок 16);
Рисунок 16. Диалоговое окно Rational Portfolio Manager Scope RTF Fields: Defect
В открывшемся диалоговом окне все поля будут незаполненными. В каждом поле имеется раскрывающийся список выбора. Поскольку эти поля могут содержать большие объемы данных, их следует отображать в многострочные поля, определенные в ClearQuest. Раскрывающийся список снова содержит список всех полей, доступных для данного типа записи ClearQuest.
- Перейдите к этому полю, воспользовавшись полосой прокрутки, а затем выделите его (рисунок 17);
Рисунок 17. Диалоговое окно Scope RTF Fields: Defect в Rational Portfolio Manager
- Заполните остальные поля RTF > ClearQuest;
- Заполнив все доступные поля, нажмите кнопку OK.
Отображение элементов объема работ на этом успешно завершено. Если вам нужно определить и другие отображения, необходимо повторить инструкции этого раздела, начиная с Шага 1, и создать новое отображение элементов объема работ для каждого типа записей в Rational ClearQuest. На рисунке 18 показана заполненная вкладка Mapping Profiles с несколькими значениями в обеих секциях.
Рисунок 18. Заполненный профиль отображения с несколькими значениями в обеих секциях
Публикация профиля
Заключительным шагом с точки зрения настройки параметров является публикация профиля. Не забывайте, что, воспользовавшись этим профилем, вы уже не сможете изменить его (если только не удалите из всех проектов, ассоциированных с ним).
- Чтобы опубликовать профиль, установите флажок в столбце Publish напротив имени профиля (см. рисунок 19).
Рисунок 19. Опубликованный профиль ClearQuest
Параметры интеграции для отображения ресурсов
- После этого на вкладке Integration Settings в секции Resource Mappings определите используемые параметры отображения ресурсов (см. рисунок 20).
Примечание
В секции Middleware Integration Settings отображаются также параметры интеграции связующего ПО, но эти поля доступны только для чтения. Они настраиваются в файле свойств без использования клиента Rational Portfolio Manager.
Рисунок 20. Вложенная вкладка параметров интеграции
Автоматизированное отображение ресурсов
Rational Portfolio Manager поддерживает модель обеспечения безопасности, определенную в Rational ClearQuest. Это означает, что вы не получите авторизованного имени пользователя для ClearQuest даже в том случае, если попробуете импортировать полномочия в Rational Portfolio Manager. В этом случае импорт не состоится, а вы получите сообщение, показанное на рисунке 21. Вход в ClearQuest осуществляется через мост интеграции.
Рисунок 21. Уведомление о недействительном имени входа
Rational Portfolio Manager допускает три способа доступа пользователей к мосту интеграции ClearQuest:
- Email ID (через адрес электронной почты);
- Name (через имя);
- Login Name (через имя входа).
Описание каждого из этих способов вы увидите, если выберете соответствующий вариант в области Resource Mapping вложенной вкладки Integration Settings. По умолчанию выбран вариант Email ID (см. рисунки 22-24).
Рисунок 22. Отображение ресурсов при помощи Email ID
Для поля Name имеется две опции:
- Full Name (Полное имя);
- Nick Name (Псевдоним).
В поле description отображается выбранный объект. Значение по умолчанию - Full Name (рисунок 23).
Рисунок 23. Отображение ресурсов при помощи опций Name, Full Name или Nick Name
Последняя из опций - Login Name (см. рисунок 24). Для отображения ресурсов можно выбрать только один из этих методов; после того, как метод будет выбран, он применяется ко всему портфелю. Не все поля, используемые в различных методах, являются обязательными, поэтому ваш процесс должен отражать выбранные вами варианты.
Рисунок 24. Отображение ресурсов при помощи Login Name/Username
Определив метод, который вы будете использовать, нажмите кнопку Apply Resource Mapping (рисунок 24).
На экране появится диалоговое информационное окно, показывающее, что процесс начался (рисунок 25).
Рисунок 25. Диалоговое окно уведомления Communication
Представление Communication отображается в том случае, если существуют любые ресурсы Rational Portfolio Manager, которые можно отобразить на соответствующие ресурсы ClearQuest. Это позволяет разрешить их до того, пока кто-нибудь не начнет использовать интеграцию (см. рисунок 26). Если в области Notification Comment нет никакой информации, значит, все ресурсы в Rational Portfolio Manager уже были успешно отображены в соответствующие ресурсы ClearQuest.
Если у вас есть такие пользователи, то одной из возможных причин может быть то, что объекты (адреса электронной почты, например), используемые для отображения ресурсов, возможно, не были заполнены в одном из приложений. Такие ресурсы можно отобразить вручную в Rational Portfolio Manager. Для этого вам не придется повторно запускать функцию отображения ресурсов, но необходимо убедиться, что соответствующие ресурсы доступны в Rational ClearQuest. Пользователь должен иметь подписку на базу данных Rational ClearQuest, кроме того, необходимо обновить базу данных для доступа к этим подпискам. В нашей инструкции не описано создание пользователей ни в одном из двух приложений.
При помощи списка, отображаемого в представлении Communication, можно выполнить отображение пользователей вручную. Если таких пользователей много, необходимо решить проблему, лежащую в основе ситуации (незаполненные псевдонимы пользователей, адреса электронной почты и т. д.), а затем повторно запустите Apply Resource Mapping на вкладке ClearQuest Integration. Однако если нужно выполнить отображение всего нескольких пользователей (как показано на рисунке 26), то в этом случае превосходной альтернативой будет неавтоматический метод.
Примечание: чтобы использовать этот метод, необходимо иметь полномочия на редактирование ресурсов.
- Откройте представление Resource Management, а затем нажмите и отпустите левую кнопку мыши на категории Resource Management в навигационном каталоге слева;
Рисунок 27. Представление Resource Management
- Разверните нужную категорию или категории и найдите ресурсы, которые необходимо отобразить. Выделите ресурс и нажмите на нем правой кнопкой мыши. На экране отобразится контекстное раскрывающееся меню (рисунок 28);
Рисунок 28. Отображение контекстного меню для ресурса в представлении Resource Management
- На экран будет выведено диалоговое окно Associate ClearQuest User (рисунок 29). Обратите внимание на то, что поле слева не содержит раскрывающегося списка;
Рисунок 29. Диалоговое окно Associate ClearQuest User
- При помощи раскрывающегося списка и полосы прокрутки найдите и выделите имя пользователя ClearQuest, которое будет ассоциировано с именем ресурса Rational Portfolio Manager (см. рисунок 30), а затем нажмите кнопку OK;
Рисунок 30. Выбор пользователя ClearQuest
Диалоговое окно будет закрыто.
Проверка всех отображений ресурсов
Чтобы проверить успешность выполнения отображений для всех ресурсов, можно добавить новый заголовок в макет в представлении Resource Management.
- Поместите указатель мыши в выделенную область (любую) и нажмите правой кнопкой, чтобы вывести на экран раскрывающееся контекстное меню;
- Из этого меню выберите команду Customize Layout (см. рисунок 31);
Рисунок 31. Контекстное меню в представлении Resource Management
- В появившемся диалоговом окне Customize перейдите на вкладку Custom Fields (рисунок 32), а затем перетащите заголовок CQ_UserName в область заголовка;
Рисунок 32. Диалоговое окно Customize
Совет:
этот заголовок удобно отпустить между строкой Indicators и строкой Quick Status. На рисунке 33 показано, в каком месте следует отпустить заголовок.
Рисунок 33. Здесь следует добавить новый заголовок в представлении Resource Management
- Добавив новый заголовок, обязательно сохраните его (установите флажок рядом с именем макета). Если сохранение пройдет успешно, то рядом с этим местом вы увидите значок Х;
Теперь вы можете видеть все ресурсы Rational Portfolio Manager и ассоциируемые с ними имена пользователей ClearQuest (рисунок 34). Это простой способ найти любые ресурсы, для которых не было выполнено отображение.
Что дальше
На этом настройку Rational Portfolio Manager можно считать законченной. Профиль готов к использованию, а для всех пользователей выполнены и проверены отображения. На следующем этапе необходимо ассоциировать профиль с проектами и проектными предложениями. Однако прежде, чем вы сможете добавить профиль в проект или проектное предложение, необходимо немного изменить макеты, чтобы можно было видеть всю информацию из Rational ClearQuest. В следующей статье мы расскажем о том, как изменить макеты для трех объектов в Rational Portfolio Manager. Читать часть 3.