练习 - 在解决方案中新建连接器

已完成

在本练习中,您将为名为 Contoso Invoicing 的现有 API 创建您的第一个自定义连接器。

重要提示

使用已预配 Microsoft Dataverse 的测试环境。 如果您没有测试环境,可以注册 Power Apps 社区计划

任务 1:查看 API

要查看 API,请按照以下步骤操作:

  1. 转到 Contoso Invoicing

  2. 选择文档链接。

    指向 API 文档链接的箭头 - 屏幕截图。

  3. 查看可用的操作。

  4. 选择以展开和查看每个操作。

  5. 关闭文档浏览器选项卡或窗口。

  6. 选择打开 API 定义链接。

  7. 下图显示了文档页面上显示的 OpenAPI 版本示例。 右键单击并选择另存为

    箭头指向“另存为”按钮 - 屏幕截图。

  8. 本地保存文件。 您将稍后在练习中使用本文件。

  9. 关闭定义浏览器选项卡或窗口。

  10. 选择API 密钥链接。

  11. 复制并保存 API 密钥,以便稍后使用。

    用于 Contoso Invoicing 的 API 密钥 - 屏幕截图。

  12. 选择返回到主页

  13. 选择下载徽标

  14. 将徽标图像保存到本地以供后续使用。

任务 2:新建解决方案

要创建新解决方案,请按照以下步骤操作:

  1. 转到 Power Apps 制作者门户并确保您处于正确的环境中。

  2. 选择解决方案 > + 新建解决方案

  3. 显示名称输入 Contoso invoicing,为发布者选择 CDS 默认发布者,然后选择创建。 处理真实项目时,最好创建自己的发布者。

    创建新的 Contoso Invoicing 解决方案 - 屏幕截图。

  4. 选择创建后,请勿离开本页面。

任务 3:创建新连接器

要创建新连接器,请按照以下步骤操作:

  1. 打开您创建的 Contoso Invoicing 解决方案。

  2. 选择 + 新建 > 自动化 > 自定义连接器

    箭头指向创建新自定义连接 - 屏幕截图。

  3. 连接器名称输入 Contoso invoicing,然后选择上传图像。

    箭头指向上传图标图像按钮 - 屏幕截图。

  4. 选择在任务 1:查看 API 中下载的连接器徽标图像。

  5. 图标背景色中输入 #175497

  6. 描述中输入 Contoso Invoicing API

  7. 主机中输入 contosoinvoicingtest.azurewebsites.net

  8. 选择创建连接器

    箭头指向创建连接器按钮 - 屏幕截图。

  9. 请勿离开本页面。

任务 4:导入 OpenAPI 定义

要导入 OpenAPI 定义,请执行以下步骤:

  1. 选择连接器名称颜色旁边的箭头。

    箭头指向后退按钮 - 屏幕截图。

  2. 选择连接器的省略号 (...) 按钮,然后选择从 OpenAPI 文件更新

    箭头指向“从 open API 文件更新”按钮 - 屏幕截图。

  3. 选择导入

  4. 选择在任务 1:查看 API 中下载的 swagger.json 文件,然后选择打开

  5. 选择继续

  6. 填写主机 URL 为 contosoinvoicingtest.azurewebsites.net,然后选择安全性

    箭头指向安全性选项卡 - 屏幕截图。

  7. 请注意,该字段已从导入的文件中填写。

  8. 请勿离开本页面。

任务 5:查看和调整定义

要查看和调整定义,请按照以下步骤操作:

  1. 选择定义选项卡。

  2. 请花几分钟时间查看导入的操作。

  3. 请注意 GetInvoice 旁边指示警告的橙色三角形。

  4. 选择 GetInvoice 操作。

    箭头指向获取发票 - 屏幕截图。

  5. 请注意,该操作指示缺少摘要

  6. 输入获取发票作为摘要,以提高可用性。

    获取发票操作摘要 - 屏幕截图。

  7. 请注意 PayInvoice 操作上的蓝色信息圆圈,这指示缺少描述

  8. 输入支付发票作为说明

  9. 删除这两个 NewInvoice 操作,因为您不会使用它们。

    箭头指向删除按钮 - 屏幕截图。

  10. 选择 GetInvoiceSchema 操作。

  11. 可见性选项修改为内部,这样用户就不会在其操作列表中看到它。

  12. 选择更新连接器

    箭头指向“更新连接器”按钮 - 屏幕截图。

  13. 请勿离开本页面。

任务 6:测试连接器

要测试连接器,请按照以下步骤操作:

  1. 选择测试选项卡。

  2. 选择+ 新建连接

    箭头指向新连接按钮 - 屏幕截图。

  3. 粘贴在任务 1:查看 API 中保存的 API 密钥,然后选择创建连接

  4. 选择刷新按钮。

    箭头指向“刷新”按钮 - 屏幕截图。

  5. 选择 ListInvoiceTypes > 测试操作

    箭头指向“测试操作”按钮 - 屏幕截图

您应该会在正文区域中看到一些发票数据。