Sobre a compatibilidade com o Windows - Legado

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

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, Suporte de curto prazo (STS) - fornece atualizações frequentes e novos recursos enquanto mantém 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, Suporte de curto prazo (STS) 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.			Lançamento contínuo, Suporte de curto prazo (STS) Cada versão é suportada até a próxima atualização.	A cada dois meses.

O Studio LTS permite criar, abrir e editar projetos do Windows - Legacy para o futuro previsível. A opção de criar projetos do Windows - Legacy pode ser habilitada por meio de políticas de governança.

O Studio STS não permite mais a criação ou edição de projetos do Windows - Legacy.

Benefícios da conversão de projetos Windows - Legacy para a compatibilidade 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 Windows ou multiplataforma desbloqueia inovações futuras e prepara você para a visão de Automação por agentes da UiPath, apresentando:

• Robôs que lidam de forma eficiente com tarefas estruturadas e baseadas em regras.
• Agentes com 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.

A Automação por agentes permite que você automatize processos mais complexos, aproveitando a tomada de decisão orientada por IA em sistemas empresariais.

Acesse novos recursos

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

• Suporte para a criação de variáveis e constantes globais no Gerenciador de dados.
• 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 Notation por meio de fluxos de trabalho de longa duração.

Desempenho e escalabilidade aprimorados

Projetos do Windows e multiplataforma:

• São compilados e proporcionam melhorias significativas de desempenho, reduzindo o tempo de execução para automações.
• São ideais para cenários de automação em larga escala com altos volumes de transações.
• Apresentam gerenciamento de memória moderno 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 a resolução rápida de vulnerabilidades, minimizando riscos.

Dívida técnica reduzida

• A conversão de projetos do Windows-Legacy remove a dependência de bibliotecas descontinuadas e tecnologias desatualizadas.
• Atualizações e aprimoramentos futuros serão mais fáceis e mais econômicas.
• Os fluxos de trabalho modernos são mais fáceis de depurar, escalonar e adaptar às necessidades de negócios em evolução.

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 nos quais eles estão instalados como dependências.
• Os Serviços Web SOAP não são compatíveis com projetos Windows e multiplataforma. Você só pode usar essa integração em projetos Windows - Legacy.

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 - Legacy, selecione Criar um novo projeto. Insira o local onde deseja criar o 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.

Cenários de migração de bibliotecas legadas

Consulte os cenários abaixo ao migrar bibliotecas legadas:

1. Biblioteca legada criada com o Studio (código-fonte disponível): migre a biblioteca primeiro, publique-a e, em seguida, migre o processo.
2. Biblioteca .NET com destino ao .NET Framework (código-fonte disponível): para bibliotecas .NET, altere o destino para .NET. Você pode:

   • Verificar a versão compatível do .NET Studio (por exemplo, o Studio 24.10.X é executado no .NET 8).

   • Alvo múltiplo para oferecer suporte ao .NET Framework e ao .NET.

   • Use variantes para a versão do .NET. Os alvos net6.0-windows são compatíveis apenas com projetos do Windows, enquanto net6.0 é compatível com o Windows e projetos multiplataforma.
   Observação: consulte os seguintes recursos:

   • Criação de atividades com código no guia do SDK.
   • Migração de atividades para . NET 6 no guia do SDK.
   • Referência do MSBuild para . Projetos do SDK .NET.

3. Biblioteca de terceiros legada (código-fonte não disponível): substitua as atividades usando alternativas recomendadas pela UiPath.

Blueprint para converter projetos do Windows - Legacy

Este guia passo a passo tem como objetivo ajudar você a fazer a transição suave de suas automações do Windows-Legacy para o Windows.

1. Inventário e avaliação - Prepare um inventário detalhado de todos os seus projetos do Windows - Legacy e suas dependências:
   • Liste todos os projetos, bibliotecas e dependências.
   • Avalie a compatibilidade com o ambiente do Windows (.NET).
   • Identifique componentes que precisam de atualizações ou substituições.
   Observação: o aplicativo NuGet Package Explorer pode ser usado para inspecionar os componentes. 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 uma dependência.
   • Execute uma conversão piloto para identificar desafios e bloqueadores.
   • Valide o resultado com testes.
   Dica:

   • Crie um backup do projeto e da biblioteca do Windows - Legacy.
   • 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 do Windows - Legacy.
3. Escalonamento- 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 esperado:
   • Realizar testes.
   • Aborde erros ou problemas de compatibilidade iterativamente.
   • Teste as 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:
   • Implante fluxos de trabalho na produção.
   • Monitore problemas de estabilidade e desempenho.
   • Forneça treinamento do usuário ou documentação atualizada, se necessário.
6. Monitoramento pós-migração - Relate para a UiPath problemas de migração 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 sucesso um projeto Windows - Legacy 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 operavam antes da conversão.	Corte a expressão usando o atalho de 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 antigas do pacote de atividades IntelligentOCR, certifique-se de atualizar para a versão mais recente do pacote 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 inferência de tipo mais rigorosa em comparação com as versões mais antigas. Converta a matriz ou o elemento para o tipo desejado, por exemplo: {} de new Object() {} <object>.ToString() CType(<element>, Object)
Operações sensíveis à codificação	Adicione System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance) usando o InvokeMethod.
“ (0x201C) versus " (0x22)	Substitua todas as instâncias por " (0x22), que é o único caractere de aspas válido 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 de Visão Computacional.
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 (Recortar ou Ctrl + X). Clique fora da atividade. Adicione a configuração novamente (Colar ou Ctrl + V).
Os Serviços Web SOAP não são compatíveis com projetos Windows e multiplataforma. Você só pode usar esta integração em projetos do Windows - Legacy