Generowanie dokumentów z produktem Rational DOORS jako źródłem danych

Po utworzeniu szablonu raportu i zapełnieniu go punktami danych można generować raporty w różnych formatach.

Zanim rozpoczniesz

W przypadku wyświetlania podglądu danych z poziomu aplikacji Launcher domyślny plan bazowy i widok są używane do pobierania danych.

Istnieje możliwość wyodrębniania obiektów OLE (technika Object Linking and Embedding) ze źródła danych produktu Rational DOORS. Więcej informacji na ten temat zawiera sekcja Obiekty OLE.

Generowanie dokumentu za pomocą programu dodatkowego

Po zainstalowaniu programu dodatkowego produktu Rational DOORS można generować dokumenty bezpośrednio z interfejsu użytkownika produktu Rational DOORS.

O tym zadaniu

  • Licencja jest używana na komputerze po uruchomieniu generowania lokalnego dokumentu w programie dodatkowym produktu Rational Publishing Engine za pomocą interfejsu użytkownika lub wiersza komend. Licencja jest pobierana po rozpoczęciu generowania zdalnego dokumentu. Następnie po wygenerowaniu dokumentu licencja jest zwracana.
  • Licencja jest używana na serwerze po uruchomieniu generowania zdalnego dokumentu w programie dodatkowym produktu Rational Publishing Engine za pomocą interfejsu użytkownika lub wiersza komend. Licencja jest pobierana po rozpoczęciu generowania zdalnego dokumentu. Następnie po wygenerowaniu dokumentu licencja jest zwracana.
Uwaga: Nie można uzyskać dostępu do interfejsów użytkownika aplikacji Document Studio lub aplikacji Launcher podczas używania do publikowania dokumentu programu dodatkowego produktu Rational Publishing Engine.

Procedura

W widoku Baza danych lub Moduł kliknij opcję Publikuj.
  • 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 Specyfikacja dokumentu > Generuj > Konfiguruj i generuj dokument 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. Przycisk Zakończ zostanie aktywowany po wybraniu co najmniej jednego szablonu i jednego formatu danych wyjściowych.
    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.

Generowanie dokumentu za pomocą kreatora generowania dokumentów produktu Rational Publishing Engine

Można użyć kreatora generowania dokumentu do konfigurowania wymagań raportu.

