Dienstprogramm 'configTool'

Die Eigenschaften und Werte auf den Seite 'Konfiguration' werden in den Marketing Platform-Systemtabellen gespeichert. Das Dienstprogramm configTool führt für die Marketing Platform-Systemtabellen den Import und den Export von Konfigurationseinstellungen aus.

Einsatzmöglichkeiten für "configTool"

In den folgenden Situationen können Sie configTool verwenden:

Zum Importieren der in Kampagne bereitgestellten Partitions- und Datenquellenvorlagen, die Sie anschließend über die Seite 'Konfiguration' ändern und duplizieren können.

Zum Registrieren von (Importieren der Konfigurationseinstellungen für) IBM® EMM-Produkten, wenn das Installationsprogramm die Eigenschaften nicht automatisch zur Datenbank hinzufügen kann.

Zum Exportieren einer XML-Version der Konfigurationseinstellungen für die Sicherung oder zum Importieren in eine andere Installation von IBM® EMM.

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 Konfigurationseinstellungen und die zugehörigen Werte enthalten. Um die besten Ergebnisse zu erzielen, erstellen Sie entweder Sicherheitskopien dieser Tabellen oder exportieren Sie Ihre aktuellen Konfigurationen mit configTool und sichern Sie die so erstellte Datei. So haben Sie die Möglichkeit, Ihre Konfiguration wiederherzustellen, falls der Import mit configTool fehlschlägt.

Gültige Produktnamen

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

Produktname	In 'configTool' verwendeter Name
Marketing Platform	Manager
Kampagne	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Kontaktoptimierung	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
Digital Analytics for On Premises	NetInsight
PredictiveInsight	Model
Leads	Leads

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 Sie die Konfigurationseinstellungen und die entsprechenden Einstellungen durch Festlegen eines Pfads in der Konfigurationseinstellungshierarchie.

Für den Elementpfad müssen die internen Namen der Kategorien und Eigenschaften 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 Hierarchie der Konfigurationseigenschaften mit dem Zeichen | ab und setzen Sie den Pfad in doppelte Anführungszeichen.

Folgendes beachten:

Mit diesem Befehl können keine ganzen Anwendungen, sondern nur Kategorien und Eigenschaften innerhalb einer Anwendung gelöscht werden. Verwenden Sie den Befehl -u, um eine komplette Registrierung einer Anwendung aufzuheben.

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 Konfigurationseinstellungen 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 übergeordneter Elementpfad müssen die internen Namen der Kategorien und Eigenschaften 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 Hierarchie der Konfigurationseigenschaften mit dem Zeichen | ab und setzen Sie den Pfad in doppelte Anführungszeichen.

Sie können einen Datenträger für die Importdatei mit Bezug zum Verzeichnis tools/bin oder einen vollständigen Verzeichnispfad festlegen. Unabhängig davon, ob Sie einen relativen Pfad oder keinen Pfad festlegen, sucht configTool zuerst nach der Datei, die sich auf das Verzeichnis tools/bin bezieht.

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 Konfigurationseinstellungen und deren Einstellungen an eine XML-Datei mit festgelegtem Namen.

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

Sie können für die Exportdatei einen Datenträger, der sich auf das aktuelle Verzeichnis bezieht, oder einen vollständigen Verzeichnispfad festlegen. Falls die Dateispezifikation kein Trennzeichen (/ bei Unix, / oder \ bei Windows™) enthält, schreibt configTool die Datei in das Verzeichnis tools/bin in Ihrer Marketing Platform-Installation. Falls Sie die Erweiterung xml nicht bereitstellen, wird sie von configTool hinzugefügt.

-r productName -f registrationFile

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

Folgendes beachten:

Wenn Sie die Option -r verwenden, muss das erste Tag in der XML-Datei der Registrierung <application> sein.

Zusammen mit dem Produkt werden eventuell andere Dateien zur Verfügung gestellt, mit deren Hilfe Sie Konfigurationseinstellungen in die Marketing Platform-Datenbank einfügen können. Verwenden Sie für diese Dateien die Option -i. Nur die Datei, deren erstes Tag das Tag <application> ist, kann mit der Option -r verwendet werden.

Der Name der Registrierungsdatei für Marketing Platform ist Manager_config.xml und das erste Tag ist <Suite>. Um diese Datei auf einer neuen Installation zu registrieren, verwenden Sie das Dienstprogramm populateDb, oder führen Sie das Marketing Platform-Installationsprogramm erneut aus, wie im IBM® Marketing Platform Installationshandbuch beschrieben.

Verwenden Sie nach der Erstinstallation für die erneute Registrierung von allen Produkten außer Marketing Platform configTool mit der Option -r und der Option -o, um die bestehenden Eigenschaften zu überschreiben.

-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 unter der Marketing Platform-Installation.

configTool -i -p "Affinium" -f Product_config.xml

Importieren von einer der Kampagne -Datenquellenvorlagen in die Kampagne -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

Exportieren aller Konfigurationseinstellungen in die Datei myConfig.xml im Verzeichnis D:\backups.

configTool -x -f D:\backups\myConfig.xml

Exportieren einer bestehenden Kampagne -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, die im Standardverzeichnis tools/bin unter der Marketing Platform-Installation gespeichert ist, und Überschreiben einer bestehenden Registrierung dieser Anwendung.

configTool -r product Name -f app_config.xml -o

Heben Sie die Registrierung einer Anwendung namens productName auf.

configTool -u productName