Navrhování šablon s produktem Rational Tau 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

Obeznamte se s modelem UML produktu Rational Tau a se schématy Rational Tau, jež jsou zapotřebí k extrahování dat z produktu Rational Publishing Engine. Chcete-li vyhledat Informační centrum pro svoji verzi produktu Rational Tau, prostudujte si téma O produktu Rational Tau a Informační centrum produktu Rational DOORS Analyst.

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. Schéma zdroje dat pro produkt Rational Tau můžete identifikovat jednou z následujících voleb:
    • Použijte předgenerované schéma produktu Rational Tau dodané s produktem Rational Publishing Engine. Toto schéma zdroje dat je umístění v RPE_HOME\source\Tau\schema\ttdMetamodel.xsd.
    • Generujte schéma zdroje dat z projektu UML produktu Rational Tau. Další informace viz Načtení schématu zdroje dat produktu Rational Tau.
  4. Přidejte schéma zdroje dat do šablony dokumentu. Pro produkt Rational Tau můžete postupovat následujícím způsobem:
    1. V aplikaci Document Studio klepněte na volbu Data > Přidat schéma zdroje dat.
    2. V poli Předdefinované vyberte hodnotu Tau.
    3. V poli Typ vyberte typ schématu ze seznamu. Pro produkt Rational Tau vyberte hodnotu TAU.
    4. Upravte pole Schéma, je-li třeba, nebo klepněte na tlačítko Procházet, abyste vybrali cestu pro soubor schématu. Příklad: RPE_HOME\source\Tau\schema\ttdMetamodel.xsd
    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í. Pokud nevyberete typ, je testován každý typ, 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.
  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ě. Dotazy v produktu IBM Rational Tau mají syntaxi podobnou syntaxi XPath. Avšak na rozdíl od XPath neurčuje dotaz produktu Rational Publishing Engine filtr. Filtr a klauzule pro řazení jsou od dotazu odděleny. Každý prvek schématu, kromě dotazu, je definován prostřednictvím nativního dotazu produktu Rational Tau. Tento dotaz, který je vyjádřen v jazyce OCL, načítá data produktu Rational Tau. Např. kořenový prvek pod prvkem modelu model.rootResource má k sobě připojen dotaz produktu Rational Tau ve tvaru GetModelRoots().
    Poznámka:
    • Vlastní atributy nelze vytvářet ve schématech zdrojů dat produktu Rational Tau.
    • Nemůžete provést náhled produktu Rational Tau z aplikací Launcher nebo Document Studio.
  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 také téma Podmínky filtru podporované nativními filtry REST.
  9. Můžete použít filtr přetypovávaného dotazu ke zpřesnění výsledků určitého dotazu. Funkce přetypování typu pracuje jako alternativní filtr pro prvky zdroje dat. Podrobnosti naleznete v tématech Přetypování typu a Atributy produktu Rational Tau.
  10. Vytvořte řazení, abyste organizovali data v sestavě. Zdroj dat produktu Rational Tau nepodporuje nativní řazení. Použijte řazení produktu Rational Publishing Engine.

Příklad

Tabulka 1. Příklad dokumentu s více šablonami v produktu Rational Tau
Název souboru šablony Obsah šablony Vysvětlení použití
titlePage.dta Titulní stránka, obsah Generuje titulní stránku z předvoleb modulu.
Preamble.dta Kapitoly preambule Obsahuje soubor aplikace Microsoft Word s kapitolami preambule.
Requirements.dta Systémové požadavky Generuje data ze zdroje dat uvádějící systémové požadavky.
userRequirements.dta Uživatelské požadavky Generuje data ze zdroje dat uvádějící uživatelské požadavky.
Design.dta Informace o modelování Generuje data ze zdroje dat uvádějící informace z modelu UML.

Zpětná vazba