从应用、流、代码或其他函数调用函数（预览版）

[本主题是预发行文档，有可能会有所更改。]

您可以从画布应用程序、模型驱动应用程序中的自定义页面、流、代码或其他函数调用 Dataverse 中的函数。

重要提示

从画布应用或自定义页面调用函数

从 Power Apps (make.powerapps.com) 中的函数区域，选择要从画布应用程序或自定义页面调用的函数。
在命令栏上选择复制代码片段。
将复制的公式粘贴并保存到文本编辑器、记事本或便于参考的地方。
在 Power Apps Studio 中：
1. 在 Power Apps Studio 中创建或编辑画布应用程序（或自定义页面）。
2. 在左侧导航窗格的数据源标签下，选择添加数据并从 Dataverse 连接器中搜索环境选项，然后将其选中。
3. 在画布上插入以下组件：
  - 添加与每个参数的数据类型相对应的输入控件，例如数字输入。
  - 添加一个按钮来调用函数。
  - 添加与参数的数据类型（如数字输入）相对应的输出控件。
选择创建的按钮，在 OnSelect 属性中输入函数，例如 Environment.new_calculatesum。
映射每个输入参数 Value 以引用相应的输入控制：
- 如果函数为 Environment.new_CalculateSum({ X: Value, Y: Value });，则可将其改写为：Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });。
- 要设置函数“结果”输出，请将公式更新为 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'。
选择输出控件，并使用公式“result.z”设置“Value”属性。

预览应用，输入输入值 1 和 2，然后选择按钮。结果应显示在输出字段中。

按照从 Web 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

需要读取环境语言对象以访问现有画布应用内的新功能。对于将环境表数据源添加到现有画布应用程序后创建的任何函数，必须删除并重新插入 Power Fx 环境语言对象。然后，您就可以看到作为操作的函数更新列表。
嵌套支持。函数只能调用 Microsoft 通过 Power Fx 表达式发布的 Microsoft 操作。
某些 Collect 场景需要 Patch。 Collect() 在某些场景中不起作用。解决方法是按照此处的填充相关列示例所示使用 Patch()。

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

如果在创建或运行函数时遇到问题，请使用 trace() 函数进行调试，或前往 Dataverse 中的函数限制了解可能出现的常见问题。

启用跟踪后，就可以开始使用 trace() 函数调试 Power Fx 公式了。进一步了解如何在 Power Fx 表达式中使用 trace() 函数：Trace 函数 - Power Platform。

对于 Microsoft Dataverse 低代码插件提示和已知问题中未涵盖的功能问题，请使用帮助 + 支持体验并包括以下信息：