Navrhování šablon s produktem Rational DOORS 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 produktu Rational DOORS.
Zkontrolujte modul Rational DOORS, který chcete používat. Rovněž zkontrolujte obsah tohoto modulu. Pro vyhledání vaší verze produktu Rational DOORS v Informačním centru viz O produktu Rational DOORS.

Můžete použít kombinaci vlastností modulu, atributů objektu a pohledů, které jsou uloženy v modulech. Přezkoumejte dostupné pohledy v modulu pro vypočtené sloupce včetně pohledů sledovatelnosti nebo sloupců rozvržení DXL. Tyto pohledy neodpovídají atributům produktu Rational DOORS, ale mohou představovat prvky, jež chcete zahrnout do sestavy.

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. Zde jsou dva způsoby pro přidání zdroje dat: pomocí průvodce zjišťováním schématu DOORS nebo pomocí průvodce schématem zdroje dat. Chcete-li přidat zdroj dat pomocí průvodce schématem zdroje dat, postupujte takto:
    1. V aplikaci Document Studio klepněte na volbu Data > Přidat schéma zdroje dat.
    2. V poli Předdefinované vyberte schéma databáze Doors.
    3. V poli Typ vyberte typ schématu ze seznamu. U produktu Rational DOORS vyberte DOORS.
    4. Upravte pole Schéma, je-li třeba, nebo klepněte na tlačítko Procházet, abyste vybrali cestu pro soubor schématu.
    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í. U produktu Rational DOORS je typ ověřování OAuth-OSLC. Pokud nevyberete OAuth-OSLC, je testován každý typ ověřování, dokud není nalezen správný typ, což může prodloužit dobu generování dokumentů.

    Chcete-li přidat zdroj dat pomocí průvodce zjišťováním schématu DOORS, postupujte takto:

    1. V aplikaci Document Studio klepněte na volbu Data > Zjišťování schématu > Zjišťování schématu DOORS.
    2. Zadejte podrobnosti o připojení:
      • Chcete-li použít spuštěnou instanci produktu Rational DOORS, vyberte volbu Použít spuštěnou instanci DOORS.
      • Chcete-li spustit produkt Rational DOORS na pozadí, vyberte volbu Spustit nový proces DOORS na pozadí. Zadejte jméno uživatele, heslo, databázi a cestu k souboru doors.exe.
    3. Vyberte pohled:
      • Pohled Databáze.
      • Pohled Projekt
    4. Klepněte na tlačítko Další.
    5. Vyberte typ atributu:
      • Chcete-li přidat atributy k hlavním objektům, prvkům schématu Module/Object, vyberte volbu Atributy modulu a objektů.
      • Chcete-li přidat atributy k propojeným objektům, prvkům schématu Module/Object/Link/Linked, vyberte volbu Atributy propojených objektů.
    6. V okně Výběr modulu DOORS vyberte požadovaný modul ze struktury databáze Rational DOORS a klepněte na tlačítko Další.
    7. V okně Základna DOORS vyberte základnu modulu. Vámi vybraná základna určuje, která sada atributů se má používat.
    8. V okně Atributy DOORS se zobrazí tyto informace o atributu:
      • Název atributu: Seznam atributů dostupných ve vybrané základně.
      • Rozsah: Rozsah atributu jako modulu nebo objektu.
      • Název povýšení: Povýšený název atributu je název používaný ve výrazech skriptů. Platné názvy se generují z názvu atributu produktu Rational DOORS, aby se zabránilo použití neplatných hodnot. Povýšený atribut umožňuje přímý přístup k hodnotě tohoto atributu z kontextu Module/Object. Hodnoty nepovýšených atributů jsou dostupné pouze z kontextu Module/Object/Attribute.

      Zaškrtněte políčko, abyste zadali atribut, nebo výběrem volby Vybrat vše vyberte všechny atributy. Volba Zrušit veškerý výběr zruší označení všech atributů. Klepněte na tlačítko Další.

    9. V okně Pohledy a sloupce DOORS vyberte pohled. Pak zaškrtněte políčko u názvu sloupce, chcete-li vybrat daný sloupec, nebo pomocí volby Vybrat vše vyberte názvy všech sloupců. Klepněte na tlačítko Další.
      Poznámka: Povýšený název sloupce se zobrazí ve sloupci Povýšený název. Sloupce můžete povýšit z libovolného počtu pohledů. Atributy můžete povýšit později při návrhu šablony. Atributy přidávají deklarativní informace do prvků nad rámec obvyklých předdefinovaných klíčových slov. Uživatelsky definované atributy produktu Rational DOORS jsou přístupné výlučně prostřednictvím uzlů Atribut v souboru standardního schématu Rational DOORS. Chcete-li použít tyto atributy, hodnoty atributů mohou být ohodnoceny jako atributy XML pomocí průvodce zjišťováním schématu XML. Atribut může mít jediný výskyt, například Název modulu a vlastnost Poslední změna. Atributy se mohou použít na objektu, ale mají více výskytů, jako např. Záhlaví objektu a Text objektu.
    10. V okně Vybrat volby schématu zadejte podrobnosti pro následující pole:
      • Vybrat umístění schématu: Klepnutím na tlačítko Procházet vyberte umístění, kam chcete uložit schéma zdroje dat.
      • ID schématu zdroje dat: Zadejte ID schématu zdroje dat.
      • Zaškrtnutím políčka Přidat schéma zdroje dat do aktuální šablony přidáte toto schéma do otevřené šablony. Klepněte na tlačítko Další.
      • Uložte schémata, abyste je mohli znovu použít v dalších šablonách, aniž byste museli znovu spustit Průvodce zjišťováním schématu.
    11. Zkontrolujte informace v okně souhrnu a klepněte na tlačítko Dokončit.
  4. Pracujte s atributy. Rovněž zjišťovat, které atributy objektu jsou přítomny v modulu Rational DOORS, a následně posoudit, zda musejí být ve vaší sestavě produktu Rational Publishing Engine. Použijte výběr nabídky Upravit > Atributy pro přístup k seznamu atributů, které jsou v modulu.
  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 kontejneru
    Místo tabulek můžete použít prvky kontejneru pro analytické diagramy produktu Rational DOORS obsažené v tabulce 1x1.
    Prvky obrazu
    Obrázky se extrahují z modulu produktu Rational DOORS s hodnotami pro atribut. Nelze dávat dotazy výlučně na obrázky.
    Chcete-li konfigurovat velikost extrahovaných obrázků, určete vlastnosti maximální šířka obrázku a maximální výška obrázku. Tyto vlastnosti lze určit na dvou místech:
    • Informace formátu prvku definuje velikost obrázků obsažených v tomto prvku šablony. K dispozici pouze pro prvky textové šablony.
    • Metadata specifikace dokumentu definují velikost pro obrázky ve všech šablonách. Hodnoty formátu prvku potlačují tyto globální hodnoty.
    Prvky tabulky
    Nemusíte být schopni reprodukovat tabulku Rational DOORS v produktu Rational Publishing Engine přesně tak, jak vypadá v produktu Rational DOORS; můžete použít dostupné atributy tabulky Rational DOORS a generovat novou tabulku.
    Použijte průvodce schématem Rational DOORS k extrahování informací o tabulkách produktu Rational DOORS. Příklad: TableCellWidthŠířka buňky v pixelech. K dispozici jsou dvě metody extrahování informací sloupce z produktu Rational DOORS:
    • Pomocí dotazu module/object/column, který získává názvy a hodnoty sloupců v objektovém dotazu. To je užitečné v situaci, kdy data produktu Rational DOORS iteruje objekt.
    • Pomocí dotazu module/view/column, který získává názvy sloupců z pohledu Rational DOORS, který se používá ke generování dokumentů. Iterace podle pohledu je užitečná v situaci, kdy jsou sloupce definovány v aktuálním pohledu a jsou zapotřebí jejich vlastnosti. K otestování těchto metod můžete použít ukázkové šablony produktu Rational Publishing Engine.
      Poznámka: Pro přístup k datům sloupců použijte v dotazu řetězec module/object/column/(@Column Text).

    Pokud máte v tabulkách produktu Rational DOORS buňky zahrnující více řádků, generuje produkt Rational Publishing Engine první buňku a zbývající buňky v úseku jsou odebrány.

    Další informace o tabulkách viz téma Přidání prvku tabulky.

  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 DOORS začínají kořenovým prvkem (modulem), pokračují jeho podřízenými prvky (objekty) až po podřízené atributy objektu. Např. Module/Object/Attribute/Name. Další informace viz Schéma produktu Rational DOORS.
  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. Můžete definovat nativní filtry pro dotazy na odkazy. Další informace viz Příklad: Nativní filtry produktu Rational DOORS.
  9. Vytvořte řazení, abyste organizovali data v sestavě. V případě produktu Rational DOORS musí být text nativního řazení ve formátu řazení Rational DOORS. Další informace viz Příklad: Nativní řazení v produktu Rational DOORS.

Jak pokračovat dále

Pokud používáte ukázková data z aplikace Document Studio, použije se k načtení dat výchozí základna a pohled.

Zpětná vazba