Wysyłanie żądań usług przy użyciu plików WSDL

Użytkownicy mogą wysyłać żądania do usług SOAP, JMS (Java Messaging Service), WebSphere MQ oraz Microsoft .NET, które korzystają z pliku WSDL (Web Service Description Language) do podawania treści żądania usługi.

Zanim rozpoczniesz

Upewnij się, że masz poprawny plik WSDL, który jest dostępny w systemie plików, w obszarze roboczym, pod konkretnym adresem URL, w repozytorium IBM® WebSphere Service Registry and Repository lub w repozytorium UDDI (Universal Description Discovery and Integration).

W plikach WSDL musi być używana poprawna składnia dla środowiska testowego. Ogólny klient usług może nie działać z niektórymi plikami WSDL.

Jeśli usługa używa uwierzytelniania Secure Sockets Layer (SSL), przed wysłaniem żądania należy utworzyć konfigurację SSL. Więcej informacji na ten temat zawiera sekcja Tworzenie konfiguracji protokołu SSL.

Jeśli usługa używa zabezpieczeń SOAP na potrzeby szyfrowania, podpisywania lub innych algorytmów zabezpieczeń, najpierw należy skonfigurować środowisko z użyciem poprawnych bibliotek i plików konfiguracyjnych, a następnie trzeba utworzyć profil zabezpieczeń dla pliku WSDL. Więcej informacji na ten temat zawierają sekcje Konfigurowanie środowiska na potrzeby zabezpieczeń SOAP i Tworzenie profili zabezpieczeń dla plików WSDL.

Aby można było zaimportować plik WSDL z chronionego serwisu, który wymaga uwierzytelniania wzajemnego, w obszarze roboczym musi znajdować się plik kluczy.

O tym zadaniu

Po utworzeniu wywołania z pliku WSDL wywołanie jest konfigurowane automatycznie z dowolnymi punktami końcowymi SOAP, JMS, WebSphere MQ lub Microsoft .NET, które są dostępne w pliku WSDL. Na stronie Transport żądania wybierz odpowiednią konfigurację transportu.
Uwaga: Konkretne wymagania dotyczące obsługi platformy Microsoft .NET można znaleźć w sekcji Tworzenie konfiguracji transportu Microsoft .NET.

Procedura

Aby wysłać żądanie usługi oparte na pliku WSDL:

  1. Kliknij przycisk paska narzędzi Otwórz ogólny klient usług Przycisk Otwórz ogólny klient usług i wybierz stronę Żądania.
  2. Kliknij przycisk Dodaj Przycisk Dodaj i wybierz metodę dodania pliku WSDL lub kliknij odpowiedni klawisz skrótu na stronie głównej.
    • Kliknij opcję Dodaj plik WSDL z obszaru roboczego, aby dodać plik WSDL z lokalnego obszaru roboczego.
    • Kliknij opcję Dodaj plik WSDL z systemu plików, aby dodać plik WSDL z systemu plików.
    • Kliknij opcję Dodaj plik WSDL z adresu URL, aby pobrać i zaimportować plik WSDL z sieci WWW.
    • Kliknij opcję Dodaj plik WSDL z repozytorium WSRR, aby dodać plik WSDL z produktu WebSphere Service Registry and Repository. Wprowadź adres URL produktu WebSphere Service Registry and Repository i kliknij przycisk Połącz. Aby przejrzeć zawartość repozytorium, można kliknąć przycisk Szukaj Szukaj.
    • Kliknij opcję Dodaj plik WSDL z repozytorium UDDI, aby dodać plik WDSL z repozytorium UDDI (Universal Description Discovery and Integration). Wprowadź adres URL rejestru UDDI i kliknij przycisk Połącz. Aby przejrzeć zawartość repozytorium, można kliknąć przycisk Filtruj Filtruj lub Szukaj Szukaj.
    Uwaga: W przypadku importowania pliku WSDL z chronionego serwisu, który wymaga uwierzytelniania przy użyciu certyfikatu, należy kliknąć opcję Właściwości importowania, a następnie w polu Magazyn kluczy wybrać plik kluczy zawierający certyfikat, który ma zostać udostępniony serwerowi, i wpisać hasło w polu Hasło magazynu kluczy.
  3. Kliknij przycisk OK. Plik WSDL zostanie dodany do okna Biblioteka żądań.
  4. W oknie Biblioteka żądań rozwiń plik WSDL, powiązanie i operację, a następnie wybierz element wywołania. W ogólnym kliencie usług zostaną wyświetlone trzy kroki: Edycja danych, Wywołanie i Wyświetlanie odpowiedzi. Szczegóły wywołania są wyświetlane w kroku Edycja danych.
  5. Na stronie Komunikat zmodyfikuj treść żądania, używając widoku Formularz, Drzewo lub Źródło. W każdym widoku te same dane są wyświetlane w inny sposób. Aby dodać lub usunąć elementy XML w widoku Formularz lub Drzewo, należy kliknąć opcję Schemat > Sprawdź poprawność i uruchom asystę. Zapewni to zgodność z definicją schematu XML (XSD) określoną w katalogu schematów.
  6. Na stronie Transport określ konfigurację transportu dla żądania. Informacje o transporcie są automatycznie importowane z pliku WSDL do konfiguracji transportu.

    W przypadku transportu Microsoft .NET wybierz odpowiednią konfigurację transportu i podaj położenie pliku soaclient.exe.config. Ten plik należy utworzyć ręcznie. Szczegółowe informacje na ten temat zawiera sekcja Tworzenie konfiguracji transportu Microsoft .NET.

    Uwaga: Jeśli jest używany produkt IBM Security AppScan, dostępne są tylko protokoły transportowe HTTP i .Net.
  7. Na stronie Stos żądań wskaż, czy mają być przesłaniane algorytmy zabezpieczeń lub przetwarzania, które są stosowane w przypadku żądań wychodzących dla pliku WSDL. Aby dodać stronę Stos odpowiedzi służącą do edytowania algorytmów zabezpieczeń lub przetwarzania, które są stosowane w przypadku odpowiedzi przychodzących, należy kliknąć opcję Pokaż stos odpowiedzi.
    Uwaga: Te ustawienia dotyczą tylko bieżącego żądania. Jeśli chcesz zmodyfikować stos żądań lub odpowiedzi dla wszystkich żądań używających bieżącego pliku WSDL, należy kliknąć opcję Edytuj zabezpieczenia WSDL w celu otwarcia okna Edytor zabezpieczeń WSDL.
  8. Na koniec kliknij przycisk Wywołaj, aby wysłać żądanie usługi. Ogólny klient usług wysyła żądanie i wyświetla zwrócony komunikat w kroku Wyświetlanie odpowiedzi.

Co dalej

Żądania zakończone pomyślnie są rejestrowane i dodawane do listy Historia żądań. Jeśli używany jest produkt IBM Rational Performance Tester lub produkt IBM Rational Service Tester for SOA Quality, można utworzyć test usługi, klikając przycisk Generuj zestaw testów (Generuj zestaw testów).

Opinia