Utilitaire configTool

Les propriétés et les valeurs de la page Configuration sont enregistrées dans les tables système Marketing Platform. L’utilitaire configTool importe et exporte les paramètres de configuration vers et depuis les tables système de IBM UnicaMarketing Platform.

Quand utiliser configTool

Vous voudrez peut-être exécuter l’utilitaire configTool pour les raisons suivantes.

*
Pour importer les modèles de partition et de source de données fournis avec Campaign, que vous pouvez ensuite modifier et/ ou dupliquer à l’aide de la page Configuration.
*
Pour enregistrer (importer les propriétés de configuration) des produits IBM Unica Marketing si l'installateur n'est pas en mesure d'ajouter automatiquement les propriétés à la base de données.
*
*
Pour supprimer les catégories ne disposant pas du lien Supprimer catégorie. Pour ce faire, utilisez configTool pour exporter votre configuration, supprimez manuellement le XML qui crée la catégorie, puis utilisez configTool pour importer le XML modifié.
*
Cet utilitaire modifie les tables usm_configuration et usm_configuration_values de la base de données de la table système de Marketing Platform, qui contient les propriétés de configuration et leurs valeurs. Pour de meilleurs résultats, créez des copies de sauvegarde de ces tables ou exportez vos configurations existantes à l’aide de configTool, puis sauvegardez le fichier obtenu afin de disposer d’un moyen de rétablir votre modification en cas d’erreur d’importation à l’aide de configTool.
Noms de produit valides

Comme décrit plus loin dans cette section, l'utilitaire configTool utilise des noms de produit en tant que paramètres avec les commandes permettant d'enregistrer et de désactiver les produits. Dans la version 8.0.0 d'IBM Unica Marketing, de nombreux produits ont changé de nom. Toutefois les noms reconnus par configTool n’ont pas changé. Les noms de produits utilisables avec configTool sont répertoriés ci-après avec les noms actuels des produits.

Syntaxe

configTool -d -p " elementPath" [-o]

configTool -i -p " parent ElementPath" -f importFile [-o]

configTool -x -p " elementPath" -f exportFile

configTool -r productName -f registrationFile [-o]

configTool -u productName

Commandes

-d -p "elementPath"

Supprimez les propriétés de configuration et leurs paramètres, tout en spécifiant un chemin pour leur hiérarchie.

Le chemin de l’élément doit utiliser les noms internes des catégories et des propriétés. Pour les obtenir, accédez à la page Configuration, sélectionnez la catégorie ou propriété souhaitée, puis consultez le chemin affiché entre parenthèses dans le volet de droite. Dans la hiérarchie des propriétés de configuration, éliminez un chemin à l'aide du caractère | et placez des guillemets doubles de chaque côté du chemin.

Gardez à l’esprit les points suivants :

*
*
Pour supprimer les catégories qui ne disposent pas du lien Supprimer catégorie dans la page Configuration, utilisez l’option -o.

-i -p "parentElementPath" -f importFile

Importe les propriétés de configuration et leurs paramètres d’un fichier XML spécifié.

Pour effectuer l’importation, spécifiez un chemin vers l’élément parent sous lequel vous souhaitez importer vos catégories. L’utilitaire configTool importe les propriétés sous la catégorie spécifiée dans le chemin.

Vous pouvez ajouter des catégories à tout niveau situé sous le niveau supérieur. Toutefois, vous ne pouvez pas ajouter une catégorie au même niveau que le niveau supérieur.

Le chemin de l’élément parent doit utiliser les noms internes des catégories et des propriétés. Pour les obtenir, accédez à la page Configuration, sélectionnez la catégorie ou propriété souhaitée, puis consultez le chemin affiché entre parenthèses dans le volet de droite. Dans la hiérarchie des propriétés de configuration, éliminez un chemin à l'aide du caractère | et placez des guillemets doubles de chaque côté du chemin.

Vous pouvez spécifier l'emplacement du fichier d'importation par rapport à votre répertoire tools/bin ou choisir un chemin complet. Si vous spécifiez un chemin relatif, voire aucun chemin, configTool recherche d’abord le fichier relatif dans le répertoire tools/bin.

Par défaut, cette commande ne remplace pas une catégorie existante, mais vous pouvez utiliser l’option -o pour forcer le remplacement.

-x -p "elementPath" -f exportFile

Exporte les propriétés de configuration et leurs paramètres dans un fichier XML spécifié.

Vous pouvez exporter toutes les propriétés de configuration ou limiter l’exportation à une catégorie spécifique. Pour ce faire, spécifiez un chemin dans la hiérarchie des propriétés de configuration.

Le chemin de l’élément doit utiliser les noms internes des catégories et des propriétés. Pour les obtenir, accédez à la page Configuration, sélectionnez la catégorie ou propriété souhaitée, puis consultez le chemin affiché entre parenthèses dans le volet de droite. Délimitez un chemin dans la hiérarchie des propriétés de configuration à l’aide du caractère |, puis insérez le chemin entre guillemets doubles.

Vous pouvez spécifier l’emplacement d’un fichier d’exportation dans le répertoire actuel ou un chemin de répertoire complet. Si le fichier spécifié ne contient pas de séparateur (/ sous Unix, / ou \ sous Windows), configTool enregistre le fichier dans le répertoire tools/bin de votre installation de Marketing Platform. Si vous n’indiquez pas l’extension xml, configTool l’ajoute.

-r productName -f registrationFile

Enregistre l’application. L’emplacement du fichier d’enregistrement peut être relatif au répertoire tools/bin ou peut être un chemin complet. Par défaut, cette commande ne remplace pas une configuration existante, mais vous pouvez utiliser l’option -o pour forcer le remplacement. Le paramètre productName peut être l’un de ceux répertoriés ci-après.

-u productName

Annule l’enregistrement d’une application spécifiée par productName. Il n’est pas nécessaire d’inclure un chemin à la catégorie du produit. Le nom du produit suffit. Le paramètre productName peut être l’un de ceux répertoriés ci-après. Cela supprime toutes les propriétés et tous les paramètres de configuration du produit.

Options

-o

Utilisée avec -i ou -r, cette option remplace une catégorie ou un enregistrement de produit (noeud) existant.

Utilisée avec -d, cette option permet de supprimer une catégorie (noeud) qui ne dispose pas du lien Supprimer catégorie dans la page Configuration.

Exemples
*
Importez les paramètres de configuration depuis le fichier Product_config.xml situé dans le répertoire conf de l’installation de Marketing Platform.
configTool -i -p "Affinium" -f Product_config.xml
*
Importez l'un des modèles de source de données Campaign fournis dans la partition Campaign par défaut, partition1.L’exemple suppose que vous avez placé le modèle de source de données Oracle, OracleTemplate.xml, dans le répertoire tools/bin de l’installation de Marketing Platform.
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
Exportez tous les paramètres de configuration dans un fichier myConfig.xml situé dans le répertoire D:\backups.
configTool -x -f D:\backups\myConfig.xml
*
Exportez une partition de Campaign existante (complète avec entrées de source de données), enregistrez-la dans un fichier partitionTemplate.xml, situé dans le répertoire par défaut tools/bin de l’installation de Marketing Platform.
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Enregistrez manuellement une application nommée productName à l’aide d’un fichier app_config.xml situé dans le répertoire par défaut tools/bin de l’installation de Marketing Platform, puis forcez le remplacement d’un enregistrement existant de cette application.
configTool -r product Name -f app_config.xml -o
*
configTool -u productName


IBM Unica Marketing Platform
 
8
For more information, see our support and community site: Customer Central