Migrando de pastas clássicas para modernas

As pastas modernas foram lançadas para melhorar e simplificar a orquestração das automações e oferecer vários benefícios em comparação com as pastas clássicas.

Observação: as pastas clássicas não são mais o padrão para gerenciar automações e foram substituídas por pastas modernas, uma alternativa melhor e com mais recursos. Por esse motivo, já removemos a opção de criar novas pastas clássicas e substituiremos as pastas clássicas a partir de outubro de 2022.

Para ajudar você na transição para as pastas modernas, você pode usar o assistente de Migração para modernas para recriar facilmente sua hierarquia das pastas clássicas e entidades nas pastas modernas, preservando todas as dependências.

Visão geral do processo de migração

Para converter sua implantação atual, no todo ou em parte, para usar pastas modernas, algumas entidades devem ser reimplantadas, enquanto outras devem ser completamente recriadas.

Aqui está uma visão geral do que o assistente de Migração faz durante e após a migração:

• Recria cada pasta clássica como uma pasta moderna com um nome com o formato Migrated <folder name>.
• Para cada ambiente, cria uma subpasta correspondente na pasta moderna de destino. Se houver apenas um ambiente, ele não criará nenhuma subpasta.
• Reimplanta cada processo para a pasta (ou subpasta) moderna que corresponde à sua pasta ou ambiente anterior.
• Migre ativos, filas e gatilhos de cada pasta clássica para a pasta moderna correspondente.
• Migre cada entidade da Test Suite para a subpasta moderna que corresponde ao ambiente de pastas clássicas ao qual pertencia anteriormente.

• Migra contas de robôs e de usuários para as pastas modernas correspondentes:

  • Mapeia cada Attended Robot clássico para uma conta de usuário e configura cada conta de usuário com configurações de automação pessoal (anteriormente conhecidas como configurações de Attended Robots) e o acesso às pastas modernas e máquinas correspondentes necessário para executar as automações Attended que executou nas pastas clássicas. Dois cenários podem ocorrer em termos de funções:

    • Se a conta do usuário para a qual um Attended Robot clássico foi mapeado não tiver sido atribuída ao tenant no momento em que a migração começou, ela será incluída automaticamente no tenant e receberá a função no nível do tenant Allow to be Automation User.
    • Se a conta de usuário para a qual um robô assistido clássico é mapeado já foi atribuída ao inquilino, suas funções não mudam, então você precisa conceder manualmente a função de nível de inquilino Permitir ser usuário de automação . Isso evita que as automações quebrem.

  • Mapeia cada Unattended Robot clássico para contas de robôs (recomendado), a não ser que tenha sido configurado de outra forma, e configura cada conta de Robot com acesso às pastas modernas e máquinas correspondentes necessárias para executar as automações que o Unattended Robot executou nas pastas clássicas.

    Concede a função no nível da pasta Automation User para as contas de Robots existentes que são mapeadas para Unattended Robots.

    As novas contas de Robots geradas automaticamente recebem a função no nível da pasta Automation User e função no nível do tenant Allow to be Automation User.

• Algumas licenças de usuários que incluem a capacidade Attended podem ficar disponíveis após a migração ser concluída. Isso ocorre porque, nas pastas modernas, cada usuário necessita de apenas uma licença de usuário para automações pessoais (anteriormente, Attended). Se o mesmo usuário tinha várias licenças, ele manterá a licença superior, e a inferior será liberada.

  Por exemplo, se um dos Attended Robots do usuário usou uma licença Attended e outro usou uma licença Citizen Developer, o usuário reterá a licença Citizen Developer, e a licença Attended será liberada.

  Importante:

  Embora o assistente possa simplificar muito o processo de migração para você, há tarefas pós-migração que você precisa executar para que suas automações possam ser executadas corretamente.

  Certifique-se de que você tenha o conhecimento necessário e que separe tempo para realizar essas tarefas antes de iniciar a migração.

Alterações nas configurações dos tenants

Após executar o assistente de Migração para modernas, algumas configurações no nível do tenant mudam automaticamente. Essas alterações são necessárias para as pastas modernas usadas.

As seguintes alterações se aplicam após todas as pastas clássicas terem sido migradas com sucesso:

