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 à partir des tables système de Marketing 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 exporter une version XML des paramètres de communication à des fins de sauvegarde ou d'importation vers une autre installation d'IBM® Unica Marketing.

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.

Nom du produit	Nom utilisé dans configTool
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Optimize	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
NetInsight	NetInsight
PredictiveInsight	Model
Leads	Leads

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 panneau 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.

Gardez à l’esprit les points suivants :

Seules les catégories et propriétés d’une application, et non les applications entières, peuvent être supprimées à l’aide de cette commande. Utilisez la commande -u pour annuler l’enregistrement d’une application entière.

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 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.

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.

Gardez à l’esprit les points suivants :

Lorsque vous utilisez l'option -r, le fichier d'enregistrement doit posséder <application> en tant que première balise dans le XML.

D'autres fichiers peuvent être fournis avec votre produit, que vous pouvez utiliser pour insérer des propriétés de configuration dans la base de données de Marketing Platform. Pour ces fichiers, utilisez l'option -i. Seul le fichier qui possède la balise <application> comme première balise peut être utilisé avec l'option -r.

Le fichier d'enregistrement pour Marketing Platform est nommé Manager_config.xml et la première balise est <Suite>. Pour enregistrer ce fichier sur une nouvelle installation, faites appel à l'utilitaire populateDb, ou exécutez à nouveau le programme d'installation de Marketing Platform comme décrit dans le Guide d'installation d'IBM® Unica® Marketing Platform.

Après l'installation initiale, pour enregistrer à nouveau des produits différents de Marketing Platform, utilisez configTool avec les options -r et -o pour écraser les propriétés existantes.

-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 à partir du 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

Annulez l’enregistrement d’une application productName.

configTool -u productName