Substitution des valeurs d'attribut de chargement de données par des variables

Vous pouvez substituer les valeurs de la plupart des attributs qui figurent dans le fichier de configuration de l'ordre de chargement des données wc-dataload.xml et dans les fichiers de configuration de l'environnement de chargement de données wc-dataload-env.xml. A l'aide de substitutions par des variables, vous pouvez modifier les valeurs des attributs sans modifier le fichier de configuration. Vous pouvez, par exemple, remplacer la valeur de l'attribut ID utilisateur par une variable.

Pourquoi et quand exécuter cette tâche

Au lieu d'utiliser des valeurs d'attributs dans les fichiers de configuration de chargement de données, vous pouvez leur substituer des variables. Les valeurs effectives des variables sont saisies dans la ligne de commande lors de l'exécution du chargement des données. Si vous n'entrez pas de valeur pour une variable lorsque vous exécutez le chargement des données, l'utilitaire vous invite à le faire. Vous pouvez également préciser une valeur par défaut pour une variable. Si vous n'entrez pas de valeur pour une variable lorsque vous exécutez le chargement des données, la valeur par défaut est utilisée.

Tenez compte des points suivants lorsque vous effectuez cette tâche :

Lorsque vous substituez un attribut de mot de passe par une variable, vous devez spécifier une valeur de mot de passe chiffrée. Si vous indiquez un mot de passe en clair, l'utilitaire de mot de passe tente de le déchiffrer et n'y parvient pas.
Remarque : Vous n'avez pas besoin d'utiliser une substitution par une variable pour l'attribut de mot de passe. Vous pouvez laisser la valeur vide. Lors du chargement des données, vous êtes invité à saisir un mot de passe. Le mot de passe que vous entrez peut être un mot de passe en clair, non chiffré. Pour des raisons de sécurité, le système ne répercute pas la valeur du mot de passe qui est entré.
Lorsque vous utilisez une variable de substitution pour une zone d'attribut numérique (telle qu'une taille de lot ou un nombre de validations), vous devez désactiver la validation XML en raison d'un problème de validation XSD. Pour plus d'informations sur la configuration du paramètre -DXmlValidation, reportez-vous à la rubrique Utilitaire de chargement de données.

Remarque : La substitution de variable est sensible à la casse.

Procédure

Ouvrez le fichier de configuration contenant la valeur d'attribut que vous voulez substituer pour l'éditer.
Entrez un nom de variable dans l'espace destiné à la valeur de l'attribut. Le format de nom de variable est le suivant : ${nom}. Vous pouvez également spécifier une valeur par défaut dans le format ${name,defaultValue}.
Les exemples suivants incluent les propriétés de configuration de base de données qui se trouvent dans le fichier de configuration de l'ordre de chargement des données wc-dataload.xml :
- <_config:Database type="db2" name="mall" user="userId" password="" port="50000" schema="USERID" server="localhost"/>
- <_config:Database name="system1" password="" server="system1.abc.com" type="OS400" user="wcuser1" schema="wcuser1"/>
Ces valeurs peuvent être substituées par les variables suivantes :
- <_config:Database type="${dbType}" name="${dbName}" user="${dbUser}" password="" schema="${dbSchema}" server="${dbServerHost,localhost}" port="${dbPort}"/>
- <_config:Database name="${dbName}" password="" server="${dbServerHost,localhost}" type="${dbType}" user="${dbUser}" schema="${dbSchema}"/>
Remarque : Pour pouvoir utiliser le kit d'outils IBM pour le pilote JDBC, vous devez spécifier la propriété driverType. Par exemple :
```
<_config:Database name="system1" password="" server="system1.abc.com" type="OS400" driverType="toolbox" user="wcuser1" schema="wcuser1"/>
```
Pour saisir les valeurs réelles des attributs, entrez -D devant chaque paramètre sur la ligne de commande lors de l'exécution de l'utilitaire de chargement de données.
Par exemple :
```
–DdbType=db2 –DdbName=mall -DdbUser=userId -DdbSchema=USERID -DdbServerHost=localhost -DdbPort=50000
```
Le paramètre -DdbServerHost=localhost peut être omis car une valeur par défaut est spécifiée pour le paramètre -DdbServerHost.