GlideSystem : inclus dans l’étendue

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ête 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’informations 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 champ d’application : 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	Une chaîne codée base64.

Tableau 8. Renvoie

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

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

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

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

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

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

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

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

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

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

Renvoie la date et l’heure du début du mois prochain, en GMT.

Tableau 13. Paramètres

Nom	Type	Description
Aucun

Tableau 14. Renvoie

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

GlideSystem inclus dans le champ d’application : 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 du début de la semaine prochaine, au format aaaa-mm-jj hh :mm :ss.

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

Renvoie la date et l’heure du début de l’année prochaine (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 champ d’application : 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 champ d’application : 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 au début de ce trimestre, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : 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 en début de 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, en GMT.

Tableau 25. Paramètres

Nom	Type	Description
Aucun

Tableau 26. Renvoie

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

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

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

Tableau 27. Paramètres

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

Tableau 28. Renvoie

Type	Description
Chaîne	Date et heure générées. Si la plage est start, la valeur renvoyée est aaaa-mm-jj 00:00:00. Si la plage est fin , 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 d’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’il y a un nombre spécifié de jours.

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 plus tôt.

Tableau 31. Paramètres

Nom	Type	Description
jours	Numéro	Nombre entier de jours

Tableau 32. Renvoie

Type	Description
Chaîne	Fin de journée GMT 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 un nombre spécifié de jours plus tôt.

Tableau 33. Paramètres

Nom	Type	Description
jours	Chaîne	Nombre entier de jours

Tableau 34. Renvoie

Type	Description
Chaîne	Début de la journée GMT 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 les espaces réservés pour tous les arguments de variables.
param1	Objet	(Facultatif) Premier argument de variable.
param2	Objet	(Facultatif) Deuxième argument de variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument de variable.
param5	Objet	(Facultatif) Cinquième argument de 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 champ d’application : 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 champ d’application : 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 champ d’application : endOfLastYear()

Renvoie la date et l’heure de la 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 champ d’application : endOfNextMonth()

Renvoie la date et l’heure de la fin du mois prochain, 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 champ d’application : 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 champ d’application : endOfNextYear()

Renvoie la date et l’heure de la 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 champ d’application : endOfThisMonth()

Renvoie la date et l’heure de la 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 champ d’application : endOfThisQuarter()

Renvoie la date et l’heure de la fin de ce trimestre, en 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 champ d’application : endOfThisWeek()

Renvoie la date et l’heure de la 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 champ d’application : endOfThisYear()

Renvoie la date et l’heure de la 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 dans le champ d’application : 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 variables (varargs) dans le message à l’aide du modèle de remplacement d’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 les espaces réservés pour tous les arguments de variables.
param1	Objet	(Facultatif) Premier argument de variable.
param2	Objet	(Facultatif) Deuxième argument de variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument de variable.
param5	Objet	(Facultatif) Cinquième argument de 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 dans le champ d’application : eventQueue(nom de chaîne, instance d’objet, chaîne parm1, chaîne parm2, file d’attente de chaîne)

Met en file d’attente un événement 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 si spécifié.
parm2	Chaîne	Facultatif. Enregistré avec l’instance si spécifié.
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 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 de calendrier des événements transmises sont stockées dans la table Événements [sysevent]. Pour plus d’informations sur les événements, consultez É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	Objet GlideRecord ou sys_id de l’enregistrement auquel cet événement s’applique.
parm1	Chaîne	Facultatif. Chaîne à transmettre dans le script de l’é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 il est nul.
parm2	Chaîne	Facultatif. Chaîne à transmettre dans le script de l’événement. Ce paramètre est de forme libre et dépend de l’implémentation du script d’événement. Valeur par défaut : nul
expiration	Objet	Facultatif. Objet GlideDateTime ou é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 le 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 utilisable 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 champ d’application : getCallerScopeName()

Obtient le nom de 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 définis sur Accessible à partir de tous les périmètres de l’application. Un include de script 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 champ d’application 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 champ d’application : 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 champ d’application : 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	L’sys_id de l’application actuelle, ou global dans aucun, n’est défini.

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

Sortie

04936cb16f30b1005be8883e6b3ee4e0

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

Obtient le nom du champ d’application actuel.

Tableau 73. Paramètres

Nom	Type	Description
Aucun

Tableau 74. Renvoie

Type	Description
Chaîne	Le 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 champ d’application : 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	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 champ d’application : 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 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 (ID de chaîne, arguments de tableau)

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, les remplace 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 en tant que 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 en tant que séquences d’échappement. Si l’identificateur du message n’existe pas dans la table, il renvoie l’ID du message.

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

Remarque :

Si le message d’interface utilisateur a une coche ('), il peut y avoir des problèmes avec le message dans le script ; pour échapper les 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 des chaînes ou 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 mot pour mot dans le message.

Tableau 82. Renvoie

Type	Description
Chaîne	Message d’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.

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 variable unique dans un message et comment les symboles < et > du message sont transposés dans les 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 (ID de chaîne, arg. de tableau)

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

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

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

Remarque :

Si le message d’interface utilisateur a une coche ('), il peut y avoir des problèmes avec le message dans le script ; pour échapper les 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 des chaînes ou 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 mot pour mot dans le message.

Tableau 84. Renvoie

Type	Description
Chaîne	Message d’interface utilisateur.

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

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

Sortie :

las filas no se actualizarán

Cet exemple montre comment remplacer une variable unique 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(String key, Object alt)

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

Tableau 85. Paramètres

Nom	Type	Description
clé	Chaîne	Clé de la propriété dont la valeur doit être renvoyée.
Alt	Objet	(Facultatif) Autre objet à renvoyer si la propriété est introuvable.

Tableau 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 champ d’application : 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 pour la session en cours.

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

GlideSystem inclus dans le champ d’application : 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 champ d’application : 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	Le jeton de session.

GlideSystem inclus dans le champ d’application : 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 champ d’application : 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 champ d’application : getUrlOnStack()

Obtient l’URI actuel de 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 champ d’application : getUser()

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

Consultez GlideUser : dans le champ d’applicationpour obtenir la liste des méthodes disponibles.

Tableau 99. Paramètres

Nom	Type	Description
Aucun

Tableau 100. Renvoie

Type	Description
GlideUser	Référence à un objet utilisateur dans le champ d’application.

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

Sortie

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

GlideSystem inclus dans le champ d’application : 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 Nom de l’utilisateur actuel. Par exemple, cette méthode renvoie Abel Tuter par opposition à abel.tuter.

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

gs.info(gs.getUserDisplayName());

Sortie :

System Administrator

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

Obtient le 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 par opposition à Abel Tuter.

Cet exemple obtient 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(Object role)

Détermine si l’utilisateur actuel dispose du rôle spécifié.

Tableau 107. Paramètres

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

Tableau 108. Renvoie

Type	Description
Booléen	Vrai si l’utilisateur avait le rôle. Renvoie la valeur vrai pour les utilisateurs ayant le rôle d’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 passées.

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 un nombre d’heures plus tôt.

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 du début de l’heure un nombre d’heures plus tôt.

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, permettant uniquement 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’include de script.

Cet exemple obtient 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’informations dans le journal système.

Tableau 117. Paramètres

Nom	Type	Description
message	Chaîne	Message du journal avec les espaces réservés pour tous les arguments de variables.
param1	Objet	(Facultatif) Premier argument de variable.
param2	Objet	(Facultatif) Deuxième argument de variable.
param3	Objet	(Facultatif) Troisième argument de variable.
param4	Objet	(Facultatif) Quatrième argument de variable.
param5	Objet	(Facultatif) Cinquième argument de 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 champ d’application : isDebugging()

Détermine si le débogage est actif pour un champ d’application 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 champ d’application 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 champ d’application : isInteractive()

Vérifie si la session en cours est interactive. Un exemple de session interactive est lorsqu’un utilisateur se connecte normalement. Un exemple d’une 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 champ d’application : 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 champ d’application : 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 appareil 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 minutes)

Renvoie la date et l’heure de fin de la minute un nombre spécifié de minutes plus tôt.

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 d’il y a 30 minutes à 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 champ d’application : minutesAgoStart(nombre de minutes)

Renvoie la date et l’heure du début de la minute un nombre spécifié de minutes plus tôt.

Tableau 129. Paramètres

Nom	Type	Description
minutes	Numéro	Nombre entier de minutes passé, 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 et la date et l’heure d’il y a 30 minutes au début de la minute en 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 passé.

Tableau 131. Paramètres

Nom	Type	Description
mois	Numéro	Nombre entier de mois plus tôt.

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 à la même heure GMT.

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

Sortie :

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

GlideSystem inclus dans le champ d’application : monthsAgoEnd(Nombre de mois)

Renvoie la date et l’heure du dernier jour du mois un nombre spécifié de mois plus tôt.

Tableau 133. Paramètres

Nom	Type	Description
mois	Nombre (entier)	Nombre de mois, par exemple 4 ou 16.

Tableau 134. Renvoie

Type	Description
Chaîne	Date et heure du mois, le nombre spécifié de mois passé, en heure locale. Format : UTC aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles et la date et l’heure il y a deux mois, à la fin du mois ouvré.

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-08-01 06:59:59

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

Renvoie la date et l’heure du début du mois un nombre de mois plus tôt.

Tableau 135. Paramètres

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

Tableau 136. Renvoie

Type	Description
Chaîne	GMT début du mois Nombre de mois spécifié plus tôt. Format : aaaa-mm-jj hh :mm :ss

L’exemple suivant affiche la date et l’heure actuelles et la date et l’heure 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 champ d’application : nul (objet o)

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

Tableau 137. Paramètres

Nom	Type	Description
o	Objet	L’objet à vérifier.

Tableau 138. Renvoie

Type	Description
Booléen	Vrai si l’objet est nul, indéfini ou contient une chaîne vide ; sinon, renvoie la valeur Faux.

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

Sortie

true

GlideSystem inclus dans le champ d’application : quartersAgoEnd(Number quarters)

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

Tableau 139. Paramètres

Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 140. Renvoie

Type	Description
Chaîne	GMT de la fin du trimestre correspondant au nombre de trimestres spécifié il y a, au format aaaa-mm-jj hh :mm :ss

GlideSystem inclus dans le champ d’application : quartersAgoStart(Number quarters)

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

Tableau 141. Paramètres

Nom	Type	Description
trimestres	Numéro	Nombre entier de trimestres

Tableau 142. Renvoie

Type	Description
Chaîne	GMT fin du mois correspondant au nombre de trimestres spécifié il y a, 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 chaîne)

Définit la clé spécifiée sur la valeur spécifiée si la propriété est comprise dans le champ d’application du script.

Remarque :

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

Tableau 143. Paramètres

Nom	Type	Description
clé	Chaîne	Clé de la propriété à définir.
valide	Chaîne	Valeur de la propriété à définir.
description	Chaîne	Description de la propriété.

Tableau 144. 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(Objet o)

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

Tableau 145. Paramètres

Nom	Type	Description
o	Objet	Objet URI ou chaîne URI à définir comme redirection

Tableau 146. 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 s’il existe une table de base de données.

Tableau 147. Paramètres

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

Tableau 148. 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 champ d’application : urlEncode(String url)

Code 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 le codage en pourcentage (%)

Tableau 149. Paramètres

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

Tableau 150. Renvoie

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

GlideSystem inclus dans le champ d’application : urlDecode(URL de chaîne)

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

Tableau 151. Paramètres

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

Tableau 152. Renvoie

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

GlideSystem inclus dans le champ d’application : 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 153. Paramètres

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

Tableau 154. 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 champ d’application : xmlToJSON (chaîne, xmlString)

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

Tableau 155. Paramètres

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

Tableau 156. 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 passées.

Tableau 157. Paramètres

Nom	Type	Description
années	Numéro	Nombre entier d’années

Tableau 158. Renvoie

Type	Description
Chaîne	GMT début de l’année, c’est-à-dire le nombre d’années spécifié, 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 159. Paramètres

Nom	Type	Description
Aucun

Tableau 160. Renvoie

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