GlideSystem - Dans le champ d’application

L’API GlideSystem incluse dans le périmètre fournit un certain nombre de méthodes pratiques pour obtenir des informations sur le système, l’utilisateur connecté actuel et d’autres informations au niveau du système.

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 inclus dans le champ d’application : addErrorMessage(message de chaîne)

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

Tableau 1. Paramètres

Nom	Type	Description
message	Chaîne	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
       }
  }

GlideSystem inclus dans le champ d’application : addInfoMessage(message de chaîne)

Ajoute un message d’information pour la session en cours. Cette méthode n’est pas prise en charge pour les règles métier asynchrones.

Tableau 3. Paramètres

Nom	Type	Description
message	Chaîne	Message d’information à 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);
  }
}

GlideSystem inclus dans le champ d’application : base64Encode(source de chaîne)

Crée une chaîne base64 à partir de la chaîne spécifiée.

Tableau 5. Paramètres

Nom	Type	Description
source	Chaîne	Chaîne à coder.

Tableau 6. Renvoie

Type	Description
Chaîne	Chaîne base64 codée.

L’exemple de code suivant montre comment appeler cette méthode.

var mac = new CertificateEncryption;
var key = "sample_key"; 
key = gs.base64Encode(key);
mac.generateMac(key, "HmacSHA256", "sample_data");

GlideSystem inclus dans le périmètre : base64Decode(source de chaîne)

Renvoie une chaîne ASCII à partir de la chaîne base64 spécifiée.

Tableau 7. Paramètres

Nom	Type	Description
source	Chaîne	Chaîne codée base64.

Tableau 8. Renvoie

Type	Description
Chaîne	Chaîne décodée.

GlideSystem inclus dans le périmètre : beginningOfLastMonth()

Renvoie la date et l’heure du début du mois dernier (GMT).

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

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

GlideSystem inclus dans le périmètre : beginningOfLastWeek()

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

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

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

GlideSystem inclus dans le périmètre : 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, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : beginningOfNextWeek()

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

Tableau 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. Renvoie

Type	Description
Chaîne	Le GMT début de la semaine prochaine, au format aaaa-mm-jj hh :mm :ss.

GlideSystem inclus dans le périmètre : beginningOfNextYear()

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

Tableau 17. Paramètres

Nom	Type	Description
Aucun

Tableau 18. Renvoie

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

GlideSystem inclus dans le périmètre : beginningOfThisMonth()

Renvoie la date et l’heure du début de ce mois en GMT.

Tableau 19. Paramètres

Nom	Type	Description
Aucun

Tableau 20. Renvoie

Type	Description
Chaîne	GMT au début de ce mois, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : beginningOfThisQuarter()

Renvoie la date et l’heure du début de ce trimestre (GMT).

Tableau 21. Paramètres

Nom	Type	Description
Aucun

Tableau 22. Renvoie

Type	Description
Chaîne	GMT début de ce trimestre, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : beginningOfThisWeek()

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

Tableau 23. Paramètres

Nom	Type	Description
Aucun

Tableau 24. Renvoie

Type	Description
Chaîne	GMT début de cette semaine, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : beginningOfThisYear()

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

Tableau 25. Paramètres

Nom	Type	Description
Aucun

Tableau 26. Renvoie

Type	Description
Chaîne	GMT au début de cette année, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : dateGenerate(chaîne, date, plage de chaînes)

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

Tableau 27. Paramètres

Nom	Type	Description
date	Chaîne	Date pour laquelle générer l’heure GMT. Format : jj-mm-aaaa
gamme	Chaîne	Début, fin ou une heure au format 24 heures hh :mm :ss.

Tableau 28. 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

GlideSystem inclus dans le champ d’application : daysAgo (nombre de jours)

Renvoie la date et l’heure d’un nombre spécifié de jours auparavant.

Tableau 29. Paramètres

Nom	Type	Description
jours	Numéro	Nombre entier de jours

Tableau 30. Renvoie

Type	Description
Chaîne	GMT au 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();
}

GlideSystem inclus dans le champ d’application : daysAgoEnd(nombre de jours)

