跳转到主要内容
SOAP 端口支持向远程 Web 服务发送 SOAP 消息并检索响应。

​
核心功能

  • 完整的 SOAP Web 服务客户端，支持通过 WSDL 导入实现自动配置
  • 支持 WS-Security，包括消息签名、加密和证书管理
  • 多种身份验证方法，包括 HTTP、Token 和 TLS 客户端身份验证
  • 通过 WSDL 与 XML Map 端口集成生成 SOAP 模板
  • 支持 SOAP 1.1 和 1.2 版本，并提供可配置的安全令牌格式

​
概述

SOAP 端口的输入应是要发送到 Web 服务的完整 SOAP 消息。可以通过为目标 Web 服务导入 WSDL 来生成 SOAP 消息模板。有关详细信息，请阅读 SOAP 模板部分。 SOAP 端口支持 HTTP 身份验证、Token 身份验证和 TLS 客户端身份验证，并且可以向传出的 SOAP 消息添加数字加密和签名以保障 Web 服务安全。发送 SOAP 请求后，端口会存储响应，或将其传递到 知行之桥 工作流中的下一个端口。

​
端口配置

本节包含所有可配置的端口属性。

​
设置选项卡

​
交易伙伴信息

用于标识目标 Web 服务的设置。

​
WS-Security

与保护 Web 服务传输相关的设置。

​
客户端证书

与本地私有证书相关的设置。

​
服务器证书

与服务器公钥证书相关的设置。

​
高级选项卡

​
Token 身份验证

与 Token 客户端身份验证相关的设置。

​
TLS 客户端身份验证

与需要双向 TLS 身份验证时的客户端身份验证相关的设置。

设置描述
私有证书TLS 客户端身份验证期间提供的私有证书。
证书密码访问 TLS 客户端证书所需的密码。

​
HTTP 身份验证

与 HTTP 客户端身份验证相关的设置。

​
自定义请求头

作为传出消息一部分包含的一组自定义请求头。

​
代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下，本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一：Basic、Digest、Proprietary 或 NTLM。

​
高级设置

前面类别中未包含的设置。

​
消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

​
日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型：
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

​
其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

​
自动化选项卡

​
自动化设置

与端口自动处理文件相关的设置。

​
性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

​
告警选项卡

​
SLA 选项卡

​
建立连接

建立连接需要目标 Web 服务的服务地址和 SOAP 操作。某些 Web 服务可能要求 SOAP 请求具备一个或多个安全功能：
  • 加密/签名 (WS-Security)
  • 客户端 SSL 身份验证
  • HTTP 身份验证

​
SOAP 模板

通过使用 WSDL 文件以及工作流中连接到 SOAP 端口的 XML Map 端口，SOAP 端口可以简化生成 SOAP 请求的过程。WSDL 文件为 SOAP 请求定义适当的 XML 结构，而 XML Map 端口可以将任意 XML 结构转换为此目标结构。 使用导入 WSDL按钮导入文件后，将 XML Map 端口连接到 SOAP 端口（这样，XML Map 端口处理的文件随后会发送到 SOAP 端口）。保存这些工作流更改后，XML Map 端口可以动态读取 WSDL XML，并将其用作目标文件模板。然后，在 XML Map 端口中将任意源 XML 结构上传为源文件。 在 XML Map 端口中设置源文件和目标文件后，可视化设计器会填充源结构和目标结构。将元素从源拖放到目标，以映射两个 XML 结构之间的关系。映射完成后，与源文件匹配的文件会由 XML Map 端口自动转换为 SOAP 请求。

​
宏

​
示例