Po zintegrowaniu produktu Rational Publishing Engine z produktem Rational DOORS można generować dokumenty bezpośrednio z produktu Rational DOORS.
Zanim rozpoczniesz
Należy sprawdzić moduł produktu
Rational DOORS, który ma być używany, oraz jego zawartość. Aby znaleźć Centrum informacyjne danej wersji produktu
Rational DOORS, należy zapoznać się z sekcją
Informacje o Centrum informacyjnym produktu Rational DOORS.
Wskazówka: Można użyć kombinacji właściwości modułu, atrybutów obiektu i widoków, które są przechowywane w modułach.
Należy przejrzeć widoki dostępne w module pod kątem kolumn obliczanych, w tym widoki śledzenia, lub kolumn DXL układu. Te widoki nie odpowiadają atrybutom produktu Rational DOORS, ale mogą być uwzględniane w raportach.
Instalacja
Produkt
Rational DOORS należy zainstalować przed produktem
Rational Publishing Engine. Produkt
Rational Publishing Engine musi zmodyfikować klucz rejestru utworzony przez produkt
Rational DOORS.
Uwaga: Instalacja produktu
Rational Publishing Engine w systemie Windows powoduje zaktualizowanie wielu wpisów w rejestrze związanych z produktem
Rational DOORS.
Jeśli produkt
Rational DOORS zainstalowano po produkcie
Rational Publishing Engine, należy otworzyć program
IBM® Installation Manager i kliknąć przycisk
Modyfikuj, a następnie
wykonać kroki kreatora dla produktu
Rational Publishing Engine, aby zresetować konfigurację
produktu
Rational DOORS. Powoduje to zaktualizowanie najnowszych zmian w rejestrze wprowadzonych przez instalator produktu
Rational Publishing Engine.
Informacje na temat ręcznego aktualizowania rejestrów zawiera sekcja
Ręczne aktualizowanie rejestrów produktu Rational DOORS.
Podczas instalacji produktu Rational Publishing Engine można skorzystać z opcji instalacji dodatku produktu Rational DOORS.
Po zainstalowaniu tego dodatku można publikować szablony produktu Rational Publishing Engine bezpośrednio z poziomu produktu Rational DOORS.
Jeśli produkt Rational Publishing Engine jest instalowany przed produktem Rational DOORS, klucz rejestru nie jest aktualizowany i wtyczka Publikowanie zawarta w dodatku produktu Rational DOORS nie może zostać znaleziona przez produkt Rational DOORS.
Budowanie szablonu
- Za pomocą kreatora wykrywania schematu produktu Rational DOORS wygeneruj nowy schemat. Po wykryciu schematu modułu produktu Rational DOORS można podjąć decyzję, które atrybuty i kolumny mają być dostępne do użytku w szablonie. Użytkownik może wybrać te elementy i umieścić je w szablonie. Patrz sekcja
Dodawanie schematu źródła danych produktu Rational DOORS za pomocą kreatora wykrywania schematów.
Atrybuty te można awansować również później podczas projektowania szablonu.
Atrybuty dodają do elementów informacje deklaratywne wykraczające poza zwykłe predefiniowane słowa kluczowe.
Atrybuty produktu Rational DOORS zdefiniowane przez użytkownika są dostępne wyłącznie za pośrednictwem węzłów Attribute w standardowym pliku schematu produktu Rational DOORS. Aby móc korzystać z tych atrybutów, muszą one zostać awansowane jako atrybuty XML za pomocą kreatora wykrywania schematu XML. Atrybut może występować tylko raz, na przykład Module Name (Nazwa modułu) i właściwość Data ostatniej modyfikacji. Atrybuty
mogą mieć zastosowanie do obiektu, ale z wieloma wystąpieniami (na przykład Nagłówek obiektu i Tekst obiektu). Istnieje również możliwość określenia atrybutów obiektu, które są obecne w module produktu Rational DOORS, a następnie oceny, czy muszą one występować w raporcie produktu Rational Publishing Engine.
Za pomocą opcji można uzyskać dostęp do listy atrybutów zawartych w module.
- Używaj zapytań, atrybutów i zmiennych w celu dodawania danych do szablonu.
- Zaprojektuj szablon za pomocą aplikacji Document Studio. Patrz:
Tworzenie szablonów za pomocą aplikacji Document Studio.
Po nawiązaniu połączenia ze schematem źródła danych zaplanuj strukturę dokumentu i zdefiniuj treść do wyodrębniania danych.
Przegląd procesu projektowania szablonu jest zawarty w sekcji Projektowanie szablonów dokumentów. W przypadku dużych dokumentów można tworzyć osobne szablony dla każdego bloku dokumentu.
- Skonstruuj wspólny element kontenera do przechowywania kilka akapitów.
Każdy akapit jest kontrolowany przez warunek testowy, który wiąże go tylko z konkretnymi danymi z modułu źródłowego produktu Rational DOORS.
Przy tworzeniu danych wyjściowych używane są elementy sterujące formatowania oraz specyfikacje stylów. Patrz sekcja
Dodawanie elementów do szablonu.
Elementów kontenera można używać zamiast tabel na potrzeby diagramów produktu
Rational DOORS Analyst, które są zawarte w tabeli 1x1.
- Utwórz tabelę na podstawie danych produktu Rational DOORS.
Patrz sekcja Dodawanie elementu tabeli. Nie ma bezpośredniej obsługi odtworzenia tabeli produktu Rational DOORS dokładnie w taki sam sposób, jak wygląda ona w produkcie Rational DOORS. Można użyć dostępnych atrybutów tabeli produktu Rational DOORS i wygenerować nową tabelę.
- Za pomocą elementu Konfiguracja źródła danych można zdefiniować niektóre właściwości, które nie są znane w czasie wykonywania. Patrz sekcja Dodawanie elementu konfiguracji źródła danych. Na przykład można dodać projekt produktu Rational DOORS, który nie został jeszcze utworzony, i wygenerować raport testowy do użycia w przyszłości.
- Istnieje możliwość używania filtrów, które są szczegółowymi wersjami ogólnego identyfikatora URI źródła danych. Pozwalają one wskazywać konkretne podzbiory danych, tak aby
produkt Rational Publishing Engine nie próbował podczas generowania raportu pobierać informacji ze
źródła danych wilości większej niż konieczna. Te filtry muszą być na tyle ogólne, aby pobrać wszystkie niezbędne dane, do których odwołuje się szablon. W przeciwnym razie wygenerowany raport może nie zawierać kompletnego zbioru danych. Więcej informacji na temat używania rodzimych filtrów produktu Rational Publishing Engine zawiera sekcja Wyodrębnianie danych przy użyciu filtrów rodzimych.
Publikowanie dokumentu
- Po zakończeniu tworzenia szablonu raportu i zapełnieniu go punktami danych produktu Rational DOORS można generować raporty w różnych formatach. Podczas generowania raportu konieczne jest nawiązanie połączenia ze źródłem danych zawierającym informacje do uwzględnienia w raporcie. Informacje na temat wskazywania odpowiednich danych zawiera sekcja Nawiązywanie połączenia ze źródłem danych Rational DOORS.
Wskazówka: Istnieje możliwość wyodrębniania obiektów OLE (technika Object Linking and Embedding) ze źródła danych produktu
Rational DOORS. Patrz:
Obiekty OLE.
- Jeśli schematy źródła danych zostają dodane do szablonu po przypisaniu tego szablonu do specyfikacji dokumentu, specyfikacja dokumentu staje się niezsynchronizowana. Można zsynchronizować specyfikację dokumentu ręcznie lub wybrać opcję preferencji zapewniającą automatyczną synchronizację specyfikacji dokumentu z bieżącym szablonem. Informacje na temat ustawiania preferencji Czy utrzymać synchronizację specyfikacji dokumentu z bieżącym szablonem? zawiera sekcja Ustawianie preferencji projektowania dokumentów.
- Przed opublikowaniem dokumentu należy zapoznać się z tematem Określanie właściwości danych wyjściowych, aby uzyskać więcej informacji o dostępnych opcjach wyjściowych oraz o tym, które z nich są najlepsze w przypadku elementów używanych w szablonie.
- Można w tej chwili opublikować dokument. Patrz sekcja Generowanie dokumentu.
- Po zainstalowaniu dodatku produktu Rational DOORS można publikować bezpośrednio z interfejsu użytkownika produktu Rational DOORS.
- Po kliknięciu opcji Publikuj w widoku Baza danych zostanie wyświetlone zapytanie o konfiguracje szablonu i specyfikacji dokumentu, podobnie jak po kliknięciu opcji w produkcie Rational Publishing Engine.
- Po kliknięciu opcji Publikuj w widoku Moduł można
wybrać nową specyfikację dokumentu i dodać do niej szablony. Ewentualnie można
wybrać istniejącą specyfikację dokumentu, do której już dodano szablony. Następnie, jeśli szablon korzysta ze źródła danych produktu Rational DOORS, produkt Rational Publishing Engine konfiguruje źródło danych dla użytkownika przy użyciu informacji z otwartego modułu, aby wygenerować dokument. Jeśli dowolne istniejące informacje konfiguracyjne w specyfikacji dokumentu nie są zgodne z informacjami w otwartym module, istniejące informacje są zastępowane informacjami z otwartego modułu.
Uwaga: W
produkcie Rational Publishing Engine 1.1.2.2 użytkownik może wybrać szablon do opublikowania. Specyfikacja dokumentu zostanie wygenerowana automatycznie. W produkcie Rational Publishing Engine w wersji 1.2 lub nowszej użytkownicy muszą utworzyć specyfikacje dokumentów przed publikowaniem, ponieważ nie są one już generowane automatycznie.
Ważne: W
przypadku lokalnego generowania dokumentów
produkt Rational Publishing Engine
może się połączyć z uruchomionym klientem
Rational DOORS,
ale podczas zdalnego generowania dokumentów ta opcja jest niedostępna.
W
przypadku publikowania przy użyciu mechanizmu generowania zdalnego z poziomu
widoku bazy danych lub modułu przed generowaniem dokumentu należy wprowadzić
referencje uwierzytelniające w specyfikacji dokumentu. Dzięki temu zdalna
usługa produktu Rational Publishing Engine
może utworzyć instancję nowego klienta nienadzorowanego produktu Rational DOORS
w celu pobrania danych raportu.