Как сформировать ссылку на запись для ClearQuest Web 7.1

<< Перейти в раздел «ClearQuest FAQ»

Ссылка на запись для cqweb 7.1 должна быть в следующем формате:

http://<hostname>/cqweb/restapi/<con_name>/<udb_name>/RECORD/<CQID>?format=HTML&noframes=true&recordType=<Record type>

где:

• hostname – наименование сервера, на котором расположен cqweb, если используется не 80-й порт, то с указание порта через двоеточие
• con_name – наименование подключения
• udb_name – наименование пользовательской базы данных ClearQuest
• CQID – идентификатор записи ClearQuest
• Record type – тип записи ClearQuest

Пример:

http://CQWEBSERVER:8080/cqweb/restapi/7.0.0/ALMIN/RECORD/ALMIN00000007?format=HTML&noframes=true&recordType=ALMRequestc

Как локализовать ClearQuest Web 7.0

<< Перейти в раздел «ClearQuest FAQ»

Если необходимо поменять какие-то текстовые надписи на формах ClearQuest Web (допустим, перевести на русский), то для этого необходимо

1. Перейти в каталог продуктов Rational «Common\rwp\EmbeddedExpress\profiles\profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\view\browser».
2. Выбрать необходимый подкаталог, допустим «entitydef», если необходимо поменять надписи для формы сущности.
3. Открыть на редактирование файл со словарем, «entitydef_en.xml» если это форма сущности.

Пример:

• Изменение

• Результат

Примечание:

Файлы-словари для верхнего меню находятся в каталоге «Common\rwp\EmbeddedExpress\profiles\profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\dct\xsl» в файле «dct_en.xml».

Важно:

Все изменение должны вноситься в кодировке UTF-8, если вносим изменения с помощью блокнота, то можно выбрать «Сохранить как….» и установить кодировку.

Дополнительно:

Customizing form layout in CQWeb

Как выполнить экспорт и импорт части схемы?

<< Перейти в раздел “ClearQuest FAQ”

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

Для этих целей cqload имеет две подкоманды:

• exportintegration – экспорт изменений для схемы на локальный диск. Используется с параметрами:
  • -dbset <connection name> – наименование подключения CQ
  • <cq-login> – логин для подключения к базе данных CQ
  • <cq-password> – пароль
  • <schema name> – наименование схемы
  • <begin_rev> – номер версии схемы, с которой выполнять экспорт
  • <end_rev> – номер версии схемы, по которую выполнять импорт
  • <recor_type_to_rename> – имя типа запроса, который будет переименован при импорте
  • “<script full path name>” – полный путь к файлу, в который будет экспортирована часть схемы
• importintegration – импорт (интеграция) изменений для схемы в базу данных CQ. Используется с параметрами:
  • -dbset <connection name> – наименование подключения CQ
  • <cq-login> – логин для подключения к базе данных CQ
  • <cq-password> – пароль
  • <schema name> – наименование схемы
  • <new_recor_type_name> – новое имя для типа запроса, если было указано <recor_type_to_rename> при экспорте
  • <integration_name> – наименование для интеграции
  • <integration_rev> – номер версии схемы, которая будет создана, на 1 больше текущей
  • “<script full path name>” – полный путь к файлу, или из которого будет выполнен импорт части схемы
  • <form_name> – имя формы, в которую будут добавлены новые закладки, сделанные в интеграции

Пример экспорта:

cqload exporintegration -dbset 7.0.0 admin “” TestStudio 8 8 “” “c:\temp\teststudioschema.txt”

Пример импорта:

cqload importintegration -dbset 7.1.0 admin “” TestStudio “” From_70_to_71 9 “c:\temp\teststudioschema.txt” “”

Дополнительно

Сценарий создания нового типа запроса с помощью cqload exportintegration и importintegration – http://www-01.ibm.com/support/docview.wss?uid=swg21130266

Как сделать пакет видимым из ClearQuest Designer

<< Перейти в раздел “ClearQuest FAQ”

Если пакет установлен как скрытый и  не виден в списке пакетов из ClearQuest Designer, то необходимо сделать следующее:

1. Запустить редактор реестра
2. Перейти в ветку «HKEY_LOCAL_MACHINE\Software\ Rational Software\ClearQuest Packages«
3. Найти необходимый пакет и перейти в подкаталог реестра этого пакета «Keywords«
4. Удалить параметр «Hide_me«

Как получить выбранный элемент в списке Reference List?

<< Перейти в раздел “ClearQuest FAQ”

Для того чтобы получить выбранный элемент из списка на форме запроса на изменение, нужно использовать функцию ListSelection, которая возвращает идентификатор выбранной записи. Эта функция доступна только при использовании Visual Basic, для Perl эта функция не реализована. Ниже показано использование этой функции для кнопки.

Пример:

Function SelectedRequest(param)

‘ param As Variant

Dim SelectedIds, SelectedId

SelectedId = param.ListSelection

SelectedId = SelectedIds(0)

msgbox «select id: «& SelectedId

End Function

