WebSphere Business Integration Connect 使用网关来将文档路由到其正确的目的地。出站传输协议决定了在网关配置期间使用哪些信息。
参与者网关支持的传输方法(缺省情况下)包括下列各项:
- HTTP/1.1
- HTTPS/1.0
- HTTPS/1.1
- FTP
- FTPS
- JMS
- SMTP
- 文件目录(File directory)
您还可以指定在创建网关过程中上载的用户定义传输方法。
作为中心管理员,您可以设置参与者的网关,参与者也可以自己执行该任务。在本章中,您将看到如何为参与者执行该任务。
要创建网关,请使用下列过程。
- 单击帐户管理 > 概要文件 > 社区参与者。
- 输入搜索条件,然后单击搜索,或者不输入任何搜索条件而单击搜索,以显示所有参与者的列表。
- 单击放大镜图标以显示参与者的概要文件。
- 单击网关。
- 单击创建。控制台显示“网关详细信息”屏幕。
- 如果您希望上载用户定义的传输方法,请执行下列步骤。否则,转至步骤 7。
- 单击导入传输类型。
- 输入定义传输方法的 XML 文件名(或使用浏览,浏览至该文件)。
- 单击上载。
注意: 从网关列表,您还可以删除用户定义的传输类型。不能删除由 WebSphere Business Integration Connect 提供的传输方法。在使用用户定义的传输方法创建某个网关后,也不能删除该传输方法。
- 单击创建。
- 输入标识网关的名称。这是必需字段。
- 指出网关的状态,这是可选的。已启用是缺省值。已启用网关已经为准备好送文档。已禁用的网关不能发送文档。
- 指出网关是联机还是脱机,这是可选的。缺省值是联机。
- 输入网关的描述,这是可选的。
以上所示的步骤对于所有网关都是通用的。但是,所选的网关不同,屏幕上所显示的选项也不同。下面是配置网关时所要采取的其它步骤,取决于其传输类型。
请注意,在提供了特定于传输方法的信息以定义网关之后,您还可以修改该网关的配置点。
要创建 HTTP 网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
格式是:http://<servername>:<optional
port>/<path>
该格式的示例是:
http://anotherwbicserver.ibm.com:57080/bcgreceiver/Receiver
- 如果访问安全 HTTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。
缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。
缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。
缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 在连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。
缺省值是 120 秒。
- 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建 HTTPS 网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
格式是:https://<servername>:<optional
port>/<path>
例如:
https://anotherwbicserver.ibm.com:57443/bcgreceiver/Receiver
- 如果访问安全 HTTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。
缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望依据与文档关联的 DUNS 号来验证发送方合作伙伴的数字证书,则在验证客户机 SSL 证书字段中选择是。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。
缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 在连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。
缺省值是 120 秒。
- 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建 FTP 网关:
- 在目标 URI 字段中,输入将传递的 URI。这个字段是必需的。
格式是:ftp://<ftp servername>: <portno>
例如:
ftp://ftpserver1.ibm.com:2115
如果不输入端口号,则使用标准的 FTP 端口。
- 如果访问 FTP 服务器需要用户名和密码,则输入用户名和密码(可选)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。
缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 在连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。
缺省值是 120 秒。
- 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建 SMTP 网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
格式是:mailto:<user@servername>
例如:
mailto:admin@anotherwbicserver.ibm.com
- 如果访问 SMTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。
缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 在需要认证字段中,指出是否随文档提供用户名和密码。缺省值是否。
- 在连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。
缺省值是 120 秒。
- 如果您想要配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建 JMS 网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
对于 WebSphere MQ JMS,目标 URI 的格式如下:
file:///<user_defined_MQ_JNDI_bindings_path>
例如:
file:///opt/JNDI-Directory
该目录包含了用于基于文件的 JNDI“.bindings”文件。该文件表明 WebSphere Business Integration Connect 如何将文档路由到既定的目的地。
对于参与者网关,参与者可能会提供 『.bindings』 文件。内部 JMS 网关(即社区管理者网关)可以使用 JMSAdmin 生成,如准备配置中心所讨论的。
这个字段是必需的。
- 如果访问 JMS 队列需要用户名和密码,则输入用户名和密码(这是可选的)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。
缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 在需要认证字段中,指出是否随文档提供用户名和密码。缺省值是否。
- 在 JMS 工厂名字段中,输入 JMS 提供程序用于连接至 JMS 队列的 Java 类的名称。这个字段是必需的。
- 在 JMS 消息类字段中,输入消息类。可选择任何有效的 JMS 消息类,例如 TextMessage 或 BytesMessage。这个字段是必需的。
- 在 JMS 消息类型字段中,输入消息的类型。这是可选字段。
- 在提供程序 URL 包字段中,输入 Java 用来解析 JMS 上下文 URL 的类(或 JAR 文件)的名称。这个字段是可选的。如果您未指定值,则使用到绑定文件的文件系统路径。
- 在 JMS 队列名字段中,输入用于接收文档的 JMS 队列的名称。这个字段是必需的。
- 在 JMS JNDI 工厂名字段中,输入用于连接至名称服务的工厂名。这个字段是必需的。如果您象准备配置中心中描述的那样设置了您的 JMS 配置,则 com.sun.jndi.fscontext.RefFSContextFactory 可能是您将要使用的一个值。
- 在连接超时字段中,输入在没有流量的情况下套接字将保持打开状态的秒数。缺省值是 120 秒。
- 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建文件目录网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
在 UNIX 系统和 Windows 系统中,与 WebSphere Business Integration Connect 安装在同一驱动器上的文件目录的格式是:file:///<path to target directory>
例如:
file:///localfiledir
其中 localfiledir 是根目录之外的目录。
在 Windows 系统中,与对 WebSphere Business Integration Connect 安装在不同驱动器上的文件目录的格式是:file:///<drive letter>:/<path>
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
要创建 FTPS 网关:
- 在目标 URI 字段中,输入将传递文档的 URI。这个字段是必需的。
格式是:ftp://<ftp servername>: <portno>
例如:
ftp://ftpserver1.ibm.com:2115
如果不输入端口号,则使用标准的 FTP 端口。
- 如果访问安全 FTP 服务器需要用户名和密码,则输入用户名和密码(这是可选的)。
- 在重试计数字段中,输入您希望网关在发送文档失败之前所尝试的次数。缺省值是 3。
- 在重试时间间隔字段中,输入网关在再次尝试发送文档前将等待的时间。缺省值是 300 秒。
- 在线程数字段中,输入将同时处理的文档数。缺省值是 3。
- 如果您希望在处理文档之前先验证发送方的 IP 地址,则在验证客户机 IP 字段中,选择是。否则就选择否。缺省值是否。
- 如果您希望在由于到达了重试次数而要发生传递失败时(自动)将网关设为脱机,则在自动排队字段中,选择是。否则就选择否。缺省值是否。
当您选择“自动排队”时,所有文档都排在队列中,直到手工将网关设为联机为止。
- 如果您希望配置网关的预处理或后处理步骤,请转至修改网关的配置点。否则,请单击保存。
注意: 要使出站 FTPS 网关正常工作,您至少需要在中心操作者的概要文件下装入 FTPS 服务器的 CA 证书,用其作为根证书。(使用帐户管理 > 概要文件 > 证书来装入证书。)当您装入该证书后,WebSphere Business Integration Connection 将信任 FTPS 服务器的证书。
如果 FTPS 服务器还要求客户机认证,则您必须在中心操作者的概要文件下装入客户机证书,用其作为 SSL 证书。WebSphere Business Integration Connect 为 FTPS 服务器提供了该证书。必须设置参与者的 FTPS 服务器以使之信任您的证书。
有关安全性的更多信息,请参阅设置入站和出站交换的安全性。
正如简介所描述的,您可以修改网关的两个处理点 - 预处理和后处理。
要将用户编写的处理程序应用于这些配置点,首先必须如上载用户定义的处理程序所描述的那样上载该处理程序。您还可以使用系统提供的处理程序,这类处理程序已处于可用状态,无须进行上载。
要修改配置点:
- 如果您正在创建网关,请继续执行步骤 6。如果您正在更新网关配置,请单击帐户管理 > 概要文件 > 社区参与者。
- 输入搜索条件,然后单击搜索,或者不输入任何搜索条件而单击搜索,以显示所有参与者的列表。
- 单击放大镜图标以显示参与者的概要文件。
- 单击网关。
- 单击放大镜图标以显示网关,然后单击编辑图标以编辑该网关。
- 从配置点处理程序列表中选择要修改的配置点。可修改的网关配置点是预处理和后处理。
- 对于您希望修改的每个处理程序,请执行下面的一个或多个步骤。
- 通过从可用处理程序列表中选择处理程序,然后单击添加,可以添加处理程序。该处理程序被移动到已配置处理程序列表。
注意: WebSphere Business Integration Connect 不支持缺省的网关处理程序。可用列表中的处理程序只是您上载的那些处理程序。
- 通过从已配置处理程序列表中选择处理程序,然后单击除取,可以除取某个处理程序。该处理程序被移动到可用处理程序列表。
- 通过选择处理程序,然后单击上移或下移按钮,可以重新排列处理程序的使用顺序。
- 通过从已配置列表中选择某个处理程序,然后单击配置,可对该处理程序进行配置。这样将显示可配置属性的列表。
- 单击保存。
