Konfiguracja dostawcy danych OData v4 i sprawdzone metody postępowania

Ten temat dotyczy platformy Dynamics 365 Customer Engagement (on-premises). Aby zapoznać się z wersją tego tematu dotyczącą usługi Power Apps, zobacz: Konfiguracja dostawcy danych OData v4

W tym temacie opisano sposób konfigurowania dostawcy danych OData v4, a także wymagania i zalecane najważniejsze wskazówki dotyczące korzystania z dostawcy danych OData v4 dla komunikowania się z usługą sieci Web OData v4.

Sprawdzone metody postępowanie dostawcy danych OData v4

• Wystąpienie wymaga, aby wszystkie encje posiadały atrybut Identyfikator. Ten identyfikator jest znany jako unikatowy identyfikator i jego wartość musi być guid. Możesz mapować pola ID do zewnętrznych pól z typem danych EDM.Guid. Nie można zamapować typu danych EDM.Int32 do pola typu danych uniqueidentifer.

• Encje OData z właściwościami z możliwą wartością null muszą być ustawione, aby pasowały do zamapowanego pola w encji wirtualnej. Na przykład właściwość encji OData z Nullable=False musi mieć pole mapowane z atrybutem Wymaganie dotyczące pola ustawionym na Wymagane ze względów biznesowych.

• Do pobierania wielu zapytań, np. podczas ładowania danych w siatce, kontroluj rozmiar zestawu danych zwróconych z zewnętrznego źródła danych przy użyciu parametrów zapytania wybierz i filtruj.

• Jeśli nie zostało jeszcze włączone, administratorzy systemu powinni włączyć śledzenie dodatków plug-in. Po włączeniu wszystkie błędy z punktu końcowego OData są zarejestrowane w dzienniku śledzenia dodatku plug-in. Więcej informacji: Okno dialogowe Ustawienia systemu - Karta dostosowania

Mapowanie typu danych

W poniższej tabeli przedstawiono mapowania typu danych OData Entity Data Model (EDM) z odpowiednim typem danych.

Typ danych OData	Typ danych
Edm.Boolean	Dwie opcje
Edm.DateTime	Data i godzina
Edm.DateTimeOffset	Data i godzina
Edm.Decimal	Liczba dziesiętna lub waluta
Edm.Double	Liczba zmiennoprzecinkowa
Edm.Guid	Unikatowy identyfikator
Edm.Int32	Liczba całkowita
Edm.Int64	Liczba całkowita
Edm.String	Pojedynczy wiersz tekstu lub wiele wierszy tekstu

Typy danych OData EDM, które nie są obsługiwane przy mapowaniu z encjami wirtualnymi

• Edm.Binary

• Edm.Time

• Edm.Float

• Edm.Single

• Edm.Int16

• Edm.Byte

• Edm.SByte

Dodaj źródło danych przy użyciu dostawcy danych OData v4

Ta procedura ilustruje sposób korzystania z gotowego dostawcy danych OData jako źródła danych encji wirtualnej.

1. Przejdź do Ustawienia>Administracja>Źródła danych encji wirtualnej.

2. Na pasku narzędzi Akcje wybierz Nowa.

3. W oknie dialogowym Wybierz dostawcę danych wybierz jedno z poniższych źródeł danych, a następnie wybierz OK.

   • Dostawca danych OData v4. Twoje środowiskp zawiera dostawcę danych Odata v4, który może służyć do połączenia ze źródłami danych, które obsługują otwarty standard OData v4.

   • Niestandardowy dostawca danych. Jeśli zaimportowałeś dodatek plug-in dostawcy danych, dostawca danych pojawi się w tym miejscu. Więcej informacji znajduje się w temacie Rozpoczęcie pracy z encjami wirtualnymi

4. Na stronie właściwości Nowe źródło danych wypełnij poniższe pola, a następnie zapisz rekord.

   • Nazwa. Wpisz nazwę, która opisuje źródło danych.

   • Uri. Jeśli używasz dostawcy danych OData, wprowadź uri dla usługi sieci Web OData. Na przykład, jeśli używasz dostawcy OData dla nawiązania połączenia z usługą sieci Web hostowaną na platformie Azure, adres URL może wyglądać podobnie do https://contosodataservice.azurewebsites.net/odata/

   • Limit czasu w sekundach. Wprowadź liczbę sekund oczekiwania na odpowiedź z usługi sieci Web do limitu czasu. Wprowadź na przykład 30, aby czekać maksymalnie 30 sekund, zanim nadejdzie limitu czasu.

   • Tryb paginacji. Wybierz, czy ma być używana paginacja po stronie klienta czy po stronie serwera, aby kontrolować paginację wyników zapytania. Domyślna wartość to stronicowanie po stronie klienta. Ze stronicowaniem po stronie serwera, serwer określa, jak stronicowane są wyniki przy użyciu parametru $skiptoken, który jest dodawana do ciągu zapytania. Więcej informacji: Opcja Pomiń do kwerendy tokenu systemu ($skiptoken)

     • Zwróć liczbę encji w tekście. Zwraca łączną liczbę rekordów w zestawie wyników. To ustawienie pozwala włączyć funkcje kolejnej strony, gdy dane są zwracane do siatki. Jeśli punkt końcowy OData nie obsługuje parametru OData $inclinecount, należy użyć wartość false. Wartość domyślna to false.

   • Parametry żądania. Opcjonalnie można dodać niestandardowe parametry nagłówka lub ciągu zapytania, aby połączyć się z usługą sieci Web OData, takie jak parametry uwierzytelniania do usługi zewnętrznej. Wybierz Ciąg zapytania, aby przełączać się między nagłówkiem a parametrem i wartością ciągu zapytania. Można dodać maksymalnie 10 ciągów zapytania lub nagłówków.

   

Zobacz też

Tworzenie i edytowanie encji wirtualnych, które zawierają dane z zewnętrznych źródeł danych
TechNet Blog: Interakcja z danymi z systemów zewnętrznych przy użyciu nowych encji wirtualnych