O utilitário configTool

As propriedades e valores da página Configuração são armazenados nas tabelas de sistema do Marketing Platform . O utilitário configTool importa e exporta definições de configuração de e para as tabelas de sistema do IBM Unica Marketing Platform.

Quando utilizar o configTool

O configTool pode ser usado pelas razões a seguir.

*
*
*
*
Para excluir categorias que não possuem o link Excluir Categoria. Faça isso usando o configTool para exportar suas configurações, em seguida exclua manualmente o XML que cria a categoria, e use o configTool para importar o XML editado.
*
Este utilitário modifica as tabelas usm_configuration e usm_configuration_values no banco de dados da tabela de sistema do Marketing Platform , que contém as propriedades de configuração e seus valores. Para melhores resultados, crie cópias de backup dessas tabelas, ou exporte suas configurações existentes usando o configTool e faça backup do arquivo resultante para ter uma forma de restaurar suas configurações se ocorrer um erro na utilização do configTool para importar.
Nomes de produtos válidos

O utilitário configTool usa nomes de produtos como parâmetros com os comandos que registram e cancelam o registro de produtos, conforme descrito posteriormente nesta seção. Com a versão 8.0.0 do IBM Unica Marketing, muitos nomes de produtos mudaram. No entanto, os nomes reconhecidos pelo configTool não mudaram. Os nomes de produtos válidos para uso com o configTool estão listados abaixo, juntamente com os nomes atuais dos produtos.

Sintaxe

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

Comandos

-d -p " elementPath"

Exclui propriedades de configuração e suas definições, especificando um caminho na hierarquia da propriedade de configuração.

O caminho do elemento deve usar os nomes internos das categorias e propriedades que podem ser obtidos na página Configurações, selecionando a categoria ou propriedade desejada, e verificando o caminho exibido entre parênteses no painel à direita. Delimite um caminho na hierarquia da propriedade de configuração usando o caractere |, e coloque o caminho entre aspas duplas.

Observe que:

*
*
Para excluir categorias que não possuem o link Excluir Categoria na página Configuração, use a opção -o.

-i -p " parentElementPath" -f importFile

Importa propriedades de configuração e suas definições de um arquivo XML especificado.

Para importar, especifique um caminho para o elemento pai sob o qual deseja importar suas categorias. O utilitário configTool importa propriedades sob a categoria especificada no caminho.

É possível adicionar categorias em qualquer nível abaixo do nível superior, mas não é possível adicionar uma categoria no mesmo nível da categoria superior.

O caminho do elemento pai deve usar os nomes internos das categorias e propriedades, que podem ser obtidos na página Configuração, selecionando a categoria ou propriedade desejada, e verificando o caminho exibido entre parênteses no painel à direita. Delimite um caminho na hierarquia da propriedade de configuração usando o caractere |, e coloque o caminho entre aspas duplas.

Especifique uma localização do arquivo de importação relativa ao diretório tools/bin ou especifique um caminho de diretório completo. Se um caminho relativo ou nenhum caminho for especificado, o configTool primeiro procura o arquivo relativo ao diretório tools/bin.

Por padrão, este comando não sobrescreve uma categoria existente, mas a opção -o pode ser usada para forçar uma substituição.

-x -p " elementPath" -f exportFile

Exporta propriedades de configuração e suas definições para um arquivo XML com um nome especificado.

É possível exportar todas as propriedades de configuração ou limitar a exportação a uma categoria específica determinando um caminho na hierarquia da propriedade de configuração.

O caminho do elemento deve usar os nomes internos das categorias e propriedades que podem ser obtidos na página Configuração, selecionando a categoria ou propriedade desejada, e verificando o caminho exibido entre parênteses no painel à direita. Delimite um caminho na hierarquia da propriedade de configuração usando o caractere |, e coloque o caminho entre aspas duplas.

Especifique uma localização do arquivo de exportação relativa ao diretório atual ou especifique um caminho de diretório completo. Se a especificação do arquivo não possuir um separador (/ no Unix, / ou \ no Windows), o configTool grava o arquivo no diretório tools/bin na sua instalação do Marketing Platform. Se a extensão xml não for fornecida, o configTool a adiciona.

-r productName -f registrationFile

Registra o aplicativo. A localização do arquivo de registro pode ser relativa ao diretório tools/bin ou pode ser um caminho completo. Por padrão, este comando não sobrescreve uma configuração existente, mas a opção -o pode ser usada para forçar uma substituição. O parâmetro productName deve ser um dos listados abaixo.

-u productName

Cancela o registro de um aplicativo especificado por productName. Não é necessário incluir um caminho para a categoria do produto; o nome do produto é suficiente. O parâmetro productName deve ser um dos listados abaixo. Isso remove todas as propriedades e definições de configuração para o produto.

Opções

-o

Quando usado com -i ou -r, sobrescreve uma categoria existente ou registro de produto (nó).

Quando usado com -d, permite excluir uma categoria (nó) que não tem o link Excluir Categoria na página Configuração.

Exemplos
*
Importa definições de configuração de um arquivo chamado Product_config.xml, localizado no diretório conf da instalação do Marketing Platform.
configTool -i -p "Affinium" -f Product_config.xml
*
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
Exporta todas as definições de configuração para um arquivo chamado myConfig.xml localizado no diretório D:\backups.
configTool -x -f D:\backups\myConfig.xml
*
Exporta uma partição do Campaign existente (completa com entradas de fonte de dados), salva em um arquivo chamado partitionTemplate.xml, e a armazena no diretório padrão tools/bin na instalação do Marketing Platform.
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Registra manualmente um aplicativo chamado productName, usando um arquivo chamado app_config.xml localizado no diretório padrão tools/bin da instalação do Marketing Platform , e o força a sobrescrever um registro existente deste aplicativo.
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