Directrices para utilizar macros personalizadas

Tenga en cuenta las directrices siguientes a la hora de crear o utilizar una macro personalizada:

El nombre de una macro personalizada debe ser alfanumérico. La cadena del nombre no puede contener espacios, pero pueden utilizarse caracteres de subrayado (_).

Si un origen de datos ha sido configurado con la propiedad ENABLE_SELECT_SORT_BY = TRUE, deberá escribir las macros personalizadas de SQL sin formato con una cláusula ORDER BY con el fin de poder ordenar los registros devueltos según los campos clave de audiencia del nivel de audiencia en el que esté trabajando. De lo contrario, si el orden no es el esperado, cuando se utilice la macro personalizada en un campo derivado de un proceso Extracción se generará un error.

En caso de no comparar un valor devuelto de una macro personalizada, si el valor es numérico, los valores distintos de cero se tratan como TRUE (y, por tanto, se seleccionan los ID asociados a éstos) y los valores iguales a cero se tratan como FALSE. Los valores de cadena siempre se tratan como FALSE.

Cuando se crea una macro personalizada que utiliza SQL sin formato, el uso de una tabla temporal puede incrementar notablemente la velocidad de rendimiento del SQL sin formato porque se delimita la cantidad de datos con los que debe trabajar.

Cuando una macro personalizada utiliza tablas temporales en su lógica subyacente, se forzará el uso de una tabla temporal en la base de datos para que la lógica no falle.

No obstante, si se utiliza una macro personalizada en una cláusula SELECT de nivel superior, no existe ningún historial que Campaign pueda utilizar para forzar el uso de una tabla temporal en la base de datos, y la lógica falla.

Por consiguiente, cuando cree una macro personalizada que utilice SQL sin formato, es posible que deba crear dos versiones de la misma macro personalizada: una que utilice identificadores y otra que no los utilice.

La macro personalizada sin identificadores de tabla temporal puede utilizarse en la parte superior de un árbol (por ejemplo, en la primera cláusula SELECT). La macro que tiene identificadores de tabla temporal puede utilizarse en cualquier otro lugar del árbol en el que exista una tabla temporal que pueda aprovecharse.

Es posible que se produzcan uniones automáticas cuando se combinen los valores devueltos por las macros personalizadas cuando se hace una consulta en datos no normalizados. Sin embargo, este comportamiento no es deseable.

Por ejemplo, si utiliza una macro personalizada basada en SQL sin formato que devuelve un valor (en un proceso Extracción, por ejemplo) y genera la salida de la macro personalizada y de otro campo a partir de la tabla en la que se basa la macro personalizada, Campaign realiza una unión automática en dicha tabla. Si la tabla no está normalizada, acabará obteniendo un producto cartesiano (es decir, el número de registros mostrado será superior al esperado).

De forma automática, las macros personalizadas sirven ahora de referencia, porque la definición de la macro personalizada no se copia en el proceso actual.

En el momento de la ejecución, para resolver una macro personalizada se busca su definición en la tabla del sistema UA_CustomMacros (que contiene las definiciones) y luego se utiliza o ejecuta la macro.

A diferencia de las consultas almacenadas, los nombres de las macros personalizadas deben ser únicos, independientemente de la ruta de acceso de la carpeta. En versiones anteriores a la 5.0, era posible tener, por ejemplo, una consulta almacenada denominada A en la carpeta F1 y en la carpeta F2.

Campaign admite consultas almacenadas de versiones anteriores. No obstante, en las referencias a consultas almacenadas que no son únicas debe utilizarse la sintaxis antigua:

storedquery(<query name>)

Cuando resuelve las variables de usuario de las macros personalizadas, Campaign utiliza el valor actual de la variable de usuario cuando comprueba la sintaxis. Si, según el valor actual, la variable está en blanco, Campaign genera un error.

Se proporciona un identificador de tabla temporal como característica avanzada de optimización del rendimiento que delimita la cantidad de datos que se toman de la base de datos al conjunto de ID de audiencia de la tabla temporal disponible para ser utilizada por el proceso actual. Esta lista de ID de la tabla temporal puede ser un superconjunto de los ID de la celda actual. Por consiguiente, las funciones de agregado que se realizan en la tabla temporal (por ejemplo, promedio o suma) no se admiten y pueden generar resultados incorrectos.

Si desea utilizar la macro personalizada en distintas bases de datos, utilice una expresión de IBM Unica en lugar de utilizar SQL sin formato, ya que es posible que éste sea específico de una base de datos determinada.

Si una macro personalizada contiene SQL sin formato y otra macro personalizada, la macro personalizada se resuelve, se ejecuta y se devuelve su valor antes de ejecutar el SQL sin formato.

Campaign trata una coma como un separador de parámetros. Si desea utilizar comas como caracteres literales en un parámetro, especifique el texto entre llaves ({}), como se muestra en el ejemplo siguiente:

TestCM( {STRING_CONCAT(UserVar.Test1, UserVar.Test2) } )

Las siguientes tablas describen cómo Campaign trata a las macros personalizadas en las consultas y los campos derivados.

Macros personalizadas en las consultas y los campos derivados (Procesos Selección, Segmentación y Audiencia)

Tipo de macro personalizada	Cómo se usa
SQL sin formato: ID	Se ejecuta como consulta independiente. La lista de ID se combina con otros resultados. Si una macro personalizada contiene otra marco personalizada y SQL sin formato, las macros personalizadas se resuelven y ejecutan, y luego se ejecuta el SQL sin formato.
SQL sin formato: ID + Valor	Espera que el valor devuelto se utilice en una expresión o como comparación. Si el valor no se utiliza de este modo, Campaign trata un valor distinto de cero como TRUE para la selección de ID y un valor igual a cero y una cadena como FALSE.
IBM Unica Expresión	Se resuelve la expresión y se verifica la sintaxis. Se admite una consulta por tabla y se lleva a cabo la coincidencia y combinación de ID.

En una consulta SQL sin formato (procesos Selección, Segmentación y Audiencia)

Tipo de macro personalizada	Cómo se usa
SQL sin formato: ID	Se resuelve la macro personalizada y luego se ejecuta la consulta.
SQL sin formato: ID + Valor	No se admite.
IBM Unica Expresión	Se resuelve la expresión, pero la sintaxis no se verifica. Si la expresión es incorrecta, el servidor de bases de datos la detecta durante su ejecución.