Dienstprogramm configTool

Eigenschaften und Werte auf der Konfigurationsseite werden in den Marketing Platform-Systemtabellen gespeichert. Mit dem Dienstprogramm configTool werden Konfigurationseinstellungen in und aus Marketing Platform-Systemtabellen importiert und exportiert.

Verwendung von configTool

Sie können configTool für folgende Zwecke verwenden:

Importieren von in Campaign bereitgestellten Partitions- und Datenquellenvorlagen, die Sie anschließend auf der Seite "Konfiguration" ändern und duplizieren können.

Registrieren (Importieren von Konfigurationseigenschaften) von IBM® EMM-Produkten, wenn das Installationsprogramm die Eigenschaften nicht automatisch in die Datenbank einfügen kann.

Exportieren einer XML-Version der Konfigurationseinstellungen als Sicherung oder um sie in eine andere Installation von IBM® EMM zu importieren.

Löschen von Kategorien, für die es keinen Link Kategorie löschen gibt. Dazu exportieren Sie die Konfiguration mit configTool, löschen anschließend manuell die XML-Datei, die die Kategorie erstellt, und importieren mit configTool die bearbeitete XML-Datei.

Mit diesem Dienstprogramm werden die Tabellen usm_configuration und usm_configuration_values in der Systemtabellendatenbank von Marketing Platform geändert. Diese Tabellen enthalten die Konfigurationseigenschaften und deren Werte. Die besten Ergebnisse erzielen Sie, wenn Sie entweder Sicherungskopien dieser Tabellen erstellen oder die vorhandene Konfiguration mit configTool exportieren und eine Sicherungskopie der resultierenden Datei erstellen. Auf diese Weise haben Sie die Möglichkeit, die Konfiguration wiederherzustellen, sollte es beim Import mit configTool zu einem Fehler kommen.

Gültige Produktnamen

Das Dienstprogramm configTool verwendet Produktnamen als Parameter für die Befehle zur Registrierung und zur Aufhebung der Registrierung von Produkten. Mehr dazu finden Sie weiter unten in diesem Abschnitt. Bei dem Release 8.0.0 von IBM® EMM haben sich viele Produktnamen geändert. Die von configTool erkannten Namen haben sich allerdings nicht geändert. In der folgenden Liste sind die Produktnamen für configTool den aktuellen Produktnamen gegenübergestellt.

Produktname	In configTool verwendeter Name
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Contact Optimization	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 von Konfigurationseigenschaften und deren Einstellungen mit Angabe eines Pfads in der Hierarchie der Konfigurationseigenschaften.

Beim Elementpfad müssen die internen Namen von Kategorien und Eigenschaften verwendet werden. Diese erhalten Sie, indem Sie auf der Konfigurationsseite die gewünschte Kategorie oder Eigenschaft auswählen. Rechts steht dann in Klammern der Pfad. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Folgendes beachten:

Mit diesem Befehl können nur Kategorien und Eigenschaften in einer Anwendung gelöscht werden, nicht ganze Anwendungen. Zum Aufheben der Registrierung einer Anwendung verwenden Sie den Befehl -u.

Um Kategorien zu löschen, bei denen der Link Kategorie löschen nicht auf der Konfigurationsseite steht, verwenden Sie die Option -o.

-i -p "parentElementPath" -f importFile

Importieren von Konfigurationseigenschaften und deren Einstellungen aus einer angegebenen XML-Datei.

Zum Importieren geben Sie einen Pfad zum übergeordneten Element an, in das Sie die Kategorien exportieren möchten. Das Dienstprogramm configTool speichert Eigenschaften in der Kategorie, die Sie im Pfad angeben.

Sie können Kategorien auf jeder beliebigen Ebene unterhalb Ausgangsebene speichern, nicht aber auf der Ausgangsebene.

Beim übergeordneten Elementpfad müssen die internen Namen von Kategorien und Eigenschaften verwendet werden. Sie erhalten diese, indem Sie auf die Konfigurationsseite gehen und die gewünschte Kategorie oder Eigenschaft auswählen. Rechts steht dann in Klammern der Pfad. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Sie können die Speicherposition einer Importdatei relativ zum Verzeichnis tools/bin oder auch einen vollständigen Verzeichnispfad angeben. Wenn Sie einen relativen Pfad oder keinen Pfad angeben, sucht configTool zunächst nach der Datei relativ zum Verzeichnis tools/bin.

