GlideSystem : global
L’API GlideSystem , à laquelle l’on fait référence par le nom de variable gs dans tout JavaScript côté serveur, fournit un certain nombre de méthodes pratiques pour obtenir des informations sur le système, l’utilisateur actuellement connecté et des informations de date/heure.
De nombreuses méthodes GlideSystem facilitent l’inclusion facile des dates dans les plages de requête et sont le plus souvent utilisées dans les filtres et les rapports.
GlideSystem : addErrorMessage(Message de l’objet)
Ajoute un message d’erreur pour la session en cours.
Utilisez getErrorMessages() pour récupérer une liste des messages d’erreur actuellement affichés.
| Nom | Type | Description |
|---|---|---|
| message | Objet | Message à ajouter. |
| Type | Description |
|---|---|
| nul |
gs.include("PrototypeServer");
var ValidatePasswordStronger = Class.create();
ValidatePasswordStronger.prototype = {
process : function() {
var user_password = request.getParameter("user_password");
var min_len = 8;
var rules = "Password must be at least " + min_len +
" characters long and contain a digit, an uppercase letter, and a lowercase letter.";
if (user_password.length() < min_len) {
gs.addErrorMessage("TOO SHORT: " + rules);
return false;
}
var digit_pattern = new RegExp("[0-9]", "g");
if (!digit_pattern.test(user_password)) {
gs.addErrorMessage("DIGIT MISSING: " + rules);
return false;
}
var upper_pattern = new RegExp("[A-Z]", "g");
if (!upper_pattern.test(user_password)) {
gs.addErrorMessage("UPPERCASE MISSING: " + rules);
return false;
}
var lower_pattern = new RegExp("[a-z]", "g");
if (!lower_pattern.test(user_password)) {
gs.addErrorMessage("LOWERCASE MISSING: " + rules);
return false;
}
return true; // password is OK
}
}
[edit]
Équivalent dans le champ d’application
Pour utiliser la méthode addErrorMessage() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : addErrorMessage().
GlideSystem : addHighMessage(message de chaîne)
Affiche un message de priorité élevée en haut du formulaire.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message de priorité élevée à afficher. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant montre comment afficher un message de priorité élevée en haut du formulaire.
gs.addHighMessage("This is a high priority message");
GlideSystem : addInfoMessage(message d’objet)
Ajoute un message d’information pour la session en cours.
Utilisez getInfoMessages() pour récupérer la liste des messages d’information affichés. Cette méthode n’est pas prise en charge pour les règles métier asynchrones et ne peut pas être utilisée dans les scripts de transformation.
| Nom | Type | Description |
|---|---|---|
| message | Objet | Message à ajouter. |
| Type | Description |
|---|---|
| nul |
if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
var start = current.u_date1.getGlideObject().getNumericValue();
var end = current.u_date2.getGlideObject().getNumericValue();
if (start > end) {
gs.addInfoMessage('start must be before end');
current.u_date1.setError('start must be before end');
current.setAbortAction(true);
}
}
Équivalent dans le champ d’application
Pour utiliser la méthode addInfoMessage() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : addInfoMessage().
GlideSystem : addLowMessage(Message de chaîne)
Affiche un message de priorité faible en haut du formulaire.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message de priorité faible à afficher. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant montre comment afficher un message de priorité faible en haut du formulaire.
gs.addLowMessage("This is a low priority message");
GlideSystem : addMessage(type de chaîne, message d’objet)
Ajoute un message pour la session en cours.
| Nom | Type | Description |
|---|---|---|
| type | Chaîne | Type de message, tel qu’une erreur ou une information. |
| message | Objet | Message à ajouter à la session en cours. |
| Type | Description |
|---|---|
| nul |
GlideSystem : addModerateMessage(message de chaîne)
Affiche un message de priorité modérée en haut du formulaire.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Modération du message à afficher. |
| Type | Description |
|---|---|
| Aucun |
L’exemple suivant montre comment afficher un message de priorité modérée en haut du formulaire.
gs.addModerateMessage("This is a moderate priority message");
GlideSystem : addSuccessMessage(Message de chaîne)
Affiche un message confirmant une action réussie en haut du formulaire.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message de réussite à afficher. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant montre comment afficher un message de confirmation d’un message de réussite en haut du formulaire.
gs.addSuccessMessage("This is a success message");
GlideSystem : début du mois dernier()
Obtient la date et l’heure du début du mois dernier dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | L’UTC du début du mois dernier, au format aaaa-mm-jj hh :mm :ss. |
Cet exemple définit la date et l’heure de l’objet GlideDateTime au début du mois dernier.
var date = new GlideDate();
date.setValue(gs.beginningOfLastMonth());
var dateasint = date.toString().replace('-','');
gs.print(dateasint);
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfLastMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfLastMonth().
GlideSystem : début de LastWeek()
Renvoie la date et l’heure du début de la semaine dernière dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début de la semaine dernière. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine dernière.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfLastWeek());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfLastWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfLastWeek().
GlideSystem : début de la NextWeek()
Renvoie la date et l’heure du début de la semaine suivante dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début de la semaine prochaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine prochaine.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextWeek());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfNextWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextWeek().
GlideSystem : début du NextMonth()
Renvoie la date et l’heure du début du mois suivant dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début du mois prochain. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début du mois prochain.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextMonth());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfNextMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextMonth().
GlideSystem : début de NextYear()
Renvoie la date et l’heure du début de l’année suivante dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | L’UTC au début de l’année prochaine, au format aaaa-mm-jj hh :mm :ss. |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de l’année prochaine.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfNextYear());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfNextYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfNextYear().
GlideSystem : début de ce mois()
Renvoie la date et l’heure du début du mois en cours dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début du mois en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de ce mois.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisMonth());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisMonth() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisMonth().
GlideSystem : début de ce trimestre()
Renvoie la date et l’heure du début du trimestre en cours dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC au début du trimestre en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début du trimestre en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisQuarter());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisQuarter() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisQuarter().
GlideSystem : début de cette semaine()
Renvoie la date et l’heure du début de cette semaine dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC en début de semaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisWeek());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisWeek().
GlideSystem : début de cette année()
Renvoie la date et l’heure du début de cette année dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début de l’année en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de l’année en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisYear());
Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisYear().
GlideSystem : début de Today()
Récupère la date et l’heure de début de la journée dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début de la journée en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la journée actuelle.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfToday());
GlideSystem : beginningOfTomorrow()
Récupère le début (UTC) du lendemain ajusté pour le fuseau horaire de la session actuelle de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC début de demain. Format : aaaa-mm-jj hh :mm :ss |
var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue();
GlideSystem : début d’hier()
Récupère la date et l’heure du début de la journée d’hier dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Le début UTC d’hier, au format aaaa-mm-jj hh :mm :ss. |
var start = new GlideDateTime();
start.setValue(gs.beginningOfYesterday()); GlideSystem : calDateDiff(Chaîne startDate, chaîne endDate, booléen numericValue)
Calculez la différence entre deux dates à l’aide du calendrier par défaut.
Les calendriers sont désormais obsolètes. Si des calendriers sont utilisés, reportez-vous à la section « Calculer pendant un calendrier donné » de la rubrique Planification des cas d’utilisation du script.
| Nom | Type | Description |
|---|---|---|
| startDate | Chaîne | Date de début à comparer au format de date de l’utilisateur actuel. |
| endDate | Chaîne | Date de fin à comparer au format de date de l’utilisateur actuel. |
| valeur numérique | Booléen | Marqueur qui indique le format de la valeur de temps renvoyée. Valeurs valides :
|
| Type | Description |
|---|---|
| Chaîne | Si le numericValue paramètre est vrai, renvoie la différence entre les deux dates sous forme de nombre entier de secondes. Si la valeur est faux, renvoie la différence entre les deux dates au format jj hh :mm :ss. |
var endDateTime = gs.nowDateTime();
gs.print('--- Total records: ' + countRecordsTotal);
gs.print('--- End time: ' + endDateTime);
gs.print('Time diff: ' + gs.calDateDiff(startDateTime, endDateTime));
GlideSystem : dateDiff(Chaîne startDate, chaîne endDate, booléen numericValue)
Calcule la différence entre deux dates.
Cette méthode attend la date antérieure comme premier paramètre et la date ultérieure comme deuxième paramètre ; sinon, la méthode renvoie la différence sous forme de valeur négative. Utilisez getDisplayValue() pour convertir les chaînes au format attendu.
Cette méthode attend des paramètres au format de date/heure utilisateur/système, qui peuvent différer du format interne. L’utilisation de paramètres dans des formats autres que le format date/heure utilisateur/système peut renvoyer des résultats non valides.
Si vous utilisez des objets GlideDateTime, utilisez la méthode GlideDateTime subtract() au lieu de dateDiff().
| Nom | Type | Description |
|---|---|---|
| startDate | Chaîne | La date de début à comparer au format de date de l’utilisateur actuel. |
| endDate | Chaîne | La date de fin à comparer au format de date de l’utilisateur actuel. |
| valeur numérique | Booléen | Si vrai, la valeur de retour sera formatée en nombre de secondes ; Si la valeur est fausse, la valeur renvoyée sera formatée DDD hh :mm :ss. |
| Type | Description |
|---|---|
| Chaîne | Si le paramètre numericValue est vrai, renvoie la différence entre les deux dates sous forme de nombre entier de secondes ; Si la valeur est faux, renvoie la différence entre les deux dates au format jj hh :mm :ss. |
// Given two date/times as DateTime objects
// Set the values this way to ensure a consistent input time
var date1 = new GlideDateTime();
var date2 = new GlideDateTime();
date1.setDisplayValueInternal('2014-01-01 12:00:00');
date2.setDisplayValueInternal('2014-01-01 13:00:00');
// Determine the difference as number of seconds (returns a string)
// Use getDisplayValue() to convert the string to the format expected by dateDiff()
var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true);
// JavaScript will coerce diffSeconds from a string to a number
// since diffSeconds is being compared to a number
var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before ';
gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue())
GlideSystem : dateGenerate(date de chaîne, plage de chaînes)
Génère une date et une heure pour la date spécifiée dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| date | Chaîne | Date à générer au format UTC. Format : aaaa-mm-jj |
| Plage | Chaîne | Début, fin ou heure. Format : 24 heures hh :mm :ss |
| 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
Équivalent dans le champ d’application
Pour utiliser la méthode dateGenerate() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : dateGenerate().
GlideSystem : daysAgo(nombre de jours)
Renvoie la date et l’heure d’il y a un certain nombre de jours. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre de jours |
| Type | Description |
|---|---|
| Chaîne | UTC du nombre spécifié de jours passés. Format : aaaa-mm-jj hh :mm :ss. |
function contractNoticeDue() {
var now_GR = new GlideRecord("contract");
now_GR.addQuery("u_contract_status", "Active");
now_GR.query();
while (now_GR.next()) {
if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
now_GR.u_contract_status = "In review";
}
else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
now-GR.u_contract_status = "In review";
}
else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
now_GR.u_contract_status = "In review";
}
}
now_GR.update();
}
Équivalent dans le champ d’application
Pour utiliser la méthode daysAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgo().
GlideSystem : daysAgoEnd(nombre de jours)
Renvoie la date et l’heure de fin de la journée il y a un nombre spécifié de jours. Renvoie la valeur dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre entier de jours |
| Type | Description |
|---|---|
| Chaîne | La fin de la journée UTC au format aaaa-mm-jj hh :mm :ss. |
Cet exemple montre l’utilisation de daysAgoEnd() pour définir la date de fin lors de l’interrogation 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.addInfoMessage("Count: " +tableData.getRowCount());
Équivalent dans le champ d’application
Pour utiliser la méthode daysAgoEnd() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : daysAgoEnd().
GlideSystem : daysAgoLocal(Nombre de jours)
Renvoie la date et l’heure de début de la journée pour le nombre spécifié de jours passés. La date et l’heure renvoyées reflètent le fuseau horaire de la session en cours (heure locale).
| Nom | Type | Description |
|---|---|---|
| jours | Numéro | Nombre de jours plus tôt |
| Type | Description |
|---|---|
| Chaîne | Date et heure locales pour le début de la journée au format de date/heure défini par l’utilisateur. Si le format date/heure n’est pas modifié par rapport à sa valeur initiale, le format est aaaa-mm-jj hh :mm :ss. |
if (due_in == "1 Day") {
dd = gs.daysAgoLocal(-1);
}
if (due_in == "1 Week") {
dd = gs.daysAgoLocal(-7);
}
GlideSystem : daysAgoStart(Nombre de jours)
Renvoie une date et une heure pour le début de la journée un nombre spécifié de jours auparavant. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| jours | Chaîne | Nombre entier de jours |
| Type | Description |
|---|---|
| Chaîne | Début de la journée UTC au format aaaa-mm-jj hh :mm :ss |
var now_GR = new GlideRecord('sysapproval_approver');
now_GR.addQuery('state', 'requested');
now_GR.addQuery('sys_updated_on', '<', gs.daysAgoStart(5));
now_GR.query();
Équivalent dans le champ d’application
Pour utiliser la méthode daysAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgoStart().
GlideSystem : fin du mois dernier()
Renvoie la date et l’heure de la fin du mois dernier dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC de la fin du mois dernier. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment interroger un enregistrement de rapport du dernier jour du mois dernier.
var month = gs.endOfLastMonth();
var monthd = new GlideDateTime(month);
monthd.addDays(-1);
var queueLast = new GlideRecord('u_amazon_connect_phone_metrics');
queueMtd.addQuery('u_queue_name',queueNames[i]);
queueMtd.addEncodedQuery('u_time_range=MTD');
queueMtd.addEncodedQuery('u_report_date'+ monthd);
queueMtd.orderByDesc('u_report_date');
queueMtd.query();
if(queueMtd.next()){
gs.info(queueMtd.u_report_date);
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfLastMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastMonth().
GlideSystem : fin de LastWeek()
Renvoie la date et l’heure de la fin de la semaine dernière dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC fin de la semaine dernière. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment interroger des enregistrements ouverts la dernière semaine du mois précédent.
var inc = new GlideRecord('incident');
inc.addQuery('active=true^priority=1^opened_atONLast month@javascript:gs.beginningOfLastMonth()@javascript:gs.endOfLastMonth()^opened_atONLast week@javascript:gs.beginningOfLastWeek()@javascript:gs.endOfLastWeek()');
inc.query();
while(inc.next())
{
gs.addInfoMessage(inc.getRowCount());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfLastWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastWeek().
GlideSystem : fin de LastYear()
Renvoie la date et l’heure de la fin de l’année dernière dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC au format aaaa-mm-jj hh :mm :ss. |
Cet exemple montre comment interroger les enregistrements créés pour tous les enregistrements créés au cours de l’année écoulée.
var inc = new GlideRecord('incident');
inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()');
inc.query();
while(inc.next()){
inc.assignment_group = "d625dccec0a8016700a222a0f7900d06";
inc.update();
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfLastYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastYear().
GlideSystem : fin de NextMonth()
Renvoie la date et l’heure de la fin du mois suivant dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Données et heure UTC. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment interroger des enregistrements de connaissances de la base de connaissances créés depuis le début de la journée jusqu’à la fin du mois prochain.
var query = "kb_knowledge_base=e81c9a0ddbc15810c38f0763b99619c1^ORkb_knowledge_base=21302e89db055810c38f0763b99619cc^valid_toBETWEENjavascript:gs.beginningOfToday()@javascript:gs.endOfNextMonth()^ORworkflow_state=pending_retirement^latest=true";
var rec = new GlideRecord('kb_knowledge');
rec.addEncodedQuery(query);
rec.addQuery('author', current.author);
rec.query();
while (rec.next()) {
var Kbtitle = rec.getValue('short_description');
articles.push(rec.number.toString()+ '' + Kbtitle);
template.print('Click here to view record<a href="https://give urs instance url here/nav_to.do?uri=kb_knowledge.do?sys_id=' + rec.sys_id + '">' + rec.number + '</a>');
}
var articlesList = "<ul>";
for (i = 0; i <= articles.length-1; i++) {
articlesList = articlesList + "<li>" + articles[i] + "</li>";
}
articlesList = articlesList + "</ul>";
Équivalent dans le champ d’application
Pour utiliser la méthode endOfNextMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextMonth().
GlideSystem : fin de la NextWeek()
Renvoie la date et l’heure de fin de la semaine prochaine dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour la fin de la semaine prochaine. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfNextWeek() dans une requête pour obtenir tous les visiteurs de la semaine écoulée.
var title = 'Visitors arriving this Week';
var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()';
Équivalent dans le champ d’application
Pour utiliser la méthode endOfNextWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextWeek().
GlideSystem : fin de l’année suivante ()
Renvoie la date et l’heure de la fin de l’année prochaine dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour la fin de l’année prochaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfNextYear() pour définir l’objet GlideDateTime sur la fin de l’année prochaine.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfNextYear());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfNextYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextYear().
GlideSystem : fin de ce mois()
Renvoie la date et l’heure de la fin de ce mois dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour la fin de ce mois. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisMonth() pour définir l’objet GlideDateTime sur la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisMonth());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisMonth().
GlideSystem : fin de ce trimestre()
Renvoie la date et l’heure de fin de ce trimestre dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC de la fin de ce trimestre. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisQuarter() pour définir l’objet GlideDateTime sur la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisQuarter());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisQuarter() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisQuarter().
GlideSystem : fin de cette semaine()
Renvoie la date et l’heure de la fin de cette semaine dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour la fin de cette semaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisWeek() pour définir l’objet GlideDateTime sur la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisWeek());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisWeek().
GlideSystem : fin de cette année()
Renvoie la date et l’heure de la fin de cette année dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour la fin de cette année. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisYear() pour définir l’objet GlideDateTime sur la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisYear());
}
Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisYear().
GlideSystem : fin de Today()
Récupère la date et l’heure de fin de la journée dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC au format aaaa-mm-jj hh :mm :ss. |
var beginToday = gs.beginningOfToday();
var endToday = gs.endOfToday();
var beginTomorrow = gs.beginningOfTomorrow();
var endTomorrow = gs.endOfTomorrow();
var beginYesterday = gs.beginningOfYesterday();
var endYesterday = gs.endOfYesterday();
gs.info('beginningOfToday: ' + beginToday);
gs.info('endOfToday: ' + endToday);
gs.info('-----------');
gs.info('beginningOfTomorrow: ' + beginTomorrow);
gs.info('endOfTomorrow: ' + endTomorrow);
gs.info('beginningOfYesterday: ' + beginYesterday);
gs.info('endOfYesterday: ' + endYesterday);
gs.info('-----------');
var gdt1 = new GlideDateTime(beginToday);
var gdt2 = new GlideDateTime(beginTomorrow);
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info('BeginTomorrow: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(endToday);
var gdt2 = new GlideDateTime(endTomorrow);
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info('EndTomorrow: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(beginToday);
var gdt2 = new GlideDateTime(beginYesterday);
var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2
gs.info('BeginningYesterday: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(endToday);
var gdt2 = new GlideDateTime(endYesterday);
var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2
gs.info('EndYesterday: ' + dur.getDisplayValue()); GlideSystem : fin de Tomorrow()
Récupère la date et l’heure de fin de demain dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC au format aaaa-mm-jj hh :mm :ss. |
var tomorrowEnd = new GlideDateTime();
tomorrowEnd.setValue(gs.endOfTomorrow()); GlideSystem : fin d’hier()
Obtient la date et l’heure de fin d’hier dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC au format (aaaa-mm-jj huh :mm :ss). |
var yesterdayEnd = new GlideDateTime();
yesterdayEnd.setValue(gs.endOfYesterday()); GlideSystem : eventQueue(nom de chaîne, objet glideRecord, chaîne parm1, chaîne parm2, file d’attente de chaîne)
Met en file d’attente un événement pour le gestionnaire d’événements.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Nom de l’événement mis en file d’attente. |
| glideRecord | Objet | Objet GlideRecord, tel que « current ». |
| parm1 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifiée. |
| parm2 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifiée. |
| queue | Chaîne | Nom de la file d'attente. |
| Type | Description |
|---|---|
| nul |
if (current.operation() != 'insert' && current.comments.changes()) {
gs.eventQueue("incident.commented", current, gs.getUserID(), gs.getUserName());
}
Équivalent dans le champ d’application
Pour utiliser la méthode eventQueue() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : eventQueue().
GlideSystem : eventQueueScheduled(nom de chaîne, objet glideRecord, chaîne parm1, chaîne parm2, expiration d’objet)
Met en file d’attente un événement pour le gestionnaire d’événements à une date et une heure spécifiées.
| Nom | Type | Description |
|---|---|---|
| nom | Chaîne | Nom de l’événement mis en file d’attente. |
| glideRecord | Objet | Objet GlideRecord, tel que « current ». |
| parm1 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifiée. |
| parm2 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifiée. |
| Expiration | Objet | Date et heure de traitement de cet événement. |
| Type | Description |
|---|---|
| nul |
if (current.operation() != 'insert' && current.comments.changes()) {
gs.eventQueueScheduled("incident.commented", current, gs.getUserID(), gs.getUserName(), new GlideDateTime('2018-06-02 20:00:00'));
}
Équivalent dans le champ d’application
Pour utiliser la méthode eventQueueScheduled() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : eventQueueScheduled().
GlideSystem : flushMessages()
Efface les messages de session enregistrés à l’aide d’addErrorMessage() ou d’addInfoMessage().
Les messages de session sont affichés en haut du formulaire. Dans les scripts côté client, utilisez g_form.clearMessages() pour supprimer les messages de session.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| nul |
Cet exemple montre comment analyser et renvoyer des messages d’erreur, puis efface les messages à l’aide de flushMessages().
MySessionUtil.getSessionError = function() {
var msg = null;
var msgs = gs.getErrorMessages().toArray();
if (msgs.length > 0) {
msg = msgs[0] + '';
gs.flushMessages();
}
return msg;
};
GlideSystem : getAvatar()
Renvoie le chemin d’accès du fichier à l’avatar de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Le chemin d’accès du fichier à l’avatar de l’utilisateur. |
var avatarFile = gs.getUser().getAvatar();
gs.addInfoMessage('User avatar ID: ' + avatarFile);
Sortie :
User avatar ID: c148e1d13741310042106710ce41f149.iix?t=small
GlideSystem : getCurrentScopeName()
Renvoie le nom du périmètre de l’application actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Nom du périmètre actuel. |
Cet exemple montre comment utiliser getCurrentScopeName() pour obtenir le champ d’application du processeur.
var incident_GR = new GlideRecord('Incident');
if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) {
gs.debug("processor scope = "+ gs.getCurrentScopeName());
var w = new global.Workflow();
var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update"); //id = id workflow
}
Équivalent dans le champ d’application
Pour utiliser la méthode getCurrentScopeName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getCurrentScopeName().
GlideSystem : getDateFormat()
Renvoie le format de date associé à l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 : getDateTimeFormat()
Renvoie le format de date et d’heure associé à l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Le format de date et d’heure associé à l’utilisateur actuel. |
L’exemple suivant renvoie le format de la date et de l’heure associées à l’utilisateur.
var userDateTimeFormat = gs.getDateTimeFormat();
gs.info(userDateTimeFormat);
Sortie :
yyyy-MM-dd HH:mm:ss
GlideSystem : getDisplayColumn(nom de table de chaînes)
Récupère la colonne d’affichage de la table.
| Nom | Type | Description |
|---|---|---|
| tableName | Chaîne | Nom de la table à partir de laquelle obtenir le nom de colonne d’affichage. |
| Type | Description |
|---|---|
| Chaîne | Afficher le nom de colonne |
// Return the sys_id value for a given table and its display value
function GetIDValue(table, displayValue) {
var rec = new GlideRecord(table);
var dn = gs.getDisplayColumn(table);
if (rec.get(dn, displayValue))
return rec.sys_id;
else
return null;
}
GlideSystem : getDisplayValueFor(String tableName, String recordID, String fieldName)
Renvoie la valeur d’affichage d’un champ spécifié sur un enregistrement spécifié.
| Nom | Type | Description |
|---|---|---|
| tableName | Chaîne | Nom de la table. |
| recordID | Chaîne | Sys_id pour mémoire. |
| Fieldname | Chaîne | Nom du champ dont la valeur d’affichage doit être renvoyée. |
| Type | Description |
|---|---|
| Chaîne | Valeur d’affichage pour le champ. |
Cet exemple montre comment utiliser getDisplayValueFor() pour renvoyer la valeur d’affichage du champ de numéro .
var value = gs.getDisplayValueFor(current.getTableName(),current.getValue('sys_id'),'number');
GlideSystem : getErrorMessages()
Renvoie la liste des messages d’erreur de la session qui ont été ajoutés par addErrorMessage().
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Liste des messages d’erreur |
Cet exemple montre comment analyser et renvoyer des messages d’erreur à l’aide de getErrorMessages().
MySessionUtil.getSessionError = function() {
var msg = null;
var msgs = gs.getErrorMessages().toArray();
if (msgs.length > 0) {
msg = msgs[0] + '';
gs.flushMessages();
}
return msg;
};
Équivalent dans le champ d’application
Pour utiliser la méthode getErrorMessages() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : getErrorMessages().
GlideSystem : getEscapedProperty(clé de chaîne, objet substituteObject)
Récupère la propriété et l’échappe pour l’analyse XML.
| Nom | Type | Description |
|---|---|---|
| key | Chaîne | Clé pour la propriété dont la valeur doit être renvoyée. |
| substituteObject | Objet | Facultatif. Objet à renvoyer si la propriété est introuvable. |
| Type | Description |
|---|---|
| Chaîne | ou substituteObject si la propriété est introuvable. |
var propValue = gs.getEscapedProperty("com.example.my_test_property");
gs.addInfoMessage("This is my property value " + propValue);
GlideSystem : getImpersonatingUserDisplayName()
Renvoie le nom d’affichage de l’utilisateur dont l’identité a été empruntée.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Nom d’affichage de l’utilisateur dont l’identité est empruntée. |
Cet exemple montre comment obtenir le nom d’affichage utilisateur de l’emprunteur d’identité.
var user = gs.getUserDisplayName();
gs.print ("The current user display name is: " + user);
var name = gs.getImpersonatingUserDisplayName();
gs.print("Impersonating user display name: " + name);
The current user display name is: abel.tuter
Impersonating user display name: adminGlideSystem : getImpersonatingUserName()
Renvoie le nom de l’utilisateur dont l’identité est empruntée ou est nul si l’identité n’est pas empruntée.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Nom de l’utilisateur dont l’identité a été empruntée |
Cet exemple montre comment obtenir le nom d’utilisateur de l’emprunteur d’identité.
var name = gs.getImpersonatingUserName();
var actual_user = null;
if (name == null || name == '')
actual_user = user;
else
actual_user = Packages.com.glide.sys.User.getUser(name);
var recent_impersonations = actual_user.getPreference('recent.impersonations');
var admin_role=actual_user.hasRole("admin");
GlideSystem : getInfoMessages()
Récupère la liste des messages d’information de la session qui ont été ajoutés par addInfoMessage().
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Liste des messages d’informations. |
Cet exemple montre comment obtenir les messages d’information.
var messages = gs.getInfoMessages();
if (messages.toString().indexOf('Conflicts Detected') == -1)
gs.addInfoMessage(msg);
GlideSystem : getInitials()
Renvoie les initiales de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Les initiales de l’utilisateur. |
var userInitials = gs.getUser().getInitials();
gs.addInfoMessage('User initials: ' + userInitials);
Sortie :
User initials: SA
GlideSystem : getMessage(String messageID, Object args)
Récupère les messages traduits 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 Messages, consultez la table Messages.
| Nom | Type | Description |
|---|---|---|
| messageID | Chaîne | Identificateur de message. Vous pouvez localiser cette valeur dans le champ Clé de la table Message [sys_ui_message]. Notez que le champ Clé peut ressembler exactement à la chaîne de message réelle. |
| args | Objet | Facultatif. Liste de chaînes ou d’autres valeurs définies par java.text.MessageFormat qui remplacent les variables dans le message spécifié. Par exemple : 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. |
| Type | Description |
|---|---|
| Chaîne | Message d’interface utilisateur demandé. |
Cet exemple montre le message renvoyé pour l’utilisateur actuel lorsque l’espagnol est la langue actuelle.
var my_message = gs.getMessage("rows will not be updated");
alert(my_message);
Sortie :
las filas no se actualizarán
Cet exemple montre comment remplacer une 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.getMessage("Abort adding action '{0}', same subflow can't be added twice in {1} subflow.", [current.action.name, current.sub_flow.name]);
alert(my_message);
Sortie :
Abort adding action update record, same subflow can't be added twice in schedule users subflow.
Équivalent dans le champ d’application
Pour utiliser la méthode getMessage() dans une application incluse dans le champ d’application, utilisez la méthode dans le champ d’application correspondante : getMessage().
GlideSystem : getMessageS(String messageID, Object args)
Récupère les messages traduits à afficher dans l’interface utilisateur et échappe toutes les graduations (').
Si l’identificateur de message spécifié (clé) existe dans la table Message [sys_ui_message] pour la langue actuelle, la méthode renvoie le message traduit. Si l’identificateur de message spécifié n’existe pas pour la langue actuelle, la méthode renvoie la version anglaise du message. Si l’identificateur du message n’existe pas dans la table, il renvoie l’ID du message.
Pour plus d’informations sur la table Messages, consultez la table Messages.
Utile si vous effectuez une insertion dans une expression JavaScript à partir de Jelly.
| Nom | Type | Description |
|---|---|---|
| ID de message | Chaîne | Identificateur de message. Vous pouvez localiser cette valeur dans le champ Clé de la table Message [sys_ui_message]. Notez que le champ Clé peut ressembler exactement à la chaîne de message réelle. |
| args | Objet | Facultatif. Liste de chaînes ou d’autres valeurs définies par java.text.MessageFormat qui remplacent les variables dans le message spécifié. Par exemple : 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. |
| Type | Description |
|---|---|
| Chaîne | Message spécifié avec des coches échappées. |
/*
"I love France" translates to "J'aime la France" in French.
Rendering this without escaping the tick in "J'aime" would break Jelly, because
the tick would prematurely end the variable assignment, and everything that
follows (aime la France') would be a jelly syntax error.
*/
var my_message = '${gs.getMessageS("I love France")}';
alert(my_message);
Sortie :
J'aime la France
GlideSystem : getMessageLang(Message de chaîne, Langage de chaîne, Arg. de tableau)
Traduit le message spécifié dans la langue spécifiée.
Vous pouvez également intégrer des variables dans le message transmis. La méthode résout ces variables avec les valeurs transmises dans le args tableau.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message à traduire. |
| language | Chaîne | Langue dans laquelle traduire le message. Format : norme BCP 47 |
| 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 : 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. |
| Type | Description |
|---|---|
| Chaîne | Message traduit. |
L’exemple suivant transforme le message spécifié en espagnol.
var my_message = gs.getMessageLang("New email", "es");
gs.info(my_message);
Sortie :
Nuevo correo electrónico
L’exemple suivant montre comment remplacer des variables dans un message.
var my_message = gs.getMessageLang("There are {0} new emails for {1}", "es", [current.numEmails, current.userName]);
gs.info(my_message);
Sortie :
Hay 7 correos nuevos para John Smith
GlideSystem : getNodeName(objet obj., index numérique)
Renvoie le nom du nœud de l’index spécifié.
| Nom | Type | Description |
|---|---|---|
| obj. | Objet | Objet à examiner. |
| Index | Numéro | Index à partir duquel obtenir le nom du nœud. |
| Type | Description |
|---|---|
| Chaîne | Nom du nœud |
function doInsert(nodeList) {
gs.print('Doing insert');
var task = new GlideRecord('task');
task.initialize();
for (var x=0; x < nodeList.size(); x++) {
var name = gs.getNodeName(nodeList, x);
var value = gs.getNodeValue(nodeList, x);
task.setValue(name, value);
}
task.insert();
}
GlideSystem : getNodeValue(objet obj., index numérique)
Renvoie la valeur de nœud pour l’index spécifié.
| Nom | Type | Description |
|---|---|---|
| obj. | Objet | Objet à examiner. |
| Index | Numéro | Index à partir duquel obtenir la valeur du nœud |
| Type | Description |
|---|---|
| Objet | Valeur du nœud |
function doInsert(nodeList) {
gs.print('Doing insert');
var task = new GlideRecord('task');
task.initialize();
for (var x=0; x < nodeList.size(); x++) {
var name = gs.getNodeName(nodeList, x);
var value = gs.getNodeValue(nodeList, x);
task.setValue(name, value);
}
task.insert();
}
GlideSystem : getPreference(clé de chaîne, objet par défaut)
Renvoie la préférence utilisateur spécifiée.
| Nom | Type | Description |
|---|---|---|
| key | Chaîne | Clé pour la préférence. |
| par défaut | Objet | Valeur par défaut à utiliser si la préférence spécifiée est introuvable. |
| Type | Description |
|---|---|
| Chaîne | Valeur de préférence. En l’absence de préférence, renvoie la valeur par défaut spécifiée. |
function getSelectedProject() {
var array= new Array();
var prj_id = gs.getPreference("prj_id"); //This will fetch value from user preference
var gr = new GlideRecord('pm_project_task');
gr.addQuery('parent', prj_id);
gr.addActiveQuery();
while(gr.next()) {
array.push(gr.sys_id.toString());
}
return array;
}
GlideSystem : getProperty(clé de chaîne, objet alt)
Renvoie la valeur d’une propriété Glide. Si la propriété est introuvable, renvoie la valeur spécifiée alt .
| Nom | Type | Description |
|---|---|---|
| key | Chaîne | Clé pour la propriété dont la valeur doit être renvoyée. |
| alt. | Objet | Facultatif. Autre objet à renvoyer si la propriété n’est pas trouvée. |
| Type | Description |
|---|---|
| Chaîne | Valeur de la propriété Glide ou de l’autre objet défini ci-dessus. |
//Check for attachments and add link if there are any
var attachment_link = '';
var rec = new GlideRecord('sc_req_item');
rec.addQuery('sys_id', current.request_item);
rec.query();
if(rec.next()){
if(rec.hasAttachments()){
attachment_link = gs.getProperty('glide.servlet.uri') + rec.getLink();
}
}
GlideSystem : getScriptError(script de chaîne)
Renvoie l’erreur de script trouvée dans le script spécifié, le cas échéant.
| Nom | Type | Description |
|---|---|---|
| script | Chaîne | Script pour vérifier les erreurs. |
| Type | Description |
|---|---|
| Chaîne | Message d’erreur. Nul s’il n’y a pas d’erreur. |
if (gs.isValidScript(current.script) == false)
{
current.setAbortAction(true);
var error = gs.getScriptError(current.script);
current.script.setError(error);
}
GlideSystem : getSession()
Renvoie un objet GlideSession.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Objet GlideSession | Objet GlideSession pour la session en cours |
if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){
var qc = current.addQuery('u_visibility', "both");
qc.addOrCondition('u_visibility', '');
if (gs.getImpersonatingUserName() != null) {
gs.getSession().clearClientData('navQuery');
}
var navQuery = gs.getSession().getClientData('navQuery');
if (navQuery == null) {
var isManager = gs.getUser().getRecord().getValue('u_is_manager');
if (!isManager) {
qc.addOrCondition('u_visibility', 'nonmanager');
gs.getSession().putClientData('navQuery', 'nonmanager');
} else {
qc.addOrCondition('u_visibility', 'manager');
gs.getSession().putClientData('navQuery', 'manager');
}
} else {
qc.addOrCondition('u_visibility', navQuery);
}
}
Équivalent dans le champ d’application
Pour utiliser la méthode getSession() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : getSession().
GlideSystem : getSessionID()
Retourne l’ID de session GlideSession.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | ID de session |
var gr_NOW = new GlideRecord('v_user_session');
var sessionId = gs.getSessionID();
gs.log("Session ID is: " + sessionId);
Sortie
Session ID is: FEE589B3DB7EE4103DD9C39D139619D7
Équivalent dans le champ d’application
Pour utiliser la méthode getSessionID() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : getSessionID.
GlideSystem : getStyle(String tableName, String fieldName, String fieldValue)
Renvoie le style défini pour la table, le champ et la valeur de champ.
| Nom | Type | Description |
|---|---|---|
| tableName | Chaîne | Nom de la table |
| Fieldname | Chaîne | Nom de champ |
| fieldValue | Chaîne | Valeur de champ |
| Type | Description |
|---|---|
| Chaîne | Style du champ spécifié. |
var returnString = gs.getStyle('<tableName>', '<fieldName>', '<fieldValue>');
gs.print(returnString);
GlideSystem : getTimeFormat()
Renvoie le format d’heure associé à l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | 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 : getUser()
Renvoie une référence à l’objet utilisateur pour l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| GlideUser | Référence à un objet utilisateur pour l’utilisateur actuel. |
L’exemple suivant montre comment obtenir l’objet utilisateur actuel.
var user = gs.getUser();
gs.print ("The current user is: " + user);
The current user is: com.glide.sys.User@db5dd9L’exemple suivant montre comment vérifier si l’utilisateur actuel dispose du rôle workflow_admin.
var role = gs.getUser().hasRole('workflow_admin');
gs.print ("Does the current user have the workflow_admin role: " + role);
Does the current user have the workflow_admin role: trueÉquivalent dans le champ d’application
Pour utiliser la méthode getUser() dans une application incluse dans le champ d’application, utilisez la méthode correspondante dans le champ d’application : getUser().
GlideSystem : getUserDisplayName()
Obtient le nom d’affichage de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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
Équivalent dans le champ d’application
Pour utiliser la méthode getUserDisplayName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserDisplayName().
GlideSystem : getUserID()
Renvoie le sys_id de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Sys_id de l’utilisateur actuel. |
Cet exemple récupère les sys_id de l’utilisateur actuel.
var currentUserId = gs.getUserID();
gs.print("Current user ID: " + currentUserId);
Current user ID: 6816f79cc0a8016401c5a33be04be441Équivalent dans le champ d’application
Pour utiliser la méthode getUserID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserID().
GlideSystem : getUserName()
Renvoie le nom d’utilisateur de l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Néant |
| 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 récupère le nom d’utilisateur de l’utilisateur actuel et d’un utilisateur dont l’identité a été empruntée.
var user = gs.getUserName();
gs.info("The current user name is: " + user);
var impUser = new GlideImpersonate();
impUser.impersonate("62826bf03710200044e0bfc8bcbe5df1");
var user2 = gs.getUserName();
gs.info("The impersonated user name is: " + user2);
The current user name is: admin
The impersonated user name is: abel.tuterÉquivalent dans le champ d’application
Pour utiliser la méthode getUserName() dans une application incluse dans le champ d’application, utilisez la méthode correspondante dans le champ d’application : getUserName().
GlideSystem : getUserNameByUserID(String user_id)
Renvoie le nom d’affichage de l’utilisateur en fonction du nom de connexion de l’utilisateur fourni.
| Nom | Type | Description |
|---|---|---|
| user_id | Chaîne | Nom de connexion de l’utilisateur à partir duquel récupérer le nom d’affichage associé. |
| Type | Description |
|---|---|
| Chaîne | Nom d’affichage de l’utilisateur demandé. Remarque : Si cette méthode ne peut pas trouver un utilisateur avec l’ID demandé, elle renvoie la valeur d’entrée fournie. |
L’exemple suivant montre comment obtenir le nom d’affichage de l’utilisateur spécifié.
var displayName = gs.getUserNameByUserID('abel.tuter');
gs.info('User display name is: ' + displayName);
User display name is: Abel TuterGlideSystem : getXMLNodeList(chaîne xml)
Construit un tableau de tous les nœuds et valeurs dans un document XML.
| Nom | Type | Description |
|---|---|---|
| XML (XML) | Chaîne | Document XML à analyser. |
| Type | Description |
|---|---|
| Liste de tableaux | Liste des noms et des valeurs du nœud XML le plus externe. |
L’exemple suivant montre comment obtenir une liste de nœuds XML et leurs valeurs associées dans une liste de tableau.
var nodeList = gs.getXMLNodeList("<note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note>");
gs.print ("The node contains: " + nodeList);
The node contains: [to : Tove, from : Jani, heading : Reminder, body : Don't forget me this weekend!]
GlideSystem : getXMLText(Chaîne xml, Chaîne xpathQuery)
Renvoie le texte XML du premier élément de la chaîne XML qui correspond à la requête XPath.
| Nom | Type | Description |
|---|---|---|
| XML (XML) | Chaîne | Chaîne XML à rechercher. |
| Requête xpathQuery | Chaîne | Requête XPath à faire correspondre. |
| Type | Description |
|---|---|
| Chaîne | Nœud XML correspondant aux paramètres de recherche. |
L’exemple suivant montre comment obtenir la valeur d’un élément XML spécifié dans un nœud transmis.
var nodeList = gs.getXMLText("<outer><note><to>Tove</to><from>Jani</from><heading>Reminder</heading><body>Don't forget me this weekend!</body></note></outer>", "//from");
gs.print ("The from element contains: " + nodeList);
The from element contains: JaniGlideSystem : hasRole(String roleName)
Détermine si l’utilisateur actuel possède au moins un des rôles transmis.
| Nom | Type | Description |
|---|---|---|
| roleName | Chaîne | Liste de rôles séparés par des virgules. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si l’utilisateur actuel possède au moins un des rôles spécifiés. Valeurs possibles :
|
L’exemple suivant montre comment vérifier si l’utilisateur actuel a le rôle administrateur ou groups_admin.
if (!gs.hasRole("admin, groups_admin") && gs.getSession().isInteractive()) {
var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups...
qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
}
Équivalent dans le champ d’application
Pour utiliser la méthode hasRole() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : hasRole().
GlideSystem : hasRoleInGroup(Objet roleName, Groupe d’objets)
Détermine si l’utilisateur actuel possède le rôle spécifié au sein d’un groupe spécifié.
| Nom | Type | Description |
|---|---|---|
| roleName | Objet | Nom du rôle. |
| groupe | Objet | Sys_id du groupe pour vérifier le rôle spécifié. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si l’utilisateur actuel possède le rôle spécifié dans le groupe spécifié. Valeurs possibles :
|
L’exemple suivant montre comment vérifier si le groupe de sys_user_group dispose du rôle role_name.
var group = new GlideRecord('sys_user_group');
group.addQuery('name', 'GROUP_NAME');
group.setLimit(1);
group.query();
if (group.next()) {
if (gs.hasRoleInGroup('role_name', group)) {
gs.print('User has role in group');
} else {
gs.print('User does NOT have role in group');
}
}
GlideSystem : hoursAgo(Nombre d’heures)
Renvoie une date et une heure pour le nombre spécifié d’heures. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.
| Nom | Type | Description |
|---|---|---|
| Heures | Numéro | Nombre d’heures plus tôt. |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour le nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss |
var currentDateTime = gs.hoursAgo(0);
gs.info("Current date/time: " + currentDateTime);
var agoDateTime = gs.hoursAgo(1);
gs.info("Ago date/time: " + agoDateTime);
Current date/time: 2021-03-17 20:53:25
Ago date/time: 2021-03-17 19:53:25Équivalent dans le champ d’application
Pour utiliser la méthode hoursAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : hoursAgo().
GlideSystem : hoursAgoEnd(Nombre d’heures)
Renvoie la date et l’heure de fin de l’heure pour le nombre d’heures spécifié passé. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.
| Nom | Type | Description |
|---|---|---|
| Heures | Nombre (entier) | Nombre d’heures plus tôt. |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC de fin du nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss |
var currentDateTime = gs.hoursAgoEnd(0);
gs.print("Current date/time: " + currentDateTime);
var agoDateTime = gs.hoursAgoEnd(1);
gs.print("Ago date/time: " + agoDateTime);
Current date/time: 2021-03-17 20:59:59
Ago date/time: 2021-03-17 19:59:59Équivalent dans le champ d’application
Pour utiliser la méthode hoursAgoEnd() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : hoursAgoEnd().
GlideSystem : hoursAgoStart(Nombre d’heures)
Renvoie la date et l’heure de début de l’heure pour le nombre d’heures spécifié passé. La valeur renvoyée est ajustée en fonction du fuseau horaire de l’instance.
| Nom | Type | Description |
|---|---|---|
| Heures | Numéro | Nombre d’heures plus tôt. |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC de fin du nombre spécifié d’heures. Format : aaaa-mm-jj hh :mm :ss |
var currentDateTime = gs.hoursAgoStart(0);
gs.print("Current date/time: " + currentDateTime);
var agoDateTime = gs.hoursAgoStart(1);
gs.print("Ago date/time: " + agoDateTime);
Current date/time: 2021-03-17 20:00:00
Ago date/time: 2021-03-17 19:00:00Équivalent dans le champ d’application
Pour utiliser la méthode hoursAgoStart() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : hoursAgoStart().
GlideSystem : isFirstDayOfMonth(date de l’objet)
Vérifie si la date dans l’objet de date spécifié est le premier jour du mois.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet Date spécifiée est le premier jour du mois. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet date spécifié est le premier jour du mois.
var gdt = new GlideDateTime();
gdt.setValue('2021-04-01 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);
gdt.setValue('2021-04-21 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);
First day of month: true
First day of month: falseGlideSystem : isFirstDayOfWeek(date de l’objet)
Vérifie si la date dans l’objet de date spécifié est le premier jour de la semaine. Cette méthode utilise la norme ISO selon laquelle le lundi est le premier jour de la semaine.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet de date actuel est le premier jour de la semaine (lundi). Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet de date spécifié est le premier jour de la semaine.
var gdt = new GlideDateTime();
gdt.setValue('2021-03-02 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);
gdt.setValue('2021-03-22 12:00:00');
var currentDay = gs.isFirstDayOfWeek(gdt);
gs.info("First day of week: " + currentDay);
First day of week: false
First day of week: trueGlideSystem : isFirstDayOfYear(date de l’objet)
Vérifie si la date dans l’objet de date spécifié est le premier jour de l’année.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet de date spécifié est le premier jour de l’année. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet de date spécifié est le premier jour de l’année.
var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);
gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isFirstDayOfYear(gdt);
gs.info("First day of year: " + currentDay);
First day of year: false
First day of year: trueGlideSystem : isInteractive()
Vérifie si la session en cours est interactive.
Un exemple de session interactive est lorsqu’un utilisateur se connecte à l’aide de l’écran de connexion. Un exemple de session non interactive est l’utilisation d’une demande SOAP pour récupérer des données.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la session est interactive. Valeurs possibles :
|
if (!gs.hasRole('admin') && gs.isInteractive()) {
var qc1 = current.addQuery('u_group', '');
var gra = new GlideRecord('sys_user_grmember');
gra.addQuery('user', gs.getUserID());
gra.query();
while (gra.next()) {
qc1.addOrCondition('u_group', gra.group);
}
}
Équivalent dans le champ d’application
Pour utiliser la méthode isInteractive() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : isInteractive().
GlideSystem : isLastDayofMonth(date de l’objet)
Vérifie si la date dans l’objet de date spécifié est le dernier jour du mois.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet Date spécifié est le dernier jour du mois. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet de date spécifié est le dernier jour du mois.
var gdt = new GlideDate();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);
gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);
Last day of month: true
Last day of month: falseGlideSystem : isLastDayOfWeek(date de l’objet)
Vérifie si la date dans l’objet de date spécifié est le dernier jour de la semaine. Cette méthode utilise la norme ISO selon laquelle le dimanche est le dernier jour de la semaine.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet de date actuel est le dernier jour de la semaine (dimanche). Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet Date spécifié est le dernier jour de la semaine.
var gdt = new GlideDate();
gdt.setValue('2021-03-01 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);
gdt.setValue('2021-03-21 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);
First day of week: false
First day of week: trueGlideSystem : isLastDayOfYear(date de l’objet)
Vérifie si la date de l’objet de date spécifié est le dernier jour de l’année.
| Nom | Type | Description |
|---|---|---|
| date | Objet | Objet de date sur lequel vérifier la date, tel que GlideDateTime ou GlideDate. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la date dans l’objet de date actuel est le dernier jour de l’année. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date dans l’objet de date spécifié est le dernier jour de l’année.
var gdt = new GlideDateTime();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);
gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfYear(gdt);
gs.info("Last day of year: " + currentDay);
Last day of year: true
Last day of year: falseGlideSystem : isLoggedIn()
Détermine si l’utilisateur actuel est actuellement connecté.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si l’utilisateur actuel est connecté. Valeurs possibles :
|
Cet exemple montre comment déterminer si l’utilisateur actuel est connecté.
if(gs.isLoggedIn())
gs.info("Current user is logged in");
else
gs.info("Current user is NOT logged in");
Current user is logged inÉquivalent dans le champ d’application
Pour utiliser la méthode isLoggedIn() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : isLoggedIn().
GlideSystem : isMobile()
Détermine si la demande provient d’un appareil mobile.
Vous pouvez utiliser cette méthode dans les conditions d’action d’interface utilisateur et les règles métier.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la demande provient d’un appareil mobile. Valeurs possibles :
|
Cet exemple montre comment déterminer si l’appareil actuel est un appareil mobile.
if(gs.isMobile())
gs.info("Submitted from mobile UI");
else
gs.info("NOT submitted from mobile UI");
Submitted from mobile UIÉquivalent dans le champ d’application
Pour utiliser la méthode isMobile() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : isMobile().
GlideSystem : lastWeek()
Renvoie la date et l’heure il y a une semaine dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure il y a une semaine. Format : (UTC) aaaa-MM-jj hh :mm :ss |
Cet exemple montre comment obtenir la date qui est une semaine à partir de la date dans l’objet date actuel.
var gdt = new GlideDateTime();
gdt.setValue('2021-03-22 01:00:00');
gs.info("Current date: " + gs.nowDateTime());
gs.info("One week earlier: " + gs.lastWeek());
Current date: 2021-03-22 15:27:07
One week earlier: 2021-03-15 15:27:07GlideSystem : log(Message de chaîne, Source de chaîne)
Consigne un message dans le journal système et l’enregistre dans la table syslog.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message à journaliser. |
| source | Chaîne | Facultatif. Source du message. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant montre comment publier une entrée de journal à l’aide de constantes et de variables.
var count = new GlideAggregate('incident');
count.addQuery('active', 'true');
count.addAggregate('COUNT', 'category');
count.query();
while (count.next()) {
var category = count.category;
var categoryCount = count.getAggregate('COUNT', 'category');
gs.log("The are currently " + categoryCount + " incidents with a category of " + category, "Incident Counter");
}
GlideSystem : logError(Message de chaîne, Source de chaîne)
Consigne une erreur dans le journal système et l’enregistre dans la table syslog.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message d’erreur à consigner. |
| source | Chaîne | Facultatif. Source du message. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant consigne une erreur si la table Incident est introuvable.
var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
gs.logError('Incident table could not be found');
return;
}
GlideSystem : logWarning(Message de chaîne, Source de chaîne)
Consigne un avertissement dans le journal système et l’enregistre dans la table syslog.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message à journaliser. |
| source | Chaîne | Facultatif. Source du message. |
| Type | Description |
|---|---|
| nul |
L’exemple suivant consigne un avertissement si la table Incident est introuvable.
var gr_NOW = new GlideRecord("incident");
if (!gr_NOW.isValid()) {
gs.logWarning('Incident table could not be found');
return;
}
GlideSystem : minutesAgo(nombre de minutes)
Renvoie la date et l’heure correspondant au nombre spécifié de minutes.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre de minutes passées à renvoyer. |
| Type | Description |
|---|---|
| Chaîne | Date et heure UTC pour le nombre spécifié de minutes. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser la méthode minutesAgo() dans un appel addQuery().
// Check to see if the user has failed to login too many times
// when the limit is reached, lock the user out of the system
//
//Check failed logins in the last 15 minutes
var now_GR = new GlideRecord('sysevent');
now_GR.addQuery('name', 'login.failed');
now_GR.addQuery('parm1', event.parm1.toString());
now_GR.addQuery('sys_created_on','>=', gs.minutesAgo(15));
now_GR.query();
var rowCount = now_GR.getRowCount();
if(rowCount >= 5){
var now_GR = new GlideRecord("sys_user");
now_GR.addQuery("user_name", event.parm1.toString());
now_GR.query();
if (now_GR.next()) {
now_GR.locked_out = true;
now_GR.update();
gs.log("User " + event.parm1 + " locked out due to too many invalid login attempts");
}
}
GlideSystem : minutesAgoEnd(Nombre minutes)
Renvoie une date et une heure pour la fin de la minute qui a eu lieu il y a un certain nombre de minutes. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre entier de minutes passées, tel que 5 ou 11. |
| Type | Description |
|---|---|
| Chaîne | UTC le nombre spécifié de minutes, à 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 UTC.
var nowDateTime = new GlideDateTime();
gs.print("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.print("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);
Sortie :
Now: 2021-10-20 15:22:13
Thirty minutes ago end time: 2021-10-20 14:52:59
Équivalent dans le champ d’application
Pour utiliser la méthode minutesAgoEnd() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : minutesAgoEnd().
GlideSystem : minutesAgoStart(Nombre de minutes)
Renvoie une date et une heure pour le début de la minute il y a un certain nombre de minutes. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre entier de minutes passées, tel que 15 ou 112. |
| Type | Description |
|---|---|
| Chaîne | UTC le nombre spécifié de minutes, 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 d’il y a 30 minutes au début de la minute UTC.
var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoStart(30);
gs.info("Thirty minutes ago: " + thirtyMinutesAgoDateTime);
Sortie :
Now: 2021-10-20 14:56:18
Thirty minutes ago: 2021-10-20 14:26:00
Équivalent dans le champ d’application
Pour utiliser la méthode minutesAgoStart() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : minutesAgoStart().
GlideSystem : monthsAgo(Nombre de mois)
Renvoie la date et l’heure d’un certain nombre de mois passés dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre entier de mois plus tôt. |
| Type | Description |
|---|---|
| Chaîne | UTC du nombre de mois spécifié il y a exactement à 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 (UTC).
var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var oneMonthAgoDateTime = gs.monthsAgo(1);
gs.info("One month ago: " + oneMonthAgoDateTime);
Sortie :
Now: 2021-10-20 15:29:15
One month ago: 2021-09-20 15:29:15
Équivalent dans le champ d’application
Pour utiliser la méthode monthsAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : monthsAgo().
GlideSystem : moisAgoEnd(Nombre de mois)
Retourne la date et l’heure du dernier jour du mois il y a un nombre spécifié de mois.
| Nom | Type | Description |
|---|---|---|
| Mois | Nombre (entier) | Nombre de mois, par exemple 4 ou 16. |
| Type | Description |
|---|---|
| Chaîne | Horodatage 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, ainsi que la date et l’heure d’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 : moisAgoStart(Nombre de mois)
Renvoie une date et une heure correspondant au début du mois il y a un certain nombre de mois. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre entier de mois passé, tel que 5 ou 14. |
| Type | Description |
|---|---|
| Chaîne | UTC début du mois le nombre de mois spécifié. 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 trois mois (UTC).
var nowDateTime = new GlideDateTime();
gs.info("Now: " + nowDateTime);
var threeMonthsAgoDateTime = gs.monthsAgoStart(3);
gs.info("Three months ago start date and time: " + threeMonthsAgoDateTime);
Sortie :
Now: 2021-10-20 15:05:27
Three months ago start date and time: 2021-07-01 07:00:00
Équivalent dans le champ d’application
Pour utiliser la méthode monthsAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : monthsAgoStart().
GlideSystem : nil(objet objet)
Interroge un objet et renvoie la valeur vrai si l’objet est nul ou contient une chaîne vide.
| Nom | Type | Description |
|---|---|---|
| obj. | Objet | L’objet à vérifier. |
| Type | Description |
|---|---|
| Booléen | True si chaîne nulle ou vide ; sinon, c’est faux. |
if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
var start = current.u_date1.getGlideObject().getNumericValue();
var end = current.u_date2.getGlideObject().getNumericValue();
if (start > end) {
gs.addInfoMessage('start must be before end');
current.u_date1.setError('start must be before end');
current.setAbortAction(true);
}
}
Équivalent dans le champ d’application
Pour utiliser la méthode nil() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : nil().
GlideSystem : now()
Renvoie la date actuelle en UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | La date actuelle, au format défini par l’utilisateur, au format UTC. |
// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
// Do something based on the Password Changing
gs.log("The user password changed so do something else...");
now_GR.u_password_last_reset = gs.now();
now_GR.update();
}
GlideSystem : nowNoTZ()
Renvoie la date et l’heure actuelles au format UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | La date et l’heure UTC actuelles |
// When the user password changes then set the u_password_last_reset field
// to now so we know when to force another update
var now_GR = new GlideRecord("sys_user");
if (now_GR.get(event.parm1.toString())) {
// Do something based on the Password Changing
gs.log("The user password changed so do something else...");
now_GR.u_password_last_reset = gs.nowNoTZ();
now_GR.update();
}
GlideSystem : nowDateTime()
Renvoie la date et l’heure actuelles au format défini par l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Date et heure actuelles au format défini par l’utilisateur. Pour plus d’informations sur la définition du format de date et d’heure système, consultez Champs Date et Date/Heure. |
var currentDateTime = gs.nowDateTime();
gs.print("Current date/time: " + currentDateTime);
Current date/time: 2021-03-17 14:04:02Lors de la définition d’une variable dans un script de workflow sur la date et l’heure actuelles, utilisez la méthode setDisplayValue( ). Le script suivant fixe la variable de workflow end_date à la date et à l’heure actuelles.
current.variables.end_date.setDisplayValue(gs.nowDateTime());
GlideSystem : nowGlideDateTime()
Obtient un objet GlideDateTime avec la date et l’heure actuelles dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
Une fois que vous avez obtenu un objet GlideDateTime avec la date et l’heure actuelles, vous pouvez utiliser les méthodes GlideDateTime pour effectuer des opérations de date et d’heure, telles que des calculs de date et d’heure, la mise en forme d’une date et d’une heure ou la conversion d’un format date-heure à l’autre.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Objet | Objet GlideDateTime avec la date et l’heure actuelles au format UTC. |
Définit le u_target_date de champ sur la date et l’heure actuelles au format UTC.
current.u_target_date = gs.nowGlideDateTime();
GlideSystem : print(Message de chaîne)
Écrit un message dans le journal système.
Cette méthode n’écrit pas le message dans la table syslog à moins que le débogage n’ait été activé.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message à consigner |
| Type | Description |
|---|---|
| nul |
var rec = new GlideRecord('incident');
rec.addQuery('active',false);
rec.query();
while (rec.next()) {
gs.print('Inactive incident ' + rec.number + ' deleted');
rec.deleteRecord();
}
GlideSystem : quartersAgo(Nombre, trimestres)
Renvoie la date et l’heure d’un certain nombre de trimestres passés dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier des trimestres passés. |
| Type | Description |
|---|---|
| Chaîne | UTC du trimestre qui était le nombre spécifié de trimestres auparavant. Format : aaaa-mm-jj hh :mm :ss |
L’exemple suivant affiche simultanément la date et l’heure actuelles et la date et l’heure d’il y a quatre trimestres.
var nowDateTime = new GlideDateTime();
gs.print("Now: " + nowDateTime);
var fourQuartersAgoDateTime = gs.quartersAgo(4);
gs.print("Four quarters ago: " + fourQuartersAgoDateTime);
Sortie :
Now: 2021-10-20 16:27:32
Four quarters ago: 2020-10-20 16:27:32
GlideSystem : quartersAgoEnd(Nombre de trimestres)
Renvoie la date et l’heure du dernier jour du trimestre, pour un nombre spécifié de trimestres passés. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier de trimestres |
| Type | Description |
|---|---|
| Chaîne | UTC fin du trimestre qui était le nombre spécifié de trimestres plus tôt, au format aaaa-mm-jj hh :mm :ss |
Équivalent dans le champ d’application
Pour utiliser la méthode quartersAgoEnd() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le champ d’application correspondante : quartersAgoEnd().
GlideSystem : quartersAgoStart(Nombre de trimestres)
Renvoie la date et l’heure du premier jour du trimestre, pour un nombre de trimestres spécifié passé. Renvoyé dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier de trimestres |
| Type | Description |
|---|---|
| Chaîne | Fin du mois UTC qui était le nombre spécifié de trimestres plus tôt, au format aaaa-mm-jj hh :mm :ss |
Équivalent dans le champ d’application
Pour utiliser la méthode quartersAgoStart() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : quartersAgoStart().
GlideSystem : setProperty(clé de chaîne, valeur de chaîne, description de chaîne)
Définit la clé spécifiée sur la valeur spécifiée.
| Nom | Type | Description |
|---|---|---|
| key | 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é. |
| Type | Description |
|---|---|
| nul |
gs.setProperty("glide.foo","bar","foo");
gs.info(gs.getProperty("glide.foo"));
Sortie : barre
Équivalent dans le champ d’application
Pour utiliser la méthode setProperty() dans une application incluse dans le champ d’application, utilisez la méthode incluse dans le périmètre correspondante : setProperty().
GlideSystem : setRedirect(URI d’objet)
Définit l’URI de redirection pour cette transaction, qui détermine ensuite la page suivante que l’utilisateur verra.
| Nom | Type | Description |
|---|---|---|
| URI | Objet | URI à définir comme redirection |
| Type | Description |
|---|---|
| nul |
Cet exemple redirige l’utilisateur vers un élément de catalogue particulier et transmet l’e-mail actuel comme paramètre.
gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user="
+ current.sys_id + "&sysparm_email=" + current.email)
Équivalent dans le champ d’application
Pour utiliser la méthode setRedirect() dans une application à champ d’application, utilisez la méthode de champ d’application correspondante : setRedirect().
GlideSystem : setReturn(URI d’objet)
Définit l’URI de retour pour cette transaction. Ceci détermine la page vers laquelle l’utilisateur sera dirigé lorsqu’il reviendra du formulaire suivant.
| Nom | Type | Description |
|---|---|---|
| URI | Objet | URI à définir comme emplacement de retour. |
| Type | Description |
|---|---|
| nul |
Cet exemple garantit que l’utilisateur sera renvoyé à la page actuelle lorsqu’il aura terminé avec la suivante.
gs.setReturn (current.getLink(true));
GlideSystem : tableExists(nom de table de chaîne)
Détermine si une table de base de données existe dans l’instance ServiceNow .
| Nom | Type | Description |
|---|---|---|
| tableName | Chaîne | Nom de la table à vérifier. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si la table spécifiée existe dans l’instance ServiceNow . Valeurs possibles :
|
Cet exemple montre comment vérifier si les tables incident et foo existent dans l’instance ServiceNow .
gs.info("Does the incident table exist? " + gs.tableExists("incident"));
gs.info("Does the foo table exist? " + gs.tableExists("foo"));
Sortie
Does the incident table exist? true
Does the foo table exist? false
Équivalent dans le champ d’application
Pour utiliser la méthode tableExists() dans une application incluse dans le champ d’application, utilisez la méthode correspondante : tableExists().
GlideSystem : userID()
Renvoie le sys_id de l’utilisateur associé à cette session. Utilisez plutôt getUserID().
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | Sys_id de l’utilisateur actuel. |
L’exemple suivant montre comment annuler l’affectation de tous les enregistrements d’incidents actifs affectés à l’utilisateur actuel.
var incidentGR = new GlideRecord('incident');
incidentGR.addActiveQuery();
// Filter results to incidents assigned to the current user
var currentUserSysId = gs.userID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();
while (incidentGR.next()) {
incidentGR.setValue('assigned_to', 'NULL');
incidentGR.update();
gs.info(
'Unassigned Incident: {0}: {1}',
incidentGR.number.toString(),
incidentGR.short_description.toString()
);
}
Sortie :
Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1
GlideSystem : workflowFlush(objet glideRecord)
Supprime tous les enregistrements de travaux planifiés ouverts dans la table Calendrier (sys_trigger) pour le GlideRecord spécifié.
| Nom | Type | Description |
|---|---|---|
| glideRecord | Objet | Le GlideRecord |
| Type | Description |
|---|---|
| nul |
GlideSystem : yearsAgo(Nombre d’années)
Obtient la date et l’heure d’un certain nombre d’années dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| années | Numéro | Nombre entier d’années |
| Type | Description |
|---|---|
| Chaîne | UTC au début de l’année, c’est-à-dire le nombre spécifié d’années, au format aaaa-mm-jj hh :mm :ss. |
Équivalent dans le champ d’application
Pour utiliser la méthode yearsAgo(Nombre d’années) dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : yearsAgo(Nombre d’années).
GlideSystem : hier()
Renvoie l’heure d’hier (il y a 24 heures) dans le fuseau horaire de la session de l’utilisateur sous forme d’horodatage UTC.
| Nom | Type | Description |
|---|---|---|
| Néant |
| Type | Description |
|---|---|
| Chaîne | UTC pour il y a 24 heures, au format aaaa-mm-jj hh :mm :ss |
Équivalent dans le champ d’application
Pour utiliser la méthode yesterday() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : yesterday().