当创建并命名新的连接器配置文件时,或当打开现有的连接器配置文件时,连接器配置器显示一个配置屏幕以及必需配置值类别的选项卡。
连接器配置器要求以下类别的属性具有值以便连接器在所有代理程序上运行:
对于在 ICS 上运行的连接器,以下属性的值也是必需的:
标准属性与特定于连接器的属性不同,如下所示:
标准属性和特定于连接器的属性的字段是用颜色编码的,以显示哪些字段是可配置的:
要更改标准属性的值:
要获取有关特定标准属性的更多信息,将鼠标移至“标准属性”选项卡式页面中该属性的“描述”列中的条目上。如果您安装了“扩展帮助”,则会打开一个“帮助”窗口并显示标准属性的详细信息。
有关“扩展帮助”文件的位置,参阅『标准属性』附录中的 AdapterHelpName 属性。
对于特定于连接器的配置属性,您可以添加或更改属性名、配置值、删除属性和对属性进行加密。缺省属性长度为 255 个字符。
对每个属性显示的“更新方法”指示激活更改的值是否需要重新启动组件或代理程序。
可以通过在“特定于连接器的属性”窗口中选择加密复选框来加密特定于应用程序的属性。要将值解密,单击以清除加密复选框,并在验证对话框中输入正确的值,然后单击确定。如果输入的值是正确的,则将解密并显示该值。
每个连接器的适配器用户指南都包含每个属性及其缺省值的列表和描述。
如果属性具有多个值,则加密复选框将对属性的第一个值显示。当您选择加密时,将对属性的所有值进行加密。要将属性的多个值解密,单击以对属性的第一个值清除加密复选框,然后在验证对话框中输入新的值。如果输入值是匹配的,则多个值将全部解密。
参阅更新方法的描述,可以在连接器的标准配置属性附录的配置属性值概述中找到这些描述。
使用“连接器配置器”中的受支持的业务对象选项卡来指定连接器将使用的业务对象。您必须指定通用业务对象和特定于应用程序的业务对象,并且您必须指定这些业务对象之间的映射关联。
要指定业务对象定义受连接器支持,或更改现有业务对象定义的支持设置,单击受支持的业务对象选项卡并使用以下字段。
在系统管理器正在运行的情况下,要指定业务对象定义受连接器支持:
要从受支持的列表删除业务对象:
从受支持的列表删除业务对象将更改连接器定义,并使删除的业务对象不可用于此连接器的此实现。它不会影响连接器代码,它也不会从系统管理器除去业务对象定义。
如果某个业务对象具有代理程序支持,则系统将尝试使用该业务对象以通过连接器代理程序将数据传递至应用程序。
通常,连接器的特定于应用程序的业务对象受该连接器的代理程序支持,但通用业务对象则不受支持。
要指示该业务对象是否受连接器代理程序支持,选择代理程序支持框。“连接器配置器”窗口不验证您的代理程序支持选择。
连接器的最大事务级别是该连接器支持的最高事务级别。
对于大多数连接器,最大努力是唯一可能的选项。
您必须重新启动服务器以便事务级别的更改生效。
如果您以独立方式工作(未连接至系统管理器),则您必须手工输入业务对象名。
如果您已在运行系统管理器,则您可以选择受支持的业务对象选项卡中业务对象名列之下的空框。出现一个组合框,显示可从连接器所属的“集成组件库”项目获得的业务对象列表。从该列表选择您需要的业务对象。
消息集标识是 WebSphere Business Integration Message Broker 5.0 的可选字段,如果提供该标识,则它不必是唯一的。但是,对于 WebSphere MQ Integrator 和 Integrator Broker 2.1,您必须提供唯一标识。
当选择 WebSphere Application Server 作为代理程序类型时,连接器配置器不需要消息集标识。受支持的业务对象选项卡仅对受支持的业务对象显示业务对象名列。
如果您以独立方式工作(未连接至系统管理器),则您必须手工输入业务对象名。
如果您已在运行系统管理器,则您可以选择“受支持的业务对象”选项卡中“业务对象名”列之下的空框。出现一个组合框,显示可从连接器所属的“集成组件库”项目获得的业务对象列表。从此列表选择您需要的业务对象。
每个连接器都支持业务对象定义列表及这些定义在 WebSphere InterChange Server 中当前活动的相关映射。在您选择相关映射选项卡时将出现此列表。
业务对象列表包含代理程序支持的特定于应用程序的业务对象和控制器发送至预订协作的相应通用对象。映射的关联确定哪个映射用来将特定于应用程序的业务对象转换为通用业务对象,或将通用业务对象转换为特定于应用程序的业务对象。
如果您正在使用为特定的源业务对象和目标业务对象唯一地定义的映射,则当您打开该屏幕时,这些映射将已经与其适当的业务对象相关,您将不需要(或无法)更改它们。
如果多个映射可供受支持的业务对象使用,则您将需要显式地将该业务对象与它应该使用的映射绑定在一起。
相关映射选项卡显示以下字段:
它们是受此连接器支持的业务对象,是在受支持的业务对象选项卡中指定的。如果您在“受支持的业务对象”选项卡下指定额外的业务对象,则在您通过从“连接器配置器”窗口的文件菜单选择保存至项目来保存更改之后,此列表中将反映这些业务对象。
该屏幕显示已安装到系统以与连接器的受支持业务对象配合使用的所有映射。每个映射的源业务对象都显示在业务对象名屏幕中映射名的左边。
在某些情况下,您可能需要显式地绑定相关映射。
仅当特定的受支持业务对象存在多个映射时,才需要显式绑定。当 ICS 引导时,它尝试自动将映射绑定至每个连接器的每个受支持的业务对象。如果多个映射使用同一业务对象作为其输入,则服务器尝试找到并绑定一个是其它映射超集的映射。
如果没有任何映射是其它映射的超集,则服务器无法将业务对象绑定至单个映射,并且您将需要显式地设置绑定。
要显式地绑定映射:
资源选项卡允许您设置一个值,用于确定连接器代理程序是否将使用连接器代理程序来同时处理多个进程以及达到的处理程度。
并非所有连接器都支持此功能。如果您要运行在 Java 中旨在用于多线程的连接器代理程序,则建议您不要使用此功能,因为使用多线程通常比使用多进程更有效。
消息传递选项卡使您能够配置消息传递属性。仅当您已将 MQ 设置为 DeliveryTransport 标准属性的值并将 ICS 设置为代理程序类型时,消息传递属性才可用。这些属性影响连接器将如何使用队列。
在可以验证消息传递队列之前,您必须执行以下操作:
要验证队列,使用“消息传递”选项卡上的“消息传递类型”和“主机名”字段右边的“验证”按钮。
可以使用“连接器配置器”中的安全性选项卡来为消息设置各种隐私级别。仅当 DeliveryTransport 属性设置为 JMS 时才能使用此功能。
缺省情况下,“隐私”是关闭的。选择隐私框以启用它。
密钥库目标系统绝对路径名为:
<ProductDir>\connectors\security\<connectorname>.jks
opt/IBM/WebSphereAdapters/connectors/security/<connectorname>.jks
此路径和文件应该与连接器配置器在同一系统上。
仅当目标系统是当前正在运行的系统时,您才能使用右边的“浏览”按钮。除非启用了隐私,并且菜单栏中的目标系统设置为 Windows,否则“浏览”按钮将变灰。
对于三种消息类别(“所有消息”、“所有管理消息”和“所有业务对象消息”),可以按如下所示设置消息隐私级别:
密钥维护功能允许您为服务器和适配器生成、导入和导出公用密钥。
在可以将证书导入适配器密钥库之前,必须从服务器密钥库中导出它。当您选择导出适配器公用密钥时,将出现“导出适配器公用密钥”对话框。
当您选择导入适配器公用密钥时,将出现“导入适配器公用密钥”对话框。
仅当 DeliveryTransport 的值为 IDL 时,才会启用适配器访问控制功能。缺省情况下,适配器使用 guest 标识登录。如果未选择使用 guest 标识框,则会启用适配器标识和适配器密码字段。
当您打开连接器配置文件或连接器定义文件时,连接器配置器使用该文件的日志和跟踪值作为缺省值。您可以在连接器配置器中更改那些值。
要更改日志和跟踪值:
仅当为 DeliveryTransport 指定了值 JMS 并且为 ContainerManagedEvents 指定了值 JMS 时,数据处理程序节才可用于配置。并非所有适配器都使用数据处理程序。
请参阅“附录 A,标准属性”中的 ContainerManagedEvents 下的描述以获取要用于这些属性的值。有关其它详细信息,请参阅 Connector Development Guide for C++ 或 Connector Development Guide for Java。