Scripts de cliente

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • 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

    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.