在工作流中使用外部 API

注意

Microsoft Purview 数据目录 (经典) 和数据运行状况见解 (经典) 不再接受新客户,这些服务(以前为 Azure Purview)现在处于客户支持模式。

重要

此功能目前处于预览阶段。 Microsoft Azure 预览版的补充使用条款包括适用于 Beta 版、预览版或其他尚未正式发布的 Azure 功能的其他法律条款。

可以使用工作流通过 Microsoft Purview 自动执行某些业务流程,而 HTTP 连接器和分析 JSON作允许将工作流与外部应用程序集成。

HTTP 连接器

HTTP 连接器使用表述性状态传输 (REST) 体系结构,该体系结构允许Microsoft Purview 工作流使用 Web 请求直接与非Microsoft应用程序交互。

HTTP 连接器在所有工作流模板中均可用。

注意

若要创建或编辑工作流,需要 Microsoft Purview 中的 工作流管理员角色 。 还可以联系集合中的工作流管理员,或联系集合管理员获取权限。

  1. 若要添加 HTTP 连接器,请选择 + 要添加的模板中的图标,然后选择 HTTP 连接器。

    如何添加 HTTP 连接器的屏幕截图。

  2. 选择 HTTP 连接器后,填写以下参数:

    1. 主机 - 执行此连接器时要调用的请求 URL。
    2. 方法 - 选择以下方法之一。 GET、PUT、PATCH、POST 和 DELETE。 这些方法对应于创建、读取、更新和删除作。
    3. 路径 - 可以选择输入请求 URL 路径。 可以为此参数使用动态内容。
    4. 标头 - (可选)可以输入 HTTP 标头。 HTTP 标头允许客户端和服务器通过 HTTP 请求或响应传递其他信息
    5. 查询 - (可选)可以传递查询。
    6. 正文 - (可选)可以在调用 URL 时传递 HTTP 正文
    7. 身份验证 - HTTP 连接器与 Microsoft Purview 凭据集成。 根据 URL,可以调用以下三种类型之一:
      1. (无身份验证)
      2. 基本身份验证 - 使用 已创建的基本身份验证凭据
      3. 服务主体 - 使用 已创建的服务主体凭据和受众。 受众将是访问令牌的预期使用者。 Microsoft Purview 受众,例如: https://purview.azure.net/.default 确保服务主体有权调用相应的服务,例如 ARM。

    如何添加 HTTP 连接器属性的屏幕截图。

  3. 默认情况下,HTTP 连接器的安全设置处于打开状态。 若要关闭安全输入和输出,请选择省略号图标 (...) 转到设置。

    如何添加 HTTP 连接器设置的屏幕截图。

  4. 现在会显示 HTTP 连接器的设置,并且可以关闭安全输入和输出。

    有关如何添加 HTTP 连接器安全输入和输出的屏幕截图。

分析 JSON作

通过工作流中的分析 JSON作,可以从 HTTP (或任何其他作/连接器) 获取传入 JSON,并分析 JSON 以提取要在工作流中使用的值。

分析 JSON作在所有工作流中都可用。

工作流分析 JSON作的屏幕截图,其中显示了用示例数据填充的参数。

分析 JSON作有两个参数:

  • Content - 应包含要分析的 JSON 的变量。
  • 架构 - 传入 JSON 的架构,它允许工作流分析传入的信息。 可以自行提供,也可以使用“ 从示例生成 ”按钮。 如果从示例生成,则会输入示例 JSON 有效负载,并且将自动生成架构。

分析 JSON作后工作流中的作和连接器将能够使用从 JSON 提取的值,方法是选择“添加任何参数的 动态内容 ”。

另一个连接器的屏幕截图,其中添加了分析 JSON作中的值。

后续步骤

有关工作流的详细信息,请参阅以下文章: