Fluxo de trabalho de desenvolvimento de script do ACL no Analytics e no Robôs

A criação do script de análise (script do ACL) é feita no aplicativo Analytics. Você cria scripts de análise no Analytics e, conforme necessário, atualiza-os no Analytics.

Quando está pronto para carregar os scripts de análise do Analytics para o aplicativo Robôs, você envia os scripts para um robô ACL específico. Para obter informações detalhadas, consulte Confirmando scripts (carregando) do ACL no Robôs.

Quando você confirma scripts, uma nova versão dos scripts é adicionada ao robô ACL e a versão fica acessível no modo de desenvolvimento. A nova versão tem o conteúdo exato dos scripts que você confirma. A versão é independente e não se mescla com nenhuma versão anterior dos scripts. Se você removeu um script no Analytics, ele não estará mais disponível na nova versão dos scripts no Robôs.

Quando considerar que o funcionamento de uma versão de script no modo de desenvolvimento está correto, ative-a para usar no modo de produção.

Um fluxo de trabalho interativo

Você pode editar um ou mais scripts e reconfirmá-los para o Robôs. Cada vez que você reenvia scripts, você cria uma nova versão deles. Você pode usar qualquer um destes métodos para editar e reconfirmar scripts:

Edite um ou mais scripts existentes em um projeto do Analytics associado a um robô e reconfirme os scripts.
Faça download dos scripts de um robô para o Analytics, edite um ou mais dos scripts e confirme os scripts.

Como funcionam as versões de scripts

As versões são numeradas em sequência
A cada vez que confirma um ou mais scripts para o mesmo robô, você cria uma versão nova e numerada sequencialmente dos scripts: versão 1, versão 2 e assim por diante.

Ao salvar versões sucessivas de scripts, o aplicativo Robôs garante que você não perca nenhum trabalho de criação de scripts e permite acessar facilmente versões mais antigas, se necessário.
As versões são autossuficientes
Cada versão confirmada é completamente autônoma. Versões anteriores dos scripts nunca são sobrescritos e os scripts nunca são mesclados entre versões.

Se você remover um script de um projeto, nenhuma das versões posteriores enviadas conterá o script.
As versões contêm todos os scripts
Uma versão contém todos os scripts que estão no projeto quando você envia os scripts ao Robôs: todos os scripts de análise e scripts auxiliares. Não é possível confirmar seletivamente alguns scripts de um projeto.
As alterações de versão são registradas
Na guia Versões de script no modo de desenvolvimento, você pode selecionar uma versão de script para ver os nomes e categorias dos scripts individuais que estão na versão. Os nomes de scripts recentemente adicionados, excluídos ou modificados são realçados.

Exemplo de versões de script

Cenário

Você quer automatizar um conjunto de testes analíticos que o departamento executa manualmente no arquivo quinzenal de folha de pagamento. Os testes verificam se os funcionários são pagos corretamente, se os descontos de folha de pagamento adequados são efetuados, se não há pagamentos para funcionários fantasmas e assim por diante.

O fluxo de trabalho de desenvolvimento de scripts

No Analytics, você desenvolve um script que importa o arquivo de folha de pagamento, executa algumas tarefas preliminares de preparação de dados e executa todos os testes analíticos.
Você confirma e envia o script para o Robôs, onde o script é executado em modo de desenvolvimento usando uma cópia dos dados reais para assegurar que está funcionando corretamente.
Quando o script estiver funcionando corretamente, ative-o para uso no modo de produção e agende-o para execução automática a cada duas semanas.

