GlideSystem - Global

GlideSystem : addErrorMessage (message d’objet)

Ajoute un message d’erreur pour la session en cours.

Utilisez getErrorMessages() pour récupérer une liste des messages d’erreur actuellement affichés.

Tableau 1. Paramètres
Nom	Type	Description
message	Objet	Message à ajouter.

Tableau 2. Renvoie
Type	Description
nul

gs.include("PrototypeServer");
  var ValidatePasswordStronger = Class.create();
  ValidatePasswordStronger.prototype = {
       process : function() {
          var user_password = request.getParameter("user_password");
          var min_len = 8;
          var rules = "Password must be at least " + min_len + 
             " characters long and contain a digit, an uppercase letter, and a lowercase letter.";
          if (user_password.length() < min_len) {
             gs.addErrorMessage("TOO SHORT: " + rules);
             return false;
          }
          var digit_pattern = new RegExp("[0-9]", "g");
          if (!digit_pattern.test(user_password)) {
             gs.addErrorMessage("DIGIT MISSING: " + rules);
             return false;
          }
          var upper_pattern = new RegExp("[A-Z]", "g");
          if (!upper_pattern.test(user_password)) {
             gs.addErrorMessage("UPPERCASE MISSING: " + rules);
             return false;
          }
          var lower_pattern = new RegExp("[a-z]", "g");
          if (!lower_pattern.test(user_password)) {
             gs.addErrorMessage("LOWERCASE MISSING: " + rules);
             return false;
          }
          return true; // password is OK
       }
  }
[edit]

Équivalent dans le champ d’application

Pour utiliser la méthode addErrorMessage() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : addErrorMessage().

GlideSystem : addInfoMessage(message d’objet)

Ajoute un message d’information pour la session en cours.

Utilisez getInfoMessages() pour récupérer la liste des messages d’informations affichés. Cette méthode n’est pas prise en charge pour les règles métier asynchrones et ne peut pas être utilisée dans les scripts de transformation.

Tableau 3. Paramètres
Nom	Type	Description
message	Objet	Message à ajouter.

Tableau 4. Renvoie
Type	Description
nul

if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

Équivalent dans le champ d’application

Pour utiliser la méthode addInfoMessage() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : addInfoMessage().

GlideSystem - addMessage(Type de chaîne, Message d’objet)

Ajoute un message pour la session en cours.

Tableau 5. Paramètres
Nom	Type	Description
type	Chaîne	Type de message, par exemple `Erreur` ou `Info`.
message	Objet	Message à ajouter à la session en cours.

Tableau 6. Renvoie
Type	Description
nul

GlideSystem - beginningOfLastMonth()

Obtient la date et l’heure du début du mois dernier en GMT.

Tableau 7. Paramètres
Nom	Type	Description
Aucun

Tableau 8. Renvoie
Type	Description
Chaîne	Le début GMT du mois dernier, au format aaaa-mm-jj hh :mm :ss.

Cet exemple définit la date et l’heure de l’objet GlideDateTime au début du mois dernier.

var date = new GlideDate();
date.setValue(gs.beginningOfLastMonth());
var dateasint = date.toString().replace('-','');
gs.print(dateasint);

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfLastMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfLastMonth().

GlideSystem - beginningOfLastWeek()

Renvoie la date et l’heure du début de la semaine dernière en format GMT.

Tableau 9. Paramètres
Nom	Type	Description
Aucun

Tableau 10. Renvoie
Type	Description
Chaîne	GMT début de la semaine dernière. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine dernière.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfLastWeek());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfLastWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfLastWeek().

GlideSystem - beginningOfNextWeek()

Renvoie la date et l’heure du début de la semaine prochaine en format GMT.

Tableau 11. Paramètres
Nom	Type	Description
Aucun

Tableau 12. Renvoie
Type	Description
Chaîne	GMT début de la semaine prochaine. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine prochaine.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextWeek());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfNextWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextWeek().

GlideSystem - beginningOfNextMonth()

Renvoie la date et l’heure du début du mois suivant en format GMT.

Tableau 13. Paramètres
Nom	Type	Description
Aucun

Tableau 14. Renvoie
Type	Description
Chaîne	GMT au début du mois prochain. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début du mois suivant.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextMonth());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfNextMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextMonth().

GlideSystem - beginningOfNextYear()

Renvoie la date et l’heure du début de l’année prochaine en format GMT.

Tableau 15. Paramètres
Nom	Type	Description
Aucun

Tableau 16. Renvoie
Type	Description
Chaîne	Le GMT début de l’année prochaine, au format aaaa-mm-jj hh :mm :ss.

Cet exemple définit la valeur de l’enregistrement date/heure Glide actuel au début de l’année prochaine.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextYear());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfNextYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextYear().

GlideSystem - beginningOfThisMonth()

Renvoie la date et l’heure du début du mois actuel en format GMT.

Tableau 17. Paramètres
Nom	Type	Description
Aucun

Tableau 18. Renvoie
Type	Description
Chaîne	GMT début du mois en cours. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de ce mois.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisMonth());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfThisMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisMonth().

GlideSystem - beginningOfThisQuarter()

Renvoie la date et l’heure du début du trimestre actuel en GMT.

Tableau 19. Paramètres
Nom	Type	Description
Aucun

Tableau 20. Renvoie
Type	Description
Chaîne	GMT début du trimestre en cours. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début du trimestre en cours.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisQuarter());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfThisQuarter() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisQuarter().

GlideSystem - beginningOfThisWeek()

Renvoie la date et l’heure du début de cette semaine en format GMT.

Tableau 21. Paramètres
Nom	Type	Description
Aucun

Tableau 22. Renvoie
Type	Description
Chaîne	GMT début de la semaine en cours. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine en cours.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisWeek());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisWeek().

GlideSystem - beginningOfThisYear()

Renvoie la date et l’heure du début de cette année en format GMT.

Tableau 23. Paramètres
Nom	Type	Description
Aucun

Tableau 24. Renvoie
Type	Description
Chaîne	GMT début de l’année en cours. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de l’année en cours.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisYear());

Équivalent dans le champ d’application

Pour utiliser la méthode beginningOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisYear().

GlideSystem - beginningOfToday()

Récupère la date et l’heure du début de la journée en format GMT.

Tableau 25. Paramètres
Nom	Type	Description
Aucun

Tableau 26. Renvoie
Type	Description
Chaîne	Début GMT de la journée en cours. Format : aaaa-mm-jj hh :mm :ss

Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel sur le début de la journée actuelle.

var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfToday());

GlideSystem - beginningOfTomorrow()

Récupère le début (UTC) de demain ajusté pour le fuseau horaire de la session en cours.

Tableau 27. Paramètres
Nom	Type	Description
Aucun

Tableau 28. Renvoie
Type	Description
Chaîne	GMT début de demain. Format : aaaa-mm-jj hh :mm :ss

var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue();

GlideSystem - beginningOfYesterday()

Récupère la date et l’heure du début de la journée d’hier en GMT.

Tableau 29. Paramètres
Nom	Type	Description
Aucun

Tableau 30. Renvoie
Type	Description
Chaîne	Le début GMT d’hier, au format aaaa-mm-jj hh :mm :ss.

var start = new GlideDateTime();
start.setValue(gs.beginningOfYesterday());

GlideSystem : calDateDiff(String startDate, String endDate, Boolean numericValue)

Calculez la différence entre deux dates à l’aide du calendrier par défaut.

Les calendriers sont désormais hérités. Si des calendriers sont utilisés, reportez-vous à la section « Calculer au cours d’un calendrier donné » de la rubrique Scripts de planification utiles.

Tableau 31. Paramètres
Nom	Type	Description
startDate	Chaîne	Date de début à comparer au format de date de l’utilisateur actuel.
endDate	Chaîne	Date de fin à comparer au format de date de l’utilisateur actuel.
valeur numérique	Booléen	Marqueur indiquant le format de la valeur de temps renvoyée. Valeurs valides : true : la valeur de retour est formatée en nombre de secondes false : la valeur de retour est au format ddd hh :mm :ss.

Tableau 32. Renvoie
Type	Description
Chaîne	Si le paramètre a la numericValue valeur vrai, renvoie la différence entre les deux dates sous forme de nombre entier de secondes. Si faux, renvoie la différence entre les deux dates au format jjj hh :mm :ss.

var endDateTime = gs.nowDateTime();
gs.print('--- Total records: ' + countRecordsTotal);
gs.print('--- End time: ' + endDateTime);
gs.print('Time diff: ' + gs.calDateDiff(startDateTime, endDateTime));

GlideSystem : dateDiff(String startDate, String endDate, Boolean numericValue)

Calcule la différence entre deux dates.

Cette méthode attend la date la plus ancienne comme premier paramètre et la date la plus tardive comme deuxième paramètre. Dans le cas contraire, la méthode renvoie la différence sous la forme d’une valeur négative. Utilisez getDisplayValue() pour convertir les chaînes au format attendu.

Cette méthode attend des paramètres au format date/heure utilisateur/système, qui peuvent différer du format interne. L’utilisation de paramètres dans des formats autres que le format date/heure utilisateur/système peut renvoyer des résultats non valides.

Si vous travaillez avec des objets GlideDateTime, utilisez la méthode GlideDateTime subtract() au lieu de dateDiff().

Tableau 33. Paramètres
Nom	Type	Description
startDate	Chaîne	La date de début à comparer au format de date de l’utilisateur actuel.
endDate	Chaîne	Date de fin à comparer au format de date de l’utilisateur actuel.
valeur numérique	Booléen	Si vrai, la valeur de retour sera formatée en nombre de secondes ; Si la valeur est faux, la valeur de retour sera formatée ddd hh :mm :ss.

Tableau 34. Renvoie
Type	Description
Chaîne	Si le paramètre numericValue est vrai, renvoie la différence entre les deux dates sous forme de nombre entier de secondes ; si faux, renvoie la différence entre les deux dates au format jjj hh :mm :ss.