• O login interativo é exigido.

  Após a migração ser concluída, os usuários precisarão atualizar suas configurações de conexão com o UiPath Studio ou o UiPath Assistant para mudar do uso de uma chave de máquina para o uso do login interativo para poder trabalhar nas pastas modernas.

• As pastas clássicas e suas entidades ainda são utilizáveis.

  Você pode mantê-las até que a validação esteja concluída; depois disso, você poderá excluí-las.

• Os mapeamentos conta-máquina estão habilitados no nível do tenant.

Pré-requisitos

Permissões

• Para poder executar com sucesso o assistente da Migração para modernas, você deve ser um administrador da organização.

• Para poder abrir o assistente de Migração para modernas, você precisa das seguintes permissões:

  • Funções: Visualizar, Criar e Editar
  • Configurações: Visualizar e Editar
  • Usuários Visualizar, Criar e Editar
  • Robôs: Visualizar, Criar, Editar e Excluir
  • Pastas: Criar e Editar.

Limitação de volume

O assistente de Migração para modernas não é adequado para grandes implantações, que exigem ferramentas e estratégia de migração dedicadas.

Recomendamos que você não use o assistente de migração em pastas que contenham mais de 2.000 Classic Robots. Isso pode causar problemas de desempenho e pode ocasionar uma falha na migração.

Etapa 1. Usando o assistente de Migração para modernas

Preparando-se para a migração

Importante:

É importante que você não faça nenhuma alteração na configuração de suas pastas clássicas até que a migração esteja concluída.

Please limit pre-migration checks and changes to the ones laid out below.

Problema conhecido

Após iniciar a migração, você não poderá mais editar gatilhos de filas nas pastas clássicas. No caso de quaisquer problemas que exijam a edição de um gatilho de fila, você não poderá usar o gatilho de fila defeituoso entre o momento em que a migração foi iniciada e o momento em que a migração foi concluída com sucesso.

Incluindo e excluindo pastas

Antes de iniciar o assistente, adicione-se a todas as pastas clássicas que você quer migrar.

As pastas às quais você não foi atribuído não serão migradas.

Incluindo e excluindo Robots clássicos

Antes de iniciar o assistente, verifique se todos os Robots que você quer migrar foram adicionados a um ambiente.

Presume-se que os Robots clássicos que não fazem parte de qualquer ambiente não estejam em uso e não sejam direcionados para migração.

Importante: se um robô não for migrado, os valores dos ativos e os agendamentos dos processos para esse robô também não serão migrados, a menos que também sejam usados por outro robô que foi migrado.

Prevenindo a elevação das permissões

Após a migração, contas de usuários Attended e Robots recebem automaticamente a função Automation Users no nível da pasta (na pasta correspondente à qual foram atribuídas no momento da migração). Se você tiver personalizado as funções no nível do serviço ou a regra de alocação de licenças para esse grupo, recomendamos que você remova quaisquer funções elevadas ou licenças extras desse grupo antes de prosseguir com a migração.

Verifique se nenhum trabalho está sendo executado

É importante assegurar que, antes de iniciar a migração, não haja trabalhos em execução.

Se você tiver gatilhos que iniciariam um trabalho durante a migração, recomendamos que você os desabilite e reabilite após o término da migração.

Antes de iniciar a migração, você pode verificar o status dos trabalhos na página Pasta > Monitoramento de cada pasta clássica a ser migrada.

Importante: quando a migração for iniciada, todos os trabalhos que não estão em um estado Final serão encerrados. Se um trabalho encerrado não atingir o status Parado até o momento em que a migração foi concluído, a migração falhará com um erro relacionado.

Usando o assistente

Para migrar pastas clássicas para pastas modernas para um tenant:

1. Acesse Tenant > Configurações.

   A página Configurações é aberta na guia Geral.

2. Na seção Pastas clássicas, clique em Iniciar migração.

   O assistente de Migração para modernas é aberto na etapa Introdução.

