Produkt IBM® Rational ClearQuest můžete definovat jako zdroj dat v produktu IBM Rational Publishing Engine.
Než začnete
- Obeznamte se se službou REST Rational ClearQuest a s různými adresami URL, jež jsou zapotřebí pro extrahování dat z produktu Rational ClearQuest při použití produktu Rational Publishing Engine.
Viz text Informačního centra O produktu Rational ClearQuest.
- Připojte se ke schématu zdroje dat. Viz téma Přidání schématu zdroje dat.
- Schéma může být v lokálním systému souborů. Produkt Rational Publishing Engine používá datové služby
Rational ke zjištění schématu a k dotazování dat. Adresa URL, kterou lze použít ke zjištění schématu: https://server:port/DataServices/ClearQuest.
Viz téma Přidání schématu zdroje dat REST průvodcem zjišťování schématu.
- Schéma může představovat libovolný identifikátor URI, který je přístupný z počítače. Můžete sestavit adresu URL, jež ukazuje na schéma zdroje dat. Otevřete své schéma zdroje dat a ze souboru XML získejte identifikátor URI pro daný prostředek. Přidejte text ?metadata=schema na konec identifikátoru URI. Například: https://server:port/service/cq/records/defects?metadata=schema.
- Pro nejnovější verze produktu Rational ClearQuest můžete k vytvoření schématu zdroje dat použít rovněž nástroj REST v2 Schema Discovery. Viz téma Přidání schématu zdroje dat REST průvodcem zjišťování schématu.
Poznámka: Při použití nástroje REST v2 Schema Discovery produkt Rational Publishing Engine nepotřebuje datové služby Rational. Produkt Rational Publishing Engine může provést zjištění schématu z produktu Rational ClearQuest nástrojem REST v2 Resource Discovery spuštěným z adresy URL ServiceProvider.
Uživatelé mohou získat adresu URL ServiceProvider na adrese URL komponenty ServiceCatalog nástroje Rational ClearQuest REST v2, např. https://server:port/context/oslc.
Nastavte záhlaví HTTP OSLC-Core-Version na hodnotu 2.0 a přijměte hodnotu application/rdf+xml. Ve vráceném výsledku naleznete adresu URL ServiceProvider rdf:about.
- Pokud používáte rozhraní API REST v2 ke generování
dokumentu, musíte poskytnout adresu URL schématu zdroje dat poskytovateli
služeb, spíše než kořenovému záznamu. Příklad:
- Nesprávně: https://server:port/cqweb/oslc
- Správně: https://server:port/cqweb/oslc/repo/úložiště/db/úložiště_schématu/
- Po připojení ke schématu zdroje dat můžete vytvořit nebo importovat návrh šablony. Pomocí produktu Rational Publishing Engine Document
Studio můžete vytvořit návrh šablony sestavy. Tento návrh určuje rozvržení sestavy. Vytváření šablon aplikací Document Studio.
- Naplánujte si strukturu svého dokumentu a definujte obsah k extrahování dat. V tématu Návrh šablon dokumentu naleznete přehled procesu vývoje šablony. Pro velké dokumenty můžete vytvořit samostatné šablony pro jednotlivé bloky dokumentu.
- Produkt Rational Publishing Engine je vybaven rozsáhlou sadou prvků šablon, jež můžete použít k vytvoření struktury svého dokumentu. Prvky můžete přetahovat myší do editoru obsahu šablony.
Další podrobnosti viz téma Prvky šablony v pohledu Paleta.
- K přidávání dat do šablony používejte dotazy, atributy a proměnné.
- Prvek Konfigurace zdroje dat můžete používat k definování určitých vlastností, jež nejsou známy v době běhu programu. Viz téma Přidání prvku konfigurace zdroje dat.
- Můžete používat filtry, což jsou specifičtější verze obecného identifikátoru URI zdroje dat, k odkazování na specifické podmnožiny dat tak, aby se produkt Rational Publishing Engine při generování sestav nepokoušel o načítání více informací, než je nezbytné z úložiště Rational ClearQuest. Tyto filtry musejí být dostatečně široké, aby došlo k načtení všech nezbytných dat, na něž odkazuje šablona, resp. aby vygenerovaná šablona obsahovala kompletní sadu dat. Viz téma Extrahování dat pomocí nativních filtrů.
- Poté co vytvoříte šablonu sestavy a vyplníte ji datovými body produktu Rational ClearQuest, můžete provést vygenerování sestavy v různých formátech. Při generování sestavy musíte být připojeni ke zdroji dat. Pokyny k odkazování na relevantní data viz Připojení ke zdroji dat.
- Dojde-li k přidání schémat zdroje dat do šablony až po přidružení této šablony k určité specifikaci dokumentu, nebude specifikace dokumentu synchronizována. Můžete provést ruční synchronizaci specifikace dokumentu, nebo můžete vybrat předvolbu automatické synchronizace specifikace dokumentu s aktuální šablonou. V tématu Nastavení předvoleb návrhu dokumentu naleznete informace o nastavení předvolby Udržovat specifikaci dokumentu synchronizovanou s aktuální šablonou?
- Před publikováním dokumentu věnujte pozornost tématu Určení vlastností výstupu, jež uvádí další informace o dostupných volbách výstupu, z nichž můžete vybírat, a o jejich vhodnosti pro prvky, jež používáte ve své šabloně.
- Nyní jste připraveni k publikování svého dokumentu. Viz téma Generování dokumentu.