---
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 de campo útil

# Scripts de campo útil {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Casos de uso comuns para scripts de personalização de campo.
Aviso:  
A personalização descrita aqui foi desenvolvida para uso em instâncias específicas e não é compatível com Now Support. Este método é fornecido no estado em que se encontra e deve ser testado cuidadosamente antes da implementação. Publique todas as perguntas e comentários sobre esta personalização no [fórum](http://community.service-now.com/) da nossa comunidade.

Para obter mais informações, consulte [Referência da API do servidor](https://servicenow-prod.fluidtopics.net/~ypnelBXD0eES~SR5L7q~Q "Use APIs de servidor em scripts para mudar a funcionalidade de aplicações ou ao criar novas aplicações.").

## Preencher um campo automaticamente {#r_UsefulFieldScripts__section_upr_nvx_mtb}

O exemplo a seguir mostra como usar um client script para preencher automaticamente uma Descrição Resumida com base na Subcategoriaselecionada.

Nesse caso, se a tabela tiver um registro com Subcategoria = Senha e Descrição resumida = Redefinição de senha. Quando o usuário seleciona a Subcategoria de Senha no formulário de Incidente, um client script pesquisa o registro correspondente e define a Descrição resumida como Redefinição de senha.  
Configurações de client script:

* Type = onChange
* Table name = incidente
* Field name = Subcategoria

{#r_UsefulFieldScripts__ul_ix3_hyx_mtb}

    function onChange(control, oldValue, newValue, isLoading){
        if(isLoading){return;}
        var newrec = gel('sys_row');
        //Check if new record
        if (newrec.value == -1) {
            var lookup = new GlideRecord('u_short_desc_lookup');
            lookup.addQuery('u_subcategory', g_form.getValue('subcategory'));
            lookup.query();
            var temp; //temp var - reusable
            if(lookup.next()){
                temp = lookup.u_short_description;
                if(null != temp) {
                    //Set the form value from lookup if there is a lookup value
                    g_form.setValue('short_description', temp);
                } else {
                    g_form.setValue('short_description',"");
                    }
              } else {
                  //If a lookup record does not exist based on lookup.addQuery
                  //Then set to UNDEFINED or NULL depending on type
                  g_form.setValue('short_description',"");
                  }
         }
    }

## Desabilitar marcadores HTML em descrições {#r_UsefulFieldScripts__section_o2z_kxx_mtb}

Este código desabilita os marcadores HTML nos campos Descrição e Descrição resumida, substituindo os marcadores por versões sem execução.

    doit();
     
    function doit(){ 
     var desc = current.description.toString();
     var shdesc = current.short_description.toString();
     if(desc.indexOf('script>')>-1|| shdesc.indexOf('script>')>-1){
       desc = desc.replace(/<script>/g,"(script)");
       current.description = desc.replace(/<\/script>/g,"(\/script)");
       shdesc = shdesc.replace(/<script>/g,"(script)");
       current.short_description = shdesc.replace(/<\/script>/g,"(\/script)");}
    }

## Eliminar espaços iniciais e finais em campos {#r_UsefulFieldScripts__section_kbd_gxx_mtb}

Este exemplo do script apara espaços à direita e à esquerda nos campos FirstName e LastName do sys_user.

    doit();
     
    function doit(){ 
      var now_GR =new GlideRecord('sys_user');
      gr.query();
      while(gr.next()){
        if((gr.first_name.toString().length!= gr.first_name.toString().trim().length)||(gr.last_name.toString().length!= gr.last_name.toString().trim().length)){
         gr.first_name= gr.first_name.toString().trim();
         gr.last_name= gr.last_name.toString().trim();
         gr.autoSysFields(false);
         gr.update();}}
    }

## Fazer um rótulo de campo piscar {#r_UsefulFieldScripts__section_lnv_swx_mtb}

O exemplo de client script a seguir é para o campo de número no incidente. O rótulo pisca por dois segundos.

    g_form.flash("incident.number","#FFFACD",0);

Os argumentos para o método flash são os seguintes:

* tablename.fieldname
* Cor RGB ou cor CSS aceitável, como "azul" ou "tomate"
* Número inteiro que determina por quanto tempo o rótulo pisca:
  * 2 para um flash de 1 segundo
  * 0 para um flash de 2 segundos
  * -2 para um flash de 3 segundos
  * -4 para um flash de 4 segundos
  {#r_UsefulFieldScripts__ul_xky_hdr_4x}
{#r_UsefulFieldScripts__ul_qh5_kgr_4x}  
Nota:  
Não especifique este argumento se quiser que o rótulo do campo seja colorido com a cor especificada.

## Tornar um rótulo de campo em negrito {#r_UsefulFieldScripts__section_y4k_xwx_mtb}

Este client script torna o rótulo de um campo específico em negrito. Nesse caso, o campo é a Descrição Resumida na Tabela de Incidentes.

    function onLoad(){
      var l = g_form.getLabel('incident.short_description');
      l.style.fontWeight = 'bold';}

## Tornar campos somente leitura {#r_UsefulFieldScripts__section_bhw_4vx_mtb}

Este client script onLoad torna os seguintes campos na tabela Incident \[incident\] somente leitura:

* Estado do incidente
* Impacto
* Urgência
* Prioridade
* Item de configuração
* Atribuído a
{#r_UsefulFieldScripts__ul_pbz_tzx_mtb}  
O script também remove a lupa dos Campos de referência somente leitura (Item de configuração e Atribuído a).

    function onLoad(){
    var incidentState = g_form.getValue('incident_state');
    if( incidentState == '6'|| incidentState == '7'){
       g_form.setReadonly('incident_state',true);
       g_form.setReadonly('impact',true);
       g_form.setReadonly('urgency',true);
       g_form.setReadonly('priority',true);
       g_form.setReadonly('cmdb_ci',true);
       g_form.setReadonly('assigned_to',true);}}

## Definir data/hora atual no campo {#r_UsefulFieldScripts__section_vpr_nvx_mtb}

Você pode definir valores de data e hora em client scripts e inclusões de script.

Script de cliente
:   Você pode usar as duas linhas a seguir para definir a data e a hora atuais em um campo de data/hora. Essa abordagem ignora o problema de obter o valor no formato e fuso horário apropriados.

        var ajax = new GlideAjax('MyDateTimeAjax');
          ajax.addParam('sysparm_name','nowDateTime');
          ajax.getXML(function(){
            g_form.setValue('put your field name here', ajax.getAnswer());});

:   Para obter mais informações sobre como executar scripts do lado do servidor com o cliente, consulte [GlideAjax](https://servicenow-prod.fluidtopics.net/M5ZNarV4DolhWDd2~K9JFg#p_AJAX "AJAX (JavaScript e XML assíncronos) é um grupo de técnicas de desenvolvimento inter-relacionadas do lado do cliente usadas para criar aplicações Web assíncronas.").

Inclusão de script do sistema
:

        // Be sure the "Client callable" checkbox is checked
         
        var MyDateTimeAjax = Class.create();
        MyDateTimeAjax.prototype = Object.extendsObject(AbstractAjaxProcessor,{
          nowDateTime:function(){
            return gs.nowDateTime();}});

## Alternar o campo de temporizador por nome de campo {#r_UsefulFieldScripts__section_xzg_mvx_mtb}

O client script a seguir alterna o campo do temporizador com base em um nome de campo específico.

    function toggleTimerByFieldName(fieldName){
     //Step 1: Find the timer object
     //timeObjectName: the timer objects name as it would normally be referenced
     //timeObjectHidden: the hidden input node in the field td
     //timeObjectParent: the parent td node containing the field and it's constituent nodes
     //timeObjectFields: anchor tag with onclick to stop timer
     
     var timeObjectName = fieldName;
     var timeObjectHidden = gel(timeObjectName);
     
     //Step 2: simulate click stop button
     var timeObjectParent;
     var timeObjectFields;
     
     //verify that we got the correct object
     if(timeObjectHidden.type=="hidden"){
     
        //Get Parent td node
        timeObjectParent = timeObjectHidden.parentNode;
     
        //Get input fields
        timeObjectFields = timeObjectParent.getElementsByTagName("input");
     
        //simulate click of stop button
        var timerTestString ="paused";
        var timerImg;
     
        //loop through input objects looking for the pause timer object
        for(var elIt=0; elIt < timeObjectFields.length; elIt++){
          if(timeObjectFields[elIt].id.match(timerTestString)){
            if(timeObjectFields[elIt].value=="false"){
              timeObjectFields[elIt].value="true";
              timerImg = timeObjectParent.getElementsByTagName("img")[0];
              timerImg.src="images/timer_start.gifx";}
          elseif(timeObjectFields[elIt].value=="true"){
              timeObjectFields[elIt].value="false";
              timerImg = timeObjectParent.getElementsByTagName("img")[0];
              timerImg.src="images/timer_stop.gifx";}}}}}

## Modificar o valor do campo GlideDateTime {#r_UsefulFieldScripts__section_k4g_jvx_mtb}

O exemplo a seguir usa um script do lado do servidor para acessar um campo GlideDateTime.  
O exemplo de script do lado do servidor a seguir mostra como modificar valores usando a API GlideDateTime. O mesmo conceito também se aplica ao objeto GlideDate.

    //You first need a GlideDateTime object
    //this can be from instantiating a new object "var gdt = new GlideDateTime()"
    //or getting the object from a GlideDateTime field
    //getting the field value (for example: var gdt = current.start_date) 
    //only returns the string value, not the object
    //to get the object use var gdt = current.start_date.getGlideObject();
    //now gdt is a GlideDateTime object
    var gdt = current.start_date.getGlideObject();
     
    //All methods can use negative values to subtract intervals
     
    //add 1 hour (60 mins * 60 secs)
    gdt.addSecondsLocalTime(3600);
     
    //add 1 day
    gdt.addDaysLocalTime(1);
     
    //subtract 1 day
    gdt.addDaysLocalTime(-1);
     
    //add 3 weeks
    gdt.addWeeksLocalTime(3);
     
    //subtract 6 months.
    gdt.addMonthsLocalTime(-6);
     
    //add 1 year, representing the date and time using the UTC timezone instead of the local user's timezone.
    gdt.addYearsUTC(1);