Renvoie la date et l’heure de fin de la journée un nombre spécifié de jours auparavant.

Tableau 31. Paramètres

Nom	Type	Description
jours	Numéro	Nombre entier de jours

Tableau 32. Renvoie

Type	Description
Chaîne	GMT fin de journée au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : daysAgoStart(nombre de jours)

Renvoie la date et l’heure du début de la journée il y a un nombre spécifié de jours.

Tableau 33. Paramètres

Nom	Type	Description
jours	Chaîne	Nombre entier de jours

Tableau 34. 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();

GlideSystem inclus dans le champ d’application : debug(message de chaîne, objet parm1, objet parm2, objet parm3, objet parm4, objet parm5)

Écrit un message de débogage dans le journal système.

Tableau 35. Paramètres

Nom	Type	Description
message	Chaîne	Message du journal avec des espaces réservés pour tous les arguments de variable.
param1	Objet	(Facultatif) Argument de la première variable.
param2	Objet	(Facultatif) Deuxième argument variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument variable.
param5	Objet	(Facultatif) Cinquième argument variable.

Tableau 36. Renvoie

Type	Description
nul

gs.debug("This is a debug message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a debug message from {0}.{1}", myFirstName, myLastName);

Sortie :

This is a debug message (sys.scripts extended logging)
This is a debug message from Abel.Tuter (sys.scripts extended logging)

GlideSystem inclus dans le périmètre : endOfLastMonth()

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

Tableau 37. Paramètres

Nom	Type	Description
Aucun

Tableau 38. Renvoie

Type	Description
Chaîne	GMT fin du mois dernier, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfLastWeek()

Renvoie la date et l’heure de la fin de la semaine dernière (GMT).

Tableau 39. Paramètres

Nom	Type	Description
Aucun

Tableau 40. Renvoie

Type	Description
Chaîne	GMT fin de semaine dernière, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfLastYear()

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

Tableau 41. Paramètres

Nom	Type	Description
Aucun

Tableau 42. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfNextMonth()

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

Tableau 43. Paramètres

Nom	Type	Description
Aucun

Tableau 44. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfNextWeek()

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

Tableau 45. Paramètres

Nom	Type	Description
Aucun

Tableau 46. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfNextYear()

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

Tableau 47. Paramètres

Nom	Type	Description
Aucun

Tableau 48. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfThisMonth()

Renvoie la date et l’heure de fin de ce mois 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

GlideSystem inclus dans le périmètre : endOfThisQuarter()

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

Tableau 51. Paramètres

Nom	Type	Description
Aucun

Tableau 52. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfThisWeek()

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

Tableau 53. Paramètres

Nom	Type	Description
Aucun

Tableau 54. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : endOfThisYear()

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

Tableau 55. Paramètres

Nom	Type	Description
Aucun

Tableau 56. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le périmètre : erreur (message de chaîne, objet parm1, objet parm2, objet parm3, objet parm4, objet parm5)

Écrit un message d’erreur dans le journal système.

Cette méthode accepte jusqu’à cinq arguments de variable (varargs) dans le message à l’aide du modèle de remplacement de l’espace réservé Java MessageFormat.

Remarque :

Les variables doivent contenir des valeurs valides pour que cette méthode fournisse une sortie correcte.

Tableau 57. Paramètres

Nom	Type	Description
message	Chaîne	Message du journal avec des espaces réservés pour tous les arguments de variable.
param1	Objet	(Facultatif) Argument de la première variable.
param2	Objet	(Facultatif) Deuxième argument variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument variable.
param5	Objet	(Facultatif) Cinquième argument variable.

Tableau 58. Renvoie

Type	Description
nul

