Programa de utilidad configTool

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

Cuándo se usa configTool

Puede usar configTool para los siguientes fines:

Para importar la partición y las plantillas de fuentes de datos que se proporcionan con Campaign, las cuales puede modificar posteriormente y/o duplicar con la página Configuración.

Para registrar (importe las propiedades de la configuración para) los productos de IBM® Unica Marketing, 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 las configuraciones para la copia de respaldo o para importar hacia una instalación diferente de IBM® Unica Marketing.

Para suprimir las categorías que no tienen el enlace Suprimir categoría. Esto lo logra usando configTool para exportar su configuración, luego eliminando manualmente el XML que crea la categoría, e importando el XML editado por medio de configTool.

Este programa de utilidad modifica las tablas usm_configuration y usm_configuration_values en la base de datos de tablas del sistema de la Marketing Platform, donde se encuentran las propiedades de configuración y sus valores. Para obtener unos resultados óptimos, se le recomienda que o bien cree una copia de seguridad de estas tablas, o exporte sus configuraciones existentes usando configTool y realice una copia de seguridad del archivo resultante de manera tal que pueda restablecer su configuración si cometiera un error cuando utiliza configTool para importar.

Nombres de producto válidos

El programa de utilidad configTool utiliza los nombres de productos como parámetros con los mandatos que registran y anulan el registro de productos, según se describe más adelante en esta sección. En el release 8.0.0 de IBM® Unica Marketing, muchos nombres de productos han cambiado. Sin embargo, los nombres que configTool reconoce no han cambiado. Los nombres válidos de productos para usar con configTool se enumeran a continuación, junto con los nombres actuales de los productos.

Nombre de producto	Nombre usado en configTool
Marketing Platform	Manager
Campaign	Campaign
Distributed Marketing	Collaborate
eMessage	emessage
Interact	interact
Optimize	Optimize
Marketing Operations	Plan
CustomerInsight	Insight
NetInsight	NetInsight
PredictiveInsight	Model
Leads	Leads

Sintaxis

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

configTool -i -p "rutaElementoPrincipal" -f archivoParaImportar [-o]

configTool -x -p "rutaElemento" -f archivoParaExportar

configTool -r nombreProducto -f archivoRegistro [-o]

configTool -u nombreProducto

Comandos

-d -p "rutaElemento"

Suprima las propiedades de la configuración y sus configuraciones, especificando una ruta en la jerarquía de la propiedad de la configuración.

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

Tenga en cuenta lo siguiente:

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

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

-i -p "rutaElementoPrincipal" -f archivoParaImportar

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

Para poder importar, usted especifica una ruta al elemento principal bajo el que usted desea importar sus categorías. El programa de utilidad configTool importa las propiedades bajo la categoría que usted especifica en la vía de acceso.

Se pueden añadir categorías en cualquier nivel inferior al nivel más alto, pero no en el mismo nivel que la categoría superior.

La ruta del elemento principal debe usar los nombres internos de las categorías y las propiedades, que se pueden obtener desde la página Configuración seleccionando la categoría o propiedad deseada y observando la ruta que aparece entre paréntesis en el panel derecho. Delimite una ruta en la jerarquía de la propiedad de la configuración con el carácter | y encierre la ruta con comillas dobles.

Puede especificar la ubicación de un archivo de importación relacionado con el directorio tools/bin o puede especificar una vía de acceso de directorio completa. Si usted especifica una vía de acceso relativa o no especifica ninguna vía de acceso, configTool primero busca el archivo relativo al directorio tools/bin.

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

-x -p "rutaElemento" -f archivoParaExportar

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

Se pueden exportar todas las propiedades de configuración o limitar la exportación a una categoría específica a través de una vía de acceso en la jerarquía de propiedades de configuración que usted especifica.

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

Se puede especificar una ubicación del archivo de exportación relativa al directorio actual o una vía de acceso 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 bajo la instalación de Marketing Platform. Si usted no incluye la extensión xml, configTool la añade.

-r nombreProducto -f archivoRegistro

Registre la aplicación. La ubicación del archivo de registro puede ser relativa al directorio tools/bin o una vía de acceso completa. De forma predeterminada, este mandato no sobrescribe una configuración existente, pero se puede utilizar la opción -o para forzar esta acción. El parámetro nombreProducto debe estar incluido en la enumeración anterior.

Tenga en cuenta lo siguiente:

Cuando utilice 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 puede 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 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 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 tal como se describe en la publicación IBM® Unica® Marketing Platform - Guía de instalación.

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

-u mombreProducto

Permite anular el registro de una aplicación especificada por nombreProducto. No es necesario incluir una vía de acceso a la categoría del producto; el nombre del producto es suficiente. El parámetro nombreProducto debe estar incluido en la enumeración anterior. Esto elimina todas las propiedades y ajustes de configuración del producto.

Opciones

-o

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

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

Ejemplos

Importe los ajustes de configuración de un archivo con el nombre Product_config.xml ubicado en el directorio conf en la instalación de la Marketing Platform.

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

Importe una de las plantillas fuente de datos de Campaign que se proporciona en la partición Campaign predeterminada, partición1. En el ejemplo se supone que se ha colocado 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

Exporte todos los ajustes de configuración a un archivo con el nombre miConfig.xml ubicado en el directorio D:\backups.

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

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

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

Registre manualmente una aplicación con el nombre nombreProducto en un archivo con el nombre app_config.xml ubicado en el directorio predeterminado tools/bin en la instalación de la Marketing Platform para que sobrescriba un registro existente de esta aplicación.

configTool -r nombreProducto -f app_config.xml -o

Anule el registro de una aplicación llamada nombreProducto.

configTool -u nombreProducto