Projektowanie szablonów z produktem Rational Tau jako źródłem danych

Projektanci raportów mogą za pomocą aplikacji Document Studio importować schematy źródła danych i budować szablony raportów.

Zanim rozpoczniesz

Zapoznaj się z modelem UML produktu Rational Tau i schematami produktu Rational Tau, które są potrzebne do wyodrębniania danych z produktu Rational Publishing Engine. Aby znaleźć Centrum informacyjne danej wersji produktu Rational Tau, należy zapoznać się z sekcją Informacje o Centrum informacyjnym produktu Rational Tau i produktu Rational DOORS Analyst.

Procedura

  1. 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.
  2. W aplikacji Document Studio utwórz szablon dokumentu.
  3. 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.
  4. Dodaj schemat źródła danych do szablonu dokumentu. W przypadku produktu Rational Tau, można wykonać następujące kroki:
    1. W programie Document Studio kliknij opcję Dane > Dodaj schemat źródła danych.
    2. W polu Predefiniowane wybierz opcję Tau.
    3. W polu Typ wybierz typ schematu z listy. W przypadku produktu Rational Tau należy wybrać opcję Tau.
    4. Edytuj pole Schemat, jeśli jest to konieczne, lub kliknij przycisk Przeglądaj, aby wybrać ścieżkę dla pliku schematu. Przykład: RPE_HOME\source\Tau\schema\ttdMetamodel.xsd
    5. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj nazwę użytkownika w polu Użytkownik.
    6. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj hasło w polu Hasło.
    7. 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.
  5. 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.
  6. 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.
  7. Dodaj formatowanie i style do elementów, aby umożliwić sterowanie sposobem ich wyświetlania w danych wyjściowych.
  8. 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.
  9. 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.
  10. 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 Tau
Nazwa 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

Opinia