Navrhování šablon s produktem Rational RequisitePro jako zdrojem dat

Návrháři sestav mohou používat produkt Document Studio k importování schémat zdrojů dat a k vytváření šablon sestav.

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.
Obeznamte se s požadavky produktu Rational RequisitePro na extrahování dat pomocí produktu Rational Publishing Engine. Pro vyhledání vaší verze produktu Rational RequisitePro v Informačním centru viz O produktu Rational RequisitePro.

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. Přidejte schéma zdroje dat do šablony dokumentu. Pro produkt Rational RequisitePro můžete zjistit schéma zdroje dat zadáním základní adresy URL do aplikace.
    1. V aplikaci Document Studio klepněte na volbu Data > Zjišťování schématu > Zjišťování schématu REST.
    2. Zadejte Název zdroje dat.
    3. Zadejte Popis zdroje dat.
    4. Zadejte Základní adresu URL prostředku.
    5. Ze seznamu vyberte Typ ověřování. Pro adaptér produktu Rational RequisitePro poskytovaný datovými službami musíte zadat základní ověřování. Pokud nevyberete typ, je testován každý typ, dokud není nalezen správný typ, což může prodloužit dobu generování dokumentu.
    6. Pokud je prostředek na zabezpečeném serveru, zadejte Jméno uživatele.
    7. Pokud je prostředek na zabezpečeném serveru, zadejte Heslo.
    8. Klepněte na tlačítko Další. K vámi zadané základní adrese URL je automaticky připojen text ?metadata=schema.
    9. Klepněte na tlačítko Dokončit. Vámi vybrané schéma zdroje dat se zobrazí v pohledu Schéma zdroje dat.
  4. 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.
  5. 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ě.
  6. Přidejte formátování a stylizaci do prvků pro kontrolu zobrazení ve výstupu.
  7. 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. V nativních filtrech typu Reportable REST v1 je třeba pouze zadat text do hranatých závorek []. Zbytek filtru vygeneruje produkt Rational Publishing Engine. Následující příklad nativního filtru typu Reportable REST v1 extrahuje schéma produktu Rational RequisitePro PRRequirements pomocí výrazu Stability='High'.
    Výraz filtru přidejte do uzlu pod Appliances, aby se vybrala pouze zařízení vyrobená specifickým výrobcem.
    fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
  8. Vytvořte řazení, abyste organizovali data v sestavě. Produkt Rational RequisitePro nepodporuje použití nativních řazení. Místo toho můžete vytvořit řazení v produktu Rational RequisitePro:
    1. Vytvořte tabulku a zadejte data.
    2. Seřaďte data.
    3. Vytvořte pohled a uložte do něj data.
    4. Vyexportujte pohled tak, aby se v produktu Rational Publishing Engine používal jako schéma zdroje dat. Aplikace Reporting Data Services automaticky zjišťuje pohled.
    5. Přidejte schéma zdroje dat do své šablony Rational Publishing Engine.
    Data produktu Rational RequisitePro vygenerovaná do výstupu produktu Rational Publishing Engine mají i nadále řazení z pohledu, avšak některá vnořená data by se nemusela zobrazovat jako vnořená.

Zpětná vazba