// Given two date/times as DateTime objects
// Set the values this way to ensure a consistent input time
var date1 = new GlideDateTime();
var date2 = new GlideDateTime();
date1.setDisplayValueInternal('2014-01-01 12:00:00');
date2.setDisplayValueInternal('2014-01-01 13:00:00');
 
// Determine the difference as number of seconds (returns a string)
// Use getDisplayValue() to convert the string to the format expected by dateDiff()
var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true);
 
// JavaScript will coerce diffSeconds from a string to a number
// since diffSeconds is being compared to a number
var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before ';
gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue())

GlideSystem - dateGenerate(String date, String range)

Génère une date et une heure pour la date spécifiée en GMT.

Tableau 35. Paramètres
Nom	Type	Description
date	Chaîne	Date à générer au format GMT. Format : aaaa-mm-jj
Gamme	Chaîne	Début, fin ou une heure. Format : hh :mm :ss 24 heures

Tableau 36. Renvoie
Type	Description
Chaîne	Date et heure de génération. Si la plage est `Début`, la valeur renvoyée est aaaa-mm-jj 00 :00 :00. Si la plage est `terminée` , la valeur de retour est aaaa-mm-jj 23 :59 :59. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre l’utilisation de dateGenerate() pour définir la date de début lors de l’interrogation des enregistrements dans la table Incident.

var tableData = new GlideRecord('incident');
tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
tableData.query();
gs.info("Count: " + tableData.getRowCount());

Sortie :

Count: 7

Équivalent dans le champ d’application

Pour utiliser la méthode dateGenerate() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : dateGenerate().

GlideSystem : daysAgo (nombre de jours)

Renvoie une date et une heure pour un certain nombre de jours plus tôt.

Tableau 37. Paramètres
Nom	Type	Description
jours	Numéro	Nombre de jours

Tableau 38. Renvoie
Type	Description
Chaîne	GMT du nombre spécifié de jours. Format : aaaa-mm-jj hh :mm :ss.

function contractNoticeDue() {
  var now_GR = new GlideRecord("contract");
  now_GR.addQuery("u_contract_status", "Active");
  now_GR.query();
  while (now_GR.next()) {
    if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
      now_GR.u_contract_status = "In review";
    } 
    else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
      now-GR.u_contract_status = "In review";
    }
    else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
      now_GR.u_contract_status = "In review";
    }
  }
  now_GR.update();
}

Équivalent dans le champ d’application

Pour utiliser la méthode daysAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgo().

GlideSystem : daysAgoEnd(Nombre de jours)

Renvoie une date et une heure pour la fin de la journée passée il y a un nombre spécifié de jours.

Tableau 39. Paramètres
Nom	Type	Description
jours	Numéro	Nombre entier de jours

Tableau 40. Renvoie
Type	Description
Chaîne	La fin GMT de la journée au format aaaa-mm-jj hh :mm :ss.

Cet exemple montre l’utilisation de daysAgoEnd() pour définir la date de fin lors de l’interrogation des enregistrements dans la table Incident.

var tableData = new GlideRecord('incident');
tableData.addEncodedQuery("sys_created_onBETWEENjavascript:gs.dateGenerate('2015-10-07','00:00:00')@javascript:gs.daysAgoEnd(0)^priority=1^severityIN1,2");
tableData.query();
gs.addInfoMessage("Count: " +tableData.getRowCount());

Équivalent dans le champ d’application

Pour utiliser la méthode daysAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgoEnd().

GlideSystem : daysAgoLocal(nombre de jours)

Renvoie la date et l’heure du début de la journée pour le nombre de jours précédent. La date et l’heure renvoyées reflètent le fuseau horaire de la session en cours (heure locale).

Tableau 41. Paramètres
Nom	Type	Description
jours	Numéro	Nombre de jours plus tôt

Tableau 42. Renvoie
Type	Description
Chaîne	Date et heure locales du début de la journée au format de date/heure défini par l’utilisateur. Si le format date/heure n’est pas modifié par rapport à sa valeur initiale, le format est aaaa-mm-jj hh :mm :ss.

if (due_in == "1 Day") {
  dd = gs.daysAgoLocal(-1);
}
if (due_in == "1 Week") {
  dd = gs.daysAgoLocal(-7);
}

GlideSystem : daysAgoStart(nombre de jours)

Renvoie une date et une heure pour le début de la journée il y a un nombre spécifié de jours.

Tableau 43. Paramètres
Nom	Type	Description
jours	Chaîne	Nombre entier de jours

Tableau 44. Renvoie
Type	Description
Chaîne	GMT début de la journée au format aaaa-mm-jj hh :mm :ss

var now_GR = new GlideRecord('sysapproval_approver');
now_GR.addQuery('state', 'requested');
now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
now_GR.query();

Équivalent dans le champ d’application

Pour utiliser la méthode daysAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgoStart().

GlideSystem - endOfLastMonth()

Renvoie la date et l’heure de la fin du mois dernier en format GMT.

Tableau 45. Paramètres
Nom	Type	Description
Aucun

Tableau 46. Renvoie
Type	Description
Chaîne	GMT de la fin du mois dernier. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment interroger un enregistrement de rapport à partir du dernier jour du mois dernier.

var month = gs.endOfLastMonth();
var monthd = new GlideDateTime(month);
monthd.addDays(-1);

var queueLast = new GlideRecord('u_amazon_connect_phone_metrics');
queueMtd.addQuery('u_queue_name',queueNames[i]);
queueMtd.addEncodedQuery('u_time_range=MTD');
queueMtd.addEncodedQuery('u_report_date'+ monthd);
queueMtd.orderByDesc('u_report_date');
        
queueMtd.query();

if(queueMtd.next()){
  gs.info(queueMtd.u_report_date);
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfLastMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastMonth().

GlideSystem - endOfLastWeek()

Renvoie la date et l’heure de la fin de la semaine dernière en format GMT.

Tableau 47. Paramètres
Nom	Type	Description
Aucun

Tableau 48. Renvoie
Type	Description
Chaîne	GMT à la fin de la semaine dernière. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment interroger les enregistrements ouverts au cours de la dernière semaine du mois précédent.

var inc = new GlideRecord('incident');
inc.addQuery('active=true^priority=1^opened_atONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()^opened_atONLast week@javascript:gs.beginningOfLastWeek()@javascript:gs.endOfLastWeek()');
inc.query();
while(inc.next())
 {
   gs.addInfoMessage(inc.getRowCount());
 }

Équivalent dans le champ d’application

Pour utiliser la méthode endOfLastWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastWeek().

GlideSystem - endOfLastYear()

Renvoie la date et l’heure de fin de l’année dernière au format GMT.

Tableau 49. Paramètres
Nom	Type	Description
Aucun

Tableau 50. Renvoie
Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss.

Cet exemple montre comment interroger les enregistrements créés pour tous les enregistrements créés au cours de la dernière année.

var inc = new GlideRecord('incident');
inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()');
inc.query();
while(inc.next()){
  inc.assignment_group = "d625dccec0a8016700a222a0f7900d06";
  inc.update();
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfLastYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastYear().

GlideSystem - endOfNextMonth()

Renvoie la date et l’heure de fin du mois suivant en GMT.

Tableau 51. Paramètres
Nom	Type	Description
Aucun

Tableau 52. Renvoie
Type	Description
Chaîne	Données et heure GMT. Format aaaa-mm-jj hh :mm :ss

Cet exemple montre comment interroger les enregistrements de connaissances de la base de connaissances créés depuis le début du jour jusqu’à la fin du mois prochain.

var query = "kb_knowledge_base=e81c9a0ddbc15810c38f0763b99619c1^ORkb_knowledge_base=21302e89db055810c38f0763b99619cc^valid_toBETWEENjavascript:gs.beginningOfToday()@javascript:gs.endOfNextMonth()^ORworkflow_state=pending_retirement^latest=true";
var rec = new GlideRecord('kb_knowledge');
rec.addEncodedQuery(query);
rec.addQuery('author', current.author);
rec.query();
while (rec.next()) {
  var Kbtitle = rec.getValue('short_description');
  articles.push(rec.number.toString()+ '' + Kbtitle);
  template.print('Click here to view record<a href="https://give urs instance url here/nav_to.do?uri=kb_knowledge.do?sys_id=' + rec.sys_id + '">' + rec.number + '</a>');
}
var articlesList = "<ul>";
for (i = 0; i <= articles.length-1; i++) {
  articlesList = articlesList + "<li>" + articles[i] + "</li>";
}
articlesList = articlesList + "</ul>";

Équivalent dans le champ d’application

Pour utiliser la méthode endOfNextMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextMonth().

GlideSystem - endOfNextWeek()

Renvoie la date et l’heure de la fin de la semaine prochaine en GMT.

Tableau 53. Paramètres
Nom	Type	Description
Aucun

Tableau 54. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de la semaine prochaine. Format aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfNextWeek() dans une requête pour obtenir tous les visiteurs de la semaine écoulée.

var title = 'Visitors arriving this Week';
var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()';

Équivalent dans le champ d’application

Pour utiliser la méthode endOfNextWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextWeek().

GlideSystem - endOfNextYear()

Renvoie la date et l’heure de fin de l’année prochaine en format GMT.

Tableau 55. Paramètres
Nom	Type	Description
Aucun

Tableau 56. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de l’année prochaine. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfNextYear() pour définir l’objet GlideDateTime à la fin de l’année prochaine.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfNextYear());
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfNextYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextYear().

GlideSystem - endOfThisMonth()

Renvoie la date et l’heure de fin de ce mois en format GMT.

Tableau 57. Paramètres
Nom	Type	Description
Aucun

Tableau 58. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de ce mois. Format aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfThisMonth() pour définir l’objet GlideDateTime à la fin du mois en cours.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisMonth());
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfThisMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisMonth().

