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:
- Dokumenty mogą być generowane w aplikacjach Launcher i Document Studio. W zadaniu poniżej przedstawiono sposób generowania dokumentów z interfejsu użytkownika aplikacji.
- W położeniu specyfikacji dokumentu w systemie plików można kliknąć plik prawym przyciskiem myszy, a następnie kliknąć opcję Publikuj za pomocą produktu Rational Publishing Engine.
Wszystkie błędy zostaną pominięte w celu wygenerowania dokumentu.
- Dokumenty można również publikować z poziomu interfejsów użytkownika produktów
Rational DOORS i
Rational Tau z zainstalowanymi programami dodatkowymi.
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:
- W aplikacji Launcher lub Document Studio kliknij opcję .
Można również kliknąć ikonę
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.
- W sekcji Szablony zostaną wyświetlone szablony już wymienione w specyfikacji dokumentu.
Aby dodać szablon:
- 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.
- 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.
- Opcjonalne: Powtórz powyższe kroki, aby dodać kolejne szablony z innych miejsc.
- Opcjonalne: Zmień kolejność szablonów w specyfikacji dokumentu, wybierając szablon i klikając opcję W górę lub W dół.
- Kliknij przycisk
Dalej.
- 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.
- 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
- 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.
- Wprowadź nazwę użytkownika i hasło w celu uwierzytelnienia w aplikacji źródła danych.
- 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
- Opcjonalne: Wprowadź nagłówek Accept. Wartością domyślną jest application/xml, */*.
- 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.
- Kliknij przycisk Dalej.
- 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.
- 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
- Wprowadź lub wybierz wartość dla konfiguracji.
- Kliknij przycisk
Dalej.
- W sekcji Dane wyjściowe wybierz typy danych wyjściowych do wygenerowania:
- Microsoft Word
- PDF
- HTML
- XSL-FO
- Wcześniejszy PDF
- 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.
- 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.
- Opcjonalne: Tylko dane wyjściowe w formacie programu Microsoft Word: w przypadku opcji Makro wprowadź nazwę makra zawartego w arkuszu stylów.
- 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.
- Kliknij przycisk
Dalej.
- Sprawdź, czy poprawne są informacje w oknie podsumowania dotyczące
szablonu i danych wyjściowych.
- 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.
- 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.