Как встроить Canvas App в форму Dynamics 365

Canvas App встраивается прямо в форму Model-Driven приложения, что открывает широкие возможности для кастомизации без программирования. Citizen developer может создать интерактивное приложение и встроить его в CRM-форму, расширив функциональность системы. Несмотря на простоту добавления, есть нюансы, связанные с обратной связью и публикацией, которые стоит учитывать.

А узнать больше про это решение можно в нашем видео:

Наш проект

В одном из проектов мы столкнулись с задачей встроить уже готовое Canvas-приложение в форму. Задача на первый взгляд выглядела сложной, но на практике решение оказалось довольно простым. Важно лишь понимать, какие шаги выполнять и где могут возникнуть подводные камни.

Кастомизация формы

Первый шаг — кастомизация формы, на которую мы хотим добавить Canvas.

• Выбираем нужную форму.

• Лучше создавать отдельную секцию, так как Canvas обычно занимает больше места, чем одно поле.

• В этой секции добавляем поле. Использовать можно любое ненужное поле или даже повторно добавить существующее.

Добавление нового control

После того как поле добавлено, открываем его свойства. На вкладке Controls выбираем Canvas App и добавляем его.

Важно отметить два момента:

1. Нужно включить отображение для всех интерфейсов (Web, Phone, Tablet), так как форма в Unified Interface используется везде.

2. По умолчанию в настройках появится Entity Name (например, Company) и возможность указать Application ID. Именно ID определяет, какое приложение будет загружено.

Field Properties

В свойствах поля можно настроить несколько параметров:

• Application Name — это необязательное значение, можно оставить любое.

• Application ID — критически важный параметр. Если приложение уже существует, его ID копируем сюда. Если нет — при нажатии на кнопку Customize создаётся новый Canvas App, и система автоматически подтянет ID.

Таким образом, мы можем либо встроить существующее приложение, либо быстро сгенерировать новое.

Интеграция Canvas

После добавления Canvas появляется новый control — Model Driven Form Integration. У него есть DataSource, привязанный к выбранной сущности (например, Company).

Здесь доступны два режима:

• Item — запись, выбранная в форме (со всеми её полями: Name, Phone, Email и т.д.).

• Data — полный набор данных (dataset).

Обычно хватает передачи Item, так как он содержит все данные текущей записи. Но при необходимости можно использовать dataset, например, для отображения отчетов или списков с фильтрацией.

Публикация

После настройки необходимо:

1. Закрыть окно кастомизации.

2. Сохранить форму.

3. Опубликовать изменения.

4. Обновить страницу в CRM.

В итоге Canvas App появится на форме и будет полностью интегрирован в пользовательский интерфейс.

Возможные проблемы

Основная сложность возникает при переносе решения между environment’ами. Application ID сохраняется в настройках и может не совпадать между разными средами.

Если у вас несколько версий Canvas App для разных окружений, нужно заранее забэкапить App ID и после релиза вручную заменить его в настройках формы. В противном случае при миграции Canvas просто не подтянется.

Заключение

Добавление Canvas App на форму — это удобный способ расширить возможности Dynamics 365 без написания кода. Процесс занимает считанные минуты, но требует аккуратности при работе с Application ID и переносом решений между окружениями. При правильной настройке Canvas App становится мощным инструментом для визуализации данных и создания уникального пользовательского опыта.