Sobre a compatibilidade com o Windows - Legado

O Studio 2021.10 trouxe suporte a projetos baseados no .NET e introduziu o conceito de compatibilidade de projetos com base no tipo de robô. Em versões anteriores à 2021.10, todos os projetos usavam a compatibilidade com o Windows - Legado. A partir do Studio 2021.10 até o Studio 2024.10, você tinha a opção de criar projetos com as compatibilidades com o Windows e multiplataforma, além do Windows - Legado.

Os usuários do Automation Cloud podem escolher entre:

• Studio LTS – Fornece estabilidade a longo prazo com um ciclo de lançamento anual.

• Lançamento contínuo do Studio – Oferece atualizações frequentes e novos recursos, mantendo a confiabilidade.

Para saber mais, consulte a página de termos de suporte ao ciclo de vida do produto.

A tabela abaixo destaca as principais diferenças entre as duas versões do Studio:

Versão do Studio	Público-alvo	Requisito de conexão de nuvem	Windows – Suporte para legado	Modelo de suporte	Ciclo de lançamento
Studio LTS Ano do Studio.10. Patch Por exemplo: 2024.10.8	Usuários Enterprise que precisam de suporte de longo prazo, estabilidade e suporte para Windows – Legado. Pode ser usado para conexões no local e na Automation Cloud/Automation Suite.			Suporte em longo prazo (LTS) 2 meses de suporte básico + 12 meses de suporte estendido.	Uma vez por ano.
Lançamento contínuo do Studio Ano do Studio.0. Patch Por exemplo: 2025.0.157	Usuários que desejam atualizações frequentes e novos recursos e, ao mesmo tempo, manter a confiabilidade. Só pode ser usado com conexões do Automation Cloud.			Suporte de versão contínuo Cada versão é suportada até a próxima atualização.	A cada dois meses.

O Studio LTS continuará a permitir a abertura e edição de projetos Windows – Legado no futuro previsto.

A versão contínua do Studio não permite mais a criação ou edição de projetos Windows – Legado.

O Studio LTS mais recente que permite a criação de projetos Windows – Legado é o Studio 2024.10. Essa opção pode ser habilitada por meio de políticas de governança.

Benefícios da conversão de projetos do Windows - Legado para a compatibilidade com o Windows

A compatibilidade padrão para novos projetos agora é Windows. A criação e edição de projetos com a compatibilidade com Windows – Legacy não é mais suportada, o que significa que novas funcionalidades só estarão disponíveis em projetos com as compatibilidades com Windows e multiplataforma.

Usar as compatibilidades com o Windows ou multiplataforma desbloqueia futuras inovações e prepara você para a visão da UiPath Agentic Automation , com:

• Robots que lidam com eficiência com tarefas estruturadas e baseadas em regras.
• Agentes alimentados por IA que processam dados não estruturados e tomam decisões inteligentes.
• Humanos que validam e supervisionam fluxos de trabalho de automação críticos.

Agentic Automation permite que você automatize processos mais complexos, aproveitando a tomada de decisões orientada por IA em todos os sistemas corporativos.

Acesse novos recursos

Os projetos para Windows e multiplataforma oferecem acesso a recursos de próxima geração que não estão disponíveis no Windows - Legado, incluindo:

• Suporte à criação de variáveis e constantes globais no Data Manager.
• Nova experiência de design disponível para projetos multiplataforma e algumas atividades em projetos do Windows.
• A capacidade de personalizar o layout de atividades geradas a partir de bibliotecas.
• Automações codificadas.
• Recursos do Autopilot™ .
• Modelo de processo de negócios e modelagem de notação por meio de fluxos de trabalho de longa duração.

Desempenho e escalabilidade aprimorados

Projetos do Windows e multiplataforma:

• São compilados e fornecem melhorias significativas de desempenho, reduzindo o tempo de execução de automações.
• São ideais para cenários de automação em larga escala com altos volumes de transações.
• Apresenta gerenciamento moderno de memória e compilação Just-In-Time (JIT).

