Import dávky záznamů produktu ClearQuest

Produkt ClearQuest Connector obsahuje nástroj pro import, který umožňuje vytváření příslušných položek uvnitř úložiště Jazz pro dávku záznamů produktu ClearQuest.
Informace o této úloze
Nástroj Import můžete použít například k vytváření pracovních položek Rational Team Concert, které odpovídají dávce závad v databázi uživatelů ClearQuest. Nové pracovní položky jsou synchronizovány se závadami. Změny, které provedete v určité pracovní položce, se budou šířit do příslušné závady, a změny, které provedete v určité závadě, se budou šířit do příslušné pracovní položky.

Nástroj Import používá parametry nastavené v souboru cqconnector.properties. Průvodce nastavením ClearQuest Connector aktualizuje soubor cqconnector.properties na základě vámi provedených voleb. Parametry můžete rovněž nastavit přímou úpravou souboru cqconnector.properties. Popisy parametrů viz Úprava parametrů služby konektoru. Spusťte nástroj pro import vícekrát, jednou pro každý typ záznamu. Tento postup vám umožní ověřit úspěšnost synchronizace jednoho typu záznamu dříve, než budete pokračovat následujícím typem záznamu.

Některý typy záznamů mohou vykazovat závislosti na jiné typy záznamů. Nástroj pro import byste měli spustit nejprve pro ty typy záznamů, na kterých závisejí jiné typy záznamů. Například v ukázkovém schématu DefectTrackingInterop synchronizace typu záznamu Závada závisí na úspěšné synchronizaci typů záznamu Projekt a uživatelé. Proto použijte nástroj pro import nejprve pro typy záznamu Projekt a uživatelé. Po ověření úspěchu synchronizace těchto typů záznamů spusťte nástroj pro import pro typ záznamu Závada.

Syntaxe nástroje pro import:

synctool recordType=record-type-name jazzServer=url projectArea=project-area-name 

Import záznamů:

  1. Přejděte do adresáře instalační-adresář\gateway.
  2. Spusťte příkaz synctool. Nástroj pro import vyhledá složku dotazu, kterou uvádí parametr cq.queryTreeRoot v souboru cqconnector.properties. Pokud nalezne dotaz ve složce oblasti projektu pro zadaný typ záznamu, použije tento dotaz k výběru záznamů k importu. Pokud žádný takový dotaz neexistuje, zvolí nástroj pro import všechny záznamy tohoto typu. Máte-li velmi vysoký počet záznamů dotyčného typu pro import, zvažte vícenásobné spuštění nástroje pro import s rozdílnými časy dotazu tak, aby jednotlivá vyvolání zvolila podmnožinu celkového počtu záznamů. Například můžete dotaz upravit tak, aby vybíral záznamy na základě data vytvoření. Rovněž zajistěte definování dotazů takovým způsobem, aby se vybíraly pouze záznamy, se kterými chcete pracovat v produktu Rational Team Concert. Obvykle nebudete zahrnovat záznamy ve stavu zavřeno.

    Vždy když přidáte nebo odeberete dotaz nebo přidáte pravidlo synchronizace, musíte zastavit a restartovat bránu ClearQuest Gateway, aby ClearQuest Connector použil nová kritéria synchronizace.

    Například v systému Windows®:

    synctool recordType="users" jazzServer="https://cqconnector:cqconnector@localhost:9443/jazz" projectArea="Reporting"

    V systému Linux®, použijte příkaz ./synctool ke spuštění příkazového řádku.

  3. Otevřete klienta Rational Team Concert a ověřte, že nástroj pro import vytvořil záznamy uživatelů pro záznamy produktu ClearQuest vybrané dotazem. V pohledu Artefakty týmu rozbalte složku Mé oblasti týmu. Poklepáním na určitou oblast týmu tuto oblast otevřete. V oblasti Členové klepněte na tlačítko Přidat a přidejte nové uživatele do oblasti týmu. Chcete-li uživatelům přiřadit role, vyberte jednotlivé uživatele v tabulce Členové a klepněte na volbu Role procesu.
  4. Spouštějte příkaz synctool se zadáním různých typů záznamu. Například typ záznamu Projekt.
  5. V klientu produktu Rational Team Concert ověřte, že nástroj pro import vytvořil příslušné položky kategorie pro záznamy projektu produktu ClearQuest vybrané dotazem. V pohledu Artefakty týmu klepněte pravým tlačítkem myši na volbu Otevřít. V editoru Oblasti projektu klepněte na kartu Kategorie pracovních položek. Vyberte kategorii, která odpovídá záznamu projektu produktu ClearQuest. Vyberte oblast týmu, kterou chcete přidružit k dané kategorii. Klepněte na volbu Přidružit. Zopakujte tento krok pro jednotlivé kategorie, které nástroj pro import vytvořil v souznačnosti se záznamy projektu produktu ClearQuest. Klepnutím na tlačítko Uložit uložte změny do oblasti projektu. Po přidružení kategorie oblasti týmu jsou pracovní položky v této kategorii přidruženy k příslušnému týmu.
  6. Spouštějte příkaz synctool se zadáním různých typů záznamu. Například typ záznamu Závada.
  7. V klientu produktu Rational Team Concert ověřte, že nástroj pro import vytvořil příslušné pracovní položky pro závady produktu ClearQuest vybrané dotazem.
Výsledky
Pokud nástroj pro import vybere záznam, který je aktuálně synchronizován s jinou oblastí projektu na stejném serveru Jazz Team Server, odpojí tento záznam z dané oblasti projektu, aby jej mohl synchronizovat s oblastí projektu zadanou v příkazovém řádku.

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