Migrando aplicativos legados para expressões VB

Um aplicativo legado é um aplicativo que foi criado antes da introdução da linguagem de expressão VB ou que usa a linguagem de expressão legada.

O processo de migração leva o aplicativo legado como entrada e gera uma cópia do aplicativo legado projetado com expressões VB.

Para migrar um aplicativo legado para expressões VB:

Abra o aplicativo legado desejado.
Na barra de ferramentas superior, clique em Migrar para VB. Uma mensagem de pop-up informa a você sobre o resultado da migração.
Selecione Continuar para migrar. Uma mensagem do sistema informa a você sobre o andamento da migração.
Verifique o painel de notificação para ver se o aplicativo foi migrado com sucesso.

O aplicativo migrado é exibido na guia Compilar , com a seguinte sintaxe de nome: app_name + carimbo de data/hora da migração.

Importante:

Após a migração, o novo aplicativo VB pode exibir erros. Esses erros são causados pela incompatibilidade entre as expressões legadas e o VB.

Para tornar seu aplicativo funcional, passe por cada erro e ajuste manualmente a expressão para atender aos requisitos do VB.

Recursos migrados

A lista a seguir resume quais recursos do Apps são migrados do legado para a linguagem de expressão VB. Nem todos os recursos são persistidos e podem precisar de correções manuais. Para ajudar você a reescrever a expressão legada na linguagem VB, o algoritmo de migração fornece uma string de orientação.

Páginas, controles, layouts do aplicativo

Todas as páginas, controles e layouts de aplicativos construídos dentro da linguagem de expressão legada são migrados para sua instância relacionada em expressões VB.

Alguns controles e elementos são migrados de forma diferente:

File picker: Migrado como Downloader de arquivos, se o controle do Seletor de arquivos for usado como Apenas download.
Caso contrário, o controle do Seletor de arquivos será migrado como Carregador de arquivos.
Associação de valor: A Associação de valor não é suportada em expressões VB.
Contexto dos dados: O contexto de dados não é suportado em expressões VB.

Observação:

A propriedade OrigemDeDados é migrada como vazia para vários controles, como Tabela, Lista suspensa ou Lista. Use o Construtor de Consultas para reconstruir a expressão.

Expressions

Todas as expressões literais são migradas totalmente. Uma expressão literal é um valor inserido diretamente pelos usuários.

Expressões complexas, como Lookup, são substituídas por uma string que serve de orientação na construção da nova expressão VB.

Integrações com o Apps

Todas as integrações, como processos, filas ou buckets de armazenamento, são totalmente migradas.

Podem ocorrer erros se um nome de integração não respeitar elementos VB. O algoritmo de migração renomeia o elemento em seu nome.

Variáveis do Apps

Durante a migração, as variáveis são definidas para tipos de dados de strings, independentemente de seu tipo de dados original.

Podem ocorrer erros para variáveis que têm outros tipos de dados além de strings atribuídas. Nesses casos, as correções manuais são necessárias.

Certifique-se de que os nomes das variáveis respeitam os elementos VB.

Associações diretas

Uma vinculação direta é um vínculo entre apenas dois elementos. Por exemplo, em um aplicativo legado, a propriedade Associação de valor de um controle de Caixa de texto ou o campo Bucket de armazenamento da regra Carregar arquivo no compartimento de armazenamento .

As associações de página cruzada estão obsoletas na linguagem de expressão VB e, portanto, esses tipos de associações não são migrados. Um erro é exibido para elementos que têm associação de página cruzada, com uma string de orientação para ajudar você a reescrever a expressão.

Todas as expressões simples nas propriedades de controle, como Necessário, Somente leitura ou Oculto, são migradas.

Regras do aplicativo

Todas as regras que contêm associações diretas são migradas. Expressões complexas são removidas ou convertidas para uma string de guia.

A imagem a seguir compara a configuração da regra Definir valores antes (imagem 1) e após (imagem 2) migrar para expressões VB:

Algumas regras são migradas de forma diferente:

Criar/atualizar entidade: A regra é migrada como a regra Criar entidade . As expressões nesta regra não são preservadas, portanto, é necessário reconfigurar a regra.
Definir Valores: Se a regra tiver vários itens no campo Itens a serem definidos , eles serão migrados como regras definidas de valores separadas.

As expressões nesta regra são substituídas por strings, que servem como orientação na construção da nova expressão VB.
If/else: A regra é migrada sem condições.