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

Вызов функции из приложения, потока, кода или другой функции (предварительная версия)

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

Функции можно вызывать в Dataverse из приложения на основе холста, пользовательской страницы в приложении на основе модели, потока, кода или из другой функции.

Внимание!

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

Вызов функции из приложения на основе холста или с пользовательской страницы

  1. В области Функции в Power Apps (make.powerapps.com) выберите функцию, которую требуется вызвать из приложения на основе холста или с пользовательской страницы.
  2. Выберите Скопировать фрагмент кода на панели команд.
  3. Вставьте и сохраните скопированную формулу в текстовом редакторе, блокноте или в любом другом месте, куда вы можете легко обратиться.
  4. В Power Apps Studio:
    1. Создайте или измените приложение на основе холста или пользовательскую страницу в Power Apps Studio.
    2. На левой панели навигации на вкладке Источники данных выберите Добавить данные, затем найдите параметр Среда в соединителе Dataverse и выберите его.
    3. Вставьте следующие компоненты в холст:
      • Добавьте элементы управления вводом, соответствующие типу данных каждого параметра, например числовой ввод.
      • Добавьте кнопку для вызова функции.
      • Добавьте элемент управления выводом, соответствующий типу данных параметра, например числовой ввод.
  5. Выберите созданную кнопку и в свойстве OnSelect введите функцию, например Environment.new_calculatesum.
  6. Сопоставьте каждый входной параметр Value для ссылки на соответствующие элементы управления вводом:
    • Если ваша функция Environment.new_CalculateSum({ X: Value, Y: Value });, ее можно переписать как: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Чтобы задать выходные данные функции "result", измените формулу на "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Выберите элемент управления выводом и задайте свойство 'Value' с формулой result.z.

Просмотрите приложение, введите входные значения 1 и 2 и нажмите кнопку. Результат должен отобразиться в поле вывода.

Вызов функций из облачного потока Power Automate

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

Вызов функций из веб-API Dataverse

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

Вызов существующих функций из новых функций

Чтобы вызвать существующую функцию в новой функции, используйте синтаксис: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Поскольку выходные данные всегда являются записью, используйте точечную нотацию для доступа к выходным параметрам. Например, если функция "ExistingFunction" имеет два выходных параметра, определенных как out1 и out2, доступ к ним можно получить одним из следующих способов:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Ограничения, связанные с функциями в Dataverse

  • Объект языка среды необходимо добавить заново, чтобы получить доступ к новым функциям в существующих приложениях на основе холста. Для всех функций, созданных после добавления источника данных таблицы среды в существующее приложение на основе холста, необходимо удалить и повторно добавить объект языка среды Power Fx. Затем вы увидите обновленный список функций в виде действий.
  • Поддержка вложенности. функции могут вызывать только действия Microsoft, опубликованные Microsoft из выражений Power Fx.
  • Некоторые сценарии использования функции Collect требуют использования функции Patch. Есть некоторые сценарии, в которых Collect() не работает. В качестве обходного решения можно использовать Patch(), как показано в примере заполнения столбца "В отношении" здесь.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Отладка и получение справки по функциям

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

Отладка с помощью функции trace()

  1. Для отладки с помощью функции трассировки убедитесь, что включен подключаемый модуль и настраиваемое отслеживание активности рабочего процесса.
  2. Перейдите в Power Apps (make.powerapps.com), выберите значок шестеренки Параметры в правом верхнем углу, затем выберите Дополнительные параметры.
  3. Выберите Параметры > Аудит > Глобальные параметры аудита.
  4. На вкладке Настройка убедитесь, что параметр Включить ведение журнала трассировки подключаемого модуля включен для значения Все.

Как только вы включите отслеживание, вы можете начать использовать функции trace() для отладки формул Power Fx. Более подробно о том, как использовать функцию trace() внутри выражения Power Fx: Функция трассировки - Power Platform.

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

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

  • Тип проблемы — веб-API и SDK Dataverse.
  • Подтип проблемы.

Примеры функций

Создание и использование функций в Microsoft Dataverse

  • Last updated on