Przejdź do głównej zawartości
Wersja: 2024 R1

REST Web Service

Źródło danych pozwala na pobranie danych z bazy REST Web Service.

RestWebService.png

1. ID​

Identyfikator źródła danych (jeżeli wartość jest mniejsza od „0”, oznacza to, że źródło nie zostało jeszcze zapisane w bazie).

2. Nazwa​

Nazwa źródła danych wprowadzona przez użytkownika.

3. Typ połączenia​

Pozwala ustalić typ połączenia. Można wybierać pomiędzy: Baza MSSQL, Baza Oracle, Exchange Server, OneDrive, Połączenie do SharePointa, REST Web Service i SOAP Web Service.

4. Opis​

Opis źródła danych zdefiniowany przez użytkownika.

5. Środowisko​

Ustawia zachowanie źródła danych 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.

6. Rodzaj uwierzytelnienia​

Pole umożliwia wybór metody autentykacji z rozwijanej listy. Wymagalność pól w konfiguracji jest zależna od wyboru danej metody. Dostępne metody:

  • Anonimowa – brak;
  • Niestandardowa – możliwe podanie każdego z pól konfiguracji. Z tego typu autentykacji można korzystać wyłącznie w dodatkach SDK;
  • Microsoft Dynamics 365 – użytkownik, hasło, ID klienta oraz URL instancji systemu użytkownika;
  • Microsoft Dynamics 365 on-Premises – użytkownik, hasło, ID klienta, URL serwisu uwierzytelniającego, ID klienta, klucz tajny klienta (client secret);
  • Microsoft Graph – identyfikator dzierżawy (tenant ID) lub adres URL serwisu uwierzytelniającego, identyfikator aplikacji, klucz tajny aplikacji;
  • NT – użytkownik domenowy i hasło;
  • OAuth2 User → API oraz OAuth2 App → API – autentykacja zdefiniowana w polu Autentykacja;
  • Salesforce – użytkownik, hasło (składa się z właściwego hasła użytkownika, do którego należy dopisać klucz tajny użytkownika (user secret)), ID klienta, klucz tajny klienta, URL instancji systemu oraz URL serwisu uwierzytelniającego;
  • WEBCON BPS – użytkownik, ID klienta, klucz tajny klienta, URL instancji systemu.

7. Uwierzytelnienie​

Wybór konfiguracji uwierzytelniania.

8. Połącz jako​

Pozwala wybrać sposób łączenia się z serwisem.

9. Użytkownik​

Użytkownik REST Web Service. W przypadku uwierzytelnienia Windows pole jest wyszarzone.

10. Hasło​

Hasło użytkownika REST Web Service. W przypadku uwierzytelnienia Windows pole jest wyszarzone.

11. URL serwisu autoryzującego​

Adres URL serwisu autoryzującego.

12. Client ID​

Numer ID klienta.

13. Client Secret​

Numer klucza tajnego klienta.

14. URL bazowej instancji serwisu​

Adres URL bazowej instancji serwisu.

15. Nie sprawdzaj certyfikatów HTTPS​

Pomija etap walidacji certyfikatu wystawionego na Web Service.
 

informacja

Dodatkowe informacje na temat nawiązywania połączenia z interfejsem Web API za pośrednictwem protokołu https można znaleźć w anglojęzycznym ARTYKULE dostępnym na portalu dla programistów.

W przypadku gdy wystawiony Web Service jest udostępniany poprzez protokół https, musi on posiadać poprawy 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 wybrać tę opcję, aby akcja nie uznała certyfikatu 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 usługą Web Service za pośrednictwem protokołu HTTPS można znaleźć w anglojęzycznym ARTYKULE dostępnym na portalu programistów WEBCON.