Scripts de análise

A execução de scripts não está limitada apenas ao Analytics. Se um script comum for convertido em um script de análise, você poderá agendar e executar scripts no aplicativo Robôs da plataforma HighBond ou no Analytics Exchange. Você também pode executar scripts de análise na janela Aplicativo de análise, um componente autônomo do Analytics.

O que são scripts de análise?

Um script de análise, ou uma "análise", é um script comum com um cabeçalho de análise. O cabeçalho da análise é uma série de tags de declaração que permitem que o script seja executado no Robôs, no Servidor AX ou na janela do Aplicativo de Análise. O cabeçalho de análise inclui parâmetros de entrada que um usuário preenche antecipadamente, o que permite que o script de análise seja executado sem supervisão, seja imediatamente ou em um horário programado.

Dica

Os scripts de análise são quase que exclusivamente desenvolvidos e testados no Analytics, que facilita o desenvolvimento. Use o Cliente AX para fazer atualizações simples em scripts de análise existentes armazenados no Servidor AX.

O que são aplicativos de análise?

Um aplicativo de análise é um projeto do Analytics empacotado para uso no Analytics Exchange ou na janela Aplicativo de análise. Os aplicativos de análise contêm um ou mais scripts de análise e também podem conter tabelas de dados e interpretações.

Nota

Os aplicativos de análise são geralmente criados ou desenvolvidos pelos especialistas em scripts da empresa ou junto aos consultores da Galvanize.

Como transformar scripts comuns em scripts de análise

Os scripts de análise começam como scripts comuns. Para executar um script comum no Robôs, no Servidor AX ou na janela Aplicativo de análise, é necessário converter o script comum em um script de análise:

Crie e teste um script no Analytics.
Adicione as tags adequadas de cabeçalho de análise para transformar o script em um script de análise.
Empacote o script de análise para execução no Servidor AX ou na janela Aplicativo de análise. Não é preciso empacotar scripts de análise para execução no Robôs.

Para obter mais informações, consulte Desenvolvendo scripts de análise.

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

Os cabeçalhos de análise devem ser definidos em um bloco de comentários que começa na primeira linha do script. No mínimo o cabeçalho da análise declara que o script é um script de análise:

COMMENT
//ANALYTIC Identificação de cheques faltantes
Este script de análise identifica números de cheques perdidos
END

Para obter mais informações, consulte Trabalhando com cabeçalhos de análise.

O que são os scripts auxiliares?

Um script auxiliar é um script comum sem um cabeçalho de análise, criado para trabalhar em conjunto com um script de análise. Em um projeto típico, um script de análise usa o comando DO SCRIPT para chamar um ou mais scripts auxiliares. Após a conclusão de um script auxiliar, o processamento retorna ao script de análise, que continua a executar.

Os scripts auxiliares também podem ser mencionados como subscripts, scripts secundários, scripts utilitários ou scripts adicionais. Você não precisa usar scripts auxiliares. Eles oferecem uma opção para compartimentalizar blocos de lógica de script que podem ser condicionais, reutilizáveis ou simplesmente de inclusão impraticável no script de análise principal.

Restrições dos scripts auxiliares

Os scripts auxiliares podem ser usados de diversas formas. No entanto, como não têm cabeçalho de análise, estão sujeitos a duas restrições:

Sem tags de entrada ou saída você não pode especificar tags de análise de entrada ou saída, o que significa que não é possível criar parâmetros de entrada ou saída no próprio script auxiliar. Todos os parâmetros necessários devem ser criados no cabeçalho da análise no script de análise principal.
Não pode ser executado diretamente os usuários não podem agendar ou executar diretamente os scripts auxiliares. Eles somente podem ser chamados de um script de análise de forma direta ou indireta, por meio de outro script auxiliar.

Distribuição e execução de scripts de análise

Há várias opções para distribuir e executar scripts de análise, dependendo dos produtos e componentes da Galvanize usados pela organização.

Aplicativo/produto/componente	Método para distribuir e executar um script de análise
Robôs	confirme um ou mais scripts de análise e todos os scripts auxiliares como uma versão de script no modo de desenvolvimento no Robôs, e agende e execute uma versão ativada do script no modo de produção
Servidor AX	Um destes métodos: importe o projeto do Analytics (arquivo .acl) diretamente no Servidor AX, e agende e execute um script de análise usando o Cliente AX empacote o projeto em um arquivo de aplicativo de análise compactado (arquivo .aclapp), importe-o para o Servidor AX e execute um script de análise usando o Cliente Web AX Para obter mais informações, consulte Empacotamento de aplicativos de análise.
Janela Aplicativo de análise	empacote o projeto em um arquivo de análise compactado (arquivo .aclapp), abra o projeto como um aplicativo de análise (arquivo .aclx ) e execute o script de análise na janela Aplicativo de análise Para obter mais informações, consulte Empacotamento de aplicativos de análise.

Aplicativo/produto/componente

Método para distribuir e executar um script de análise

Robôs

confirme um ou mais scripts de análise e todos os scripts auxiliares como uma versão de script no modo de desenvolvimento no Robôs, e agende e execute uma versão ativada do script no modo de produção

Servidor AX

Um destes métodos:

importe o projeto do Analytics (arquivo .acl) diretamente no Servidor AX, e agende e execute um script de análise usando o Cliente AX
empacote o projeto em um arquivo de aplicativo de análise compactado (arquivo .aclapp), importe-o para o Servidor AX e execute um script de análise usando o Cliente Web AX
Para obter mais informações, consulte Empacotamento de aplicativos de análise.

Janela Aplicativo de análise

empacote o projeto em um arquivo de análise compactado (arquivo .aclapp), abra o projeto como um aplicativo de análise (arquivo .aclx ) e execute o script de análise na janela Aplicativo de análise
Para obter mais informações, consulte Empacotamento de aplicativos de análise.

Como determinar o ambiente em que o script de análise será executado

Se você quiser criar um script de análise que possa ser executado no Analytics, no Analytics Exchange ou na janela Aplicativo de análise, é possível determinar o ambiente de tempo de execução durante a execução do script. Você pode usar essas informações para tomar decisões sobre quais comandos executar de acordo com o ambiente em que o script está sendo executado.

Use a função FTYPE( )para determinar onde o script está sendo executado:

FTYPE("ax_main") = "b"

Se o script estiver sendo executado no Analytics Exchange ou na janela Aplicativo de análise, a expressão será avaliada como verdadeira (T). Para script sendo executados no Analytics, a expressão será avaliada como falsa (F). Para obter mais informações, consulte Função FTYPE( ).

Identificação do usuário que executa o script no Servidor AX

Para scripts de análise executados no Servidor AX, você pode usar a variável de sistema AXRunByUser para identificar o nome do usuário que está executando o script no momento, no formato domínio\nome do usuário:

EXTRACT FIELDS TIME() AS "Hora", DATE() AS "Data", AXRunByUser AS "Usuário atual" TO R_RegistroExecução APPEND