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.”.

informacja

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.