Diretrizes para Usar Macros Customizadas

Mantenha as seguintes diretrizes em mente ao criar ou usar uma macro customizada:

O nome de uma macro customizada deve ser alfanumérica. Não é possível usar espaços na sequência de nomes, mas pode usar sublinhado (_).

Se uma origem de dados tiver sido configurada com a propriedade ENABLE_SELECT_SORT_BY = TRUE, será necessário gravar macros customizadas de SQL bruta com uma cláusula ORDER BY para classificar os registros retornados pelos campos-chave de público do nível de público no qual você está trabalhando. Caso contrário, se a ordem de classificação não estiver conforme o esperado, um erro será gerado quando a macro customizada for usada em um campo derivado em um processo Captura Instantânea.

Se você não comparar um valor retornado de uma macro customizada, se o valor for numérico, valores que não sejam zero serão tratados como TRUE (e, portanto, IDs associados a eles serão selecionados) e valores zero serão tratados como FALSE. Valores de sequência são sempre tratados como FALSE.

Ao criar uma macro customizada que use SQL bruta, usar uma tabela temporária pode aumentar muito a velocidade do desempenho da SQL bruta efetuando o escopo da quantidade de dados com a qual você precisa trabalhar.

Quando uma macro customizada usa tabelas temporárias em sua lógica subjacente, uma tabela temporária será forçada para o banco de dados, para que a lógica não falhe.

No entanto, se uma macro customizada for usada em um SELECT de nível superior, não haverá histórico para o Campaign usar para forçar uma tabela temporária para o banco de dados e a lógica falhará.

Assim, ao criar uma macro customizada que usa SQL bruta, pode ser necessário criar duas versões da mesma macro customizada - uma que usa tokens da tabela temporária e outra que não usa.

A macro customizada sem tokens da tabela temporária pode ser usada na parte superior de uma árvore (por exemplo, no primeiro SELECT). Aquela com tokens da tabela temporária pode ser usada em qualquer local na árvore na qual pode haver uma tabela temporária para beneficiar-se.

Junções automáticas podem ocorrer ao combinar valores retornados de macros customizadas ao efetuar consultas em dados não normalizados, o que provavelmente não é o comportamento desejado.

Por exemplo, se você usar uma macro customizada com base na SQL bruta que retorna um valor e (em um processo Captura Instantânea, por exemplo) efetuar a saída da macro customizada e outro campo da tabela na qual a macro customizada está baseada, o Campaign executará uma junção automática nessa tabela. Se a tabela não estiver normalizada, você acabará com um produto Cartesiano (ou seja, o número de registros exibidos será maior que o esperado).

Macros customizadas agora serão automaticamente para referência, pois a definição da macro customizada não será copiada para o processo atual.

No tempo de execução, uma macro customizada será resolvida consultando sua definição na tabela do sistema UA_CustomMacros (na qual definições são armazenadas) e depois usada/executada.

Diferente das consultas armazenadas, os nomes das macros customizadas devem ser exclusivos, independentemente do caminho da pasta. Em liberações anteriores à versão 5.0, você poderia ter uma consulta armazenada denominada A, por exemplo, nas pastas F1 e F2.

O Campaign suporta consultas armazenadas de liberações anteriores. No entanto, referências para consultas armazenadas não exclusivas usam a sintaxe antiga:

storedquery(<query name>)

Ao resolver variáveis do usuário em macros customizadas, o Campaign usa o valor atual da variável de usuário ao verificar a sintaxe. Se o valor atual estiver em branco, o Campaign gerará um erro.

O token da tabela temporária é fornecido como um recurso avançado de otimização de desempenho que efetua o escopo da quantidade de dados recebida do banco de dados pelo conjunto de IDs de público na tabela temporária disponível para uso pelo processo atual. Essa lista de IDs da tabela temporária pode ser um super conjunto de IDs na célula atual. Portanto, funções agregadas executadas na tabela temporária (por exemplo, média ou soma) não são suportadas e podem gerar resultados incorretos.

Se você pretende usar a macro customizada em diversos bancos de dados diferentes, pode desejar usar uma expressão do IBM® em vez da SQL bruta, pois a SQL bruta pode ser específica para um determinado banco de dados.

Se uma macro customizada contiver SQL bruta em vez de outra macro customizada, a macro customizada será resolvida, executada e seu valor retornado antes que a SQL bruta seja executada.

O Campaign trata uma vírgula como um separador de parâmetros. Se você estiver usando vírgulas como caracteres literais em um parâmetro, coloque o texto entre colchetes de abertura e fechamento ({}), como no seguinte exemplo:

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

O Campaign suporta substituição simples para parâmetros em macros customizadas usando código de SQL bruta. Por exemplo, se você configurar uma caixa Selecionar Processo em um fluxograma que contém esta consulta:

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

Campaign substituirá com êxito a tabela temporária real no lugar do token <temptable>. Observe que as aspas simples no nome da tabela são obrigatórias.

As seguintes tabelas mostram como o Campaign trata as macros customizadas nas consultas e campos derivados.

Macros customizadas nas consultas e campos derivados (Selecionar, Segmento e Processos de Público)

Tipo de macro customizada	Como será usado
SQL Bruta: IDs	Executada como uma consulta separada. A lista de IDs é mesclada com outros resultados. Se uma macro customizada contiver outras macros customizadas além da SQL bruta, as macros customizadas serão resolvidas e executada e a SQL bruta será executada.
SQL: IDs + Valor	Espera que o valor retornado seja usado em uma expressão ou como uma comparação. Se o valor não for usado dessa forma, o Campaign tratará um valor que não seja zero como TRUE para a seleção de ID e um valor zero e a sequência como FALSE.
Expressão do IBM®	A expressão é resolvida e uma verificação de sintaxe é executada. Uma consulta por tabela é suportada e os IDs são correspondidos/mesclados.

Em uma consulta SQL bruta (Selecionar, Segmento e Processos de Público)

Tipo de macro customizada	Como será usado
SQL Bruta: IDs	A macro customizada é resolvida e depois a consulta é executada.
SQL: IDs + Valor	Não suportada.
Expressão do IBM®	A expressão é resolvida, mas nenhuma verificação de sintaxe é executada. Se a expressão estiver incorreta, ela será detectada pelo servidor de banco de dados quando executada.