Produkt IBM® Rational ClearQuest można zdefiniować jako źródło danych w produkcie IBM Rational Publishing Engine.
Uwaga: Należy zainstalować i wdrożyć usługi danych produktu
Rational Publishing Engine z adapterem produktu
Rational ClearQuest.
Patrz:
Wdrażanie aplikacji Data Services.
Zanim rozpoczniesz
- Zapoznaj się z usługą REST produktu Rational ClearQuest i różnymi adresami URL, które są potrzebne, aby wyodrębnić dane z produktu Rational ClearQuest przy użyciu produktu Rational Publishing Engine.
Patrz temat Informacje o Centrum informacyjnym produktu Rational ClearQuest.
- Nawiąż połączenie ze schematem źródła danych. Patrz sekcja Dodawanie schematu źródła danych.
- Schemat może znajdować się w lokalnym systemie plików. Produkt
Rational Publishing Engine
używa usług danych produktu Rational do wykrywania schematu i realizowania
zapytań dotyczących danych. Podczas wykrywania danych można używać następującego adresu URL: https://serwer:port/DataServices/ClearQuest.
Patrz sekcja Dodawanie schematu źródła danych REST przy użyciu kreatora wykrywania schematów.
- Schemat może mieć dowolny identyfikator URI, który jest dostępny z komputera. Istnieje możliwość utworzenia adresu URL, który wskazuje schemat źródła danych. Otwórz schemat źródła danych i pobierz z pliku XML identyfikator URI określonego zasobu. Dodaj łańcuch ?metadata=schema na końcu identyfikatora URI. Przykład: https://serwer:port/service/cq/records/defects?metadata=schema.
- W przypadku najnowszych wersji produktu Rational ClearQuest do utworzenia schematu źródła danych można również użyć funkcji wykrywania schematów REST w wersji 2. Patrz sekcja Dodawanie schematu źródła danych REST przy użyciu kreatora wykrywania schematów.
Uwaga: Gdy
jest używana funkcja wykrywania schematu REST w wersji 2, produkt
Rational Publishing Engine
nie potrzebuje usług danych produktu Rational. Produkt Rational Publishing Engine może wykryć schemat z produktu Rational ClearQuest za pomocą funkcji wykrywania zasobów REST w wersji 2 uruchomionej z adresu URL elementu ServiceProvider.
Użytkownicy mogą uzyskać adres URL elementu ServiceProvider,
odwiedzając adres URL Rational
ClearQuest REST 2
elementu ServiceCatalog, na przykład
https://serwer:port/context/oslc.
Należy ustawić nagłówki HTTP OSLC-Core-Version na wartość 2.0 i zaakceptować application/rdf+xml. W zwróconym wyniku można znaleźć adres URL elementu ServiceProvider - rdf:about.
- W przypadku używania interfejsów API REST 2 do generowania dokumentu konieczne jest udostępnienie adresu URL schematu źródła danych wskazującego dostawcę usług, a nie
główny wpis. Przykład:
- Niepoprawny: https://serwer:port/cqweb/oslc
- Poprawny: https://serwer:port/cqweb/oslc/repo/repozytorium/db/repozytorium_schematów/
- Po nawiązaniu połączenia ze schematem źródła danych można utworzyć lub zaimportować projekt szablonu. Za pomocą produktu Rational Publishing Engine Document Studio można zbudować projekt szablonu raportu. Ten projekt określa układ raportu. Tworzenie szablonów za pomocą aplikacji Document Studio.
- Zaplanuj strukturę dokumentu i zdefiniuj treść do wyodrębniania danych. Przegląd procesu projektowania szablonu jest zawarty w sekcji Projektowanie szablonów dokumentów. W przypadku dużych dokumentów można tworzyć osobne szablony dla każdego bloku dokumentu.
- 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.
Więcej szczegółów zawiera sekcja Elementy szablonu w widoku Paleta.
- Używaj zapytań, atrybutów i zmiennych w celu dodawania danych do szablonu.
- Za pomocą elementu Konfiguracja źródła danych można zdefiniować niektóre właściwości, które nie są znane w czasie wykonywania. Patrz sekcja Dodawanie elementu konfiguracji źródła danych.
- 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 produktu Rational ClearQuest. 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 nie będzie zawierać kompletnego zbioru danych. Patrz sekcja Wyodrębnianie danych przy użyciu filtrów rodzimych.
- Po utworzeniu szablonu raportu i zapełnieniu go punktami danych produktu Rational ClearQuest można generować raporty w różnych formatach. Podczas generowania raportu użytkownik musi być połączony ze źródłem danych. Informacje na temat wskazywania odpowiednich danych zawiera sekcja Nawiązywanie połączenia ze źródłem danych.
- Jeśli schematy źródła danych zostają dodane do szablonu po przypisaniu tego szablonu do specyfikacji dokumentu, specyfikacja dokumentu staje się niezsynchronizowana. Można zsynchronizować specyfikację dokumentu ręcznie lub wybrać opcję preferencji zapewniającą automatyczną synchronizację specyfikacji dokumentu z bieżącym szablonem. Informacje na temat ustawiania preferencji Czy utrzymać synchronizację specyfikacji dokumentu z bieżącym szablonem? zawiera sekcja Ustawianie preferencji projektowania dokumentów.
- Przed opublikowaniem dokumentu należy zapoznać się z tematem Określanie właściwości danych wyjściowych, aby uzyskać więcej informacji o dostępnych opcjach wyjściowych oraz o tym, które z nich są najlepsze w przypadku elementów używanych w szablonie.
- Można w tej chwili opublikować dokument. Patrz sekcja Generowanie dokumentu.