GlideElement - com escopo

A API GlideElement com escopo fornece vários métodos de script convenientes para lidar com campos e seus valores. Os métodos GlideElement com escopo estão disponíveis para os campos do GlideRecord atual.

GlideElement com escopo - canCreate()

Determina se a função do usuário permite a criação de novas entradas no campo associado.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 2. Retorna

Tipo	Descrição
Booliano	Sinalizador que indica se o usuário atual tem permissões para criar novas entradas no campo associado. Valores possíveis: verdadeiro: o usuário pode criar novas entradas. falso: o usuário não pode criar novas entradas.

O exemplo a seguir mostra como determinar se o usuário tem permissões para criar entradas para os três registros mais recentes na tabela Problema [problema].

var gr = new GlideRecord('problem');

// Get records in new state in Problem Table
gr.addQuery('state','101');

// Sort records in order of recent to earlier Created Date
gr.orderByDesc('sys_created_on');

// Limit the query to three records
gr.setLimit(3); 
gr.query();

while(gr.next()){
  if(gr.short_description.canCreate()){ ///check to see if the current user is allowed to create the record
  gs.info("I can create new records for the field Problem statement for - " + gr.number);
  }
}

Saída:

I can create new records for the field Problem statement for - PRB0000004
I can create new records for the field Problem statement for - PRB0001000
I can create new records for the field Problem statement for - PRB0001001

Equivalente com escopo

Para usar o método canCreate() em uma aplicação com escopo, use o método com escopo correspondente: canCreate().

GlideElement com escopo - canRead()

Indica se a função do usuário permite que ele leia o GlideRecord associado.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o campo puder ser lido, caso contrário, falso.

O exemplo a seguir mostra como obter uma lista de registros de incidentes ativos com um campo de descrição resumida legível.

var grIncident = new GlideRecord('incident');
grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
grIncident.orderByDesc('number');
grIncident.setLimit(3); // limit to three results for example
grIncident.query();

