Коллективная (или параллельная) работа над схемой IBM® Rational® ClearQuest® хотя и вполне возможна, но сопровождается определенными сложностями. Тем не менее, в некоторых ситуациях для ускорения разработки нескольким проектировщикам приходится работать со схемой одновременно.

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

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

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

Вообще говоря, существует два метода для разработки схемы в IBM® Rational® ClearQuest: последовательная разработка схемы и параллельная разработка схемы.

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

Информационном центре по IBM Rational ClearQuest Information Center.

>

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

• Конфликты именования
• Перезаписывание форм
• Отсутствующая или неединообразная информация пакета
• Мертвые связи
• Организационные проблемы

При импортировании схемы можно увидеть следующее сообщение об ошибке: The name XYZ is already in use (Имя XYZ уже используется). Эта ошибка указывает на наличие конфликта именования. Как правило, причина состоит в том, что вы пытаетесь создать (или переименовать) объект с именем, которое идентично имени уже существующего объекта. Этого делать не разрешается.

Все объекты какого-либо одного типа должны иметь уникальные имена. Возможные типы объектов:

• Record types (Тип записи)
• Fields (Поле)
• States (Состояние)
• Actions (Действие)
• Record scripts (Скрипт записи)
• Global hooks (Глобальная ловушка)
• Forms (Форма)
• Named lists (Список имен)

Например, два типа записи не могут иметь имя Defect, а две поля в одном типе записи не могут иметь имя Headline. Несомненно, можно использовать поле с именем Headline в типе записи Defect и другое поле с таким же именем Headline в типе записи EnhancementRequest.

Если вы не сможете добиться того, чтобы каждый объект имел уникальное имя, ClearQuest возвратит следующее сообщение об ошибке: name XYZ is already in use (имя XYZ уже используется).

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

Обычно вы узнаете о том, что столкнулись с этой проблемой, если не видите изменений, которые разработчик внес в форму, или если вы раньше видели определенные изменения, но они пропали после выполнения следующей команды importintegration.

Причина этого состоит в том, что формы ClearQuest имеют кодировку Base64. Это означает, что любое изменение, даже минимальное, приводит к записи нового определения формы. Другими словами, даже если вы перемещаете кнопку всего на один пиксел вверх или вниз, вы получаете совершенно новое определение формы. Когда в следующий раз вы экспортируете свои изменения с помощью команды cqload exportintegration, полная форма экспортируется вместе со всеми остальными изменениями, которые вы внесли.

Предположим, что Разработчик 1 изменил форму Submit записи типа Defect. Разработчик 2 случайно сдвинул на один пиксел элемент Button (Кнопка) в той же форме Submit записи типа Defect. Оба разработчика экспортировали свои изменения и прислали их вам.

В соответствии со своим потоком работ вы сначала импортируете изменения, сделанные Разработчиком 1. После импорта вы смотрите на форму Submit записи типа Defect и видите, что изменения Разработчика 1 были внесены в схему.

Затем вы импортируете изменения, сделанные Разработчиком 2. Поскольку никаких ошибок не произошло, вы смотрите на схему снова и обнаруживаете, что изменения Разработчика 1 пропали. Вы только что испытали т.н. «перезаписывание формы».

Отсутствие или неединообразие информации пакета – это, вероятно, наиболее трудная проблема для разрешения. При возникновении этой проблемы не пытайтесь устранить ее своими силами, а вместо этого обратитесь за помощью в службу поддержки клиентов IBM Rational.

Хорошая новость состоит в том, эту проблему очень легко предотвратить

В общем случае в ClearQuest имеется два вида пакетов.

• Автономные пакеты
  
  Эти пакеты предлагают содержащиеся в них функциональные возможности. Другими словами, вы сможете применить эти пакеты к схеме «Blank», после чего и у вас будет полностью функциональная схема. Например, пакет EnhancementRequest добавляет тип записи (помимо прочего), при этом для его использования не требуется существования никаких других типов записей.
• Зависимые пакеты
  
  Эти пакеты не могут быть использованы сами по себе, но добавляют функциональные возможности к типу записи. Например, пакет Notes добавляет поля и ловушки к существующим типам записей. Таким образом, этот пакет может быть практически использован только в том случае, если указанные типы записей уже присутствуют в схеме.

