在 Microsoft Dataverse 中创建和使用函数（预览）

2025-03-05

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

在 Microsoft Dataverse 中创建和使用可重复使用的函数。函数使用 Power Fx 在运行服务器端的 Dataverse 中执行一组特定命令。

重要提示

这是一项预览功能。
预览功能不适合生产使用且功能可能受限。这些功能在正式发布之前已经可用，以便客户可以抢先体验并提供反馈。

先决条件

Power Platform 环境中的系统定制者安全角色成员资格。

在解决方案中创建函数

转到 Power Apps，然后在左侧导航窗格中选择解决方案。如果项目不在侧面板窗格中，请选择 …更多，然后选择所需项目。
打开要创建函数的解决方案。
在命令栏中选择新建>自动化>函数。
在出现的新函数侧面板中输入以下信息。
- 提供函数的显示名称和说明。
- 选择新输入参数和/或新输出参数，然后提供参数名称和数据类型。根据需要添加更多输入和输出参数。
- 在表格引用列表中，可以选择表格。您可以使用数据收集函数（如 Filter() 和 LookUp() 函数）引用您选择的 Dataverse 表。
- 在公式框中输入 Power Fx 表达式。
选择保存。
测试函数。

按名称引用公式中的输入参数。

输出参数必须在花括号内引用，例如 { Out: "Return value" }。

小费

注意公式框中的 intellisense。带下划线的红色表示无效。黄色波纹表示您的逻辑可能受委托限制的影响。可通过使用可委托函数来避免委托问题。
展开“高级选项”以查看架构名称。

函数示例

本节提供了一些示例函数。

计算两个整数之和

输入显示名称，如 new_calculateSum，以及说明。
添加两个输入参数 x 和 y（数据类型均为整数）和一个输出参数 z（数据类型整数）。
在公式框中输入公式：
{ z:x+y }
测试函数。

为文章表格添加新标题

创建两个输入参数 title 和 url（均具有字符串数据类型）和一个输出变量 message（数据类型字符串）。
在表参考下拉菜单中选择知识联合文章表。
在公式框中输入公式：

Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

验证输入字符串是否包含所选字符串

创建一个输入参数 DocumentTextInput（数据类型为字符串）和一个输出变量 result（数据类型为字符串）。
在公式框中输入公式：

{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

计算酒店住宿价格

创建 6 个输入参数：nights、rooms、tax、discount、roomservice、ratepernight（均具有字符串数据类型）和一个输出变量 price（数据类型 float）。
在公式框中输入公式：

{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

编辑、测试或删除函数

编辑函数

在函数区域选择函数。
在命令栏上，选择编辑。
修改公式，然后保存。

测试函数

在函数区域选择函数。
在命令栏中选择测试。
输入函数中定义的输入参数值，然后选择播放。

成功的测试将返回一个 OData 回复，其中包括组织 URI、函数名称以及输出参数和值等信息。

小费

使用输出参数帮助验证预期行为和结果。否则，您只能在测试时观察成功或失败。

删除函数