Utilidad configTool

Las propiedades y valores de la página Configuración se almacenan en las tablas del sistema de Marketing Platform. La utilidad configTool importa y exporta valores de configuración a y desde las tablas del sistema de Marketing Platform.

Cuándo se utiliza configTool

Puede que desee utilizar configTool por los motivos siguientes.

Para importar plantillas de origen de datos y partición proporcionadas con Campaign, que a continuación se pueden modificar y duplicar mediante la página Configuración.

Para registrar (importar las propiedades de configuración para) productos de IBM® EMM, si el instalador del producto no puede añadir las propiedades a la base de datos automáticamente.

Para exportar una versión XML de los valores de configuración para hacer una copia de seguridad o importarlos en una instalación diferente de IBM® EMM.

Para suprimir las categorías que no tienen el enlace Suprimir categoría. Para realizar esta acción utilice configTool para exportar la configuración y, a continuación, suprimir manualmente el XML que crea la categoría e importe el XML editado mediante configTool.

Esta utilidad modifica las tablas usm_configuration y usm_configuration_values en la base de datos de la tabla del sistema de Marketing Platform, que contiene las propiedades de configuración y sus valores. Para que los resultados sean óptimos, cree copias de seguridad de estas tablas o exporte las configuraciones existentes utilizando configTool y realice una copia de seguridad del archivo resultante de manera que pueda restaurar la configuración en caso de cometer un error al utilizar configTool para importar.

Nombres de producto válidos

La utilidad configTool utiliza los nombres de productos como parámetros con los comandos que registran y anulan el registros de productos, como se describe más adelante en esta sección. Con el release 8.0.0 de IBM® EMM, muchos nombres de productos han cambiado. Sin embargo, los nombres que configTool reconoce no han cambiado. Los nombres válidos de productos para utilizar con configTool se listan a continuación, junto con los nombres actuales de los productos.

Nombre del producto	Nombre utilizado en configTool
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

Sintaxis

configTool -d -p "rutaElemento" [-o]

configTool -i -p "rutaElemento padre" -f archivoImportación [-o]

configTool -x -p "rutaElemento" -f archivoExportación

configTool -r nombreProducto -f archivoRegistro [-o]

configTool -u nombreProducto

Comandos

-d -p "rutaElemento"

Permite suprimir propiedades de configuración y sus valores, especificando una ruta en la jerarquía de propiedades de configuración.

La ruta del elemento debe utilizar los nombres internos de las categorías y propiedades, que puede obtener en la página Configuración, seleccionando la categoría o propiedad que desea y observando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta de la jerarquía de propiedades de configuración mediante el carácter | y coloque la ruta entre comillas dobles.

Tenga en cuenta lo siguiente.

Con este comando sólo se pueden suprimir las categorías y propiedades dentro de una aplicación, no las aplicaciones completas. Utilice el comando -u para anular el registro de una aplicación completa.

Para suprimir categorías que tienen el enlace Suprimir categoría en la página Configuración, utilice la opción -o.

-i -p "rutaElementoPadre" -f archivoImportación

Permite importar propiedades de configuración y sus valores desde un archivo XML especificado.

Para importar, debe especificar una ruta en el elemento padre bajo el cual desea importar las categorías. La utilidad configTool importa propiedades bajo la categoría se especifica en la ruta.

Puede añadir categorías en cualquier nivel por debajo del nivel superior, pero no puede añadir una categoría en el mismo nivel que la categoría superior.

La ruta del elemento padre debe utilizar los nombres internos de las categorías y propiedades, que puede obtener en la página Configuración, seleccionando la categoría o propiedad que desea y observando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta de la jerarquía de propiedades de configuración mediante el carácter | y coloque la ruta entre comillas dobles.

Puede especificar una ubicación de archivo de importación relativa al directorio tools/bin o puede especificar un ruta de directorio completa. Si especifica una ruta relativa o no especifica ninguna ruta, configTool primero busca el archivo relativo al directorio tools/bin.

