Sobre a compatibilidade com o Windows - Legado

Migre e gerencie projetos de compatibilidade do Windows-Legacy no Studio após a introdução de tipos de projeto baseados no.NET em 2021.10.

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.

Benefícios da conversão de projetos Windows - Legacy para a compatibilidade Windows

A compatibilidade padrão para novos projetos agora é o Windows. Embora continuemos a oferecer suporte à compatibilidade com o Windows - Legado, novas funcionalidades só estarão disponíveis em projetos com compatibilidade com o 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.
• Autopilot capabilities.
• Modelo de processo de negócios e Notation por meio de fluxos de trabalho de longa duração.
• Soluções.

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 continuar a criar projetos do Windows - Legado

Embora você só possa criar novos projetos com a compatibilidade com o Windows ou multiplataforma a partir da visualização Backstage, as organizações ainda podem usar políticas de governança para restaurar a opção de criação de projetos do Windows - Legado definindo a configuração Estruturas de compatibilidade permitidas. Para fazer isso:

1. Navegue até Automation Ops™ > Governança.
2. Defina uma nova política de governança do Studio.Certifique-se de usar a versão 24.10.0 Modelo de política do Studio.
3. Na janela de política de governança, selecione a aba Design e role até a seção Estilo de Design.
4. Habilite a configuração Estruturas de compatibilidade permitidas e selecione a estrutura de destino Windows - Legacy.
5. Salve e implante a política de governança.

Para saber mais, consulte Configurações das políticas do Studio no manual do Automation Ops.

Alternativamente, você pode definir a configuração usando o modelo de governança baseado em arquivo:

1. Gere um arquivo de governança JSON a partir do Studio.
2. Localize a configuração AllowedProjectFrameworks dentro do arquivo de governança.
3. Defina o valor do parâmetro Clássicocomo Verdadeiro.
4. Salve e implante o arquivo de governança.

Para saber mais, consulte Governança no manual do Studio.

Para se manter atualizado com as próximas alterações, consulte Linha do tempo de descontinuações.

Como editar projetos existentes do Windows - Legado

Editar, publicar e executar projetos do Windows - Legado continuarão a ser compatíveis com versões futuras. Projetos do Windows - Legado são abertos em uma nova instância do Studio Legado dedicada para projetos do Windows - Legado. Essa instância do Studio Legado permite editar, publicar e converter projetos do Windows - Legado para compatibilidade com o Windows.

Observação:

A instância do Studio Legado não está disponível para o Lançamento Contínuo do Studio, Suporte de Curto Prazo (STS). O STS do Studio não permite atualmente a criação ou edição de projetos do Windows - Legado.

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 a 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 pelo 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.
• Namespaces que são diferentes no Windows
  • Projetos legados e do 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.

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

1. Abra o projeto do Windows - Legado no Studio e abra-o apenas em uma instância do Studio.
2. Abra o menu de contexto para o nó do projeto no painel Projeto e selecione Converter para Windows. Uma nova janela é exibida.

3. 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 criar o projeto. O novo projeto leva o nome do projeto antigo + _Windows.
   • 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.
4. Selecione 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 Explorador de Pacotes NuGet pode ser usado para inspecionar frameworks de destino .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.	{} para new Object() {}new Object() {task_output.Id.ToString,task_action,now,I_comment }para 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: {} para 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).