Konfiguracja, wymagania i najlepsze rozwiązania dotyczące dostawcy danych OData w wersji 4

W tym temacie opisano sposób konfigurowania dostawcy danych OData w wersji 4 oraz wymagań i zalecanych najlepszych rozwiązań dotyczących używania dostawcy danych OData w wersji 4 w celu nawiązania połączenia z usługą internetową OData w wersji 4.

Sprawdzone metody postępowanie dostawcy danych OData v4

• Usługa Microsoft Dataverse wymaga, aby wszystkie tabele miały atrybut ID. Ten identyfikator jest znany jako unikatowy identyfikator, a wartość musi być identyfikatorem GUID. Kolumny identyfikatorów można przypisywać tylko do kolumn zewnętrznych z typem danych Edm.Guid. Nie możesz mapować typu danych Edm.Int32 do kolumn typu danych Unique Identifier w Dataverse.
• Tabele OData z właściwościami, które mogą mieć wartość null, muszą być ustawione tak, aby pasowały do zamapowanej kolumny 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 : Podręcznik administratora: okno dialogowe Ustawienia systemu — karta Dostosowywanie
• Nie można użyć dostawcy danych OData w wersji 4 do nawiązania połączenia z innym środowiskiem.

Mapowanie typu danych

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

Typy danych OData EDM, które nie są obsługiwane do mapowania przy użyciu tabel wirtualnych

• 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 pokazuje, jak używać wbudowanego dostawcy danych OData jako źródła danych dla tabeli wirtualnej.

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

2. Na pasku narzędzi akcji kliknij pozycję Nowy.

3. W oknie dialogowym Wybieranie dostawcy danych wybierz z następujących źródeł danych, a następnie kliknij przycisk OK.

   • Dostawca danych OData w wersji 4. Usługa Dataverse zawiera dostawcę danych Odata w wersji 4, który może służyć do łączenia ze źródłami danych obsługującymi otwarty standard OData w wersji 4.
   • 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: Wprowadzenie do tabel wirtualnych

4. Na stronie Właściwości nowego źródła danych wypełnij następujące kolumny, a następnie zapisz wiersz.

   • Name. Wpisz nazwę, która opisuje źródło danych.
   • Identyfikator URI. Jeśli używasz dostawcy danych OData, wprowadź uri dla usługi sieci Web OData. Jeśli na przykład używasz dostawcy OData do nawiązywania połączenia z usługą internetową 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. Użyj wartości false, jeśli punkt końcowy OData nie obsługuje parametru OData $inlinecount. Wartość domyślna to fałsz.
   • 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 pozycję Ciąg zapytania , aby przełączać się między parametrem nagłówka a parametrem ciągu zapytania i wartością. 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