Segurança aprimorada

• O .NET inclui os algoritmos de criptografia e protocolos de segurança mais recentes para proteger dados confidenciais.
• A manutenção ativa garante uma resolução rápida das vulnerabilidades, minimizando os riscos.

Dívida técnica reduzida

• A conversão de projetos do Windows-Legado remove a dependência de bibliotecas obsoletas e tecnologias desatualizadas.
• Atualizações e aprimoramentos futuros serão mais fáceis e barato.
• Os fluxos de trabalho modernos são mais fáceis de depurar, dimensionar e adaptar à evolução das necessidades de negócios.

Como converter projetos do Windows-Legado para compatibilidade com o Windows

Importante: as dependências para as quais não são encontradas versões com compatibilidade com o Windows são marcadas como não resolvidas, e a versão usada no projeto do Windows - Legado é exibida no painel Projeto após a conversão. A maioria dos pacotes de atividades desenvolvidos pela UiPath e disponíveis no feed oficial suportam a compatibilidade com o Windows. Para obter uma lista completa, consulte os Guias de atividades.

O Studio vem com uma ferramenta de conversão integrada que habilita você a converter qualquer projeto do Windows - Legado para o Windows.

Quando você converte um projeto para o Windows:

• As dependências do projeto são gerenciadas com base nas seguintes regras:
  • Se a mesma versão do pacote existir nas origens do pacote configuradas, a versão usada no projeto do Windows - Legado não é alterada.
  • Se a mesma versão do pacote não existir, a versão usada no projeto do Windows - Legado será alterada para o patch mais alto da versão mais próxima.
• Todas as atividades e propriedades são preservadas no projeto convertido.
• Os namespaces que são diferentes nos projetos do Windows - Legado e Windows são atualizados.

• Os namespaces que são necessários em projetos do Windows são adicionados e aqueles usados apenas em projetos do Windows - Legado são removidos.

  Observação: converta e republique bibliotecas do Windows - Legado antes de converter os processos onde eles estão instalados como dependências.

Para converter um projeto do Legado para a compatibilidade com o Windows:

1. Abra o projeto do Windows - Legado no Studio e certifique-se de que você o abra apenas em uma instância do Studio. Uma nova janela é exibida.

   
   

   

   
   

2. Selecione como converter:

   • Para criar uma cópia do projeto atual usando a compatibilidade com o Windows e manter o projeto original do Windows - Legado, selecione Criar um novo projeto. Digite o nome, o local onde criar e, opcionalmente, uma descrição para o novo projeto.
   • Para atualizar o projeto existente e convertê-lo para a compatibilidade com o Windows, desmarque a caixa de seleção Criar um novo projeto. As alterações feitas no projeto se você selecionar essa opção não podem ser desfeitas.
3. Clique em Converter.

Se problemas de dependência causarem atividades não resolvidas após a conversão, uma mensagem exibida no topo de cada atividade indica que está faltando ou não pode ser carregada.As seguintes informações estão disponíveis para cada um: nome de exibição, namespace da atividade, propriedades e valores da atividade. Clique em Substituir para encontrar uma alternativa e substituir a atividade ausente ou inválida. Para obter mais informações, consulte Atividades ausentes ou inválidas.

Modelo para conversão de projetos do Windows - Legado

Este guia passo a passo tem por objetivo ajudar você a fazer a transição sem problemas de suas automações do Windows - Legado para o Windows.

1. Inventário e avaliação - Prepare um inventário detalhado de todos os seus projetos do Windows - Legado e suas dependências:
   • Liste todos os projetos, bibliotecas e dependências.
   • Avalie a compatibilidade com o ambiente do Windows (.NET).
   • Identificar componentes que precisam de atualizações ou substituições.
   Observação: o aplicativo NuGet Package Explorer pode ser usado para inspecionar estruturas de destino do .NET.
   
   
   
   
   
