测试和分发自定义连接器

重要提示

此功能的部分或全部属于预览版内容。 相关内容和功能可能会发生更改。

本文提供有关如何在 Microsoft Sustainability Manager 中测试和分发自定义数据导入连接器的信息。

测试连接器 UI

通过以下步骤,您可以看到连接器的 UI 是什么样子的。

  1. 按照导出解决方案中的步骤导出您先前创建的 Power Platform 解决方案。 确保您导出的解决方案版本号高于当前版本。 您将在添加之前创建的 XML 文件后重新导入解决方案。

  2. 提取您导出的 ZIP 文件,并创建一个名为资产的新文件夹。

  3. msdyn_dataconnectors.xml 文件(以及 Power Query 模板连接器的 msdyn_dataflowtemplates.xml 文件)保存在资产文件夹中。

    对于 Power Automate 连接器,您的文件夹结构现在应该如下所示:

    显示 Power Automate 连接器 ZIP 文件中的文件夹和文件的屏幕截图。

    对于 Power Query 模板连接器,您的文件夹结构应该如下所示:

    显示 Power Query 模板连接器 ZIP 文件中的文件夹和文件的屏幕截图。

  4. 选择所有文件,将其压缩为 ZIP 文件。 当您打开新创建的 ZIP 文件时,顶级文件夹结构应该包含以下项目:

    • Assets 文件夹
    • [内容类型] 文件
    • customizations.xml 文件
    • solution.xml 文件
    • 模板解决方案 ZIP 文件(对于 Power Query 模板连接器)
  5. 按照导入解决方案中的步骤,将 ZIP 文件重新导入导出它的 Power Platform 环境中。

  6. 导入成功完成后,该环境中会显示一个连接器。 在 Sustainability Manager 中,在左侧导航的数据区域中,选择导入。 选择新建,然后选择数据提供程序连接器。 您的连接器磁贴将显示在下一页上。 选择您的连接器磁贴,然后选择下一步

    对于 Power Automate 连接器,将显示您设计的凭据窗体的 UI。 您可以确保它看起来正确,并通过此页面调试窗体。

    对于 Power Query 模板连接器,将显示 Power Query 模板导入体验。

    如果您要进行任何更改,请按照步骤导出解决方案,更新 msdyn_dataconnectors.xml 文件,然后重新导入。 确保导出的版本高于当前版本。

  7. 您可以使用示例值填充窗体并保存。 要检查这些值的存储方式,在 Power Apps 中,选择。 选择所有,搜索 msdyn_providercredential。 表中的数据将显示。 如果这是您第一次创建连接,应该只有一个凭据记录。 检查凭据列,查看您在窗体中提供的值是如何存储的。

    显示 msdyn_providercredential 表中凭据列的屏幕截图。

错误处理测试

对于 Power Automate 连接器,处理连接流中的错误非常重要。 如果由于某种原因,流中的任意步骤失败,数据导入状态将卡在已计划

要测试此事件,将您的操作添加到 try/catch 块中的流中。 在 catch 块中,将连接和连接刷新进行失败处理。

如果连接失败,您的用户应该能够使用您的连接器 UI 的 JSON 中包含的支持链接与您联系。 此 JSON 显示在步骤 2:创建连接器记录中。

要使连接和连接刷新失败,对连接刷新连接记录使用更新行 Dataverse 操作。

  • 对于连接刷新记录,将刷新状态字段设置为失败

    显示如何在 Power Automate 流中将连接刷新记录刷新状态字段设置为“失败”的屏幕截图。

  • 对于连接记录,将状态字段设置为错误

    显示如何在 Power Automate 流中将连接记录状态字段设置为“错误”的屏幕截图。

有关详细信息,请转到使用流更新行

有关错误处理的详细信息,请转到 Power Automate 流的错误处理最佳做法

测试连接器

创建连接器后,您可以按照导出解决方案中的步骤将其导出为托管解决方案。

将您导出的解决方案导入安装了 Sustainability Manager 的其他环境,并测试您的解决方案以确保它按预期工作。

分发连接器

完成测试后,您可以将解决方案直接私下分发给用户,或通过 Microsoft AppSource 公开分发。 有关通过 AppSource 分发的更多信息,请转到在 AppSource 上发布应用