GlideSystem : endOfThisQuarter()

Renvoie la date et l’heure de fin de ce trimestre en GMT.

Tableau 59. Paramètres
Nom	Type	Description
Aucun

Tableau 60. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de ce trimestre. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfThisQuarter() pour définir l’objet GlideDateTime à la fin du mois en cours.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisQuarter());
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfThisQuarter() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisQuarter().

GlideSystem - endOfThisWeek()

Renvoie la date et l’heure de fin de cette semaine en GMT.

Tableau 61. Paramètres
Nom	Type	Description
Aucun

Tableau 62. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de cette semaine. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfThisWeek() pour définir l’objet GlideDateTime à la fin du mois en cours.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisWeek());
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisWeek().

GlideSystem - endOfThisYear()

Renvoie la date et l’heure de fin de cette année au format GMT.

Tableau 63. Paramètres
Nom	Type	Description
Aucun

Tableau 64. Renvoie
Type	Description
Chaîne	Date et heure GMT pour la fin de cette année. Format aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser endOfThisYear() pour définir l’objet GlideDateTime à la fin du mois en cours.

setEndDate : function(dt) {
  var gdt2 = new GlideDateTime(dt);
  gdt2.setValue(gs.endOfThisYear());
}

Équivalent dans le champ d’application

Pour utiliser la méthode endOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisYear().

GlideSystem - endOfToday()

Récupère la date et l’heure de fin de la journée d’aujourd’hui en GMT.

Tableau 65. Paramètres
Nom	Type	Description
Aucun

Tableau 66. Renvoie
Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss.

var beginToday = gs.beginningOfToday(); 
        var endToday = gs.endOfToday(); 
        var beginTomorrow = gs.beginningOfTomorrow(); 
        var endTomorrow = gs.endOfTomorrow(); 
        var beginYesterday = gs.beginningOfYesterday(); 
        var endYesterday = gs.endOfYesterday(); 
        
        gs.info('beginningOfToday: ' + beginToday); 
        gs.info('endOfToday: ' + endToday); 
        gs.info('-----------'); 
        gs.info('beginningOfTomorrow: ' + beginTomorrow); 
        gs.info('endOfTomorrow: ' + endTomorrow); 
        gs.info('beginningOfYesterday: ' + beginYesterday); 
        gs.info('endOfYesterday: ' + endYesterday); 
        gs.info('-----------'); 
        var gdt1 = new GlideDateTime(beginToday); 
        var gdt2 = new GlideDateTime(beginTomorrow); 
        var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
        gs.info('BeginTomorrow: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(endToday); 
        var gdt2 = new GlideDateTime(endTomorrow); 
        var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2 
        gs.info('EndTomorrow: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(beginToday); 
        var gdt2 = new GlideDateTime(beginYesterday); 
        var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
        gs.info('BeginningYesterday: ' + dur.getDisplayValue()); 
        
        var gdt1 = new GlideDateTime(endToday); 
        var gdt2 = new GlideDateTime(endYesterday); 
        var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2 
        gs.info('EndYesterday: ' + dur.getDisplayValue());

GlideSystem - endOfTomorrow()

Récupère la date et l’heure de fin de demain en GMT.

Tableau 67. Paramètres
Nom	Type	Description
Aucun

Tableau 68. Renvoie
Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss.

var tomorrowEnd = new GlideDateTime();
tomorrowEnd.setValue(gs.endOfTomorrow());

GlideSystem - endOfYesterday()

Obtient la date et l’heure de fin de la journée d’hier en GMT.

Tableau 69. Paramètres
Nom	Type	Description
Aucun

Tableau 70. Renvoie
Type	Description
Chaîne	GMT au format (aaaa-mm-jj huh :mm :ss).

var yesterdayEnd = new GlideDateTime();
yesterdayEnd.setValue(gs.endOfYesterday());

GlideSystem – eventQueue(nom de chaîne, objet glideRecord, chaîne parm1, chaîne parm2, file d’attente de chaînes)

Met un événement en file d’attente pour le gestionnaire d’événements.

Tableau 71. Paramètres
Nom	Type	Description
nom	Chaîne	Nom de l’événement mis en file d’attente.
glideRecord	Objet	GlideRecord, tel que « current ».
parm1	Chaîne	(Facultatif) Enregistré avec l’instance si spécifiée.
parm2	Chaîne	(Facultatif) Enregistré avec l’instance si spécifiée.
queue	Chaîne	Nom de la file d'attente.

Tableau 72. Renvoie
Type	Description
nul

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueue("incident.commented", current, gs.getUserID(), gs.getUserName());
}

Équivalent dans le champ d’application

Pour utiliser la méthode eventQueue() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : eventQueue().

GlideSystem – eventQueueScheduled(Nom de chaîne, Objet glideRecord, Chaîne parm1, Chaîne parm2, Expiration de l’objet)

Met en file d’attente un événement pour le gestionnaire d’événements à une date et une heure spécifiées.

Tableau 73. Paramètres
Nom	Type	Description
nom	Chaîne	Nom de l’événement mis en file d’attente.
glideRecord	Objet	GlideRecord, tel que « current ».
parm1	Chaîne	(Facultatif) Enregistré avec l’instance si spécifiée.
parm2	Chaîne	(Facultatif) Enregistré avec l’instance si spécifiée.
Date d’expiration	Objet	Date et heure de traitement de cet événement.

Tableau 74. Renvoie
Type	Description
nul

if (current.operation() != 'insert' && current.comments.changes()) {
    gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00'));
}

Équivalent dans le champ d’application

Pour utiliser la méthode eventQueueScheduled() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : eventQueueScheduled().

GlideSystem - flushMessages()

Efface les messages de session enregistrés à l’aide de addErrorMessage() ou addInfoMessage().

Les messages de session sont affichés en haut du formulaire. Dans les scripts côté client, utilisez g_form.clearMessages() pour supprimer les messages de session.

Tableau 75. Paramètres
Nom	Type	Description
Aucun

Tableau 76. Renvoie
Type	Description
nul

Cet exemple montre comment analyser et renvoyer les messages d’erreur, puis effacer les messages à l’aide de flushMessages().

MySessionUtil.getSessionError = function() {
  var msg = null;
  var msgs = gs.getErrorMessages().toArray();
  if (msgs.length > 0) {
    msg = msgs[0] + '';
    gs.flushMessages();
  }
  return msg;
};

GlideSystem : getAvatar()

Renvoie le chemin d’accès au fichier vers l’avatar de l’utilisateur.

Tableau 77. Paramètres
Nom	Type	Description
Aucun

Tableau 78. Renvoie
Type	Description
Chaîne	Le chemin d’accès au fichier vers l’avatar de l’utilisateur.

var avatarFile = gs.getUser().getAvatar();        
gs.addInfoMessage('User avatar ID: ' + avatarFile);

Sortie :

User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small

GlideSystem : getCurrentScopeName()

Renvoie le nom du périmètre de l’application actuel.

Tableau 79. Paramètres
Nom	Type	Description
Aucun

Tableau 80. Renvoie
Type	Description
Chaîne	Nom du périmètre actuel.

Cet exemple montre comment utiliser getCurrentScopeName() pour obtenir la portée du processeur.

var incident_GR = new GlideRecord('Incident');

if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) {
  gs.debug("processor scope = "+ gs.getCurrentScopeName());
  var w = new global.Workflow();
  var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update");   //id = id workflow
}

Équivalent dans le champ d’application

Pour utiliser la méthode getCurrentScopeName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getCurrentScopeName().

GlideSystem : getDateFormat()

Renvoie le format de date associé à l’utilisateur actuel.

Tableau 81. Paramètres
Nom	Type	Description
Aucun

Tableau 82. Renvoie
Type	Description
Chaîne	Le format de date associé à l’utilisateur actuel.

L’exemple suivant renvoie le format de date associé à l’utilisateur.

var userDateFormat = gs. getDateFormat();
gs.info(userDateFormat);

Sortie :

yyyy-MM-dd

GlideSystem : getDateTimeFormat()

Renvoie le format de date et d’heure associé à l’utilisateur actuel.

Tableau 83. Paramètres
Nom	Type	Description
Aucun

Tableau 84. Renvoie
Type	Description
Chaîne	Le format de date et d’heure associé à l’utilisateur actuel.

L’exemple suivant renvoie le format de la date et de l’heure associées à l’utilisateur.

var userDateTimeFormat = gs.getDateTimeFormat();
gs.info(userDateTimeFormat);

Sortie :

yyyy-MM-dd HH:mm:ss

GlideSystem : getDisplayColumn(String tableName)

Récupère la colonne d’affichage de la table.

Tableau 85. Paramètres
Nom	Type	Description
tableName	Chaîne	Nom de la table à partir de laquelle obtenir le nom de colonne d’affichage.

Tableau 86. Renvoie
Type	Description
Chaîne	Afficher le nom de colonne

// Return the sys_id value for a given table and its display value
function GetIDValue(table, displayValue) { 
    var rec = new GlideRecord(table);
    var dn = gs.getDisplayColumn(table);
    if (rec.get(dn, displayValue))
        return rec.sys_id;
    else
        return null;
}

GlideSystem : getDisplayValueFor(String tableName, String recordID, String fieldName)

Renvoie la valeur d’affichage d’un champ spécifié sur un enregistrement spécifié.

Tableau 87. Paramètres
Nom	Type	Description
tableName	Chaîne	Nom de la table.
ID d’enregistrement	Chaîne	Sys_id pour mémoire.
Fieldname	Chaîne	Nom du champ dont la valeur d’affichage doit être renvoyée.

Tableau 88. Renvoie
Type	Description
Chaîne	Affichez la valeur du champ.

Cet exemple montre comment utiliser getDisplayValueFor() pour renvoyer la valeur d’affichage du champ numérique .