3. Examine as informações e, na seção Resumo clique em Copiar o resumo acima e salve essas informações para seus registros.

   O resumo lista os tipos e o número de entidades incluídas para migração.

   • Apenas as pastas clássicas às quais você tem acesso são direcionadas para migração. Pastas às quais você não foi adicionado não são migradas.
   • Os Robots clássicos que não são adicionados a um ambiente são considerados como não estando em uso e não são direcionados para migração.
4. Quando estiver pronto, clique em Avançar para prosseguir para a etapa Usuários Attended.

Usando o Assistente para Usuários Assistidos

Como nas pastas modernas gerenciamos a relação entre usuários e Robots de forma diferente e criamos o Robot do usuário automaticamente, você precisa mapear cada Attended Robot clássico para a conta do usuário que o usa.

A página Usuários Attended lista todos os Attended Robots encontrados nas pastas clássicas direcionadas e seus detalhes.

Na coluna Conta do usuário de destino, para cada Attended Robot encontrado, você deve selecionar a conta do usuário que usa o Attended Robot, com base nas informações nas outras colunas.

Importante:

• Se você não definir uma conta para um robô, esse robô não será migrado. Os processos associados a esse Robot não poderão mais ser executados.
• Se o nome de usuário de um Attended Robot envolvido na migração não contiver o caractere @, a migração não será bem-sucedida. Para superar isso, os usuários locais precisam ser convertidos em usuários do diretório. Isso é feito automaticamente durante a instalação ou atualização, desde que os usuários impactados façam login no Orchestrator pelo menos uma vez. Se eles não o fizerem, você pode usar este script para convertê-los:

  DECLARE @domain VARCHAR(100) = 'your-domain-name-here'
  UPDATE u
  SET
      u.[UserName] = CONCAT(u.[UserName], '@', lower(@domain)),
      u.[Type] = 2
  FROM
      [dbo].[Users] u
      JOIN [dbo].[UserLogins] l ON u.[Id] = l.[UserId]
  WHERE 
      u.[Type] = 0
      AND l.[LoginProvider] = 'Windows'
      AND u.[IsDeleted] = 0

1. Para cada conta de destino que não esteja correta ou não esteja definida, você deve definir manualmente a conta:
   1. Clique em Atribuir na coluna Conta de usuário de destino.
   2. No campo Pesquisar um usuário, comece a digitar para pesquisar e, então, selecione o usuário de acordo com os resultados.
   3. Clique em Salvar na parte inferior direita para definir a conta de destino e retornar à página anterior.
      Para obter informações sobre como mapear Robots para contas de usuários, consulte Regras de mapeamento para attended robots.
2. Quando estiver pronto, clique em Avançar para mover para a etapa Usuários Unattended.

Regras de mapeamento para Attended Robots

A seguir encontram-se as regras que usamos para validar sua seleção ao tentar mapear Attended Robots clássicos para seus usuários.

• Os Robots com o mesmo Nome de usuário (mostrado na página Usuários Attended) devem ser mapeados para a mesma conta de usuário de destino.

  De forma semelhante, Robots com um valor de Nome de usuário diferente devem ser mapeados para contas de usuários de destino diferentes.

• Se você tiver uma integração com um diretório de usuários externo, ao mapear Robots para as contas de usuários do diretório, o valor Nome de usuário do Robot deve corresponder ao endereço de email ou nome de usuário da conta do usuário de destino.

  Você pode visualizar o endereço de email e o nome de usuário para a conta de um usuário na página Tenant > Gerenciar acesso > Atribuir funções.

• Ao mapear Robots para contas de usuários locais:

  • Se o login interativo for exigido para o tenant, você terá permissão para mapear qualquer Robot clássico para qualquer usuário.
  • Se a configuração de autenticação de robôs no nível do tenant estiver definida como Híbrida e a conta do usuário de destino tiver a automação pessoal habilitada, o valor de Nome de usuário para o robô deverá corresponder ao valor de Domínio\Nome de usuário, conforme mostrado na página Configuração de automações pessoais do usuário.
  • Se a configuração de autenticação de robôs no nível do tenant estiver definida como Híbrida, a conta do usuário de destino terá a automação pessoal habilitada, e a opção Herdar licença do grupo do usuário será definida na página Configuração de automações pessoais do usuário e, então, o usuário terá um nome de usuário de automação pessoal gerado que não é mostrado, mas que deve corresponder ao Nome de usuário do robô; caso contrário, o mapeamento não será permitido.

