Wywołaj SOAP Web service

Akcja pozwala łączyć się z usługami Web Service udostępnionymi przez inne systemy w celu pobrania lub wysłania do nich danych.

Pozwala również na pobranie definicji wszystkich metod Web Service na podstawie pliku WSDL dostępnego online lub w postaci pliku na dysku. Możliwe jest wskazanie odpowiedniej metody oraz parametrów, z jakimi akcja będzie wywoływana.

Okno konfiguracyjne akcji jest podzielone na dwie zakładki: Uwierzytelnianie i Konfiguracja wywołania.

Uwierzytelnianie

Zakładka umożliwia skonfigurowanie połączenia z Web Service na podstawie wprowadzonych danych uwierzytelniających.

1. Połączenie

Pole dostępne po zaznaczeniu opcji Na podstawie połączenia. Umożliwia wskazanie połączenia z zakładki Źródło danych, o ile takie połączenie jest dostępne.

2. URL

Pole dostępne po zaznaczeniu opcji Niestandardowe. Adres usługi Web Service.

Domyślny adres BPS Web API ma format: http://myservername/bps_site/_vti_bin/Webservice_8_2.svc

3. Binding

Wybór protokołu przesyłania danych oraz sposobu autentykacji. Po wskazaniu bindingu należy podać poświadczenia użytkownika.

4. Nie sprawdzaj certyfikatów HTTPS

Pomija etap walidacji certyfikatu wystawionego na Web Service.

informacja

Więcej informacji na ten temat można znaleźć tutaj.

5. Keep-Alive

Połączenie z usługą Web Service będzie cyklicznie podtrzymywane. Opcja może zwiększyć wydajność w przypadku wielokrotnego odnoszenia się do Web Service'u w krótkich odstępach czasowych, ograniczając konieczności powtórnej konfiguracji połączenia.

6. Edytor zmiennych

Dynamicznie zbudowane drzewo wszystkich zmiennych dostępnych w bieżącej lokalizacji Designer Studio. Informacje o tym, jak działają zmienne w WEBCON BPS oraz listę zmiennych można znaleźć tutaj.

Konfiguracja wywołania

Parametrami metod wywołania Web Service'u mogą być stałe wartości, wartości pobrane z bazy danych za pomocą zapytania, czy też wartości dostępne w polu formularza. Obsługiwane są zarówno proste typy danych, takie jak string czy liczba, jak również złożone kolekcje elementów.

Elastyczność konfiguracji umożliwia obsługę większości scenariuszy integracji z systemami zewnętrznymi tylko z poziomu BPS Studio, bez konieczności tworzenia dedykowanych rozwiązań.

1. Wskaż WSDL

Ścieżka do pliku WSDL opisującego Web Service. Możliwe jest wskazanie lokalizacji sieciowej lub na dysku.

Oprócz lokalizacji pliku należy podać również Sposób uwierzytelniania (Anonymous, NTLM, Basic), a w przypadku wybrania opcji Basic, wskazać także nazwę użytkownika i hasło.

Typy złożone – określa sposób, w jaki będą reprezentowane typy złożone w przekazanym do Web Service'u wywołaniu. Dla usług Web Service stworzonych w technologii .NET wskazane jest ustawienie parametru na Brak opakowywania. Niemniej, w zależności od konkretnej implementacji Web Service'u, konieczne może okazać się przestawienie parametru na Opakowywanie.

2. Metoda

Lista metod udostępnionych przez wskazany Web Service.

3. Parametry

Informacje o tym, skąd Web Service będzie pobierał dane do przetwarzania (np. ze źródeł/atrybutów).

Przy przekazywaniu liczb do Web Service'u w postaci tekstu nie należy używać kropki (.) jako separatora grup trzycyfrowych. Kropki należy używać jako separatora dziesiętnego.

Nawiasy kwadratowe po nazwie typu ([], np. Kolekcja1[]) oznaczają kolekcję, która może być uzupełniona w następujący sposób:

• zapytaniem SQL,
• poprzez wstawienie tagu odwołującego się do Listy pozycji.

Parametry typu tablica tablic i typy złożone w tablicy typów złożonych nie są obsługiwane przez akcję. Dlatego nie będą one widoczne w konfiguracji parametrów mimo, że zawiera je definicja pliku WSDL.

4. Rezultat

Informacje o tym, do jakich atrybutów akcja będzie wstawiała wartości zwrócone przez Web Service.

Przykłady

Przykładowa tabela parametrów:

W polu Wartość można używać:

• wartości stałych (np: j.nowak),
• wartości atrybutów na formularzu (np: {123}),
• zapytań SQL (np: select 'j.nowak')

Gwiazdka (*) oznacza pole wymagane. Jeśli wstawiona wartość dynamiczna nie zwróci nic, to wykonanie zakończy się błędem.

Kolekcja uzupełniana zapytaniem SQL:

Zapytanie SQL w polu wartości (A) musi zwracać wartości odpowiadające typom pod kolekcją (B). Liczba zwróconych wyników w zapytaniu odpowiada liczbie utworzonych wierszy Listy pozycji pod typem kolekcji (B).

Kolekcja uzupełniana poprzez odwołanie do Listy pozycji:

W pole wartości należy wstawić tag odwołujący się do Listy pozycji (A). Następnie należy zmapować odpowiednie pola wartości pod kolekcją do kolumn Listy pozycji (dowolnie za pomocą tagów i/lub zapytania SQL) (B).