Das Dienstprogramm „configTool“

Die Eigenschaften und Werte auf der Seite "Konfiguration" werden in den Marketing Platform-Systemtabellen gespeichert. Das Dienstprogramm configTool importiert und exportiert Konfigurationseinstellungen aus den IBM UnicaMarketing Platform-Systemtabellen.

Wann „configTool“ verwendet werden sollte

In folgenden Situationen können Sie configTool verwenden.

*
Zum Importieren der in Campaign bereitgestellten Partitions- und Datenquellenvorlagen, die Sie anschließend über die Seite „Konfiguration“ bearbeiten und/oder duplizieren können.
*
Zum Registrieren von (Importieren der Konfigurationseigenschaften für) IBM Unica Marketing-Produkte, wenn das Installationsprogramm die Eigenschaften nicht automatisch zur Datenbank hinzufügen kann.
*
*
Zum Löschen von Kategorien, die nicht über den Link Kategorie löschen verfügen. Hierzu verwenden Sie configTool, um Ihre Konfiguration zu exportieren. Anschließend löschen Sie die XML, die die Kategorie erstellt, und verwenden configTool, um die bearbeitete XML zu importieren.
*
Dieses Dienstprogramm modifiziert die Tabellen usm_configuration und usm_configuration_values in der Marketing Platform-Systemtabellendatenbank, die die Konfigurationseigenschaften und die zugehörigen Werte enthalten. Es wird empfohlen, dass Sie entweder Sicherheitskopien dieser Tabellen erstellen oder Ihre aktuellen Konfigurationen mit configTool exportieren, und die so erstellte Datei sichern. So haben Sie die Möglichkeit, Ihre Konfiguration wieder herzustellen, falls der Import mit configTool fehlschlägt.
Gültige Produktnamen

Das Dienstprogramm configTool verwendet Produktnamen als Parameter mit den Befehlen, die zur Registrierung und Abmeldung von Produkten eingesetzt werden. Nähere Informationen hierzu finden Sie in einem späteren Teil dieses Abschnitts. Mit der Version 8.0.0 von IBM Unica Marketing wurden zahlreiche Produktnamen geändert. Die von configTool erkannten Namen haben sich allerdings nicht geändert.Die gültigen Produktnamen für die Nutzung mit configTool sowie die aktuellen Namen der Produkte sind nachfolgend aufgeführt.

Syntax

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

Befehle

-d -p " elementPath"

Löschen der Konfigurationseigenschaften und der entsprechenden Einstellungen durch Festlegen eines Pfads in der Konfigurationseigenschaftshierarchie.

Für den Element-Pfad müssen die internen Namen und Kategorien verwendet werden. Diese können über die Seite "Konfiguration" abgerufen werden. Wählen Sie hier die gewünschte Kategorie oder Eigenschaft aus; der entsprechende Pfad wird auf der rechten Seite des Bildschirms in Klammern angezeigt. Grenzen Sie einen Pfad in der Konfigurationseigenschaftshierarchie mit dem Zeichen | ab, und fassen Sie den Pfad in doppelte Anführungszeichen.

Folgendes beachten:

*
*
Um Kategorien zu löschen, die auf der Seite Konfiguration nicht über den Link Kategorie löschen verfügen, verwenden Sie die Option -o.

-i -p " parentElementPath" -f importFile

Importieren von Konfigurationseigenschaften und dessen Einstellungen aus einer festgelegten XML-Datei.

Zum Importieren geben Sie den Pfad zu dem übergeordneten Element an, unter welchem Sie die Kategorien speichern möchten. Das Dienstprogramm configTool importiert Eigenschaften unter der Kategorie, die Sie im Pfad angeben.

Sie können Kategorien auf jeder Ebene unter der obersten Ebene speichern. In die Ebene der obersten Kategorie können Sie jedoch keine Kategorie hinzufügen.

Für den Pfad des übergeordneten Elements müssen die internen Namen und Kategorien verwendet werden. Diese können über die Seite "Konfiguration" abgerufen werden. Wählen Sie hier die gewünschte Kategorie oder Eigenschaft aus; der entsprechende Pfad wird auf der rechten Seite des Bildschirms in Klammern angezeigt.Grenzen Sie einen Pfad in der Konfigurationseigenschaftshierarchie mit dem Zeichen | ab, und fassen Sie den Pfad in doppelte Anführungszeichen.

