使用 SOAP Web 服务

  • 5 分钟

借助 SOAP Web 服务，您可以使用 SOAP 从其他应用程序的 Business Central 获取数据。 如果需要在服务器和 SOAP 客户端之间定义正式合同，或者客户端应用程序无法使用 REST 服务，则 SOAP Web 服务可能比 OData 更有优势。

Microsoft 在 REST 和 OData 以及 Power BI、Power Apps 和 Power Automate 等在线应用程序上投入了大量人力物力。 因此，SOAP 服务此时虽然不再是 Web 服务的主要选择，但仍然可用且已启用。

您不仅可以在 OData Web 服务的页面上查看可用的 SOAP Web 服务，而且始终可以创建新服务。 要获取包含所有可用 SOAP Web 服务的列表或创建新 Web 服务，请在搜索框中输入 Web 服务。

  1. 选择右上角的搜索图标。

  2. 在告诉我您想要做什么搜索框中输入 Web 服务。

  3. 在显示的列表中选择 Web 服务。

显示所有可用 Web 服务的页面用于启用 OData 和 SOAP Web 服务的访问权限。 Business Central 中的 Web 服务基于现有对象，如页面、查询和 codeunit。 SOAP Web 服务只能与页面和 Codeunit 对象类型一起使用，无法与查询类型一起使用。 每个已发布的对象将生成一个链接，您可以使用该链接访问 Web 服务。

用于启用访问权限的所有可用 Web 服务的屏幕截图。

要添加新的 OData Web 服务，请在菜单中选择新建按钮，然后选择对象类型。 对于 SOAP，您可以选择页面或 Codeunit。 选择对象 ID 并为服务命名。 在以下示例中，客户卡对象用于将客户记录公开为名为客户的 SOAP Web 服务。 最后，选择已发布复选框。 选择菜单中的重新加载按钮后，Business Central 会生成一个 SOAP 链接。

选中“已发布”复选框的 Web 服务的屏幕截图。

生成的链接始终使用相同的结构。

https://api.businesscentral.dynamics.com/v2.0/<tenant>/WS/<service>

对于沙盒环境，您可以使用以下结构。

https://api.businesscentral.dynamics.com/v2.0/<tenant>/sandbox/WS/<service>