Importante: quando vários Attended Robots são mapeados para a mesma conta de destino, o nome de usuário do robô na pasta moderna será um dos nomes de usuário dos robôs migrados, aleatoriamente. Isso pode resultar em problemas de acesso ao tentar se conectar a máquinas.

Usando o assistente para usuários Unattended

Para Unattended Robots, você deve mapeá-los para contas de Robots novas ou existentes. As contas de Robots são projetadas para executar automações Unattended, e recomendamos usá-las em vez de contas de usuários.

A página Usuários Unattended lista todos os Unattended Robots encontrados em pastas clássicas.

1. Na parte superior direita, em Ações em massa, selecione como você quer que o assistente lide com Unattended Robots clássicos que não têm uma conta de Robot de destino mapeada:

   • Recomendado: selecione Gerar automaticamente contas de Robôs se você quiser migrar todos os Robots Unattended listados e quiser que o assistente crie novas contas de Robôs para eles. Detalhes...

   • Não recomendado: selecione Ignorá-los se você quiser migrar apenas alguns dos Robots clássicos encontrados.

2. Examine a coluna Conta do Robot de destino para assegurar que quaisquer mapeamentos existentes estão corretos.
   • Se você selecionou Gerar automaticamente contas de Robots, pule esta etapa.

   • Se você selecionou Ignorá-los, você deve mapear manualmente apenas aqueles Unattended Robots clássicos que você quer migrar para uma conta de Robot de destino clicando em Atribuir na coluna Conta de Robot de destino. Você também pode criar novas contas de Robots nesse momento, se necessário.

     Importante: quaisquer robôs clássicos que não foram mapeados para uma conta de Robot de destino não serão migrados para as pastas modernas.
3. Quando estiver pronto, clique em Avançar para prosseguir para a etapa final.

   A página Terminando é aberta.

O que gerar automaticamente contas de Robots faz

Com essa opção selecionada, no momento da migração, o assistente tentará mapear automaticamente cada Robot clássico da seguinte forma:

1. Procura um usuário existente ou uma conta de robô com um nome de usuário unattended correspondente.

   Se encontrar, mapeará o Unattended Robot para essa conta existente. Se não for encontrada nenhuma correspondência, passará para a próxima etapa.

2. Procura outros unattended robots clássicos com o mesmo Nome de usuário que já foi mapeado para uma conta.

   Se encontrar, mapeará esse Robot para a mesma conta. Se não for encontrada nenhuma correspondência, criará uma nova conta de Robot para o Robot clássico.

Novas contas de Robots criadas pelo assistente têm um nome com o formato Migrated folderName_robotName.

Regras de mapeamento para Unattended Robots

As seguintes regras se aplicarão ao tentar mapear Unattended Robots clássicos para contas de Robots ou de usuários.

Se você optar por mapear manualmente Robots para contas de Robots (não recomendado) em vez de permitir que o assistente crie novas contas de Robots, então você deve seguir estas regras.

1. Procura uma conta de robô existente que usa as mesmas credenciais do unattended robot clássico.

   Se for encontrada uma correspondência, o assistente exigirá que você mapeie o Unattended Robot clássico para a conta do Robot existente. Se não encontrar, passará para a próxima etapa.

2. Procura outro Unattended Robot clássico que tenha as mesmas credenciais do robô clássico a ser mapeado. Se for encontrado e já tiver sido mapeado para uma conta de destino, o assistente exigirá que você mapeie o Robot atual para a mesma conta de destino.

Importante: se você mapear vários robôs com diferentes credenciais para a mesma conta do robô, a conta do robô usará as credenciais de um dos robôs clássicos, de forma aleatória. Há um risco de que essas credenciais não funcionem em todas as máquinas de destino e, após a migração, pode haver uma falha na conexão às máquinas.

Iniciando a migração

1. Quando estiver pronto, clique em Executar migração para iniciar o processo.

   Uma caixa de diálogo de confirmação é exibida.