Sie können für die Importdatei einen Speicherort, der sich auf das aktuelle Verzeichnis tools/bin bezieht, oder einen vollständigen Verzeichnispfad, festlegen.Egal ob Sie einen bezugnehmenden Pfad oder keinen Pfad festlegen, configTool sucht zunächst nach der Datei mit Bezug zum Verzeichnis tools/bin.

Standardmäßig werden bestehende Kategorien nicht überschrieben. Falls Sie das wünschen, können Sie jedoch die Option -o verwenden.

-x -p " elementPath" -f exportFile

Exportieren von Konfigurationseigenschaften und dessen Einstellungen an eine XML-Datei mit festgelegtem Namen.

Sie können alle Konfigurationseigenschaften exportieren oder den Export auf eine bestimmte Kategorie beschränken, indem Sie einen Pfad in der Konfigurationseigenschaftshierarchie festlegen.

Für den Element-Pfad müssen die internen Namen und Kategorien verwendet werden. Diese können über die Seite "Konfiguration" abgerufen werden. Wählen Sie hier die gewünschte Kategorie oder Eigenschaft aus; der entsprechende Pfad wird auf der rechten Seite des Bildschirms in Klammern angezeigt.Grenzen Sie einen Pfad in der Konfigurationseigenschaftshierarchie mit dem Zeichen | ab, und fassen Sie den Pfad in doppelte Anführungszeichen.

Sie können für die Exportdatei einen Speicherort, der sich auf das aktuelle Verzeichnis bezieht, oder einen vollständigen Verzeichnispfad festlegen.Falls der Dateipfad kein Trennzeichen (/ in Unix, / oder \ in Windows) enthält, speichert configTool die Datei im Verzeichnis tools/bin in Ihrer Marketing Platform-Installation.Falls Sie die Dateiendung xml nicht anfügen, wird diese von configTool angefügt.

-r productName -f registrationFile

Registrieren Sie die Anwendung. Der Speicherort der Registrierungsdatei kann sich auf das Verzeichnis tools/bin beziehen oder ein vollständiger Verzeichnispfad sein. Standardmäßig werden bestehende Konfigurationen nicht überschrieben. Falls Sie das wünschen, können Sie jedoch die Option -o verwenden.Der Parameter productName muss einer der in der obigen Liste aufgeführten Parameter sein.

-u productName

Abmelden einer durch productName festgelegten Anwendung.Sie müssen der Produktkategorie keinen Pfad hinzufügen; der Produktname ist ausreichend.Der Parameter productName muss einer der in der obigen Liste aufgeführten Parameter sein.Hierdurch werden alle Eigenschaften und Konfigurationseinstellungen für das Produkt entfernt.

Optionen

-o

Überschreibt in Verbindung mit -i oder -r eine bestehende Kategorie oder Produktregistrierung (Knoten).

Bei Nutzung mit -d können Sie eine Kategorie (Knoten) löschen, die auf der Seite "Konfiguration" keinen Link Kategorie löschen enthält.

Beispiele
*
Importieren von Konfigurationseinstellungen aus der Datei Product_config.xml aus dem Verzeichnis conf in der Marketing Platform-Installation.
configTool -i -p "Affinium" -f Product_config.xml
*
Importieren Sie eine der bereitgestellten Campaign-Datenquellenvorlagen in die Campaign-Standardpartition, partition1.Das Beispiel setzt voraus, dass Sie die Oracle-Datenquellenvorlage, OracleTemplate.xml, im Verzeichnis tools/bin unter der Marketing Platform-Installation gespeichert haben.
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
configTool -x -f D:\backups\myConfig.xml
*
Exportieren einer bestehenden Campaign-Partition (vollständig, mit Datenquelleneinträgen), Speichern in der Datei partitionTemplate.xml und Speichern im Standardverzeichnis tools/bin unter der Marketing Platform-Installation.
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Manuelles Registrieren der Anwendung "productName" unter Verwendung der Datei app_config.xml, gespeichert im Standardverzeichnis tools/bin in der Marketing Platform-Installation, und Überschreiben einer bestehenden Registrierung dieser Anwendung.
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