Конфигурация и най-добри практики на доставчик на данни 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 като източник на данни на виртуален обект.
Отидете на Настройки>Администриране>Източници на данни за виртуален обект.
В лентата с инструменти за действия изберете Създай.
В диалоговия прозорец Избор на доставчик на данни изберете от следните източници на данни и след това изберете OK.
OData v4 доставчик на данни. Вашата среда включва доставчик на данни на Odata v4, който може да се използва за свързване с източници на данни, които поддържат отворения стандарт на OData v4.
Персонализиран доставчик на данни. Ако сте импортирали добавка за доставчик на данни, доставчикът на данни ще се покаже тук. Повече информация: Първи стъпки с виртуални обекти
На страницата със свойствата на новия източник на данни попълнете следните полета, след което запишете записа.
Име. Въведете име, което описва източника на данни.
Ури. Ако използвате доставчика на данни OData, въведете URI за уеб услугата на OData. Например, ако използвате доставчика на OData, за да се свържете с уеб услуга, хоствана в Azure, URI адресът може да изглежда подобно на
https://contosodataservice.azurewebsites.net/odata/
Време за изчакване в секунди. Въведете броя секунди за изчакване на отговор от уеб услугата, преди да изтече времето за изчакване на заявката за данни. Например въведете 30, за да се изчака най-много тридесет секунди преди изтичане на времето за изчакване.
Режим на пагинация. Изберете дали да използвате страниране от страна на клиента, или от страна на сървъра, за управление на странирането на резултатите от заявката. Стойността по подразбиране е страниране от страна на клиента. При страниране от страна на сървъра сървърът управлява как се странират резултатите с помощта на параметъра $skiptoken, който се добавя към низа на заявката. Повече информация: Опция за системна заявка за пропускане на токен ($skiptoken)
- Връщане на вградения брой. Връща общия брой на записите в групата резултати. Тази настройка се използва за разрешаване на функционалността на следващата страница при връщане на данни в мрежа. Използвайте стойността false, ако крайната точка на OData не поддържа параметъра на OData $inclinecount. Стойността по подразбиране е false.
Параметри на заявката. По избор може да добавите параметри на персонализирана заглавка или низ на заявка, които се използват за свързване с уеб услугата на OData, като например параметри за удостоверяване във външната услуга. Изберете Низ на заявката, за да превключвате между параметъра и стойността на заглавката и низа на заявката. Може да се добавят до 10 заглавки или низове на заявки.
Вижте също
Създаване и редактиране на виртуални обекти, които съдържат данни от външен източник на данни
Блог на TechNet: Взаимодействайте с данни от външни системи с помощта на новите виртуални обекти