Конфігурація постачальника даних OData v4, вимоги і сучасний досвід

Ця тема описує настроювання постачальника даних OData v4, а також вимоги та рекомендований сучасний досвід використання постачальника даних OData v4 для з'єднання з веб-службою OData v4.

Сучасний досвід використання постачальника даних OData v4

• Microsoft Dataverse вимагає, щоб всі таблиці мали ідентифікатор атрибута, цей ідентифікатор є унікальним ідентифікатором, а значення повинно бути guid. Можна зіставляти стовпці ідентифікатора тільки із зовнішніми стовпцями із типом даних Edm.Guid. Не можна зіставляти тип даних Edm.Int32 зі стовпцем типу даних «Унікальний ідентифікатор» в Dataverse.
• Таблиці OData із властивостями, для яких можна вказати значення null, повинні бути настроєні таким чином, щоб вони відповідали зіставленому стовпцю у віртуальній таблиці. Наприклад, властивість таблиці OData, для якої Nullable = False, повинна мати зіставлений стовпець у Dataverse в атрибуті Вимоги до поля зі значенням Бізнес-вимога.
• Під час отримання кількох запитів, наприклад, коли ви завантажуєте дані до сітки, контролюйте розмір набору даних, які повернули із зовнішнього джерела даних, за допомогою параметрів вибору та запиту фільтра.
• Якщо ще не ввімкнено, системний адміністратор повинен активувати трасування компонента plug-in. Після активації всі помилки з кінцевої точки OData відображені в журналі трасування компонента plug-in. Додаткові відомості: Посібник адміністратора: Діалогове вікно параметрів системи – Вкладка "Настроювання"
• Постачальник даних OData v4 не можна використовувати для підключення до іншого середовища.

Зіставлення типу даних

У таблиці нижче наведено зіставлення типів даних моделі даних таблиці OData (EDM) із типами даних 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. У діалоговому вікні Вибрати постачальника даних виберіть із наведених нижче джерел даних, а потім натисніть ОК.

   • Постачальник даних OData v4. Dataverse включає в себе постачальника даних v4 Odata, який можна використати для підключення до джерел даних, які підтримують відкритий стандарт v4 OData.
   • Постачальник настроюваних даних. Якщо ви імпортували компонент plug-in постачальника даних, постачальник даних буде відображено тут. Докладні відомості: Документація для розробника: початок роботи з віртуальними таблицями

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

   • Ім'я. Введіть ім’я, що описує джерело даних.
   • Uri. Якщо ви використовуєте постачальника даних OData, введіть ідентифікатор uri веб-служби OData. Наприклад, якщо ви використовуєте постачальника OData для підключення до веб-служби, що розміщена в Azure, URI може виглядати схожим на https://contosodataservice.azurewebsites.net/odata/.
   • Граничний час у секундах. Введіть кількість секунд очікування відповіді від веб-служби до закінчення часу очікування запитуваних даних. Наприклад, введіть 30, щоб чекати не більше тридцяти секунд, перш ніж закінчиться час очікування.
   • Режим розбиття на сторінки. Виберіть, чи використовувати розбиття на сторінки на стороні клієнта чи на стороні сервера, щоб контролювати, як розбиті сторінки результатів запиту. Значення за промовчанням — розбиття на сторінки на стороні клієнта. Якщо розбиття на сторінки відбувається на стороні сервера, то сервер контролює, як результати розбиваються по сторінках за допомогою параметра $skiptoken, який додано до рядка запиту. Додаткові відомості: Пропустити параметр запиту маркера системи ($skiptoken)
     • Повернути кількість вбудованих сутностей. Повертає загальну кількість рядків в наборі результатів. Цей параметр використовується для увімкнення функціональності наступної сторінки, коли ви повертаєте дані до сітки. Використовуйте значення «хибність», якщо ваша кінцева точка OData не підтримує параметр OData $inlinecount. Значення за промовчанням "хибність".
   • Параметри запиту. За потреби можна додати настроюваний заголовок або параметри рядка запиту, що використовуються для підключення до веб-служби OData, такі як параметри автентифікації до зовнішньої служби. Натисніть на Рядок запиту для переключення між параметром рядка заголовка та запиту та значенням. Можна додати до 10 заголовків або рядків запиту.

     

Статті за темою

Створюйте та редагуйте віртуальні таблиці, які містять дані із зовнішнього джерела даних

Примітка

Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)

Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).