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. Po dodaniu szablonu źródła danych i zmienne określone w szablonie
są również dodawane do kreatora.
- 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. Ś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.
- 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 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.
- 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.
Co dalej
Aby zidentyfikować problemy, należy przejrzeć
informacje dotyczące generowania dokumentów w widoku Konsola lub Problemy. Po
naprawieniu problemów należy ponownie wygenerować dane wyjściowe.
Po
skonfigurowaniu generowania dokumentu w przypadku kolejnych operacji
generowania dokumentu można kliknąć opcję , aby wygenerować dokument bez wykonywania
kroków kreatora konfiguracji.