Standardmäßig wird mit diesem Befehl eine vorhandene Kategorie nicht überschrieben. Mit der Option -o können Sie jedoch das Überschreiben erzwingen.

-x -p "elementPath" -f exportFile

Exportieren von Konfigurationseigenschaften und deren Einstellungen in eine XML-Datei mit einem angegebenen Namen.

Sie können alle Konfigurationseinstellungen exportieren oder den Export begrenzen, indem Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften angeben.

Beim Elementpfad müssen die internen Namen von Kategorien und Eigenschaften verwendet werden. Sie erhalten diese, indem Sie auf die Konfigurationsseite gehen und die gewünschte Kategorie oder Eigenschaft auswählen. Rechts steht dann in Klammern der Pfad. Begrenzen Sie einen Pfad in der Hierarchie der Konfigurationseigenschaften mit dem Zeichen | und setzen ihn in doppelte Anführungszeichen.

Sie können die Speicherposition einer Importdatei relativ zum aktuellen Verzeichnis oder auch einen vollständigen Verzeichnispfad angeben. Wenn die Dateispezifikation kein Trennzeichen enthält (/ unter Unix, / oder \ unter Windows™), schreibt configTool die Datei in das tools/bin-Verzeichnis in der Marketing Platform-Installation. Wenn Sie die Erweiterung xml nicht hinzufügen, wird sie von configTool automatisch hinzugefügt.

-r productName -f registrationFile

Registrieren der Anwendung. Die Speicherposition der Registrierungsdatei kann relativ zum Verzeichnis tools/bin oder mit einem vollständigen Pfad angegeben werden. Standardmäßig wird mit diesem Befehl eine vorhandene Konfiguration nicht überschrieben. Sie können aber mit der Option -o das Überschreiben erzwingen. Der Wert des Parameters productName muss einer der oben aufgeführten Produktnamen sein.

Folgendes beachten:

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

Mit Ihrem Produkt können andere Dateien bereitgestellt werden, mit denen Sie Konfigurationseigenschaften in die Marketing Platform-Datenbank einfügen können. Verwenden Sie bei diesen Dateien die Option -i. Die Option -r kann nur bei der Datei verwendet werden, in der <application> der erste Tag ist.

Die Registrierungsdatei für Marketing Platform lautet Manager_config.xml und der erste Tag ist <Suite>. Zur Registrierung dieser Datei bei einer neuen Installation verwenden Sie das Dienstprogramm populateDb oder führen Sie erneut das Installationsprogramm Marketing Platform entsprechend der Beschreibung im IBM® Marketing Platform-Installationshandbuch aus.

Um nach der Erstinstallation andere Produkte als Marketing Platform erneut zu registrieren, verwenden Sie configTool mit der Option -r und -o zum Überschreiben der vorhandenen Eigenschaften.

-u productName

Eine mit productName angegebene Registrierung aufheben. Sie müssen keinen Pfad zur Produktkategorie angeben, der Produktname reicht aus. Der Wert des Parameters productName muss einer der oben aufgeführten Produktnamen sein. Damit werden alle Eigenschaften und Konfigurationseinstellungen des Produkts entfernt.

Optionen

-o

Bei Verwendung in Verbindung mit -i oder -r wird eine vorhandene Kategorie oder eine vorhandene Produktregistrierung (Knoten) überschrieben.

Bei Verwendung in Verbindung mit -d können Sie eine Kategorie (Knoten) löschen, bei der auf der Konfigurationsseite kein Link Kategorie löschen vorhanden ist.

Beispiele

Importieren von Konfigurationseinstellungen aus der Datei Product_config.xml im Verzeichnis conf der Marketing Platform-Installation.

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

Importieren einer der bereitgestellten Campaign-Datenquellenvorlagen in die Campaign-Standardpartition, Partition1. Die Oracle-Datenquellenvorlage OracleTemplate.xml befindet sich bei diesem Beispiel im Verzeichnis tools/bin in der Marketing Platform-Installation.

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 vorhandenen Campaign-Partition (komplett mit Datenquelleneinträgen), Speichern in der Datei partitionTemplate.xml im Verzeichnis tools/bin in der Marketing Platform-Installation.

configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml

Manuelles Registrieren der Anwendung productName mit der Datei app_config.xml im Standardverzeichnis tools/bin in der Marketing Platform-Installation und erzwungenes Überschreiben einer vorhandenen Registrierung dieser Anwendung.

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

Aufheben der Registrierung einer Anwendung mit dem Namen productName.

configTool -u productName