装入用户定义的值集数据

可以使用 UDDIUserDefinedValueSet 实用程序来执行以下操作:将值集数据装入 UDDI 注册中心、将现有的值集数据指定给另一个 tModel 实体以及卸载现有的值集数据。装入值集数据是作为一个过程步骤,用来将用户定义的值集添加到 UDDI 注册中心。

值集数据文件的格式

值集数据由唯一代码值、可选描述和指定它与其他代码值关系的父代码来标识。值集数据必须遵循此格式。

必须以 UTF-8 格式保存文件。

表 1. 值集数据格式. 该表列出了不同的值集列名、显示其最大字符长度并提供每个列名的描述。
列名 最大长度 使用描述
code 765 值集中的唯一值,用于验证
description 765 通常由 UDDI 用户控制台使用,并且在 keyedReference 元素中用作 keyName 值(可选)
parentcode 765 指示作为此代码的逻辑父代的现有代码,并且用于树显示
通常,在值集数据文件中,列使用数字编号 (#) 字符定界,如以下示例中所示:
00#Food#00
10#Fruit#00
101#Apples#10
102#Oranges#10
103#Pears#10
1031#Anjou#103
1032#Conference#103
1033#Bosc#103
104#Pomegranates#10
20#Vegetables#00
201#Carrots#20
202#Potatoes#20
203#Peas#20
204#Sprouts#20

在本示例中,Food 是根节点的描述,并且它具有子节点 Fruit 和 Vegetables;这两个子节点的 parentcode 值与 Food 的代码值相同。

然后,示例文件中的值集数据可以在树中呈示,如以下示例中所示:
Food
  Fruit
    Apples
    Oranges
    Pears
      Anjou
      Conference
      Bosc
    Pomegranates
  Vegetables
    Carrots
    Potatoes
    Peas
    Sprouts

UDDIUserDefinedValueSet 实用程序

可以使用 UDDIUserDefinedValueSet 实用程序来执行以下操作:将值集数据装入 UDDI 注册中心、将现有的值集数据指定给另一个 tModel 实体以及卸载现有的值集数据。此实用程序也支持 UDDI V2 中所使用的定制分类法文件。

此实用程序使用 UDDI 注册中心 JMX 接口,因此需要许多连接参数。

用法:
[AIX Solaris HP-UX Linux Windows]
UDDIUserDefinedValueSet[.sh|.bat] '{'function'}' [options]
[IBM i]
UDDIUserDefinedValueSet '{'function'}' [options]
[z/OS]
UDDIUserDefinedValueSet.sh '{'function'}' [options]
功能:
-load <path> <key>         Load value set data from specified file
-newKey <oldKey> <newKey>  Move value set to a new tModel
-unload <key>              Unload existing value set
选项:
-properties <path>         Specify location of configuration file
-host <host name>          Application Server or deployment manager host
-port <port>               SOAP Lister port number
-node <node name>          Node running a UDDI server
-server <server name>      Server with UDDI deployed
-columnDelimiter <delim>   Character delimiter to denote field end
-stringDelimiter <delim>   Character delimiter to denote strings
连接器安全参数
-userName <name>
-password <password>
-trustStore <path>
-trustStorePassword <password>
-keyStore <name>
-keyStorePassword <password>

确保您从中运行 UDDIUserDefinedValueSet 实用程序的命令窗口,使用合适的代码页和字体来显示值集名称中的字符。如果使用不正确的代码页或字体,那么在成功装入后可能会导致消息不清晰,且可能造成难以使用卸载和 newKey 功能。

UDDIUserDefinedValueSet 脚本位于 app_server_root/bin 目录中。

如果未提供任何连接参数,那么在使用缺省 Deployment Manager SOAP 端口号的本地主机上寻找连接;如果没有运行的 Deployment Manager,那么在使用缺省应用程序服务器 SOAP 端口号的本地主机上寻找连接。

命令参数不区分大小写。

可选择性地使用属性参数来指定配置文件。此配置文件确定您也可以在命令行上指定的可选属性。在命令行上指定的属性会覆盖配置文件中的值。这些属性主要是 JMX 连接参数和安全参数。

通常,当描述值包含与列定界符相同的字符时,使用 stringDelimiter 参数。例如,如果 columnDelimiter 参数设为逗号 (,) 且值集描述值为 "Fruits, citrus",请将 stringDelimiter 参数设为双引号 (") 并使用引号将描述引起来(例如,"Fruits, citrus"),以将此描述包括在值集数据文件中。请注意,必须将反斜杠 (\) 设为转义字符以显示已使用文字字符。

如果尝试将值集装入具有现有值集数据的 tModel 实体中,那么显示警告消息。要覆盖此警告,您可使用 override 参数。在以下情况下,您也需要此参数:使用 newKey 功能将值集数据移至新的 tModel 实体、检查 tModel 实体以及针对所检查的 tModel 实体卸载值集数据。
表 2. 命令行参数和属性. 该表列出了不同的命令行参数及其属性,并提供每个参数和属性的注释。
命令行参数和示例数据 属性和示例数据 注释
-columnDelimiter # column.delimiter=# 用于值集数据文件的列定界符。
-stringDelimiter \" string.delimiter=\" 字段定界符。此值不同于 column.delimiter 值。
-host ibm.com host=ibm.com

正在运行 Deployment Manager 或应用程序服务器的系统的主机名

-port 8880 port=8880

Deployment Manager 或应用程序服务器的 SOAP 端口号。

-node ibmNode node=ibmNode 运行带有 UDDI 注册中心的服务器的节点名。
-server server1 server=server1 运行 UDDI 注册中心的服务器。
-userName ibmuser security.username=ibmuser 用户名。如果已打开 WebSphere® Application Server 安全性,那么此值是必需的。
-password mypassword security.password=mypassword 密码。
-trustStore /TrustStoreLocation security.truststore=/TrustStoreLocation 信任库文件位置。
-keyStore ibmkeystore security.keystore=ibmkeystore 密钥库名称。
-trustStorepassword trustpass security.truststore.password=trustpass 信任库密码
-keyStorePassword keypass security.keystore.password=keypass 密钥库密码。

用法示例

[AIX Solaris HP-UX Linux Windows]在以下示例中,.xxx.bat(Windows 操作系统)或 .sh(UNIX 和 Linux 操作系统)。

通过在 valuesetdata.txt 文件中使用 % 号作为列标记,在本地 UDDI 注册中心中装入 tModel 实体的值集数据。

[AIX Solaris HP-UX Linux Windows]
UDDIUserDefinedValueSet.xxx -load valuesetdata.txt 
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe -columnDelimiter %
[z/OS]
UDDIUserDefinedValueSet.sh -load valuesetdata.txt 
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe -columnDelimiter %

在 Network Deployment 配置中的 UDDI 注册中心中,将值集数据从一个已检查 tModel 实体移至另一个已检查 tModel 实体。

[AIX Solaris HP-UX Linux Windows]
12345678901234567890123456789012345678901234567890123456789012345678901234567890
UDDIUserDefinedValueSet.xxx -newKey 
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe 
uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f -host depmanagerhost.ibm.com 
-port 8879 -node uddinode -server uddiserver -override
[z/OS]
UDDIUserDefinedValueSet.sh -newKey uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe 
uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f -host depmanagerhost.ibm.com 
-port 8879 -node uddinode -server uddiserver -override

从启用安全性的服务器上的 tModel 实体中卸载值集。在文件 myproperties.properties 中提供连接和安全性参数,但在命令行上提供服务器和密码参数。在命令行上提供的参数会扩充或覆盖属性文件中的参数。

[AIX Solaris HP-UX Linux Windows]
UDDIUserDefinedValueSet.xxx -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f 
-server uddiserver -properties myproperties.properties -password myrealpassword 
[z/OS]
UDDIUserDefinedValueSet.sh -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f 
-server uddiserver -properties myproperties.properties -password myrealpassword 

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsu_tax_load
文件名:rwsu_tax_load.html