Schéma produktu Rational DOORS

Schéma produktu Rational DOORS přesně odpovídá struktuře modulu produktu Rational DOORS.

Můžete použít předdefinované schéma, které je generické a platí pro všechny formální moduly produktu Rational DOORS. Toto předdefinované schéma použijte, pracujete-li s celým pohledem nebo s předdefinovanými atributy pohledu, které nevyžadují extrahování atributů definovaných uživatelem. Jsou-li zapotřebí uživatelsky definované atributy, použijte k vytvořené schématu Rational DOORS průvodce zjištěním schématu z produktu Document Studio.

Dotazy a atributy v předdefinovaném schématu

V předdefinovaném schématu jsou níže uvedené dotazy a atributy.
Tabulka 1. Dotazy a atributy
Dotaz Výsledky Atributy
Module Jediná entita, modul specifikovaný v konfiguraci zdroje dat
  • Name: Název modulu
  • Description: Popis modulu
  • Baseline: Verze modulu
Module/Attribute Seznam atributů na úrovni modulu pro modul
  • Name: Název atributu
  • _value: Hodnota atributu
Module/Discussion Seznam diskuzí pro modul Nelze aplikovat
Module/Discussion/Attribute Seznam atributů pro diskuzi
  • Name: Název atributu
  • _value: Hodnota atributu
Module/Discussion/Comment Seznam komentářů pro diskuzi
  • Status
  • Text
  • Changed Status
  • Created On
Module/View Jeden výsledek, pohled definovaný pro jednotlivé zdroje dat produktu Rational DOORS ve specifikaci dokumentu
  • Name: Název pohledu
Module/View/Column Seznam názvů v záhlaví sloupců pro vybraný pohled
Poznámka: Tento dotaz poskytuje metodu získání struktury pohledu, tj. informace o sloupcích, bez nutnosti získání vlastních dat pohledu. Informace o datech o sloupcích viz Modul/Objekt/Sloupec.
  • Column Text: Použití tohoto atributu v šabloně vygeneruje ve výstupu zprávu <atribut dat nebyl nalezen>
  • Main: Sloupec je/není hlavním sloupcem
  • Name: Název sloupce
  • Attribute: Atribut sloupce není atributem produktu Rational DOORS, na němž je tento sloupec založen, ale konstruktem Rational Publishing Engine. Atribut je vyplněn v době běhu programu jedinou textovou hodnotou sloupce. Z parametru Attribute nemůžete načíst informaci o použitém atributu či DXL pro sloupec.
  • _value: Prázdné
Module/Object Seznam všech objektů se zadanou verzí modulů, které jsou filtrovány a seřazeny vybraným pohledem. Veškeré atributy povýšené uživatelem v průvodci zjištěním schématu.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/Attribute Seznam atributů pro objekt, pokud je dotaz v kontextu dotazu modul/objekt. Jinak je zahrnut seznam všech atributů pro všechny objekty v modulu.
  • Name: Název atributu
  • _value: Hodnota atributu
Module/Object/Column Data sloupce z vybraného pohledu pro aktuální objekt
  • Column Text: Data ze sloupce
  • Main: Sloupec je/není hlavním sloupcem
  • Name: Název sloupce
  • Attribute: Atribut sloupce není atributem produktu Rational DOORS, na němž je tento sloupec založen, ale konstruktem Rational Publishing Engine. Atribut je vyplněn v době běhu programu jedinou textovou hodnotou sloupce. Z parametru Attribute nemůžete načíst informaci o použitém atributu či DXL pro sloupec.
  • _value: Prázdné
Module/Object/Table Jeden výsledek (tabulka Rational DOORS), je-li objekt záhlavím tabulky. Zahrnuty nejsou žádné výsledky, pokud aktuální objekt není tabulkou Rational DOORS. Nelze aplikovat
Module/Object/Table/Row Řádky tabulky Nelze aplikovat
Module/Object/Table/Row/object Kolekce objektů; buňky aktuálního řádku. K dispozici jsou stejné atributy, jako pro dotaz module/object.
  • Object Identifier
  • Object Text
  • Object Heading
  • Absolute Number
  • Object Level
Module/Object/External Link Kolekce externích odkazů pro objekt
  • URL: Adresa URL externí propojené entity nebo ostatní atributy definované v produktu Rational DOORS
Module/Object/Link Seznam odkazů Rational DOORS pro objekt Nelze aplikovat
Module/Object/Link/Attribute Seznam atributů pro odkaz
  • Name: Název atributu
  • _value: Prázdné
Module/Object/Link/Linked Object Seznam propojených objektů Nelze aplikovat

Obrázky

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.

Objekty OLE

Ze zdroje dat Rational DOORS můžete extrahovat vložené objekty, tj. například objekty OLE (Object Linking and Embedding). Objekty OLE se ve výstupech HTML, PDF a XSL-FO vždy vykreslují jako obrázky, protože tyto formáty nepodporují objekty OLE.
Pro výstup Microsoft Word musíte nastavit vlastnost Objekty OLE jako statické obrázky v části metadat specifikace dokumentu.
  • Je-li pro vlastnost Objekty OLE jako statické obrázky nastavena hodnota true, budou objekty OLE zahrnuty do výstupního dokumentu jako statické obrázky. Když jsou objekty OLE zahrnuty do výstupního dokumentu jako statické obrázky, dokument je samostatný.
  • Je-li pro vlastnost Objekty OLE jako statické obrázky nastavena hodnota false, dojde k vygenerování složky ref v umístění výstupního dokumentu Microsoft Word. Když nejsou objekty OLE zahrnuty do výstupního dokumentu jako statické obrázky, dokument není samostatný, protože je požadována samostatná složka ref.
