Конфигурация и най-добри практики на доставчик на данни OData v4

Тази тема се прилага към Dynamics 365 Customer Engagement (on-premises). За версията на Power Apps на тази тема вижте: Конфигурация на доставчик на данни OData v4

Тази тема описва как се конфигурира доставчикът на данни OData v4, както и изискванията и препоръчителните най-добри практики за използване на доставчик на данни OData v4 за свързване с уеб услуга на OData v4.

Най-добри практики на доставчика на данни OData v4

• Вашият екземпляр изисква всички обекти да имат атрибут на ИД. Този ИД е известен като еднозначен идентификатор и стойността трябва да е guid. Може да съпоставяте полета „ИД” само с външни полета с типа данни EDM.Guid. Не може да съпоставяте типа данни EDM.Int32 с поле с тип данни на еднозначен идентификатор.

• Обектите на OData със свойства за приемане на стойност null трябва да се зададат да съвпадат със съпоставеното поле във виртуалния обект. Например свойство на обект на OData с Nullable=False трябва да има нанесено поле с атрибута Изискване за поле, зададено на Business Required.

• За извличане на няколко заявки, например при зареждане на данни в мрежа, контролирайте размера на набора от данни, който се връща от външния източник на данни, с помощта на параметрите на заявката за избор и филтриране.

• Ако вече не е разрешено, системните администратори трябва да разрешат проследяването на допълнителни модули. След като бъде разрешено, всички грешки от крайната точка на OData се улавят в регистрационния файл за проследяване на допълнителни модули. Повече информация: Диалогов прозорец "Системни настройки" - раздел "Персонализиране"

Съпоставяне на тип данни

Таблицата по-долу посочва съпоставянията на типа данни на обектния модел на данни (EDM) на OData с подходящия тип данни.

Тип данни на OData	Тип данни
Edm.Boolean	Две опции
Edm.DateTime	Дата и час
Edm.DateTimeOffset	Дата и час
Edm.Decimal	Десетично число или валута
Edm.Double	Число с плаваща запетая
Edm.Guid	Еднозначен идентификатор
Edm.Int32	Цяло число
Edm.Int64	Цяло число
Edm.String	Един ред с текст или няколко реда с текст

Типове данни на EDM на OData, които не се поддържат за съпоставяне с виртуални обекти

• Edm.Binary

• Edm.Time

• Edm.Float

• Edm.Single

• Edm.Int16

• Edm.Byte

• Edm.SByte

Добавяне на източник на данни с помощта на доставчика на данни OData v4

Тази процедура показва как се използва стандартният доставчик на данни на OData като източник на данни на виртуален обект.

1. Отидете на Настройки Администриране>Виртуален обект Източници> наданни.

2. В лентата с инструменти за действия изберете Създай.

3. В диалоговия прозорец Избор на доставчик на данни изберете от следните източници на данни и след това изберете OK.

   • OData v4 доставчик на данни. Вашата среда включва доставчик на данни на Odata v4, който може да се използва за свързване с източници на данни, които поддържат отворения стандарт на OData v4.

   • Персонализиран доставчик на данни. Ако сте импортирали добавка за доставчик на данни, доставчикът на данни ще се покаже тук. Повече информация: Първи стъпки с виртуални обекти

4. На страницата със свойствата на новия източник на данни попълнете следните полета, след което запишете записа.

   • Име. Въведете име, което описва източника на данни.

   • Ури. Ако използвате доставчика на данни OData, въведете URI за уеб услугата на OData. Например, ако използвате доставчика на OData, за да се свържете с уеб услуга, хоствана в Azure, URI може да изглежда подобно на https://contosodataservice.azurewebsites.net/odata/

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

   • Режим на страниране. Изберете дали да използвате страниране от страна на клиента, или от страна на сървъра, за управление на странирането на резултатите от заявката. Стойността по подразбиране е страниране от страна на клиента. При страниране от страна на сървъра сървърът управлява как се странират резултатите с помощта на параметъра $skiptoken, който се добавя към низа на заявката. Повече информация: Skip Token System Query Option ($skiptoken)

     • Връщане на вграден брой. Връща общия брой на записите в групата резултати. Тази настройка се използва за разрешаване на функционалността на следващата страница при връщане на данни в мрежа. Използвайте стойността false, ако крайната точка на OData не поддържа параметъра на OData $inclinecount. Стойността по подразбиране е false.

   • Заявка за параметри. По избор може да добавите параметри на персонализирана заглавка или низ на заявка, които се използват за свързване с уеб услугата на OData, като например параметри за удостоверяване във външната услуга. Изберете Низ на заявка, за да превключвате между параметър и стойност на заглавен блок и низ на заявка. Може да се добавят до 10 заглавки или низове на заявки.

   

Вижте също

Създаване и редактиране на виртуални обекти, които съдържат данни от външен източник на данни
TechNet Блог: Взаимодействайте с данни от външни системи, използвайки новите виртуални обекти