Návrh šablon za použití aplikace Requirements Management jako zdroje dat

Návrháři sestav mohou používat produkt Document Studio k importování schémat zdrojů dat a k vytváření šablon sestav. Funkce poskytované aplikací Requirements Management (RM) jsou licencovány jako produkt IBM® Rational DOORS Next Generation. Informace o integraci aplikace RM platí pro produkty Rational DOORS Next Generation a pro specifické verze produktu IBM Rational Requirements Composer.

Než začnete

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 Vytváření ukázkové šablony REST.
Seznamte se se službou REST aplikace RM a s různými adresami URL potřebnými k extrakci dat z aplikace RM s použitím produktu Rational Publishing Engine. Chcete-li vyhledat Informační centrum pro verzi aplikace RM, projděte si téma O Informačním centru produktu Rational Requirements Composer.

Informace o této úloze

Data jsou extrahována pomocí rozhraní REST API. Toto rozhraní je instalováno a implementováno pomocí aplikace zdroje dat a pracuje nezávisle na produktu Rational Publishing Engine. Chcete-li získat další informace o rozhraní REST API zdroje dat, viz dokumentace tohoto zdroje dat.

Postup

  1. V tématu Návrh šablon dokumentu vyhledáte přehled procesu vývoje šablon. Spusťte plánování struktury vašeho dokumentu a dat, která mohou být zahrnuta. Rozhodněte se například, zda bude konečný dokument generován z jedné šablony nebo z více souborů šablon obsahujících znovu použitelné části obsahu.
  2. V aplikaci Document Studio vytvořte šablonu dokumentu.
  3. Identifikujte schéma zdroje dat ze zdroje dat. Chcete-li přidat specifické části dat z projektu aplikace RM, zadejte adresu URL v tomto formátu:
    • https://server:port/rm/publish/artifact
    Příklad:
    • https://server:port/rm/publish/resources
  4. Přidejte schéma zdroje dat do šablony dokumentu. Pro aplikaci RM můžete postupovat takto:
    1. V aplikaci Document Studio klepněte na volbu Data > Přidat schéma zdroje dat.
    2. V poli Typ vyberte typ schématu ze seznamu. Pro aplikaci RM vyberte Generické XML.
    3. Do pole Soubor schématu vložte adresu URL, kterou jste identifikovali jako schéma zdroje dat.
    4. Připojte text ?metadata=schema na konec adresy URL.
      • Příklad: https://server:port/rm/publish/artifact?metadata=schema
    5. Pokud je prostředek na zabezpečeném serveru, zadejte Jméno uživatele.
    6. Pokud je prostředek na zabezpečeném serveru, zadejte Heslo.
    7. Ze seznamu vyberte Typ ověřování. Pro aplikaci RM je typ ověřování OAuth. Pokud nevyberete OAuth, je testován každý typ ověřování, dokud není nalezen správný typ, což může prodloužit dobu generování dokumentů.
  5. Přidejte prvky do šablony. 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. Například, můžete přidat prvek Kontejner, abyste uchovali některé odstavce. Každý odstavec může být řízen testovací podmínkou, která mu přidružuje pouze specifická data. Další informace viz Prvky šablony v pohledu Paleta a Přidání prvků do šablony.
    Prvky tabulky
    Když jsou data tabulky vstupem z aplikace RM, šířka musí být uvedena na úrovni sloupce, a to pro každou buňku, a ne na úrovni tabulky, aby je bylo možné zpracovat produktem Rational Publishing Engine.
  6. Použijte dotazy, atributy a proměnné, abyste přidali data do šablony. Tyto položky určují, které části informací budou generovány v sestavě.
  7. Přidejte formátování a stylizaci do prvků pro kontrolu zobrazení ve výstupu.
  8. Vytvořte filtry, abyste zúžili data stažená do sestavy. Můžete používat filtry, které jsou podrobné verze obecného identifikátoru URI zdroje dat, k odkazování na specifické podmnožiny dat tak, aby se při generování sestavy produkt Rational Publishing Engine nepokoušel o načítání více informací ze zdroje dat, než je nezbytné. 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á sestava nebude obsahovat kompletní data. Další informace viz Rational Requirements Composer: Zdroje dat.
  9. Vytvořte řazení, abyste organizovali data v sestavě.

Zpětná vazba