Analytics	Ação/Resultado	Robôs
Confirmar e enviar scripts >>	Confirmar Você confirma o script 1 que importa, prepara e analisa dados quinzenais de folha de pagamento. Testar Você testa o script 1 no modo de desenvolvimento do Robôs e, aparentemente, o script funciona corretamente. Problema Você percebe que o script 1 contém tanta funcionalidade que pode ser difícil que outra pessoa possa entender ou editar os script com facilidade.	>> Versão um
Confirmar e enviar scripts >>	Editar Você divide o script 1 em três scripts separados (2, 3, 4), um para cada fase: importação, preparação e análise. Você exclui o script 1. Confirmar Você confirma os scripts no projeto. Testar Você testa os três scripts e percebe que alguns resultados que deveriam constar na saída não foram incluídos. Problema A limpeza de dados executada pelo script 3 não é suficientemente abrangente, e você está perdendo alguns resultados.	>> Versão dois
Confirmar e enviar scripts >>	Editar No script 3, você usa funções do Analytics para criar campos calculados que executam uma limpeza de dados adicional. Os scripts 2 e 4 não são alterados. Confirmar Você confirma os scripts no projeto. Testar Você testa os três scripts e todos os resultados que deveriam constar na saída agora foram incluídos. Sucesso Você verificou que todos os três scripts e o processo geral estão funcionando corretamente. Você ativa a versão 3 dos scripts para uso no modo de produção.	>> Versão três
script editado script inalterado

Práticas recomendadas ao editar e confirmar e enviar scripts

Trate os scripts no Robôs como as versões principais

Os scripts são protegidos contra alteração quando são enviados para o Robôs. Como prática recomendada, você deve tratar os scripts no Robôs como a versão principal. Se quiser editar scripts, deve primeiro baixá-los do Robôs em vez de usar as cópias salvas localmente.

Você não está limitado ao download da versão mais recente dos scripts no Robôs. Você pode baixar qualquer versão dos scripts com os quais quer trabalhar.

O risco de iniciar o trabalho com uma cópia local

O risco de iniciar seu trabalho de edição com uma cópia local de scripts é que a cópia pode não corresponder à versão no Robôs:

você pode ter alterado a cópia local sem intenção ou esquecido que alterou
outra pessoa pode ter confirmado uma versão dos scripts para o Robôs depois que você confirmou os scripts pela última vez

Quando é seguro ignorar o download?

Normalmente, após fazer o download de uma versão do script, é seguro confirmar versões iterativas durante uma única sessão de edição do script diretamente do projeto do Analytics sem fazer download entre as iterações.

Se for uma possibilidade outra pessoa trabalhar nos scripts ao mesmo tempo que você, baixe entre as iterações. Recomenda-se que apenas uma pessoa trabalhe em uma versão de script por vez.

Testar scripts editados que são parte das tarefas agendadas

Você deve sempre testar um script(s) editado(s) que faz(em) parte de uma tarefa agendada no Robôs para ter a certeza de que as edições não interromperam a tarefa.

Por exemplo, fazer qualquer uma das seguinte edições em um cabeçalho de análise em um script pode prejudicar a tarefa associada e ela deverá ser recriada:

adicionando ou removendo um parâmetro de entrada
adicionando ou removendo um arquivo de entrada, tabela ou campo
alterando um arquivo de entrada ou nome de arquivo codificado

Validação de sintaxe

Cada vez que você confirma scripts para o Robôs, o Analytics executa automaticamente dois tipos de validação ou verificação de sintaxe:

Validação de cabeçalho de análise
Verificação de sintaxe do script

Se qualquer script não passar pela validação ou verificação, a confirmação dos scripts será cancelada e uma mensagem será exibida, indicando a localização do problema.

Validação de cabeçalho de análise

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

A validação de cabeçalho de análise não pode ser desativada.

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

Verificação de sintaxe do script

Certos elementos em scripts de análise, como comandos de interação de usuário em tempo de execução e caminhos de arquivo absolutos, não são compatíveis ou não são recomendados.

A verificação de sintaxe do script é ativada por padrão. Se você quiser desativá-la, selecione Desative a verificação de sintaxe de scripts antes da confirmação de scripts na caixa de diálogo Opções (Ferramentas > Opções > Interface).

Para obter mais informações, consulte Práticas recomendadas para o desenvolvimento de análises.