Поделиться через

Использование малокодовых подключаемых модулей Dataverse (предварительная версия)

  • Статья

[Данный раздел посвящен предварительному выпуску и может быть изменен.]

Microsoft Dataverse предлагает оптимальное решение для получения более эффективной архитектуры данных и снижения рабочей нагрузки на стороне клиента с помощью малокодовых подключаемых модулей. Эти подключаемые модули представляют собой многократно используемые рабочие процессы в реальном времени, которые выполняют определенный набор команд внутри Dataverse (работают на стороне сервера и запускаются персонализированными обработчиками событий).

Важно

  • Это предварительная версия функции.
  • Предварительные версии функций не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Традиционно подключаемые модули создавались как пользовательские классы, скомпилированные в сборку .NET Framework, которые затем загружались и регистрировались в Dataverse. Однако с появлением малокодовых подключаемых модулей пользователи могут создавать эти обработчики событий с использованием минимального кода или вообще без него, а также без необходимости ручной регистрации.

Малокодовые подключаемые модули хранятся в базе данных Dataverse и могут быть легко интегрированы в Power Apps и Power Automate. Поведение бизнес-процесса определяется с помощью языка выражений Power Fx и для него может быть установлена прямая связь с бизнес-данными Dataverse и внешними источниками данных через соединители Power Platform. С помощью малокодовых подключаемых модулей создатели могут быстро создавать сложные бизнес-процессы с минимальными знаниями в области написания кода. Это способствует созданию более оптимизированной и эффективной архитектуры данных.

Преимущества логики на стороне сервера

Определение бизнес-логики на стороне сервера дает несколько преимуществ, в том числе следующие:

  • Повышенная безопасность. Поскольку серверная логика выполняется на сервере, она может помочь предотвратить несанкционированный доступ к конфиденциальным данным или процессам.
  • Повышенная производительность. При выполнении бизнес-логики на сервере, можно уменьшить объем данных, которые необходимо передавать между клиентом и сервером, что приводит к сокращению времени обработки.
  • Надежность и стабильность. Логика на стороне сервера гарантирует, что бизнес-правила последовательно применяются ко всем клиентам, снижая риск ошибок или несоответствий.
  • Более простой процесс обслуживания и обновления. Централизация бизнес-логики на сервере позволяет облегчить обслуживание и обновление, поскольку изменения можно вносить в одном месте, а не обновлять несколько клиентов.
  • Масштабируемость. Логику на стороне сервера легче масштабировать, чем логику на стороне клиента, что позволяет повысить производительность и обрабатывать большие рабочие нагрузки.

Малокодовые подключаемые модули

В Dataverse поддерживаются два типа малокодовых подключаемых модулей:

Type Триггер Поддерживает параметры Поддерживаемая область действия
Мгновенные Запускается вручную Да Глобальные и таблица
Автоматизированный Событие таблицы в Dataverse Нет Таблицу

Все малокодовые подключаемые модули имеют следующие общие свойства:

Свойство Description
Показать имя Понятное для человека имя подключаемого модуля. Невозможно изменить после создания.
Полное имя Внутреннее имя подключаемого модуля. Он используется платформой для идентификации компонента в операциях кода и базы данных. Невозможно изменить после создания.
Description Используется для предоставления дополнительного контекста для подключаемого модуля (назначение, поведение или другие важные сведения).
Решение Используется для группировки компонентов и экспорта в другие среды. Узнайте больше о решениях.
Выражение Это пользовательская функция, которую можно использовать для выполнения действий или вычислений, определенных с помощью языка выражений Power Fx. Power Fx — это язык формул, используемый в Power Apps приложениях на основе холста, и расширенный для использования в плагинах малокодовый. Подробнее см. в поддерживаемых функциях.

Мгновенный малокодовый подключаемый модуль — это логика пользовательского кода, которая запускается вручную пользователем. Могут использоваться пользовательские входные и выходные параметры.

