Projektanci raportów mogą za pomocą aplikacji Document Studio importować schematy źródła danych i budować szablony raportów.
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.
- Zidentyfikuj schemat źródła danych w źródle danych. Schemat źródła danych dla produktu
Rational Tau
można zidentyfikować za pomocą jednej z następujących metod:
- Użycie wygenerowanego wstępnie schematu produktu
Rational Tau
dostarczonego z produktem Rational Publishing Engine.
Ten schemat źródła danych znajduje się w położeniu
RPE_HOME\source\Tau\schema\ttdMetamodel.xsd.
- Wygenerowanie schematu źródła danych z projektu UML produktu Rational Tau. Więcej informacji na ten temat zawiera sekcja
Pobieranie schematu źródła danych produktu Rational Tau.
- Dodaj schemat źródła danych do szablonu dokumentu. W przypadku produktu Rational Tau,
można wykonać następujące kroki:
- W programie Document Studio kliknij opcję .
- W polu Typ schematu wybierz z listy typ
schematu. W przypadku produktu
Rational Tau
należy wybrać opcję Tau.
- W polu Plik schematu kliknij przycisk
Przeglądaj i wybierz schemat źródła danych
określony w poprzednim kroku. Przykład:
RPE_HOME\source\Tau\schema\ttdMetamodel.xsd
- W polu Identyfikator źródła danych
wpisz nazwę źródła danych w szablonie. Kliknij przycisk
Dalej.
- 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. 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.
- 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. Zapytania w produkcie
IBM Rational Tau
mają składnię podobną do składni wyrażeń XPath. Jednak w przeciwieństwie do
wyrażeń XPath zapytanie produktu
Rational Publishing Engine
nie określa filtru. Filtr i klauzule sortowania są oddzielone od zapytania. Każdy element schematu, z wyjątkiem zapytania, jest definiowany za pomocą
zapytania rodzimego produktu
Rational Tau. To zapytanie, które jest wyrażone w języku OCL, pobiera dane produktu
Rational Tau.
Na przykład element główny w ramach elementu modelu model.rootResource ma
przyłączone zapytanie
GetModelRoots() produktu
Rational Tau.
Uwaga: - Nie można utworzyć atrybutów niestandardowych w schematach źródła
danych produktu
Rational Tau.
- Nie można wyświetlić podglądu produktu
Rational Tau
z aplikacji Launcher ani Document
Studio.
- 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. Więcej informacji na ten temat zawiera sekcja Warunki filtru obsługiwane przez filtry rodzime usług REST.
- Aby doprecyzować wyniki zapytania, można zastosować filtr zapytania rzutującego. Funkcja rzutowania typów działa jako filtr alternatywny dla elementów
źródła danych. Szczegóły zawierają sekcje
Rzutowanie typów
i
Atrybuty produktu Rational Tau.
- Utwórz
sortowania,
aby uporządkować dane w raporcie. Źródło danych produktu
Rational Tau
nie obsługuje sortowania rodzimego. Należy użyć sortowania produktu
Rational Publishing Engine.
Przykład
Tabela 1. Przykład dokumentu opartego na wielu szablonach
produktu Rational TauNazwa pliku szablonu |
Treść szablonu |
Instrukcja użycia |
titlePage.dta |
Strona tytułowa, spis treści |
Generuje stronę tytułową na podstawie właściwości modułu |
Preamble.dta |
Rozdziały wstępu |
Uwzględnia plik programu Microsoft Word
z rozdziałami wstępu |
Requirements.dta |
Wymagania systemowe |
Generuje listę wymagań systemowych na podstawie danych ze źródła danych |
userRequirements.dta |
Wymagania dotyczące użytkownika |
Generuje listę wymagań dotyczących użytkownika na podstawie danych ze źródła danych |
Design.dta |
Informacje dotyczące modelowania |
Generuje listę informacji z modelu UML na podstawie danych ze źródła danych |