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 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. Quando você abre um projeto existente do Windows - Legado, uma mensagem é exibida na parte superior da janela.

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.

Restrições conhecidas

• As seguintes 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:

  Windows - Sintaxe legada	Sintaxe do Windows
  {}	new Object() {}
  {task_output.Id.ToString,task_action,now,I_comment}	new Object() {task_output.Id.ToString,task_action,now,I_comment }

• Para resolver erros de validação gerados por outras expressões que funcionavam 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.