Scripts de cliente

Os client scripts permitem que o sistema execute o 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.

Use client scripts para configurar formulários, campos de formulário e valores de campos enquanto o usuário está usando o formulário. Os client scripts podem:

• tornar os campos ocultos ou visíveis
• tornar os campos somente leitura ou graváveis
• tornar os campos opcionais ou obrigatórios com base na função do usuário
• definir o valor em um campo com base no valor em outros campos
• modificar as opções em uma lista de seleção com base na função de um usuário
• exibir mensagens com base em um valor em um campo

Aviso:

Os scripts de cliente têm como objetivo otimizar a experiência do usuário em um formulário. Os scripts de cliente não devem proteger o acesso indesejado aos dados.

Para impedir o acesso indesejado aos dados, certifique-se de que os campos confidenciais estejam ocultos ou sejam somente leitura por meio de ACLs ou políticas de dados.

Para mais informações, confira Access Control List Rules ou Data policy.

Onde os client scripts são executados

Com exceção dos client scripts onCellEdit(), os client scripts se aplicam somente a formulários e páginas de pesquisa. Se você criar um client script para controlar valores de campos em um formulário, deverá usar um desses outros métodos para controlar valores de campos quando estiver em uma lista.

• Crie um controle de acesso para restringir quem pode editar valores de campos.
• Crie uma regra de negócio para validar o conteúdo.
• Crie uma política de dados para validar o conteúdo.
• Crie um client script onCellEdit() para validar o conteúdo.
• Desabilite a edição de lista para a tabela.

Nota:

Client scripts não são compatíveis com aplicações ServiceNow Mobile.

Formulário de client script

Campo	Descrição
Nome	Nome do client script.
Tabela	Tabela à qual o client script se aplica.
Tipo de IU	Interface do usuário de destino à qual o client script se aplica.
Tipo	onLoad() — é executado quando o sistema renderiza o formulário pela primeira vez e antes que os usuários possam inserir dados. Normalmente, os client scripts onLoad() executam a manipulação do lado do cliente do formulário atual ou definem valores de registro padrão. onSubmit() — é executado quando um formulário é enviado. Normalmente, os scripts onSubmit() validam itens no formulário e garantem que o envio faz sentido. Um client script onSubmit() pode cancelar o envio do formulário retornando um valor falso. onChange() — é executado quando o valor de um campo específico muda no formulário. O client script onChange() deve especificar esses parâmetros. control: o widget DHTML cujo valor foi alterado. Nota: control não está acessível no portal móvel e de serviços. oldValue: o valor que o widget tinha quando o registro foi carregado. Nota: Valores antigos não são retornados para o tipo de campo HTML. newValue: o valor que o widget tem após a mudança. isLoading: identifica se a mudança ocorre como parte de um carregamento de formulário. isTemplate: identifica se a mudança ocorre como parte de um carregamento de modelo. onCellEdit() — é executado quando o editor de listas altera o valor de uma célula. O client script onCellEdit() deve especificar esses parâmetros. sysIDs: uma matriz de sys_ids para todos os itens que estão sendo editados. table: a tabela dos itens que estão sendo editados. oldValues: os valores antigos das células que estão sendo editadas. newValue: o novo valor das células que estão sendo editadas. callback: um retorno de chamada que continua a execução de quaisquer outros scripts de edição de célula relacionados. Se verdadeiro for passado como um parâmetro, os outros scripts serão executados ou a mudança será confirmada se não houver mais scripts. Se falso for passado como um parâmetro, nenhum script adicional será executado e a mudança não será confirmada.
Nome do campo	Nome do campo ao qual o script se aplica. Disponível somente se o script responder a uma mudança de valor de campo (tipos de script onChange ou onCellEdit).
Aplicação	Aplicação em que este client script reside.
Ativo	Habilita o client script quando selecionado. Desmarque este campo para desabilitar o client script.
Herdados	Indica se o client script se aplica a tabelas estendidas.
Global	Se verdadeiro, o client script será executado em todas as exibições da tabela.
Exibição	Visível somente quando Global está desmarcado. Exibições nas quais o client script será executado.
Descrição	Conteúdo que descreve a funcionalidade e a finalidade do client script.
Mensagens	Cadeia de caracteres de texto (uma por linha) disponível para o script do cliente como mensagens localizadas usando getmessage('[message]'). Para obter informações adicionais, consulte Traduzir uma mensagem de client script.
Script	Contém o client script.
Isolar script	Os novos client scripts são executados no modo estrito, com o acesso direto ao DOM desabilitado. O acesso ao jQuery, ao prototipo e ao objeto da janela também está desabilitado. Para desabilitar isso por script, configure este formulário e marque a caixa de seleção Isolar script. Para desabilitar este recurso para todos os novos scripts do lado do cliente com escopo global, defina a propriedade do sistema glide.script.block.client.globals como falsa.