Уникальные свойства:

Свойство Description
Область действия Используется для привязки подключаемого модуля к определенной таблице. Его можно задать как для таблицы (отображается как сущность), так и для глобальной области, где область действия таблицы (сущности) означает, что подключаемый модуль запускается в контексте определенной записи таблицы, а глобальная область действия означает, что операция не связана с таблицей (узнать больше).
Параметры Параметры позволяют передавать информацию между подключаемым модулем и контекстом, который его запускает, упрощая процесс создания бизнес-логики, которая может быть повторно использоваться в различных ситуациях.

Входные параметры используются для предоставления данных подключаемому модулю и позволяют вам управлять поведением функции, передавая различные значения, указанные вами в Power Fx формуле.

Выходные параметры позволяют извлекать результаты функции или метода для дальнейшего использования в вашей программе.

Поддерживаемые типы данных:
  • Логический
  • String
  • Акции в свободном обращении
  • Decimal
  • Дата/время
  • Целое

Дополнительная информация о том, как выполнить интеграцию из приложения Canvas или в Power Automate облачный поток: Интеграция подключаемого модуля малокодовый

Разрешения в отношении подключаемых модулей

Время проектирования

Создатели, у которых есть членство в роли безопасности для настройщика системы или системного администратора в среде Power Platform могут получать доступ ко всем подключаемым модулям в этой среде. Пользовательские роли безопасности можно использовать для ограничения доступа к малокодовым подключаемым модулям.

Время выполнения

Когда вызывается подключаемый модуль, он подучает доступ к данным таблицы, включенным в определение подключаемого модуля (таблицы, которые являются частью формулы или, если таблица связана с параметрами автоматического подключаемого модуля) в контексте пользователя, который вызвал его.

Связи

Используя роли безопасности, доступ к коннекторам в подключаемых модулях можно ограничить для определенного набора пользователей в вашей организации. Укажите, какие роли имеют привилегии на создание, чтение, обновление или удаление.

Предварительные условия для создания малокодового подключаемого модуля

  • Роль безопасности системного администратора или настройщика системы в среде Power Platform.
  • Доступ к приложению ускорителя Dataverse.

Совет

С 1 октября 2023 г. во всех новых средах автоматически устанавливается приложение ускорителя Dataverse. Если у вас уже установлен ускоритель Dataverse, вы можете обновить вручную ускоритель Dataverse.

Обновите Dataverse ускоритель

  1. Следуйте инструкциям, чтобы просмотреть лицензированные приложения в вашей среде.
  2. Если Dataverse Ускоритель уже установлен и доступно обновление, это указано в таблице рядом с элементом.
  3. Выберите Dataverse Ускоритель, а затем выберите Обновить на панели команд.

Совет

Включите автоматические обновления приложений для издателя Microsoft - Power CAT , чтобы автоматически получать обновления по мере их появления (не обязательно для новых сред, созданных после 1 октября 2023 г.).

Заметка

Если вы ранее установили дополнительное решение малокодовый Plug-ins for Connectors , оно будет автоматически удалено при обновлении после 29 июня 2023 г. Возможности будут доступны в основном решении.

Создание мгновенного малокодового подключаемого модуля

  1. Запустите приложение ускорителя Dataverse.
  2. Выберите Создать мгновенный плагин карточка. Создать мгновенный плагин карточка
  3. Укажите отображаемое имя.
  4. При желании определите параметры:
    • Выберите Новый входной параметр или Новый выходной параметр, затем введите метку и тип данных.
    • При необходимости добавьте дополнительные входные и выходные параметры.
  5. Введите Power Fx выражение в редакторе выражений .
    • Ссылайтесь на входные параметры в формуле по имени подписи.
    • Выходные параметры должны быть указаны внутри фигурных скобок, например { Out: "Return value" }.
    • Справочные Dataverse таблицы с использованием функций сбора данных, таких как Filter() и LookUp().
    • Если область действия установлена на сущность, используйте ThisRecord для доступа к значениям столбцов в строке таблицы, связанной с запуском подключаемого модуля, например ThisRecord.'Account Name'.

    Совет

    Обратите внимание на intellisense в поле Выражение . Компоненты с красным подчеркиванием являются недопустимыми. Волнистая желтая линия означает, что на вашу логику могут повлиять ограничения делегирования. Избегайте проблем делегирования, используя делегируемые функции.

  6. При желании можно развернуть Дополнительные параметры , чтобы изменить решение, область или описание.
  7. Выберите Сохранить.
  8. Протестируйте свой мгновенный плагин малокодовый.