var value = gs.getDisplayValueFor(current.getTableName(),current.getValue('sys_id'),'number');

GlideSystem : getErrorMessages()

Renvoie la liste des messages d’erreur pour la session qui ont été ajoutés par addErrorMessage().

Tableau 89. Paramètres
Nom	Type	Description
Aucun

Tableau 90. Renvoie
Type	Description
Chaîne	Liste des messages d’erreur

Cet exemple montre comment analyser et renvoyer les messages d’erreur à l’aide de getErrorMessages().

MySessionUtil.getSessionError = function() {
  var msg = null;
  var msgs = gs.getErrorMessages().toArray();
  if (msgs.length > 0) {
    msg = msgs[0] + '';
    gs.flushMessages();
  }
  return msg;
};

Équivalent dans le champ d’application

Pour utiliser la méthode getErrorMessages() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getErrorMessages().

GlideSystem - getEscapedProperty(String key, Object substituteObject)

Récupère la propriété et l’échappe pour l’analyse XML.

Tableau 91. Paramètres
Nom	Type	Description
key	Chaîne	Clé de la propriété dont la valeur doit être renvoyée.
Objet de substitution	Objet	Facultatif. Objet à retourner si la propriété est introuvable.

Tableau 92. Renvoie
Type	Description
Chaîne	Property, ou le substituObject si la propriété est introuvable.

var propValue = gs.getEscapedProperty("com.example.my_test_property");
gs.addInfoMessage("This is my property value " + propValue);

GlideSystem : getImpersonatingUserDisplayName()

Renvoie le nom d’affichage de l’utilisateur qui emprunte l’identité.

Tableau 93. Paramètres
Nom	Type	Description
Aucun

Tableau 94. Renvoie
Type	Description
Chaîne	Nom d’affichage de l’utilisateur qui emprunte l’identité.

Cet exemple montre comment obtenir le nom d’affichage de l’emprunteur d’identité.

var user = gs.getUserDisplayName();
gs.print ("The current user display name is: " + user);

var name = gs.getImpersonatingUserDisplayName(); 
gs.print("Impersonating user display name: " + name);

Sortie :

The current user display name is: abel.tuter
Impersonating user display name: admin

GlideSystem : getImpersonatingUserName()

Renvoie le nom de l’utilisateur qui emprunte l’identité ou null s’il n’emprunte pas l’identité.

Tableau 95. Paramètres
Nom	Type	Description
Aucun

Tableau 96. Renvoie
Type	Description
Chaîne	Nom de l’utilisateur empruntant l’identité

Cet exemple montre comment obtenir le nom d’utilisateur de l’emprunteur d’identité.

var name = gs.getImpersonatingUserName();
var actual_user = null;
if (name == null || name == '')
  actual_user = user;
else
  actual_user = Packages.com.glide.sys.User.getUser(name);

var recent_impersonations = actual_user.getPreference('recent.impersonations');
var admin_role=actual_user.hasRole("admin");

GlideSystem : getInfoMessages()

Récupère la liste des messages d’information pour la session qui ont été ajoutés par addInfoMessage().

Tableau 97. Paramètres
Nom	Type	Description
Aucun

Tableau 98. Renvoie
Type	Description
Chaîne	Liste des messages d’information.

Cet exemple montre comment obtenir les messages d’information.

var messages = gs.getInfoMessages();
if (messages.toString().indexOf('Conflicts Detected') == -1)
  gs.addInfoMessage(msg);

GlideSystem : getInitials()

Renvoie les initiales de l’utilisateur.

Tableau 99. Paramètres
Nom	Type	Description
Aucun

Tableau 100. Renvoie
Type	Description
Chaîne	Les initiales de l’utilisateur.

var userInitials = gs.getUser().getInitials();        
gs.addInfoMessage('User initials: ' + userInitials);

Sortie :

User initials: SA

GlideSystem : getMessage(String messageID, Object args)

Récupère les messages traduits à partir de la table Message [sys_ui_message] pour les afficher dans une interface utilisateur.

Si l’identificateur de message spécifié (clé) existe dans la table Message [sys_ui_message] pour la langue actuelle, la méthode renvoie le message traduit. Si l’identificateur de message spécifié n’existe pas pour la langue actuelle, la méthode renvoie la version anglaise du message. Si l’identificateur du message n’existe pas dans la table, il renvoie l’ID du message.

Pour plus d’informations sur la table Message, reportez-vous à la rubrique Table Message.

Remarque :

Si le message de l’interface utilisateur comporte une coche ('), il peut y avoir des problèmes avec le message dans le script ; pour échapper les graduations ('), utilisez getMessageS(String, Object).

Tableau 101. Paramètres
Nom	Type	Description
Messageid	Chaîne	Identificateur de message. Vous pouvez rechercher cette valeur dans le champ Clé de la table Message [sys_ui_message]. Notez que le champ Clé peut ressembler exactement à la chaîne de message réelle.
args	Objet	Facultatif. Liste de chaînes ou d’autres valeurs définies par java.text.MessageFormat qui remplacent les variables dans le message spécifié. Par exemple : `gs.getMessage (« Abandonner l’ajout de l’action '{0}', le même flux secondaire ne peut pas être ajouté deux fois dans ce flux secondaire. », current.action.name) ;` Dans cet exemple `, « {0} »` est remplacé par le contenu de `current.action.name`. Remarque : Les valeurs transmises ne sont pas traduites. Ils sont insérés textuellement dans le message.

Tableau 102. Renvoie
Type	Description
Chaîne	Message d’interface utilisateur demandé.

Cet exemple montre le message renvoyé pour l’utilisateur actuel lorsque l’espagnol est la langue actuelle.

var my_message = gs.getMessage("rows will not be updated");
alert(my_message);

Sortie :

las filas no se actualizarán

Cet exemple montre comment remplacer une seule variable dans un message.

// current.action.name is "update record"
var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in this subflow.", current.action.name);
alert(my_message);

Sortie :

Abort adding action update record, same subflow can't be added twice in this subflow.

Cet exemple montre comment remplacer plusieurs variables dans un message.

// current.sub_flow.name is 'schedule users'
// current.action.name is "update record"
var my_message = gs.getMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
alert(my_message);

Sortie :

Abort adding action update record, same subflow can't be added twice in schedule users subflow.

Équivalent dans le champ d’application

Pour utiliser la méthode getMessage() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getMessage().

GlideSystem : getMessageS(String messageID, Object args)

