Adição de cabeçalhos de análise

O cabeçalho da análise consiste em uma série de tags analíticas incluídas em um comentário no início de um script. O cabeçalho inclui parâmetros de entrada preenchidos antecipadamente pelo usuário para que a análise possa executar sem intervenção manual imediatamente ou em um momento agendado.

Após desenvolver e testar os scripts no projeto do Analytics, é necessário adicionar um cabeçalho de análise antes de confirmar os scripts para o Robôs ou usar o projeto como um aplicativo de análise no Servidor AX ou na janela Aplicativo de análise.

Requisitos do cabeçalho de análise

Um cabeçalho de análise deve cumprir alguns requisitos. Caso contrário, o script de análise falhará na execução.

Para obter informações detalhadas sobre a sintaxe do cabeçalho de análise e uma lista completa de tags de análise, consulte Cabeçalhos e das tags da análise.

Inclua os cabeçalhos de análise em um bloco de comentários

Os cabeçalhos de análise devem ser definidos completamente em um bloco de comentários que começa na primeira linha do script.

COMMENT
As tags de análise ficam aqui.
END

Declare entradas e saídas

É necessário declarar, no cabeçalho de análise, as entradas exigidas pela análise e as saídas a serem copiadas para o Robôs ou o Servidor AX ou gravadas como resultados na janela Aplicativo de análise:

Entradas Saídas
  • tabelas
  • campos
  • parâmetros
  • arquivos de entrada
  • avisos de digitação de senha
  • arquivos de dados
  • tabelas de resultados
  • arquivos de log

Declarar valores de entrada

Os cabeçalhos de análise também devem declarar todos os valores de entrada especificados pelo usuário ao executar ou agendar a análise.

Utilize a tag PARAM para adicionar parâmetros de entrada que aceitam esses valores de entrada especificados pelo usuário e os armazenam em variáveis. Por exemplo, se você deseja que a análise selecione dados com base em um intervalo de datas, é preciso adicionar parâmetros de Data Inicial e Data Final que permitam aos usuários especificar essas datas.

Validação dos cabeçalhos de análise

Após adicionar um cabeçalho de análise a um ou mais scripts, use as ferramentas do Analytics para validar a sintaxe do cabeçalho para garantir que está correta. Execute a validação antes de confirmar scripts para o Robôs ou empacotar aplicativos de análise para evitar que falhem na execução.

Uma ferramenta valida cabeçalhos de análise individuais por script. A outra ferramenta valida todos os cabeçalhos de análise de um projeto de uma só vez. Os dois tipos de validação têm objetivos diferentes.

Validar um cabeçalho de análise individual

A validação de um cabeçalho de análise por script verifica a sintaxe de tags de análise individuais e relata erros com os números de linha associados.

  1. Abra o script que contém o cabeçalho da análise.
  2. Na barra de ferramentas do Editor de script, clique em Validar cabeçalho de análise .

    É exibida uma mensagem informando que o cabeçalho de análise é válido ou especificando um erro e o número da linha em que o erro ocorre.

  3. Se o cabeçalho de análise contiver um erro, corrija o erro e clique em Validar cabeçalho de análise novamente para garantir que não há mais erros.

    Dica

    Se o motivo do erro não estiver aparente com base apenas na mensagem de erro, consulte o tópico de ajuda da tag de análise associada. Compare cuidadosamente a sintaxe no tópico com a sintaxe na linha do cabeçalho de análise. Os erros podem ser causados por discrepâncias pequenas na sintaxe do cabeçalho da análise.

Validar todos os cabeçalho de análise de um projeto

A validação de cabeçalhos de análise por projeto faz duas verificações:

  • se existe pelo menos um cabeçalho de análise no projeto
  • se os nomes das diversas análises são únicos

    Nota

    Faz referência ao nome especificado na tag ANALYTIC tag e não ao nome do script na guia Visão geral no Navegador.

A validação por projeto é executada automaticamente quando você confirma scripts para o Robôs. Você também poderá executar manualmente a validação se adicionar o botão Verificar scripts na barra de ferramentas do Analytics.

  1. Se necessário, adicione o botão Verificar scripts à barra de ferramentas do Analytics:
    1. Clique duas vezes em uma parte vazia da barra de ferramentas para abrir a caixa de diálogo Personalizar barra de ferramentas.
    2. Na lista Botões disponíveis da barra de ferramentas, selecione o botão Verificar scripts e clique em Adicionar.
    3. Na lista Botões atuais da barra de ferramentas, selecione o botão Verificar scripts e clique em Mover para cima ou Mover para baixo para alterar a localização do botão.

      A ordem dos botões de cima para baixo corresponde à sua localização da esquerda para a direita na barra de ferramentas.

    4. Clique em Fechar para salvar suas alterações.

  2. Na barra de ferramentas, clique em Verificar scripts .

    Uma mensagem é exibida informando que os cabeçalho de análise do projeto são válidos ou especificando um ou mais erros.

  3. Se o cabeçalho de análise contiver um erro, corrija o erro e clique em Verificar scripts novamente para garantir que não há mais erros.

Exemplo de cabeçalho da análise

COMMENT
//ANALYTIC Identificação de cheques perdidos
  Esta análise identifica números de cheques perdidos
//TABLE v_tabela_pagamentos Tabela de Pagamentos
  Selecione uma tabela que exibe os pagamentos e contém uma coluna de número do cheque
//FIELD v_num_cheque CN Número do Cheque
  Selecione o campo que contém os números de cheques
//PARAM v_data_inicial D OPTIONAL Data Inicial (opcional)
  Insira a data inicial da análise
//PARAM v_data_final D OPTIONAL Data Final (opcional)
  Insira a data final da análise
//PARAM v_região C MULTI SEPARATOR , QUALIFIER ' Região(ões)
  Insira uma ou mais regiões para incluir na análise
//RESULT LOG
//RESULT TABLE ChequesPerdidos
//RESULT FILE DetalhesChequesPerdidos.xls
END

[ Voltar ao início ]

Guia de scripting do ACL 14.1