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 na estrutura de destino. Em versões anteriores à 2021.10, todos os projetos usavam o .NET Framework 4.6.1, mas desde o Studio 2021.10 você tem a opção de criar projetos com a compatibilidade com o Windows - Legado (.NET Framework 4.6.1) ou com as compatibilidades com o Windows e multiplataforma baseadas no .NET.

Os projetos do Windows - Legado não recebem novos recursos

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.

Por exemplo, os seguintes recursos introduzidos no Studio 2022.10 não estão disponíveis em projetos do Windows - Legado:

• 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.

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

A edição, publicação e execução de projetos do Windows - Legado continuarão a ser compatíveis em futuras versões, o que significa que você pode abri-los e editá-los como outros projetos do Windows e multiplataforma.

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.

2. Clique com o botão direito do mouse no 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 - 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.
4. 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).