Главное различие между этими двумя типами пакетов состоит в процедуре их установки. Оба типа пакетов устанавливаются с помощью мастера Package Installation. Кроме того, зависимые пакеты также должны быть добавлены к одному или более типам записей с помощью функции Setup Record Types for Packages инструмента ClearQuest Designer.

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

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

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

Другая потенциальная проблема состоит в том, что разные версии какого-либо пакета могут содержать разные метаданные. Например, версия 5.0 пакета Notes имеет не такие ловушки, как версия 5.1 этого же пакета (BASIC-ловушки были удалены, а ловушка Validation была добавлена).

Предположим, что пакет Notes 5.0 применен к главной схеме. Разработчик решил модернизировать свою копию схемы до версии Notes 5.1.

Как и ожидалось, ClearQuest удаляет BASIC-ловушки и добавляет новую ловушку Validation, которая появилась в версии 5.1 этого пакета. После того, как этот Разработчик экспортировал свои изменения, изменения, порожденные модернизацией пакета, также экспортируются и воспроизводятся в главной схеме в процессе импортирования изменений.

Продукт ClearQuest не обнаруживает, что пакет Notes был модернизирован до версии 5.1, даже при том, что метаданные соответствуют версии Notes 5.1. Свойства вашей схемы указывают, что установлен пакет Notes 5.0, а в действительности вы установили Notes 5.1.

Проблема состоит в том, что вы можете очень долго не замечать эти проблемы – вплоть до нескольких месяцев после исполнения команды importintegration – поскольку ваша схема по-прежнему работает прекрасно. Проблема станет очевидной только тогда, когда вы попытаетесь модернизировать установленные пакеты (с помощью функции Upgrade Installed Packages инструмента Designer). Если информация о соответствующих пакетах будет отсутствовать в схеме, то ClearQuest не сообщит ни о каких пакетах, способных к модернизации. Если ваша схема уже была непреднамеренно модернизирована до версии Notes 5.1, то ваша модернизация пакета потерпит неудачу, поскольку ClearQuest попытается удалить BASIC-ловушки, которые уже не существуют, поскольку они были удалены на этапе модернизации пакета в схеме разработки.

Повторяю еще раз. Эта ситуация рассматривается как повреждение схемы. Вам не следует пытаться устранить ее своими силами, а вместо этого надо обратитесь за помощью в службу поддержки клиентов IBM Rational.

Примечание.
В данной статье под «мертвыми» связями в схемах ClearQuest могут пониматься не только типы полей REFERENCE или REFERENCE_LIST, но также и любые разновидности ссылок от одного объекта к другому.

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

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

• Ловушки (GetEntity и другие API-вызовы)
• Формы (контроль форм на предмет несуществующих полей)
• Поля (несуществующий именованный список, выбранный в качестве предпочтительного списка)
• Столбцы просмотра списка, когда определенный столбец обращается к несуществующему полю.
• Действия (скрипт Record Script, используемый действием RECORD_SCRIPT_ALIAS, не существует, или действие должно перевести запись в отсутствующее целевое состояние State)

Как правило, исправление этих проблем осуществляется сравнительно просто. Кроме того, их достаточно легко предотвратить.

Как говорят англичане, «Излишек поваров портит еду». (Русский аналог: «У семи нянек дитя без глазу»). Вы вполне сможете найти многочисленные примеры, которые подтверждают этот тезис. На практике организационные проблемы не являются специфическими для разработки схемы ClearQuest (применительно к тематике данной статьи - для параллельной разработки схемы). Тем не менее, эта разновидность проблем типична для процесса разработки схемы, особенно при использовании коллективного подхода.

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

Таким образом, у вас возникнуть следующий вопрос: «В какую версию какой схемы разработки были внесены изменения X?»

Портал службы поддержки IBM. Чтобы представить запрос на обслуживание, нажмите на ссылку «Открыть средство подачи запроса» в правом нижнем углу начальной страницы этого портала.

При подаче своего запроса сообщите специалисту IBM следующую информацию:

• Используемая версия ClearQuest
• Список выполненных вами команд (cqload exportintegration/importintegration)
• Точное сообщение об ошибке, возможно – снимки экрана и системные журналы
• Экспорт целевой схемы или резервная копия базы данных, содержащая репозитарий схемы
• Все экспортные файлы, созданные с помощью команд cqload exportintegration, которые вы пытаетесь импортировать
• Описание порядка импортирования экспортных файлов в целевую схему

>

