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.
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 |
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".
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 :
UDDIUserDefinedValueSet[.sh|.bat] '{'fonction'}' [options]
UDDIUserDefinedValueSet '{'fonction'}' [options]
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.
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
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]](../images/dist.gif)
UDDIUserDefinedValueSet.xxx -load valuesetdata.txt
uddi:a708b8a7-35b5-451c-aafc-718ae071fcfe -columnDelimiter %
![[z/OS]](../images/ngzos.gif)
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]](../images/dist.gif)
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]](../images/ngzos.gif)
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]](../images/dist.gif)
UDDIUserDefinedValueSet.xxx -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f
-server uddiserver -properties myproperties.properties -password myrealpassword
![[z/OS]](../images/ngzos.gif)
UDDIUserDefinedValueSet.sh -unload uddi:b819c9b8-46c6-562d-bb0d-829bf1820d0f
-server uddiserver -properties myproperties.properties -password myrealpassword