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

Тази тема се прилага към Dynamics 365 Customer Engagement (on-premises). За версията на Power Apps на тази тема вижте: Създаване и редактиране на виртуални обекти, които съдържат данни от външен източник на данни

Виртуалният обект представлява персонализиран обект в Dynamics 365 Customer Engagement (on-premises), който има полета, съдържащи данни от външен източник на данни. Виртуалните обекти се показват на потребителите в приложението ви като обикновени записи на обекти в , но съдържат данни, които произхождат от външна база данни, като например база данни на SQL в Azure. Записите, базирани на виртуални обекти, са налични във всички клиенти, включително персонализирани клиенти, разработени с помощта на уеб услугите на Dynamics 365 Customer Engagement.

В миналото, за да се интегрират различните източници на данни, беше необходимо да се създаде конектор, за да се преместят данните, или да се разработи персонализиран допълнителен модул от клиента или от страна на сървъра. С виртуалните обекти можете обаче да се свържете директно с външен източник на данни по време на изпълнението, така че определени данни от външния източник на данни да са достъпни в дадена среда, без да се налага репликация на данни.

Виртуалните обекти се състоят от три основни компонента, доставчик наданни, запис # източник на данни и виртуална единица. Доставчикът на данни се състои от добавки и обект на източник на данни. Източникът на данни е запис на обект в Dynamics 365 Customer Engagement (on-premises), който включва метаданни, които представляват схемата на параметрите за връзка. Всеки виртуален обект препраща към източник на данни в дефиницията на обекта.

Dynamics 365 Customer Engagement (on-premises) включва доставчик на данни OData, който може да използвате, за да се свържете с уеб услуга на OData v4 с достъп до външните данни.

Освен това разработчиците могат да изграждат свои собствени доставчици на данни. Доставчиците на данни са инсталирани в дадена среда като решение. Повече информация: Първи стъпки с виртуални обекти

Предимства на виртуалния обект

• Разработчиците могат да внедрят плъгини за четене на външни данни с помощта на инструмента за регистрация на Dynamics 365 Customer Engagement Web Services и Customer Engagement Plug-in Registration.

• Персонализаторите на системата използват Dynamics 365 Customer Engagement (on-premises), за да конфигурират записа на източника на данни и да създават виртуални обекти, които се използват за достъп до външни данни, без да пишат код.

• Крайните потребители работят със записите, създадени от виртуалните обекти, за да преглеждат данните в полета, мрежи, резултати от търсене и отчети и табла, базирани на Fetch XML.

Добавяне на източник на данни, който да се използва за виртуални обекти

Разработчиците създават персонализирана добавка, която се използва като доставчик на данни за виртуален обект. Алтернативно, можете да използвате предоставения доставчик на данни OData v4. Повече информация: OData v4 Конфигурация на доставчика на данни, изисквания и най-добри практики

1. Отидете на Настройки Администриране>Виртуален обект Източници> наданни.

2. В лентата с инструменти за действия изберете Създай.

3. В диалоговия прозорец Избор на доставчик на данни изберете от следните източници на данни и след това изберете OK.

   • Персонализиран доставчик на данни. Ако сте импортирали добавка за доставчик на данни, доставчикът на данни ще се покаже тук. Повече информация: Първи стъпки с виртуални обекти

   • OData v4 доставчик на данни. Dynamics 365 Customer Engagement (on-premises) включва доставчик на данни OData, който може да се използва с уеб услуги на OData v4. Повече информация: OData v4 Конфигурация на доставчика на данни, изисквания и най-добри практики

Добавяне на защитено поле към източник на данни

Създавате полета за източник на данни по същия начин, както всеки друг обект. За данни, които са шифровани или чувствителни, разрешете атрибута „Тайна на източник на данни“ за персонализираното поле на източника на данни. Например, за да осигурите поле, което съдържа низ за връзка с базата данни.

Бележка

Атрибутът „Тайна на източник на данни“ е достъпен само с полета, добавени към формуляр за източник на данни.

Създаване на виртуален обект

Вие създавате виртуална единица, точно като всяка друга единица в Customer Engagement с добавянето на няколко допълнителни атрибута, описани тук.

Бележка

Въпреки че можете да създадете виртуален обект, като изберете Няма като източник на данни, за да получите данни, виртуалният обект изисква източник на данни. Повече информация: Добавяне на източник на данни, което да се използва за виртуални обекти

1. Отидете в Настройки>Персонализации>Персонализиране на системата.

2. В прозореца на решението създайте нов обект. За да направите това, изберете Обекти в левия навигационен екран и след това изберете Създай.

3. В раздела Общи на дефиницията на обекта изберете Виртуален обект и след това в падащия списък източник на данни изберетежелания източник на данни .

   