Récupère les messages traduits à afficher dans l’interface utilisateur et échappe toutes les graduations (').

Si l’identificateur de message spécifié (clé) existe dans la table Message [sys_ui_message] pour la langue actuelle, la méthode renvoie le message traduit. Si l’identificateur de message spécifié n’existe pas pour la langue actuelle, la méthode renvoie la version anglaise du message. Si l’identificateur du message n’existe pas dans la table, il renvoie l’ID du message.

Pour plus d’informations sur la table Message, reportez-vous à la rubrique Table Message.

Utile si vous effectuez une insertion dans une expression JavaScript à partir de Jelly.

Tableau 103. Paramètres
Nom	Type	Description
Messageid	Chaîne	Identificateur de message. Vous pouvez rechercher cette valeur dans le champ Clé de la table Message [sys_ui_message]. Notez que le champ Clé peut ressembler exactement à la chaîne de message réelle.
args	Objet	Facultatif. Liste de chaînes ou d’autres valeurs définies par java.text.MessageFormat qui remplacent les variables dans le message spécifié. Par exemple : `gs.getMessage (« Abandonner l’ajout de l’action '{0}', le même flux secondaire ne peut pas être ajouté deux fois dans ce flux secondaire. », current.action.name) ;` Dans cet exemple `, « {0} »` est remplacé par le contenu de `current.action.name`. Remarque : Les valeurs transmises ne sont pas traduites. Ils sont insérés textuellement dans le message.

Tableau 104. Renvoie
Type	Description
Chaîne	Message spécifié avec des graduations échappées.

/*
"I love France" translates to "J'aime la France" in French.
Rendering this without escaping the tick in "J'aime" would break Jelly, because 
the tick would prematurely end the variable assignment, and everything that 
follows (aime la France') would be a jelly syntax error.
*/
var my_message = '${gs.getMessageS("I love France")}'; 
alert(my_message);

Sortie :

J'aime la France

GlideSystem : getMessageLang(message de chaîne, langage de chaîne, args de tableau)

Traduit le message spécifié dans la langue spécifiée.

Vous pouvez également intégrer des variables dans le message transmis. La méthode résout ces variables avec les valeurs transmises dans le args tableau.

Tableau 105. Paramètres
Nom	Type	Description
message	Chaîne	Message à traduire.
langue	Chaîne	Langue dans laquelle traduire le message. Format : BCP 47 standard
args	Tableau	Facultatif. Liste de chaînes ou d’autres valeurs définies par java.text.MessageFormat qui remplacent les variables dans le message spécifié. Par exemple : `gs.getMessageLang(« Abandonner l’ajout de l’action '{0}', le même flux secondaire ne peut pas être ajouté deux fois dans ce flux secondaire. », current.action.name) ;` Dans cet exemple `, « {0} »` est remplacé par le contenu de `current.action.name`. Remarque : Les valeurs transmises ne sont pas traduites. Ils sont insérés textuellement dans le message.

Tableau 106. Renvoie
Type	Description
Chaîne	Message traduit.

L’exemple suivant transforme le message spécifié en espagnol.

var my_message = gs.getMessageLang("New email", "es");
gs.info(my_message);

Sortie :

Nuevo correo electrónico

L’exemple suivant montre comment remplacer des variables dans un message.

var my_message = gs.getMessageLang("There are {0} new emails for {1}", "es", [current.numEmails, current.userName]);
gs.info(my_message);

Sortie :

Hay 7 correos nuevos para John Smith

GlideSystem : getNodeValue(objet obj, index numérique)

Renvoie la valeur de nœud pour l’index spécifié.

Tableau 107. Paramètres
Nom	Type	Description
obj.	Objet	Objet à examiner.
Index	Numéro	Index à partir duquel obtenir la valeur du nœud.

Tableau 108. Renvoie
Type	Description
Objet	Valeur du nœud

function doInsert(nodeList) {
  gs.print('Doing insert');
  var task = new GlideRecord('task');
  task.initialize();
  for (var x=0; x < nodeList.size(); x++) {
    var name = gs.getNodeName(nodeList, x);
    var value = gs.getNodeValue(nodeList, x);
    task.setValue(name, value);
  }
  task.insert();
}

GlideSystem : getNodeName(objet obj, index numérique)

Renvoie le nom du nœud pour l’index spécifié.

Tableau 109. Paramètres
Nom	Type	Description
obj.	Objet	Objet à examiner.
Index	Numéro	Index à partir duquel obtenir le nom du nœud.

Tableau 110. Renvoie
Type	Description
Chaîne	Nom du nœud

function doInsert(nodeList) {
  gs.print('Doing insert');
  var task = new GlideRecord('task');
  task.initialize();
  for (var x=0; x < nodeList.size(); x++) {
    var name = gs.getNodeName(nodeList, x);
    var value = gs.getNodeValue(nodeList, x);
    task.setValue(name, value);
  }
  task.insert();
}

GlideSystem : getPreference(clé de chaîne, objet par défaut)

Renvoie la préférence utilisateur spécifiée.

Tableau 111. Paramètres
Nom	Type	Description
key	Chaîne	Clé de la préférence.
Par défaut	Objet	Valeur par défaut à utiliser si la préférence spécifiée est introuvable.

Tableau 112. Renvoie
Type	Description
Chaîne	Valeur de préférence. En l’absence de préférence, renvoie la valeur par défaut spécifiée.

function getSelectedProject() {
  var array= new Array();
  var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference
  var gr = new GlideRecord('pm_project_task');
  gr.addQuery('parent', prj_id);
  gr.addActiveQuery();
  while(gr.next()) {
    array.push(gr.sys_id.toString());
  }
  return array;
}

GlideSystem : getProperty(clé de chaîne, alt objet)

Renvoie la valeur d’une propriété Glide. Si la propriété est introuvable, renvoie la valeur spécifiée alt .

Tableau 113. Paramètres
Nom	Type	Description
key	Chaîne	Clé de la propriété dont la valeur doit être renvoyée.
Alt	Objet	Facultatif. Autre objet à renvoyer si la propriété est introuvable.

Tableau 114. Renvoie
Type	Description
Chaîne	Valeur de la propriété Glide ou de l’autre objet défini ci-dessus.

//Check for attachments and add link if there are any
var attachment_link = '';
var rec = new GlideRecord('sc_req_item');
rec.addQuery('sys_id', current.request_item);
rec.query();
if(rec.next()){
  if(rec.hasAttachments()){
    attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
  }   
}

GlideSystem : getScriptError(script de chaîne)

Renvoie l’erreur de script trouvée dans le script spécifié, s’il y en a une.

Remarque :

Le script n’est pas exécuté par cette fonction, il n’est vérifié que pour les erreurs de syntaxe.

Tableau 115. Paramètres
Nom	Type	Description
script	Chaîne	Script pour vérifier les erreurs.

Tableau 116. Renvoie
Type	Description
Chaîne	Message d'erreur. Null s’il n’y a pas d’erreur.

if (gs.isValidScript(current.script) == false)
  {
    current.setAbortAction(true);
    var error = gs.getScriptError(current.script);
    current.script.setError(error);
  }

GlideSystem : getSession()

Renvoie un objet GlideSession.

Tableau 117. Paramètres
Nom	Type	Description
Aucun

Tableau 118. Renvoie
Type	Description
Objet GlideSession	Objet GlideSession pour la session en cours

if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){
  var qc = current.addQuery('u_visibility', "both");
  qc.addOrCondition('u_visibility', '');
  if (gs.getImpersonatingUserName() != null) {
    gs.getSession().clearClientData('navQuery');
  }
  var navQuery = gs.getSession().getClientData('navQuery');
  if (navQuery == null) {
    var isManager = gs.getUser().getRecord().getValue('u_is_manager');
      if (!isManager) {
        qc.addOrCondition('u_visibility', 'nonmanager');
        gs.getSession().putClientData('navQuery', 'nonmanager');
      } else {
        qc.addOrCondition('u_visibility', 'manager');
        gs.getSession().putClientData('navQuery', 'manager');
        }
  } else {
  qc.addOrCondition('u_visibility', navQuery);
  }   
}

Équivalent dans le champ d’application

Pour utiliser la méthode getSession() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getSession().

GlideSystem : getSessionID()

Renvoie l’ID de session GlideSession.

Tableau 119. Paramètres
Nom	Type	Description
Aucun

Tableau 120. Renvoie
Type	Description
Chaîne	ID de session

var gr_NOW = new GlideRecord('v_user_session');
var sessionId = gs.getSessionID();
gs.log("Session ID is: " + sessionId);

Sortie

Session ID is: FEE589B3DB7EE4103DD9C39D139619D7

Équivalent dans le champ d’application

Pour utiliser la méthode getSessionID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getSessionID.

GlideSystem : getStyle(String tableName, String fieldName, String fieldValue)

Renvoie le style défini pour la table, le champ et la valeur de champ.

Tableau 121. Paramètres
Nom	Type	Description
tableName	Chaîne	Nom de la table
Fieldname	Chaîne	Nom de champ
fieldValue	Chaîne	Valeur du champ

Tableau 122. Renvoie
Type	Description
Chaîne	Style du champ spécifié.

var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
gs.print(returnString);

GlideSystem : getTimeFormat()

Renvoie le format d’heure associé à l’utilisateur actuel.

Tableau 123. Paramètres
Nom	Type	Description
Aucun

Tableau 124. Renvoie
Type	Description
Chaîne	Le format d’heure associé à l’utilisateur actuel.

var userTimeFormat = gs. getTimeFormat();
gs.info(userTimeFormat);

Sortie :

HH:mm:ss

GlideSystem : getUser()

Renvoie une référence à l’objet utilisateur pour l’utilisateur actuel.

Tableau 125. Paramètres
Nom	Type	Description
Aucun

Tableau 126. Renvoie
Type	Description
GlideUser (en anglais seulement)	Référence à un objet utilisateur pour l’utilisateur actuel.

L’exemple suivant montre comment obtenir l’objet utilisateur actuel.

var user = gs.getUser();
gs.print ("The current user is: " + user);

Sortie :

The current user is: com.glide.sys.User@db5dd9

L’exemple suivant montre comment vérifier si l’utilisateur actuel dispose du rôle workflow_admin.

var role = gs.getUser().hasRole('workflow_admin');
gs.print ("Does the current user have the workflow_admin role: " + role);

Sortie :

Does the current user have the workflow_admin role: true

Équivalent dans le champ d’application

Pour utiliser la méthode getUser() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUser().

GlideSystem : getUserDisplayName()

Obtient le nom d’affichage de l’utilisateur actuel.

Tableau 127. Paramètres
Nom	Type	Description
Aucun

Tableau 128. Renvoie
Type	Description
Chaîne	Le champ Nom de l’utilisateur actuel. Par exemple, cette méthode renvoie Abel Tuter au lieu d’abel.tuter.

Cet exemple permet d’obtenir le nom d’affichage de l’utilisateur actuel.

gs.info(gs.getUserDisplayName());

Sortie :

System Administrator

Équivalent dans le champ d’application

Pour utiliser la méthode getUserDisplayName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserDisplayName().

GlideSystem : getUserID()

Renvoie les sys_id de l’utilisateur actuel.

Tableau 129. Paramètres
Nom	Type	Description
Aucun

Tableau 130. Renvoie
Type	Description
Chaîne	Sys_id de l’utilisateur actuel.

Cet exemple permet d’obtenir l’sys_id de l’utilisateur actuel.

var currentUserId = gs.getUserID();
gs.print("Current user ID: " + currentUserId);

Sortie :

Current user ID: 6816f79cc0a8016401c5a33be04be441

Équivalent dans le champ d’application

Pour utiliser la méthode getUserID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserID().

GlideSystem : getUserName()

Renvoie le nom d’utilisateur de l’utilisateur actuel.

Tableau 131. Paramètres
Nom	Type	Description
Aucun

Tableau 132. Renvoie
Type	Description
Chaîne	Nom d’utilisateur de l’utilisateur actuel. Par exemple, cette méthode renvoie abel.tuter au lieu d’Abel Tuter.

Cet exemple permet d’obtenir le nom d’utilisateur de l’utilisateur actuel et un utilisateur dont l’identité a été empruntée.

var user = gs.getUserName();
gs.info("The current user name is: " + user);

var impUser = new GlideImpersonate();
impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1");
var user2 = gs.getUserName();
gs.info("The impersonated user name is: " + user2);

Sortie :

The current user name is: admin
The impersonated user name is: abel.tuter

Équivalent dans le champ d’application

Pour utiliser la méthode getUserName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserName().

GlideSystem : getUserNameByUserID(chaîne user_id)

Renvoie le nom d’affichage de l’utilisateur en fonction d’un nom de connexion utilisateur fourni.

Tableau 133. Paramètres
Nom	Type	Description
user_id	Chaîne	Nom de connexion de l’utilisateur à partir duquel récupérer le nom d’affichage associé.

Tableau 134. Renvoie
Type	Description
Chaîne	Nom d’affichage de l’utilisateur demandé. Remarque : Si cette méthode ne trouve pas d’utilisateur avec l’ID demandé, elle renvoie la valeur d’entrée fournie.

