Tworzenie raportu do użycia w zintegrowanym produkcie Rational Reporting for Document Generation

Produktu Rational Publishing Engine można używać do projektowania raportów na podstawie danych udostępnianych przez produkty i aplikacje zawierające komponent Rational Reporting for Document Generation, takie jak aplikacje Rational solution for Collaborative Lifecycle Management. Te szablony można importować do produktów lub aplikacji do użycia w ich interfejsach.

Zanim rozpoczniesz

Przed rozpoczęciem korzystania z produktu Rational Publishing Engine w celu dostosowywania raportów należy skonfigurować serwer kluczy licencyjnych z ważnymi licencjami. Należy skontaktować się z administratorem, aby sprawdzić, czy zostało to wykonane oraz aby określić ścieżkę do serwera licencji. Jeśli produkt Rational Publishing Engine nie jest jeszcze zainstalowany, użytkownik lub administrator musi zainstalować ten produkt i sprawdzić, czy możliwe jest nawiązane połączenia z serwerem licencji.

Należy określić wersję programu Rational Reporting for Document Generation, która jest dołączona do produktu zintegrowanego (lub "dostawcy danych"). Ta wersja określa, która wersja szablonu musi być używana podczas projektowania szablonów raportu dla produktu. Należy zapoznać się z ograniczeniami dotyczącymi kompatybilności w przypadku nowszych wersji produktu Rational Publishing Engine ze starszymi wersjami programu Rational Reporting for Document Generation.

Informacje pomocnicze:

Procedura

Produkt Rational Publishing Engine udostępnia możliwość tworzenia treści nowych szablonów raportów w stylu dokumentów.Istnieje możliwość projektowania szablonów, w których gromadzone są dane i tworzone są raporty dotyczące tych danych w produkcie lub aplikacji. Jeśli produkt lub aplikacja zawiera program Rational Reporting for Document Generation, te szablony można zaimportować i wygenerować raporty w stylu dokumentów w ramach kontekstu produktu lub aplikacji.

Licencja produktu Rational Publishing Engine jest wymagana do tworzenia szablonów. Licencja produktu Rational Publishing Engine nie jest wymagana do importowania szablonów i generowania raportów na ich podstawie w ramach kontekstu produktu lub aplikacji zawierającej program Rational Reporting for Document Generation.

Pojęcia dodatkowe
Aby utworzyć w produkcie Rational Publishing Engine raporty korzystające z danych produktu lub aplikacji, wykonaj następujące kroki:

1: Nawiąż połączenie z produktem Rational Publishing Engine

Jeśli produkt Rational Publishing Engine nie jest jeszcze zainstalowany, użytkownik lub administrator musi zainstalować go, a następnie nawiązać połączenie z serwerem licencji. Do importowania źródeł aplikacji oraz budowania szablonów raportów można używać programu Document Studio produktu Rational Publishing Engine. Można również używać aplikacji Launcher produktu Rational Publishing Engine do budowania specyfikacji dokumentów uwzględniających szablony raportów oraz do generowania raportów.

2. Zaprojektuj szablony raportów

Ważne: Należy użyć wersji szablonu, która jest obsługiwana przez wersję programu Rational Reporting for Document Generation dołączoną do produktu zintegrowanego (lub "dostawcy danych"). Aby określić, która wersja jest dołączona, należy skontaktować się z administratorem raportów produktu. Szczegółowe informacje zawiera sekcja Zgodność wersji.
  1. Uruchom produkt Rational Publishing Engine Document Studio, aby zbudować projekt szablonu raportu.
  2. Utwórz lub zaimportuj projekt szablonu. Ten projekt określa układ raportu. Produkt Rational Publishing Engine jest dostarczany wraz z zestawem przykładowych raportów i kursów, które można przeglądać.
    Ważne: Należy zaktualizować numer wersji szablonu w interfejsie API ładowania szablonu, tak aby używana wersja była kompatybilna z dostawcą danych. Jeśli określono nową wersję szablonu i otwarto starszy szablon, wersja szablonu zostanie zaktualizowana dla tego szablonu.