Procedura

  1. W aplikacji Document Studio lub w aplikacji Launcher otwórz kreator generowania dokumentów, klikając opcję Specyfikacja dokumentu > Generuj > Skonfiguruj i wygeneruj dokument.
  2. W sekcji Szablony zostaną wyświetlone szablony już wymienione w specyfikacji dokumentu. Aby dodać szablon:
    1. Wybierz położenie szablonów do dodania:
      • Z biblioteki centralnej: umożliwia wybór szablonów przechowywanych w komponencie centralnego zarządzania.
      • Z lokalnego lub zdalnego pliku: aby wybrać szablony lokalne lub zdalne, wprowadź adres URL szablonu lub kliknij przycisk Przeglądaj w celu wybrania szablonu.
    2. Wybierz co najmniej jeden szablon do dodania.
      • Jeśli wybrano opcję Z bibliotek centralnej oraz szablony z komponentu Centralne zarządzanie, kliknij opcję Dodaj wybrane, aby dodać szablony do specyfikacji dokumentu.
      • Jeśli wybrano opcję Z lokalnego lub zdalnego pliku i wprowadzono adres URL pojedynczego szablonu, kliknij opcję Dodaj adres URL, aby dodać szablon do specyfikacji dokumentu.
      • Jeśli wybrano opcję Z lokalnego lub zdalnego pliku i wskazano szablony, które mają zostać dodane, po kliknięciu przycisku Otwórz szablony zostaną dodane do specyfikacji dokumentu.
    3. Opcjonalne: Powtórz powyższe kroki, aby dodać kolejne szablony z innych miejsc.
    4. Opcjonalne: Zmień kolejność szablonów w specyfikacji dokumentu, wybierając szablon i klikając opcję W górę lub W dół.
    5. Kliknij przycisk Dalej. Po dodaniu szablonu źródła danych i zmienne określone w szablonie są również dodawane do kreatora.
  3. W sekcji Źródła danych skonfiguruj poszczególne źródła danych.
    Uwaga:
    • Jeśli istnieje wartość domyślna dla źródła danych lub wprowadzono już wartość w polu Domyślny identyfikator URI, źródło zdanych zostanie wyświetlone jako skonfigurowane i w danych wyjściowych zostanie użyta wartość domyślna, chyba że zostanie wybrana inna wartość.
    • Jeśli po minięciu sekcji Źródła danych kliknięto przycisk Wstecz, aby wprowadzić dodatkowe zmiany do źródła danych, sekcja zawsze otwiera się na pierwszym źródle danych na liście.
    1. Baza danych: wprowadź nazwę bazy danych, z którą ma zostać nawiązane połączenie. Domyślnie jest używana nazwa -data 36677@localhost. Jeśli wartość -data nie zostanie podana, zostanie ona dołączona automatycznie. Jeśli nie zostanie podana żadna wartość, produkt Rational Publishing Engine pobierze wartość domyślną z rejestru (jeśli to możliwe).
    2. Ścieżka do pliku doors.exe: wprowadź pełną ścieżkę do pliku doors.exe. Jeśli ścieżka jest niepoprawna lub nie można uzyskać do niej dostępu, kreator poprawi tę ścieżkę (jeśli to możliwe). Przykład: C:\Program Files\IBM\Rational\DOORS\wersja\bin\doors.exe
    3. Identyfikator URI modułuWidok i Plan bazowy: można wpisać te wartości lub kliknąć opcję Wykryj, aby za pomocą kreatora wybrać wartość z listy wartości. W przypadku użycia kreatora wykrywania kliknij opcję Dalej i wykonaj jeden z następujących kroków:
      • Kliknij przycisk Dalej, aby wybrać wartości pól Identyfikator URI modułu, Widok i Plan bazowy. Po kliknięciu przycisku Dalej w oknie Wybór widoku z bazy danych DOORS możesz dokonać odpowiedniego wyboru, korzystając z list modułów, widoków i planów bazowych. Następnie kliknij przycisk Zakończ.
      • Wprowadź wartość w polu Identyfikator URI modułu. Po wprowadzeniu identyfikatora URI modułu zostanie aktywowany przycisk Zakończ. Możesz go kliknąć, aby użyć wartości domyślnych dla widoku i planu bazowego. Aby użyć widoku i planu bazowego innych niż domyślne, w polach Widok i Plan bazowy wprowadź wartości, które mają zostać użyte w zamian, i kliknij przycisk Zakończ.
        Uwaga: W przypadku ręcznej edycji wartości pola Identyfikator URI modułu i wprowadzenia niepoprawnej wartości dane wyjściowe mogą nie zostać wygenerowane. Podanie niepoprawnej wartości lub wartości NULL w polach Widok lub Plan bazowy spowoduje, że dane wyjściowe zostaną wygenerowane na podstawie widoku standardowego bieżącej wersji modułu. Dane wyjściowe zostaną wygenerowane, ale mogą nie być poprawne.
    4. Nazwa użytkownika: wprowadź nazwę konta produktu Rational DOORS.
    5. Hasło: wprowadź hasło do konta produktu Rational DOORS.
    6. Wybierz, czy ma być używana opcja Użyj działającej instancji DOORS podczas generowania dokumentu:
      • Jeśli produkt Rational DOORS ma zostać uruchomiony w położeniu określonym w polu Ścieżka do pliku doors.exe podczas generowania dokumentu przy użyciu tej specyfikacji dokumentu, wybierz opcję Użyj działającej instancji DOORS podczas generowania dokumentu. Czas przetwarzania można skrócić, gdy używana jest uruchomiona instancja produktu Rational DOORS.
      • Jeśli produkt Rational DOORS nie ma zostać uruchomiony w położeniu określonym w polu Ścieżka do pliku doors.exe podczas generowania dokumentu przy użyciu tej specyfikacji dokumentu, usuń zaznaczenie opcji Użyj działającej instancji DOORS podczas generowania dokumentu w celu uruchomienia nowej instancji.
        Uwaga: Jeśli używana jest aplikacja usług zdalnych, właściwości doors_home i new_instance są zawsze przepisywane przez aplikację usług zdalnych. Po przesłaniu specyfikacji dokumentu produkt Rational Publishing Engine przepisuje właściwości, aby zapewnić ich zgodność z konfiguracją serwera.

    W przypadku zastąpienia niepoprawnych wartości przez produkt Rational Publishing Engine w kreatorze wartości te zostaną również zaktualizowane w widoku Właściwości dla źródła danych i w opcjach środowiska wykonawczego.

  4. W sekcji Zmienne skonfiguruj poszczególne zmienne.
    Uwaga:
    • Jeśli istnieje wartość domyślna dla zmiennej, zmienna zostanie wyświetlona jako skonfigurowana i w danych wyjściowych zostanie użyta wartość domyślna, chyba że zostanie wybrana inna wartość.
    • Jeśli po minięciu sekcji Zmienne kliknięto przycisk Wstecz, aby wprowadzić dodatkowe zmiany do zmiennej, sekcja zawsze otwiera się na pierwszej zmiennej na liście.
    1. Z menu rozwijanego wybierz jedną z następujących opcji:
      • Ręczna konfiguracja: umożliwia wybór dowolnej wartości zmiennej w przypadku braku innych informacji konfiguracyjnych dla tej zmiennej w warstwie konfiguracji lub w komponencie centralnego zarządzania
      • Z warstwy konfiguracji: umożliwia wybór wartości z metadanych konfiguracji wprowadzonych dla zmiennej w szablonie
      • Przy użyciu wartości zmiennych z biblioteki centralnej: umożliwia wybór zmiennej przechowywanej w komponencie centralnego zarządzania
    2. Wprowadź lub wybierz wartość dla konfiguracji.
    3. Kliknij przycisk Dalej.
  5. W sekcji Dane wyjściowe wybierz typy danych wyjściowych do wygenerowania:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    • Wcześniejszy PDF
    1. Opcjonalne: W polu Miejsce zapisu kliknij przycisk Przeglądaj, aby wybrać ścieżkę zapisu pliku dla każdego typu danych wyjściowych. Ścieżkę można edytować tak, aby była ścieżką względną prowadzącą od specyfikacji dokumentu. Jeśli miejsce zapisu danych wyjściowych nie zostanie określone, plik zostanie wygenerowany w położeniu tymczasowym.
    2. Opcjonalne: W przypadku pola Arkusz stylów kliknij przycisk Przeglądaj, aby wybrać arkusz stylów do użycia dla każdego typu danych wyjściowych podczas ich generowania.
    3. Opcjonalne: Tylko dane wyjściowe w formacie programu Microsoft Word: w przypadku opcji Makro wprowadź nazwę makra zawartego w arkuszu stylów.
    4. Opcjonalne: Aby wprowadzić dodatkowe metadane lub skonfigurować inne właściwości dokumentu, które nie są uwzględnione w kreatorze, kliknij przycisk Edytuj właściwości metadanych.
    5. Kliknij przycisk Dalej.
  6. Sprawdź, czy poprawne są informacje w oknie podsumowania dotyczące szablonu i danych wyjściowych.
  7. Wybierz działanie do wykonania po kliknięciu przycisku Zakończ:
    • Uruchom generowanie dokumentu: generuje określone typy danych wyjściowych.
    • Uruchom generowanie dokumentu i wyjdź z produktu RPE: generuje określone typy danych wyjściowych i zamyka aplikację Rational Publishing Engine po zamknięciu okna Wyniki.
    • Zapisz i zamknij kreator bez generowania dokumentu: kreator generowania dokumentów zostanie zamknięty, ale aplikacja Launcher pozostanie otwarta.
    Uwaga: W przypadku użycia kreatora generowania dokumentów z programu dodatkowego Rational DOORS wybranie opcji Zapisz i zamknij kreator bez generowania dokumentu powoduje zamknięcie kreatora oraz aplikacji Launcher.

Opinia