De forma predeterminada, este comando no sobrescribe una categoría existente, pero puede utilizar la opción -o para forzar una sobrescritura.

-x -p "rutaElemento" -f archivoExportación

Permite exportar propiedades de configuración y sus valores a un archivo XML con un nombre especificado.

Puede exportar todas las propiedades de configuración o limitar la exportación a una categoría específica especificando una ruta en la jerarquía de propiedades de configuración.

Puede especificar una ubicación de archivo de exportación relativa al directorio actual o puede especificar una ruta de directorio completa. Si la especificación de archivo no contiene un separador (/ en Unix, / o \ en Windows™), configTool graba el archivo en el directorio tools/bin bajo la instalación de Marketing Platform. Si no proporciona la extensión xml, configTool la añade.

-r nombreProducto -f archivoRegistro

Permite registrar la aplicación. La ubicación del archivo de registro puede ser relativa al directorio tools/bin o puede ser una ruta completa. De forma predeterminada, este comando no sobrescribe una configuración existente, pero puede utilizar la opción -o par forzar una sobrescritura. El parámetro nombreProducto debe ser uno de los listados previamente.

Tenga en cuenta lo siguiente.

Cuando se utiliza la opción -r, el archivo de registro debe tener <application> como primera etiqueta en el XML.

Con el producto se pueden proporcionar otros archivos que se pueden utilizar para insertar propiedades de configuración en la base de datos de Marketing Platform. Para estos archivos, utilice la opción -i. Sólo puede utilizarse con la opción -r el archivo que tiene la etiqueta <application> como primera etiqueta.

El archivo de registro para Marketing Platform se denomina Manager_config.xml y la primera etiqueta es <Suite>. Para registrar este archivo en una nueva instalación, utilice la utilidad populateDb o vuelva a ejecutar el instalador de Marketing Platform como se describe en la publicación IBM® Marketing Platform - Guía de instalación.

Después de la instalación inicial, para anular el registros de productos que no sean Marketing Platform, utilice configTool con la opción -r y -o para sobrescribir las propiedades existentes.

-u nombreProducto

Permite anular el registro de una aplicación especificada por nombreProducto . No es necesario incluir una ruta en la categoría del producto; el nombre de producto es suficiente. El parámetro nombreProducto debe ser uno de los listados previamente. Elimina todas las propiedades y valores de configuración del producto.

Opciones

-o

Cuando se utiliza con -i o -r, sobrescribe una categoría o registro de producto (nodo) existente.

Cuando se utiliza con -d le permite suprimir una categoría (nodo) que no tiene el enlace Suprimir categoría en la página Configuración.

Ejemplos

Importar valores de configuración de un archivo denominado Product_config.xml situado en el directorio conf bajo la instalación de Marketing Platform.

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

Importar una de las plantillas de origen de datos de Campaign proporcionadas a la partición predeterminada de Campaign, partition1. En el ejemplo se supone que se ha situado la plantilla de origen de datos de Oracle, OracleTemplate.xml, en el directorio tools/bin bajo la instalación de Marketing Platform.

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

Exportar todos los valores de configuración a un archivo denominado myConfig.xml situado en el directorio D:\backups.

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

Exportar una partición existente de Campaign (completa con entradas de origen de datos), guardarla en un archivo denominado partitionTemplate.xml y almacenarla en el directorio predeterminado tools/bin bajo la instalación de Marketing Platform.

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

Registrar manualmente una aplicación denominada nombreProducto, utilizando un archivo denominado app_config.xml situado en el directorio predeterminado tools/bin bajo la instalación de Marketing Platform y forzar que sobrescriba un registro existente de esta aplicación.

configTool -r nombreProducto -f app_config.xml -o

Anular el registro de una aplicación denominada nombreProducto.

configTool -u nombreProducto