O Utilitário configTool

As propriedades e os valores na página Configuração são armazenadas nas tabelas de sistema do Plataforma de Marketing. O utilitário configTool importa, e também exporta, as definições de configuração das tabelas de sistema do Plataforma de Marketing.

Quando Usar o configTool

Você poderá desejar usar o configTool pelos seguintes motivos.

Para importar modelos de partição e de origem de dados fornecidos com o Campaign , que podem então ser modificados e duplicados usando a página de Configuração.

Para registrar (importar as propriedades de configuração para) produtos do IBM® EMM, se o instalador do produto não puder incluir as propriedades no banco de dados automaticamente.

Para exportar uma versão de XML das definições de configuração para backup ou para importar em uma instalação diferente do IBM® EMM.

Para excluir as categorias que não têm o link Excluir Categoria. Isso é feito usando o configTool para exportar sua configuração, excluindo, então, o XML que cria a categoria e usando o configTool para importar o XML editado.

Esse utilitário modifica as tabelas usm_configuration e usm_configuration_values no banco de dados da tabela de sistema Plataforma de Marketing, o qual contém as propriedades de configuração e seus valores. Para obter melhores resultados, crie cópias de backup dessas tabelas ou exporte as configurações existentes usando o configTool e faça o backup do arquivo resultante para que tenha uma forma de restaurar a configuração se cometer um erro usando o configTool para a importação.

Nomes válidos de produtos

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 liberação 8.0.0 do IBM® EMM, muitos nomes de produtos foram alterados. Entretanto, os nomes reconhecidos pelo configTool não foram alterados. Os nomes válidos de produtos para uso com o configTool estão listados abaixo, juntamente com os nomes atuais dos produtos.

Nome do produto	Nome usado no configTool
Plataforma de Marketing	Manager
Campaign	Campaign
Marketing Distribuído	Collaborate
eMessage	emessage
Interagir	interact
Contact Optimization	Optimize
Operações de Marketing	Plan
CustomerInsight	Insight
Digital Analytics for On Premises	NetInsight
PredictiveInsight	Model
Líderes	Leads

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"

Exclua as propriedades de configuração e suas definições especificando um caminho na hierarquia de propriedades de configuração.

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

Observe o seguinte.

Somente categorias e propriedades em um aplicativo podem ser excluídas usando esse comando, não aplicativos inteiros. Use o comando -u para cancelar o registro de um aplicativo inteiro.

Para excluir as categorias que não têm o link Excluir Categoria na página Configuração, use a opção -o.

-i -p "parentElementPath" -f importFile

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

Para importar, você especifica um caminho para o elemento-pai, sob o qual deseja importar as categorias. O utilitário configTool importa propriedades sob a categoria especificada no caminho.

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

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

É possível especificar um local de arquivo de importação relativo ao diretório tools/bin ou especificar um caminho completo de diretório. Se especificar um caminho relativo ou não especificar nenhum caminho, o configTool olha primeiro para o arquivo relativo ao diretório tools/bin.

Por padrão, este comando não sobrescreve uma categoria existente, mas é possível usar a opção -o para forçar uma sobrescrição.

-x -p "elementPath" -f exportFile

Exporte as 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 de propriedades de configuração.

É possível especificar um local de arquivo de exportação relativo ao diretório atual ou especificar um caminho completo de diretório. Se a especificação de arquivo não contiver um separador (/ no Unix / ou \ no Windows™), o configTool grava o arquivo no diretório tools/bin, sob a instalação do Plataforma de Marketing. Se não fornecer a extensão xml, o configTool a inclui.

-r productName -f registrationFile

Registre o aplicativo. O local do arquivo de registro pode ser relativo ao diretório tools/bin ou pode ser um caminho completo. Por padrão, este comando não sobrescreve uma configuração existente, mas é possível usar a opção -o para forçar uma sobrescrição. O parâmetro productName deve ser um daqueles listados acima.

Observe o seguinte.

Ao usar a opção -r, o arquivo de registro dever ter <application> como a primeira tag no XML.

Outros arquivos podem ser fornecidos com o produto e podem ser usados para inserir propriedades de configuração do banco de dados do Plataforma de Marketing. Para esses arquivos, use a opção -i. Somente o arquivo que tem a tag <application> como a primeira tag pode ser usado com a opção -r.

O arquivo de registro para o Plataforma de Marketing é denominado Manager_config.xml e a primeira tag é <Suite>. Para registrar esse arquivo em uma nova instalação, use o utilitário populateDb ou execute novamente o instalador do Plataforma de Marketing, conforme descrito no Guia de Instalação do IBM® Plataforma de Marketing.

Após a instalação inicial, para registrar novamente produtos diferentes do Plataforma de Marketing, use configTool com a opção -r e -o para sobrescrever as propriedades existentes.

-u productName

Cancele o registro de um aplicativo especificado por productName. Não é necessário incluir um caminho na categoria do produto; o nome do produto é suficiente. O parâmetro productName deve ser um dos listados acima. Isto 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 ou um registro do produto existente (nó).

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

Exemplos

Importar definições de configuração de um arquivo denominado Product_config.xml localizado no diretório conf sob a instalação do Plataforma de Marketing.

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

Importar um dos modelos de origem de dados do Campaign fornecidos na partição padrão do Campaign , partition1. O exemplo assume que você colocou o modelo de origem de dados Oracle, OracleTemplate.xml, no diretório tools/bin sob a instalação do Plataforma de Marketing.

configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml

Exportar todas as definições de configuração para um arquivo denominado myConfig.xml localizado no diretório D:\backups.

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

Exportar uma partição existente do Campaign (completa com entradas de origem de dados), salvá-la em um arquivo denominado partitionTemplate.xml e armazená-la no diretório tools/bin padrão sob a instalação do Plataforma de Marketing.

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

Registrar manualmente um aplicativo denominado productName, usando um arquivo denominado app_config.xml localizado no diretório tools/bin padrão sob a instalação do Plataforma de Marketing e forçá-lo a sobrescrever um registro existente deste aplicativo.

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

Cancelar registro de um aplicativo denominado productName.

configTool -u productName