Как вывести сообщение при выполнении хука?

<< Перейти в раздел “ClearQuest FAQ”

Для вывода диалогового окна с сообщением для Perl необходимо использовать функцию MsgBox, а для VB – msgbox. Однако необходимо осторожно использовать эти функции, если предполагается использование сервера ClearQuest Web, т.к. все сообщения будут появляться на стороне сервера и ожидать своего закрытия, что скажется на производительности сервера. Поэтому перед выводом сообщения необходимо проверять тип текущей сессии.

Пример Perl:

if ( !$session->HasValue ( «_CQ_WEB_SESSION» );
{
Win32::MsgBox( «Message» );
}

Пример VB:

Dim CurSession
Dim ISWeb

Set CurSession = GetSession
ISWeb = CurSession.NameValue(«_CQ_WEB_SESSION»)

if ISWeb = FALSE then
msgbox «Messge «
end if

Как ограничить доступ к закладке формы запроса на изменение?

<< Перейти в раздел “ClearQuest FAQ”

Для этого необходимо в ClearQuest Designer открыть форму, щелкнуть правой кнопкой мыши на необходимой закладке и выбрать «Tab Properties«. В появившемся окне можно установить список групп, которым будет доступна эта закладка.

Как создать запрос внутри хука?

<< Перейти в раздел “ClearQuest FAQ”

Ниже показан пример выбора всех запросов типа «Defect«, которые не находятся в состоянии «Closed«

sub GetListFromQuery
{
my $name_entity = «Defect»;
my $operator;

my $session = $entity->GetSession();
my $queryDef = $session->BuildQuery( $name_entity );

# выбираем поля
$queryDef->BuildField( $name_field );
# устанавливаем фильтр
$operator = $queryDef->BuildFilterOperator( $CQPerlExt::CQ_BOOL_OP_AND );
$operator->BuildFilter( «State», $CQPerlExt::CQ_COMP_OP_NOT_IN, [ "Closed" ] );

# выполняем
my $resultSet = $session->BuildResultSet( $queryDef );
$resultSet->Execute();

# Добавляем выбранные значения в список
while ( $resultSet->MoveNext() == $CQPerlExt::CQ_SUCCESS )
{
push( @$choices, $resultSet->GetColumnValue( 1 ) );
}

$choices = sort( @choices );
return $choices;
}

Как выполнить экспорт и импорт схемы?

<< Перейти в раздел “ClearQuest FAQ”

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

cqload имеет две подкоманды:

• exportschema – экспорт схемы на локальный диск.
• importschema – импорт схемы в базу данных CQ.

Исполняемая команда имеет следующий вид:

cqload exportschema -dbset <connection name> <cq-login> <cq-password> <schema name> «<script full path name>», где

• <connection name> – наименование подключения CQ.
• <cq-login> – логин для подключения к базе данных CQ.
• <cq-password> – пароль.
• <schema name> – наименование схемы, используется только для экспорта.
• <script full path name> – полный путь к файлу, в который будет экспортирована схема или из которого будет выполнен импорт схемы.

Пример экспорта:

cqload exportschema -dbset 7.0.0 admin «» TestStudio «c:\temp\teststudioschema.txt»

Пример импорта:

cqload importschema -dbset 7.0.0 admin «» «c:\temp\teststudioschema.txt»

Как разблокировать базу данных ClearQuest?

<< Перейти в раздел “ClearQuest FAQ”

Симптомы

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

Access to this database is currently denied. The database is locked while upgrading the application.

Причины

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

Решение

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

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

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

Для снятия блокировки используется команда командной строки ClearQuest installutil:

1. installutil unlockschemarepo используется для разблокирования схемы ClearQuest.
2. installutil unlockuserdb используются для разблокирования пользовательской базы данных ClearQuest.

Команды используют следующие параметры:

installutil unlockuserdb dbvendor server db dbologin dbopassword connectoptions

• dbvendor – наименование производителя базы данных: MS_ACCESS, SQL_ANYWHERE, SQL_SERVER, ORACLE, DB2.
• server – наименование сервера баз данных
• db – наименование базы данных
• dbologin – имя пользователя для подключения к базе данных
• dbopassword – пароль пользователя
• connect_options – опции подключения

Пример для ORACLE:

installutil unlockuserdb ORACLE oracle_server_name SID dbologin dbopassword «HOST=abc;SID=Oracle;SERVER_VER=8.1,CLIENT_VER=8.1;LOB_TYPE=long»

Пример для Microsoft SQL Server:

installutil unlockuserdb SQL_SERVER sql_server_name host_name dbologin dbopassword  «»

Пример для DB2:

installutil unlockuserdb DB2 db2_server_name alias dbologin dbopassword «»

Пример для Sybase SQL Anywhere:

installutil unlockuserdb SQL_ANYWHERE sybsqla C:\SybSQLA\sampl.db admin admin SERVER_VER=8.0

Пример для Microsoft Access:

installutil unlockuserdb MS_ACCESS «» c:\temp\sampl.mdb  «» «» «»