2. Prova de conceito - Teste o processo de conversão em um pequeno subconjunto de fluxos de trabalho:
   • Selecione um fluxo de trabalho representativo que tenha uma biblioteca adicionada como dependência.
   • Realize uma conversão-pilotagem para identificar desafios e bloqueadores.
   • Valide o resultado com testes.
   Dica:

   • Crie um backup do projeto e da biblioteca do Windows - Legado.
   • Não altere o nome do projeto ou biblioteca durante a migração.
   • Migre a biblioteca primeiro e publique-a. Não se preocupe — a versão migrada da biblioteca não pode ser usada em projetos Windows - Legado.
3. Dimensionamento - Converta todos os projetos e bibliotecas sistematicamente:
   • Migre todas as bibliotecas e publique-as.
   • Migre todos os projetos.
4. Validação e testes - Certifique-se de que os fluxos de trabalho convertidos funcionem conforme pretendido:
   • Realize testes.
   • Resolva erros ou problemas de compatibilidade iterativamente.
   • Testar interações com sistemas externos e fontes de dados.
5. Implantação de produção - transição do projeto para o ambiente de produção:
   • Implantar fluxos de trabalho na produção.
   • Monitorar problemas de estabilidade e desempenho.
   • Forneça treinamento de usuários ou documentação atualizada, se necessário.
6. Monitoramento pós-migração - Relate problemas de migração ao UiPath para melhorias futuras:
   • Envie feedback.
   • Compartilhe desafios ou soluções com representantes da UiPath.

Problemas conhecidos

Issue	Solução
Algumas expressões são incompatíveis com projetos do Windows e precisam ser alteradas manualmente para converter com êxito um projeto Windows - Legado para Windows.	{} de new Object() {} new Object() {task_output.Id.ToString,task_action,now,I_comment } de new Object() {task_output.Id.ToString,task_action,now,I_comment }
Erros de validação gerados por outras expressões que funcionavam antes da conversão.	Recorte a expressão usando o atalho do teclado CTRL + X e cole-a de volta no campo de atividade usando CTRL + V.
Em uma atividade For Each, nomear a variável cujos valores você deseja iterar como “expressão” resulta em um erro de compilação.	Evite nomear a variável "expression".
Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.	Após converter um projeto que continha versões mais antigas do pacote de atividades do IntelligentOCR, certifique-se de atualizar para a versão mais recente do pacote do IntelligentOCR.
BC36915: Cannot infer an element type because more than one type is possible. Specifying the type of the array might correct this error. BC30512: Option Strict On disallows implicit conversions from 'Object()' to 'String()'. The selected value is incompatible with the property type. BC36914: Cannot infer an element type, and Option Strict On does not allow 'Object' to be assumed. Specifying the type of the array might correct this error.	As linguagens de programação modernas impõem uma inferência de tipos mais rigorosa em comparação com as versões mais antigas. Converta o array ou o elemento para o tipo desejado, por exemplo: {} de new Object() {} <object>.ToString() CType(<element>, Object)
Operações sensíveis à codificação	Adicionar System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance) usando InvokeMethod.
“ (0x201C) vs. " (0x22)	Substitua todas as instâncias por " (0x22), que é a única aspa válida para literais de string no .NET moderno.
BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.	Remova e adicione novamente os argumentos da atividade do Computer Vision.
BC31424: Type ‘System.Data.DataTable' in assembly ‘…’ has been forwarded to assembly 'System.Data.Common’ … BC30652: Reference required to assembly ‘System.Collections’ … containing the type 'List(Of )'. Add one to your project. BC30057: Too many arguments to 'Public Overloads Property SpecificContent As Dictionary(Of String, Object)'.	Para corrigir esses erros de validação: Navegue até as propriedades da atividade que contêm os erros. Remova a configuração (Cut ou Ctrl + X). Clique fora da atividade. Adicione a configuração de volta (Colar ou Ctrl + V).