在 Azure 逻辑应用中创建和注册 SOAP 自定义连接器（预览）

  • 项目

[本主题是预发行文档，有可能会有所更改。]

要在 Azure 逻辑应用工作流中集成 SOAP 服务，可以使用描述 SOAP 服务的 Web Services 描述语言 (WSDL) 创建和注册自定义简单对象访问协议 (SOAP) 连接器。 SOAP 连接器的工作方式类似于预构建连接器，因此您可以像在逻辑应用中使用其他连接器那样使用它们。 目前，SOAP 自定义连接器不支持单向操作。

重要

  • 这是一项预览功能。

  • 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前已经可用，以便客户可以及早使用并提供反馈。

先决条件

若要注册您的 SOAP 连接器，需要：

  • Azure 订阅。 如果您没有订阅，则可以使用免费 Azure 帐户开始。 作为替代方法，您可以注册购买即用即付订阅。

  • 以下任一项：

    • 定义您的 SOAP 服务和 API 的 WSDL 文件的 URL。
    • 定义您的 SOAP 服务和 API 的 WSDL 文件。

    对于此过程，您可以使用我们的示例订单 SOAP 服务 (http://fazioapisoap.azurewebsites.net/FazioService.svc?singleWsdl)。

  • （可选）用作自定义连接器图标的图像。

1. 创建连接器

  1. 在 Azure 门户的 Azure 主菜单上，选择新建。

  2. 在搜索框中，输入逻辑应用连接器，然后选择 Enter。

    搜索“逻辑应用连接器”的屏幕截图。

  3. 从结果列表中选择逻辑应用连接器 > 创建。

    创建逻辑应用连接器的屏幕截图。

  4. 按照表中的说明输入有关注册连接器的详细信息。 完成后，选中固定到仪表板复选框，然后选择创建。

    逻辑应用自定义连接器详细信息的屏幕截图。

    属性 建议值 说明
    客户 soap-connector-name 为您的连接器输入一个名称
    预订 Azure-subscription-name 选择您的 Azure 订阅。
    资源组 Azure-resource-group-name 创建或选择一个用于组织 Azure 资源的 Azure 组。
    位置 部署区域 选择与您的逻辑应用相同的 Azure 区域。

Azure 部署连接器后，逻辑应用连接器菜单应会打开。 如果未打开，从 Azure 仪表板中选择 SOAP 连接器。

2. 定义连接器

指定用于创建连接器的 WSDL 文件或 URL、连接器使用的身份验证，以及 SOAP 连接器提供的操作和触发器。

2a. 为您的连接器指定 WSDL 文件或 URL

  1. 在连接器的菜单上，如果尚未选择，选择逻辑应用连接器。

  2. 在工具栏上选择编辑。

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

  3. 选择常规在这些表中提供详细信息，以为您的 SOAP 连接器创建、保护和定义操作和触发器。

    1. 对于自定义连接器，为您的 API 终结点选择 SOAP 提供描述您的 API 的 WSDL 文件。

      为 API 提供 WSDL 文件的屏幕截图

      选项 格式 说明
      从文件上载 WSDL WSDL-file 浏览到 WSDL 文件所在的位置，然后选择该文件。
      从 URL 上载 WSDL http://path-to-wsdl-file 输入您的服务的 WSDL 文件的 URL。
      SOAP 至 REST 不适用 将 SOAP 服务中的 API 转换为 REST API。

    2. 对于常规信息，为您的连接器上载图标。

      通常情况下，说明、主机和基本 URL 字段会自动从 WSDL 文件填充。 如果未填充，按照表中的说明添加此信息，然后选择继续。

      连接器详细信息的屏幕截图

      选项或设置 格式 说明
      上载图标 png-or-jpg-file-under-1-MB 表示您的连接器的图标

      颜色：最好是有彩色背景的白色徽标。

      维度：一个约 160 × 160 像素的徽标在 230 × 230 像素的正方形内
      图标背景色 icon-brand-color-hexadecimal-code 与图标文件中的背景色匹配的图标后面的颜色。

      格式：十六进制。 例如，#007ee5 表示蓝色。
      说明 connector-description 为您的连接器输入简短说明。
      Host connector-host 输入您的 SOAP 服务的主机域。
      基本 URL connector-base-URL 输入您的 SOAP 服务的基本 URL。

2b. 描述您的连接器使用的身份验证

  1. 选择安全性，然后查看或描述您的连接器使用的身份验证。 身份验证可确保您的用户的身份在您的服务和任何客户端之间适当地流动。

    默认情况下，您的连接器的身份验证类型设置为无身份验证。

    身份验证类型的屏幕截图。

    要更改身份验证类型，选择编辑。 您可以选择基本身份验证。 若要使用默认值之外的参数标签，请在参数标签下进行更新。

    基本身份验证的屏幕截图。

  2. 要在输入安全信息后保存连接器，在页面顶部选择更新连接器，然后选择继续。

2c. 查看、更新或定义您的连接器的操作和触发器

  1. 选择定义，然后查看、编辑或定义用户可以添加到工作流中的新操作和触发器。

    操作和触发器基于 WSDL 文件中定义的操作，这些操作将自动填充定义页面，并包括请求和响应值。 如果此处已出现所需的操作，您无需在此页面上进行更改即可进入注册过程的下一步。

    连接器定义的屏幕截图。

  2. （可选）如果您想要编辑现有操作和触发器，或者添加新操作和触发器，转到编辑 API 定义的示例。

3. 完成连接器的创建

准备就绪后，选择更新连接器部署您的连接器。

恭喜！ 现在，当您创建逻辑应用时，您可以在逻辑应用设计器中找到您的连接器，并将该连接器添加到您的逻辑应用中。

在逻辑应用设计器中查找连接器的屏幕截图。

与其他逻辑应用用户共享您的连接器

已注册但未认证的自定义连接器的工作方式与预生成连接器类似，但有一个例外。 它们仅对在部署这些应用的区域中具有相同 Microsoft Entra ID 租户和逻辑应用 Azure 订阅的连接器的作者和用户可用。 虽然共享是可选的，但有时您可能需要与其他用户共享您的连接器。

重要

如果您共享一个连接器，其他连接器可能会开始依赖该连接器。 删除连接器会删除该连接器所有连接。

要与这些边界之外的外部用户（例如，与所有逻辑应用用户）共享您的连接器，请认证您的连接器。 要了解更多信息，请转到认证连接器。

常见问题

问： SOAP 连接器是否正式发布？
答： SOAP 连接器处于预览阶段，还不是正式发布服务。

问： SOAP 连接器是否有任何限制或已知问题？
答： 有。 要了解更多信息，请转到 SOAP 连接器限制和已知问题。

问： 自定义连接器是否有任何限制？
答： 有。 要了解更多信息，请转到自定义连接器限制。

获取支持

  • 若要获得开发和加入支持，或者请求注册向导中未提供的功能，请联系 condevhelp@microsoft.com。 Microsoft 会查看此帐户了解开发人员提出的疑问和问题，并将其转给适当的团队。

  • 要提出或回答问题，或查看其他逻辑应用用户在做什么，请转到 Azure 逻辑应用论坛。

  • 为了帮助改进逻辑应用，请在逻辑应用用户反馈网站上投票或提交想法。

另请参见

认证连接器
Azure 逻辑应用、Power Automate 和 Power Apps 的自定义连接器常见问题解答

提供反馈

我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 要提供反馈，请转到提交问题或获取连接器帮助，然后选择反馈类型。