Guia de scripting do ACL versão 14.1

Resumo geral: como usar funções em um script

No tutorial final de funções do Analytics, resumiremos tudo usando variáveis com diversas funções em um script que executa uma tarefa do mundo real.

Nota

Não é necessário conhecer scripting para fazer este tutorial. Basta copiar e colar o script predefinido na parte inferior do tutorial no Analytics.

O que o script faz

O script de exemplo permite que qualquer pessoa o execute para aplicar um filtro de datas em qualquer tabela do Analytics com um campo de data, e agrupe por mês os registros incluídos pelo filtro.

O script combina operações já explicadas em tutoriais de funções anteriores.

Como as funções se relacionam a um script

Um autor de scripts do Analytics pode usar diversas funções em um único script para executar diversas tarefas auxiliares pequenas, mas importantes, que contribuem com a análise de dados geral executada pelo script.

A inclusão de uma função em um script não altera a forma como ela funciona. As funções em scripts têm exatamente o mesmo comportamento apresentado quanto testadas separadamente na linha de comando do Analytics.

  • Examine o script

    Examine o script de exemplo na parte inferior do tutorial. Os scripts do Analytics são executados sequencialmente, linha por linha. Dessa forma, você pode prosseguir sequencialmente pelo script e ler cada COMMENT para ter uma ideia geral do que a lógica do script está fazendo.

    As linhas COMMENT não fazem parte da lógica do script e não são executadas.

  • Compreenda o que as funções estão fazendo

    Examine com cuidado as funções contidas no script. As funções estão destacadas em marrom. Consulte a tabela acima do script para obter mais detalhes sobre a tarefa simples executada em cada função.

    Se já terminou os tutoriais de função anteriores, você já conhecerá a maioria das funções no script e as tarefas que executam.

  • Execute o script

    Depois de se familiarizar com o script e com suas funções, copie e cole o script no Analytics e execute-o para ver como o script funciona interativamente.

  1. Abra um projeto do Analytics que contenha uma ou mais tabelas com campos de data.

    O projeto Sample Project.ACL tem diversas tabelas com campos de data.

  2. Crie um script novo vazio:
    1. No Navegador, clique com o botão direito em uma pasta ou na entrada do projeto de nível mais alto e selecione Novo > Script.
    2. Copie e cole todo o script a seguir no novo script no Editor de Script.
    3. Salve o projeto.
  3. Clique em Executar para executar o script.
  4. Siga as solicitações da caixa de diálogo para selecionar uma tabela e um campo de data, especifique as datas inicial e final e selecione um campo numérico de subtotal.

O script de exemplo executa duas tarefas importantes:

  • filtra os registros em uma tabela por data, usando as datas especificadas
  • agrupa por mês os registros incluídos no filtro

Não se preocupe se não entender toda a sintaxe do script. O que é importante agora é ver as diversas funções do Analytics funcionando em um script.

Um COMMENT antes de cada parte de sintaxe de script explica em termos simples o que a sintaxe está fazendo.

As funções usadas no script de exemplo

O propósito de cada função usada no script de exemplo é descrito abaixo.

No script, as funções estão destacadas em marrom.

Função no script Propósito
DATE( )

Converte as variáveis MIN1 e MAX1 do tipo de dados datahora no tipo caractere. O tipo de dados caractere é necessário para exibir o conteúdo das variáveis em uma cadeia de texto em uma caixa de diálogo.

MIN1 e MAX1 são variáveis de sistema criadas automaticamente pelo comando STATISTICS. Elas contêm as datas mais antigas e mais recentes no campo de data selecionado.
ALLTRIM( ) Limpa espaços extras antes e depois das datas mais antigas e mais recentes, quando exibidas na caixa de diálogo.
CTOD( )

Converte as variáveis v_data_inicial e v_data_final do tipo de dados caractere no tipo de dados datahora. O tipo de dados datahora é obrigatório para subtrair ou comparar datas.
CTOD( ) Converte as variáveis v_data_inicial e v_data_final do tipo de dados caractere no tipo de dados datahora para que fiquem consistentes com a variável v_campo_data. Todos os parâmetros de funções BETWEEN devem ter o mesmo tipo de dados.
BETWEEN( ) Filtra o campo de data com base nas datas inicial e final especificadas.
MONTH( ) Extrai a parte do mês de todas as datas no campo de data como um número.
CMOY( ) Extrai a parte do mês de todas as datas no campo de data como um valor caractere.

Exemplo de script: filtra registros por data e agrupa os registros filtrados por mês

COMMENT
Este script permite aplicar um filtro de datas em qualquer tabela do Analytics com um campo de data, e agrupar por mês os registros incluídos pelo filtro.
END

COMMENT Solicita a seleção de uma tabela no projeto do Analytics.
ACCEPT "Selecione uma tabela com um campo de data:" FIELDS "xf" TO v_nome_tabela