4. В дефиницията на обекта попълнете следните задължителни полета.

   • Външно име. Въведете името на таблицата във външния източник на данни, към който е съпоставен този обект.

   • Име на външна колекция. Въведете името в множествено число на таблицата във външния източник на данни, към който е съпоставен този обект.

     Ето пример за виртуален обект с име Movie , който използва доставчик на данни на Azure за достъп до файлове с Cosmos DB документи.

   

   Важно

   Няколко опции, като например "Екипи за достъп", "Опашки" и "Бързо създаване", не са налични за виртуални обекти. Повече информация: Съображения, когато използвате виртуални обекти

   Попълнете допълнителните задължителни и незадължителни свойства, например показвано име и име в множествено число, според необходимостта. За повече информация относно тези свойства вижте Създаване и редактиране на обекти.

5. Създаване и добавяне на едно или повече полета за виртуалния обект. Освен стандартните свойства на полето, които са необходими за създаване на персонализирано поле, тези свойства по избор са налични за всяко персонализирано поле, което създавате за виртуален обект.

   • Външно име. Обикновено това е уникалното име за идентифициране на данните, които искате да се покажат в полето.

   Бележка

   Ако типът на полето, което създавате, е OptionSet, са налични следните допълнителни полета.

   • Име на външен тип. Това свойство се съпоставя с външното име на набора от стойности във външната услуга за набора от опции. Обикновено това може да е числена стойност или клас на стойност на низ. Името от външен тип може да се използва, когато е необходимо изцяло квалифицирано име. Например, като Име на тип с OData, където параметрите в заявката се нуждаят от напълно квалифицирано име, като например [ Име натип].[Стойност].
   • Външна стойност. Това свойство се съпоставя със съответната стойност във външния източник на данни за елемента на набора от опции. Тази въведена стойност се използва за определяне на елемента на набора от опции, който се показва в приложението.

   Попълнете допълнителните свойства според необходимостта. За повече информация за тези свойства вижте Създаване и редактиране на полета.

6. Изберете Запиши и затвори на страницата Свойства на полето .

7. В лентата с инструменти на solution explorer изберете Запиши.

8. В лентата с инструменти на solution explorer изберете Публикуване.

9. Затворете прозореца за решения.

Съображения при използване на виртуални обекти

Виртуалните обекти имат следните ограничения.

• Всички виртуални обекти са само за четене.

• Съществуващите обекти не могат да бъдат конвертирани във виртуални обекти.

• По подразбиране виртуални обекти съдържат само поле за име и ИД. Не се поддържат никакви други полета, управлявани от системата, като „Състояние” или „Създадено на”/„Променено на”.

• виртуалните обекти не поддържат персонализирани полета с типове данни „Валута”, „Изображение”„” или „Клиент”.  

• Виртуалните обекти не поддържат проверяване.

• Полетата на виртуални обекти не може да се използват в сборни или изчисляеми полета.  

• Виртуален обект не може да бъде тип дейност на обект.

• Много функции, които засягат редове на таблица с обекти, не могат да бъдат разрешени с виртуални обекти. Примерите включват опашки, управление на знания, SLA, откриване на дублиращ се запис, проследяване на промените, възможности на Mobile Offline, защита на поле, търсене на съответствие, решения за уеб портали на Dynamics 365 Customer Engagement (on-premises) и N:N релации между виртуални обекти.

• Виртуалните обекти са собственост на организацията и не поддържат концепциите за защита на ниво ред на Commond Data Service за приложения. Препоръчваме да реализирате собствен модел за защита за външните източници на данни.

• Препоръчваме да определите един източник на данни, когато използвате виртуални обекти в разширеното търсене. Създаването например на разширено търсене, което в крайна сметка създава връзка между основните данни на Dataverse и външните данни на виртуален обект, не се поддържа.

• Свойствата на метаданни на поле, които се валидират при актуализация, не се отнасят за виртуални обекти. Например поле за цяло число в поле на виртуален обект поле може да бъде зададено да има минимална стойност, равна на нула. Тъй като стойността идва от външен източник на данни обаче, заявката ще върне стойности, по-малки от нула, когато са извлечени от виртуален обект. Свойството за минимална стойност не се подразбира в заявката. Пак ще трябва да филтрирате стойностите, така че бъдат по-големи от 0, ако това се желае.

• Виртуалните обекти не поддържат проследяване на промените и не могат да бъдат синхронизирани с помощта на функция за ангажиране на клиенти, като например услугата за експортиране на данни.

• Потоците от бизнес процеси не се поддържат с виртуални обекти. Повече информация:Неочаквана грешка, получена при активиране на поток на бизнес процес

Получена е неочаквана грешка, когато потребител активира поток на бизнес процес

Когато потребител се опита да активира поток на бизнес процес, може да получи съобщение за „неочаквана грешка“. При преглед на регистрационния файл се показва следният запис в журнала.

ErrorCode: 0x80040216 Съобщение: System.Web.HttpUnhandledException: Беше хвърлено изключение от тип „System.Web.HttpUnhandledException“. ---> Microsoft.Crm.CrmException: поток на бизнес процес не може да бъде разрешено за виртуален обект

Този проблем възниква, защото виртуалните обекти не поддържат потоци от бизнес процеси.

Вижте също

OData v4 Изисквания към доставчика на данни и най-добри практики
Създаване и редактиране на обекти
Създаване и редактиране на полета