Produkt IBM® Rational Change můžete v produktu IBM Rational Publishing Engine definovat jako zdroj dat.
Tip: Instalace produktu
Rational Publishing Engine zahrnuje sadu ukázkových sestav. Než začnete s publikováním dokumentů, můžete prozkoumat tento ukázkový scénář generování dokumentů. Viz téma
Vytvoření ukázkové šablony REST.
Než začnete
- Obeznamte se se službou REST Rational Change a s různými adresami URL, jež jsou zapotřebí k extrahování dat z produktu Rational Change pomocí produktu Rational Publishing Engine.
K vyhledání vaší verze produktu Rational Change v Informačním centru viz O produktu Rational Change.
- 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ů. Například https://server:port/ibm/report/com.ibm.change.project.artifacts.xsd je soubor schématu, který používá argument artifacts. Toto schéma můžete použít k přidání specifických částí dat ze svého projektu Rational Change.
- 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/ibm/report/com.ibm.change.project.artifacts.xsd
- Prvky ve schématu zdroje dat můžete použít k přidání dotazů do své šablony. Tyto dotazy specifikují, které části informací se nakonec vygenerují
v sestavě.
- 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. Viz téma 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 vytvořte 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 Change. 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 Rational Change, můžete provést vygenerování sestavy v různých formátech. Při generování sestavy se musíte připojit ke zdroji dat zadáním identifikátoru URI, který ukazuje na úložiště Rational Change obsahující relevantní data. Viz téma 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.