Przykład: pobieranie artefaktów z aplikacji obsługujących interfejsy API zgodne ze specyfikacją REST

W tym przykładzie opisano sposób pobierania artefaktów z aplikacji Requirements Management produktu Rational solution for Collaborative Lifecycle Management i tworzenia składników w produkcie IBM® Rational Focal Point.

Przeznaczenie

Jeśli w aplikacji Requirements Management istnieją wymagania, dla których w produkcie Rational Focal Point ma zostać określony priorytet, do pobrania wymagań można użyć opcji Komenda wyświetlania klienta usługi REST.
Wymaganie wstępne:
  • W pliku hosta komputera, z poziomu którego jest konfigurowana integracja, ustaw adres IP i nazwę hosta produktu Rational solution for CLM. W systemie Windows plik hosta znajduje się zwykle w katalogu C:\Windows\System32\drivers\etc, a w systemie Linux plik ten reprezentuje ścieżka /etc/hosts.
  • W produkcie Rational Focal Point dodaj aplikację Requirements Management jako opcję Elementy zaprzyjaźnione (wychodzące). Więcej informacji na ten temat zawiera sekcja Nawiązywanie połączenia z serwerem aplikacji rozwiązania Rational dla produktu Collaborative Lifecycle Management.
  • Pamiętaj o strukturze danych XML artefaktów aplikacji Requirements Management i uzyskaj prawa dostępu do nich.

Przykład

W tym przykładzie przyjęto, że produkt Rational Focal Point zawiera obszar roboczy FP-RRC oraz widok Wyświetlanie wymagań RRC. W tabeli pokazano niektóre atrybuty dostępne w produkcie Rational Focal Point oraz aplikacji Requirements Management.
Tabela 1. Atrybuty produktu Rational Focal Point i aplikacji Requirements Management
Atrybuty produktu Rational Focal Point Atrybuty aplikacji Requirements Management
Wybór paliwa rrm:description
Zużycie paliwa rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Połączenie integracyjne rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Tytuł ds:location/ds:project/rrm:title
  1. W produkcie Rational Focal Point otwórz obszar roboczy FP-RRC, w którym mają zostać pobrane artefakty.
  2. Kliknij opcję Konfiguracja > Komenda wyświetlania klienta usługi REST, a następnie opcję Dodaj komendę wyświetlania.
  3. W polu Nazwa konektora klienta usługi REST wpisz nazwę Konektor RRC w celu identyfikacji połączenia.
  4. W polu Metoda żądania usługi REST wybierz metodę GET.
  5. W polu Lista serwerów zaprzyjaźnionych wybierz opcję RRC.
  6. W polu Adres URL żądania aplikacji usługi REST wpisz adres URL aplikacji, która zawiera artefakty do pobrania. Aby na przykład uzyskać artefakty z aplikacji Requirements Management, wpisz adres URL https://<nazwa_hosta>:<numer_portu>/rm/<nazwa_projektu>/<nazwa_kolekcji>.
    Wskazówka: Po otwarciu przeglądarki WWW należy wpisać adres URL, który został użyty podczas dodawania aplikacji Requirements Management jako serwera zaprzyjaźnionego. Zostanie wyświetlona lista artefaktów wysokiego poziomu. Po znalezieniu artefaktu do pobrania należy skopiować jego adres URL w polu Adres URL żądania aplikacji usługi REST.
  7. Kliknij przycisk Połącz.
  8. Kliknij Wybierz wyrażenie XPath elementu głównego, aby ograniczyć wyszukiwanie artefaktów do kolekcji. Wybierz wyrażenie /ds:dataSource/ds:artifact. Wyrażenie XPath służy do zawężenia wyszukiwania do artefaktów. Wyrażenia XPath to hierarchiczna struktura danych XML aplikacji.
  9. Aby zapewnić, że artefakty nie są duplikowane, w sekcji Odwzorowanie identyfikatorów kliknij przycisk Dodaj i odwzoruj atrybut Wybór paliwa produktu Rational Focal Point oraz atrybut rrm:description aplikacji Requirements Management. Odwzorować można tylko jeden atrybut.
  10. W sekcji Odwzorowywanie atrybutów kliknij przycisk Dodaj, aby odwzorować poniższe atrybuty między aplikacją Requirements Management i produktem Rational Focal Point. Odwzorowane atrybuty są wyświetlane przy składniku pobranym z aplikacji. Upewnij się, że atrybuty mogą być edytowane.
    Uwaga: Atrybut wybrany w sekcji Odwzorowanie identyfikatorów nie jest wyświetlany w sekcji Odwzorowywanie atrybutów, ponieważ ten atrybut jest wewnętrznie odwzorowywany i dostępny dla pobranych składników.
    Tabela 2. Odwzorowywanie atrybutów między produktem Rational Focal Point i aplikacją Requirements Management
    Atrybuty produktu Rational Focal Point Atrybuty aplikacji Requirements Management
    Zużycie paliwa rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Połączenie integracyjne rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Tytuł ds:location/ds:project/rrm:title
  11. W polu Obsługiwany format daty aplikacji usługi REST wpisz datę 2012-08-18.
  12. W polu Separator produktu Focal Point zachowaj znak , bez zmian.
  13. Kliknij przycisk Zapisz.
  14. Otwórz widok Wyświetlanie wymagań RRC i wybierz pozycję Konektor RRC z listy rozwijanej. Lista wymagań oraz atrybuty są pobierane i tworzone jako składniki widoku.

Opinia