L’exemple suivant montre comment obtenir le nom d’affichage de l’utilisateur spécifié.

var displayName = gs.getUserNameByUserID('abel.tuter');
gs.info('User display name is: ' + displayName);

Sortie :

User display name is: Abel Tuter

GlideSystem : getXMLNodeList(String xml)

Construit un tableau de tous les nœuds et valeurs d’un document XML.

Tableau 135. Paramètres
Nom	Type	Description
xml	Chaîne	Document XML à analyser.

Tableau 136. Renvoie
Type	Description
Liste de tableaux	Liste de noms et de valeurs du nœud XML le plus externe.

L’exemple suivant montre comment obtenir une liste de nœuds XML et de leurs valeurs associées dans une liste de tableaux.

var nodeList = gs.getXMLNodeList("<note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note>");
gs.print ("The node contains: " + nodeList);

Sortie :

The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!]

GlideSystem : getXMLText(String xml, String xpathQuery)

Renvoie le texte XML du premier élément de la chaîne XML qui correspond à la requête XPath.

Tableau 137. Paramètres
Nom	Type	Description
xml	Chaîne	Chaîne XML à rechercher.
xpathQuery	Chaîne	Requête XPath à faire correspondre.

Tableau 138. Renvoie
Type	Description
Chaîne	Nœud XML correspondant aux paramètres de recherche.

L’exemple suivant montre comment obtenir la valeur d’un élément XML spécifié dans un nœud transmis.

var nodeList = gs.getXMLText("<outer><note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note></outer>", "//from");
gs.print ("The from element contains: " + nodeList);

Sortie :

The from element contains: Jani

GlideSystem : hasRole(String roleName)

Détermine si l’utilisateur actuel dispose d’au moins un des rôles transmis.

Tableau 139. Paramètres
Nom	Type	Description
roleName	Chaîne	Liste de rôles séparés par des virgules.

Tableau 140. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel dispose d’au moins un des rôles spécifiés. Valeurs possibles : true : l’utilisateur a au moins un des rôles transmis. Renvoie également la valeur true si l’utilisateur dispose du rôle administrateur. false : l’utilisateur ne dispose d’aucun des rôles transmis.

L’exemple suivant montre comment vérifier si l’utilisateur actuel dispose du rôle administrateur ou groups_admin.

if (!gs.hasRole("admin, groups_admin") && gs.getSession().isInteractive()) {
  var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups... 
  qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
}

Équivalent dans le champ d’application

Pour utiliser la méthode hasRole() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : hasRole().

GlideSystem : hasRoleInGroup(Object roleName, Object group)

Détermine si l’utilisateur actuel a le rôle spécifié au sein d’un groupe spécifié.

Tableau 141. Paramètres
Nom	Type	Description
roleName	Objet	Nom du rôle.
groupe	Objet	Sys_id du groupe à vérifier pour le rôle spécifié.

Tableau 142. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel a le rôle spécifié dans le groupe spécifié. Valeurs possibles : true : l’utilisateur connecté est affecté au rôle spécifié dans le groupe spécifié. false : l’utilisateur connecté n’est pas affecté au rôle spécifié dans le groupe spécifié.

L’exemple suivant montre comment vérifier si le groupe sys_user_group dispose du rôle role_name.

var group = new GlideRecord('sys_user_group');
group.addQuery('name', 'GROUP_NAME');
group.setLimit(1);
group.query();
if (group.next()) {
   if (gs.hasRoleInGroup('role_name', group)) {
      gs.print('User has role in group');  
   } else {
      gs.print('User does NOT have role in group');
   }  
}

GlideSystem : hoursAgo (nombre d’heures)

Renvoie la date et l’heure correspondant au nombre spécifié d’heures auparavant. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.

Tableau 143. Paramètres
Nom	Type	Description
Heures	Numéro	Nombre d’heures plus tôt.

Tableau 144. Renvoie
Type	Description
Chaîne	Date et heure UTC pour le nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss

var currentDateTime = gs.hoursAgo(0);
gs.info("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgo(1);
gs.info("Ago date/time: " + agoDateTime);

Sortie

Current date/time: 2021-03-17 20:53:25
Ago date/time: 2021-03-17 19:53:25

Équivalent dans le champ d’application

Pour utiliser la méthode hoursAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : hoursAgo().

GlideSystem : hoursAgoEnd(nombre d’heures)

Renvoie une date et une heure pour la fin de l’heure pour le nombre spécifié d’heures auparavant. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.

Tableau 145. Paramètres
Nom	Type	Description
Heures	Nombre (entier)	Nombre d’heures plus tôt.

Tableau 146. Renvoie
Type	Description
Chaîne	Date et heure UTC de la fin du nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss

var currentDateTime = gs.hoursAgoEnd(0);
gs.print("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgoEnd(1);
gs.print("Ago date/time: " + agoDateTime);

Sortie

Current date/time: 2021-03-17 20:59:59
Ago date/time: 2021-03-17 19:59:59

Équivalent dans le champ d’application

Pour utiliser la méthode hoursAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : hoursAgoEnd().

GlideSystem : hoursAgoStart(nombre d’heures)

Renvoie une date et une heure pour le début de l’heure pour le nombre spécifié d’heures auparavant. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.

Tableau 147. Paramètres
Nom	Type	Description
Heures	Numéro	Nombre d’heures plus tôt.

Tableau 148. Renvoie
Type	Description
Chaîne	Date et heure UTC de la fin du nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss

var currentDateTime = gs.hoursAgoStart(0);
gs.print("Current date/time: " + currentDateTime);

var agoDateTime = gs.hoursAgoStart(1);
gs.print("Ago date/time: " + agoDateTime);

Sortie

Current date/time: 2021-03-17 20:00:00
Ago date/time: 2021-03-17 19:00:00

Équivalent dans le champ d’application

Pour utiliser la méthode hoursAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : hoursAgoStart().

GlideSystem : isFirstDayOfMonth (date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le premier jour du mois.

Tableau 149. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 150. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet de date spécifié est le premier jour du mois. Valeurs possibles : true : premier jour du mois. false : ce n’est pas le premier jour du mois.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le premier jour du mois.

var gdt = new GlideDateTime();
gdt.setValue('2021-04-01 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);

gdt.setValue('2021-04-21 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);

Sortie

First day of month: true
First day of month: false

GlideSystem : isFirstDayOfWeek (date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le premier jour de la semaine. Cette méthode utilise la norme ISO selon laquelle le lundi est le premier jour de la semaine.

Tableau 151. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 152. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet Date actuelle est le premier jour de la semaine (lundi). Valeurs possibles : true : premier jour de la semaine. false : ce n’est pas le premier jour de la semaine.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le premier jour de la semaine.

var gdt = new GlideDateTime();
gdt.setValue('2021-03-02 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);

gdt.setValue('2021-03-22 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);

Sortie

First day of week: false
First day of week: true

GlideSystem : isFirstDayOfYear(date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le premier jour de l’année.

Tableau 153. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 154. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet de date spécifié est le premier jour de l’année. Valeurs possibles : true : premier jour de l’année. false : ce n’est pas le premier jour de l’année.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le premier jour de l’année.

var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);

Sortie

First day of year: false
First day of year: true

GlideSystem - isInteractive()

Vérifie si la session en cours est interactive.

Un exemple de session interactive est lorsqu’un utilisateur se connecte à l’aide de l’écran de connexion. Un exemple de session non interactive est l’utilisation d’une demande SOAP pour récupérer des données.

Tableau 155. Paramètres
Nom	Type	Description
Aucun

Tableau 156. Renvoie
Type	Description
Booléen	Marqueur indiquant si la session est interactive. Valeurs possibles : true : la session est interactive. false : la session n’est pas interactive.

if (!gs.hasRole('admin') && gs.isInteractive()) {
  var qc1 = current.addQuery('u_group', '');
  var gra = new GlideRecord('sys_user_grmember');
  gra.addQuery('user', gs.getUserID());
  gra.query();
  while (gra.next()) {
    qc1.addOrCondition('u_group', gra.group);
  }
}

Équivalent dans le champ d’application

Pour utiliser la méthode isInteractive() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : isInteractive().

GlideSystem : isLastDayofMonth (date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le dernier jour du mois.

Tableau 157. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 158. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet de date spécifié est le dernier jour du mois. Valeurs possibles : true : dernier jour du mois. false : ce n’est pas le dernier jour du mois.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le dernier jour du mois.

var gdt = new GlideDate();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);

Sortie

Last day of month: true
Last day of month: false

GlideSystem : isLastDayOfWeek (date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le dernier jour de la semaine. Cette méthode utilise la norme ISO selon laquelle le dimanche est le dernier jour de la semaine.

Tableau 159. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 160. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet Date actuelle est le dernier jour de la semaine (dimanche). Valeurs possibles : true : dernier jour de la semaine. false : ce n’est pas le dernier jour de la semaine.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le dernier jour de la semaine.

var gdt = new GlideDate();
gdt.setValue('2021-03-01 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);

gdt.setValue('2021-03-21 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);

Sortie

First day of week: false
First day of week: true

GlideSystem : isLastDayOfYear(date de l’objet)

Vérifie si la date dans l’objet de date spécifié est le dernier jour de l’année.

Tableau 161. Paramètres
Nom	Type	Description
date	Objet	Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 162. Renvoie
Type	Description
Booléen	Marqueur indiquant si la date dans l’objet de date actuelle est le dernier jour de l’année. Valeurs possibles : true : dernier jour de l’année. false : ce n’est pas le dernier jour de l’année.

Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le dernier jour de l’année.

var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);

gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);

Sortie

Last day of year: true
Last day of year: false

GlideSystem : isLoggedIn()

Détermine si l’utilisateur actuel est actuellement connecté.

Tableau 163. Paramètres
Nom	Type	Description
Aucun

Tableau 164. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel est connecté. Valeurs possibles : true : l’utilisateur est connecté. false : l’utilisateur n’est pas connecté.

Cet exemple montre comment déterminer si l’utilisateur actuel est connecté.

if(gs.isLoggedIn())
  gs.info("Current user is logged in");
else
  gs.info("Current user is NOT logged in");

Sortie

Current user is logged in

Équivalent dans le champ d’application

Pour utiliser la méthode isLoggedIn() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : isLoggedIn().

GlideSystem - isMobile()

Détermine si la demande provient d’un équipement mobile.

Vous pouvez utiliser cette méthode dans les conditions d’action d’interface utilisateur et les règles métier.

Tableau 165. Paramètres
Nom	Type	Description
Aucun

Tableau 166. Renvoie
Type	Description
Booléen	Marqueur indiquant si la demande provient d’un équipement mobile. Valeurs possibles : true : appareil mobile. false : appareil non mobile.

Cet exemple montre comment déterminer si l’appareil actuel est un appareil mobile.

if(gs.isMobile())
    gs.info("Submitted from mobile UI");
  else 
   gs.info("NOT submitted from mobile UI");

Sortie

Submitted from mobile UI

Équivalent dans le champ d’application

Pour utiliser la méthode isMobile() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : isMobile().

GlideSystem - lastWeek()

Renvoie la date et l’heure d’il y a une semaine (GMT).

Tableau 167. Paramètres
Nom	Type	Description
Aucun

Tableau 168. Renvoie
Type	Description
Chaîne	Date et heure il y a une semaine. Format : aaaa-MM-jj hh :mm :ss

Cet exemple montre comment obtenir la date qui se situe une semaine à partir de la date dans l’objet date actuelle.

var gdt = new GlideDateTime();
gdt.setValue('2021-03-22 01:00:00');

gs.info("Current date: " + gs.nowDateTime());

gs.info("One week earlier: " + gs.lastWeek());

Sortie

Current date: 2021-03-22 15:27:07
One week earlier: 2021-03-15 15:27:07

GlideSystem : log(message de chaîne, source de chaîne)

Consigne un message dans le journal système et l’enregistre dans la table syslog.

Tableau 169. Paramètres
Nom	Type	Description
message	Chaîne	Message à journaliser.
source	Chaîne	Facultatif. Source du message.

Tableau 170. Renvoie
Type	Description
nul

L’exemple suivant montre comment valider une entrée de journal à l’aide de constantes et de variables.

var count = new GlideAggregate('incident');
count.addQuery('active', 'true');
count.addAggregate('COUNT', 'category');
count.query();   
while (count.next()) {
   var category = count.category;
   var categoryCount = count.getAggregate('COUNT', 'category');
   gs.log("The are currently " + categoryCount + " incidents with a category of " + category, "Incident Counter");
}

GlideSystem : logError(message de chaîne, source de chaîne)

Consigne une erreur dans le journal système et l’enregistre dans la table syslog.

Tableau 171. Paramètres
Nom	Type	Description
message	Chaîne	Message d’erreur à journaliser.
source	Chaîne	Facultatif. Source du message.

Tableau 172. Renvoie
Type	Description
nul

L’exemple suivant consigne une erreur si la table Incident est introuvable.

var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
  gs.logError('Incident table could not be found');
  return;
}

GlideSystem : logWarning(message de chaîne, source de chaîne)

Consigne un avertissement dans le journal système et l’enregistre dans la table syslog.

Tableau 173. Paramètres
Nom	Type	Description
message	Chaîne	Message à journaliser.
source	Chaîne	Facultatif. Source du message.

Tableau 174. Renvoie
Type	Description
nul

L’exemple suivant consigne un avertissement si la table Incident est introuvable.

var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
  gs.logWarning('Incident table could not be found');
  return;
}

GlideSystem : minutesAgo (nombre de minutes)

Renvoie une date et une heure pour le nombre spécifié de minutes plus tôt.

Tableau 175. Paramètres
Nom	Type	Description
minutes	Numéro	Nombre de minutes passées à renvoyer.

Tableau 176. Renvoie
Type	Description
Chaîne	Date et heure UTC pour le nombre spécifié de minutes auparavant. Format : aaaa-mm-jj hh :mm :ss

Cet exemple montre comment utiliser la méthode minutesAgo() dans un appel addQuery().

// Check to see if the user has failed to login too many times
// when the limit is reached, lock the user out of the system
//
//Check failed logins in the last 15 minutes
var now_GR = new GlideRecord('sysevent');
now_GR.addQuery('name', 'login.failed');
now_GR.addQuery('parm1', event.parm1.toString());
now_GR.addQuery('sys_created_on','>=', gs.minutesAgo(15));
now_GR.query();
var rowCount = now_GR.getRowCount();
if(rowCount >= 5){
  var now_GR = new GlideRecord("sys_user");
  now_GR.addQuery("user_name", event.parm1.toString());
  now_GR.query();
  if (now_GR.next()) {
    now_GR.locked_out = true;
    now_GR.update();
    gs.log("User " + event.parm1 + " locked out due to too many invalid login attempts");
  }
}

GlideSystem : minutesAgoEnd(nombre de minutes)

Renvoie une date et une heure pour la fin de la minute passée il y a un certain nombre de minutes.

Tableau 177. Paramètres
Nom	Type	Description
minutes	Numéro	Nombre entier de minutes plus tôt, tel que 5 ou 11.

Tableau 178. Renvoie
Type	Description
Chaîne	GMT le nombre spécifié de minutes plus tôt, à la fin de la minute (59 secondes). Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles, ainsi que la date et l’heure 30 minutes plus tôt à la fin de la minute (GMT).

var nowDateTime = new GlideDateTime();
gs.print("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.print("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);

Sortie

Now: 2021-10-20 15:22:13
Thirty minutes ago end time: 2021-10-20 14:52:59

Équivalent dans le champ d’application

Pour utiliser la méthode minutesAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : minutesAgoEnd().

GlideSystem : minutesAgoStart(nombre de minutes)

Renvoie la date et l’heure de début de la minute effectuée il y a un certain nombre de minutes.

Tableau 179. Paramètres
Nom	Type	Description
minutes	Numéro	Nombre entier de minutes plus tôt, tel que 15 ou 112.

Tableau 180. Renvoie
Type	Description
Chaîne	GMT le nombre spécifié de minutes plus tôt, au début de la minute. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles, ainsi que la date et l’heure 30 minutes plus tôt au début de la minute (GMT).

var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30);
gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime);

Sortie

Now: 2021-10-20 14:56:18
Thirty minutes ago: 2021-10-20 14:26:00

Équivalent dans le champ d’application

Pour utiliser la méthode minutesAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : minutesAgoStart().

GlideSystem : monthsAgo (nombre de mois)

Renvoie une date et une heure pour un certain nombre de mois plus tôt.

Tableau 181. Paramètres
Nom	Type	Description
mois	Numéro	Nombre entier de mois plus tôt.

Tableau 182. Renvoie
Type	Description
Chaîne	GMT du nombre spécifié de mois plus tôt à la même heure. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles, ainsi que la date et l’heure d’il y a un mois à la même heure (GMT).

var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var oneMonthAgoDateTime = gs.monthsAgo(1);
gs.info("One month ago: " + oneMonthAgoDateTime);

Sortie

Now: 2021-10-20 15:29:15
One month ago: 2021-09-20 15:29:15

Équivalent dans le champ d’application

Pour utiliser la méthode monthsAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : monthsAgo().

GlideSystem : monthsAgoEnd(nombre de mois)

Renvoie une date et une heure pour le dernier jour du mois il y a un certain nombre de mois.

Tableau 183. Paramètres
Nom	Type	Description
mois	Numéro	Nombre entier de mois, par exemple 4 ou 16.

Tableau 184. Renvoie
Type	Description
Chaîne	GMT : fin du mois, nombre spécifié de mois. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles, ainsi que la date et l’heure d’il y a deux mois, à la fin du mois ouvrable.

var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var endOfTheMonthDateTime = gs.monthsAgoEnd(2);
gs.info("End of the month: " + endOfTheMonthDateTime);

Sortie

Now: 2021-10-20 19:23:35
End of the month: 2021-09-01 06:59:59

GlideSystem : monthsAgoStart (nombre de mois)

Renvoie une date et une heure pour le début du mois il y a un certain nombre de mois.

Tableau 185. Paramètres
Nom	Type	Description
mois	Numéro	Nombre entier de mois plus tôt, par exemple 5 ou 14.

Tableau 186. Renvoie
Type	Description
Chaîne	GMT début du mois spécifié il y a plusieurs mois. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles, ainsi que la date et l’heure d’il y a trois mois en GMT.

var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var threeMonthsAgoDateTime = gs.monthsAgoStart(3);
gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime);

Sortie

Now: 2021-10-20 15:05:27
Three months ago start date and time: 2021-07-01 07:00:00

Équivalent dans le champ d’application

Pour utiliser la méthode monthsAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : monthsAgoStart().

GlideSystem - néant(objet obj)

Interroge un objet et renvoie true si l’objet est null ou contient une chaîne vide.

Tableau 187. Paramètres
Nom	Type	Description
obj.	Objet	Objet à vérifier.

Tableau 188. Renvoie
Type	Description
Booléen	Vrai si chaîne nulle ou vide ; sinon, faux.

if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
  var start = current.u_date1.getGlideObject().getNumericValue();
  var end = current.u_date2.getGlideObject().getNumericValue();
  if (start > end) {
    gs.addInfoMessage('start must be before end');
    current.u_date1.setError('start must be before end');
    current.setAbortAction(true);
  }
}

Équivalent dans le champ d’application

Pour utiliser la méthode nil() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : nil().

GlideSystem - now()

Renvoie la date actuelle en UTC.

Tableau 189. Paramètres
Nom	Type	Description
Aucun

Tableau 190. Renvoie
Type	Description
Chaîne	La date actuelle au format défini par l’utilisateur, au format UTC.

// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
 
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
    // Do something based on the Password Changing
    gs.log("The user password changed so do something else...");
    now_GR.u_password_last_reset = gs.now();
    now_GR.update();
}

GlideSystem - nowNoTZ()

Renvoie la date et l’heure actuelles au format UTC.

Tableau 191. Paramètres
Nom	Type	Description
Aucun

Tableau 192. Renvoie
Type	Description
Chaîne	La date et l’heure UTC actuelles

// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
 
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
    // Do something based on the Password Changing
    gs.log("The user password changed so do something else...");
    now_GR.u_password_last_reset = gs.nowNoTZ();
    now_GR.update();
}

GlideSystem - nowDateTime()

Renvoie la date et l’heure actuelles au format défini par l’utilisateur.

Tableau 193. Paramètres
Nom	Type	Description
Aucun

Tableau 194. Renvoie
Type	Description
Chaîne	Date et heure actuelles au format défini par l’utilisateur. Pour plus d’informations sur la définition du format de date et d’heure du système, consultez les champs Date et Date/Heure.

var currentDateTime = gs.nowDateTime();
gs.print("Current date/time: " + currentDateTime);

Sortie

Current date/time: 2021-03-17 14:04:02

Lors de la définition d’une variable dans un script de workflow sur la date et l’heure actuelles, utilisez la méthode setDisplayValue(). Le script suivant définit la variable de workflow end_date à la date et à l’heure actuelles.

current.variables.end_date.setDisplayValue(gs.nowDateTime());

GlideSystem : nowGlideDateTime()

Obtient un objet GlideDateTime avec la date et l’heure actuelles.

Une fois que vous avez obtenu un objet GlideDateTime avec la date et l’heure actuelles, vous pouvez utiliser les méthodes GlideDateTime pour effectuer des opérations date-heure, telles que l’exécution de calculs de date-heure, la mise en forme d’une date-heure ou la conversion entre les formats date-heure.

Tableau 195. Paramètres
Nom	Type	Description
Aucun

Tableau 196. Renvoie
Type	Description
Objet	GlideDateTime avec la date et l’heure actuelles au format GMT.

Définit la u_target_date du champ sur la date et l’heure actuelles au format GMT.

current.u_target_date = gs.nowGlideDateTime();

GlideSystem - print (message de chaîne)

Écrit un message dans le journal système.

Cette méthode n’écrit pas le message dans la table syslog à moins que le débogage n’ait été activé.

Tableau 197. Paramètres
Nom	Type	Description
message	Chaîne	Message à consigner

Tableau 198. Renvoie
Type	Description
nul

var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while (rec.next()) { 
 gs.print('Inactive incident ' + rec.number + ' deleted');
 rec.deleteRecord();
}

GlideSystem : quartersAgo (nombre de trimestres)

Renvoie une date et une heure pour un certain nombre de trimestres plus tôt.

Tableau 199. Paramètres
Nom	Type	Description
trimestres	Numéro	Nombre entier des trimestres plus tôt.

Tableau 200. Renvoie
Type	Description
Chaîne	GMT du trimestre qui était le nombre spécifié de trimestres auparavant. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche simultanément la date et l’heure actuelles et la date et l’heure d’il y a quatre trimestres.

var nowDateTime = new GlideDateTime();
gs.print("Now: " + nowDateTime);
var fourQuartersAgoDateTime = gs.quartersAgo(4);
gs.print("Four quarters ago: " + fourQuartersAgoDateTime);

Sortie

Now: 2021-10-20 16:27:32
Four quarters ago: 2020-10-20 16:27:32

GlideSystem : quartersAgoEnd(Nombre de trimestres)

Renvoie une date et une heure pour le dernier jour du trimestre, pour un nombre spécifié de trimestres plus tôt.

Tableau 201. Paramètres
Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 202. Renvoie
Type	Description
Chaîne	GMT fin du trimestre qui était le nombre spécifié de trimestres, au format aaaa-mm-jj hh :mm :ss

Équivalent dans le champ d’application

Pour utiliser la méthode quartersAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : quartersAgoEnd().

GlideSystem : quartersAgoStart(Nombre de trimestres)

Renvoie la date et l’heure du premier jour du trimestre, pour un nombre spécifié de trimestres auparavant.

Tableau 203. Paramètres
Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 204. Renvoie
Type	Description
Chaîne	GMT fin du mois qui était le nombre spécifié de trimestres, au format aaaa-mm-jj hh :mm :ss

Équivalent dans le champ d’application

Pour utiliser la méthode quartersAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : quartersAgoStart().

GlideSystem - setProperty(clé de chaîne, valeur de chaîne, description de chaîne)

Définit la clé spécifiée sur la valeur spécifiée.

Remarque :

Des précautions doivent être prises lors de la définition des propriétés système (sys_properties) à l’aide de cette méthode, car elle provoque une purge du cache à l’échelle du système. Chaque purge peut entraîner une dégradation du système pendant la reconstruction des caches. Si une valeur doit être mise à jour souvent, elle ne doit pas être stockée en tant que propriété système. En règle générale, vous ne devez placer dans la table sys_properties que des valeurs qui ne changent pas fréquemment.

Tableau 205. Paramètres
Nom	Type	Description
key	Chaîne	Clé de la propriété à définir.
valide	Chaîne	La valeur de la propriété à définir.
description	Chaîne	Description de la propriété.

Tableau 206. Renvoie
Type	Description
nul

gs.setProperty("glide.foo","bar","foo");
gs.info(gs.getProperty("glide.foo"));

Sortie : bar

Équivalent dans le champ d’application

Pour utiliser la méthode setProperty() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : setProperty().

GlideSystem - setRedirect(URI de l’objet)

Définit l’URI de redirection pour cette transaction, qui détermine ensuite la page suivante que l’utilisateur verra.

Tableau 207. Paramètres
Nom	Type	Description
URI	Objet	URI à définir comme redirection

Tableau 208. Renvoie
Type	Description
nul

Cet exemple redirige l’utilisateur vers un élément de catalogue particulier et transmet l’e-mail actuel comme paramètre.

gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user=" 
+ current.sys_id + "&sysparm_email=" + current.email)