Složka ref obsahuje soubory .rtf pro objekty OLE. Pro každý exportovaný objekt OLE zahrnuje výstup Microsoft Word jedno pole ukazující na soubor .rtf. Protože produkt IBM® Rational Publishing Engine není schopen aktualizovat pole Microsoft Word, zahrnutá pole se při otevření dokumentu Microsoft Word nezobrazují. Chcete-li tato pole zobrazit, proveďte některou z těchto akcí:
Tabulka 2. Akce
Akce Výsledek
Vyberte celý obsah dokumentu a použijte funkci Aktualizovat pole programu Microsoft Word. Objekty OLE se zobrazí v dokumentu. Dokument není samostatný.
Použijte makro updateFields, jež je součástí produktu Rational Publishing Engine. Objekty OLE se zobrazí v dokumentu. Dokument není samostatný.
Použijte makro insertOLEs, jež je součástí produktu Rational Publishing Engine. Objekty OLE se zobrazí v dokumentu. Dokument je samostatný.
Použijte makro rpe nebo insertOLEs, jež je součástí produktu Rational Publishing Engine. Objekty OLE se zobrazí v dokumentu. Dokument je samostatný.
Poznámka: Přesunete-li dokument, který není samostatný, na jiný počítač, nebudete moci upravovat objekty OLE. Tomuto problému se vyhnete spuštěním makra rpe nebo insertOLEs.

Tabulky

Extrahování tabulek Rational DOORS neprobíhá automaticky. Musíte pro ně zadat explicitní dotaz. Tato ruční metoda poskytuje řízení s vysokou úrovní granularity formátu tabulky. Tabulka se vytváří pouze pro objekty Rational DOORS, které spouštějí tabulku.

Příklad dotazu, který extrahuje tabulku:

Container DOORS 1 $1 Module/Object
Odstavec
Text
Module/Object/Object/Text
Table DOORS 1 $2 Module/Object/Table
Row DOORS 1 $3 Module/Object/Table/Row
Cell DOORS 1 $4 Module/Object/Table/Row/Object
Text
Module/Object/Table/Row/Object/Object Text

Poznámka: Buňky tabulky nemají ve schématu produktu Rational DOORS vyhrazený typ. Chcete-li načíst obsah buňky, použijte dotaz Module/Object/Table/Row/Object. Objekty, jež jsou buňkami tabulky, mají atribut Text objektu, který kombinuje Záhlaví objektu a Text objektu.

Externí odkazy

Dotaz Module/Object/External Link načítá informace související s odkazy produktu Rational DOORS. Informace sestává z adresy URL externí entity a ze sady dalších atributů, jež jsou definovány pro externí odkaz.

Vnitřní odkazy

K načtení informací souvisejících s vnitřními odkazy produktu Rational DOORS použijte dotazy. Vnitřní odkazy vytvářejí odkazy mezi souvisejícími informacemi. Například můžete vytvořit odkaz z uživatelského požadavku k funkcím návrhu. Můžete se dotazovat na odkazy na objekty nebo na propojené odkazy.

Rekurzivní načtení

Chcete-li odkazy produktu Rational DOORS sledovat rekurzivně, nastavte pro vlastnost Úroveň rekurze nenulovou hodnotu v pohledu Vlastnosti. To způsobí sledování odkazů od počátečního objektu a všech propojených objektů až po uvedenou úroveň rekurze.

Poznámka: Sledování odkazů je časově náročné. Protože každý objekt má obvykle více odkazů, s každou úrovní rekurze počet zpracovaných objektů narůstá exponenciálně. Chcete-li uspořit čas, použijte nativní filtry ke snížení počtu sledovaných odkazů.

Nativní filtrování

Můžete definovat nativní filtry pro dotazy na odkazy. Použití těchto filtrů snižuje počet zpracovaných odkazů, a zkracuje tak dobu nezbytnou k vygenerování dokumentů.

Filtrování podle směru

Syntaxe pro filtrování všech příchozích a odchozích odkazů:

Link direction in|out

Filtrování podle modulu odkazu

Syntaxe pro filtrování všech odkazů prostřednictvím modulu odkazu: Link module link_module_path_and_name

Filtr odlišuje velká a malá písmena.

Následující příklad filtruje všechny odkazy z modulu odkazu Link Module 1:

Link module /Demo/Car/Link Module 1

Filtrování podle cílového modulu

Syntaxe pro filtrování všech odkazů přicházejících či vycházejících do/z určeného modulu: Link analyze module cesta_a_název_cílového_modulu

Následující příklad filtruje všechny odkazy mezi modulem analyze a modulem system requirement: Link analyze module /Demo/Car/System Requirements

Kombinace nativního filtrování odkazů

Filtry můžete kombinovat na kartě nativních filtrů. Každý filtr musí být na svém vlastním řádku.
Například můžete na kartě nativní filtr zadat filtr takto:

Link direction out.
Link analyze module /Demo/Car/System Requirements.

Co nelze extrahovat

Zdroj dat produktu Rational DOORS v produktu Rational Publishing Engine je definován modulem, úrovní baseline a pohledem. Nemůžete dotazovat seznam úrovní baseline nebo seznam pohledů pro modul. Zdroj dat produktu Rational DOORS je definován modulem, úrovní baseline a pohledem. Extrahování dat z více než jednoho modulu, úrovně baseline či pohledu můžete provádět takto:

Zpětná vazba