Úprava parametrů služby konektoru

Soubor cqconnector.properties obsahuje nastavení parametrů, při kterém se spouští brána ClearQuest Gateway a obslužný program příkazového řádku synctool.
Informace o této úloze

Průvodce nastavením ClearQuest Connector aktualizuje soubor cqconnector.properties na základě voleb, které v průvodci provedete. Pokud máte v úmyslu implementovat produkt ClearQuest Connector na stejném počítači, kde jste spustili průvodce, nemusíte soubor cqconnector.properties upravovat. Pokud máte v úmyslu implementovat produkt ClearQuest Connector na jiném počítači, např. na takovém, kde běží Linux®, zkopírujte soubor cqconnector.properties na tento počítač a potom upravte soubor tak, aby byly všechny cesty počítače v parametrech správné.

Následující tabulka popisuje parametry produktu ClearQuest Connector.
Tabulka 1. Parametry produktu ClearQuest Connector
Parametr Popis
com.ibm.rational.interop.pollingPeriod Období výzev, které určuje četnost, se kterou brána ClearQuest Gateway zjišťuje změny v databázi uživatelů produktu ClearQuest. Výchozí období výzev je 60 sekund.
com.ibm.team.uris Jednotný identifikátor prostředku (URI) serveru Jazz. Výchozí identifikátor URI je https://cqconnector:cqconnector@localhost:9443/jazz. K oddělení položek pro více serverů Jazz použijte středník (;). Musíte vytvořit uživatele Jazz s názvem cqconnector nebo nahradit jméno jiným uživatelem Jazz. Uživatel Jazz (cqconnector nebo jiný) musí mít licenci Jazz ClearQuest Connector nebo Developer. Použijete-li jako ID uživatele cqconnector, zajistěte změnu hesla z výchozího cqconnector.
cq.dbSetDbName Úložiště schémat a databáze uživatelů produktu ClearQuest. Výchozí úložiště schémat je sample_schema_repo. Výchozí databáze uživatelů je SAMPL. Formát je název_připojení_úložiště_schémat/název_databáze_uživatelů.
cq.orderedProperties.record-type Seznam polí oddělených čárkami, který označuje pořadí, ve kterém má produkt ClearQuest Connector nastavovat hodnoty těchto polí při operacích odchozí synchronizace. Můžete nastavit parametr pro jednotlivé typy záznamů, které mají pravidlo synchronizace. Pole, které do seznamu nezadáte, budou zpracována po polích v seznamu. Zadání pořadí může být zapotřebí v případě, že vaše typy záznamů produktu ClearQuest obsahují zapojení, jež ustavují závislosti mezi poli.

Dalším způsobem, jak určit pořadí, je použít vlastnost Pole závislá na webu u polí v definici formuláře produktu ClearQuest Designer. Pokud určíte vlastnost Pole závislá na webu i parametr cq.orderedProperties, produkt ClearQuest Connector použije pořadí určené pomocí parametru cq.orderedProperties.

cq.password Heslo pro přihlášení do databáze uživatelů produktu ClearQuest. Brána ClearQuest Gateway a nástroj pro import používají toto heslo a jméno uživatele zadané prostřednictvím parametru cq.userId k přihlášení do databáze uživatelů produktu ClearQuest a k načtení záznamů, které chcete importovat do úložiště Jazz. Výchozí hodnota je cqconnector. Zajistěte změnu hesla z výchozí hodnoty.
cq.userId Jméno uživatele pro přihlášení do databáze uživatelů ClearQuest. Brána ClearQuest Gateway a nástroj pro import používají toto jméno uživatele a heslo zadané prostřednictvím parametru cq.password k přihlášení do databáze uživatelů produktu ClearQuest a k načtení záznamů, které chcete importovat do úložiště Jazz. Výchozí hodnota je cqconnector. Tento uživatel musí mít oprávnění editora SQL.
cq.queryTreeRoot Název s úplnou cestou pro kořenovou složku, která obsahuje složku nebo složky specifické pro oblasti projektu nebo složky dotazů, které používáte k filtrování záznamů, které mají být synchronizovány s položkami produktu Rational Team Concert. Můžete zadat dotaz pro jednotlivé synchronizované typy záznamů pro jednotlivé oblasti projektu. Dotazy musíte zapsat takovým způsobem, aby nevybíraly žádný záznam produktu ClearQuest k synchronizaci s více než jednou oblastí projektu na stejném serveru Jazz Team Server.