Пример: Вычислить сумму двух целых чисел.

  • Создайте два входных параметра, X и Y (оба типа integer), и один выходной параметр, Z (тип string).
  • Используйте следующую формулу: {Z: X + Y }

Пример мгновенного плагина в приложении Dataverse Accelerator

Создание автоматизированного малокодового подключаемого модуля

  1. Запустите приложение ускорителя Dataverse.
  2. Выберите Создать автоматизированный плагин карточка. Создать автоматизированный плагин карточка
  3. Укажите следующие значения:
    • Имя: введите имя для подключаемого модуля, например, Проверка входных данных.
    • Таблица: выберите таблицу, с которой нужно связать подключаемый модуль, например Учетная запись.
    • Запустите это правило плагина, когда строка. Укажите событие данных, которое вызывает подключаемый модуль.
  4. Введите Power Fx выражение в редакторе выражений .
    • Справочные Dataverse таблицы с использованием функций сбора данных, таких как Filter() и LookUp().
    • Используйте ThisRecord для доступа к значениям столбцов в строке таблицы, связанной с запуском подключаемого модуля, например ThisRecord.'Account Name'.
  5. При желании разверните Дополнительные параметры , чтобы изменить этап (когда это должно выполняться) и решение , где сохранен плагин.
  6. Выберите Сохранить.
  7. Протестируйте свой автоматизированный плагин малокодовый.

Использование соединителей Power Platform в малокодовых подключаемых модулях

Соединители Power Platform можно использовать в малокодовых подключаемых модулях для простой интеграции данных и функций из систем за пределами Dataverse, таких как SQL Server, Salesforce и SharePoint, без необходимости написания сложных кодов или пользовательской разработки.

Предварительные условия для использования соединителей в малокодовых подключаемых модулях

Использование действий соединителя в малокодовых подключаемых модулях

Вы можете легко использовать коннекторы и пользовательские коннекторы из плагина малокодовый в Power Fx формуле.

  1. Создайте подключение к нужному соединителю.
  2. Добавьте ссылка на подключение к подключению в Dataverse среде.
  3. В редакторе выражений подключаемого модуля малокодовый Power Fx введите имя ссылка на подключение (внутреннее имя с префиксом и подчеркиванием, например new_connectorName, а не отображаемое имя).
  4. Intellisense показывает доступные действия. Выберите нужное действие, а затем введите необходимые параметры.

Перед использованием коннектора в подключаемом модуле малокодовый ознакомьтесь с документацией коннектора, чтобы убедиться, что вы правильно передаете входные и выходные параметры.

Дополнительная информация: пример

Заметка

  • Не все действия соединителя поддерживаются в настоящее время.
  • Не используйте соединитель Dataverse для подключения к таблицам Dataverse из выражения подключаемого модуля. Вместо этого используйте собственные Power Fx функции для взаимодействия с коллекциями: Filter, Search, LookUp, Patch, Collect и Set, где столбцы рассматриваются как глобальные переменные.

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

Тестирование мгновенных подключаемых модулей

  1. На главном экране выберите мгновенный подключаемый модуль из списка, затем выберите Тест на панели команд. Вы также можете перейти к этому экрану из редактора мгновенного подключаемого модуля на панели команд после его сохранения. Выберите Тест для плагина малокодовый.

  2. Укажите значения для всех входных параметров, которые определены в подключаемом модуле малокодовый, а затем выберите Запустить. Выберите «Запустить», чтобы протестировать плагин малокодовый.

