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

Эта тема относится к Dynamics 365 Customer Engagement (on-premises). Версию этой темы для Power Apps см. по адресу: Конфигурация поставщика данных OData v4

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

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

• Для вашего экземпляра требуется, чтобы все сущности имели атрибут идентификатора. Этот идентификатор известен как уникальный идентификатор, и его значение должно быть идентификатором GUID. Поля ID можно сопоставлять только с внешними полями с типом данных EDM.Guid. Невозможно сопоставить тип данных EDM.Int32 с полем с типом данных uniqueidentife.

• Сущности OData со свойствами, которые могут принимать значение NULL, должны быть заданы в соответствии с сопоставленным полем в виртуальной сущности. Например, свойство сущности OData со значением Nullable=False должно быть сопоставлено полю с атрибутом "Требование поля", имеющим значение Требуется для бизнеса.

• Для извлечения нескольких запросов, например при загрузке данных в сетку, контролируйте размер набора данных, возвращенного из внешнего источника данных, с помощью параметров выбора и фильтрации запроса.

• Если еще не включено, системные администраторы должны включить отслеживание подключаемого модуля. После включения все ошибки из конечной точки OData регистрируются в журнале трассировки подключаемого модуля. Дополнительные сведения: Диалоговое окно "Системные параметры" — вкладка "Настройка"

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

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

Тип данных OData	Тип данных
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. Ваша среда включает поставщика данных Odata v4, который может использоваться для подключения к источникам данных, поддерживающим открытый стандарт OData v4.

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

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

   • Имя. Введите имя, которое описывает источник данных.

   • URI-адрес. При использовании поставщика данных OData введите URI-адрес для веб-службы OData. Например, если используется поставщик OData для подключения к веб-службе, размещенной в Azure, URI-адрес может выглядеть подобно следующему: https://contosodataservice.azurewebsites.net/odata/

   • Время ожидания в секундах. Введите число секунд ожидания ответа веб-службы перед отменой запроса данных из-за истечения времени ожидания. Например, введите 30 для ожидания не более 30 секунд до истечения срока ожидания.

   • Режим разбиения на страницы. Выберите, требуется ли использовать разбиение на страницы на стороне клиента или на стороне сервера для управления разбиением на страницы результатов запроса. Значение по умолчанию — разбиение на страницы на стороне клиента. В случае разбиения на страницы на стороне сервера разбиение результатов на страницы контролируется сервером с помощью параметра $skiptoken, который добавляется к строке запроса. Дополнительные сведения: Системный параметр запроса с токеном пропуска ($skiptoken)

     • Вернуть количество в строке. Возвращает общее количество записей в наборе результатов. Этот параметр используется для включения функции следующей страницы при возврате данных в сетку. Используйте значения false, если ваша конечная точка OData не поддерживает параметра OData $inclinecount. По умолчанию используется значение false.

   • Параметры запроса. Если требуется, можно добавить настраиваемый заголовок или параметры строки запроса, используемые для подключения к веб-службе OData, например параметры проверки подлинности с помощью внешней службы. Выберите Строка запроса для переключения между заголовком и параметром и значением строки запроса. Можно добавить не более 10 заголовков или строк запроса.

   

См. также

Создание и изменение виртуальных сущностей, содержащих данные из внешнего источника данных
Блог TechNet. Взаимодействие с данными из внешних систем с помощью новых виртуальных сущностей