Vytvoření pravidel synchronizace

Musíte vytvořit pravidla synchronizace pro typy záznamů produktu ClearQuest, které plánujete mapovat na položky produktu Rational Team Concert.
Než začnete

Průvodce nastavením ClearQuest Connector můžete použít k vytvoření pravidel synchronizace nebo šablon pravidel synchronizace. Po použití průvodce k vygenerování pravidel synchronizace přesto budete muset pravidla přezkoumat a upravit, než budou připravena k použití. Toto téma popisuje, jak vytvořit a upravit pravidla pomocí editoru pravidel synchronizace v klientovi Eclipse Rational Team Concert.

Chcete-li vytvořit, upravit a odstranit pravidla synchronizace, musíte mít přidělenu licenci vývojáře nebo licenci pro přístup k produktu ClearQuest Connector Client. Kromě toho musí být oblast projektu nakonfigurována tak, aby udělovala oprávnění vaší uživatelské roli. Chcete-li nastavit oprávnění, otevřete oblast projektu, klepněte na kartu Konfigurace procesu, klepněte na volbu Konfigurace projektu > Oprávnění, vyberte roli a dále vyberte volbu Konektory položky na seznamu Povolené akce.

Nezapomeňte před vytvořením pravidla synchronizace spustit ClearQuest Gateway, jinak nebudou seznamy v editoru pravidel synchronizace naplněny pomocí polí z typů záznamů produktu ClearQuest.

Informace o této úloze
Podrobné informace o vytváření plánovacího pracovního listu před vytvořením pravidel synchronizace viz Plánování pravidel synchronizace. Kromě témat v tomto oddílu se podívejte na https://jazz.net/wiki/bin/view/Main/WritingSyncRules, kde najdete příklady mapování typů polí záznamů ClearQuest do vlastností položek platformy Rational Team Concert.

