Carregar scripts
Para usar scripts de cliente em um formulário, um script deve primeiro ser carregado como um recurso da Web de script. Você pode usar recursos da Web de script para manter bibliotecas de funções de script de cliente escritas em JavaScript ou TypeScript e usá-las em um formulário de aplicativo baseado em modelo ou na definição da barra de comandos. Se for usar TypeScript, você deverá transpilá-lo em JavaScript antes de carregá-lo como um recurso da Web.
Para carregar um recurso da Web de script, crie uma Biblioteca de Formulários no editor de formulários.
O pop-up Adicionar Biblioteca JavaScript aparecerá. Selecione + Novo recurso da Web no canto superior direito. No painel Novo recurso da Web, certifique-se de selecionar JavaScript (JS) como o tipo.
Para que os dados de uma coluna de tabela estejam disponíveis para inclusão na lógica de um script, certifique-se de ter configurado o formulário para exibir a coluna. Observe que, se alguém remover a coluna do formulário posteriormente, isso fará com que seu script seja interrompido porque a coluna referenciada não estará mais disponível. Você pode adicionar a coluna como uma dependência para garantir que os dados da coluna estejam sempre disponíveis para sua lógica de script. A imagem a seguir mostra a adição da coluna Idea Score da tabela Idea como uma dependência.
Dependências de recursos da Web
Além das dependências de dados, você também pode configurar dependências em outros recursos da Web. Essa dependência poupa tempo e simplifica a lógica de carregamento, pois o formulário não precisa carregar explicitamente vários recursos da Web dependentes quando você registra um script para um evento de formulário, comando da faixa de opções ou regras de ativação da faixa de opções. Com a configuração de dependência, você pode registrar o script principal e deixar a configuração de dependência carregar os outros recursos necessários ao seu código.
É importante observar que as dependências de recursos da Web não fornecem nenhum controle sobre a ordem de carregamento dos recursos da Web. Todos os recursos da Web são carregados de forma assíncrona e em paralelo. Se você tiver um recurso da Web JavaScript que dependa de outro recurso da Web JavaScript para ser carregado e inicializado de modo que possa ser inicializado, será necessário gerenciar essa dependência de outra maneira.
Usar bibliotecas de scripts de cliente
Depois de configuradas como um recurso de script da Web, as bibliotecas de script de cliente podem ser associadas a comandos da faixa de opções e eventos de formulário. Para associar um script a um formulário, selecione Bibliotecas de formulários na barra de ferramentas e, depois, Adicionar biblioteca.
Na caixa de diálogo Adicionar biblioteca, você pode associar um recurso da Web de script carregado existente ou criar um novo.
A associação da biblioteca de scripts ao formulário só é necessária uma vez por script para cada formulário, independentemente de quantos manipuladores de eventos você registrar nesse formulário.
Se precisar fazer alterações à medida que cria a lógica do script de cliente após o carregamento inicial, retorne ao recurso da Web de script na solução e carregue a nova versão do arquivo. Após o upload, você deve publicar o recurso da Web do script para que o aplicativo use as alterações mais recentes.