Конфігурація постачальника даних 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 в якості джерела даних для віртуальної таблиці.
Перейти до Настройки > Адміністрування > Джерела даних віртуальних сутностей.
На панелі інструментів «Дії» натисніть Новий.
У діалоговому вікні Вибрати постачальника даних виберіть із наведених нижче джерел даних, а потім натисніть ОК.
- Постачальник даних OData v4. Dataverse включає в себе постачальника даних v4 Odata, який можна використати для підключення до джерел даних, які підтримують відкритий стандарт v4 OData.
- Постачальник настроюваних даних. Якщо ви імпортували компонент plug-in постачальника даних, постачальник даних буде відображено тут. Докладні відомості: Документація для розробника: початок роботи з віртуальними таблицями
На сторінці властивостей Нове джерело даних заповніть перелічені нижче стовпці, а потім збережіть рядок.
- Ім'я. Введіть ім’я, що описує джерело даних.
- Uri. Якщо ви використовуєте постачальника даних OData, введіть ідентифікатор uri веб-служби OData. Наприклад, якщо ви використовуєте постачальника OData для підключення до веб-служби, що розміщена в Azure, URI може виглядати схожим на
https://contosodataservice.azurewebsites.net/odata/
. - Граничний час у секундах. Введіть кількість секунд очікування відповіді від веб-служби до закінчення часу очікування запитуваних даних. Наприклад, введіть 30, щоб чекати не більше тридцяти секунд, перш ніж закінчиться час очікування.
- Режим розбиття на сторінки. Виберіть, чи використовувати розбиття на сторінки на стороні клієнта чи на стороні сервера, щоб контролювати, як розбиті сторінки результатів запиту. Значення за промовчанням — розбиття на сторінки на стороні клієнта. Якщо розбиття на сторінки відбувається на стороні сервера, то сервер контролює, як результати розбиваються по сторінках за допомогою параметра $skiptoken, який додано до рядка запиту. Додаткові відомості: Пропустити параметр запиту маркера системи ($skiptoken)
- Повернути кількість вбудованих сутностей. Повертає загальну кількість рядків в наборі результатів. Цей параметр використовується для увімкнення функціональності наступної сторінки, коли ви повертаєте дані до сітки. Використовуйте значення «хибність», якщо ваша кінцева точка OData не підтримує параметр OData $inlinecount. Значення за промовчанням "хибність".
- Параметри запиту. За потреби можна додати настроюваний заголовок або параметри рядка запиту, що використовуються для підключення до веб-служби OData, такі як параметри автентифікації до зовнішньої служби. Натисніть на Рядок запиту для переключення між параметром рядка заголовка та запиту та значенням. Можна додати до 10 заголовків або рядків запиту.
Статті за темою
Створюйте та редагуйте віртуальні таблиці, які містять дані із зовнішнього джерела даних
Примітка
Розкажіть нам про свої уподобання щодо мови документації? Візьміть участь в короткому опитуванні. (зверніть увагу, що це опитування англійською мовою)
Проходження опитування займе близько семи хвилин. Персональні дані не збиратимуться (декларація про конфіденційність).
Зворотний зв’язок
https://aka.ms/ContentUserFeedback.
Очікується незабаром: протягом 2024 року ми будемо припиняти використання механізму реєстрації проблем у GitHub для зворотного зв’язку щодо вмісту й замінювати його новою системою зворотного зв’язку. Докладніше:Надіслати й переглянути відгук про