Konfiguracja dostawcy danych OData v4, wymagania i sprawdzone metody postępowania

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

• Microsoft Dataverse wymaga, aby wszystkie tabele posiadały atrybut ID, ten identyfikator jest znany jako unikatowy identyfikator, a wartość musi być identyfikatorem guid. Możesz mapować pola ID tylko do zewnętrznych kolumn z typem danych Edm.Guid. Nie możesz mapować typu danych Edm.Int32 do kolumny typu danych Unique Identifier w Dataverse.
• Tabele OData z właściwościami dopuszczającymi wartość null muszą być ustawione tak, aby były zgodne z mapowaną kolumną w tabeli wirtualnej. Na przykład właściwość tabeli OData z Nullable=False musi mieć kolumna mapowane w atrybucie Dataverse Wymaganie pola ustawione 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: Przewodnik administratora: Okno dialogowe Ustawienia systemowe — karta Dostosowanie.
• Nie można używać dostawcy danych OData v4 do łączenia się z innym środowiskiem.

Mapowanie typu danych

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

Typ danych OData	Typ danych Dataverse
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 tabelami 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 tabeli wirtualnej.

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

2. Na pasku narzędzi akcji kliknij Nowy.

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

   • Dostawca danych OData v4. Dataverse 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: Dokumentacja dla deweloperów: Rozpoczęcie pracy z tabelami

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

   • Name. 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, identyfikator URI 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ę wierszy 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 $inlinecount, 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. Kliknij 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 także

Tworzenie i edytowanie tabeli wirtualnych, które zawierają dane z zewnętrznych źródeł danych

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).