Projektanci raportów mogą za pomocą aplikacji Document Studio importować schematy źródła danych i budować szablony raportów.
Zanim rozpoczniesz
Wskazówka: Instalacja produktu
Rational Publishing Engine obejmuje zestaw przykładowych raportów. Przed przystąpieniem do publikowania dokumentów można przećwiczyć ten przykładowy scenariusz generowania dokumentów. Patrz sekcja
Tworzenie
przykładowego szablonu REST.
Zapoznaj się z wymaganiami produktu
Rational RequisitePro dotyczącymi wyodrębniania danych za pomocą produktu
Rational Publishing Engine.
Aby znaleźć Centrum informacyjne danej wersji produktu
Rational RequisitePro, należy zapoznać się z sekcją
Informacje o Centrum informacyjnym produktu Rational RequisitePro.
O tym zadaniu
Dane są wyodrębniane przy użyciu interfejsu REST API.
Ten interfejs jest instalowany i implementowany przy użyciu aplikacji źródła
danych i działa niezależnie od produktu
Rational Publishing Engine.
Więcej informacji na temat interfejsu REST API dla źródła danych zawiera
dokumentacja tego źródła danych.
Procedura
- Zapoznaj się z procesem projektowania szablonu w sekcji
Projektowanie szablonów dokumentów. Rozpoczęcie planowania struktury dokumentu i danych, które może on zawierać. Określ na przykład, czy dokument końcowy ma być generowany na
podstawie jednego szablonu, czy wielu plików szablonów zawierających fragmenty
treści wielokrotnego użytku.
- W aplikacji Document Studio
utwórz
szablon dokumentu.
- Dodaj schemat źródła danych do szablonu dokumentu. W przypadku produktu Rational RequisitePro schemat źródła danych można wykryć przez wprowadzenie podstawowego adresu URL do aplikacji.
- W programie Document Studio kliknij opcję
.
- W polu Nazwa wprowadź nazwę źródła danych.
- W polu Opis wprowadź opis źródła danych.
- W polu Podstawowy adres URL określ podstawowy adres URL zasobu.
- Z listy Typ uwierzytelniania wybierz odpowiedni typ. Dla adaptera produktu
Rational RequisitePro
udostępnianego przez usługi danych konieczne jest określenie uwierzytelniania
Podstawowe.
Jeśli żaden typ nie zostanie wybrany, będą testowane wszystkie typy do czasu znalezienia typu poprawnego. Może to wydłużyć czas generowania dokumentu.
- 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.
- Kliknij przycisk Dalej. Do wprowadzonego podstawowego adresu URL automatycznie dołączany jest łańcuch ?metadata=schema.
- Kliknij przycisk Zakończ. Wybrany schemat źródła danych zostanie wyświetlony w widoku Schemat źródła danych.
- Dodaj elementy do szablonu. Produkt Rational Publishing Engine zawiera obszerny zestaw elementów szablonów, których można używać przy określaniu struktury dokumentu. Elementy te można przeciągać do edytora treści szablonu.
Na przykład można dodać element kontenera do przechowywania kilku akapitów.
Każdy akapit może być sterowany przez warunek testowy, który wiąże go tylko z konkretnymi danymi. Więcej informacji na ten temat zawierają sekcje
Elementy szablonu w widoku Paleta
i
Dodawanie elementów do szablonu.
- Użyj
zapytań,
atrybutów
i
zmiennych,
aby dodać dane do szablonu. Te elementy określają, które fragmenty informacji są generowane w raporcie.
- Dodaj
formatowanie
i style do elementów, aby umożliwić sterowanie sposobem ich wyświetlania
w danych wyjściowych.
- Utwórz
filtry,
aby zawęzić dane, które są pobierane do raportu. Istnieje możliwość używania filtrów, które są szczegółowymi wersjami ogólnego identyfikatora URI źródła danych. Pozwalają one wskazywać konkretne podzbiory danych, tak aby
produkt Rational Publishing Engine nie próbował podczas generowania raportu pobierać informacji ze
źródła danych w ilości większej niż konieczna. Te filtry muszą być na tyle ogólne, aby pobrać wszystkie niezbędne dane, do których odwołuje się szablon. W przeciwnym razie wygenerowany raport może nie zawierać kompletnego zbioru danych. W filtrach rodzimych usług REST możliwości raportowania w wersji 1
należy tylko wprowadzić tekst w nawiasach kwadratowych []. Pozostała część
filtru jest generowana przez produkt
Rational Publishing Engine. W następującym przykładzie filtru rodzimego usług REST możliwości
raportowania w wersji 1 wyodrębniany jest schemat
PRRequirements produktu
Rational RequisitePro
przy użyciu właściwości Stability='High'.
Dodanie wyrażenia filtru do węzła w obszarze urządzeń
(
Appliances) w celu wyboru wyłącznie urządzeń
wyprodukowanych przez konkretnego producenta.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
- Utwórz
sortowania,
aby uporządkować dane w raporcie. Produkt Rational RequisitePro nie obsługuje sortowań rodzimych. Zamiast tego można utworzyć
sortowanie w produkcie Rational RequisitePro:
- Utwórz tabelę i wprowadź dane.
- Posortuj dane.
- Utwórz
widok i zapisz w nim dane.
- Wyeksportuj widok do użycia jako schemat źródła danych w produkcie
Rational Publishing Engine.
Aplikacja usług danych raportowania automatycznie wykryje widok.
- Dodaj schemat źródła danych do szablonu produktu
Rational Publishing Engine.
Dane produktu
Rational RequisitePro
wygenerowane w danych wyjściowych produktu
Rational Publishing Engine
zachowują sortowanie z widoku, jednak niektóre zagnieżdżone dane mogą nie być
wyświetlane jako zagnieżdżone.