---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# API de client script - ServiceNow Fluent

# API de client script - ServiceNow Fluent {#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

A API Client Script inclui objetos que definem scripts de cliente \[sys_script_client\] que executam JavaScript no cliente (navegador da Web) quando ocorrem eventos baseados no cliente, como quando um formulário é carregado, após o envio do formulário ou quando um campo muda de valor.

## Objeto ClientScript {#ariaid-title2}

Crie um client script \[sys_script_client\] para configurar formulários, campos de formulário e valores de campos enquanto o usuário está usando o formulário.
{#client-script-object-now-ts__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| $id | Cadeia de caracteres ou número | Obrigatório. Um ID exclusivo para o objeto de metadados fornecido no seguinte formato, em que\<value\> é uma cadeia de caracteres ou um número. $id: Now.ID[<value>] Quando você cria a aplicação, esse ID é convertido em um sys_ID exclusivo. |
| tabela | Cadeia de caracteres | Obrigatório. O nome da tabela na qual o client script é executado. |
| nome | Cadeia de caracteres | Obrigatório. O nome do client script. |
| ativo | Booliano | Sinalizador que indica se o client script está habilitado. Valores válidos: * verdadeiro: o script está habilitado. * falso: o script não está habilitado. {#client-script-object-now-ts__ul_cxj_srr_4bc} Padrão: verdadeiro |
| aplica-se_estendido | Booliano | Sinalizador que indica se o script do cliente se aplica a tabelas estendidas da tabela especificada. Valores válidos: * verdadeiro: o script se aplica a tabelas estendidas. * falso: o script não se aplica a tabelas estendidas. {#client-script-object-now-ts__ul_q5n_ltz_pbc} Padrão: falso |
| iu_type | Cadeia de caracteres | A interface do usuário à qual o client script se aplica. Valores válidos: desktop, mobile_or_service_portal, all Padrão: desktop |
| descrição | Cadeia de caracteres | Uma descrição da funcionalidade e da finalidade do client script. |
| mensagens | Cadeia de caracteres | Cadeias de caracteres de texto que estão disponíveis para o client script como mensagens localizadas usando getmessage('\[message\]'). Para obter mais informações, consulte [Traduzir uma mensagem de client script](https://www.servicenow.com/docs/access?context=t_TranslateAClientScriptMessage&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). |
| isolar_script | Booliano | Sinalizador que indica se os scripts são executados no modo estrito, com acesso ao DOM direto, jQuery, prototype e ao objeto de janela desativados. Valores válidos: * verdadeiro: isola o script e não o executa no modo estrito. * falso: execute o script no modo estrito. {#client-script-object-now-ts__ul_s1q_c5z_pbc} Padrão: falso |
| script | Script | Um script em linha precedido por um marcador de `script` no seguinte formato: script: script`gs.info('info')`, Nota: A importação de funções de módulos JavaScript ou bibliotecas de terceiros não é compatível com client scripts. |
| global | Booliano | Sinalizador que indica em quais exibições da tabela o client script é executado. Valores válidos: * verdadeiro: o script é executado em todas as exibições. * falso: o script é executado somente nas exibições especificadas. {#client-script-object-now-ts__ul_mvv_l5h_qbc} Padrão: verdadeiro |
| exibição | Cadeia de caracteres | As exibições da tabela na qual o client script é executado. Esta propriedade se aplica somente quando a propriedade global está definida como falsa. |
| tipo | Cadeia de caracteres | O tipo de client script, que define quando ele é executado. Para obter informações sobre os tipos compatíveis, consulte [Client scripts](https://www.servicenow.com/docs/access?context=client-scripts&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US). Valores válidos: onCellEdit, onChange, onLoad, onSubmit |
| Assunto: | Cadeia de caracteres | Um campo na tabela ao qual o client script se aplica. Esta propriedade se aplica somente quando a propriedade de tipo está definida como onChange ou onCellEdit. |
[Tabela 1. Propriedades]

{#client-script-object-now-ts__table_vy2_525_jq}  

    import { ClientScript } from '@servicenow/sdk/core'

    export const cs = ClientScript({
       $id: Now.ID['my_scripts'], 
       name: 'my_scripts',
       table: 'incident',
       active: true, 
       applies_extended: false, 
       global: true,
       ui_type: 'all', 
       messages: '', 
       isolate_script: false, 
       type: 'onLoad',
       script: script`function onLoad() { const x = 'util' g_form.addInfoMessage(x) }`,
    })