Źródła danych

Podsumowanie:

Aplikacje tworzone w nAxiom mogą przetwarzać dane nie tylko z tabel definiowanych w kreatorze modeli danych, ale także z innych źródeł. Dane z takich źródeł mogą być dostępne przy użyciu zapytań REST API i SOAP API (akcje zapytań do webservice) oraz przez połączenia z innymi bazami danych SQL Server i Oracle. Do źródeł danych można się odwoływać w akcjach (zapytania do webserwisów, SQL do baz zewnętrznych, SQL między bazami danych) oraz w zapytaniach SQL. W niektórych polach właściwości źródła danych jest obsługiwana składnia smart numbers. W połączeniu ze zmiennymi aplikacji, pozwala to na przykład używać różnych źródeł danych w różnych środowiskach.

Na stronie Źródła danych jest wyświetlana lista zdefiniowanych źródeł danych. Na tej stronie można dodawać definicje nowych źródeł danych (przycisk Nowe źródło danych w lewym górnym rogu) oraz edytować definicje i usuwać je (przyciski Edytuj i Usuń obok definicji źródła danych).

Okno dialogowe Nowe źródło danych/Edycja źródła danych zawiera poniższe ustawienia.

• Kod: kod źródła danych; może zawierać tylko litery (bez diakrytycznych), cyfry i znaki podkreślenia.
• Nazwa: nazwa tworzonego źródła danych.
• Aplikacja: nazwa aplikacji, do której zostanie przypisane źródło danych.
• Moduł: nazwa modułu aplikacji, do którego zostanie przypisane źródło danych.
• Typ źródła danych: rodzaj źródła danych; dostępne wartości:
  • Api: REST: źródło danych obsługiwane za pomocą zapytań i odpowiedzi wymienianych z serwerem, który udostępnia interfejs REST API.
  • Api: Soap: źródło danych obsługiwane za pomocą zapytań i odpowiedzi wymienianych z serwerem, który udostępnia interfejs API z protokołem SOAP.
  • Tenant w środowisku nAxiom: źródło danych wskazuje na interfejs PublicAPI bieżącego środowiska nAxiom i umożliwia przesyłanie żądań między tenantami. Ten typ źródła danych nie ma żadnych parametrów konfiguracyjnych. W żądaniach korzystających ze źródła tego typu używany jest mechanizm automatycznego uwierzytelniania oparty na jednorazowych tokenach TOTP.
  • Baza danych: Microsoft SQL (SQL Server): zewnętrzna (lub podstawowa¹) baza danych SQL Server; wymaga wypełnienia pól Adres serwera (nazwa hosta lub adres IP), Port (można użyć smart numbers), Nazwa użytkownika Hasło, Nazwa bazy danych (można użyć smart numbers) i Nazwa instancji (można użyć smart numbers).
  • Baza danych: Oracle: zewnętrzna baza danych Oracle; wymaga wypełnienia pól Adres serwera, Port, Nazwa użytkownika, Hasło (można użyć smart numbers), Nazwa bazy danych (SERVICE_NAME) i Nazwa instancji (SID).
• Typ uwierzytelniania: rodzaj uwierzytelniania, który ma być stosowany do połączeń z serwerem udostępniającym źródło danych REST lub SOAP API; dostępne wartości:
  • Brak uwierzytelniania: (wartość domyślna) połączenia ze źródłem danych nie wymagają uwierzytelniania.
  • Podstawowa autentykacja (Base64): wymaga wypełnienia pól Nazwa użytkownika i Hasło.
  • JSON Web Token (JWT): wymaga wypełnienia pól Serwer autoryzacji (można użyć smart numbers), Nazwa użytkownika i Hasło.
  • OAuth 2.0 Password: wymaga wypełnienia pól Serwer autoryzacji (można użyć smart numbers), Nazwa użytkownika, Hasło, Scope, Client ID i Client Secret.
  • OAuth 2.0 Client Credentials: wymaga wypełnienia pól Serwer autoryzacji (można użyć smart numbers), Scope, Client ID i Client Secret.
• Adres serwera: adres serwera, który udostępnia źródło danych; w tym polu obsługiwana jest składnia smart numbers.
• Open api url: adres URL specyfikacji Open API tworzonego źródła danych; po podaniu tego adresu można zaimportować specyfikację źródła danych i automatycznie utworzyć z niej akcje zapytań do webserwsów; w tym polu obsługiwana jest składnia smart numbers.
• Open api plik: plik w formacie JSON ze specyfikacją Open API tworzonego źródła danych; po wskazaniu tego pliku można zaimportować specyfikację źródła danych i automatycznie utworzyć z niej akcje zapytań do webserwsów.
• Opis: opis źródła danych.
• Zapisz i importuj akcje: przycisk dostępny tylko dla źródeł typu REST API; zapisuje definicję źródła danych i importuje specyfikację OPEN API źródła danych, automatycznie generując akcje zapytań do webserwisów, z których można korzystać jak z szablonów żądań do danego serwisu.
• Zapisz: kliknij, aby zapisać definicję źródła danych.
• Anuluj: kliknij, aby zamknąć to okno dialogowe.

Źródła danych są obsługiwane przez składnię smart numbers. Odpowiednia referencja ma postać:

   {@<kod_aplikacji>.DataSources.<kod_modułu>.<kod_źródła_danych>}

Powiązane tematy:

• Akcja zapytań do webservice
• Miejsca użycia smart numbers
• Definiowanie zmiennych aplikacji

---