在画布应用中使用数据源环境变量

本文介绍如何在画布应用中使用数据源环境变量。 您可以使用预先存在的数据源环境变量,也可以在连接到数据时自动创建数据源环境变量。

使用预先存在的数据源环境变量

可以跨其他应用甚至不同类型的资源(例如云流)重复使用环境变量。 你可能需要先在解决方案中创建它们,然后在编写画布应用和云端流时使用它们。 以下步骤使用 SharePoint Online 作为示例。

  1. 请按照以下步骤在解决方案中手动创建环境变量。
  2. 从解决方案编辑或创建画布应用。
  3. 为 SharePoint online 添加新数据源。
  4. 选择“高级”选项卡。可以看到一个经过筛选的可用环境变量列表,这些环境变量是您有权访问且与所设置的参数匹配的。 例如,选择 SharePoint 站点时,列表包含数据源环境变量,其中 连接器为 SharePoint,参数类型为 站点。 为给定站点选择 SharePoint 列表时,也是如此。 如果未显示现有变量,请参阅 “限制”和“故障排除”。
  5. 选择所需的环境变量,然后选择连接。

重要

  • 如果选择了其他解决方案中的环境变量,包含该环境变量的解决方案将存在依赖关系。 因此,请务必:
    • 在导出之前将环境变量添加到当前解决方案。
    • 在导入当前解决方案之前,确保将包含环境变量的解决方案导入到目标环境。

连接到数据时自动创建数据源环境变量

此选项提供简单性并确保始终将环境变量用于数据源,例如 SharePoint Online。 但是,有些客户喜欢提供自己的架构名称,因此应从解决方案创建它们。

注释

预先存在的画布应用不会自动使用数据源环境变量。 从应用中删除数据源,然后使用上述步骤将它们添加回去,以升级这些应用来使用环境变量。

  1. 从解决方案编辑或创建画布应用。

  2. 选择设置>常规,启用添加数据源时自动创建环境变量设置。

  3. 为 SharePoint online 添加新数据源。

  4. 选择一个 SharePoint 站点,一个或多个列表,然后选择连接。

    注释

    为了防止创建重复的环境变量,系统会提示在标识重复项时使用现有环境变量。 如果需要创建重复项,您可以清除使用现有环境变量的选项。

  5. 选择“保存”。

限制和故障排除

环境变量可以存在于你的环境中,而无需显示在 Canvas Studio 数据源选取器中。 如果找不到变量,请检查以下限制。

Canvas Studio 选取器限制

为支持的连接器(包括SharePoint和SQL Server)选择数据源环境变量时,适用此限制。 对于SQL Server,它适用于支持数据源环境变量的连接类型,例如Microsoft Entra连接。

Canvas Studio 数据源选取器仅检索与所选连接器和参数类型匹配的环境变量定义和值的第一页。 它不会检索后续页面。 每个 Dataverse 请求最多返回 5,000 条匹配记录,因此某些变量可能不会显示在 “高级 ”选项卡或其搜索结果中。 搜索缺失变量时,不会从后续页面中将其检索出来。

此限制适用于选取器,而不是 Dataverse 中 5,000 个环境变量的限制。 相关计数是每个请求的匹配定义或值数,而不是环境中所有连接器中的变量总数。

若要缓解此限制,请重用现有变量,并在检查其依赖项后删除过时的变量。 不要删除应用或流仍在使用的变量。 如果无法减少变量的数量,请考虑一个较小的环境,其中包含所需的变量和应用。 将变量移到同一环境中的不同解决方案不会减少该环境中的变量数。

特定于SharePoint的配置检查

除了跨受支持连接器应用的分页限制之外,SharePoint变量还必须满足以下配置要求:

  • 网站变量需要非空的当前值或默认值,其中包含 SharePoint 站点 URL。 选择器不会列出两个值均为空的站点变量。
  • 列表变量的值必须与为所选站点和连接返回的列表的唯一标识符(GUID)匹配,而不是列表的显示名称。 验证连接是否有权访问列表,以及变量是否包含其标识符。

另请参阅

使用 Dataverse 从头开始创建画布应用程序。
在 Power Automate 解决方案云端流中使用环境变量
环境变量概述