Проверьте полученный ответ.

Совет

Используйте выходные параметры для проверки того, соответствуют ли поведение и результаты тому, что вы ожидаете. В противном случае вы увидите только результат тестирования: успех или неудача.

Тестирование автоматических подключаемых модулей

Протестируйте автоматические подключаемые модули, вызвав событие данных. Проверьте, успешно ли работает подключаемый модуль, проверив ожидаемые изменения, определенные в формуле.

Совет

Во время стадии предварительной версии вы можете вызвать связанное событие данных с помощью редактора таблиц в Power Apps:

  1. войдите в систему Power Apps, перейдите в раздел Таблицы и выберите Плагин table.
  2. На панели команд выберите Изменить.
  3. Создавайте, обновляйте или удаляйте строки непосредственно из этого представления. Либо откройте строку в форме по умолчанию, выбрав ее, а затем выберите Редактировать строку с помощью формы на панели команд.

Интеграция малокодового подключаемого модуля

Вызов мгновенного подключаемого модуля из приложения на основе холста или с пользовательской страницы

  1. В приложении Dataverse Accelerator :
    1. Выберите мгновенный подключаемый модуль в списке.
    2. Выберите Копировать код фрагмент кода на панели команд. Вызов экземпляра плагина малокодовый
    3. Вставьте и сохраните скопированную формулу в текстовом редакторе или блокноте (куда вы сможете легко вернуться).
  2. В Power Apps:
    1. Создавайте или редактируйте приложение на основе холста (или пользовательскую страницу) в Power Apps Studio.
    2. В левой навигационной панели на вкладке Источники данных выберите + Новый источник данных и найдите параметр Среда в Dataverse коннекторе.
    3. Вставьте в холст следующие компоненты:
    • Добавьте элементы управления вводом, соответствующие типу данных каждого параметра, например, Ввод текста для текста или чисел, переключение для логический.
    • Если область подключаемого модуля привязана к таблице, добавьте поле со списком, связанное с той же таблицей, чтобы можно было выбрать входные данные.
    • Добавьте кнопку для вызова плагина.
  3. Вставьте скопированную вами формулу плагина в свойство кнопки OnSelect .
  4. Сопоставьте каждый входной параметр Value со ссылкой на соответствующие элементы управления вводом:
    • Если бы формула была Environment.new_CalculateSum({ X: Value, Y: Value });, ее можно было бы переписать так: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Если формула была привязана, замените Environment на таблицу отображаемое имя для доступа к подключаемому модулю.
  5. Если для плагина малокодовый определен выходной параметр:
    1. Запишите ответ в Set() или UpdateContext() формулу: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Отобразите переменную в подписи. В качестве альтернативы используйте Notify() формулу для отображения данных в уведомлении.
  6. Запустите приложение и выберите команду на панели команд, чтобы выполнить малокодовый подключаемый модуль.

Узнайте больше о том, как можно вызывать Dataverse действия непосредственно из Power Fx приложений Canvas.

Вызов мгновенного подключаемого модуля из облачного потока Power Automate

  1. В облачный поток добавьте новое действие из соединителя Microsoft Dataverse.
  2. Выберите действие под названием Выполнить непривязанное действие или Выполнить связанное действие.
  3. Выберите свой подключаемый модуль (он имеет уникальное имя с префиксом).
  4. Укажите значения для всех входных параметров (если они есть).

Вызов мгновенного подключаемого модуля из веб-API Dataverse

Следуйте инструкциям в разделах Непривязанное действие или Функция, привязанная к таблице в Вызов пользовательских API из документации по веб-API (в зависимости от соответствующей области действия подключаемого модуля).

Справка по малокодовым подключаемым модулям

