Carga de los datos del conjunto de valores definido por el usuario

Puede utilizar el programa de utilidad UDDIUserDefinedValueSet para cargar datos del conjunto ve valores en el registro UDDI, asignar datos de un conjunto de valores existente a otra entidad tModel, y descartar datos de un conjunto de valores existente. Los datos del conjunto de valores se cargan como parte del procedimiento de adición al registro UDDI de un conjunto de valores definido por el usuario.

Formato del archivo de datos del conjunto de valores

Los datos del conjunto de valores se identifican mediante un valor de código único, una descripción opcional y un código padre que especifica su relación con otros valores de código. Los datos del conjunto de valores deben tener el formato siguiente.

Debe guardar el archivo en formato UTF-8.

Tabla 1. Formato de los datos del conjunto de valores. En la tabla se muestran los distintos nombres de columna del conjunto de valores, así como sus longitudes máximas de caracteres, y se proporciona una descripción de cada una de ellas.
Nombre de columna Longitud máxima Descripción de uso
code 765 Valor exclusivo del conjunto de valores, que se utiliza para validación.
descripción 765 Utilizada normalmente por las consolas de usuario de UDDI y, de manera opcional, en el elemento keyedReference como el valor de keyName.
parentcode 765 Indica el código existente que es el padre lógico de éste, y se utiliza en tres vistas de árbol.
Generalmente, las columnas están delimitadas en el archivo de datos del conjunto de valores por caracteres (#), como se muestra en el siguiente ejemplo:
00#Food#00
10#Fruta#00
101#Manzanas#10
102#Naranjas#10
103#Peras#10
1031#Anjou#103
1032#Conferencia#103
1033#Bosc#103
104#Granadas#10
20#Vegetales#00
201#Zanahorias#20
202#Patatas#20
203#Guisantes#20
204#Coles#20

En este ejemplo, Alimentos es la descripción del nodo raíz y tiene los nodos secundarios Fruta y Vegetales; los valores de código padre para estos nodos secundarios son el mismo que el valor de código de Alimentos.

Los datos del conjunto de valores del archivo de ejemplo pueden representarse en un árbol, como se muestra en el siguiente ejemplo:
Food
  Fruta
    Manzanas
    Naranjas
    Peras
      Anjou
      Conferencia
      Bosc
    Granadas
  Vegetales
    Zanahorias
    Patatas
    Guisantes
    Coles

Utilidad UDDIUserDefinedValueSet

Puede utilizar el programa de utilidad UDDIUserDefinedValueSet para cargar datos del conjunto ve valores en el registro UDDI, asignar datos de un conjunto de valores existente a otra entidad tModel, y descartar datos de un conjunto de valores existente. Esta utilidad también da soporte a archivos de taxonomía personalizados que se utilizan en UDDI versión 2.

Este programa de utilidad utiliza la interfaz JMX del registro UDDI y, por lo tanto, requiere un número de parámetros de conexión.

Uso:
[AIX Solaris HP-UX Linux Windows]
UDDIUserDefinedValueSet[.sh|.bat] '{'función'}' [opciones]
[IBM i]
UDDIUserDefinedValueSet '{'function'}' [options]
[z/OS]
UDDIUserDefinedValueSet.sh '{'function'}' [options]
Funciones:
-load <vía acceso> <clave>     Cargar los datos del conjunto de valores del archivo especificado
-newKey <claveAntigua> <claveNueva>  Trasladar el conjunto de valores a un nuevo tModel
-unload <clave>             Descargar el conjunto de claves existente
Opciones:
-properties <vía acceso>     Especificar ubicación del archivo de configuración
-host <nombre host>          host del servidor de aplicaciones o del gestor de despliegue
-port <puerto>             Número de puerto de escucha SOAP
-node <nombre nodo>        Nodo que ejecuta un servidor UDDI
-server <nombre servidor>  Servidor con UDDI desplegado
-columnDelimiter <delim>   Carácter delimitador para indicar el final del campo
-stringDelimiter <delim>   Carácter delimitador para indicar series
Parámetros de seguridad del conector
-userName <nombre>
-password <contraseña>
-trustStore <vía de acceso>
-trustStorePassword <contraseña>
-keyStore <nombre>
-keyStorePassword <contraseña>

Asegúrese de que la ventana de mandatos desde la que ejecuta el programa de utilidad eUDDIUserDefinedValueSet utiliza una página de códigos y un font adecuados para visualizar los caracteres que se encuentran en el nombre del conjunto de valores. Si utiliza una página de códigos o un font incorrectos, es posible que una carga satisfactoria dé lugar a mensajes poco claros, y que sea difícil utilizar las funciones unload y newKey.

El scriptUDDIUserDefinedValueSet se encuentra en el directorio raíz_servidor_aplicaciones/bin.

Si no proporciona parámetros de conexión, aparece una conexión en el host local utilizando el número de puerto SOAP por omisión del gestor de despliegue, o si no hay ningún gestor de despliegue en ejecución, el número de puerto SOAP por omisión del servidor de aplicaciones.

Los argumentos del mandato no son sensibles a las mayúsculas y minúsculas.

Si lo desea, puede utilizar el parámetro properties para especificar un archivo de configuración. Este archivo de configuración determina propiedades opcionales que también puede especificar en la línea de mandatos. Las propiedades que se especifican en la línea de mandatos prevalecen sobre los valores del archivo de configuración. Estas propiedades son, en su mayoría, parámetros de conexión JMX y de seguridad.

Generalmente, se utiliza el parámetro stringDelimiter cuando un valor de descripción contiene el mismo carácter que el carácter de delimitador de columna. Por ejemplo, si el parámetro columnDelimiter se establece en una coma (,) y existe el valor de descripción del conjunto de valores "Frutas, cítricos", para incluir esta descripción en el archivo de datos del conjunto de valores, establezca el parámetro stringDelimiter en comillas (") y especifique la descripción entre comillas, por ejemplo, "Fruta, cítricos". Observe que debe utilizar una barra inclinada (\) como carácter de escape para mostrar que se utiliza el carácter literal.

Si intenta cargar un conjunto de valores en una entidad tModel que tiene datos de un conjunto de valores existente, se muestra un mensaje de aviso. Para omitir este aviso, puede utilizar el argumento override. También necesita este argumento si desplaza los datos del conjunto de valores a una nueva entidad tModel utilizando la función newKey cuando la entidad tModel está seleccionada, y cuando descarga datos de un conjunto de valores para una entidad tModel seleccionada.
Tabla 2. Argumentos de la línea de mandatos y propiedades. En la tabla se muestran los distintos argumentos de línea de mandatos y sus propiedades y se incluye un comentario sobre cada uno de ellos.
Argumentos de la línea de mandatos y datos de ejemplo Propiedad y datos de ejemplo Comentarios
-columnDelimiter # column.delimiter=# Delimitador de columna que se utiliza en los archivos de datos de conjuntos de valores.
-stringDelimiter \" string.delimiter=\" Delimitador de campo. Este valor debe ser distinto del valor column.delimiter.
-host ibm.com host=ibm.com

Nombre de host del sistema que ejecuta el gestor de despliegue o el servidor de aplicaciones.

-port 8880 port=8880

Número de puerto SOAP del gestor de despliegue o el servidor de aplicaciones.

-node ibmNode node=ibmNode Nombre del nodo que ejecuta el servidor con el registro UDDI.
-server server1 server=server1 Servidor que ejecuta el registro UDDI.
-userName ibmuser security.username=ibmuser Nombre de usuario. Este valor es necesario si la seguridad de WebSphere Application Server está activada.
-password mypassword security.password=mypassword Contraseña.
-trustStore /TrustStoreLocation security.truststore=/TrustStoreLocation Ubicación del archivo de almacén de confianza.
-keyStore ibmkeystore security.keystore=ibmkeystore Nombre del almacén de claves.
-trustStorepassword trustpass security.truststore.password=trustpass Contraseña del almacén de confianza
-keyStorePassword keypass security.keystore.password=keypass Contraseña del almacén de claves.

Ejemplos de uso

[AIX Solaris HP-UX Linux Windows]En los siguientes ejemplos, .xxx es .bat para el sistema operativo Windows o .sh para los sistemas operativos UNIX y Linux.

Cargue los datos del conjunto de valores para una entidad tModel en el registro UDDI local con el signo de porcentaje como marcador de columna del archivo valuesetdata.txt.

[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 %

Trasladar los datos del conjunto de valores de una entidad tModel seleccionada a otra en un registro UDDI de una configuración de Network Deployment.

[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

Descargar un conjunto de valores de una entidad tModel desde un servidor con la seguridad habilitada. Especifique los parámetros de conexión y de seguridad en el archivo myproperties.properties, pero indique los argumentos de servidor y contraseña en la línea de mandatos. Los argumentos que se especifican en la línea de mandatos prevalecen sobre los argumentos del archivo de propiedades.

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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsu_tax_load
File name: rwsu_tax_load.html