Поделиться через

Конфигурация, требования и рекомендации для поставщика данных OData v4

  • Статья

В этом разделе описывается порядок настройки поставщика данных OData v4, а также требования и рекомендации по использованию поставщика данных OData v4 для подключения к веб-службе OData v4.

Рекомендации для поставщика данных OData v4

  • Microsoft Dataverse требует, чтобы все таблицы имели атрибут ID, который называется уникальным идентификатором и должен иметь значение типа GUID. Столбцы ID можно сопоставлять только с внешними столбцами с типом данных Edm.Guid. Невозможно сопоставить тип данных Edm.Int32 со столбцом с типом данных уникального идентификатора в Dataverse.
  • Таблицы OData со свойствами, которые могут принимать значение NULL, должны быть заданы в соответствии с сопоставленным столбцом в виртуальной таблице. Например, свойство таблицы OData со значением Nullable=False должно быть сопоставлено столбцу в Dataverse с атрибутом Требование поля со значением Требуется для бизнеса.
  • Для извлечения нескольких запросов, например при загрузке данных в сетку, контролируйте размер набора данных, возвращенного из внешнего источника данных, с помощью параметров выбора и фильтрации запроса.
  • Если еще не включено, системные администраторы должны включить отслеживание подключаемого модуля. После включения все ошибки из конечной точки OData регистрируются в журнале трассировки подключаемого модуля. Дополнительные сведения: Руководство администратора. Диалоговое окно "Системные параметры" — вкладка "Настройка".
  • Вы не можете использовать поставщик данных OData v4 для подключения к другой среде.

Сопоставление типов данных

В следующей таблице перечислены сопоставления типов данных модели данных таблицы (EDM) OData с типами данных Dataverse.

Тип данных OData Тип данных Dataverse
Edm.Boolean Два параметра
Edm.DateTime Дата и время
Edm.DateTimeOffset Дата и время
Edm.Decimal Десятичное число или валюта
Edm.Double Число с плавающей запятой
Edm.Guid Уникальный идентификатор
Edm.Int32 Целое число
Edm.Int64 Целое число
Edm.String Одна строка текста или несколько строк текста

Типы данных OData EDM, которые не поддерживаются для сопоставления с виртуальными таблицами

  • Edm.Binary
  • Edm.Time
  • Edm.Float
  • Edm.Single
  • Edm.Int16
  • Edm.Byte
  • Edm.SByte

Добавление источника данных с использованием поставщика данных OData v4

Эта процедура описывает порядок использования готового поставщика данных OData в качестве источника данных виртуальной таблицы.

  1. Перейдите в раздел Параметры > Администрирование > Источники данных виртуальных сущностей.

  2. На панели действий нажмите кнопку Создать.

  3. В диалоговом окне Выберите поставщика данных выберите одного из следующих поставщиков данных, затем нажмите ОК.

    • Поставщик данных OData v4. Dataverse включает поставщика данных Odata v4, который может использоваться для подключения к источникам данных, поддерживающим открытый стандарт OData v4.
    • Настраиваемый поставщик данных. Если был импортирован подключаемый модуль поставщика данных, этот поставщик данных будет отображаться здесь. Дополнительные сведения: Документация для разработчиков. Начало работы с виртуальными таблицами

  4. На странице свойств Новый источник данных заполните указанные ниже столбцы, затем сохраните строку.

    • Имя. Введите имя, которое описывает источник данных.
    • URI-адрес. При использовании поставщика данных OData введите URI-адрес для веб-службы OData. Например, если используется поставщик OData для подключения к веб-службе, размещенной в Azure, URI-адрес может выглядеть подобно следующему: https://contosodataservice.azurewebsites.net/odata/.
    • Время ожидания в секундах. Введите число секунд ожидания ответа веб-службы перед отменой запроса данных из-за истечения времени ожидания. Например, введите 30 для ожидания не более 30 секунд до истечения срока ожидания.
    • Режим разбиения на страницы. Выберите, требуется ли использовать разбиение на страницы на стороне клиента или на стороне сервера для управления разбиением на страницы результатов запроса. Значение по умолчанию — разбиение на страницы на стороне клиента. В случае разбиения на страницы на стороне сервера разбиение результатов на страницы контролируется сервером с помощью параметра $skiptoken, который добавляется к строке запроса. Дополнительные сведения: Системный параметр запроса с токеном пропуска ($skiptoken)
      • Вернуть количество в строке. Возвращает общее количество строк в наборе результатов. Этот параметр используется для включения функции следующей страницы при возврате данных в сетку. Используйте значения false, если ваша конечная точка OData не поддерживает параметра OData $inlinecount. По умолчанию используется значение false.
    • Параметры запроса. Если требуется, можно добавить настраиваемый заголовок или параметры строки запроса, используемые для подключения к веб-службе OData, например параметры проверки подлинности с помощью внешней службы. Щелкните Строка запроса для переключения между заголовком и параметром и значением строки запроса. Можно добавить не более 10 заголовков или строк запроса.

      Строка источника данных виртуальной таблицы.

См. также

Создание и изменение виртуальных таблиц, содержащих данные из внешнего источника данных

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).