while (grIncident.next()) {
    if (grIncident.short_description.canRead()) { //check to see if the current user is allowed to read the record
        gs.info('You have permission to read the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
    }
}

Saída:

*** Script: You have permission to read the short description of: INC0009009 Unable to access the shared folder.
*** Script: You have permission to read the short description of: INC0009005 Email server is down.
*** Script: You have permission to read the short description of: INC0009001 Unable to post content on a Wiki page

GlideElement com escopo - canWrite()

Determina se a função do usuário permite que ele grave no GlideRecord associado.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o usuário puder gravar no campo, caso contrário, falso.

O exemplo a seguir mostra como obter uma lista de registros de incidentes ativos com um campo Descrição resumida gravável.

var grIncident = new GlideRecord('incident');
grIncident.addEncodedQuery("active=true"); //Query the Incident table for active incidents
grIncident.orderByDesc('number');
grIncident.setLimit(3); // limit to three results for example
grIncident.query();

while (grIncident.next()) {
    if (grIncident.short_description.canWrite()) { //check to see if the current user is allowed to write to the record
        gs.info('You have permission to write to the short description of: ' + grIncident.number + ' ' + grIncident.short_description);
    }
}

Saída:

*** Script: You have permission to write to the short description of: INC0009009 Unable to access the shared folder.
*** Script: You have permission to write to the short description of: INC0009005 Email server is down.
*** Script: You have permission to write to the short description of: INC0009001 Unable to post content on a Wiki page

GlideElement com escopo - mudanças ()

Determina se o campo atual foi modificado. Esta funcionalidade está disponível para todos os tipos de dados disponíveis, exceto campos de diário.

Nota:

O método changes() não é compatível com scripts de ACL.

Nota:

Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Booliano	Verdadeiro se os campos foram alterados, falso se o campo não foi.

O exemplo a seguir de uma regra de negócios mostra como criar um evento na EventQueue se o valor do campo assigned_to for alterado.

if (!current.assigned_to.nil() && current.assigned_to.changes()) {
  gs.eventQueue('incident.assigned', current, current.assigned_to.getDisplayValue(), previous.assigned_to.getDisplayValue());
}

GlideElement com escopo - changesFrom(Object o)

Determina se o valor anterior do campo atual corresponde ao objeto especificado.

Nota:

Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
o	Objeto	Um valor de objeto a ser verificado em relação ao valor anterior do campo atual.

Tabela 10. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o valor anterior corresponder, falso se não corresponder.

// The following example shows that in a business rule, if "active" field is changed from true, 
// insert a event in the EventQueue.
if (current.active.changesFrom(true)) {
  gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
}

GlideElement com escopo - changesTo(Object o)

Determina se o novo valor de um campo, após uma mudança, corresponde ao objeto especificado.

Nota:

O método changesTo() não é compatível com scripts de ACL.

Nota:

Se o GlideRecord no qual você está executando este método tiver sido apenas inicializado e lido e não tiver sido gravado, os valores anteriores e posteriores subjacentes serão os mesmos. Nesse caso, o método retorna "falso", pois não houve mudança no armazenamento de dados.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
o	Objeto	Um valor de objeto a ser verificado em relação ao novo valor do campo atual.

Tabela 12. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o valor anterior corresponder, falso se não corresponder.

// The following example shows that in a business rule, if "active" field is changed to false, 
// insert a event in the EventQueue.
if (current.active.changesTo(false)) {
  gs.eventQueue("incident.inactive", current, current.incident_state, previous.incident_state);
}

GlideElement com escopo - dateNumericValue()

Retorna o número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT para um campo de duração. Não requer a criação de um objeto GlideDateTime porque o campo de duração já é um objeto GlideDateTime.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Número	Número de milissegundos desde 1º de janeiro de 1970, 00:00:00 GMT.

var inc = new GlideRecord('incident');
inc.get('17c90efb13418700cc36b1422244b05d');
gs.info(inc.calendar_duration.dateNumericValue());

Saída:

98000

GlideElement com escopo - getAttribute(cadeia de caracteres "attributeName")

Retorna o valor do atributo especificado do dicionário.

Se o atributo for um atributo booliano, use getBooleanAttribute(String) para obter o valor como booliano em vez de uma cadeia de caracteres.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
attributeName	Cadeia de caracteres	Nome de atributo

Tabela 16. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor de atributo

doit();
function doit() {
  var now_GR = new GlideRecord('sys_user');
  now_GR.query("user_name","admin");
  if (now_GR.next()) {
    gs.info("we got one");
    gs.info(now_GR.location.getAttribute("tree_picker"));
  }
}

GlideElement com escopo - getBooleanAttribute(cadeia de caracteres "attributeName")

Retorna o valor booliano do atributo especificado do dicionário.

Para obter o valor como uma cadeia de caracteres, use getAttribute(string).

Tabela 17. Parâmetros

Nome	Tipo	Descrição
attributeName	Cadeia de caracteres	Nome de atributo

Tabela 18. Retorna

Tipo	Descrição
Booliano	Valor booliano do atributo. Retorna falso se o atributo não existir.

O exemplo a seguir mostra como obter valores boolianos do atributo ignore_filter_on_new para dois campos.

var inc = new GlideRecord('incident');
inc.query();

if (inc.next())
 {
   // opened_by field has attribute "ignore_filter_on_new = true"
   gs.info(inc.opened_by.getBooleanAttribute("ignore_filter_on_new"));

  // short_description field does not have attribute ignore_filter_on_new
   gs.info(inc.short_description.getBooleanAttribute("ignore_filter_on_new"));
 }

Saída:

true
false

GlideElement com escopo - getChoices(cadeia de caracteres dependente)

Retorna a lista de seleção de um campo especificado.

O campo para o qual a lista de seleção será retornada é especificado na chamada do método. Por exemplo: var escolhas = glideRecord.urgency.getChoices();. Para obter informações sobre tipos de campo de lista de seleção e seus recursos associados, consulte Tipo de campo delista de seleção.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
dependente	Cadeia de caracteres	Opcional. Campo no registro associado do qual o campo da lista de seleção depende.

Tabela 20. Retorna

Tipo	Descrição
Matriz	Lista de valores possíveis para a lista de seleção, que são os valores na tabela Opção [sys_choice]. Se o parâmetro dependent for aprovado, os resultados retornados refletirão somente as opções disponíveis para o campo dependente especificado.

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next(); 
 
// urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
var choices = glideRecord.urgency.getChoices();

GlideElement com escopo – getChoiceValue()

Retorna o rótulo da opção atual.

Uma opção tem um valor (número) e um rótulo (cadeia de caracteres). Este método retorna o rótulo.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 22. Retorna

Tipo	Descrição
Cadeia de caracteres	O rótulo da opção selecionada.

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next(); 
 
// urgency has choice list: 1 - High, 2 - Medium, 3 - Low, with value: 1, 2, 3
var choiceLabel = glideRecord.urgency.getChoiceValue(); 
gs.info(choiceLabel);

Saída:

1 - High

GlideElement com escopo - getDecryptedValue()

Retorna o valor de texto não criptografado dos campos de Senha (criptografada bidirecionalmente) em aplicações com escopo.

Tabela 23. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 24. Retorna

Tipo	Descrição
Cadeia de caracteres	A senha em texto não criptografado.

var tablename = 'x_scoped_app_table'
var CI = new GlideRecord(tablename);  
CI.addQuery('number', '0001002'); 
CI.query(); 
CI.next(); 

var password = CI.password_field
var decrypted = password.getDecryptedValue(); 
gs.info(decrypted);

Saída:

x_scoped_app: cleartextpassword

GlideElement com escopo - getDisplayValue(Number maxCharacters)

Retorna o valor de exibição formatado de um campo especificado de um objeto GlideRecord associado.

Os valores de exibição são manipulados com base no valor real no banco de dados e nas configurações e preferências do usuário ou do sistema.

O valor de exibição retornado depende do tipo de campo.

• Campos de opção: o valor do banco de dados pode ser um número, mas o valor de exibição será mais descritivo.
• Campos de data: o valor do banco de dados está no formato UTC, enquanto o valor de exibição é baseado no fuso horário do usuário.
• Texto criptografado: o valor do banco de dados é criptografado, enquanto o valor exibido não é criptografado com base no contexto de criptografia do usuário.
• Campos de referência: o valor do banco de dados é sys_id, mas o valor de exibição é um campo de exibição do registro referenciado.

Para obter mais informações sobre valores de exibição, consulte Valoresde exibição.

Tabela 25. Parâmetros

Nome	Tipo	Descrição
máx. de caracteres	Número	Opcional. Máximo de caracteres desejados. Padrão: Todos

Tabela 26. Retorna

Tipo	Descrição
Cadeia de caracteres	Exiba o valor do campo especificado.

O exemplo a seguir mostra como recuperar o valor de exibição do campo de prioridade em um registro de incidente.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
gs.info(glideRecord.priority.getDisplayValue());

Saída:

1 - Critical

O exemplo a seguir mostra como recuperar o valor de exibição e o valor interno de campos especificados no banco de dados de incidentes.

var now_GR = new GlideRecord('incident');
now_GR.get('9c573169c611228700193229fff72400'); //INC0000001
gs.info('Display Values:');
gs.info('Opened at ' + now_GR.opened_at.getDisplayValue());
gs.info('Opened by ' + now_GR.opened_by.getDisplayValue());
gs.info('Priority ' + now_GR.priority.getDisplayValue());
gs.info('Values:');
gs.info('Opened at ' + now_GR.opened_at.getValue());
gs.info('Opened by ' + now_GR.opened_by.getValue());
gs.info('Priority ' + now_GR.priority.getValue());

Saída:

Display Values:
Opened at 2022-02-01 15:09:51
Opened by Joe Employee
Priority 1 - Critical
Values:
Opened at 2022-02-01 23:09:51
Opened by 681ccaf9c0a8016400b98a06818d57c7
Priority 1

GlideElement com escopo - getDisplayValueLang(String language)

obtém o valor de exibição do campo no idioma passado como um parâmetro.

O resultado só se aplica a tipos de campo traduzíveis, como Opção, Campotraduzido e Texto traduzido. Para outros tipos de campo, o resultado padrão é getDisplayValue().

Você deve ter o plug-in de idioma correspondente para recuperar um valor traduzido. Para obter informações, consulte Activate a language.

Consulte também GlideElement com escopo - getLabelLang(String language).

Tabela 27. Parâmetros

Nome	Tipo	Descrição
idioma	Cadeia de caracteres	Marcador de idioma em conformidade com IETF BCP-47.

Tabela 28. Retorna

Tipo	Descrição
Cadeia de caracteres	Exiba o valor do campo no idioma aprovado. Se uma tradução não estiver disponível, o método recuperará um valor traduzido no idioma do usuário atual. Se uma tradução não estiver disponível, o resultado padrão será o inglês.

O exemplo a seguir mostra como obter o texto original e o texto traduzido para o alemão do campo de título Aceitar (Exibição da IU).

var uiView = new GlideRecord("sys_ui_view");
uiView.get("fa776f6d97700100f309124eda2975bc");

gs.info("getDisplayValue: " + uiView.getElement("title").getDisplayValue());
gs.info("getDisplayValueLang: " + uiView.getElement("title").getDisplayValueLang("de"));

Saída:

getDisplayValue: Accept
getDisplayValueLang: Akzeptieren

GlideElement com escopo - getED()

Retorna o descritor de elemento do campo.

Tabela 29. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 30. Retorna

Tipo	Descrição
GlideElementDescriptor	O descritor de elemento do campo.

var grInc = new GlideRecord('incident');
grInc.query('priority', '1');
 
var field = grInc.getElement('priority');
var ed = field.getED();

GlideElement com escopo - getGlobalDisplayValue()

Retorna o número de telefone em formato internacional.

Tabela 31. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 32. Retorna

Tipo	Descrição
Cadeia de caracteres	Número de telefone em formato internacional.

O exemplo a seguir mostra como obter o número de telefone de um local de balcão de serviços. Este exemplo requer o plug-in Walk-up Experience.

// Passing walkup location name and closed phone number in parameters
setWalkupLocPhone('Santa Clara Tech Lounge','phone_number');

function setWalkupLocPhone(locName, field) {
  var walkupLoc = new GlideRecord('wu_location_queue');
  walkupLoc.addQuery('name',locName);
  walkupLoc.query();
  walkupLoc.next();

  // Returns the phone number of walk-up location queue in international format
  gs.info(walkupLoc[field].getGlobalDisplayValue());
}

Saída:

[phone]

GlideElement com escopo - getHTMLValue(Number maxChars)

Retorna o valor HTML de um campo.

Tabela 33. Parâmetros

Nome	Tipo	Descrição
maxChars	Número	Opcional. Número máximo de caracteres a serem retornados.

Tabela 34. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor HTML do campo.

var inccause = new GlideRecord("incident");
inccause.short_description = current.short_description;
inccause.comments = current.comments.getHTMLValue();
inccause.insert();

GlideElement com escopo - getJournalEntry(Number mostRecent)

Retorna a entrada de diário mais recente ou todas as entradas de diário.

Tabela 35. Parâmetros

Nome	Tipo	Descrição
mais recente	Número	Se 1, retorna a entrada mais recente. Se for -1, retornará todas as entradas do registro.

Tabela 36. Retorna

Tipo	Descrição
Cadeia de caracteres	Para a entrada mais recente, retorna uma cadeia de caracteres que contém o rótulo do campo, o carimbo de data/hora e o nome de exibição do usuário da entrada do registro. Para todas as entradas de diário, retorna as mesmas informações para todas as entradas de diário já inseridas como uma única cadeia de caracteres com cada entrada delimitada por "\n\n".

//gets all journal entries as a string where each entry is delimited by '\n\n'
var notes = current.work_notes.getJournalEntry(-1); 
//stores each entry into an array of strings
var na = notes.split("\n\n");  
                      
for (var i = 0; i < na.length; i++)                 
  gs.info(na[i]);

GlideElement com escopo - getLabel()

Retorna o rótulo do objeto.

Tabela 37. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 38. Retorna

Tipo	Descrição
Cadeia de caracteres	Rótulo do objeto

var now_GR = new GlideRecord("sc_req_item");
now_GR.addQuery("request", current.sysapproval);
now_GR.query();
while(now_GR.next()) {
var nicePrice = now_GR.price.toString();
    if (nicePrice != ) {
        nicePrice = parseFloat(nicePrice);
        nicePrice = nicePrice.toFixed(2);
    }
    template.print(now_GR.number + ":  " + now_GR.quantity + " X " + now_GR.cat_item.getDisplayValue() + " at $" + nicePrice + " each \n");
    template.print("    Options:\n");
    var variables = now_GR.variables.getElements();    
    for (var key in variables) {
      var now_V = variables[key];
      if(now_V.getQuestion().getLabel() != ) {
         template.space(4);
         template.print('     ' +  now_V.getQuestion().getLabel() + " = " + now_V.getDisplayValue() + "\n");  
      }
    }
}

GlideElement com escopo - getLabelLang(String language)

Obtém o valor do rótulo do campo no idioma passado como um parâmetro.

Você deve ter o plug-in de idioma correspondente para recuperar um valor traduzido. Para obter informações, consulte Activate a language.

Consulte também:

• getDisplayValueLang()
• getLabel()

Tabela 39. Parâmetros

Nome	Tipo	Descrição
idioma	Cadeia de caracteres	Marcador de idioma em conformidade com IETF BCP-47.

Tabela 40. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor do rótulo do campo no idioma informado. Se uma tradução não estiver disponível, o método recuperará um valor traduzido no idioma do usuário atual. Se uma tradução não estiver disponível, o resultado padrão será o inglês.

O exemplo a seguir mostra como obter o texto do rótulo original e sua tradução em alemão do título Aceitar (Exibição da IU).

var uiView = new GlideRecord("sys_ui_view");
uiView.get("fa776f6d97700100f309124eda2975bc");

gs.info("getLabel: " + uiView.getElement("title").getLabel());
gs.info("getLabelLang: " + uiView.getElement("title").getLabelLang("de"));

Saída:

getLabel: Title
getLabelLang: Titel

GlideElement com escopo - getName()

Retorna o nome do campo.

Tabela 41. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 42. Retorna

Tipo	Descrição
Cadeia de caracteres	Nome do campo.

O exemplo a seguir mostra como obter o nome e outros valores de cada campo em um registro sys_user.

var userRec = new GlideRecord("sys_user"); // GlideRecord to sys_user table

userRec.get("5137153cc611227c000bbd1bd8cd2005"); // Sys Id of user: Fred Luddy

var fields = userRec.getFields();

for (var i = 0; i < fields.size(); i++) {

    var field = fields.get(i);
    var name = field.getName(); // Name of the field
    var label = field.getLabel(); // Label of the field
    var value = field.getDisplayValue(); // Value of the field

    gs.info((Number(i) + 1) + ".\n" + "Field Label: " + label + "\n" + "Field Name: " + name + "\n" + "Field Value: " + value);

};

Saída. Os resultados incluem 62 campos e foram truncados com pontos de reticências (...) para economizar espaço.

*** Script: 1.
Field Label: Country code
Field Name: country
Field Value: 
*** Script: 2.
Field Label: Calendar integration
Field Name: calendar_integration
Field Value: Outlook
...
*** Script: 47.
Field Label: First name
Field Name: first_name
Field Value: Fred
...
*** Script: 54.
Field Label: Last name
Field Name: last_name
Field Value: Luddy
...

GlideElement com escopo - getReferenceTable()

Obtém o nome da tabela para um elemento de referência.

Tabela 43. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 44. Retorna

Tipo	Descrição
Cadeia de caracteres	Nome da tabela da referência.

var grINC = new GlideRecord('incident');
grINC.query('number','INC0010041'); // record assignment group assigned to "CAB Approval"
if (grINC.next()) { 
  // Get the table name 
  var tableName = grINC.assignment_group.getReferenceTable();
  gs.info( tableName ); 
}

GlideElement com escopo - getRefRecord()

Retorna um objeto GlideRecord para um determinado elemento de referência.

Aviso:

Se o elemento de referência não contiver um valor, ele retornará um objeto GlideRecord vazio, não um objeto NULL.

Tabela 45. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 46. Retorna

Tipo	Descrição
GlideRecord	Um objeto GlideRecord

var grINC = new GlideRecord('incident'); 
grINC.addNotNullQuery('caller_id'); 
grINC.query(); 
if (grINC.next()) { 

// Get a GlideRecord object for the referenced sys_user record 
var grUSER = grINC.caller_id.getRefRecord(); 
if (grUSER.isValidRecord()) 
  gs.info(grUSER.getValue('name')); 

} 

GlideElement com escopo - getTableName()

Retorna o nome da tabela na qual o campo reside.

Tabela 47. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 48. Retorna

Tipo	Descrição
Cadeia de caracteres	Nome da tabela. O valor retornado pode ser diferente da classe da tabela em que o registro está. Consulte Tabelas e classes na documentação do produto.

if (current.approver.getTableName() == "sysapproval_approver") {
  if (current.approver == email.from_sys_id)  {
     current.comments = "reply from: " + email.from + "\n\n" + email.body_text;
 
   // if it's been cancelled, it's cancelled.
  var doit = true;
  if (current.state=='cancelled')
      doit = false;
 
  if (email.body.state != undefined)
     current.state= email.body.state;
 
   if (doit)
      current.update();
} else {
   gs.log("Approval for task ("+current.sysapproval.getDisplayValue()+") rejected because user sending 
           email( "+email.from+") does not match the approver ("+current.approver.getDisplayValue()+")");
}
 
}

GlideElement com escopo - nil()

Determina se um campo é nulo.

Tabela 49. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 50. Retorna

Tipo	Descrição
Booliano	Sinalizador que indica se o campo é nulo. Valores possíveis: verdadeiro: o campo é nulo. falso: o campo não é nulo.

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next(); 
gs.info(glideRecord.state.nil());

Saída:

false

GlideElement com escopo - setDateNumericValue(Number milissegundos)

Define o valor de um elemento de data/hora para o número especificado de milissegundos desde 1º de janeiro de 1970 00:00:00 GMT.

Quando chamado, setDateNumericValue() cria automaticamente o objeto GlideDateTime/GlideDate/GlideDuration necessário e, em seguida, define o elemento com o valor especificado.

Nota:

Antes de chamar este método, o elemento já deve existir consultando um registro existente ou usando o método now_GR.initialize () para inicializar um novo registro.

Tabela 51. Parâmetros

Nome	Tipo	Descrição
milissegundos	Número	Número de milissegundos desde 01/01/1970

Tabela 52. Retorna

Tipo	Descrição
vazio

var now_GR = new GlideRecord("incident");
now_GR.initialize();
now_GR.opened_at.setDateNumericValue(10000);

GlideElement com escopo - setDisplayValue(Object value)

Define o valor de exibição do campo.

Tabela 53. Parâmetros

Nome	Tipo	Descrição
valor	Objeto	O valor a ser definido para o campo.

Tabela 54. Retorna

Tipo	Descrição
vazio

var glideRecord = new GlideRecord('incident'); 
glideRecord.query('priority','1'); 
glideRecord.next();
 
//change the urgency to 3 
glideRecord.urgency.setDisplayValue('3 - Low');
gs.info(glideRecord.urgency);

GlideElement com escopo - setError(String errorMessage)

Adiciona uma mensagem de erro. Disponível no patch Fuji 3.

Tabela 55. Parâmetros

Nome	Tipo	Descrição
errorMessage	Cadeia de caracteres	A mensagem de erro.

Tabela 56. Retorna

Tipo	Descrição
vazio

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
 
glideRecord.short_description.setError('Error text');

GlideElement com escopo - setPhoneNumber(objeto phoneNumber, booliano estrito)

Define o campo como o número de telefone especificado.

Este método só está disponível em um número de telefone GlideElement.

Tabela 57. Parâmetros

Nome	Tipo	Descrição
phoneNumber	Objeto	O número de telefone a ser definido. Isso pode estar no formato internacional ou local.
estrito	Booliano	Quando verdadeiro, especifica que o número especificado deve corresponder ao formato correto. Quando falso, o sistema tenta corrigir um número de telefone formatado incorretamente.

Tabela 58. Retorna

Tipo	Descrição
Booliano	Sinalizador que indica se o valor do número de telefone foi definido. Valores possíveis: verdadeiro: o valor foi definido. falso: o valor não foi definido.

O exemplo a seguir mostra como definir o número de telefone de um local de balcão de serviços. Este exemplo requer o plug-in Walk-up Experience.

setWalkupLocPhone('Santa Clara Tech Lounge','[phone]'); 

function setWalkupLocPhone(locName, phoneNumber) {
  var walkupLoc = new GlideRecord('wu_location_queue');
  walkupLoc.addQuery('name', locName);
  walkupLoc.query();
  walkupLoc.next();
  
  // Set phone number of walk-up location
  var isPhoneNumberSet = walkupLoc.phone_number.setPhoneNumber(phoneNumber, true);
  walkupLoc.update();
  gs.info('Phone Number: ' + walkupLoc.phone_number);
  gs.info('Is phone number specified match the correct format: ' + isPhoneNumberSet);
}

Saída:

Phone Number: [phone]
Is phone number specified match the correct format: true

GlideElement com escopo - setValue(Object value)

Define o valor de um campo.

Nota:

Antes de chamar este método, o elemento já deve existir consultando um registro existente ou usando o método now_GR.initialize () para inicializar um novo registro.

Tabela 59. Parâmetros

Nome	Tipo	Descrição
valor	Objeto	Valor do objeto para definir o campo.

Tabela 60. Retorna

Tipo	Descrição
vazio

Defina o valor passando uma cadeia de caracteres.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
glideRecord.short_description.setValue('Network failure');

Defina o valor passando um objeto.

var now_GR  = new GlideRecord('student');
now_GR.initialize();
now_GR.setValue('first_name', 'Joe');
now_GR.setValue('last_name', 'Smith');
now_GR.insert();

GlideElement com escopo - toString()

Converte o valor de um campo GlideRecord em uma cadeia de caracteres.

Tabela 61. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 62. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor como uma cadeia de caracteres.

var glideRecord = new GlideRecord('incident');
glideRecord.query('priority','1');
glideRecord.next();
gs.info(glideRecord.opened_at.toString());

Saída:

2019-08-31 23:09:51