Équivalent dans le champ d’application

Pour utiliser la méthode setRedirect() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : setRedirect().

GlideSystem - setReturn(URI d’objet)

Définit l’URI de retour pour cette transaction. Cela détermine la page vers laquelle l’utilisateur sera redirigé lorsqu’il reviendra du formulaire suivant.

Tableau 209. Paramètres
Nom	Type	Description
URI	Objet	URI à définir comme emplacement de retour.

Tableau 210. Renvoie
Type	Description
nul

Cet exemple garantit que l’utilisateur sera renvoyé à la page actuelle lorsqu’il aura terminé de passer à la suivante.

gs.setReturn (current.getLink(true));

GlideSystem : tableExists(String tableName)

Détermine si une table de base de données existe dans l’instance ServiceNow .

Tableau 211. Paramètres
Nom	Type	Description
tableName	Chaîne	Nom de la table à vérifier.

Tableau 212. Renvoie
Type	Description
Booléen	Marqueur indiquant si la table spécifiée existe dans l’instance ServiceNow . Valeurs possibles : true : la table existe false : la table n’existe pas.

Cet exemple montre la vérification de l’existence des tables incident et foo dans l’instance ServiceNow .

gs.info("Does the incident table exist? " + gs.tableExists("incident"));

gs.info("Does the foo table exist? " + gs.tableExists("foo"));

Sortie

Does the incident table exist? true
Does the foo table exist? false

Équivalent dans le champ d’application

Pour utiliser la méthode tableExists() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : tableExists().

GlideSystem : userID()

Renvoie l’sys_id de l’utilisateur associé à cette session. Utilisez getUserID() à la place.

Tableau 213. Paramètres
Nom	Type	Description
Aucun

Tableau 214. Renvoie
Type	Description
Chaîne	Sys_id de l’utilisateur actuel.

L’exemple suivant montre comment annuler l’affectation de tous les enregistrements d’incidents actifs affectés à l’utilisateur actuel.

var incidentGR = new GlideRecord('incident');
incidentGR.addActiveQuery();

// Filter results to incidents assigned to the current user
var currentUserSysId = gs.userID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();

while (incidentGR.next()) {
    incidentGR.setValue('assigned_to', 'NULL');
    incidentGR.update();
    gs.info(
        'Unassigned Incident: {0}: {1}',
        incidentGR.number.toString(),
        incidentGR.short_description.toString()
    );
}

Sortie :

Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1

GlideSystem : workflowFlush(Objet glideRecord)

Supprime tous les enregistrements de travaux planifiés ouverts dans la table Calendrier (sys_trigger) pour le GlideRecord spécifié.

Tableau 215. Paramètres
Nom	Type	Description
glideRecord	Objet	Le GlideRecord

Tableau 216. Renvoie
Type	Description
nul

GlideSystem : annéesAgo (nombre d’années)

Obtient une date et une heure pour un certain nombre d’années.

Tableau 217. Paramètres
Nom	Type	Description
années	Numéro	Nombre entier d’années

Tableau 218. Renvoie
Type	Description
Chaîne	GMT début de l’année correspondant au nombre spécifié d’années, au format aaaa-mm-jj hh :mm :ss.

Équivalent dans le champ d’application

Pour utiliser la méthode yearsAgo(Nombre d’années) dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : yearsAgo(Nombre d’années).

GlideSystem - hier()

Renvoie l’heure d’hier (il y a 24 heures).

Tableau 219. Paramètres
Nom	Type	Description
Aucun

Tableau 220. Renvoie
Type	Description
Chaîne	GMT pour il y a 24 heures, au format aaaa-mm-jj hh :mm :ss

Équivalent dans le champ d’application

Pour utiliser la méthode yesterday() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : yesterday().