Если у вас возникли проблемы с созданием или запуском плагина малокодовый, ознакомьтесь с этими советами по устранению распространенных проблем, которые могут возникнуть: Microsoft Dataverse Советы и известные проблемы с плагинами малокодовый

Получение справки и поддержки

В случае возникновения проблем с установкой решения Accelerator или подключаемыми модулями малокодовый, не описанных в Dataverse советах по подключаемым модулям малокодовый и известных проблемах Microsoft Dataverse , таких как полученные недокументированные ошибки,используйте функцию «Справка + поддержка» и укажите следующую информацию:

  • Тип проблемы: Web API и SDK Dataverse
  • Подтип проблемы: набор Accelerator для Dataverse

Примеры малокодовых подключаемых модулей, которые вы можете создавать

Несколько примеров создания подключаемого модуля малокодовый см. в разделе Пример Dataverse Плагины малокодовый (предварительная версия)

Ограничения

  • Объект языка среды необходимо прочитать, чтобы получить доступ к новым подключаемым модулям внутри существующих приложений на основе холста. Для любых подключаемых модулей, созданных после того, как вы добавили источник данных таблицы среды в существующее приложение на основе холста, вам нужно удалить и прочитать объект языка среды Power Fx. Затем обновленный список подключаемых модулей отобразится как действия.

  • Для Intellisense требуются явная нотация в автоматических подключаемых модулях, если вы хотите ссылаться на какие-либо таблицы в формуле. Используйте следующий синтаксис для устранения неоднозначности, например, [@Accounts], используя квадратные скобки и символ @ (а не Accounts).

  • Поддержка вложенности. Подключаемые модули могут вызывать из выражений Power Fx только собственные действия (опубликованные Майкрософт).

  • Для некоторых Collect сценариев требуется Patch. Есть некоторые сценарии, где это не работает. Collect() Обходной путь — использовать Patch() , как показано в примере заполнения столбца «в отношении» ниже. Если вы создаете автоматизированный подключаемый модуль, добавляйте @ к каждой таблице, на которую ссылается формула Power Fx.

    Patch(Faxes,
    Collect(Faxes, { Subject : "Sub1" } ),
    { Regarding : First(Accounts) }
)

  • Когда малокодовые подключаемые модули взаимодействуют с соединителями и используется DLP, администратор может заблокировать создание подключений с помощью DLP. Однако существующие ссылки на подключения в среде Dataverse продолжают работать. Если администратору необходимо заблокировать все взаимодействия плагина малокодовый с любыми коннекторами, он может отключить настройку организации Allowconnectorsonpowerfxactions. Этот параметр включен по умолчанию и может быть отключен обычными методами SDK (WebAPI, SDK, PowerShell и т. д.). Вы можете отключить этот параметр с помощью малокодового мгновенного подключаемого модуля следующим образом:

    Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })

  • Подключаемые модули, использующие соединители, могут выводить результаты только из определенных полей. В связи с этим вам необходимо сопоставить определенные примитивные значения из ответа соединителя с выходными значениями.

Малокодовые подключаемые модули, которые имеют ограничение на пользовательские соединители

Если у вас есть малокодовые подключаемые модули с пользовательскими соединителями, сначала необходимо импортировать подключаемые соединители, а затем ссылки на подключения или потоки.

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

Если вы импортируете решение, которое содержит настраиваемые соединители и потоки, Azure не сможет зарегистрировать настраиваемый соединитель, пока он регистрирует ваши ссылки на подключение или потоки. Это также относится к ссылкам на подключения для настраиваемого соединителя, которые ранее не были импортированы в отдельном решении. Если Azure не зарегистрировал ваш пользовательский соединитель, импорт завершится ошибкой или вы не сможете начать импорт.

Дополнительная информация: Создание пользовательских коннекторов в решениях: известные ограничения

См. также

Плагины малокодовый Power Fx (предварительная версия)

Используйте готовую подсказку в плагине Dataverse малокодовый в Power Apps