La utilidad configTool

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

Cuándo utilizar configTool

Es posible que desee utilizar configTool por los siguientes motivos.

Para importar la partición y las plantillas de origen de datos proporcionados con Campaign, que puede después modificar y duplicar utilizando la página Configuración.

Para registrar (importar para las propiedades de configuración) productos 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 valores de configuración para hacer una copia de seguridad o para importar a una instalación diferente de IBM® EMM.

Para suprimir las categorías que no tienen el enlace Suprimir categoría. Puede conseguirlo utilizando configTool para exportar la configuración y, a continuación, suprimiendo manualmente el XML que crea la categoría y utilizando configTool para importar el XML editado.

Esta utilidad modifica las tablas usm_configuration y usm_configuration_values en la base de datos de la tabla del sistema Marketing Platform, que contiene las propiedades de configuración y sus valores. Para obtener los mejores resultados, cree copias de seguridad de estas tablas o bien exporte las configuraciones existente utilizando configTool y haga una copia de seguridad del archivo resultante de forma que tenga una manera para restaurar la configuración si comete un error al utilizar configTool para importar.

Nombre de producto válidos

La utilidad configTool utiliza los nombres de producto como parámetros con los comandos que registran y eliminan el registro de los productos, tal como se describe posteriormente en este apartado. Con el release 8.0.0 de IBM® EMM, muchos nombres de producto han cambiado. Sin embargo, los nombres que reconoce configTool no han cambiado. Los nombres de producto válidos para ser utilizados con configTool se listan a continuación, 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
Optimización de contactos	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
Digital Analytics para las instalaciones	NetInsight
PredictiveInsight	Model
Clientes potenciales	Leads

Sintaxis

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

configTool -i -p "ruta_elemento padre" -f archivo_importación [-o]

configTool -x -p "ruta_elemento" -f archivo_exportación

configTool -r nombre_producto -f archivo_registro [-o]

configTool -u nombre_producto

Comandos

-d -p "ruta_elemento"

Suprima 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 Configuración, seleccionando la categoría o propiedad que desee y consultando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la carácter utilizando el carácter | y escriba la ruta entre comillas dobles.

Tenga en cuenta lo siguiente.

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

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

-i -p "ruta_elemento_padre" -f archivo_importación

Importe las propiedades de configuración y sus valores de un archivo XML especificado.

Para importar, especifique una ruta al elemento padre debajo del cual desea importar las categorías. La utilidad configTool importa las propiedades debajo de la categoría que especifica en la ruta.

Puede añadir categorías en cualquier nivel inferior al 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 categorías y propiedades, que puede obtener yendo a la página Configuración, seleccionando la categoría o propiedad deseada y consultando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la carácter utilizando el carácter | y escriba la ruta entre comillas dobles.

Puede especificar una ubicación de archivo de importación relativa al directorio tools/bin o puede especificar una ruta de directorio completa. Si especifica una ruta relativa o no especifica ninguna, configTool en primer lugar, 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 esta acción.

-x -p "ruta_elemento" -f archivo_exportación

Exporte las 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 escribe el archivo en el directorio tools/bin debajo de la instalación de Marketing Platform. Si no proporciona la extensión xml, configTool la añade.

-r nombre_producto -f archivo_registro

Registre 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 para forzar dicha acción. El parámetro nombre_producto debe adoptar uno de los valores listados arriba.

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.

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

El archivo de registro para Marketing Platform se llama 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 Marketing Platform tal como se describe en la publicación IBM® Marketing Platform Guía de instalación.

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

-u nombre_producto

Elimine el registro de una aplicación especificada por nombre_producto . No es necesario que incluya una ruta en la categoría del producto; con el nombre del producto es suficiente. El parámetro nombre_producto debe adoptar uno de los valores listados arriba. Así se eliminan todas las propiedades y valores de configuración para el producto.

Opciones

-o

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

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

Ejemplos

Importe los valores de configuración de un archivo llamado Product_config.xml situado en el directorio conf debajo de la instalación de Marketing Platform.

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

Importe una de las plantillas de origen de datos de Campaign proporcionado a la partición Campaign predeterminada, partition1. El ejemplo da por supuesto que ha colocado la plantilla de origen de datos Oracle, OracleTemplate.xml, en el directorio tools/bin debajo de la instalación de Marketing Platform.

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

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

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

Exporte una partición Campaign existente (completa con las entradas de origen de datos), guárdela en un archivo llamado partitionTemplate.xml y almacénela en el directorio tools/bin predeterminado debajo de la instalación de Marketing Platform.

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

Registre de forma manual una aplicación llamada productName, utilizando un archivo llamado app_config.xml situado en el directorio tools/bin predeterminado debajo de la instalación de Marketing Platform y fuerce que sobrescriba un registro existente de esta aplicación.

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

Elimine el registro de una aplicación llamada productName.

configTool -u productName