SOAP Web Service
Połączenie pozwala na pobranie danych z bazy SOAP Web Service.
1. Parametry podstawowe
- ID – identyfikator połączenia (jeżeli wartość jest mniejsza od „0”, oznacza to, że połączenie nie zostało jeszcze zapisane w bazie).
- Nazwa – nazwa połączenia wprowadzona przez użytkownika.
- Typ połączenia – pozwala ustalić typ połączenia. Pole jest wypełniane automatycznie.
- Opis – opis połączenia zdefiniowany przez użytkownika.
2. Środowisko
Ustawia zachowanie połączenia w poszczególnych środowiskach. W zakładce Wspólne domyślnie ustawiane są parametry, jakie będą stosowane dla wszystkich trzech środowisk (DEV/TEST/PROD). W zakładkach poszczególnych środowisk można z kolei wpisać indywidualne parametry. Należy wówczas zaznaczyć opcję Zerwij dziedziczenie (będzie to równoznaczne z ignorowaniem ustawień z zakładki Wspólne) i wpisać żądane ustawienia połączenia.
3. URL
Adres serwera SOAP Web Service. W przypadku, gdy na serwerze dostępnych jest kilka instancji SOAP Web Service, konieczne jest wskazanie serwera oraz instancji, z którą ma nastąpić połączenie.
4. Binding
Określa typ uwierzytelnienia.
- HttpSecurityNone – połączenie nie będzie wykorzystywać uwierzytelniania, nastąpi anonimowo,
- HttpBasic – połączenie użyje podanego loginu i hasła do uwierzytelniania,
- HttpNtlm – logowanie zintegrowane. Do połączenia użyty zostanie login i hasło puli aplikacji SharePoint,
- HttpsBasic – do uwierzytelnienia użyty zostanie login i hasło z zastosowaniem protokołu https. Wymaga to poprawnego certyfikatu lub wyłączenia jego walidacji,
- HttpNoCredentials – dane logowania nie są potrzebne do nawiązania połączenia.
5. Użytkownik
Użytkownik SOAP Web Service. W przypadku uwierzytelnienia Windows pole jest nieaktywne.
6. Hasło
Hasło użytkownika SOAP Web Service. W przypadku wyboru bindingu z anonimowym lub zintegrowanym uwierzytelnianiem pole jest nieaktywne.
7. Keep-Alive
Zaznaczenie przycisku wyboru dodaje do nagłówka wiadomości tekst „Connection: keep-alive”. Pozwala to na utrzymywanie połączenia między WEBCON BPS a web serwisem. Zaletą takiego rozwiązania jest szybsza komunikacja oraz mniejsza liczba komunikatów. Nagłówek ten musi być obsługiwany przez web serwis. Przy występującym błędzie „Message=The request was aborted: The request was canceled” zaleca się wyłączenie wspomnianego nagłówka.
11. Nie sprawdzaj certyfikatów HTTPS
W przypadku gdy wystawiona usługa sieciowa jest udostępniana poprzez protokół HTTPS, powinien on posiadać poprawny certyfikat.
Certyfikat jest zaufany – akcja sama sprawdza poprawność certyfikatu w centrum certyfikacji.
Certyfikat jest wystawiony lokalnie – jeśli certyfikat nie został dodany do zaufanych certyfikatów na serwerze, należy zaznaczyć tę opcję, ponieważ akcja uzna certyfikat za nieważny.
Ignorowanie sprawdzenia certyfikatu nie jest zalecane.
Możliwy komunikat błędu: „Could not establish trust relationship for the SSL/TLS secure channel. ---> System.Security.Authentication.AuthenticationException: The remote certificate is invalid according to the validation procedure.”.
Dodatkowe informacje na temat łączenia z web serwisem za pośrednictwem protokołu HTTPS można znaleźć w anglojęzycznym ARTYKULE dostępnym na portalu programistów WEBCON.