Schemat produktu Rational DOORS

Schemat produktu Rational DOORS bardzo ściśle odpowiada strukturze modułu Rational DOORS.

Użytkownik może korzystać z predefiniowanego schematu, który jest ogólny i poprawny dla wszystkich modułów formalnych produktu Rational DOORS. Tego predefiniowanego schematu można używać podczas pracy z całym widokiem lub z predefiniowanymi atrybutami widoku, które nie wymagają wyodrębnionych atrybutów zdefiniowanych przez użytkownika. Jeśli atrybuty zdefiniowane przez użytkownika są wymagane, należy użyć kreatora wykrywania schematu, dostępnego w aplikacji Document Studio, do utworzenia schematu produktu Rational DOORS.

Zapytania i atrybuty w schemacie predefiniowanym

Następujące zapytania i atrybuty znajdują się w predefiniowanym schemacie.
Tabela 1. Zapytania i atrybuty
Zapytanie Wyniki Atrybuty
Module Pojedyncza encja, moduł określony w konfiguracji źródła danych
  • Name (Nazwa): Nazwa modułu
  • Description (Opis): Opis modułu
  • Baseline (Wersja): Wersja modułu
Module/Attribute Lista atrybutów modułu, określonych na poziomie modułu
  • Name (Nazwa): Nazwa atrybutu
  • _value (Wartość)Wartość atrybutu
Module/Discussion Lista dyskusji związanych z modułem Nie dotyczy
Module/Discussion/Attribute Lista atrybutów dyskusji
  • Name (Nazwa): Nazwa atrybutu
  • _value (Wartość)Wartość atrybutu
Module/Discussion/Comment Lista komentarzy do dyskusji
  • Status
  • Text (Tekst)
  • Changed Status (Zmieniony status)
  • Created On (Utworzono)
Module/View Pojedynczy wynik, widok zdefiniowany dla każdego źródła danych produktu Rational DOORS w specyfikacji dokumentu
  • Name (Nazwa): Nazwa widoku
Module/View/Column Lista nazw nagłówków kolumn związanych z wybranym widokiem
Uwaga: To zapytanie umożliwia pobranie struktury widoku, czyli informacji o kolumnach, bez pobierania danych widoku. Informacje o danych w kolumnach zawiera sekcja dotycząca zapytania Module/Object/Column.
  • Column Text (Tekst kolumny): Użycie tego atrybutu w szablonie powoduje wygenerowanie w danych wyjściowych komunikatu <nie znaleziono atrybutu danych>
  • Main (Główna): Informacja o tym, czy dana kolumna jest główna, czy nie
  • Name (Nazwa): Nazwa kolumny
  • Attribute (Atrybut): Atrybut kolumny nie jest atrybutem produktu Rational DOORS, na którym oparta jest dana kolumna, ale jest konstrukcją produktu Rational Publishing Engine. Atrybut jest wypełniany w czasie wykonywania wartością tekstową pojedynczej kolumny. Z atrybutu Attribute nie można pobrać informacji o atrybucie bazowym ani skrypcie DXL związanym z kolumną.
  • _value (Wartość): Pusty
Module/Object Lista wszystkich obiektów z określoną wersją modułów, które są filtrowane i sortowane według wybranego widoku. Dowolny atrybut awansowany przez użytkownika w kreatorze wykrywania schematu.
  • Object Identifier (Identyfikator obiektu)
  • Object Text (Tekst obiektu)
  • Object Heading (Nagłówek obiektu)
  • Absolute Number (Wartość bezwzględna)
  • Object Level (Poziom obiektu)
Module/Object/Attribute Lista atrybutów obiektu, jeśli zapytanie jest w kontekście zapytania module/object. W przeciwnym razie jest to lista wszystkich atrybutów wszystkich obiektów w module.
  • Name (Nazwa): Nazwa atrybutu
  • _value (Wartość)Wartość atrybutu
Module/Object/Column Dane kolumny z wybranego widoku bieżącego obiektu
  • Column Text (Tekst kolumny): Dane znajdujące się w kolumnie
  • Main (Główna): Informacja o tym, czy dana kolumna jest główna, czy nie
  • Name (Nazwa): Nazwa kolumny
  • Attribute (Atrybut): Atrybut kolumny nie jest atrybutem produktu Rational DOORS, na którym oparta jest dana kolumna, ale jest konstrukcją produktu Rational Publishing Engine. Atrybut jest wypełniany w czasie wykonywania wartością tekstową pojedynczej kolumny. Z atrybutu Attribute nie można pobrać informacji o atrybucie bazowym ani skrypcie DXL związanym z kolumną.
  • _value (Wartość): Pusty
