Scripts de cliente

Os scripts de cliente permitem que o sistema execute 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 scripts de cliente para configurar formulários, campos de formulário e valores de campo enquanto o usuário estiver usando o formulário. Scripts de cliente podem:

• oculte ou fique visível os campos
• tornar os campos somente leitura ou graváveis
• torne os campos opcionais ou obrigatórios com base na função do usuário
• defina o valor em um campo com base no valor em outros campos
• modifique as opções em uma lista de seleção com base na função de um usuário
• exiba mensagens com base em um valor em um campo

Aviso:

Os scripts de cliente são destinados a otimizar a experiência do usuário em um formulário. Scripts de cliente não são destinados a proteger o acesso indesejado aos dados.

Para impedir o acesso indesejado aos dados, certifique-se de que os campos confidenciais estejam ocultos ou 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 scripts de cliente são executados

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

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

Nota:

Scripts de cliente não são compatíveis com ServiceNow Mobile aplicações.

Formulário 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 script do cliente 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, OnLoad() os scripts de cliente 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, OnSubmit() os scripts validam itens no formulário e garantem que o envio faça sentido. Um OnSubmit() o client script pode cancelar o envio do formulário retornando um valor falso. Onchange() - é executado quando um valor de campo específico muda no formulário. . Onchange() o client script deve especificar esses parâmetros. controlO widget DHTML cujo valor foi alterado. Nota: control não está acessível no dispositivo móvel e no portal 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. isLoadingidentifica se a mudança ocorre como parte de um carregamento de formulário. isTemplateidentifica se a mudança ocorre como parte de um carregamento de modelo. OnCellEdit() - é executado quando o editor de lista muda o valor de uma célula. . OnCellEdit() o client script 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. callbackum retorno de chamada que continua a execução de qualquer outro script de edição de célula relacionado. Se verdadeiro passado como um parâmetro, os outros scripts são executados ou a mudança é confirmada se não houver mais scripts. Se falso é passado como um parâmetro, todos os scripts adicionais não são executados e a mudança não é 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 script do cliente será executado em todas as exibições da tabela.
Exibição	Visível somente quando Global não está selecionado. 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 Traduza uma mensagem de client script .
Script	Contém o client script.
Isolar script	Novos client scripts são executados no modo estrito, com o acesso direto ao DOM desabilitado. O acesso ao jQuery, ao protótipo e ao objeto window também estão desabilitados. Para desabilitar isso por script, configure este formulário e selecione Isolar script caixa de seleção. Para desabilitar esse 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.