练习 - 通过 Azure 逻辑应用中的工作流创建和调用自定义连接器

  • 10 分钟

你具有一个名为 Print Framer API 的 Web API，它根据发送给它的尺寸计算相框的成本。 整个公司的开发人员都希望在 Azure 逻辑应用工作流中使用此 API，但是目前没有办法实现这种连接。

在本练习中，你将为 Print Framer API 创建自定义连接器，并将其用于在逻辑应用工作流和 Web API 之间发送和接收数据。 首先，需要一个逻辑应用工作流。

创建逻辑应用工作流

  1. 在 Azure 门户菜单上或在“主页”中，选择“Azure 服务”下的“创建资源”。 此时会显示“创建资源”窗格。

  2. 在左侧菜单窗格中，选择“集成”，找到并选择“逻辑应用”。

  3. 在“创建逻辑应用”窗格的“基本设置”下，为每个设置输入以下值。

    设置 值
    项目详细信息
    订阅 Concierge 订阅
    资源组 选择 沙盒资源组
    实例详细信息
    逻辑应用名称 提供唯一名称。 记下名称以供稍后使用。
    发布 工作流
    区域 选择你附近的区域。
    启用日志分析 否
    规划
    计划类型 消耗
    区域冗余
    区域冗余 保留为默认设置（禁用）

    使用免费沙盒，可以在部分 Azure 全球区域中创建资源。 创建资源时，请从下面的列表中选择一个区域：

    • 美国西部 2
    • 美国中南部
    • 美国中部
    • 美国东部
    • 西欧
    • 东南亚
    • Japan East
    • Brazil South
    • Australia Southeast
    • 印度中部

  4. 选择“查看 + 创建”，然后在验证成功后选择“创建”。

  5. 门户创建逻辑应用资源后，选择“转到资源”。

    Azure 门户显示了一个包含常用触发器和工作流模式的库。

  6. 在左侧菜单中选择“逻辑应用设计器”，然后选择“添加触发器”。

  7. 搜索并选择“当收到 HTTP 请求时”。

    工作流设计器现在显示所选的触发器。

  8. 在“高级参数”部分中选择“全部显示”。

  9. 在“方法”下拉列表中选择“GET”。

  10. 在“相对路径”字段中输入 {height}/{width} 作为字面量字符串。

    显示“请求触发器”信息的屏幕截图。

  11. 在设计器工具栏上选择“保存”。

现在，我们就有了一个基本逻辑应用工作流。 接下来添加自定义连接器，以便可以通过工作流调用自定义 PrintFramer API。

在 Azure 门户中新建自定义的 Azure 逻辑应用连接器

  1. 在 Azure 门户菜单上或在“主页”中，选择“Azure 服务”下的“创建资源”。 此时会显示“创建资源”窗格。

  2. 在搜索框中，找到并选择“逻辑应用自定义连接器”。

  3. 在“逻辑应用自定义连接器”窗格中，选择“创建”。

  4. 在“创建逻辑应用自定义连接器”窗格的“基本设置”下，为每个设置输入以下值。

    设置 值
    项目详细信息
    订阅 Concierge 订阅
    资源组 选择 沙盒资源组
    实例详细信息
    自定义连接器名称 PrintFramerConnector
    区域 选择沙盒也支持的最近的区域。
    关联集成服务环境 保持未选中状态

  5. 选择“查看 + 创建”。 验证成功后，选择“创建”。

  6. 部署完成后，选择“转到资源”。

导入 OpenAPI 定义

现在，使用之前保存的 OpenAPI 文件来定义自定义连接器。

  1. 在 Azure 门户上或在门户主页中，选择“所有资源”，然后选择“PrintFramerConnector”。

  2. 在“概述”页上，选择“编辑”。

    显示自定义连接器的编辑器的屏幕截图。

  3. 在“自定义连接器”部分，依次选择“OpenAPI 文件”和“导入”。 打开在上个练习中保存的 JSON 文件。

配置自定义连接器

OpenAPI 文件规定自定义连接器在 Web API 中可进行的操作。 以下是必须为自定义连接器设置的一些其他属性。

  1. 在“一般信息”部分的“说明”框中，输入“获取相框的估计值”。 可能必须向下滚动才能看到配置窗格的这一部分。

  2. 在“主机”文本框中，输入之前记下的示例 URL。

  3. 在“安全”窗格上，确保选中“无身份验证”。

    重要

    对于本演示，无需任何身份验证即可访问 API。 如果是包含敏感数据或需要付费订阅的实际 API，身份验证必不可少。

  4. 在“定义”窗格的“摘要”文本框中，输入“估算相框成本”。

  5. 在“可见性”下，选择“重要”。

  6. 在窗格顶部，选择“更新连接器”。

将自定义连接器添加到逻辑应用工作流

现在，可以在逻辑应用工作流中使用自定义连接器。

  1. 在 Azure 门户上或门户主页中，选择“Azure 资源”下的“所有资源”，然后选择在第 3 单元中创建的逻辑应用资源。

  2. 在逻辑应用资源菜单中，选择“概述”。 在“概述”窗格工具栏中，选择“编辑”。

  3. 在设计器上，选择“新建步骤”>“添加操作”。

  4. 在“选择操作”搜索框下，选择“自定义”，然后选择 PrintFramerConnector。

  5. 在“操作”下，选择“估算相框成本”。

  6. 在“估计相框成本”框中，将光标放在“高度”字段中。 从打开的动态内容列表中，选择“高度”。

    以下屏幕截图演示了此选择：

    该屏幕截图显示了自定义连接器，以及在动态内容列表中选择的“高度”参数。

  7. 返回到自定义连接器，将光标放在“宽度”字段中。 在动态内容列表中，选择“宽度”。

    从触发工作流的每个 HTTP 请求接收的高度和宽度参数现已绑定到传递给 PrintFramerConnector 的高度和宽度参数。

完成工作流

最后，工作流需要一种显示结果的方法。 可以使用“响应”操作来显示估计值：

  1. 在工作流设计器中，选择“新建步骤”。

  2. 在“选择操作”搜索框中，输入“响应”，然后选择名为“响应”的操作。

  3. 在“正文”字段中，输入“相框大致成本为：$”。

  4. 在打开的“动态内容”列表中，选择“估计相框成本”部分中的“正文”。

    以下屏幕截图显示了此选择：

    该屏幕截图显示了“响应”操作的设置。

  5. 完成后，选择“保存”以保存工作流。

测试工作流

工作流现已完成，并将通过自定义连接器调用 Web API。 现在，你只需发送一个触发工作流的请求，可使用浏览器来完成该操作。

  1. 在工作流设计器中，展开“何时接收 HTTP 请求”操作。

  2. 在“HTTP GET URL”字段旁，选择“复制 URL”。

  3. 打开新的浏览器选项卡并将 URL 粘贴到地址栏。

  4. 在粘贴的 URL 中，将 {height} 参数替换为 10。 将 {width} 参数替换为 4。 按 Enter。

    此浏览器窗格显示大致成本。

  5. 尝试输入其他高度和宽度。

恭喜！ 你已创建可通过自定义连接器调用内部 Print Framer API 的逻辑应用工作流！