Dodatkowe pojęcia w Centrum informacyjnym produktu Rational Publishing Engine:
Dodatkowe czynności w Centrum informacyjnym produktu Rational Publishing Engine:
Szablony importu i metadanych:

3. Nawiąż połączenie ze źródłem danych aplikacji

Określ schemat źródła danych, które ma zostać zaimportowane. Istnieje możliwość użycia elementów w schemacie w celu dodania do szablonu zapytań dotyczących danych aplikacji. Te zapytania określają, jakie elementy informacji są generowane w raporcie.
  1. Przejrzyj dostępne schematy danych, które mają być używane w raporcie. Każdy produkt ma unikalny schemat lub zbiór schematów.
  2. Skonstruuj adres URL wskazujący schemat źródła danych.
  3. Dodaj nowe źródło danych w produkcie Document Studio.
Dodatkowe czynności w Centrum informacyjnym produktu Rational Publishing Engine:

4. Dodaj zapytania o dane oparte na aplikacji do szablonu

Użyj aplikacji Document Studio w celu dodania danych ze źródeł danych do istniejącego szablonu projektu raportu. Dodawane zapytania o dane określają, jakie elementy danych są generowane w poszczególnych częściach danych wyjściowych raportu. Należy wybrać punkty danych w widoku Schematy źródeł danych oraz dodać je w kolejności hierarchicznej do szablonu.
Dodatkowe pojęcia w Centrum informacyjnym produktu Rational Publishing Engine:
Dodatkowe czynności w Centrum informacyjnym produktu Rational Publishing Engine:

5. Utwórz specyfikację dokumentu

Po zakończeniu tworzenia szablonu raportu i zapełnieniu go punktami danych aplikacji można wygenerować raport w różnych formatach. Podczas generowania raportu konieczne jest nawiązanie połączenia ze źródłem danych zawierającym informacje, których ma dotyczyć raport. Należy to zrobić, określając identyfikator URI wskazujący repozytorium aplikacji zawierające odpowiednie dane.

Istnieje możliwość używania filtrów, które są konkretnymi 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ć większej niż konieczna ilości informacji z repozytorium aplikacji. 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 będzie niekompletny.

  1. Określ szablon do uwzględnienia w raporcie.
  2. Określ format wyjściowy i położenie.
  3. Określ identyfikator URI źródła danych. Istnieje możliwość wskazania ogólnego źródła danych, co powoduje pobranie wszystkich powiązanych danych z repozytorium. Można również opcjonalnie użyć filtrów, które są bardziej konkretnymi identyfikatorami URI, określającymi parametry pozwalające pobrać mniejszy zbiór danych z repozytorium.
  4. Wprowadź identyfikator URI źródła danych.
  5. Opcjonalnie: wprowadź referencje logowania, aby uzyskać dostęp do określonego źródła danych. Jeśli ta specyfikacja dokumentu ma być współużytkowana z innymi użytkownikami, warto pozostawić pole referencji puste. Jeśli referencje nie zostaną określone, a użytkownik podejmie próbę uruchomienia raportu na podstawie specyfikacji dokumentu, zostanie poproszony o podanie referencji. Jeśli referencje zostaną określone, a użytkownik podejmie próbę uruchomienia raportu, do uzyskania dostępu do repozytorium wykorzystywane są zapisane referencje, nawet jeśli nie są to referencje tego użytkownika.
Dodatkowe pojęcia w Centrum informacyjnym produktu Rational Publishing Engine:

6: Wygeneruj raport

Istnieje możliwość generowania raportów ze specyfikacji dokumentów. Podczas generowania raportu użytkownik musi być połączony ze źródłami danych, które udostępniają dane na potrzeby raportu. Informacje na temat generowania dokumentów przy użyciu produktu Rational Publishing Engine zawiera sekcja Definiowanie specyfikacji dokumentów bez użycia kreatora generowania dokumentów.

7. Zaimportuj niestandardowy raport w stylu dokumentu

Ten raport można zaimportować do aplikacji, a następnie użytkownicy mogą generować raporty w stylu dokumentów przy użyciu kreatora Tworzenie raportu w interfejsie WWW. Więcej informacji na temat importowania raportu zawiera Centrum informacyjne produktu.


Opinia