El programa de utilidad configTool

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

Cuándo se debe utilizar configTool

Es posible que desee utilizar configTool para lo siguiente:

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

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

Para exportar una versión XML de los valores de configuración para la copia de seguridad o para importarla en otra instalación de IBM® EMM.

Para suprimir categorías que no tengan el enlace Suprimir categoría. Puede hacer esto utilizando configTool para exportar su configuración, y después suprimiendo manualmente el XML que crea la categoría e utilizando configTool para importar el XML editado.

Este programa de utilidad modifica las tablas usm_configuration y usm_configuration_values de la base de datos de tablas del sistema de Marketing Platform, que contienen las propiedades de configuración y sus valores. Para obtener unos mejores resultados, cree una copia de seguridad de estas tablas, o exporte sus configuraciones existentes utilizando configTool y realice una copia de seguridad del archivo resultante de forma que pueda restaurar su configuración si comete un error al importar con configTool.

Nombres de producto válidos

El programa de utilidad configTool utiliza los nombres de producto como parámetros en los comandos para registrar y anular el registro de los productos, como se describe más adelante en esta sección. Con el release 8.0.0 de IBM® EMM, muchos nombres de producto han cambiado. No obstante, los nombres que reconoce configTool no han cambiado. A continuación se listan los nombres de producto válidos para utilizar con configTool, junto con los nombres actuales de los productos.

Nombre de 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"

Suprimir las 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 las propiedades, que puede obtener yendo a la página de configuración, seleccionando la categoría o propiedad deseada y mirando la ruta que se muestra entre paréntesis en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de configuración utilizando el carácter | y coloque la ruta entre comillas dobles.

Tenga en cuenta lo siguiente:

Con este comando únicamente se pueden suprimir las categorías y propiedades de dentro de una aplicación, no aplicaciones completas. Para anular el registro de una aplicación completa, utilice el comando -u.

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

-i -p "rutaElementoPadre" -f importFile

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

Para importar, debe especificar una ruta hasta el elemento padre bajo la que desea importar las categorías. El programa de utilidad configTool importa las propiedades bajo la categoría que haya especificado en la ruta.

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

La ruta del elemento padre debe utilizar los nombres internos de las categorías y las propiedades, que puede obtener yendo a la página de configuración, seleccionando la categoría o propiedad deseada y mirando la ruta que se muestra entre paréntesis en el panel de la derecha. Delimite una ruta en la jerarquía de propiedades de configuración utilizando el carácter | y coloque la ruta entre comillas dobles.

Se puede especificar una ubicación para el archivo de importación relativa al directorio tools/bin o especificar una 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 se puede utilizar la opción -o para forzar esta acción.

-x -p "rutaElemento" -f archivoParaExportar

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.

Se puede especificar una ubicación para el archivo de exportación relativa al directorio actual o 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 indica la extensión xml, configTool la añade.

-r nombreProducto -f archivoRegistro

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 se puede utilizar la opción -o para forzar esta acción. El parámetro nombreProducto debe ser uno de los que se listan arriba.

Tenga en cuenta lo siguiente:

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

Es posible que se suministren otros archivos con el producto que pueda 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 se puede utilizar con la opción -r el archivo que tenga el código <application> en primer lugar.

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

Después de la instalación inicial, para volver a registrar productos distintos a Marketing Platform, utilice configTool con la opción -r y -o para sobrescribir las propiedades existentes.

-u nombreProducto

Anular registro de una aplicación especificada con nombreProducto . No es necesario incluir una ruta para la categoría de producto; es suficiente con el nombre de producto. El parámetro nombreProducto debe ser uno de los que se listan arriba. Esto elimina todas las propiedades y los valores de configuración del producto.

Opciones

-o

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

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

Ejemplos

Importar valores de configuración de un archivo denominado Product_config.xml que se encuentra 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 suministradas en la partición de Campaign predeterminada, partition1. En el ejemplo se da por supuesto que la plantilla de origen de datos de Oracle, OracleTemplate.xml, se encuentra 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, en el directorio D:\backups.

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

Exportar una partición de Campaign existente (completa con entradas de origen de datos), guardarla en un archivo denominado partitionTemplate.xml, y almacenarlo 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 ubicado 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