使用英语阅读

通过


使用 Power Pages 中的 Power Fx(预览版)

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

Power Fx是用于跨 Microsoft Power Platform 表达逻辑的低代码语言。 它是一种强类型、声明性、一般用途的函数式编程语言。

Power Fx 以人性化的文本表达。 它是一种低代码语言,制作者可以直接在类似 Excel 的公式栏中使用。 低代码中的“低”是由于语言的简洁性和简单性,让制作者和开发人员都可以轻松进行一般的编程任务。

备注

您可能会发现创作 Power Fx 公式的语法与您在 Power Apps 或 Power Automate 中习惯的语法有些不同。 若要启动 Power Fx 表达式,必须在 Excel 中以 '='(等号)开头。 有关更多信息,请参阅重要注意事项

Power Fx 支持全方位的开发,从没有任何编程知识的无代码人员到专业开发人员。 这有助于不同团队之间的协作,从而帮助他们节省时间和工作。

重要

  • 这是一项预览功能。
  • 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前推出,以便客户可以提前使用并提供反馈。
  • 该功能在 Power Pages 版本 9.6.5.x 中提供。

使用 Power Pages 中的 Power Fx

在网站 Power Pages 中, Power Fx 可用作用于以下组件及其属性的表达式语言。 此功能有助于根据 Power Fx 表达式的结果动态赋值。

组件 属性
文本 文本
Image 图像 URL,替代文本
Button 按钮 URL、按钮文本
Iframe Iframe URL

使用 Power Fx 公式栏

工具栏包括一个新的 fx 命令,用于支持 Power Fx 的组件:

文本控件命令栏中 Power Fx 命令的屏幕截图。

选择 fx 以访问 Power Fx 公式栏。

公式栏组件

下面的屏幕截图突出显示了公式栏的一些重要组件:

Power Pages 中 Power Fx 公式栏的屏幕截图。

  1. 下拉菜单允许您从可用组件属性中选择。

  2. 多行可展开文本框允许创作 Power Fx 公式。

  3. 重置按钮将组件属性设置为其默认值。

  4. 保存按钮会保留组件属性的公式和表达式。 如果结果值可用,并且可以显示在文本属性中,工作室画布会立即更新。

公式栏体验

下面是一些以开发人员为中心的功能,提高工作效率:

  • 自动完成帮助:建议公式、参数、表格和对象。 选择Ctrl + 空格来手动访问此功能。

    Power Fx 中的自动完成体验截图。

  • 查看问题功能:有助于对公式和表达式进行早期验证和调试。

    Power Fx 公式检测出问题时的体验截图。

  • 未保存的更改对话框:当公式有未保存的更改时,如果您离开公式栏,则会显示该对话框。

    带有“返回”或“放弃”选项的未保存更改对话框的屏幕截图。

    选择返回继续编辑公式,或选择放弃放弃更改。

重要考虑因素

在 Power Pages 中使用 Power Fx 公式栏时,请考虑以下准则:

  • 以等于符号开始:可以直接输入文本作为值。 要启动 Power Fx 表达式,则应该以 '='(等号)开头,如下例所示:

    =Concatenate("Hello, ", User.FullName)
    
  • 安全地访问表:Dataverse 可以使用公式安全地访问表。 首先验证是否正确配置了表权限。 此外,使用用户对象可以获得站点用户的上下文。 例如,以下表达式检索当前已通过身份验证的用户的 DataverseUserId 值。

    =Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
    

    备注

    用户对象代表 Power Pages用 户,因此不支持与用户函数相同的属性集。

  • 在文本中插入值:若要在文本中插入值,请使用以下语法。

    This text ${variable/ expression} includes a dynamic value.
    

    例如:

    The total number is ${Sum(10, 20)}
    

可用的 Power Fx 功能

有关 Power Pages 中所有可用函数的完整列表,请访问公式参考 – Power Pages

已知问题和限制

  • Power Pages 目前不支持通过 IntelliSense 提供的某些 Power Fx 功能。 这些函数在使用时显示以下设计时间错误:

    Parameter 'Value': PowerFx type is not supported.

  • 系统不会为匿名用户初始化用户,这会导致您在任何表单上使用它时出现以下错误,包括检查空白。 此问题将在未来的版本中得到解决。

    UserInfo object was not added to service

  • 当使用包含双引号的 Power Fx 公式或表达式设置值时,一些用户可能会看到按钮和图像 URL 属性不起作用的问题。 此问题仅在您的版本为 9.6.3.x 时发生,并且在您的 Power Pages 网站升级到版本 9.6.5.x 时得到修复。

常见问题解答

我应该用 Power Fx 代替 Liquid 吗?

Power Fx 以低代码方式实现某些动态数据场景,这也可以通过 Liquid 代码和专业开发人员工具来实现。 Power Fx(目前位于公开预览版阶段)建议进行试用或试用站点评估。 在此阶段,欢迎您提供反馈。 Liquid 是一个正式发布 (GA) 的功能,相对来说提供的功能更多。 将 Liquid用 于您的生产网站,尤其是在关键和复杂的方案中。

另请参见