Module/Object/Table Pojedynczy wynik (tabela produktu Rational DOORS), jeśli obiekt jest nagłówkiem tabeli. Nie ma wyników, jeśli bieżący obiekt nie jest tabelą produktu Rational DOORS. Nie dotyczy
Module/Object/Table/Row Wiersze tabeli Nie dotyczy
Module/Object/Table/Row/object Kolekcja obiektów - komórki w bieżącym wierszu. Lista dostępnych atrybutów jest taka sama, jak w przypadku zapytania module/object.
  • Object Identifier (Identyfikator obiektu)
  • Object Text (Tekst obiektu)
  • Object Heading (Nagłówek obiektu)
  • Absolute Number (Wartość bezwzględna)
  • Object Level (Poziom obiektu)
Module/Object/External Link Kolekcja odsyłaczy zewnętrznych związanych z obiektem
  • URL: Adres URL zewnętrznej powiązanej encji i innych atrybutów zdefiniowanych w produkcie Rational DOORS
Module/Object/Link Lista odsyłaczy produktu Rational DOORS związanych z obiektem Nie dotyczy
Module/Object/Link/Attribute Lista atrybutów związanych z odsyłaczem
  • Name (Nazwa): Nazwa atrybutu
  • _value (Wartość): Pusty
Module/Object/Link/Linked Object Lista połączonych obiektów Nie dotyczy

Images (Obrazy)

Obrazy są wyodrębniane z modułu produktu Rational DOORS z wartościami atrybutu. Nie można wykonywać zapytań wyłącznie o obrazy.

Aby skonfigurować wielkość wyodrębnianych obrazów, należy określić właściwości image max width (maksymalna szerokość obrazu) i image max height (maksymalna wysokość obrazu). Właściwości te można określić w dwóch miejscach:
  • Informacje o formacie elementu definiują wielkość obrazów znajdujących się w danym elemencie szablonu. Są dostępne tylko w przypadku elementów szablonów tekstowych.
  • Metadane specyfikacji dokumentu definiują wielkość obrazów we wszystkich szablonach. Wartości formatu elementów przesłaniają wartości globalne.

Obiekty OLE

Istnieje możliwość wyodrębniania osadzonych obiektów, takich jak obiekty OLE (Object Linking and Embedding), ze źródła danych produktu Rational DOORS. Obiekty OLE są w formacie HTML, PDF i dokumentów wyjściowych XSL-FO zawsze wyświetlane jako obrazy, ponieważ te formaty nie obsługują obiektów OLE.
W przypadku danych wyjściowych programu Microsoft Word należy ustawić właściwość Obiekty OLE jako obrazy statyczne w sekcji metadanych specyfikacji dokumentu.
  • Jeśli właściwość Obiekty OLE jako obrazy statyczne jest ustawiona na wartość true, obiekty OLE są zawarte w dokumencie wyjściowym jako obrazy statyczne. Jeśli obiekty OLE są zawarte w dokumencie wyjściowym jako obrazy statyczne, dokument jest samodzielny.
  • Jeśli właściwość Obiekty OLE jako obrazy statyczne jest ustawiona na wartość false, folder ref jest generowany w tym samym miejscu, w którym znajduje się dokument wyjściowy programu Microsoft Word. Jeśli obiekty OLE nie są zawarte w dokumencie wyjściowym jako obrazy statyczne, dokument nie jest samodzielny, ponieważ jest wymagany osobny folder ref.
Folder ref zawiera pliki .rtf obiektów OLE. Dla każdego wyeksportowanego obiektu OLE do danych wyjściowych programu Microsoft Word dołączane jest pole wskazujące plik .rtf. Ponieważ produkt IBM® Rational Publishing Engine nie może aktualizować pól programu Microsoft Word, dołączone pola są niewidoczne, gdy dokument programu Microsoft Word jest otwarty. Aby ustawić te pola jako widoczne, wykonaj jedno z następujących działań:
Tabela 2. Działania
Działanie Wynik
Zaznacz całą treść dokumentu i użyj funkcji Aktualizuj pola w programie Microsoft Word. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument nie jest niezależny.
Użyj makrodefinicji updateFields udostępnionej w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument nie jest niezależny.
Użyj makrodefinicji insertOLEs udostępnionej w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument jest niezależny.
Użyj makrodefinicji rpe lub insertOLEs udostępnionych w produkcie Rational Publishing Engine. Obiekty OLE zostaną wyświetlone w dokumencie. Dokument jest niezależny.
Uwaga: W przypadku przeniesienia dokumentu, który nie jest niezależny, na inny komputer nie można edytować obiektów OLE. Aby uniknąć tego problemu, należy uruchomić makrodefinicje rpe lub insertOLEs.