Kořenová složka může být v libovolné úrovni hierarchie složek pod složkami Veřejné dotazy nebo Osobní dotazy, hierarchie však musí vypadat tímto způsobem: kořenová_složka/složka_s_názvem_oblasti_projektu. Dotazy musejí být uloženy přímo ve složkách oblasti projektu. Můžete mít více složek oblasti projektu. Názvy jednotlivých složek oblasti projektu musejí odpovídat názvům příslušných oblastí projektu uvnitř úložiště Jazz.

Musíte zadat hodnotu tohoto parametru. Kořenová složka dotazu, kterou zadáte, musí existovat a musí obsahovat složky pro jednotlivé oblasti projektu, se kterými chcete synchronizovat záznamy a pracovní položky. Pokud určitá složka oblasti projektu neobsahuje dotaz pro určitý typ záznamu, který má pravidlo synchronizace pokusí se produkt ClearQuest Connector o synchronizaci všech záznamů tohoto typu.

   

Úprava parametrů:

  1. Přejděte do složky instalační-adresář\gateway. Otevřete soubor cqconnector.properties.
  2. Upravte hodnoty parametrů podle potřeb svého prostředí.
    1. Upravte hodnotu parametru com.ibm.team.uris tak, aby ukazovala na umístění serveru nebo serverů Jazz. Standardně se brána ClearQuest Gateway pokouší přihlásit na server Jazz jako uživatel cqconnector. Musíte vytvořit uživatele Jazz s názvem cqconnector nebo nahradit jméno jiným uživatelem Jazz. Uživatel Jazz (cqconnector nebo jiný) musí mít licenci Rational Team Concert ClearQuest Connector nebo Developer license. Chcete-li zadat jiného uživatele, vložte před název hostitele jméno_uživatele[:heslo]@. Například: https://chris:chris_pw@localhost:9443/jazz. K oddělení položek pro více serverů Jazz použijte středník (;).
    2. Upravte hodnotu parametru cq.dbSetDbName tak, aby identifikovala vaše úložiště schémat a databázi uživatelů.
    3. Upravte hodnotu parametru com.ibm.rational.interop.pollingPeriod, chcete-li změnit výchozí období zjišťování změn o délce 60 sekund.
    4. Chcete-li filtrovat záznamy produktu ClearQuest k synchronizaci, vytvořte dotazy pro jednotlivé typy záznamů, které mají pravidlo synchronizace. Uložte dotazy do složek specifických pro oblast projektu v kořenové složce. Upravte parametr cq.queryTreeRoot tak, aby identifikoval název s úplnou cestou ke kořenové složce. Například: Public Queries/Jazz CQ Connector. Dokonce i v případě, že nechcete záznamy filtrovat, musíte vytvořit kořenovou složku a dále složky oblasti projektu pro jednotlivé oblasti projektů, pro které plánujete synchronizaci záznamů a pracovních položek.
    5. Zadejte jména uživatelů a hesla pro přihlašování do produktu ClearQuest prostřednictvím parametrů cq.userId a cq.password. Uživatel, kterého zadáte prostřednictvím parametru cq.userId, musí mít oprávnění editora SQL.
    6. Pokud libovolné z polí v typech záznamů produktu ClearQuest, které plánujete synchronizovat, obsahuje zapojení vytvářející závislosti s ostatními poli, a pokud nechcete použít vlastnost Pole závislá na webu v definici formuláře produktu ClearQuest k určení požadovaného pořadí nastavování hodnot v polích, nastavte parametr cq.orderedProperties.record-type. Zapojení přidružené k jednomu poli může použít hodnotu, kterou uživatel zadá do tohoto pole, k určení způsobu nastavení hodnoty v jiném poli. V této situaci musíte identifikovat pořadí, ve kterém mají být zapojení prováděna během operací odchozí synchronizace, aby bylo zajištěno nastavení polí záznamu produktu ClearQuest s použitím správných hodnot. Například: cq.orderedProperties.Defect=Nadpis, Typ, Produkt, Komponenta. Tento příklad určuje, že pole Nadpis v typu záznamu Závada má být nastaveno jako první a poté má následovat nastavení polí Typ, Produkt a Komponenta.

      Pokud určíte vlastnost Pole závislá na webu i parametr cq.orderedProperties, produkt ClearQuest Connector použije pořadí určené pomocí parametru cq.orderedProperties.

    7. Uzavřete a uložte soubor cqconnector.properties.
Jak pokračovat dále
Poznámka: Protože soubor cqconnector.properties obsahuje přihlašovací jména a hesla pro uživatelské účty produktu ClearQuest a Jazz, zajistěte nastavení oprávnění pro tento soubor takovým způsobem, aby jej mohli číst pouze autorizovaní uživatelé.

Váš názor

Byla tato pomoc užitečná? Zpětnou vazbu můžete poskytnout na stránkách Jazz.net (registrace je požadována): Komentář na fóru nebo odeslat chybu