Итак, вы увидели, что для избежания трудностей при параллельной работе со схемами ClearQuest необходимо тщательное планирование и надлежащее информирование участников. Тем не менее, следование описанным в этой статье типовым методикам существенно повышает вероятность успешного выполнения вашего проекта «с первой попытки». Если, несмотря на все приготовления, по какой-либо причине что-то пойдет ненадлежащим образом, вы сохраняете хорошие шансы на устранение возникшей ошибки.

И, наконец, если вы не в состоянии устранить ошибку самостоятельно, вы можете обратиться за помощью в Службу поддержки клиентов IBM Rational.

Научиться

• Оригинал статьи: Collaborative Schema Design with IBM Rational ClearQuest (EN).
  
  
• Просмотрите страницы по продукту Rational ClearQuest на ресурсе developerWorks – там приведены ссылки на технические статьи и другие релевантные ресурсы. Хорошим источником для получения первичной информации является начальная странице по программному обеспечению Rational на ресурсе developerWorks.(EN)
  
  
• Посетите Информационный центр по IBM Rational ClearQuest Information Center.(EN)
  
  
• Загрузите бесплатную пробную версию Rational ClearQuest.(EN)
  
  
• Ознакомьтесь с другими приложениями платформы IBM Rational Software Delivery Platform, включая коллективные инструменты для параллельной и территориально распределенной разработки, а также специализированные программные продукты для управления архитектурой, управления активами, управления изменениями/выпусками, управления интегрированными требованиями, управления процессами/портфелями и управления качеством. Для получения руководств по продуктам, инструкций по установке и другой документации обратитесь в Центр онлайновой документации по продуктам IBM Rational. (EN)
  
  
• Ознакомьтесь с каталогом курсов по продуктам Rational. (которые предусматривают самостоятельное компьютеризированное обучение, самостоятельное обучение в онлайновом режиме и обучение под руководством инструктора в онлайновом режиме). Эти курсы, различающиеся по сложности от начального до высшего уровня, позволят вам усовершенствовать свои навыки и углубить свои знания об инструментах Rational. Курсы, представленные в этом каталоге, доступны для приобретения в варианте для самостоятельного компьютеризированного обучения и в варианте для обучения в Интернет-режиме. (EN)
  
  
• Подпишитесь на информационный бюллетень IBM developerWorks – еженедельный обзор по лучшим материалам на ресурсе developerWorks (учебным пособиям, статьям, материалам для загрузки, мероприятиям сообщества, Web-трансляциям и событиям).(EN)
  
  

Получить продукты и технологии

• Загрузите пробные версии программных продуктов IBM Rational.(EN)
  
  
• Загрузите ознакомительные версии программных продуктов IBM и приобретите опыт работы с инструментами разработки и продуктами связующего уровня семейств DB2®, Lotus®, Tivoli® м WebSphere®.(EN)
  
  

Обсудить

Кристиан Глокнер (Christian Glockner) более трех лет работает инженером технической поддержки в Европейской службе поддержки клиентов IBM Rational, где помогает клиентам в использовании продукта IBM Rational ClearQuest. Одновременно с этим он участвовал в несколько внутрикорпоративных проектах IBM в области ClearQuest, один из которых включал планирование и разработку схемы в составе группы из двух проектировщиков, а также развертывание системы и ее техническое сопровождение. Кроме того, К. Глокнер консультирует коллег по методике разрешения проблем Кепнера и Трего (Kepner-Tregoe), которую служба поддержка клиентов Rational внедрила несколько лет назад. В свободное время К. Глокнер любит путешествовать, слушать музыку и участвовать в различных развлекательных мероприятиях.

Помощь по сообщениям о нарушениях

Спасибо. Эта запись была помечена для модератора.

>

Помощь по сообщениям о нарушениях

Сообщение о нарушении не было отправлено. Попробуйте, пожалуйста, позже.

>

developerWorks: вход

>

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

Вся введенная информация защищена.

Выберите ваше отображаемое имя

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

Отображаемое имя должно иметь длину от 3 символов до 31 символа. Ваше Имя в системе должно быть уникальным. В качестве имени по соображениям приватности нельзя использовать контактный e-mail.

>

Вся введенная информация защищена.

SITE_ID=40

Zone=Rational

ArticleID=660752

ArticleTitle=Совместное проектирование схемы в среде IBM Rational ClearQuest

publish-date=05252011