COMMENT Abre a tabela selecionada.
OPEN %v_nome_tabela%

COMMENT Solicita a seleção de um campo de data da tabela.
ACCEPT "Selecione um campo de data:" FIELDS "D" TO v_campo_data

COMMENT Identifica as datas mais antiga e mais recente no campo de data selecionado.
STATISTICS ON %v_campo_data%

COMMENT Atribui as datas mais antiga e mais recente a variáveis. As variáveis são usadas para exibir o intervalo de datas existente na caixa de diálogo, onde você especifica as datas final e inicial para o filtro de datas. É mais fácil especificar datas de filtro se você souber qual é o intervalo de datas existente.
ASSIGN v_data_mínima = ALLTRIM(DATE(MIN1; "YYYYMMDD"))
ASSIGN v_data_máxima = ALLTRIM(DATE(MAX1; "YYYYMMDD"))

COMMENT Solicita que você especifique as datas inicial e final para o filtro de data.
DIALOG (DIALOG TITLE "Diálogo de usuário" WIDTH 484 HEIGHT 153 ) (BUTTONSET TITLE "&OK;&Cancel" AT 370 12 DEFAULT 1 ) (TEXT TITLE "Especifique uma data de início:" AT 12 16 ) (EDIT TO "v_data_inicial" AT 156 12 DEFAULT "AAAAMMDD" ) (TEXT TITLE "Especifique uma data final:" AT 12 52 ) (EDIT TO "v_data_final" AT 156 48 DEFAULT "AAAAMMDD" ) (TEXT TITLE "Intervalo de datas na tabela:" AT 12 88 ) (TEXT TITLE "%v_data_mínima%    a   %v_data_máxima%" AT 156 88 )

COMMENT Exibe um aviso se o filtro de data especificado pelo usuário abrange mais de 1 ano.
IF CTOD(v_data_final) - CTOD(v_data_inicial) > 365 OR CTOD(v_data_inicial) - CTOD(v_data_final) > 365 DIALOG (DIALOG TITLE "Diálogo de usuário" WIDTH 469 HEIGHT 100 ) (BUTTONSET TITLE "&OK;&Cancelar" AT 348 8 DEFAULT 1 ) (TEXT TITLE "Intervalo de datas excede um ano. Os agrupamentos mensais podem incluir registros de mais de um ano." AT 12 28 WIDTH 326 HEIGHT 33 ) (TEXT TITLE "Cuidado" AT 12 8 )

COMMENT Exibe um aviso se a data inicial especificada pelo usuário for posterior à data final.
IF CTOD(v_data_inicial) > CTOD(v_data_final) DIALOG (DIALOG TITLE "Diálogo de usuário" WIDTH 469 HEIGHT 100 ) (BUTTONSET TITLE "&OK;&Cancelar" AT 348 8 DEFAULT 1 ) (TEXT TITLE "Data inicial posterior à data final. Os registros entre as duas datas estão incluídos." AT 12 28 WIDTH 326 HEIGHT 33 ) (TEXT TITLE "Cuidado" AT 12 8 )

COMMENT Aplica o filtro de data à tabela e ao campo selecionados.
SET FILTER TO BETWEEN(%v_campo_data%; CTOD(%v_data_inicial%); CTOD(%v_data_final%))

COMMENT Solicita a seleção de um campo de subtotal.
ACCEPT "Selecione um campo numérico a ser totalizado por mês:" FIELDS "N" TO v_campo_subtotal

COMMENT Agrupa a tabela por mês e gera os resultados em uma nova tabela.
SUMMARIZE ON MONTH(%v_campo_data%) SUBTOTAL %v_campo_subtotal% OTHER CMOY(%v_campo_data%; 9) TO "%v_nome_tabela%_by_month.FIL" OPEN PRESORT

Se você concluiu todos os tutoriais em Como usar funções e Uso avançado de funções, parabéns! Agora você já tem uma boa compreensão sobre como as funções do Analytics funcionam em todo o Analytics.

Veja a seguir algumas sugestões para continuar a aumentar o seu conhecimento de funções:

  • Continue a explorar
    • Confira As 30 principais funções do Analytics para obter uma lista das funções do Analytics usadas com maior frequência e os exemplos correspondentes.
    • Navegue pelo conjunto completo do Analytics Funções. Conheça resumidamente tudo o que as distintas funções podem fazer.
  • Não se esqueça das funções

    Quando você encontrar um desafio de análise de dados ao trabalhar com o Analytics, pergunte-se: "Há alguma função que poderia me ajudar? Ou várias funções juntas?"

    Nas análises de dados usando comandos do Analytics, uma boa parte do desafio pode ser a preparação dos dados para análise. As funções, individualmente ou combinadas, são muitas vezes essenciais na preparação.

[ Voltar ao início ]