Scripts da IU

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 disponibiliza o script 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 oláMundo()e tenha o campo Global marcado:

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

Depois de criar este script de IU global, você pode chamar a função oláMundo() de qualquer script de cliente ou política de IU que você escrever.

Criar um script de IU

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

Procedimento

Para criar scripts de IU, navegue até IU do Sistema > Scripts da IU e crie ou edite um registro (consulte a tabela para obter as 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.OláMundo).
Aplicação	Aplicação que contém o script de IU.
Ativo	Indicador que indica se o script de IU está ativo. Somente 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 porque 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.

Executar 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. Na macro de IUassociada, inclua um marcador g:requires e especifique o parâmetro name= como o nome do script de IU seguido pela extensão .jsdbx. Adicione o formatador na exibição de formulário.

Este código garante que as definições e os resultados do script de IU estejam imediatamente disponíveis 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>

Chamar um script de IU em HTML

Para executar um script de IU a partir do código HTML, use o <![CDATA[<script> ]]> e especifique o argumento src= como o nome da API do script de IU, seguido pela extensão .jsdbx. Por exemplo, inclua o script de IU chamado LegalClock com este código:

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

Chamar um script de IU a partir do código do lado do cliente

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

Nota:

Esta classe não oferece suporte a scripts de IU com o campo Global definido como verdadeiro.