Analytics e Robôs

O Robôs é um aplicativo do HighBond usado para automatizar tarefas repetitivas usando scripts criados no Analytics. Após criar os scripts, você pode carregá-los no Robôs, onde é possível configurar a automação das tarefas necessárias. O Robôs processa as tarefas recorrentes de acordo com a configuração.

Para obter informações detalhadas sobre o aplicativo Robôs, consulte a Ajuda do Robôs.

Como faço para automatizar o uso do Robôs?

Para automatizar tarefas repetitivas usando o Robôs, você deve antes criar um projeto no Analytics que contém pelo menos um script de análise. Um script de análise é um script do Analytics que usa um cabeçalho de análise para declarar determinadas propriedades e instruções para execução do script.

Para obter mais informações sobre scripts de análise e cabeçalhos de análise, consulte Scripts de análise.

Confirmação e envio de scripts e criação de um robô

Após escrever o script de análise ou os scripts, você os carrega no Robôs. A ação de carregamento de scripts do Analytics para o Robôs é chamada de confirmação de scripts. A confirmação de scripts pela primeira vez faz com que um robô seja criado no aplicativo Robôs. Um robô é um contêiner que hospeda scripts de análise confirmados, scripts auxiliares e arquivos relacionados. O robô é o objeto configurado para executar tarefas agendadas e automatizadas.

Modo de desenvolvimento e produção

Os scripts são confirmados no modo de desenvolvimento somente no Robôs, e nunca em produção. Essa definição protege os scripts de produção, que são mantidos completamente separados do modo de desenvolvimento.

Depois de enviar a versão final de um script ou de scripts para o Modo de desenvolvimento, você precisa ativar explicitamente a versão em produção.

Uma abordagem alternativa

No Robôs, você pode criar um robô vazio e confirmar scripts do Analytics para o robô vazio. Você pode criar manualmente o robô no Robôs, ou criar automaticamente o robô ao confirmar scripts pela primeira vez. Nos dois casos, o resultado será o mesmo.

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 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 Robôs garante que você não perca nenhum trabalho de criação de scripts e permite que você acesse 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. Não é possível confirmar seletivamente alguns scripts de um projeto.

Práticas recomendadas ao editar 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. Baixe a versão dos scripts com os quais você deseja 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 acidentalmente a cópia local, ou se esquecer de que a 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 ou scripts editado(s) 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

A cada vez que você confirma scripts para o Robôs, o Analytics executa automaticamente dois tipos de validação ou verificação de sintaxe. 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.

Confirmação de scripts para o Robôs

Há várias possibilidades de enviar scripts para o Robôs.

A maneira mais fácil de compreender as diversas possibilidades é considerar um projeto do Analytics e um robô como dois contêineres, que contêm scripts que podem ser associados. Após a associação, você pode confirmar versões sucessivas de scripts do projeto para o robô.

Ação	Resultado da confirmação
Enviar scripts para um novo robô	Um novo robô é criado e contém a versão 1 dos scripts enviados.
Enviar scripts para um robô existente	O robô existente contém os scripts enviados, com um número de versão que depende se o robô já contém scripts.
Enviar scripts editados	Uma nova versão dos scripts é enviada ao robô associado com o projeto.
Enviar scripts para um robô diferente	Os scripts são enviados para um robô recém-criado ou existente. A associação entre o projeto e o robô anterior é excluída.

Enviar scripts para um novo robô

Envie scripts para o Robôs pela primeira vez para criar um novo robô que contenha os scripts enviados.

Enviar scripts para um robô existente

Envie scripts para um robô que já existe para preencher o robô. O robô existente pode conter scripts ou estar vazio.

Enviar scripts editados

Envie scripts editados para criar uma nova versão dos scripts no robô associado.

Há dois métodos para editar scripts antes de enviá-los. Você pode editar os scripts no projeto associado ou fazer download dos script do Robôs para um novo projeto do Analytics e editar os scripts no novo projeto.

Enviar scripts para um robô diferente

Enviar scripts para um robô diferente para adicionar uma versão dos scripts ao robô e para alterar o robô associado com o projeto. Os scripts podem ser editados ou não editados.

Há duas possibilidades ao enviar scripts para um robô diferente:

• enviar scripts para um novo robô
• enviar scripts para um robô existente

Exibição de tabelas, logs e arquivos do Robôs

Você pode fazer download de tabelas ou logs do Analytics, ou arquivos não Analytics, do Robôs e exibi-los no computador local. Há diferentes opções, dependendo da tabela ou do tipo de arquivo.

Tabela ou tipo de arquivo	Download no pacote de resultados ou o projeto do Analytics	Download individual	Exibir no Robôs
Tabelas de resultados do Analytics
Tabelas de dados do Analytics
Log de resultados do Analytics
arquivo de resultados não Analytics
arquivos relacionado não Analytics

