练习 - 使用策略模板动态设置主机 URL

10 分钟

在本练习中，您将创建策略模板以便在创建连接时设置主机 URL。本流程允许将连接用于测试或生产。

本练习要求安装 Python 并访问用于本练习的计算机上的命令提示。

重要提示

使用已预配 Microsoft Dataverse 的测试环境。如无社区计划，您可以注册社区计划。

注意

将以下文件下载到本地计算机来完成本练习 Contoso Invoicing 触发器。选择屏幕中部右侧的下载按钮。

任务 1：导入解决方案

在本任务中，您将导入包含 Contoso Invoicing 自定义连接器的非托管解决方案。您将使用本连接器完成本练习中的任务。

转到 Power Apps Maker Portal 并确保您处于正确的环境中。
选择解决方案 > 导入解决方案。
选择浏览。
选择 ContosoInvoicingPolicyTemplates_1_0_0_2.zip 解决方案，然后选择打开。
选择下一步。
选择导入，然后等待导入完成。您应在导入完成后收到成功消息。
选择发布所有自定义项并等待发布完成。
打开您导入的 Contoso Invoicing - Policy Templates 解决方案。

您应看到 Contoso Invoicing - Policy 自定义连接器组件。

任务 2：安装 Microsoft Power Platform CLI

Microsoft Power Platform CLI 包括旨在辅助 Microsoft Power Platform 自定义连接器开发的 paconn 命令行工具。 Paconn 工具使用 Python 运行时，因此您也需要安装 Python 运行时。

转到下载 Python 并选择下载 Python。您可以使用任意高于 3.5 的版本。
选择下载的 .exe 文件开始安装。
选中添加 Python xx 到路径复选框，选择安装，然后等待安装完成。
安装完成后关闭安装向导。
启动命令提示，然后运行以下命令安装 paconn。

pip install paconn
等待安装完成。

任务 3：在本地下载连接器

本任务要求您在本地下载连接器定义文件，以添加 主机 URL 属性。

运行登录命令。

paconn login
复制提供的代码。
在浏览器中，使用与环境相同的凭据登录。转到 Microsoft 设备登录，粘贴复制的代码并选择下一步。
提供您的凭据。
选择继续。
您应收到成功登录的消息。
返回命令提示并运行下载命令。

paconn download
系统提示选择环境时，输入您安装解决方案的环境的编号，然后按Enter键。
应仅列出一个连接器：Contoso Invoicing Policy。再次按Enter键选择该连接器。
下载应成功完成。请注意连接器的下载位置。

任务 4：编辑 apiProperties.json 添加主机 URL 属性

在本任务中，您将编辑 apiProperties.json 文件配置 hostUrl 属性。配置属性后，将向创建连接的用户提示本值以及 API 密钥。

转到您在之前的任务中下载的文件夹，然后打开apiProperties.json文件。

在 ConnectionParameters 中的 api_key 属性之前粘贴 JSON。

"hostUrl": {
        "type": "string",
        "uiDefinition": {
          "constraints": {
            "required": "true"
          },
          "description": "Specify your API Url e.g. https://test.contoso.com",
          "displayName": "API URL",
          "tooltip": "Specify your API Url e.g. https://test.contoso.com"
        }
      },

保存更改。
转到命令提示符，将目录改为下载的文件夹。
运行 update 命令。

paconn update --api-def apiDefinition.swagger.json --api-prop apiProperties.json --icon icon.png
选择安装解决方案的正确环境。
选择 Contoso Invoicing - Policy 连接器。

更新应成功完成。

任务 5：添加“设置主机名称”策略

在本任务中，您将配置设置主机名称策略模板，以使用您在之前的任务中配置的连接属性。

转到 Power Apps 制作者门户并确保选择正确的环境。
选择解决方案，然后打开您导入的 Contoso Invoicing - Policy Templates 解决方案。
选择 Contoso Invoicing - Policy 自定义连接器，然后选择编辑。
选择定义选项卡。
向下滚动到策略部分并选择+ 新建策略。
在名称中输入主机 URL 策略，然后为模板选择设置主机 URL。
为URL 模板输入@connectionParameters('hostUrl')，然后选择更新连接器。

连接器应更新成功。
请勿离开本页面。

任务 6：测试

在本任务中，您将使用新配置创建连接，然后进行测试。

启动新的浏览器窗口，然后转到 Contoso Invoicing。
选择API 密钥链接。
复制API 密钥。
返回连接器。
选择测试选项卡。
选择+ 新建连接。
为API URL输入 https://contosoinvoicingtest.azurewebsites.net/，粘贴复制的API 密钥，然后选择创建连接。
选择刷新连接。
选择ListInvoice > 测试操作。

测试应返回发票。