2. Clique em Executar para iniciar a migração.

   A página é atualizada para mostrar o progresso da migração para cada pasta.

   Observação: se ocorrer alguma falha, verifique as mensagens de erro apresentadas. Após resolver o problema em cada pasta clássica, você pode reiniciar ou tentar novamente a migração.
3. Clique em Fechar para sair do assistente.

Próximas etapas: se a migração tiver sido bem-sucedida, continue com a Configuração pós-migração.

Solução de problemas

Os trabalhos ainda não estão no estado Final

Quando a migração começar, o assistente terminará automaticamente quaisquer trabalhos em execução, para que ela possa ser executada. Se, no momento em que a migração terminar, um trabalho encerrado permanecer no status Encerrando e não atingir o status Parado, então a migração falhou.

Se isso acontecer, após 24 horas, definiremos automaticamente os trabalhos Encerrando com o Status Parado. Nesse ponto, você pode reiniciar a migração.

Reiniciando ou tentando novamente a migração

Se a migração falhar para algumas ou todas as pastas, você poderá tentar novamente depois de resolver as configurações incorretas que causaram os erros.

Para reiniciar ou tentar novamente uma migração que falhou:

1. Examine as mensagens de erro para cada pasta e, então, verifique a configuração das pastas clássicas para resolver os erros.
2. Após resolver todos os erros, vá para Tenant > Configurações > Iniciar migração.

   O assistente é aberto na página final.

3. Para executar novamente a migração:

   • Se você quiser executar novamente a migração com suas configurações anteriores, clique no ícone Tentar novamente à direita da linha de uma pasta cuja migração falhou. Essa opção reinicia a migração como foi configurada anteriormente, sem dar a você a opção de alterar os mapeamentos.

     (Opcional) Marque a caixa de seleção Limpar antes de tentar novamente se você quiser excluir quaisquer dados parcialmente migrados para a pasta para a qual a migração falhou. Se você não marcar essa caixa de seleção, a migração será realizada apenas para as entidades que não puderam ser migradas anteriormente.

     Dica: se a migração falhar com um erro para os itens Filas de dados de testes ou Fila de dados de testes, marque a caixa de seleção Limpar antes de tentar novamente antes de reiniciar a migração. Isso evita itens Fila de dados de testes duplicados nas pastas modernas.

   • Se você quiser refazer os mapeamentos para Attended e Unattended Robots, clique em Reiniciar na parte inferior direita. Essa opção leva você de volta à primeira etapa do assistente. Siga as instruções em Usando o assistente para concluir a configuração mais uma vez.

Etapa 2. Configuração pós-migração

Após a migração estar completa, você deve executar as seguintes etapas manuais para tratar de problemas de compatibilidade com versões anteriores:

1. Recompile fluxos de trabalho existentes que usam atividades do Orchestrator ou que estão fazendo chamadas HTTP diretas para a API do Orchestrator para usar a versão 2019.10 ou posterior para UiPath.System.Activities.
2. Reprovisione todas as outras entidades existentes, como catálogos de ação, na pasta moderna correspondente.

   Você não precisa reprovisionar Attended e Unattended Robots (eles são provisionados automaticamente para usuários com acesso à nova pasta moderna) e ambientes (eles não são usados no contexto de uma pasta moderna).

3. Desvincule Conjuntos de testes das pastas clássicas, excluindo-os dos projetos do Test Manager correspondentes.
   
   

   

   
   
4. Vincule os Conjuntos de testes novamente, selecionando os Conjuntos de testes que [Migraram] conforme sua descrição.
   
   

   

   
   
5. Atualize o processo das pastas clássicas usado no UiPath Apps para usar o processo de pastas modernas recém-migrado.
6. Atualize quaisquer fluxos de Trabalho que:
   • tenham uma dependência no caminho das pastas antigas
   • usem a atividade Start Job. Nas pastas clássicas, onde você tinha processName_envName, agora você precisa alterar para processName para as pastas modernas.
7. Se ainda não estiver habilitado, habilite o login interativo para o tenant. Isso é obrigatório para trabalhar nas pastas modernas.
8. Execute os processos Unattended no Orchestrator usando Start Job para testá-los na configuração moderna.
   Observação: aguarde 10 minutos após a migração ser concluída para o assistente desabilitar os robôs das pastas clássicas migradas. Isso é necessário para que as licenças sejam liberadas e possam ser usadas nas pastas modernas.
