Ръководство за виртуален обект с помощта на доставчик на данни OData v4
Представете си, че искате да осъществите достъп, създаване, актуализиране и изтриване на лична информация за контакт от външен източник на данни в рамките на вашето персонализирано бизнес приложение. Тъй като източникът на данни, използван в това ръководство има уеб услуга OData v4, можете да използвате доставчика на данни OData v4, включен във вашата версия на Dynamics 365 Customer Engagement. Повече информация: Виртуална таблица с помощта на доставчика на данни OData v4
Тази тема се прилага към Dynamics 365 Customer Engagement (on-premises). За версията на Power Apps на тази тема вижте: Кратък преглед на виртуална маса
За този кратък преглед на виртуален обект
Представете си, че искате да получите достъп до информация за билети от външен източник на данни в рамките на вашето персонализирано бизнес приложение или в областта на обслужване на ангажираността на клиентите. В това опростено ръководство ще моделирате виртуален обект с полета, съпоставени която извлича данни за тикети по време на изпълнение от 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).
Отидете на Настройки Администриране>Виртуален обект Източници на>данни.
Изберете NEW, изберете OData v4 доставчик на данни и след това изберетеOK.
Въведете или изберете следната информация.
- Име: Contoso Sample източник на данни
- URL адрес:
https://contosowebservice.azurewebsites.net/odata - Време на изчакване: 30
- Връщане на вграден брой: Вярно
Оставете другите полета както са и изберете ЗАПИШИ &ЗАТВОРИ.
Съвет
Когато използвате собствена уеб услуга, се уверете, че URL адресът е валиден, като го поставите в уеб браузъра си.
Създаване на виртуалния обект
Отидете в Настройки>Персонализации>Персонализиране на системата.
В левия навигационен екран изберете Обекти и след това изберете Създай от главния екран.
В формуляра Обект: Нов изберете опцията Виртуален обект и след това въведете следната информация:
- Източник на данни: Примерен източник на данни Contoso
- Име за показване: Билет
- Име в множествено число: Билети
- Име: new_ticket
- Външно име: Билет
- Име на външна колекция: Билети
- Изберете, за да разрешите следните опции за комуникация и сътрудничество:
- Забележки (включва прикачени файлове)
- Дейности
До Области, които показват този обект, изберете Услуга и след това изберете Запиши (но не затваряйте формуляра на обекта).
Създаване на полетата за виртуалния обект
В левия навигационен екран на страницата Обект: Билет изберете Полета. Като част от това ръководство ще редактирате две съществуващи полета и ще добавите трето поле.
Важно
Външните имена са чувствителни на главни и малки букви. Вижте метаданните си за уеб услуга, за да се уверите, че използвате правилното име.
Нулируема стойност „Невярно“ указва, че се изисква атрибут. Обърнете внимание, че полетата за основни ключове винаги се изискват от системата.
Отворете полето new_ticketid и променете следния атрибут със стойността, посочена тук:
Външно име: ИД на билет
Изберете Запиши и затвори.
Отворете полето new_name и променете следните атрибути, за да имат стойностите, посочени тук:
- Име за показване: Заглавие
- Външно име: Заглавие
Изберете Запиши и затвори.
Изберете Създай и на страницата Поле: Ново за билет въведете следната информация:
- Име за показване: Сериозност
- Име: new_severity
- Външно име: Сериозност
- Изискване за поле: изисква се за бизнес
- Тип данни: Цяло число
- Минимална стойност: 0
- Максимална стойност: 4
Изберете Запиши и затвори.
Добавете полетата към основния формуляр
В прозореца Обект на билет изберете Формуляри.
Отворете главния формуляр, плъзнете и пуснете полето Сериозност от десния екран във формуляра в раздела Общи под полето Заглавие .
В прозореца Обект на билет изберете Запиши и затвори.
Конфигуриране на изгледа по подразбиране
В левия екран на Solution Explorer, под обекта Ticket изберетеИзгледи .
Отворете изгледа Всички билети .
В екрана Общи задачи изберете Добавяне на колони.
Изберете Тежест и след това изберете OK.
В прозореца Изглед: Всички билети изберете Запиши и затвори.
В прозореца Solution Explorer изберете Публикуване на всички персонализации.
След публикуването на всички персонализации, затворете прозореца на мениджъра на решения.
Преглед на виртуалния обект в действие с Dynamics 365 Customer Engagement (on-premises)
Отидете на Билети за разширения на >> услуги.
Изгледът "Всички билети" показва. Забележете, че може да се наложи да обновите браузъра си, за да видите обекта от зоната за услуги .
Отворете запис за билет , за да видите формуляра, който включва полетата Заглавие и Тежест за дадения запис.
Вижте също
Конфигурация, изисквания и най-добри практики на доставчика на данни на OData v4
Създаване и редактиране на виртуални обекти, които съдържат данни от външен източник на данни