Пошаговое руководство по созданию виртуальной сущности с использованием поставщика данных OData v4

Статья
12/13/2024

Представьте, что вы хотите получить доступ к некоторой личной информации о контакте, создать, обновить и удалить такую информацию из внешнего источника данных в вашем пользовательском бизнес-приложении. Поскольку источник данных, используемый для данного пошагового руководства, имеет веб-службу 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-адрес веб-службы, используемый для этого пошагового руководства, не является действующей веб-службой.

Для этого пошагового руководства требуется одна виртуальная сущность, содержащая следующие три поля.

Имя внешнего поля	Тип внешних данных	Тип данных виртуальной сущности	Назначение
TicketID	Edm.Guid	Первичный ключ	Первичный ключ для сущности
Заголовок	Edm.String	Строка текста	Название билета
Важность	Edm.Int32	Целое число	Числовое значение от 0 до 4, представляющее важность билета

Метаданные OData сущности "Билет" внешнего источника данных при просмотре из веб-браузера.

Метаданные сущности

Создание источника данных

Создайте источник данных для поставщика данных OData v4, который использует пример веб-службы с открытым протоколом OASIS Open Data Protocol (OData).

Перейдите в раздел Параметры>Администрирование>Источники данных виртуальных сущностей.

Выберите СОЗДАТЬ, выберите Поставщик данных OData v4, затем выберите ОК.

Введите или выберите следующие сведения.

Имя: пример источника данных Contoso
URL-адрес: https://contosowebservice.azurewebsites.net/odata
Время ожидания: 30
Вернуть количество в строке: Да

Оставьте другие поля без изменений и выберите СОХРАНИТЬ И ЗАКРЫТЬ.

Совет

При использовании вашей собственной веб-службы проверьте правильность URL-адреса, вставив его в веб-браузер.

Создание виртуальной сущности

Перейдите в раздел Параметры>Настройки>Настройка системы.

В левой области навигации выберите Сущности, затем выберите Создать в основной области.

В форме Сущность: новая выберите вариант Виртуальная сущность, затем введите следующие сведения:

Источник данных: Пример источника данных Contoso
Отображаемое имя: Билет
Имя во множественном числе: Билеты
Имя: new_ticket
Внешнее имя: Билет
Имя внешней коллекции: Билеты
Выберите для включения следующие пункты в разделе "Взаимодействие и сотрудничество":
- Примечания (включают в себя вложения)
- Действия

Рядом с пунктом Области для отображения сущности выберите Служба, затем выберите Сохранить (но не закрывайте форму сущности).

Определение сущности

Создание полей для виртуальной сущности

В левой области навигации на странице Сущность: Билет выберите Поля. В данном пошаговом руководстве вы измените два существующих поля и добавите третье поле.

Внимание

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

Значение "Нет" для "Допускает значение NULL" означает, что атрибут является обязательным. Обратите внимание, что поля первичного ключа всегда обязательны для системы.

Откройте поле new_ticketid и измените следующий атрибут на указанное здесь значение:

Внешнее имя: TicketID

Поле TicketID.

Выберите Сохранить и закрыть.

Откройте поле new_name и измените следующие атрибуты на указанные здесь значения:

Отображаемое имя: Заголовок
Внешнее имя: Заголовок

Поле

Выберите Сохранить и закрыть.

Выберите Создать, затем на странице Поле: создать для Билет введите следующую информацию:

Отображаемое имя: Важность
Имя: new_severity
Внешнее имя: Важность
Требование поля: Требуется для бизнеса
Тип данных: целое число
Минимальное значение: 0
Максимальное значение: 4

Поле

Выберите Сохранить и закрыть.

Добавление полей в главную форму

В диалоговом окне сущности "Билет" выберите Формы.

Откройте основную форму, перетащите поле Важность из правой области на форму в раздел Общие сведения в поле Заголовок.

Поле

В диалоговом окне сущности "Билет" выберите Сохранить и закрыть.

Настройка представления по умолчанию

В левой области обозревателя решений под узлом Сущность "Билет" выберите Представления.

Откройте представление Все билеты.

В области Общие задачи выберите Добавить столбцы.

Добавление столбцов для представления.

Выберите Важность, затем выберите ОК.

В окне Представление: Все билеты выберите Сохранить и закрыть.

В окне обозревателя решений выберите Опубликовать все настройки.

Опубликуйте все настройки.

После публикации всех настроек закройте окно обозревателя решений.

Просмотр виртуальной сущности в действии в Dynamics 365 Customer Engagement (on-premises)

Откройте Служба>Расширения>Билеты.

Область билетов.

Открывается представление Все билеты. Обратите внимание, что, возможно, потребуется обновить браузер, чтобы можно было просмотреть сущность из области Служба.

Представление