Tworzenie dokumentów śledzenia w aplikacjach CLM za pomocą profilu POX

Tworzenie dokumentów śledzenia w aplikacjach CLM jest teraz łatwiejsze niż kiedykolwiek. Istnieje możliwość skonfigurowania adresów URL OSLC pod kątem zwracania danych możliwości raportowania w reprezentacji REST, jeśli do żądania zostanie dodany specjalny nagłówek w języku POX (Plain Old XML).

Zanim rozpoczniesz

Należy zainstalować produkt Rational Publishing Engine 2.1.0 lub nowszy i produkt Rational solution for CLM 6.0.2 lub nowszy.

O tym zadaniu

Wcześniej trudno było tworzyć dokumenty śledzenia, ponieważ niektóre aplikacje, na przykład Rational Quality Manager i Rational Team Concert, używały adresów URL OSLC, a produkt Rational Publishing Engine wymagał adresów URL REST możliwości raportowania. Komplikowało to projektowanie szablonów, ponieważ konieczne było przekształcanie tych adresów URL z formatu OSLC do formatu REST możliwości raportowania. Czasami reprezentacja OSLC artefaktu nie zawierała wszystkich informacji wymaganych do wygenerowania dokumentu, na przykład tekstu formatowanego.

Profil POX umożliwia korzystanie z adresów URL OSLC w taki sposób, jakby były one adresami URL interfejsu REST API możliwości raportowania. Profilu POX można używać w produkcie Rational Publishing Engine do tworzenia i odbierania żądań dotyczących danych REST możliwości raportowania, podając dodatkowy nagłówek. Nie trzeba już przekształcać adresów URL ani duplikować żądań. Po dodaniu tego nagłówka usługa generowania dokumentów zwróci dodatkowy kod XML.

Przykład: Tworzenie dokumentu śledzenia produktu Rational DOORS Next Generation przeznaczonego dla produktu Design Management

Procedura

  1. W programie Document Studio dodaj schemat produktu Rational DOORS Next Generation.
  2. Utwórz elementy szablonu służące do drukowania informacji pochodzących z artefaktu.
    Element produktu DNG
  3. Podaj ponownie informacje o odsyłaczu w wymaganiu.
    Odsyłacz produktu DNG
  4. W produkcie Design Management skopiuj adres URL artefaktu, klikając ikonę Pokaż odsyłacz trwały w ścieżce nawigacyjnej.
  5. W programie Document Studio otwórz kreator dodawania schematu źródła danych.
  6. (Nowy). Wklej adres URL w polu Schemat i dodaj łańcuch &metadata=schema na jego końcu.
  7. (Nowy). W polu Dodatkowe nagłówki wybierz nagłówek profilu POX.
    Dodawanie schematu produktu DM za pomocą profilu POX
  8. Kliknij przycisk Dalej, a następnie przycisk Zakończ.
  9. Utwórz w szablonie elementy szablonu z odsyłaczem prowadzącym do produktu Rational DOORS Next Generation. Otwórz okno Konfiguracja źródła danych w widoku Właściwości i kliknij kartę Konfiguracja dynamiczna:
    1. (Nowy). W polu Identyfikator URI wprowadź element href z produktu Rational DOORS Next Generation.
    2. (Nowy). W polu Akceptuj nagłówek wprowadź wartość application/xml.
    3. (Nowy). W polu Dodatkowe nagłówki wybierz odsyłacz do profilu POX. Dzięki wartości w polu Dodatkowe nagłówki aplikacja może odpowiadać za pomocą informacji REST możliwości raportowania, nawet jeśli używany jest adres URL OSLC.
      Konfiguracja źródła danych dla profilu POX
  10. Utwórz elementy szablonu służące do drukowania informacji o produkcie Design Management.
    Element produktu DM
  11. Przejdź do programu RPE Launcher w celu wygenerowania dokumentu.
  12. W widoku Specyfikacja dokumentu kliknij prawym przyciskiem myszy źródło danych produktu Rational DOORS Next Generation i wybierz opcję Konfiguruj źródło danych.
    1. Adres URL: wprowadź adres URL odsyłacza trwałego z produktu Rational DOORS Next Generation.
    2. Jeśli to konieczne, podaj nazwę użytkownika i hasło.
    3. Uwierzytelnianie: wybierz opcję OAuth.
    4. Akceptuj nagłówek: wprowadź wartość application/xml.
    5. (Nowy). Dodatkowe nagłówki: wybierz odsyłacz do profilu POX, aby żądać danych REST możliwości raportowania z produktu Rational DOORS Next Generation.
  13. Na głównym pasku narzędzi kliknij przycisk Generuj dokument. W widoku Konsola można zauważyć, że produkt Rational Publishing Engine żąda danych z produktów Design Management i Rational DOORS Next Generation przy użyciu adresów URL OSLC. Produkty Design Management i Rational DOORS Next Generation przekierowują na adresy URL REST możliwości raportowania. Dokument wyjściowy zawiera wymaganie z produktu Rational DOORS Next Generation i powiązane dane modelu z produktu Design Management.
    Wynik zawierający dane produktu DNG i dane produktu DM