Scripts da IU

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Os scripts de IU fornecem uma maneira de empacotar o JavaScript do lado do cliente em um formulário reutilizável, semelhante à forma como as inclusões de script armazenam o JavaScript do lado do servidor. Os administradores podem criar scripts de IU e executá-los a partir de scripts de cliente e outros objetos de script do lado do cliente e do código HTML.

    Scripts de IU não são compatíveis com dispositivos móveis.

    Scripts de IU globais

    Você pode criar um script de IU e designá-lo como global, o que torna o script disponível em qualquer formulário no sistema. Você não pode criar um script de IU global em uma aplicação com escopo.

    Você pode marcar um script de IU como Global para disponibilizá-lo em qualquer formulário no sistema. Por exemplo, você pode criar um script de IU que tenha uma função HelloWorld() e tem Global campo verificado:

    function helloWorld() {
      alert('Hi');
    }

    Depois de criar este script de IU global, você pode chamar o. HelloWorld() Função a partir de qualquer script de cliente ou política de IU que você escrever.

    Crie um script de IU

    Crie um script de IU para definir código JavaScript reutilizável do lado do cliente.

    Procedimento

    Para criar scripts de IU, navegue até IU do Sistema > Scripts da IU e criar ou editar um registro (consulte a tabela para obter descrições dos campos).
    Tabela 1. Scripts da IU
    Campo Descrição
    Nome do script Nome do script de IU. Certifique-se de que o nome seja exclusivo em seu sistema.
    Nome da API O nome da API do script de IU, incluindo o escopo e o nome do script (por exemplo, x_custom_app.HelloWorld).
    Aplicação Aplicação que contém o script de IU.
    Ativo Indicador que indica se o script de IU está ativo. Scripts de IU ativos podem ser executados.
    Global

    Indicador que indica se o script é carregado em todas as páginas do sistema.

    Nota:
    Tenha cuidado ao criar scripts de IU globais, pois eles podem afetar o desempenho. Você não pode criar um script de IU global em uma aplicação com escopo.
    Descrição Resumo da finalidade do script.
    Script Script do lado do cliente a ser executado quando chamado de outros scripts.

    Executar scripts de IU

    Siga estas diretrizes ao executar scripts de IU.

    Execute um script de IU a partir de um formulário

    Para executar um script de IU em um formulário, Crie um formatador e adicione-o a um formulário . No associado Macro de IU , incluir um g: requer marque e especifique name=Parâmetro como o nome do script de IU seguido pela extensão .jsdbx. Adicione o formatador na exibição do formulário.

    Este código garante que as definições e os resultados do script de IU estejam disponíveis imediatamente no navegador.

    <?xml version="1.0" encoding="utf-8" ?>  
    <j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">  
        <g2:evaluate var="jvar_stamp">  
            var now_GR = new GlideRecord('sys_ui_script');  
            gr.orderByDesc('sys_updated_on');  
            gr.query();  
            gr.next();  
            gr.getValue('sys_updated_on');  
        </g2:evaluate>  
        <g:requires name="<UI SCRIPT NAME>.jsdbx" params="cache=$[jvar_stamp]" />  
    </j:jelly>

    Chame um script de IU em HTML

    Para executar um script de IU a partir do código HTML, use ]]>marque e especifique origem Argumento como o nome da API do script de IU seguido pela extensão .jsdbx. Por exemplo, inclua o script de IU chamado CoolClock com este código:

    <script language="javascript" src="CoolClock.jsdbx" />

    Chame um script de IU do código do lado do cliente

    Acesse scripts de IU de dentro do código do lado do cliente usando g_ui_scripts objeto global. Para obter mais informações, consulte GlideUISscripts - Cliente.

    Nota:
    Esta classe não é compatível com scripts de IU com Global campo definido como verdadeiro.