Produkt Rational Quality Manager můžete definovat jako zdroj dat v produktu Rational Publishing Engine.
Data se extrahují pomocí rozhraní API REST Rational Quality Manager. Toto rozhraní instaluje a implementuje aplikace a pracuje nezávisle na produktu Rational Publishing Engine.
Tip: Produkt
Rational Publishing Engine se dodává se sadou 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 produktu Rational Quality Manager a s různými adresami URL, jež jsou zapotřebí pro extrahování dat z produktu Rational Quality Manager při použití produktu Rational Publishing Engine.
Viz dokumentaci rozhraní API REST Rational Quality Manager.
- 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/jazz/service/com.ibm.rqm.integration.service.IntegrationService/schema/feed.xsd je soubor schématu, který používá argument feed. Toto schéma můžete použit k přidání specifických částí dat, tj. například podrobností testovacího případu nebo testovacích skriptů, ze svého projektu Rational Quality Manager nebo pro přístup k určitému prostředku prostřednictvím známé adresy URL.
- 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/qm/oslc_qm/catalog
- Správně: https://server:port/qm/oslc_qm/catalog/úložiště/db/úložiště_schématu/
Prvky ve schématu zdroje dat můžete použít k přidání dotazů do své šablony. Tyto dotazy určují, které části informací budou generovány v sestavě.Chcete-li se ujistit, že přijímáte úplný seznam vratek ze zdroje dat kanálu
Rational Quality Manager, musíte nastavit typ schématu jako Generické XML a přidat
řetězec ?abbreviate=false na konec identifikátoru URI. Příklad: https://rqmserver:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/JKE
Banking (Quality Management)/testcase?abbreviate=false.
- 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 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. Například datové schéma qm se nastavuje dynamicky na základě datového schématu feed. Vždy použijete toto schéma a dynamicky je nakonfigurujete pro specifické části dat ve své šabloně z projektu Rational Quality Manager.
- 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 Quality Manager. Tyto filtry musejí být dostatečně široké, aby došlo k načtení všech nezbytných dat, na něž odkazuje šablona, jinak vygenerovaná šablona nebude obsahovat kompletní data. Viz téma Extrakce dat pomocí filtru produktu Rational Publishing Engine.
- Poté co vytvoříte šablonu sestavy a vyplníte ji datovými body produktu Rational Quality Manager, můžete provést vygenerování sestavy v různých formátech. Při vygenerování sestavy musíte připojit zdroj dat obsahující informace, nad nimiž chcete vytvořit sestavu. Zadejte identifikátor URI ukazující na úložiště produktu Rational Quality Manager, jež obsahuje relevantní data. Pokyny k odkazování na relevantní data viz Připojení ke zdroji dat.
Poznámka: Pokud v případě rozhraní API OSLC produktu
IBM Rational Quality Manager není ve specifikaci dokumentu určeno záhlaví pro příjem,
produkt Rational Quality Manager standardně vrací reprezentaci prostředků v HTML. Pro získání dat ve formátu XML musíte nastavit záhlaví pro příjem na application/xml.
- 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.