Jeśli aplikacja obsługuje interfejsy API RESTful, można utworzyć artefakty w
aplikacji na podstawie potrzeb biznesowych w produkcie
IBM® Rational Focal Point.
Na przykład można utworzyć wymagania w aplikacji Requirements Management produktu Rational solution for
Collaborative Lifecycle Management na podstawie potrzeb biznesowych w produkcie Rational Focal Point.
Zanim rozpoczniesz
- Należy upewnić się, że uzyskano odpowiednie uprawnienia dostępu do aplikacji, w której są tworzone artefakty z produktu Rational Focal Point.
- Należy dodać aplikację jako wychodzący element zaprzyjaźniony w produkcie Rational Focal Point.
Więcej informacji na ten temat zawiera sekcja Nawiązywanie połączenia z serwerem aplikacji rozwiązania Rational dla produktu Collaborative Lifecycle Management.
- Należy sprawdzić, czy treść aplikacji obsługującej interfejsy API REST jest w
formacie XML.
- Należy wziąć pod uwagę strukturę XML artefaktów aplikacji i mieć uprawnienia dostępu do nich.
Procedura
- W produkcie
Rational Focal Point
otwórz obszar roboczy.
- Kliknij opcję , a następnie kliknij przycisk Dodaj komendę wyświetlania.
- Wybierz widok, w którym ma zostać dodana komenda wyświetlania.
- W sekcji Konfiguracja komendy klienta usługi REST wykonaj następujące kroki:
- W polu Nazwa konektora klienta usługi REST wpisz nazwę identyfikującą połączenie.
- W polu Metoda żądania REST wybierz metodę
POST. Informacje na temat korzystania z poszczególnych metod zawiera sekcja Obsługiwane metody zarządzania zasobami.
- W polu Lista serwerów zaprzyjaźnionych wybierz aplikację,
która ma zostać dodana jako zaprzyjaźniona do produktu
Rational Focal Point.
- W polu Wybierz unikalny atrybut dla metody POST kliknij
przycisk
Wybierz i wybierz atrybut. Ten atrybut jest pusty. Po pierwszej operacji POST jest w nim zapisywany
adres URL odpowiedzi z aplikacji. Dlatego jeśli dla kolejnych operacji POST adres URL
jest taki sam, oznacza to, że operacja POST nie została wykonana dla tego adresu URL.
- W polu Adres URL żądania aplikacji REST wpisz adres URL
najwyższego poziomu dla obszaru aplikacji, w którym tworzone są artefakty. Na przykład w przypadku aplikacji Requirements Management należy użyć adresu URL fabryki tworzenia wymagań. Do pobrania tego adresu URL zazwyczaj używa się adresu URL usług
głównych w celu pobrania adresu URL katalogu RMCatalog. Adres URL katalogu RMCatalog umożliwia uzyskanie adresu URL obszaru projektu. Następnie można użyć adresu URL obszaru projektu do uzyskania adresu URL fabryki wymagań.
- W sekcji Konfiguracja XML szablonu klienta usługi REST, wykonaj następujące kroki:
- W polu Adres URL aplikacji usługi REST do kodu XML szablonu wpisz adres URL, który wskazuje artefakt w aplikacji, a następnie kliknij przycisk Pobierz kod XML szablonu. Kod XML zostanie załadowany w polu tekstowym Kod XML szablonu aplikacji usługi REST. Jeśli kod XML nie ma zostać załadowany dynamicznie, można go skopiować w polu tekstowym Kod XML szablonu aplikacji usługi REST.
Uwaga: W przypadku operacji POST konieczna jest znajomość struktury kodu XML aplikacji, do której są przesyłane artefakty. W ten sposób możliwe jest pobieranie kodu XML dynamicznie lub ręcznie. Po pobraniu kod XML musi obsługiwać przesyłanie nowych danych do aplikacji. Jeśli w niektórych aplikacjach kod XML tego nie obsługuje, konieczne będzie ręczne utworzenie lub zmodyfikowanie kodu XML.
- W polu Wyrażenie XPath elementu głównego artefaktu aplikacji usługi REST kliknij przycisk Wybierz i wybierz wyrażenie XPath elementu głównego dla atrybutów. Przycisk Wybierz jest włączony tylko wtedy, gdy poprawny jest kod XML w polu Kod XML szablonu aplikacji usługi REST.
- W sekcji Odwzorowanie atrybutu kliknij przycisk Dodaj i odwzoruj atrybuty produktu Rational Focal Point przy użyciu atrybutów aplikacji. Jeśli na przykład atrybut Tytuł produktu Rational Focal Point odwzorowano przy użyciu atrybutu Nazwa aplikacji, po wykonaniu operacji POST atrybut Nazwa w aplikacji zostanie zmieniony na Tytuł.
- W sekcji Odpowiedź wykonaj następujące kroki:
- W polu Kod XML szablonu aplikacji usługi REST podaj kod XML, który jest odbierany w odpowiedzi dla metody GET, lub określ dowolny inny kod XML aplikacji. W polu Główne wyrażenie XPath do artefaktu aplikacji
REST określ główne wyrażenie XPath wskazujące atrybuty, a następnie w polu
Odwzorowanie atrybutów odpowiedzi kliknij opcję
Dodaj, aby odwzorować atrybuty.
- W sekcji Odwzorowanie nagłówka odpowiedzi kliknij opcję
Dodaj, aby odwzorować nagłówek aplikacji na atrybut produktu
Rational Focal Point. Nagłówek aplikacji przechowuje kod XML tej aplikacji. Zazwyczaj w przypadku aplikacji produktu Rational solution for CLM nagłówek to Location.
- W sekcji Konfiguracja wykonaj następujące kroki:
- W polu Format daty obsługiwany przez aplikację REST wpisz
format daty używany przez aplikację zewnętrzną.
- W polu Separator produktu Focal Point wpisz wartość separatora, takiego jak przecinek (,) lub średnik (;). Elementy list MultiChoice i LinkedList będą rozdzielone określonym separatorem.
- Aby odwzorować identyfikatory atrybutów między produktem Rational Focal Point i aplikacją, w sekcji Tabela parametrów żądania kliknij opcję Dodaj, a następnie wybierz atrybut produktu Rational Focal Point.
Wpisz identyfikator aplikacji w kolumnie
Klucz. Jeśli na przykład w kolumnie Klucz zostanie wybrana opcja Identyfikator projektu dla produktu Rational Focal Point, wpisz identyfikator, który jest używany jako identyfikator projektu w aplikacji.
- W sekcji Odwzorowanie nagłówka żądania kliknij opcję Dodaj i wpisz nazwę oraz wartość nagłówka. W przypadku aplikacji produktu Rational solution for CLM używane są następujące nagłówki:
| Nazwa nagłówka |
Wartość nagłówka |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- Kliknij przycisk Zapisz.
- W menu Wyświetl wybierz widok elementów, które mają zostać użyte do tworzenia w innej aplikacji.
- W celu utworzenia wszystkich artefaktów, które są dostępne w widoku, na pasku narzędzi widoku kliknij listę rozwijaną i wybierz komendę wyświetlania POST, a następnie kliknij ikonę Wykonaj
.
- Aby utworzyć jeden artefakt, na pasku narzędzi artefaktu wybierz komendę wyświetlania
POST, a następnie kliknij ikonę Wykonaj
.