---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Scripts da IU

# Scripts da IU {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 ao modo 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 client scripts 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 {#ariaid-title2}

Você pode criar um script de IU e designá-lo como global, o que disponibiliza o script em qualquer formulário do 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 do sistema. Por exemplo, você pode criar um script de IU que tenha uma função oláMundo()e tenha o campo Global verificado:  

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

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

## Criar um script de IU {#ariaid-title3}

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 SistemaScripts da IU e crie ou edite um registro (consulte a tabela para obter as descrições dos campos).  
{#t_CreateAUIScript__table_zsc_z4z_sr__entry__2}

| 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.Hallow World). |
| 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. |
[Tabela 1. Scripts da IU]

{#t_CreateAUIScript__table_zsc_z4z_sr}

## Executar scripts de IU {#ariaid-title4}

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](https://www.servicenow.com/docs/access?context=t_CreateAFormatter&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Na [macro de IU](https://servicenow-prod.fluidtopics.net/dgFG18y~yGBcumzXueJ7Fw#c_UIMacros "Macros de IU são componentes discretos em script que os administradores podem adicionar à interface do usuário.")associada, 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 do 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 {#r_RunUIScripts__section_o5w_npl_d2b}

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 {#r_RunUIScripts__section_bs1_rpl_d2b}

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](https://servicenow-prod.fluidtopics.net/IFny1MsOF77V1Cp5ex2zfw#GUIScriptsAPI "A API GlideUIScripts fornece métodos para acessar scripts de IU de dentro do código do lado do cliente.").  
Nota:  
Esta classe não é compatível com scripts de IU com o campo Global definido como verdadeiro.