Exibindo uma tabela no Analytics

O conteúdo de um pacote de resultados ou projeto do Analytics baixado, bem como a forma como você exibe tabelas do Analytics baixadas, depende do tipo de Agente do Robôs utilizado.

Para obter mais informações sobre o Agente do Robôs, consulte a Ajuda do Robôs.

Tipo de agente	Baixar e exibir detalhes
Agente do Robôs local	Baixar O pacote ou projeto baixado contém apenas o layout da tabela. Os dados da tabela permanecem na rede da sua organização, mas você pode usar os dados para análise no Analytics. Exibição Usando um perfil de servidor, você se conecta do Analytics aos dados da tabela no Agente do Robôs da sua organização. Tabelas compatíveis Tabelas de resultados do Analytics e tabelas de dados do Analytics.
Agente do Robôs baseado na rede	Baixar O pacote ou projeto baixado contém o layout da tabela e os dados da tabela. Exibição Você acessa os dados da tabela localmente usando apenas o Analytics. Tabelas compatíveis Somente tabelas de resultados do Analytics.

Download dos resultados da tarefa

Os resultados da tarefa podem incluir tabelas de resultado do Analytics, outros tipos de arquivos e um arquivo de log.

Os resultados de tarefa são especificados usando a tag de análise //RESULT. Para obter mais informações, consulte RESULT.

1. No painel do Robôs, clique no robô que contém os resultados.
2. No canto superior direito do robô, use o botão de alternância Modo de desenvolvimento para selecionar o ambiente a ser usado.
3. Selecione a guia Execuções de tarefa.
4. Selecione a execução de tarefa com os resultados para download.
5. No painel Detalhes da execução da tarefa, execute uma das seguintes ações:

   Faça download de um arquivo de resultado individual

   Clique em Baixar ao lado de um arquivo de resultado não Analytics ou de um arquivo de log do Analytics. Resultado O download do arquivo é executado para o sistema de arquivos local, de onde ele pode ser aberto pelo aplicativo nativo. Um arquivo de log do Analytics pode ser aberto em qualquer editor de texto. Você também pode clicar em Exibir ao lado do nome de um arquivo de log para exibir diretamente o log.

   Fazer download de todos os arquivos de resultado em um pacote

   Clique em Baixar pacote de resultados. Resultado Um arquivo compactado chamado <nome_robô>.zip, que inclui um projeto do Analytics, é baixado para seu sistema de arquivos local. Você pode extrair o conteúdo do arquivo compactado, abrir o projeto do Analytics no Analytics e exibir as tabelas de resultado do Analytics. É possível abrir qualquer outro tipo de arquivo de resultados, como Excel, em seus aplicativos nativos. Se a execução de tarefa falhou, clique em Baixar pacote com falha para fazer download do arquivo de log. Você também pode clicar em Exibir ao lado do nome do arquivo de log para exibir diretamente o log. O arquivo de log pode ajudar você a identificar o motivo da falha da tarefa.

Baixar uma tabela de dados do Analytics

As tabelas de dados são especificadas usando a tag de análise //DATA. Para obter mais informações, consulte DATA.

1. No painel do Robôs, clique no robô que contém a tabela ou as tabelas de dados.
2. No canto superior direito do robô, use o botão de alternância Modo de desenvolvimento para selecionar o ambiente a ser usado.
3. Selecione a guia Entrada/Saída.
4. Na lista Outras tabelas ou Tabelas de origem, selecione a tabela de dados para download.
5. No painel Detalhes da tabela , clique em Exibir Tabela no AN.

   Dica

   Se você quiser remover a tabela, clique em Excluir Tabela > Excluir.

   Resultado Um projeto do Analytics chamado <nome_robô>.acl é baixado para seu sistema de arquivos local. O projeto contém todas as tabelas de dados da guia Entrada/Saída e não apenas a tabela selecionada.

   Você pode abrir o projeto no Analytics e exibir a tabela de dados.

Abrir uma tabela baixada do Analytics (Agente do Robôs local)

Antes de começar

Para conectar-se a dados em um Agente do Robôs, você deve ter um perfil de servidor configurado no Analytics.

Abra a tabela

1. Navegue até o projeto do Analytics (*.acl) baixado ou descompactado e clique duas vezes nele.

   O projeto abre no Analytics.

2. Clique duas vezes em uma tabela do Robôs para abri-la.
3. Insira sua senha de rede e clique em OK.

Abrir uma tabela baixada do Analytics (Agente do Robôs baseado na nuvem)

1. Navegue até o projeto do Analytics (*.acl) descompactado e clique duas vezes nele.

   O projeto abre no Analytics.

2. Clique duas vezes em uma tabela para abri-la.