Power Apps 代码应用系统配置

本文介绍如何Power Apps代码应用托管已编译的应用资产、如何控制标头可见性以及如何自定义用户无权访问应用时显示的文本。

公开托管的代码应用资产

使用 pa app push 将代码应用发布到 Power Platform 时,会在可公开访问的终结点上托管已编译的应用资产。 此终结点当前不支持基于 IP 的访问限制。 由于代码应用使用Microsoft Entra ID进行身份验证,因此请使用条件访问按位置或 IP 控制访问。 不要在应用中存储敏感用户或组织数据。 将此类数据存储在数据源中,以便在播放应用的最终用户通过身份验证和授权检查后检索内容。

播放应用时隐藏 Power Apps 标头

可通过两种方法隐藏应用的所有用户或特定应用 URL 的标头。

Method Description
配置应用设置以隐藏标头 使用 Power Apps CLI 为所有应用用户隐藏标头。
添加查询字符串参数以隐藏标头 添加参数以隐藏特定应用 URL 的标头。

配置应用设置以隐藏标头

使用 pa app set-setting 可默认隐藏标头。 从初始化的代码应用项目运行命令:

pa app set-setting --show-header false

该命令将设置添加到 power.config.json. 若要查看当前的应用设置,请运行:

pa app get-settings

发布应用以使此设置生效:

pa app push

若要再次显示标头,请设置为--show-headertrue,然后发布应用。

若要以交互方式配置标头,请运行 pa app set-setting 而不设置标志并选择 show-header。 在 “显示应用标题栏?”中,选择“ 是 ”以显示标题或 “否 ”可隐藏它。

添加查询字符串参数以隐藏标头

若要在不更改应用设置的情况下隐藏特定应用 URL 的标头,请在共享 URL 时追加 hideNavBar=true 查询字符串参数。

标头可见:

https://apps.powerapps.com/play/e/{environment-id}/a/{app-id}

标头已隐藏:

https://apps.powerapps.com/play/e/{environment-id}/a/{app-id}?hideNavBar=true

如果 URL 已包含查询字符串参数,请改为追加 &hideNavBar=true 。

自定义请求访问文本

自定义用户在无权访问代码应用时显示的标题和消息。 使用消息说明如何请求访问权限,例如联系管理员。

Important

自定义文本不会授予访问权限或更改应用权限。 若要授予访问权限,请使用 与用户共享应用。

从包含 power.config.json 文件的初始化代码应用项目运行以下命令:

pa app set-setting --customize-request-access true --request-access-title "Request access" --request-access-message "Contact your administrator to request access."

若要以交互方式配置文本,请运行 pa app set-setting 而不设置标志并选择 customize-request-access。 选择是否启用自定义。 启用它时,请在提示符处输入标题和消息。 禁用它时,该命令将跳过内容提示并保留保存的标题和消息。

查看本地设置,然后发布应用以应用更改:

pa app get-settings
pa app push

使用 pa app get-settings --json 以 JSON 格式读取设置。

若要禁用自定义,请运行以下命令。 禁用自定义会保留保存的标题和消息供以后使用。

pa app set-setting --customize-request-access false
pa app push

power.config.json 中的应用设置

CLI 将标头可见性和请求访问自定义存储在 appSettings 的 power.config.json 对象中。 例如,以下配置隐藏标头并启用自定义请求访问文本:

{
  "appSettings": {
    "showHeader": false,
    "customizeRequestAccess": {
      "enabled": true,
      "title": "Request access",
      "messageBody": "Contact your administrator to request access."
    }
  }
}

这两个设置都是可选的。 使用 pa app set-setting 更新它们。

财产 要求和默认行为
showHeader 一个布尔值。 如果省略,则显示标头。
customizeRequestAccess.enabled 一个布尔值。 如果省略,则会禁用自定义。
customizeRequestAccess.title 启用自定义项时是必需的。 必须是非空白且不超过 100 个字符。 禁用时可选,但提供的任何值必须满足相同的要求。
customizeRequestAccess.messageBody 启用自定义项时是必需的。 必须是非空白且不超过 1,000 个字符。 禁用时可选,但提供的任何值必须满足相同的要求。

pa app set-setting 仅更新指定的字段,并保留未指定的字段和不相关的设置。 它在保存之前验证合并的设置。 可以通过提供有效值来替换无效保存的字段值,但格式不正确的设置容器或仍包含无效值的结果将被拒绝。 pa app push 还会在发布之前验证设置。