Ръководство за виртуален обект с помощта на доставчик на данни OData v4
Представете си, че искате да осъществите достъп, създаване, актуализиране и изтриване на лична информация за контакт от външен източник на данни в рамките на вашето персонализирано бизнес приложение. Тъй като източникът на данни, използван в това ръководство има уеб услуга OData v4, можете да използвате доставчика на данни OData v4, включен във вашата версия на Dynamics 365 Customer Engagement. Повече информация: Ръководство за виртуална таблица с помощта на доставчика на данни на OData v4
Тази тема се прилага към Dynamics 365 Customer Engagement (on-premises). За версията на Power Apps на тази тема вижте: Ръководство за виртуална таблица
За този кратък преглед на виртуален обект
Представете си, че искате да получите достъп до информация за билети от външен източник на данни във вашето персонализирано бизнес приложение или областта на услугата на Customer Engagement. В това опростено ръководство ще моделирате виртуален обект с полета, съпоставени която извлича данни за тикети по време на изпълнение от OData уеб услуга.
Подробности за източник на данни
Тъй като източникът на данни, използван в това ръководство има уеб услуга OData v4, можем да използваме доставчика на данни OData v4, включен във вашата среда.
URL адрес на уеб услугата: https://contosowebservice.azurewebsites.net/odata/
Важно
URL адресът за уеб услуга, използван за това ръководство, не е функционираща уеб услуга.
За това ръководство е необходим единен виртуален обект, който съдържа следните три полета.
Име на външно поле | Тип външни данни | Тип данни на виртуален обект | Цел |
---|---|---|---|
ИД на билет | Edm.Guid | Основен ключ | Основен ключ за обекта |
Длъжност | Edm.String | Единичен ред от текст | Заглавие на билета |
Сериозност | Edm.Int32 | Цяло число | Числена стойност от 0 – 4, указваща сериозността на билета |
Метаданните на OData на обекта на билет на външния източник на данни, както се наблюдават в уеб браузър.
Създаване на източник на данни
Създайте източник на данни за доставчика на данни OData v4, който използва уеб услугата за проба на OASIS Open Data Protocol (OData).
Отидете на Настройки>Администриране>Източници на данни за виртуален обект.
Изберете НОВ, изберетеOData v4 доставчик на данни и след това изберетеOK.
Въведете или изберете следната информация.
- Име: Примерен източник на данни на Contoso
-
URL адрес:
https://contosowebservice.azurewebsites.net/odata
- Време за изчакване: 30
- Връщане на вградения брой: Вярно
Оставете другите полета такива, каквито са, и изберете ЗАПИШИ и ЗАТВОРИ.
Съвет
Когато използвате собствена уеб услуга, се уверете, че URL адресът е валиден, като го поставите в уеб браузъра си.
Създаване на виртуалния обект
Отидете в Настройки>Персонализации>Персонализиране на системата.
В левия навигационен екран изберете Обекти и след това изберете Създай от главния екран.
Във формуляра Обект: Нов изберете опцията Виртуален обект и след това въведете следната информация:
- Източник на данни: Примерен източник на данни Contoso
- Име за показване: Билет
- Име в множествено число: Билети
- Име: new_ticket
- Външно име: Билет
- Име на външна колекция: Билети
- Изберете, за да активирате следните опции за комуникация и сътрудничество:
- Забележки (включва прикачени файлове)
- Дейности
До Области, които показват този обект, изберете Услуга и след това изберете Запиши (но не затваряйте формуляра на обекта).
Създаване на полетата за виртуалния обект
В левия навигационен екран на страницата Обект: Билет изберете Полета. Като част от това ръководство ще редактирате две съществуващи полета и ще добавите трето поле.
Важно
Външните имена са чувствителни на главни и малки букви. Вижте метаданните си за уеб услуга, за да се уверите, че използвате правилното име.
Нулируема стойност „Невярно“ указва, че се изисква атрибут. Обърнете внимание, че полетата за основни ключове винаги се изискват от системата.
Отворете полето new_ticketid и променете следния атрибут със стойността, посочена тук:
Външно име: ИД на билет
Изберете Запиши и затвори.
Отворете полето new_name и променете следните атрибути, за да имате стойностите, посочени тук:
- Име за показване: Заглавие
- Външно име: Заглавие
Изберете Запиши и затвори.
Изберете Нов и настраницата Полето: Нов за билет въведете следната информация:
- Име за показване: Сериозност
- Име: new_severity
- Външно име: Сериозност
- Изискване за поле: изисква се за бизнес
- Тип данни: Цяло число
- Минимална стойност: 0
- Максимална стойност: 4
Изберете Запиши и затвори.
Добавете полетата към основния формуляр
В прозореца Билет обект изберете Формуляри.
Отворете основния формуляр, плъзнете и пуснете полето Сериозност от десния прозорец във формуляра в секцията Общи под полето Заглавие .
В прозореца на обекта Билет изберете Запиши и затвори.
Конфигуриране на изгледа по подразбиране
В левия прозорец на прозореца на решението, под обекта Билет изберете Изгледи.
Отворете изгледа Всички билети .
В екрана Общи задачи изберете Добавяне на колони.
Изберете Сериозност, след което изберете OK.
В прозореца Изглед: Всички билети изберете Запазване и затваряне.
В прозореца на прозореца Solution Explorer изберете Публикуване на всички персонализации.
След публикуването на всички персонализации, затворете прозореца на мениджъра на решения.
Преглед на виртуалния обект в действие с Dynamics 365 Customer Engagement (on-premises)
Отидете на Билети>> за удължаване на услугата.
Показва се изгледът Всички билети . Обърнете внимание, че може да се наложи да обновите браузъра си, за да видите обекта от зоната за обслужване .
Отворете запис на билет , за да видите формуляра, който включва полетата Заглавие и Сериозност за дадения запис.
Вижте също
Конфигурация, изисквания и най-добри практики на доставчик на данни на OData v4
Създаване и редактиране на виртуални обекти, които съдържат данни от външен източник на данни