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

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

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

• Microsoft Dataverse изисква всички таблици да имат атрибут ИД, познат като еднозначен идентификатор, и стойността трябва да е GUID. Може да съпоставяте колони „ИД” само с външни колони с типа данни 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	Един ред с текст или няколко реда с текст

Типове данни на 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. Dataverse включва доставчик на данни на Odata v4, който може да се използва за свързване с източници на данни, които поддържат отворения стандарт на OData v4.
   • Персонализиран доставчик на данни. Ако сте импортирали добавка за доставчик на данни, доставчикът на данни ще се покаже тук. Повече информация: Документация за разработчици: Първи стъпки с виртуални таблици

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

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

     

Вижте също

Създаване и редактиране на виртуални таблици, които съдържат данни от външен източник на данни

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).