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 Marketing Platform-Systemtabellen.

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.

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 dem Release 8.0.0 von IBM® Unica Marketing wurden viele Produktnamen geändert. Die in configTool erkannten 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.

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

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

Für den Elementpfad müssen die internen Namen von 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 im rechten Fensterbereich in Klammern angezeigt. Grenzen Sie einen Pfad in der Konfigurationseigenschaftshierarchie mit dem Zeichen | ab, und fassen Sie den Pfad in doppelte Anführungszeichen.

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 von 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 im rechten Fensterbereich 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.

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

-r Produktname -f Registrierungsdatei

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.

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

Möglicherweise sind in Ihrem Produkt andere Dateien enthalten, die Sie verwenden können, um Konfigurationseigenschaften in die Marketing Platform-Datenbank einzufügen. Verwenden Sie für diese Dateien die Option -i. Nur die Datei, in der der Tag <application> als erster Tag enthalten ist, kann mit der Option -r verwendet werden.

Die Registrierungsdatei für die Marketing Platform hat den Namen Manager_config.xml und der erste Tag lautet <Suite>. Um diese Datei in einer neuen Installation zu registrieren, verwenden Sie das Dienstprogramm populateDb oder führen Sie das Marketing Platform-Installationsprogramm erneut aus wie im IBM® Unica®Marketing Platform-Installationshandbuch beschrieben.

Verwenden Sie nach der Erstinstallation zur Aufhebung der Registrierung für alle anderen Produkte mit Ausnahme der Marketing Platform das Dienstprogramm configTool mit den Optionen -r und -o, um die vorhandenen Eigenschaften zu überschreiben.

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.

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

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

Importieren Sie eine der bereitgestellten Campaign -Datenquellenvorlagen in die Campaign -Standardpartition, partition1. Bei dem Beispiel wird davon ausgegangen, dass Sie die Oracle-Datenquellenvorlage, OracleTemplate.xml, im Verzeichnis tools/bin unter der Marketing Platform-Installation gespeichert haben.

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.

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.

Produktname	In "configTool" verwendeter Name
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