Generowanie dokumentu za pomocą kreatora generowania dokumentów

Aplikacje Launcher i Document Studio umożliwiają generowanie dokumentów.

Zanim rozpoczniesz

Każdy szablon jest domyślnie powiązany z pustą specyfikacją dokumentu. Podczas uruchamiania podglądu lub publikowania szablonu w aplikacji Document Studio można dostosować tą pustą specyfikację dokumentu lub użyć jej bez dostosowań w celu wygenerowania danych wyjściowych. Aplikacja Document Studio utrzymuje synchronizację szablonu z domyślną specyfikacją dokumentu podczas otwierania lub zapisywania szablonu.
Uwaga: Te instrukcje dotyczą większości źródeł danych, ale nie wszystkich. Instrukcje specyficzne dla danego źródła danych można znaleźć w dokumentacji źródeł danych w sekcji Integracja.

O tym zadaniu

Istnieje kilka różnych metod generowania dokumentów:

Między generowaniem dokumentów z aplikacji Launcher i z aplikacji Document Studio nie ma żadnej różnicy. Gdy dokumenty są generowane za pomocą kreatora, w obu aplikacjach udostępniane są te same opcje. W aplikacji Launcher możliwe jest jednak skonfigurowanie szczegółów generowania dokumentów w widokach Specyfikacja dokumentu i Właściwości bez stosowania kreatora.

Procedura

Aby wygenerować dokumenty z aplikacji Launcher lub Document Studio:

  1. W aplikacji Launcher lub Document Studio kliknij opcję Specyfikacja dokumentu > Generuj > Konfiguruj i generuj dokument.

    Można również kliknąć ikonę Ikona Konfiguruj i generuj dokument Konfiguruj i generuj dokument na pasku narzędzi.

    Zostanie otwarty kreator konfiguracji umożliwiający określenie dodatkowych opcji generowania dokumentu przed jego wygenerowaniem. Na pasku postępu wyświetlane są informacje, które muszą być skonfigurowane w pięciu sekcjach:
    • Szablony
    • Źródła danych
    • Zmienne
    • Dane wyjściowe
    • Podsumowanie
    Można kliknąć sekcję lub element na pasku postępu, aby przejść do danej strony w kreatorze.
    Wskazówka: O ile będzie wybrane przynajmniej jedno źródło danych oraz jeden format wyjściowy, można w dowolnym momencie kliknąć przycisk Zakończ, aby rozpocząć generowanie dokumentu, lub kliknąć przycisk Dalej, aby kontynuować pracę z kreatorem konfiguracji.
  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.
  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. Wybierz źródło danych z jednego z następujących miejsc:
      • Ręczna konfiguracja: umożliwia wybór lokalnego lub zdalnego źródła danych w przypadku braku innych informacji konfiguracyjnych dla tego źródła danych w warstwie konfiguracji lub w komponencie centralnego zarządzania
      • Przy użyciu wartości źródła danych z biblioteki centralnej: umożliwia wybór źródła danych przechowywanego w komponencie centralnego zarządzania
      • Ładuj z warstwy konfiguracji: umożliwia wybór wartości z metadanych konfiguracji wprowadzonych dla źródła danych w szablonie
    2. W zależności od opcji wybranej w poprzednim kroku można wybrać źródło danych, wprowadzając adres URL, klikając przycisk Przeglądaj, aby je odnaleźć, albo wybierając wartość z warstwy konfiguracji.
    3. Wprowadź nazwę użytkownika i hasło w celu uwierzytelnienia w aplikacji źródła danych.
    4. Wybierz typ uwierzytelniania. W przypadku braku wyboru typu zostanie przetestowany każdy typ aż do momentu znalezienia poprawnego typu, co może wydłużyć czas generowania dokumentu.
      • Automatyczny
      • Podstawowe
      • Formularz
      • OAuth
      • OAuth-OSLC
    5. Opcjonalne: Wprowadź nagłówek Accept. Wartością domyślną jest application/xml, */*.
    6. Opcjonalne: Aby zastosować wprowadzone referencje do każdego źródła danych, wybierz opcję Zastosuj te wartości nazwy użytkownika i hasła do każdego skonfigurowanego i nieskonfigurowanego źródła danych.
    7. Kliknij przycisk Dalej.
  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. 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 zamknij program RPE: generuje określone typy danych wyjściowych i zamyka aplikację Rational Publishing Engine po zamknięciu okna Wyniki.
    • Zamknij ten kreator i otwórz klient produktu RPE: otwiera specyfikację dokumentu ze szczegółami wprowadzonymi w aplikacji Launcher.
  8. Kliknij przycisk Zakończ.
    Wskazówka: W przypadku zdalnego generowania dokumentu można zamknąć aplikację Document Studio lub Launcher przed zakończeniem generowania dokumentu bez przerywania procesu generowania. W przypadku lokalnego generowania dokumentu nie należy zamykać aplikacji Document Studio lub Launcher do momentu zakończenia generowania dokumentu.

Wyniki

Specyfikacja dokumentu została załadowana w aplikacji Launcher i generuje lub zapisuje dokument w zależności od wybranych opcji.

Opinia