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 WEBCON 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.
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 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 Designer 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ł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).