GlideSystem - Global

L’API GlideSystem , qui est désignée par le nom de variable gs dans n’importe quel JavaScript côté serveur, fournit un certain nombre de méthodes pratiques pour obtenir des informations sur le système, l’utilisateur connecté actuel et les informations de date/heure.

De nombreuses méthodes GlideSystem facilitent l’inclusion de dates dans les plages de requêtes et sont le plus souvent utilisées dans les filtres et les rapports.

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 correspondante incluse dans le périmètre : 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 correspondante dans le périmètre : 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, tel qu’erreur ou information.
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 GMT du début du mois dernier, au format aaaa-mm-jj hh :mm :ss.

Dans cet exemple, il 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 (GMT).

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel est définie sur le 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 délimitée correspondante : beginningOfLastWeek().

GlideSystem : beginningOfNextWeek()

Renvoie la date et l’heure du début de la semaine prochaine (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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel est définie sur le 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 délimitée correspondante : beginningOfNextWeek().

GlideSystem - beginningOfNextMonth()

Renvoie la date et l’heure du début du mois suivant (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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel est définie sur le début du mois prochain.

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 correspondante dans le périmètre : beginningOfNextMonth().

GlideSystem - beginningOfNextYear()

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

Tableau 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. Renvoie

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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel est définie sur le 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 correspondante dans le champ d’application : beginningOfNextYear().

GlideSystem - beginningOfThisMonth()

Renvoie la date et l’heure du début du mois en cours (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 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 délimitée correspondante : beginningOfThisMonth().

GlideSystem - beginningOfThisQuarter()

Renvoie la date et l’heure du début du trimestre en cours (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 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 délimitée correspondante : beginningOfThisQuarter().

GlideSystem - beginningOfThisWeek()

Renvoie la date et l’heure du début de cette semaine (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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel est définie sur le 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 délimitée correspondante : beginningOfThisWeek().

GlideSystem - beginningOfThisYear()

Renvoie la date et l’heure du début de cette année (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 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 délimitée correspondante : beginningOfThisYear().

GlideSystem - beginningOfToday()

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

Tableau 25. Paramètres

Nom	Type	Description
Aucun

Tableau 26. Renvoie

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

Dans cet exemple, la valeur de l’enregistrement date/heure Glide actuel correspond au 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 à partir 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 (GMT).

Tableau 29. Paramètres

Nom	Type	Description
Aucun

Tableau 30. Renvoie

Type	Description
Chaîne	Le GMT commençant 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 pendant 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 dans le format de date de l’utilisateur actuel.
endDate	Chaîne	Date de fin à comparer dans le format de date de l’utilisateur actuel.
valeur numérique	Booléen	Marqueur qui indique 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 renvoyée est au format jjj hh :mm :ss.

Tableau 32. Renvoie

Type	Description
Chaîne	Si le numericValue paramètre 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 jj 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 dans le format date/heure utilisateur/système, qui peut différer du format interne. L’utilisation de paramètres dans des formats autres que le format de 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 dans le format de date de l’utilisateur actuel.
endDate	Chaîne	La date de fin à comparer dans le 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 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 la forme d’un nombre entier de secondes ; Si faux, renvoie la différence entre les deux dates au format jjv 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 (GMT).

Tableau 35. Paramètres

Nom	Type	Description
date	Chaîne	Date à générer au format GMT. Format : jj-mm-aaaa
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 correspondante dans le périmètre : dateGenerate().

GlideSystem : daysAgo (nombre de jours)

Renvoie une date et une heure pour un certain nombre de jours auparavant.

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 auparavant. 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 correspondante dans le périmètre : daysAgo().

GlideSystem : daysAgoEnd(nombre de jours)

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

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 correspondante dans le périmètre : daysAgoEnd().

GlideSystem : daysAgoLocal(nombre de jours)

Renvoie la date et l’heure de début de la journée pour le nombre de jours spécifiés auparavant. 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 de la 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 de début de la journée il y a un nombre de jours spécifié.

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 correspondante dans le périmètre : daysAgoStart().

GlideSystem : endOfLastMonth()

Renvoie la date et l’heure de la fin du mois dernier en 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 délimitée correspondante : endOfLastMonth().

GlideSystem : endOfLastWeek()

Renvoie la date et l’heure de la fin de la semaine dernière (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 correspondante dans le périmètre : endOfLastWeek().

GlideSystem : endOfLastYear()

Renvoie la date et l’heure de fin de l’année dernière en 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 l’année écoulé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 délimitée correspondante : endOfLastYear().

GlideSystem : endOfNextMonth()

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

Tableau 51. Paramètres

Nom	Type	Description
Aucun

Tableau 52. Renvoie

Type	Description
Chaîne	Données GMT et heure. 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 d’aujourd’hui 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 (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 correspondante dans le périmètre : endOfNextWeek().

GlideSystem : endOfNextYear()

Renvoie la date et l’heure de fin de l’année prochaine en 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 délimitée correspondante : endOfNextYear().

GlideSystem : endOfThisMonth()

Renvoie la date et l’heure de fin de ce mois en 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 délimitée correspondante : endOfThisMonth().

GlideSystem : endOfThisQuarter()

Renvoie la date et l’heure de fin de ce trimestre (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 délimitée correspondante : endOfThisQuarter().

GlideSystem : endOfThisWeek()

Renvoie la date et l’heure de fin de cette semaine (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 délimitée correspondante : endOfThisWeek().

GlideSystem : endOfThisYear()

Renvoie la date et l’heure de fin de cette année en 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 délimitée correspondante : endOfThisYear().

GlideSystem : endOfToday()

Récupère la date et l’heure de fin de la journée (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 (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 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	Objet GlideRecord, tel que « current ».
parm1	Chaîne	(Facultatif) Enregistré avec l’instance indiquée
parm2	Chaîne	(Facultatif) Enregistré avec l’instance indiqué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 délimitée 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	Objet GlideRecord, tel que « current ».
parm1	Chaîne	(Facultatif) Enregistré avec l’instance indiquée
parm2	Chaîne	(Facultatif) Enregistré avec l’instance indiquée
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.
recordID	Chaîne	Sys_id pour le compte rendu.
Fieldname	Chaîne	Nom du champ dont la valeur d’affichage doit être renvoyée.

Tableau 88. Renvoie

Type	Description
Chaîne	Valeur d’affichage du champ.

Cet exemple montre comment utiliser getDisplayValueFor() pour renvoyer la valeur d’affichage du champ de nombre .

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 correspondante délimitée : getErrorMessages().

GlideSystem : getEscapedProperty(clé de chaîne, objet 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.
substituteObject (Objet substitué)	Objet	Facultatif. Objet à retourner si la propriété n’est pas trouvée.

Tableau 92. Renvoie

Type	Description
Chaîne	Property, ou le substituteObject si la propriété n’est pas trouvée.

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 emprunteur de l’identité.

Cet exemple montre comment obtenir le nom d’affichage d’utilisateur 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, arguments de l’objet)

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 de message n’existe pas dans la table, il renvoie l’ID du message.

Pour plus d’informations sur la table Message, consultez 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 aux graduations ('), utilisez getMessageS(String, Object).

Tableau 101. Paramètres

Nom	Type	Description
ID message	Chaîne	Identificateur de message. Vous pouvez localiser 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 courante.

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 correspondante incluse dans le périmètre : getMessage().

GlideSystem : getMessagesS(String messageID, Object args)

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

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 de message n’existe pas dans la table, il renvoie l’ID du message.

Pour plus d’informations sur la table Message, consultez Table Message.

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

Tableau 103. Paramètres

Nom	Type	Description
ID du message	Chaîne	Identificateur de message. Vous pouvez localiser 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 passées dans le args tableau.

Tableau 105. Paramètres

Nom	Type	Description
message	Chaîne	Message à traduire.
language	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 : getNodeName(objet obj., index numérique)

Renvoie le nom du 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 le nom du nœud.

Tableau 108. 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 : getNodeValue(objet obj, index numérique)

Renvoie la valeur de 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 la valeur du nœud

Tableau 110. 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 : 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é pour la préférence.
Par défaut	Objet	Valeur par défaut à utiliser si la préférence spécifiée n’est pas trouvée.

Tableau 112. Renvoie

Type	Description
Chaîne	Valeur de préférence. S’il n’y a pas 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 à retourner 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é, le cas échéant.

Remarque :

Le script n’est pas exécuté par cette fonction, il est seulement vérifié 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. Nul 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 correspondante délimitée : 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 délimitée 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 de 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 correspondante dans le périmètre : 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 du nom de l’utilisateur actuel. Par exemple, cette méthode renvoie Abel Tuter plutôt que abel.tuter.

Cet exemple récupère 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 correspondante dans le périmètre : getUserDisplayName().

GlideSystem : getUserID()

Renvoie l’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 récupère 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 correspondante dans le périmètre : 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	Le nom d’utilisateur de l’utilisateur actuel. Par exemple, cette méthode renvoie abel.tuter au lieu d’Abel Tuter.

Cet exemple obtient 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 correspondante dans le périmètre : getUserName().

GlideSystem : getUserNameByUserID(chaîne user_id)

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

Tableau 133. Paramètres

Nom	Type	Description
user_id	Chaîne	Nom de connexion de l’utilisateur dont le nom d’affichage associé doit être récupéré.

Tableau 134. Renvoie

Type	Description
Chaîne	Nom d’affichage de l’utilisateur demandé. Remarque : Si cette méthode ne parvient pas à trouver un 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 pour le 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
nom du rôle	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 dispose d’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 a le 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 correspondante dans le périmètre : hasRole().

GlideSystem : hasRoleInGroup(Object roleName, groupe d’objets)

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

Tableau 141. Paramètres

Nom	Type	Description
nom du rôle	Objet	Nom du rôle.
groupe	Objet	Sys_id du groupe pour vérifier le rôle spécifié.

Tableau 142. Renvoie

Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel dispose du rôle spécifié dans le groupe spécifié. Valeurs possibles : vrai : l’utilisateur connecté est affecté au rôle spécifié dans le groupe spécifié. faux : 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 pour le nombre d’heures spécifié. 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 d’heures spécifié. 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 correspondante délimitée : hoursAgo().

GlideSystem : hoursAgoEnd(nombre d’heures)

Renvoie une date et une heure de fin d’heure pour le nombre d’heures spécifié. 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 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 correspondante dans le périmètre : hoursAgoEnd().

GlideSystem : hoursAgoStart(nombre d’heures)

Renvoie une date et une heure de début de l’heure pour le nombre d’heures spécifié. 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 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 correspondante délimitée : 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 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 de 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 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 de 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 de 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 date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 154. Renvoie

Type	Description
Booléen	Marqueur qui indique 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. faux : 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 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 de l’objet de 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 date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate.

Tableau 160. Renvoie

Type	Description
Booléen	Marqueur qui indique si la date dans l’objet de 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 de l’objet de 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 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 : vrai : 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 délimitée 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 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 : journal (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 auparavant.

Tableau 175. Paramètres

Nom	Type	Description
minutes	Numéro	Nombre de minutes dans le passé pour revenir.

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 de fin de minute 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 et 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 correspondante dans le périmètre : minutesAgoEnd().

GlideSystem : minutesAgoStart(nombre de minutes)

Renvoie une date et une heure de début de la minute 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 délimitée correspondante : minutesAgoStart().

GlideSystem : monthsAgo (nombre de mois)

Renvoie une date et une heure pour un certain nombre de mois auparavant.

Tableau 181. Paramètres

Nom	Type	Description
mois	Numéro	Nombre entier de mois auparavant.

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 et la date et l’heure d’il y a un mois en même temps en 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 un certain nombre de mois plus tôt.

Tableau 183. Paramètres

Nom	Type	Description
mois	Numéro	Nombre entier de mois, tel que 4 ou 16.

Tableau 184. Renvoie

Type	Description
Chaîne	GMT à la fin du mois, le nombre spécifié de mois plus tôt. 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 un certain nombre de mois plus tôt.

Tableau 185. Paramètres

Nom	Type	Description
mois	Numéro	Nombre entier de mois passé, tel que 5 ou 14.

Tableau 186. Renvoie

Type	Description
Chaîne	GMT début du mois le nombre spécifié de mois plus tôt. 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 correspondante dans le périmètre : monthsAgoStart().

GlideSystem - néant(objet obj)

Interroge un objet et renvoie la valeur true si l’objet est nul 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 correspondante dans le périmètre : nil().

GlideSystem : now()

Renvoie la date du jour en UTC.

Tableau 189. Paramètres

Nom	Type	Description
Aucun

Tableau 190. Renvoie

Type	Description
Chaîne	La date du jour 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, voir 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 de 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 de 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 auparavant.

Tableau 199. Paramètres

Nom	Type	Description
trimestres	Numéro	Nombre entier de 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 auparavant.

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 correspondante délimitée : quartersAgoEnd().

GlideSystem : quartersAgoStart(Nombre de trimestres)

Renvoie une date et une heure pour le 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 correspondante dans le périmètre : quartersAgoStart().

GlideSystem : setProperty(clé de chaîne, valeur de chaîne, description de la 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 entraîne une purge du cache à l’échelle du système. Chaque vidage peut entraîner une dégradation du système pendant que les caches se reconstruisent. Si une valeur doit être mise à jour souvent, elle ne doit pas être stockée en tant que propriété système. En général, vous ne devez placer dans la table sys_properties que les 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 : barre

É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 correspondante dans le périmètre : setProperty().

GlideSystem - setRedirect(URI d’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 en tant que 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 en tant que 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 dirigé lorsqu’il revient 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 revient à la page actuelle lorsqu’il a terminé de passer à la page 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 faux : la table n’existe pas

Cet exemple montre comment vérifier si les tables incident et foo existent 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 correspondante dans le périmètre : tableExists().

GlideSystem : userID()

Renvoie le 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’incident 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(Object glideRecord)

Supprime tous les enregistrements de travaux planifiés ouverts dans la table de 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 : yearsAgo(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	Un nombre entier d’années

Tableau 218. Renvoie

Type	Description
Chaîne	GMT début de l’année qui correspond 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(Number years) dans une application incluse dans le champ d’application, utilisez la méthode du champ d’application correspondante : yearsAgo(Number years).

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 correspondante dans le périmètre : yesterday().