Chargement des données d'un ensemble de valeurs défini par l'utilisateur

Vous pouvez employer l'utilitaire UDDIUserDefinedValueSet pour charger les données d'un ensemble de valeurs dans le registre UDDI, affecter les données d'un ensemble de valeurs existant à une autre entité tModel et annuler le chargement des données d'un ensemble de valeurs existant. Le chargement des données d'un ensemble de valeurs défini par l'utilisateur doit être fait quand vous ajoutez un ensemble de valeurs défini par l'utilisateur dans le registre UDDI.

Format du fichier de données de l'ensemble de valeurs

Les données d'un ensemble de valeurs sont identifiées par une valeur de code unique, une description facultative et un code parent qui précise leur relation avec d'autres valeurs de code. Elles doivent respecter le format suivant :

Le fichier doit être sauvegardé au format UTF-8.

Tableau 1. Format des données de l'ensemble de valeurs. Le tableau répertorie les différents noms de colonnes pour les ensembles de valeurs, affiche leur longueur de caractères maximale et fournit une description pour chacune d'elles.
Nom de la colonne Longueur maximale Conditions d'utilisation
code 765 Valeur unique dans l'ensemble de valeurs, utilisée pour la validation
description 765 En général, utilisée par les consoles utilisateur UDDI et parfois dans l'élément keyedReference en tant que valeur keyName
parentcode 765 Indique quel code existant est le parent logique de ce code ; utilisé dans les vues en arborescence
En général, les colonnes sont délimitées par le caractère dièse (#) dans le fichier des données d'un ensemble de valeurs, comme dans l'exemple suivant :
00#Food#00
10#Fruit#00
101#Pommes#10
102#Oranges#10
103#Poires#10
1031#Anjou#103
1032#Conférence#103
1033#Bosc#103
104#Grenades#10
20#Légumes#00
201#Carottes#20
202#Pommes de terre#20
203#Pois#20
204#Germes#20

Dans cet exemple, "Aliments" est la description du noeud racine et ses noeuds enfants sont "Fruits" et "Légumes". Les valeurs de code parent de ces deux noeuds enfants sont identiques à la valeur de code "Aliments".

Les données de l'ensemble de valeurs de cet exemple de fichier peuvent s'afficher ainsi dans une arborescence :
Aliments
  Fruits
    Pommes
    Oranges
    Poires
      Anjou
      Conférence
      Bosc
    Grenades
  Légumes
    Carottes
    Pommes de terre
    Pois
    Germes

Utilitaire UDDIUserDefinedValueSet

vous pouvez employer l'utilitaire UDDIUserDefinedValueSet pour charger les données d'un ensemble de valeurs dans le registre UDDI, affecter les données d'un ensemble de valeurs existant à une autre entité tModel et annuler le chargement des données d'un ensemble de valeurs existant. Cet utilitaire prend également en charge les fichiers de taxinomie personnalisés utilisés dans UDDI Version 2.

Cet utilitaire utilise l'interface JMX du registre UDDI et requiert donc un certain nombre de paramètres de connexion.

Syntaxe :
[AIX Solaris HP-UX Linux Windows]
UDDIUserDefinedValueSet[.sh|.bat] '{'fonction'}' [options]
[IBM i]
UDDIUserDefinedValueSet '{'fonction'}' [options]
[z/OS]
UDDIUserDefinedValueSet.sh '{'fonction'}' [options]
Fonctions :
-load <chemin> <clé>         Charge les données d'un ensemble de valeurs depuis le fichier spécifié
-newKey <oldKey> <newKey>  Déplace l'ensemble de valeurs vers un nouveau tModel
-unload <key>              Annule le chargement d'un ensemble de valeurs existant
Options :
-properties <chemin>         Spécifie l'emplacement du fichier de configuration
-host <host name>          Application Server or deployment manager host
-port <port>               Numéro de port du module d'écoute SOAP
-node <node name>          Noeud exécutant un serveur UDDI
-server <server name>      Serveur avec UDDI déployé
-columnDelimiter <delim>   Caractère délimiteur indiquant la fin d'une zone
-stringDelimiter <delim>   Caractère délimiteur permettant de séparer des chaînes
Paramètres de sécurité du connecteur
-userName <name>
-password <mot_passe>
-trustStore <path>
-trustStorePassword <password>
-keyStore <name>
-keyStorePassword <password>

Vérifiez que la fenêtre de commande dans laquelle vous exécutez l'utilitaire UDDIUserDefinedValueSet utilise une page de code et une police appropriées pour afficher les caractères figurant dans le nom de l'ensemble de valeurs. A défaut, si le chargement réussit, les messages risquent d'être illisibles et vous aurez des difficultés pour utiliser les fonctions unload et newKey.

Le script UDDIUserDefinedValueSet se trouve dans le répertoire racine_serveur_app/bin.

Si aucun paramètre de connexion n'est indiqué, une connexion est recherchée sur l'hôte local à l'aide du numéro de port SOAP par défaut du gestionnaire de déploiement ou, si aucun gestionnaire de déploiement n'est en cours d'exécution, à l'aide du numéro de port SOAP du serveur d'applications.

Les arguments de commande ne font pas la distinction entre majuscules et minuscules.

Vous pouvez aussi utiliser le paramètre des propriétés pour indiquer un fichier de configuration. Ce fichier de configuration indique les propriétés facultatives que vous pouvez spécifier sur la ligne de commande. Les propriétés que vous spécifiez dans la ligne de commande remplacent les valeurs contenues dans le fichier de configuration. Ces propriétés sont pour la plupart des paramètres de sécurité et des paramètres de connexion JMX.

Le paramètre stringDelimiter est généralement utilisé lorsqu'une valeur de description contient le même caractère que le caractère délimiteur de colonne. Par exemple, si le paramètre columnDelimiter a pour valeur une virgule (,) et que la valeur de description de l'ensemble de valeurs est "Fruits, agrumes", vous pouvez inclure cette valeur dans le fichier de données de l'ensemble de valeurs en affectant au paramètre stringDelimiter la valeur du signe guillemet droit double (") et en plaçant la description entre apostrophes "Fruits, agrumes". Notez que vous devez utiliser la barre oblique inversée (\) comme caractère d'échappement pour indiquer l'utilisation d'un caractère littéral.

Si vous tentez de charger un ensemble de valeurs dans une entité tModel possédant déjà des données d'ensemble de valeurs, un message d'avertissement apparaît. Pour ignorer cet avertissement, vous pouvez utiliser l'argument "override". Utilisez également cet argument quand vous déplacez les données d'un ensemble de valeurs vers une nouvelle entité tModel avec la fonction newKey quand l'entité tModel est vérifiée et quand vous annulez le chargement des données d'un ensemble de valeurs pour une entité tModel vérifiée.
Tableau 2. Arguments et propriétés de ligne de commande. Le tableau répertorie les différents arguments de ligne de commande ainsi que leurs propriétés, et contient un commentaire sur chacun d'eux.
Arguments de ligne de commande et exemples de données Propriété et exemples de données Commentaires
-columnDelimiter # column.delimiter=# Délimiteur de colonne utilisé dans les fichiers de données des ensembles de valeurs
-stringDelimiter \" string.delimiter=\" Délimiteur de zone. Cette valeur doit être différente de la valeur de column.delimiter.
-host ibm.com host=ibm.com

Nom d'hôte du système qui exécute le gestionnaire de déploiement ou le serveur d'applications

-port 8880 port=8880

Numéro de port SOAP du gestionnaire de déploiement ou du serveur d'applications

-node ibmNode node=ibmNode Nom du noeud exécutant le serveur avec le registre UDDI
-server server1 server=server1 Serveur exécutant le registre UDDI
-userName ibmuser security.username=ibmuser Nom de l'utilisateur. Cette valeur est requise si la sécurité de WebSphere Application Server est activée.
-password mypassword security.password=mypassword Mot de passe
-trustStore /TrustStoreLocation security.truststore=/TrustStoreLocation Emplacement du fichier de clés certifiées
-keyStore ibmkeystore security.keystore=ibmkeystore Nom du fichier de clés
-trustStorepassword trustpass security.truststore.password=trustpass Mot de passe du fichier de clés
-keyStorePassword keypass security.keystore.password=keypass Mot de passe du fichier de clés

Exemples d'utilisation

[AIX Solaris HP-UX Linux Windows]Dans les exemples suivants, .xxx correspond à .bat pour le système d'exploitation Windows et à .sh pour les systèmes d'exploitation UNIX et Linux.

Chargez les données d'un ensemble de valeurs pour une entité tModel dans le registre UDDI local en utilisant le caractère de pourcentage (%) comme délimiteur de colonne dans le fichier 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 %

Déplacez les données d'un ensemble de valeurs depuis une entité tModel contrôlée vers une autre dans un registre UDDI d'une configuration de déploiement en réseau.

[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

Déchargez un ensemble de valeurs d'une entité tModel à partir d'un serveur dont la sécurité est activée. Indiquez les paramètres de connexion et de sécurité dans le fichier myproperties.properties mais indiquez les arguments du serveur et du mot de passe dans la ligne de commande. Les arguments fournis dans la ligne de commande s'ajoutent à ceux contenus dans le fichier des propriétés ou les remplacent.

[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 

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwsu_tax_load
Nom du fichier : rwsu_tax_load.html