[Share] SOAP 端口

SOAP端口支持将SOAP消息发送到远程Web服务并检索响应。

总览

SOAP端口的输入是需要发送到Web服务的完整SOAP消息。 可以通过为目标Web服务导入WSDL来生成SOAP消息的模板,有关更多信息,请参见SOAP模板部分。

SOAP端口支持HTTP身份验证,并且可以通过为输出的SOAP消息添加数字加密和签名来实现Web Service安全性。 发送SOAP请求后,端口将保存响应或将其传递给工作流中的下一个接口。

端口配置

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

配置

伙伴信息

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

服务接口 SOAP请求应发送到的URL
SOAP 操作 在远程服务器上要触发的Web服务操作。
从WSDL导入 可以从URL或本地文件导入WSDL,并自动在端口中填充配置字段。 此外,导入WSDL可以连接到XML Map端口,为SOAP请求生成XML模板。 有关更多详细信息,请参见SOAP模板部分。
WS-安全性

与Web服务传输安全性有关的设置。

发送消息安全性 是否签名/加密发送的SOAP请求。
接收消息安全性 是否要求传入的SOAP响应中存在签名/加密。 如果收到的消息没有必需的安全性参数,将引发错误。
Live 时间 端口在出现超时错误之前将等待连接响应的时间长度。
客户端证书

与本地私钥有关的设置。

私钥证书 用于签名传出请求和解密传入响应的私钥。
证书密码 私钥证书密码
服务器证书

与服务器公钥有关的设置。

加密证书 发送消息时用于加密的公钥证书,接收响应时用于验证签名的公钥证书。
SSL 服务器证书 用于验证服务器身份的SSL/TLS公钥证书,仅在通过HTTPS(而不是HTTP)发送请求时才需要。 在没有特定服务器证书的情况下,可以将此设置设置为“Any Certificate”以无条件地信任目标服务器的身份。

自动化

自动化
发送 到达端口的文件是否将自动作为SOAP请求发送。
重试间隔 重试发送失败之前的时间。 当服务器不响应发送尝试,或者否定响应以表明未收到文件时,将触发重试。

高级配置

本地文件夹

用于确定文件发送和接收位置的设置。

输入文件夹(Send) 放置在此处的文件将作为请求由端口发送。 如果启用了“发送自动化”,则端口将自动在此位置轮询要发送的文件。
输出文件夹(Receive) 端口收到的响应将放置在此处。 如果端口已连接到工作流中的另一个接口,则文件将不会保留在此处,而是会传递到所连接端口的“输入/Send”文件夹中。
已处理文件夹(Sent) 如果启用了保存到已发送文件夹,端口将已发送文件的副本放置在此处,并且该文件的副本将不会传递到流中的下一个端口。
SSL 客户端认证

SSL双向认证时与客户端认证有关的设置。

私钥证书 SSL客户端身认证私钥证书。
证书密码 SSL客户端认证私钥证书。
HTTP认证

与HTTP客户端认证相关的设置

启用HTTP认证 是否启用客户端HTTP认证。
HTTP认证类型 是否以加密格式(Digest)或纯文本(Basic)提供HTTP身份验证凭据。 仅当连接是HTTPS连接(非HTTP)时,才应使用Basic 认证。
用户 用于HTTP客户端认证的用户。
密码 HTTP客户端认证用户的密码。
自定义头部

一组包含在传出消息中的任意自定义头部。

性能

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

最大线程数 线程池在此端口上处理文件所使用的最大工作线程数。 此设置将覆盖“配置文件”选项卡中的默认设置。
最大文件数 每次将工作线程分配给端口时,端口将处理的最大文件数。 此设置将覆盖“配置文件”选项卡中的默认设置。
其他设置

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

加密算法 加密发送消息时使用的算法。
签名算法 签署发送消息时使用的算法。相应的回执将请求相同的算法。
验证证书 用于验证接收的SOAP响应的公共证书。仅当应使用与“加密证书”中设置的公共证书不同的证书来验证签名时,才需要此配置。
发送过滤器 全局模式过滤器,用于确定端口将发送“Send”文件夹中的文件类型(例如* .txt)。取反模式可以用于指定端口不处理的文件类型(例如-*。tmp)。多个模式可以用逗号分隔,除非找到完全匹配的内容,否则后面的过滤器优先。
本地文件名称 文件名映射,用于确定端口如何命名下载的文件并将其推送到“输出/接收文件夹”。支持以下宏:
%ConnectorId%
%Filename%
%FilenameNoExt%
%EXT%
%ShortDate%
%LongDate%
%RegexFilename:%
%DateFormat:%
比如: %%FilenameNoExt%_%ShortDate%%EXT%
父端口 除非应在现有端口配置中明确覆盖设置,否则应从父端口中继承设置。必须将其设置为与当前端口相同类型的端口。
记录调试日志 是否为端口启用了调试日志记录。当请求技术支持时,建议将生成调试日志和技术支持请求一起提供。
签名头部有效载荷 是否在发送的请求中对SOAP标头签名。
规范发行人主题 是否应该将证书颁发者数据标准化为一个简单的字符串,以供Web服务进行验证。
记录消息 文件处理日志是否包括文件本身的副本。
保存到已发送文件夹 端口处理的文件是否应复制到端口的“Sent”文件夹。
启用S​​SL协议 建立发送连接时支持的SSL/TLS协议列表。强烈建议仅使用TLS协议,但是一些过时的操作系统不支持TLS 1.2。

建立连接

建立连接需要目标Web服务的服务接口和服务操作。对于SOAP请求,某些Web服务可能需要一种或多种安全功能:

  • 加密/签名(WS-安全性)
  • 客户端SSL认证
  • HTTP认证

SOAP模板

SOAP端口可以通过使用WSDL文件和连接到工作流中的SOAP端口的XML Map端口来简化生成SOAP请求的过程。 WSDL文件为SOAP请求定义了适当的XML结构,并且XML Map端口可以将任何任意XML结构转换为SOAP 目标结构。

使用“import WSDL”按钮导入文件后,将XML Map端口连接到SOAP端口,这样由XML Map端口处理的文件将被发送到SOAP连接器。保存这些工作流更改之后,XML Map端口可以动态读取WSDL XML并将其用作目标文件模板。然后,在XML Map端口中上载任意源XML结构作为源文件。

在XML Map端口中设置“Source file”和“Destination file”后,将使用源文件和目标文件的结构填充可视设计器。将元素从源文件拖放到目标以映射两个XML结构之间的关系。映射完成后,与XML Map端口将自动将与源文件匹配的文件转换为SOAP请求。

了解更多EDI相关讯息,请您电话 150-0298-3180 / 177-8250-8152 或邮件 edi@kasoftware.cn 联系我们,获取 30 天全功能 免费试用 版本EDI软件。
标签:
文章分类 edi 电子数据交换, edi方案工作流, share 知识分享