Utility configTool

Le proprietà e i valori della pagina Configurazione sono memorizzati nelle tabelle di sistema di Marketing Platform . L'utility configTool importa ed esporta le impostazioni di configurazione e verso le tabelle di sistema di IBM Unica Marketing Platform .

Quando utilizzare configTool

Utilizzare configTool per i seguenti motivi.

*
*
*
*
Per eliminare le categorie che non dispongono di un collegamento Elimina categoria. A questo scopo, utilizzare configTool per esportare la configurazione e quindi eliminare manualmente l'XML che crea la categoria. Tramite configTool, quindi, importare l'XML modificato.
*
Questa utility modifica le tabelle usm_configuration e usm_configuration_values nel database delle tabelle di sistema di Marketing Platform , che contiene le proprietà di configurazione e i relativi valori. Per ottenere i migliori risultati, è consigliabile creare copie di backup di queste tabelle o esportare le configurazioni esistenti tramite configTool per poi eseguire il backup del file ottenuto, in modo da poter ripristinare la configurazione in caso si commettano errori nell'uso di configTool per l'importazione.
Nomi di prodotto validi

Come descritto più avanti in questa sezione, l'utility configTool utilizza i nomi dei prodotti come parametri con i comandi che registrano e annullano la registrazione dei prodotti. Con la versione 8.0.0 di IBM Unica Marketing, molti nomi di prodotti sono cambiati, mentre non sono cambiati i nomi riconosciuti da configTool. Di seguito sono elencati i nomi di prodotto validi da utilizzare con configTool, con i relativi nomi correnti.

Sintassi

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

Comandi

-d -p " elementPath"

Elimina le proprietà di configurazione e le relative impostazioni, specificando un percorso nella gerarchia delle proprietà di configurazione.

Il percorso dell'elemento deve utilizzare i nomi interni di categorie e proprietà, ottenibili nella pagina Configurazione, selezionando la categoria o proprietà desiderata e consultando il percorso visualizzato tra parentesi nel riquadro di destra. Delimitare un percorso nella gerarchia delle proprietà di configurazione tramite il carattere |, racchiudendo il percorso tra virgolette doppie.

Si noti quanto segue.

*
*
Per eliminare le categorie che non dispongono del collegamento Elimina categoria nella pagina Configurazione, utilizzare l'opzione -o.

-i -p " parentElementPath" -f importFile

Importa le proprietà di configurazione e le relative impostazioni da un file XML specificato.

Per eseguire l'importazione, specificare il percorso per l'elemento padre in cui si desidera importare le categorie. L'utility configTool importa le proprietà sotto la categoria specificata nel percorso.

È possibile aggiungere le categorie a qualsiasi livello sotto quello più elevato, ma non è possibile aggiungere una categoria al livello della categoria più alta.

Il percorso dell'elemento padre deve utilizzare i nomi interni di categorie e proprietà, ottenibili nella pagina Configurazione, selezionando la categoria o proprietà desiderata e consultando il percorso visualizzato tra parentesi nel riquadro di destra. Delimitare un percorso nella gerarchia delle proprietà di configurazione tramite il carattere |, racchiudendo il percorso tra virgolette doppie.

È possibile specificare la posizione del file di importazione rispetto alla directory tools/bin oppure specificare un percorso di directory completo. Se si specifica un percorso relativo o non si specifica alcun percorso, configTool ricerca prima di tutto il file in relazione alla directory tools/bin.

Per impostazione predefinita, questo comando non sovrascrive una categoria esistente, ma è possibile utilizzare l'opzione -o per forzare la sovrascrittura.

-x -p " elementPath" -f exportFile

Esporta le proprietà di configurazione e le relative impostazioni in un file XML con un nome specificato.

È possibile esportare tutte le proprietà di configurazione o limitare l'esportazione a una categoria desiderata, specificando un percorso nella gerarchia delle proprietà di configurazione.

Il percorso dell'elemento deve utilizzare i nomi interni di categorie e proprietà, ottenibili nella pagina Configurazione, selezionando la categoria o proprietà desiderata e consultando il percorso visualizzato tra parentesi nel riquadro di destra. Delimitare un percorso nella gerarchia delle proprietà di configurazione tramite il carattere |, racchiudendo il percorso tra virgolette doppie.

È possibile specificare la posizione del file di esportazione rispetto alla directory corrente oppure specificare un percorso di directory completo. Se la specifica del file non contiene un separatore (/ per Unix, / o \ per Windows), configTool scrive il file nella directory tools/bin dell'installazione di Marketing Platform . Se non si fornisce l'estensione xml, configTool la aggiunge.

-r productName -f registrationFile

Registra l'applicazione. La posizione del file di registrazione può essere relativa alla directory tools/bin oppure è possibile specificare un percorso completo. Per impostazione predefinita, questo comando non sovrascrive una configurazione esistente, ma è possibile utilizzare l'opzione -o per forzare la sovrascrittura. Il parametro productName deve essere uno di quelli elencati sopra.

-u productName

Annulla la registrazione di un'applicazione specificata in base a productName. Non è necessario includere un percorso alla categoria del prodotto, il nome del prodotto è sufficiente. Il parametro productName deve essere uno di quelli elencati sopra. In tal modo si eliminano tutte le proprietà e le impostazioni di configurazione per il prodotto.

Opzioni

-o

Quando utilizzato con -i o -r, sovrascrive una categoria o una registrazione di prodotto (nodo) esistente.

Quando utilizzato con -d permette di eliminare una categoria (nodo) che non dispone del collegamento Elimina categoria nella pagina Configurazione.

Esempi
*
Importazione delle impostazioni di configurazione da un file denominato Product_config.xml che si trova nella directory conf dell'installazione di Marketing Platform .
configTool -i -p "Affinium" -f Product_config.xml
*
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
Esportazione di tutte le impostazioni di configurazione in un file denominato myConfig.xml che si trova nella directory D:\backups.
configTool -x -f D:\backups\myConfig.xml
*
Esportazione di una partizione Campaign esistente, completa di voci delle origini dati, salvataggio in un file denominato partitionTemplate.xml e memorizzazione nella directory predefinita tools/bin dell'installazione di Marketing Platform .
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Registrazione manuale di un'applicazione denominata productName tramite un file denominato app_config.xml che si trova nella directory predefinita tools/bin dell'installazione di Marketing Platform e sovrascrittura forzata di una registrazione esistente della stessa applicazione.
configTool -r product Name -f app_config.xml -o
*
configTool -u productName


IBM Unica Marketing Platform
 
8.5.0
For more information, see our support and community site: Customer Central