Chcete-li vytvořit pravidlo synchronizace:

  1. Přihlaste se ke klientovi produktu Rational Team Concert.
  2. V pohledu Artefakty týmu klepněte pravým tlačítkem myši na připojení úložiště a vyberte volbu Spravovat > Pravidla synchronizace. V pohledu Pravidla synchronizace klepněte pravým tlačítkem myši na oblast projektu a vyberte volbu Nové > Pravidlo synchronizace. Chcete-li upravit existující pravidlo synchronizace, rozbalte uzel oblasti projektu, abyste zobrazili pravidla synchronizace. Poklepejte na pravidlo, abyste je otevřeli v editoru pravidel synchronizace.
  3. V editoru synchronizačních pravidel zadejte jedinečný název pro pravidlo ve vlastnosti Název. Použití podobné konvence pojmenování, jako pro pojmenování balíků Java™ je jedním ze způsobů, které pomáhají zajistit jedinečné pojmenovávání. Například: com.sapphire.clearquest.NázevSchématu.TypZáznamu, kde NázevSchématu je název schématu produktu ClearQuest a TypZáznamu je název typu záznamu v tomto schématu, který chcete synchronizovat.
  4. V sekci Mapování typu vyberte typ položky, který chcete synchronizovat s typem záznamu produktu ClearQuest. Vlastnost Správce položky je nastavena na správce, který vytváří a synchronizuje typ položky, který jste vybrali. V poli Externí úložiště vyberte připojení externího úložiště, které se má použít při zpracování tohoto pravidla synchronizace. Vyberte položku Správce produktu ClearQuest (neuživatelské záznamy) jako Externího správce pro všechny typy záznamů kromě uživatelského. Pro typ uživatelského záznamu vyberte položku Správce produktu ClearQuest (uživatelské záznamy). Poznámka: protože uživatelské položky produktu Rational Team Concert nenáleží k jedné oblasti projektu, můžete mít pouze jedno pravidlo synchronizace pro typ uživatelského záznamu na jeden server Jazz Team Server. V poli Externí typ vyberte typ záznamu produktu ClearQuest, který chcete synchronizovat s položkou produktu Rational Team Concert.

    Při vytváření nové pracovní položky musí být použito pole Typ. Pravidla synchronizace, které vytváříte pro mapování typů záznamů na pracovní položky musejí označovat způsob nastavení hodnoty pole Typ pracovní položky. Podrobnosti viz Mapování typů záznamů na typy pracovních položek.

  5. V sekci Povolené oblasti týmu vyberte oblasti týmu, případně zrušte jejich výběr, a omezte tak rozsah pravidla synchronizace. Všechny položky produktu Rational Team Concert, jež jsou přidruženy k oblasti projektu s pravidly synchronizace, jsou standardně kandidáty pro odchozí synchronizaci. Možná budete chtít vytvořit záznamy produktu ClearQuest pouze pro položky přidružené k určitým oblastem týmu. Pokud je vybrána nadřízená oblast týmu, všechny její podřízené oblasti týmu jsou také vybrány. Můžete vybrat podřízenou oblast týmu, aniž byste vybrali její nadřízenou oblast.
  6. Pomocí pole Maximální počet cyklů určete počet cyklů synchronizace, které by ClearQuest Connector měl provést před selháním operace synchronizace. Při zápisu pravidla synchronizace pro stavový typ záznamu vyberte volbu Synchronizovat všechny stavy položek. U nestavových typů záznamů nevybírejte volbu Synchronizovat všechny stavy položek.
  7. V sekci Mapování vlastností určete, které vlastnosti pracovní položky se mapují na která pole typů záznamů produktu ClearQuest. Klepněte na tlačítko Přidat, chcete-li vytvořit mapování. Vyberte vlastnost položky a odpovídající externí vlastnost (pole typu záznamu produktu ClearQuest). Chcete-li mapovat vztah pracovní položky, vyberte jednu z následujících vlastností položky: Související, Blokuje, Závisí na, Nadřízené nebo Podřízené. Poté vyberte externí vlastnost, která odkazuje na související záznam produktu ClearQuest. Raději než přidávat mapování jedno po druhém můžete klepnout na volbu Inicializovat a vytvořit počáteční sadu mapování na základě shodných nebo částečně shodných názvů vlastností. Poté můžete projít uvedený seznam a odebrat nebo upravit mapování dle potřeby.

    Sekce Podrobnosti mapování zobrazuje podrobnosti pro mapování vybrané v tabulce Mapování vlastností. Chcete-li vymazat položku v poli Vlastnost položky nebo Externí vlastnost, vyberte volbu Není u položky Vlastnost položky nebo Externí vlastnost. V poli Synchronizace určete směr synchronizace. Vstup/výstup povoluje obousměrnou synchronizaci. Vstup povoluje synchronizaci pouze z databáze uživatelů produktu ClearQuest na položky produktu Rational Team Concert. Výstup povoluje synchronizaci pouze z položek produktu Rational Team Concert na databázi uživatelů produktu ClearQuest. Identifikátor položky se vybere, když je vlastnost použita jako vyhledávací klíč pro mapování položky na záznam produktu ClearQuest. Externí identifikátor se vybere, když je pole produktu ClearQuest použito jako vyhledávací klíč pro mapování záznamu produktu ClearQuest na položku produktu Rational Team Concert. Obvykle nebudete muset nastavovat pole Identifikátor položky nebo Externí identifikátor. Za předpokladu, že je spuštěn produkt ClearQuest Gateway, jsou tato dvě pole v případě potřeby nastavena editorem pravidel synchronizace.

    Standardně platí, že pokud jsou změny v záznamech produktu ClearQuest synchronizovány s položkami produktu Rational Team Concert, operace aktualizace je provedena s použitím uživatelského účtu platformy Jazz, který brána ClearQuest Gateway používá k přihlášení do úložiště Jazz. V poli Externí modifikátor můžete nakonfigurovat pravidlo synchronizace tak, aby se změny zaznamenávaly v kontextu uživatele, který je provede. Podrobnosti viz Konfigurace pravidel synchronizace pro externí uživatele.

    Pokud hodnota vlastnosti odkazuje na jiný objekt s definovaným pravidlem synchronizace, vyberte toto pravidlo synchronizace ze seznamu Pravidlo synchronizace odkazu. Například pokud typ záznamu závady produktu ClearQuest obsahuje pole s odkazem na typ uživatelského záznamu, vyberte pravidlo synchronizace pro typ uživatelského záznamu. V průběhu synchronizace je toto pravidlo synchronizace zpracováno a je vytvořen odkaz z položky produktu Rational Team Concert na uživatele platformy Jazz. Pokud vlastnost odkazuje na jinou pracovní položku, nezáleží na tom, které pravidlo synchronizace pracovní položky určíte jako referenční. Operace synchronizace použije při určení typu odkazovaného objektu správné pravidlo synchronizace. Předpokládejte například, že všechny typy pracovních položek Závada a Vylepšení obsahují vlastnost DuplicateOf, která odkazuje na jinou pracovní položku. Mapování vlastnosti DuplicateOf v pravidlu synchronizace Závada určuje pravidlo synchronizace Závada jako pravidlo synchronizace odkazu. A podobně mapování vlastnosti DuplicateOf v pravidle synchronizace Vylepšení určuje pravidlo synchronizace Vylepšení jako pravidlo synchronizace odkazu. Pokud operace synchronizace určí, že je pravidlo Závada označeno jako duplikát pravidla Vylepšení, použije se pravidlo synchronizace Vylepšení.

    Pomocí sekce Transformátor hodnoty určete jakoukoli speciální manipulaci, kterou je nutno provést při transformaci dat šířených mezi položkou produktu Rational Team Concert a polem záznamu produktu ClearQuest. Pokud nepotřebujete provádět transformaci dat, ponechejte volbu Bez transformace označenou, nebo výběr volby zrušte a dojde k aktivaci ostatních polí. Produkt ClearQuest Connector poskytuje tyto transformátory hodnot. Transformátory můžete přidávat vytvořením rozšíření modulů plug-in.

    Tabulka 1. Transformátory ClearQuest Connector
    Název transformátoru Popis
    Připojení pole k transformátoru vlastních atributů Mapuje hodnotu vlastního atributu pracovní položky na pole v záznamu produktu ClearQuest, na které odkazuje pole v jiném záznamu.
    Transformátor podrobností přispěvatele Momentálně se u produktu ClearQuest Connector nepoužívá.
    Zobrazení odkazovaných polí záznamů v transformátoru vlastních atributů Mapuje obsah odkazovaného záznamu produktu ClearQuest na vlastní atribut pracovní položky, aby obsah mohl být zobrazen v editoru pracovních položek.
    Transformátor oblasti projektu Momentálně se u produktu ClearQuest Connector nepoužívá.
    Transformátor časového razítka/dní Převádí řetězec označující počet dnů v záznamu produktu ClearQuest na počet milisekund, který je použit v časovém razítku k určení času.
    Transformátor operace pracovní položky Vypočítává akci, která se má provést při přechodu z jednoho stavu na jiný během příchozí synchronizace. Toto je nezbytné, pokud definice toku pracovní položky produktu Rational Team Concert obsahuje nejednoznačné přechody stavu, kdy je možný přechod více než jedné akce mezi dvěma stavy.

    Na rozdíl od typů záznamů produktu Rational ClearQuest typy pracovních položek produktu Rational Team Concert umožňují přechod více než jedné akce z jednoho stavu na jiný. Pokud nepoužijete transformátor akce pracovní položky k synchronizaci položek obsahujících více akcí pro přechody stavu, operace synchronizace následující po přechodu stavu vygeneruje chybu, která oznamuje, že nelze provést přechod záznamu produktu ClearQuest do jiného stavu.

    Transformátor příloh pracovní položky Převádí přílohu produktu Rational Team Concert na přílohu záznamu produktu ClearQuest.
    Transformátor kategorie pracovní položky Udržuje hierarchickou strukturu kategorií produktu Rational Team Concert mapovaných na záznamy produktu ClearQuest, když hodnotou je cesta.
    Transformátor komentářů pracovní položky Převádí komentář produktu Rational Team Concert na poznámku záznamu produktu ClearQuest.
    Transformátor značek pracovní položky Převádí značky v pracovní položce na klíčová slova v záznamu produktu ClearQuest.

    Některé transformátory hodnot mohou vyžadovat dodatečné vlastnosti, aby mohly provést transformaci dat. V případě potřeby klepněte na volbu Nastavit další vlastnosti vstupu vyžadované transformátorem a vyberte vlastnosti v dialogovém okně Požadované vlastnosti.

    Pomocí sekce Mapování hodnoty určete hodnoty, které se mají mapovat z položek na záznamy. Klepněte na tlačítko Přidat. Zadejte hodnotu položky a odpovídající hodnotu pole záznamu produktu ClearQuest. Pokud neexistuje mapování všech hodnot jedna ku jedné, označte jednu jako výchozí hodnotu. Například pole Priorita produktu ClearQuest může mít čtyři hodnoty (1, 2, 3 a 4) a vlastnost Priorita Team Concert může mít tři hodnoty (vysoká, střední a nízká). Pokud mapujete hodnotu Vysoká na hodnotu 1 a 2, vyberte hodnotu 1 nebo 2 jako externí hodnotu Výchozí. Chcete-li určit prázdnou hodnotu pro pole záznamu produktu ClearQuest, nechte hodnotu prázdnou. Raději než přidávat mapování hodnot jedno po druhém, můžete klepnout na volbu Inicializovat a vytvořit počáteční sadu mapování na základě shodných nebo částečně shodných názvů hodnot. Poté můžete projít uvedený seznam a odebrat nebo upravit mapování hodnot dle potřeby.

    Produkty Rational ClearQuest a Rational Team Concert umožňuje identifikaci duplicitních záznamů, respektive položek. Chcete-li synchronizovat duplicity, mapujte vlastnost položky DuplicateOf na externí vlastnost original. V poli Pravidlo synchronizace odkazu vyberte pravidlo synchronizace, které se má použít pro pracovní položky.

  8. Klepnutím na volbu Uložit uložíte svoji práci.
Jak pokračovat dále

Kdykoli přidáte pravidlo synchronizace nebo přidáte či odeberete dotaz, musíte zastavit a znovu spustitClearQuest Gateway, aby produkt ClearQuest Connector použil nová kritéria synchronizace.


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