Tabele

Tabele produktu Rational DOORS nie są wyodrębniane automatycznie. Należy jawnie wykonać zapytania, które ich dotyczą. To ręczne podejście zapewnia szczegółową kontrolę nad formatem tabeli. Tabela jest tworzona tylko dla obiektów produktu Rational DOORS, które rozpoczynają tabelę.

Przykład zapytania wyodrębniającego tabelę:

Container DOORS 1 $1 Module/Object
Paragraph
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

Uwaga: Komórki tabeli nie mają dedykowanego typu w schemacie produktu Rational DOORS. Aby pobrać zawartość komórki, należy użyć zapytania Module/Object/Table/Row/Object. Obiekty, które są komórkami tabeli, posiadają atrybut Object Text, który łączy atrybuty Object Heading i Object Text.

Odsyłacze zewnętrzne

Zapytanie Module/Object/External Link powoduje pobranie informacji dotyczących odsyłaczy produktu Rational DOORS. Informacje obejmują adres URL jednostki zewnętrznej i zestaw innych atrybutów zdefiniowanych dla odsyłacza zewnętrznego.

Odsyłacze wewnętrzne

Zapytania umożliwiają pobieranie informacji dotyczących odsyłaczy wewnętrznych produktu Rational DOORS. Odsyłacze wewnętrzne tworzą połączenia między informacjami pokrewnymi. Na przykład można utworzyć odsyłacz z wymagania użytkownika do opcji projektu. Można wykonywać zapytania dotyczące odsyłaczy do obiektów lub obiektów połączonych.

Pobieranie rekurencyjne

Aby podążać za odsyłaczami produktu Rational DOORS rekurencyjnie, należy ustawić właściwość Poziom rekurencji na wartość różną od zera w widoku Właściwości. Powoduje to podążanie za odsyłaczami z obiektu początkowego i z wszystkich obiektów z nim połączonych do określonego poziomu rekurencji.

Uwaga: Podążanie za odsyłaczami jest procesem zajmującym dużo czasu. Ponieważ każdy obiekt zawiera zwykle wiele odsyłaczy, liczba przetwarzanych obiektów rośnie wykładniczo na każdym poziomie. Aby oszczędzić czas, należy użyć filtru rodzimego ograniczającego liczbę odsyłaczy, które są sprawdzane.

Filtrowanie rodzime

Istnieje możliwość zdefiniowania filtrów rodzimych w zapytaniach dotyczących odsyłaczy. Użycie tych filtrów zmniejsza liczbę odsyłaczy do przetworzenia, co skraca czas generowania dokumentu.

Filtrowanie według kierunku

Składnia filtrowania wszystkich odsyłaczy przychodzących lub odsyłaczy wychodzących jest następująca:

Link direction in|out

Filtrowanie według modułu odsyłacza

Składnia filtrowania wszystkich odsyłaczy za pośrednictwem modułu odsyłacza jest następująca: Link module ścieżka_i_nazwa_modułu_odsyłacza

W filtrze rozróżniana jest wielkości liter.

W poniższym przykładzie przedstawiono filtrowanie wszystkich odsyłaczy z modułu odsyłaczy Link Module 1:

Link module /Demo/Car/Link Module 1

Filtrowanie według modułu docelowego

Składnia filtrowania wszystkich odsyłaczy skierowanych do lub z określonego modułu jest następująca: Link analyze module ścieżka_i_nazwa_modułu docelowego

W poniższym przykładzie przedstawiono filtrowanie wszystkich odsyłaczy między modułem analyze i modułem system requirement: Link analyze module /Demo/Car/System Requirements

Łączenie rodzimego filtrowania odsyłaczy

Filtry można połączyć na karcie filtru rodzimego. Każdy filtr musi znajdować się w osobnym wierszu.
Na przykład na karcie Filtr rodzimy można wpisać następujący filtr:

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

Czego nie można wyodrębnić

Źródło danych produktu Rational DOORS w produkcie Rational Publishing Engine jest zdefiniowane przez elementy moduł, wersja, widok. Nie można wykonywać zapytania o listę wersji lub listę widoków modułu. Źródło danych produktu Rational DOORS jest zdefiniowane przez elementy moduł, wersja, widok. Wyodrębnianie danych z więcej niż jednego modułu, wersji lub widoku można wykonać jedną z następujących metod:

Opinia