Po utworzeniu szablonu raportu i zapełnieniu go punktami danych można generować raporty w różnych formatach.
Procedura
- W aplikacji Document Studio lub w aplikacji Launcher otwórz kreator generowania dokumentów, klikając opcję .
- 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 Centralne zarządzanie.
- 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 Centralne zarządzanie
- Przy użyciu wartości źródła danych z biblioteki centralnej:
umożliwia wybór źródła danych przechowywanego w komponencie Centralne zarządzanie
- Ł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. Niezależnie od tego, czy wartość jest adresem URL, czy wartością zawierającą adres URL, typowy adres URL źródła danych dla produktu Rational Focal Point można określić przez:
- Zidentyfikowanie adresu URL schematu źródła danych używanego w celu dodania schematu do szablonu.
- Usunięcie przyrostka ?metadata=schema z adresu URL schematu źródła danych.
Przykład:
- Adres URL schematu źródła danych: http://serwer:port/fp/resources/?metadata=schema
- Adres URL źródła danych:
http://serwer:port/fp/resources/
Jeśli dane, do których planowane jest uzyskanie dostępu, znajdują się w obrębie mniejszej części schematu, można skonstruować bardziej konkretne adresy URL.
Na przykład identyfikator URI http://serwer:port/fp/resources/workspaces/4/modules/1/elements/?metadata=schema zwraca pole id wszystkich elementów zasobów kryteriów, a identyfikator http://serwer:port/fp/resources/workspaces/4/modules/1/elements/ zwraca pola id oraz summary wszystkich elementów zasobów projektu.
W przypadku korzystania z interfejsu REST API
umożliwiającego raportowanie produktu
Rational Requirements Composer
należy wprowadzić adres URL w następującym formacie:
- https://serwer:port/rm/publish/artefakt
- Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj nazwę użytkownika w polu Użytkownik.
- Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj hasło w polu Hasło.
- Z listy Typ uwierzytelniania wybierz odpowiedni typ. W przypadku produktu Rational Focal Point typ uwierzytelniania to OAuth. Jeśli typ OAuth nie zostanie wybrany, będą testowane wszystkie typy uwierzytelniania do czasu znalezienia poprawnego. Może to wydłużyć czas generowania dokumentu.
- 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 Centralne zarządzanie
- 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 Centralne zarządzanie
- 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.