Projektowanie szablonów z produktem Rational DOORS Next Generation 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. Możliwości udostępniane przez aplikację Requirements Management (RM) są licencjonowane jako produkt IBM® Rational DOORS Next Generation. Informacje dotyczące integracji aplikacji RM dotyczą produktu Rational DOORS Next Generation i konkretnych wersji produktu IBM Rational Requirements Composer.

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. Więcej informacji na ten temat zawiera sekcja Tworzenie przykładowego szablonu REST.
Zapoznaj się z usługą REST aplikacji Requirements Management i różnymi adresami URL, które są potrzebne, aby wyodrębnić dane z aplikacji Requirements Management podczas używania produktu Rational Publishing Engine. Aby znaleźć Centrum informacyjne danej wersji aplikacji Requirements Management, należy zapoznać się z dokumentacją produktu Rational DOORS Next Generation.

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

  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. Aby dodać konkretne elementy danych z projektu aplikacji Requirements Management, należy wprowadzić adres URL w następującym formacie:
    • https://serwer:port/rm/publish/artefakt
    Przykład:
    • https://serwer:port/rm/publish/resources
  4. Dodaj schemat źródła danych do szablonu dokumentu. W przypadku aplikacji Requirements Management 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ę Tekst DNG lub Moduł DNG.
    3. W polu Typ wybierz typ schematu z listy. Dla aplikacji Requirements Management należy wybrać opcję Ogólny XML.
    4. Edytuj pole Schemat, jeśli jest to konieczne, lub kliknij przycisk Przeglądaj, aby wybrać ścieżkę dla pliku schematu. Przykład: https://serwer:port/rm/publish/artefakt?metadata=schema.

      W przypadku produktu CLM 6.0.2 lub nowszych można pobrać odsyłacz trwały, klikając ikonę Pokaż odsyłacz trwały znajdującą się na końcu ścieżki nawigacyjnej artefaktu w produkcie Rational DOORS Next Generation. Adres URL jest wyświetlany w oknie Pokaż odsyłacz trwały. Wklej adres URL w polu Schemat i dodaj wartość &metadata=schema na końcu adresu URL.

    5. (Tylko profil POX - dla produktu CLM 6.0.2 i nowszych). Wybierz nagłówek profilu POX w polu Dodatkowe nagłówki. Więcej informacji na temat profilu POX zawiera sekcja Tworzenie dokumentów śledzenia w aplikacjach CLM za pomocą profilu POX.
    6. Kliknij przycisk Dalej, a następnie przycisk Zakończ.
    7. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj nazwę użytkownika w polu Użytkownik.
    8. Jeśli zasób znajduje się na zabezpieczonym serwerze, podaj hasło w polu Hasło.
    9. Z listy Typ uwierzytelniania wybierz odpowiedni typ. W przypadku aplikacji Requirements Management 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.
  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.
    Elementy tabeli
    Gdy dane tabeli są wprowadzane z aplikacji RM, szerokości należy określić na poziomie kolumny (tzn. dla każdej komórki), a nie na poziomie tabeli, aby produkt Rational Publishing Engine mógł je przetworzyć.
  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.
  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 Źródła danych produktu Rational Requirements Composer.
  9. Utwórz sortowania, aby uporządkować dane w raporcie.