gs.error("This is an error message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.error("This is an error message from {0}.{1}", myFirstName, myLastName);

Sortie :

This is an error message
This is an error message from Abel.Tuter

GlideSystem inclus dans le champ d’application : eventQueue(nom de chaîne, instance d’objet, 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 59. Paramètres

Nom	Type	Description
nom	Chaîne	Nom de l’événement mis en file d’attente.
instance	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	Facultatif. Nom de la file d'attente.

Tableau 60. Renvoie

Type	Description
nul

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

GlideSystem inclus dans le champ d’application : eventQueueScheduled(nom de la chaîne, instance d’objet, chaîne parm1, chaîne parm2, expiration de l’objet)

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

Les informations transmises sur le calendrier des événements sont stockées dans la table Événements [sysevent]. Pour plus d’informations sur les événements, voir Événements.

Tableau 61. Paramètres

Nom	Type	Description
nom	Chaîne	Nom de l’événement à mettre en file d’attente.
instance	Objet/Chaîne	GlideRecord ou sys_id de l’enregistrement auquel cet événement s’applique.
parm1	Chaîne	Facultatif. Chaîne à transmettre dans le script d’événement. Ce paramètre est de forme libre et dépend de l’implémentation du script d’événement. Par défaut : si le instance paramètre est un objet GlideRecord, la valeur par défaut est la valeur d’affichage de ce GlideRecord (now_GR.getDisplayValue), sinon elle est nulle.
parm2	Chaîne	Facultatif. Chaîne à transmettre dans le script d’événement. Ce paramètre est de forme libre et dépend de l’implémentation du script d’événement. Par défaut : null
expiration	Objet	Facultatif. GlideDateTime ou un élément de type date/heure qui spécifie la date et l’heure de traitement de l’événement. Par défaut : Date/heure actuelle

Tableau 62. Renvoie

Type	Description
nul

Cet exemple montre comment appeler la méthode à l’aide d’un GlideRecord, de deux paramètres transmis au script d’événement et d’une heure spécifiée pour planifier l’événement.

var requestXml = requestBody.dataString;
var processTime = new GlideDateTime();
processTime.addDaysLocalTime(7);
gs.eventQueueScheduled('sn_app.user.deactivate', now_GR, requestXML, gs.getUserID(), processTime);

Cet exemple montre comment appeler la méthode à l’aide d’un sys_id et les valeurs par défaut des paramètres facultatifs.

gs.eventQueueScheduled('event.test', '0e29421383101000dada83ec37d9292d', '', '', '');

GlideSystem inclus dans le champ d’application : executeNow(tâche GlideRecord)

Exécute une tâche pour une application incluse dans le périmètre.

Vous ne pouvez utiliser cette méthode que sur une tâche dans la même application que le script appelant cette méthode.

Tableau 63. Paramètres

Nom	Type	Description
tâche	GlideRecord	Tâche à exécuter.

Tableau 64. Renvoie

Type	Description
Chaîne	Renvoie les sys_id de la tâche planifiée. Renvoie null si la tâche est globale.

scheduleImportJob: function () {
  var jobId = '61847fe04c603300fa9bb64c2b491dac';
  var now_GR = new GlideRecord('sysauto_script');
  if (!now_GR.get(jobId)) {
    throw new Error('Unable to find import job');
  }
  gs.executeNow(now_GR);
}

GlideSystem inclus dans le champ d’application : generateGUID()

Génère un GUID qui peut être utilisé lorsqu’un identificateur unique est requis.

Tableau 65. Paramètres

Nom	Type	Description
Aucun

Tableau 66. Renvoie

Type	Description
Chaîne	GUID hexadécimal de 32 caractères.

L’exemple de code suivant montre comment appeler cette méthode.

personalId = gs.generateGUID();
gs.info(personalId);

Sortie :

af770511ff013100e04bfffffffffff6

GlideSystem inclus dans le périmètre : getCallerScopeName()

Obtient le nom de la portée de l’appelant ; Renvoie null s’il n’y a pas d’appelant.

Tableau 67. Paramètres

Nom	Type	Description
Aucun

Tableau 68. Renvoie

Type	Description
Chaîne	Nom du champ d’application de l’appelant ou nul s’il n’y a pas d’appelant.

Cet exemple montre deux includes de script qui sont définis sur Accessible à partir de tous les périmètres de l’application. Un script include est créé dans app_scope_a.

var Scopea = Class.create(); 
 
Scopea.prototype = { 
    initialize: function() { 
    }, 
 
    callerScope: function() { 
        var scopeb = new app_scope_b.Scopeb(); 
        return scopeb.callerscope(); 
    }, 
 
    type: 'Scopea' 
}

Sortie :

Cet exemple montre un autre include de script créé dans app_scope_b.

var Scopeb = Class.create(); 
 
Scopeb.prototype = { 
    initialize: function() { 
        this._constructorCallerScope = gs.getCallerScopeName(); 
    }, 
 
    callerscope: function() { 
        return gs.getCallerScopeName(); 
    }, 
 
    getConstructorCallerScope: function() { 
        return this._constructorCallerScope; 
    }, 
 
    type: 'Scopeb' 
}

Sortie :

Ce script peut être utilisé dans le périmètre app_scope_a pour obtenir le nom du champ d’application de l’appelant ; dans ce cas, app_scope_b.

gs.info(new Scopea().getCallerScopeName());

GlideSystem inclus dans le périmètre : getCssCacheVersionString()

Obtient une chaîne représentant la version du cache d’un fichier CSS.

Tableau 69. Paramètres

Nom	Type	Description
Aucun

Tableau 70. Renvoie

Type	Description
Chaîne	Version du cache CSS.

L’exemple de code suivant montre comment appeler cette méthode.

var verStr = gs.getCssCacheVersionString();
gs.info(verStr);

Sortie :

_d82979516f0171005be8883e6b3ee4cf&theme=

GlideSystem inclus dans le périmètre : getCurrentApplicationId()

Obtient l’ID de l’application actuelle tel que défini à l’aide du sélecteur d’application.

Tableau 71. Paramètres

Nom	Type	Description
Aucun

Tableau 72. Renvoie

Type	Description
Chaîne	La sys_id de l’application actuelle, ou globale dans Aucun, n’est définie.

var currentId = gs.getCurrentApplicationId();
gs.info(currentId);

Sortie

04936cb16f30b1005be8883e6b3ee4e0

GlideSystem inclus dans le périmètre : getCurrentScopeName()

Obtient le nom du champ d’application actuel.

Tableau 73. Paramètres

Nom	Type	Description
Aucun

Tableau 74. Renvoie

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

L’exemple de code suivant montre comment appeler cette méthode.

var currentScope = gs.getCurrentScopeName();
gs.info(currentScope);

Sortie :

s_snc_test_scope

GlideSystem inclus dans le périmètre : getDateFormat(String)

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

Tableau 75. Paramètres

Nom	Type	Description
Aucun

Tableau 76. 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 inclus dans le périmètre : getDateTimeFormat()

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

Tableau 77. Paramètres

Nom	Type	Description
Aucun

Tableau 78. 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 inclus dans le champ d’application : getErrorMessages()

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

Tableau 79. Paramètres

Nom	Type	Description
Aucun

Tableau 80. Renvoie

Type	Description
Tableau de chaînes	Messages d’erreur associés à la session.

GlideSystem inclus dans le champ d’application : getEscapedMessage(String id, Array args)

Récupère le message spécifié à partir de la table Message [sys_ui_message]. Si le message contient des caractères spéciaux HTML, remplacez-les par les codes de nom HTML correspondants. Par exemple, & devient &.

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 avec tous les caractères spéciaux renvoyés sous forme de séquences d’échappement. Si l’identificateur de message spécifié n’existe pas pour la langue actuelle, la méthode renvoie la version anglaise du message avec tous les caractères spéciaux renvoyés sous forme de séquences d’échappement. 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 81. Paramètres

Nom	Type	Description
id	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	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.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 82. Renvoie

Type	Description
Chaîne	Message de l’interface utilisateur avec des caractères spéciaux HTML remplacés par des codes de nom HTML.

Cet exemple montre le caractère esperluette remplacé par le code de nom HTML équivalent esperluette.

var my_message = gs.getEscapedMessage("Is the summary & details accurate?");
alert(my_message);

Sortie

Is the summary & details accurate?

Cet exemple montre comment remplacer une seule variable dans un message et comment les symboles < et > du message sont transposés aux codes de nom HTML correspondants < et >.

// current.action.name is "update record"
var my_message = gs.getEscapedMessage("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 &ltsubflow&gt can't be added twice in this subflow.

GlideSystem inclus dans le champ d’application : getMessage(String id, Array 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 de message n’existe pas dans la table, il renvoie l’ID du message.

Pour plus d’informations sur la table Message, voir 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 83. Paramètres

Nom	Type	Description
id	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 au message réel.
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.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 84. Renvoie

Type	Description
Chaîne	Message de l’interface utilisateur.

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.getEscapedMessage("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.

GlideSystem inclus dans le champ d’application : getProperty(clé de chaîne, alt objet)

Obtient la valeur d’une propriété Glide. Si la propriété est introuvable, elle renvoie une autre valeur.

Tableau 85. 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 86. Renvoie

Type	Description
Chaîne	La valeur de la propriété Glide ou de l’autre objet défini ci-dessus.

L’exemple de code suivant montre comment appeler cette méthode.

var attachment_link = gs.getProperty('glide.servlet.uri');
gs.info(attachment_link);

Sortie :

https://instance.service-now.com/

GlideSystem inclus dans le périmètre : getSession()

Obtient une référence à la session Glide actuelle.

Tableau 87. Paramètres

Nom	Type	Description
Aucun

Tableau 88. Renvoie

Type	Description
Chaîne	Référence de la session en cours.

if (!gs.hasRole("admin") && !gs.hasRole("user_admin") && gs.getSession().isInteractive()) {
  current.addQuery("active", "true");
}

GlideSystem inclus dans le périmètre : getSessionID()

Récupère l’ID de session GlideSession.

Tableau 89. Paramètres

Nom	Type	Description
Aucun

Tableau 90. Renvoie

Type	Description
Chaîne	ID de session.

var myUserObject = gs.getSessionID();
gs.info(myUserObject);

Sortie :

A0D4E5416F3F21005BE8883E6B3EE4B8

GlideSystem inclus dans le périmètre : getSessionToken()

Cette méthode n’est plus disponible. Utilisez plutôt gs.getSession().getSessionToken().

Tableau 91. Paramètres

Nom	Type	Description
Aucun

Tableau 92. Renvoie

Type	Description
Chaîne	Jeton de session.

GlideSystem inclus dans le périmètre : getTimeFormat()

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

Tableau 93. Paramètres

Nom	Type	Description
Aucun

Tableau 94. Renvoie

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

L’exemple de code suivant montre comment appeler cette méthode.

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

Sortie :

HH:mm:ss

GlideSystem inclus dans le périmètre : getTimeZoneName()

Renvoie le nom du fuseau horaire associé à l’utilisateur actuel.

Cette méthode a été déconseillée. Au lieu de cela, utilisez la méthode getTimeZoneName() dans l’API GlideSession .

Tableau 95. Paramètres

Nom	Type	Description
Aucun

Tableau 96. Renvoie

Type	Description
Chaîne	Nom du fuseau horaire.

L’exemple de code suivant montre comment appeler cette méthode.

gs.info(gs.getTimeZoneName());

GlideSystem inclus dans le périmètre : getUrlOnStack()

Obtient l’URI actuel pour la session.

Tableau 97. Paramètres

Nom	Type	Description
Aucun

Tableau 98. Renvoie

Type	Description
Chaîne	L’URI.

gs.info(gs.getUrlOnStack());

GlideSystem inclus dans le périmètre : getUser()

Renvoie une référence à l’objet GlideUser inclus dans le champ d’application pour l’utilisateur actuel.

Voir GlideUser - Scopedpour une liste des méthodes disponibles.

Tableau 99. Paramètres

Nom	Type	Description
Aucun

Tableau 100. Renvoie

Type	Description
GlideUser (en anglais seulement)	Référence à un objet utilisateur inclus dans le champ d’application.

var myUserObject = gs.getUser();
gs.info(myUserObject);

Sortie

com.glide.script.fencing.ScopedUser@6c0645

GlideSystem inclus dans le périmètre : getUserDisplayName()

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

Tableau 101. Paramètres

Nom	Type	Description
Aucun

Tableau 102. 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

GlideSystem inclus dans le champ d’application : getUserID()

Obtient les sys_id de l’utilisateur actuel.

Tableau 103. Paramètres

Nom	Type	Description
Aucun

Tableau 104. Renvoie

Type	Description
Chaîne	Le 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.getUserID();
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 inclus dans le champ d’application : getUserName()

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

Tableau 105. Paramètres

Nom	Type	Description
Aucun

Tableau 106. 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 récupère le nom d’utilisateur de l’utilisateur actuel.

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

Sortie :

The current user name is: admin

GlideSystem inclus dans le champ d’application : hasRole(rôle d’objet)

Détermine si l’utilisateur actuel possède le rôle spécifié.

Tableau 107. Paramètres

Nom	Type	Description
role	Objet	Le rôle à vérifier.

Tableau 108. Renvoie

Type	Description
Booléen	Vrai si l’utilisateur avait le rôle. Renvoie la valeur true pour les utilisateurs disposant du rôle administrateur.

if (!gs.hasRole("admin") && !gs.hasRole("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
  gs.info("User has admin and groups admin roles");
}
else {
  gs.info("User does not have both admin and groups admin roles");
}

GlideSystem inclus dans le champ d’application : hoursAgo (nombre d’heures)

Renvoie la date et l’heure d’un nombre spécifié d’heures auparavant.

Tableau 109. Paramètres

Nom	Type	Description
Heures	Numéro	Nombre entier d’heures

Tableau 110. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

if (current.operation() == 'insert') {
 // If no due date was specified, calculate a default
 if (current.due_date == '') {
 
  if (current.urgency == '1') {
   // Set due date to 4 hours ahead of current time
   current.due_date = gs.hoursAgo(-4);
  }
 
  if (current.urgency == '2') {
   // Set due date to 2 days ahead of current time
   current.due_date = gs.daysAgo(-2);
  }
 
  if (current.urgency == '3') {
   // Set due date to 7 days ahead of current time
   current.due_date = gs.daysAgo(-7);
  }
 }
}

GlideSystem inclus dans le champ d’application : hoursAgoEnd(nombre d’heures)

Renvoie la date et l’heure de fin de l’heure il y a un nombre d’heures spécifié.

Tableau 111. Paramètres

Nom	Type	Description
Heures	Numéro	Nombre entier d’heures

Tableau 112. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : hoursAgoStart (nombre d’heures)

Renvoie la date et l’heure de début de l’heure il y a un nombre d’heures spécifié.

Tableau 113. Paramètres

Nom	Type	Description
Heures	Numéro	Nombre entier d’heures

Tableau 114. Renvoie

Type	Description
Chaîne	GMT au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : include(nom de chaîne)

Fournit un moyen sûr d’appeler un include de script à partir du bac à sable, en n’autorisant que l’inclusion de scripts approuvés.

Tableau 115. Paramètres

Nom	Type	Description
nom	Chaîne	Nom du script à inclure.

Tableau 116. Renvoie

Type	Description
Booléen	Marqueur indiquant si l’include de script a fonctionné. Valeurs possibles : true : l’include de script a fonctionné. false : échec de l’inclusion du script.

Cet exemple récupère les LDAPUtils dans le contexte de script actuel.

var ldapServer = new GlideRecord("ldap_server_config");
ldapServer.addActiveQuery();
ldapServer.query();
gs.include("LDAPUtils");
var ldapUtils = new LDAPUtils();
var errMsg = "";
while (ldapServer.next()) {
  var ldap = new GlideLDAP();
  var dn = ldapServer.dn;
  var env = ldap.setup();
  if (env == null) {
    errMsg = "Failed environment setup, missing URL";
    gs.eventQueue("ldap.connection_failed",   ldapServer, ldapServer.getDisplayValue(), errMsg);
    gs.logError("LDAP server " + ldapServer.getDisplayValue() + " failed scheduled connection test: " + errMsg, "LDAP");
 }
}

GlideSystem inclus dans le champ d’application : info (message de chaîne, objet parm1, objet parm2, objet parm3, objet parm4, objet parm5)

Écrit un message d’information dans le journal système.

Tableau 117. Paramètres

Nom	Type	Description
message	Chaîne	Message du journal avec des espaces réservés pour tous les arguments de variable.
param1	Objet	(Facultatif) Argument de la première variable.
param2	Objet	(Facultatif) Deuxième argument variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument variable.
param5	Objet	(Facultatif) Cinquième argument variable.

Tableau 118. Renvoie

Type	Description
nul

gs.info("This is an info message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.info("This is an info message from {0}.{1}", myFirstName, myLastName);

Sortie :

This is an info message
This is an info message from Abel.Tuter

GlideSystem inclus dans le périmètre : isDebugging()

Détermine si le débogage est actif pour un périmètre spécifique.

Tableau 119. Paramètres

Nom	Type	Description
Aucun

Tableau 120. Renvoie

Type	Description
Booléen	Vrai si le débogage de session est actif ou si le niveau de journal est défini sur Déboguer pour le périmètre spécifié.

gs.debug("This is a log message");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.debug("This is a log message from {0}.{1}", myFirstName, myLastName);
gs.info(gs.isDebugging());

GlideSystem inclus dans le périmètre : isInteractive()

Vérifie si la session en cours est interactive. Un exemple de session interactive est lorsqu’un utilisateur se connecte normalement. Un exemple de session non interactive est l’utilisation d’une demande SOAP pour récupérer des données.

Tableau 121. Paramètres

Nom	Type	Description
Aucun

Tableau 122. Renvoie

Type	Description
Booléen	Vrai si la session est interactive.

if (!gs.hasRole("admin") && gs.getSession().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);
    }
}

GlideSystem inclus dans le périmètre : isLoggedIn()

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

Tableau 123. Paramètres

Nom	Type	Description
Aucun

Tableau 124. Renvoie

Type	Description
Booléen	Vrai si l’utilisateur actuel est connecté.

gs.info(gs.isLoggedIn());

GlideSystem inclus dans le périmètre : isMobile()

Vous pouvez déterminer si une demande provient d’un équipement mobile.

Cette méthode peut être utilisée dans les conditions d’action d’interface utilisateur et les règles métier.

Tableau 125. Paramètres

Nom	Type	Description
Aucun

Tableau 126. Renvoie

Type	Description
Booléen	Vrai si la demande provient d’un équipement mobile ; sinon, faux.

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

Sortie

NOT submitted from mobile UI

GlideSystem inclus dans le champ d’application : minutesAgoEnd(nombre de minutes)

Renvoie la date et l’heure de fin de la minute il y a un nombre de minutes spécifié.

Tableau 127. Paramètres

Nom	Type	Description
minutes	Numéro	Nombre entier de minutes plus tôt, tel que 5 ou 126.

Tableau 128. 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.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.info("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

GlideSystem inclus dans le périmètre : minutesAgoStart(nombre de minutes)

Renvoie la date et l’heure de début de la minute il y a un nombre de minutes spécifié.

Tableau 129. Paramètres

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

Tableau 130. 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

GlideSystem inclus dans le champ d’application : monthsAgo (nombre de mois)

Renvoie la date et l’heure d’un nombre spécifié de mois auparavant.

Tableau 131. Paramètres

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

Tableau 132. 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

GlideSystem inclus dans le champ d’application : monthsAgoStart(nombre de mois)

Renvoie la date et l’heure de début du mois il y a un nombre spécifié de mois.

Tableau 133. Paramètres

Nom	Type	Description
mois	Numéro	Nombre entier de mois plus tôt, tel que 3 ou 14.

Tableau 134. 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

GlideSystem inclus dans le périmètre : nél(objet o)

Interroge un objet et renvoie la valeur true si l’objet est nul, non défini ou contient une chaîne vide.

Tableau 135. Paramètres

Nom	Type	Description
o	Objet	Objet à vérifier.

Tableau 136. Renvoie

Type	Description
Booléen	Vrai si l’objet est nul, indéfini ou contient une chaîne vide ; dans le cas contraire, renvoie la valeur false.

var now_GR = new GlideRecord();
gs.info(gs.nil(now_GR));

Sortie

true

GlideSystem inclus dans le périmètre : quartersAgoEnd(Nombre de trimestres)

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

Tableau 137. Paramètres

Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 138. 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

GlideSystem inclus dans le périmètre : quartersAgoStart(nombre de trimestres)

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

Tableau 139. Paramètres

Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 140. 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

GlideSystem inclus dans le champ d’application : 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 si la propriété est dans le champ d’application du script.

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 141. 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 142. Renvoie

Type	Description
nul

L’exemple de code suivant montre comment appeler cette méthode.

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

Sortie :

bar

GlideSystem inclus dans le champ d’application : setRedirect(Object o)

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

Tableau 143. Paramètres

Nom	Type	Description
o	Objet	Objet URI ou chaîne URI à définir en tant que redirection

Tableau 144. Renvoie

Type	Description
nul

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

GlideSystem inclus dans le champ d’application : tableExists(nom de chaîne)

Détermine si une table de base de données existe.

Tableau 145. Paramètres

Nom	Type	Description
nom	Chaîne	Nom de la table dont l’existence doit être vérifiée.

Tableau 146. Renvoie

Type	Description
Booléen	Vrai si la table existe. Faux si la table est introuvable.

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

GlideSystem inclus dans le périmètre : urlEncode(URL de chaîne)

Encode les caractères non ASCII, les caractères ASCII non sécurisés et les espaces afin que la chaîne renvoyée puisse être utilisée sur Internet. Utilise l’encodage UTF-8. Utilise l’encodage de pourcentage (%).

Tableau 147. Paramètres

Nom	Type	Description
URL	Chaîne	Chaîne à coder.

Tableau 148. Renvoie

Type	Description
Chaîne	Chaîne avec des caractères non ASCII, des caractères ASCII non sécurisés et des espaces codés.

GlideSystem inclus dans le périmètre : urlDecode(URL de chaîne)

Remplace les caractères codés UTF-8 par des caractères ASCII.

Tableau 149. Paramètres

Nom	Type	Description
URL	Chaîne	UTF-8 pour cent (%) caractères codés.

Tableau 150. Renvoie

Type	Description
Chaîne	Les caractères codés sont remplacés par des caractères ASCII.

GlideSystem inclus dans le périmètre : warn(message de chaîne, objet parm1, objet parm2, objet parm3, objet parm4, objet parm5)

Écrit un message d’avertissement dans le journal système.

Tableau 151. Paramètres

Nom	Type	Description
message	Chaîne	Message du journal avec des espaces réservés pour tous les arguments de variable.
param1	Objet	(Facultatif) Argument de la première variable.
param2	Objet	(Facultatif) Deuxième argument variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument variable.
param5	Objet	(Facultatif) Cinquième argument variable.

Tableau 152. Renvoie

Type	Description
nul

gs.warn("This is a warning");
var myFirstName = "Abel";
var myLastName = "Tuter";
gs.warn("This is a warning from {0}.{1}", myFirstName, myLastName);

Sortie :

This is a warning
This is a warning from Abel.Tuter

GlideSystem inclus dans le périmètre : xmlToJSON (chaîne xmlString)

Prend une chaîne XML et renvoie un objet JSON.

Tableau 153. Paramètres

Nom	Type	Description
Chaîne XML	Chaîne	Chaîne XML à convertir.

Tableau 154. Renvoie

Type	Description
Objet	Objet JSON représentant la chaîne XML. Nul si impossible de traiter la chaîne XML.

L’exemple de code suivant montre comment appeler cette méthode.

var jsonObject = gs.xmlToJSON(xmlString);

GlideSystem inclus dans le champ d’application : yearsAgo(nombre d’années)

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

Tableau 155. Paramètres

Nom	Type	Description
années	Numéro	Un nombre entier d’années

Tableau 156. 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.

GlideSystem inclus dans le champ d’application : yesterday()

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

Tableau 157. Paramètres

Nom	Type	Description
Aucun

Tableau 158. Renvoie

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