9. Atualize estações de trabalho do usuário final para usar o UiPath Robot versão 2019.10 ou posterior.
10. Remova as pastas clássicas agora não utilizadas.

Revertendo para as pastas clássicas

Se você executou o assistente de migração, mas suas automações não são executadas corretamente nas pastas modernas, você poderá reabilitar temporariamente a configuração de suas pastas clássicas, para que você possa continuar a executar automações até conseguir resolver os problemas de migração e mover para as pastas modernas com sucesso.

Para reverter temporariamente para o uso de pastas clássicas após executar a migração:

1. Defina as configurações de autenticação dos robôs para o tenant de volta para Híbrida.
2. Habilite todos os Robots clássicos.
3. Habilite gatilhos nas pastas clássicas.
4. Exclua as pastas modernas.
5. Exclua as novas contas de Robots.
6. Investigue o que na configuração das pastas clássicas causou uma falha nas automações e considere limpar suas pastas clássicas.
7. Execute a migração novamente.

Migração manual

Para aproveitar os recursos fornecidos pelas pastas modernas, você deve recompilar os fluxos de trabalho existentes que estão usando atividades do Orchestrator ou estão fazendo chamadas HTTP diretas para a API do Orchestrator, usando UiPath.System.Activities v19.10.1 ou superior. Você também deve reprovisionar todas as outras entidades existentes em uma estrutura de pasta moderna, exceto: Robôs - pois eles são provisionados automaticamente para usuários com acesso à nova pasta moderna; e Ambientes - pois não são usados no contexto de uma pasta moderna.

Importante:

Atualizar suas entidades existentes para o modelo moderno remove toda a compatibilidade retroativa. Os fluxos de trabalho recompilados são executáveis apenas por Robôs v2019.10+.

Migração para pastas modernas

Para converter sua implantação atual, no todo ou em parte, para usar pastas modernas, algumas entidades devem ser reimplantadas, enquanto outras devem ser completamente recriadas. Uma visão geral do processo de migração pode ser considerada da seguinte forma:

• Cada ambiente se torna uma subpasta separada, ou então sua própria pasta de primeiro nível, se você quiser manter os usuários e processos em cada uma completamente segregados.

• O fluxo de trabalho de cada pacote deve ser recompilado usando atividades atuais e, depois, republicado ou carregado para o Orchestrator.

• Usando os Pacotes recém-compilados, cada processo deve ser reimplantado na pasta (ou subpasta) que corresponda ao seu ambiente anterior.

• Cada usuário deve ser adicionado à(s) pasta(s) correspondente(s) aos processos que ele precisa acessar.

Essa migração pode ser executada de forma perfeita para o usuário. O administrador do Orchestrator cria e adiciona toda a estrutura de pastas modernas e as entidades necessárias, enquanto os usuários ainda usam as entidades existentes nas pastas clássicas onde estiverem atribuídas. Durante esse tempo, você pode criar dois robôs com o mesmo domain\username, um em uma pasta clássica e outro em uma pasta moderna, e o usuário verá e executará apenas os processos clássicos disponíveis para eles. Quando o robô clássico é excluído, o robô moderno assume sua posição e executa as versões modernas recém-criadas e adicionadas dos mesmos processos, sem alteração na experiência do usuário.

Importante:

Se um robô clássico existir com o mesmo domain/username que um usuário em uma pasta moderna, o usuário terá acesso apenas ao robô clássico e processos relacionados. Para o robô assistido funcionar em um contexto moderno, o robô flutuante clássico deve ser desativado. Após a migração ser testada e selecionada com sucesso, o robô clássico pode ser excluído com segurança.

Migração assistida usando o Orchestrator Manager

Para simplificar o processo de migração para pastas modernas, você pode usar o UiPath Orchestration Manager1. Esse é um projeto do Studio que usa a API do Orchestrator para manipular entidades com base em pastas de trabalho do Microsoft Excel. Para obter instruções sobre como usá-la para migração, consulte a documentação do produto.