Migrar scripts do AX para o Robôs
Importante
Antes de migrar os scripts, conclua a etapas anterior da migração. Para obter mais informações, consulte Recriar a estrutura do seu repositório do AX no Robôs.
Para cada processo automatizado no AX que você pretende recriar no Robôs, é necessário migrar os scripts associados. Você precisa migrar todos os scripts de análise, subscripts e scripts auxiliares.
Não é possível migrar scripts diretamente do AX para o Robôs. Você precisa exportar os scripts do AX para um local intermediário em que o Analytics esteja instalado, como o seu próprio computador. Após concluir todo o trabalho preparatório necessário, você confirma e envia (faz upload) dos scripts do local intermediário para o Robôs.
Compatibilidade retroativa do Robôs
De forma geral, o Robôs foi projetado para ter a maior compatibilidade retroativa possível com o AX. A maioria dos scripts do AX deve funcionar no Robôs sem qualquer modificação.
Todos os scripts que dependem do projeto específico do AX precisarão ser ajustados. Por exemplo:
- scripts que acessam o banco de dados operacional do AX para ler agendamentos ou logs de tarefas
- scripts que incluem caminhos absolutos para recursos de servidor que não são válidos para o servidor do Agente do Robôs
Se precisar de ajuda para ajustar os scripts de análise para uso no Robôs, entre em contato com o Suporte da Diligent.
Exportar os scripts do AX
Para iniciar a migração, use a opção Exportar para exportar scripts do AX. Os scripts são exportados no aplicativo de análise que os contém. Cada aplicativo de análise exportado se torna um projeto do Analytics separado no destino de exportação.
Este procedimento supõe que você está usando seu próprio computador como local intermediário.
- Crie uma pasta no seu computador para armazenar scripts exportados.
- No Explorador do servidor do AX, selecione o aplicativo de análise que contém os scripts que você quer exportar.
Você pode usar Ctrl+clique para selecionar vários aplicativos de análise na mesma pasta principal Aplicativos de análise ou selecionar a pasta principal para exportar todos os aplicativos de análise na pasta.
- Selecione Arquivo > Exportar.
- Na caixa de diálogo Exportar, verifique se estas duas opções não estão marcadas:
- Trabalhar com o(s) arquivo(s) exportado(s)?
- Exportar arquivos de dados com as definições selecionadas
- Clique em Procurar, selecione a pasta que você criou para armazenar scripts e clique em OK.
- Clique em OK para exportar o(s) aplicativo(s) de análise.
Os scripts são exportados em seus aplicativos de análise para o local especificado. Cada aplicativo de análise é convertido em um projeto de Analytics.
- Repita o processo para todos os scripts adicionais que estão prontos para migrar.
Scripts de análise vinculados
Ao contrário do AX, o Robôs não aceita scripts de análise vinculados. Se você usa scripts de análise vinculados no AX, exporte o script de análise mestre e confirme-o em cada robô em que é necessário.
Executar todo o trabalho preparatório necessário
Após a exportação do AX, os scripts estarão prontos para confirmação no Robôs se:
- todos os scripts associados a um processo automatizado estiverem em um único projeto do Analytics
- todos os scripts de análise que devem ser executados sequencialmente em um processo automatizado:
- usam um esquema de nomenclatura alfanumérico adequado
- se implementados, têm um tipo de análise adequado
Cadeias de análise
Ao contrário do AX, o Robôs não aceita cadeias de análise. Se você usa cadeias de análise, pode ser necessário fazer algum trabalho preparatório antes que os scripts fiquem prontos para confirmação e envio ao Robôs. Para obter mais informações, consulte Replicar cadeias de análise no Robôs.
Confirmar e enviar (fazer upload) dos scripts para o Robôs
Depois que todos os scripts associados a um processo automatizado estiverem contidos em um único projeto do Analytics e tiverem nomes adequados, você poderá confirmar e enviar os scripts para o Robôs.
Com a confirmação e envio de scripts, eles são carregados de um ambiente local para o aplicativo Robôs baseado em nuvem. Usamos "confirmar e enviar" em vez de "fazer upload" porque a cada confirmação e envio de scripts para o mesmo robô, você cria uma versão dos scripts no histórico de scripts.
Para obter informações detalhadas, consulte Confirmando scripts (carregando) do ACL no Robôs.
- Abra o projeto do Analytics com os scripts que você quer confirmar e enviar.
- No menu principal do Analytics, selecione Arquivo > Confirmar e enviar scripts.
Se aparecer uma mensagem de erro, pode haver um problema com o cabeçalho de análise ou com a sintaxe do script em um ou mais scripts no projeto.
Para obter mais informações, consulte Fluxo de trabalho de desenvolvimento de script do ACL no Analytics e no Robôs.
- Se necessário, na caixa de diálogo Selecionar destino, clique duas vezes na instância do Diligent One adequada.
A Coleção de robôs é exibida, com a lista de robôs existentes.
- Na lista de robôs, selecione o robô para o qual deseja enviar os scripts e clique em OK.
O projeto do Analytics que contém os scripts e o robô existente agora estão associados. Nas confirmações subsequentes, não será mais necessário localizar manualmente o robô.
-
Insira uma breve mensagem de confirmação que descreve os scripts confirmados e clique em OK.
Os scripts são confirmados no modo de desenvolvimento no robô.
- Na caixa de diálogo Scripts confirmados com sucesso, clique no segundo link para inspecionar os scripts recém-enviados no aplicativo Robôs.
A guia Versões de script é aberta com a versão enviada dos scripts.
- Selecione a versão do script (vn).
O painel lateral Detalhes da versão abre. Os nomes dos scripts de análise individuais e auxiliares estão listados em Alterações na versão do script.
- No Analytics, clique em OK para sair da caixa de diálogo Scripts confirmados com sucesso.
Replicar cadeias de análise no Robôs
Observação
Esta seção só se aplica se você usa cadeias de análise no AX.
Ao contrário do AX, o Robôs não permite no momento combinar scripts de análise de qualquer lugar do repositório em uma cadeia de análises executada sequencialmente. Para implementar a execução sequencial de uma série de scripts de análise no Robôs, duas coisas são necessárias:
- manter os scripts de análise em um único robô e criar uma única tarefa para executar os scripts
- usar nomes de scripts e tipos de análise para criar uma sequência de scripts
Mostre-me mais
Manter os scripts de análise em um único robô
Mantenha os scripts de análise que você quer executar sequencialmente em um único robô.
Para manter os scripts em um único robô, é necessário antes manter todos os scripts relacionados em um único projeto do Analytics. Você confirma e envia os scripts como um único pacote, denominado uma versão de script, do projeto do Analytics para o robô.
Depois que os scripts estiverem em um único robô, você criará uma única tarefa para executar a série de scripts de análise.
Manter os scripts associados em um único projeto do Analytics
Se os scripts associados a um único processo automatizado estão distribuídos entre dois ou mais projetos do Analytics, você deve unir os scripts em um único projeto antes de confirmar e enviar os scripts para o Robôs. Essa situação pode ocorrer se os scripts de análise são parte de uma cadeia de análises no AX.
- Abra o projeto do Analytics que você quer usar para conter todos os scripts associados a um processo automatizado.
- Na guia Visão geral do Navegador, clique com o botão direito do mouse no nome do projeto na parte superior da exibição de árvore e selecione Copiar de outro projeto > Script.
- Na caixa de diálogo Localizar arquivo do projeto, localize e selecione o projeto do Analytics do qual deseja copiar o(s) script(s) e clique em Abrir.
- Na caixa de diálogo Importar, realize uma das seguintes etapas para adicionar um ou mais scripts à lista Para nome_projeto:
- Dê duplo clique em um script.
- Utilize Ctrl+clique em vários scripts e clique no botão de seta à direita.
- Clique em Adicionar tudo para adicionar todos os scripts.
- Clique em OK para copiar o script ou scripts para o projeto de destino.
Se um script com o mesmo nome já existir no projeto, um sufixo numérico incremental será acrescentado ao nome do script copiado.
- Repita o processo para todos os scripts em outros projetos que precisam ser incluídos no projeto de destino.
Usar nomes de scripts e tipos de análise para criar uma sequência de scripts
Nomes do script
Os scripts de análise são ordenados alfabeticamente por nome em uma tarefa de robô e executados nessa ordem. Portanto, atribua nomes aos scripts de análise de forma a criar a sequência de execução desejada.
Por exemplo, o primeiro script na sequência pode usar o prefixo A_01, o segundo A_02 ou B_01, e assim por diante. Um sistema de prefixos facilita a inserção posterior de scripts adicionais. Subscripts ou scripts auxiliares não estão sujeitos ao requisito de nomenclatura sequencial.
Observação
Não é possível renomear scripts no Robôs. Portanto, verifique se todos os scripts têm nomes corretos no Analytics antes de enviá-los para o Robôs.
Tipo de análise
Como ajuda adicional para a execução sequencial, você pode especificar um tipo para os scripts de análise. A especificação de um tipo agrupa os scripts em áreas separadas em uma tarefa. As áreas são ordenadas desta forma e executadas nessa ordem:
- Importar
- Preparação
- Análise
Em cada área, os scripts são ordenados alfanumericamente. Independentemente do nome do script, uma tarefa executa todos os scripts em uma área antes de passar para a próxima área.
Para obter mais informações, consulte Tag ANALYTIC.
Renomear scripts de análise para criar uma sequência de execução
Se você quiser que dois ou mais scripts de análise executem em sequência, eles precisam ser nomeados de forma a criar a sequência de execução desejada. Para obter mais informações, consulte Replicar cadeias de análise no Robôs.
Observação
O nome do script de análise especificado no cabeçalho de análise é o nome usado no Robôs. O nome do script na guia Visão geral do Navegador não é usado.
- No Analytics, abra o script de análise que você quer renomear.
- Na tag //ANALYTIC no cabeçalho de análise, atualize o nome da análise e clique em Salvar o Projeto Aberto
.Para obter mais informações, consulte Tag ANALYTIC.
- Repita o processo para todos os scripts de análise que precisam ser renomeadas.
Especificar um tipo de análise para agrupar scripts de análise
Se você quiser agrupar scripts de análise nas áreas Importação, Preparação e Análise de uma tarefa, precisará especificar um tipo de análise correspondente para cada script. O agrupamento de scripts de análise oferece uma opção adicional para criar uma sequência de scripts, mas não é obrigatório. Para obter mais informações, consulte Replicar cadeias de análise no Robôs.
- No Analytics, abra o script de análise para o qual você quer especificar um tipo.
- Na tag //ANALYTIC no cabeçalho de análise, adicione um tipo de análise e clique em Salvar o Projeto Aberto .
Para obter mais informações, consulte Tag ANALYTIC.
- Repita o processo para todos os scripts de análise que precisam de um tipo de análise.
O que fazer em seguida
Após migrar os scripts para um ou mais processos automatizados, você está pronto para começar a migrar dados: Migrar dados do AX para o Robôs.
