Directrices para la utilización de macros personalizadas

Tenga presentes las siguientes directrices cuando cree o utilice una macro personalizada:

El nombre de una macro personalizada debe ser alfanumérico. No se pueden utilizar espacios en la cadena del nombre, pero sí se pueden utilizar caracteres de subrayado (_).

Si un origen de datos se ha configurado con la propiedad ENABLE_SELECT_SORT_BY = TRUE, entonces deberá escribir macros personalizadas en SQL sin formato con una cláusula ORDER BY a fin de ordenar los registros devueltos por los campos de clave de audiencia por los que busca. De lo contrario, si el orden de clasificación no es el esperado, se generará un error cuando la macro personalizada se utilice en un campo derivado en un proceso Instantánea.

Si no compara un valor devuelto por una macro personalizada, si dicho valor es numérico, los valores distintos de cero se tratarán como TRUE (y por tanto se seleccionarán los ID asociados a ellos) y los valores igual a cero se tratarán como FALSE. Los valores de tipo cadena se tratan siempre como FALSE.

Cuando se crea una macro personalizada que utiliza SQL sin formato, el empleo de una tabla temporal puede incrementar el rendimiento del SQL sin formato considerablemente a limitar la cantidad de datos con los que necesita trabajar.

Cuando una macro personalizada utiliza tablas temporales en su lógica subyacente, se fuerza una tabla temporal a subir a la base de datos para que no falle la lógica.

Sin embargo, si una macro personalizada se utiliza en un SELECT de nivel superior, entonces no habrá historial que pueda utilizar Campaign para forzar la subida de una tabla temporal a la base de datos, con lo que fallará la lógica.

Por tanto, al crear una macro personalizada que utilice SQL sin formato, podría interesarle crear dos versiones de la misma macro: una que utilice tokens de la tabla temporal y otra que no los utilice.

La macro personalizada sin los tokens de la tabla temporal podrá utilizarse en el nivel superior del árbol (por ejemplo, en el primer SELECT). La que tiene tokens de tabla temporal podrá utilizarse en cualquier otra parte del árbol en la que pueda aprovecharse una tabla temporal.

Al combinar valores devueltos por macros personalizadas cuando se efectúan consultas de datos sin normalizar, podrían producirse uniones automáticas, lo que probablemente no será el comportamiento deseado.

Por ejemplo, si utiliza una macro personalizada basada en SQL sin formato que devuelve un valor y (en un proceso Instantánea, por ejemplo) se genera la salida de la macro personalizada y un campo adicional de la tabla en que se base la macro personalizada, Campaign realizará una unión automática sobre dicha tabla. Si la tabla no está normalizada, el resultado será un producto cartesiano (es decir, el número de registros mostrados será mayor de lo esperado).

Las macros personalizadas se invocan ahora por referencia, porque la definición de una macro personalizada no se copia al proceso actual.

En tiempo de ejecución, una macro personalizada se resuelve buscando su definición en la tabla del sistema UA_CustomMacros (donde se almacenan las definiciones) y luego se utiliza/ejecuta.

A diferencia de las consultas almacenadas, los nombres de las macros personalizadas deben ser exclusivos independientemente de la ruta de la carpeta. En releases anteriores a 5,0, se podía tener una consulta almacenada llamada A, por ejemplo, en las carpetas F1 y F2.

Campaign soporta consultas de releases anteriores. Sin embargo, las referencias a consultas almacenadas no exclusivas deben utilizar la sintaxis antigua.

storedquery(<nombre consulta>)

Cuando se resuelven las variables de usuario en las macros personalizadas, Campaign utiliza el valor actual de la variable de usuario al comprobar la sintaxis. Si el valor actual se ha dejado en blanco, Campaign generará un error.

El token de tabla temporal se facilita como una característica avanzada de optimización del rendimiento que limita la cantidad de datos extraída de la base de datos por el conjunto de ID de audiencia en la tabla temporal a disposición del proceso actual. Esta lista de ID de la tabla temporal podría ser un superconjunto de los ID de la celda actual. Por tanto, las funciones de agregado realizadas sobre la tabla temporal (por ejemplo, promedio o suma) no están soportadas y podrían generar resultados incorrectos.

Si tiene la intención de utilizar una macro personalizada en varias bases de datos, podría interesarle utilizar una expresión IBM® en vez de SQL sin formato, ya que el SQL sin formato puede ser específico de una base de datos concreta.

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

Campaign trata las comas como separador de parámetro. Si está utilizando comas como caracteres litereales en un parámetro, encierre el texto en llaves ({}) como en el siguiente ejemplo:

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

Campaign soporta la sustitución simple de parámetros en macros personalizadas que utilicen SQL sin formato. Por ejemplo si configura un cuadro de proceso Selección en un diagrama de flujo que contenga esta consulta:

exec dbms_stats.gather_table_stats(tabname=> <temptable>,ownname=> 'autodcc')

Campaign sustituiría satisfactoriamente la tabla temporal real en el lugar del token <temptable>. Tenga en cuenta que las comillas simples alrededor del nombre de tabla son obligatorias.

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

Macros personalizadas en consultas y campos derivados (procesos Selección, Segmentación y Audiencia)

Tipo de macro personalizada	Cómo se utiliza
SQL sin formato: ID	Ejecuta como una consulta aparte. La lista de ID se fusiona con otros resultados. Si una nmacro personalizada contiene otras macros personalizadas más SQL sin formato, las macros personalizadas se resolverán y ejecutarán y luego se ejecutará el SQL sin formato.
SQL sin formato: ID + valor	Asume que el valor devuelto se utilizará en una expresión o como comparación. Si el valor no se utiliza de esa forma, Campaign tratará un valor distinto de cero como TRUE en la selección de ID, y una cadena y un valor de cero como FALSE.
Expresión IBM®	Se resuelve la expresión y se realiza una comprobación de sintaxis. Se soporta una consulta por tabla, y los ID se emparejan/fusionan.

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

Tipo de macro personalizada	Cómo se utiliza
SQL sin formato: ID	La macro personalizada se resuelve y después se ejecuta la consulta.
SQL sin formato: ID + valor	No está soportado.
Expresión IBM®	Se resuelve la expresión, pero no se realiza una comprobación de sintaxis. Si la expresión es incorrecta, lo detectará el servidor de base de datos cuando se ejecute.