GlideSystem : global
L’API GlideSystem , qui est désignée 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 connecté actuel et des informations de date/heure.
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 : 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 en cours d’affichage.
| 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 périmètre, utilisez la méthode incluse dans le périmètre 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 objet)
Ajoute un message d’informations pour la session en cours.
Utilisez getInfoMessages() pour récupérer la liste des messages d’informations affichés. Cette méthode n’est pas prise en charge pour les règles métier asynchrones et ne peut pas être utilisée dans les scripts de transformation.
| 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 périmètre, utilisez la méthode incluse dans le périmètre 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 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 (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Le GMT 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, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT au 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 NextWeek()
Renvoie la date et l’heure du début de la semaine prochaine (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début de 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 NextMois()
Renvoie la date et l’heure du début du mois prochain, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT 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 prochaine (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Le GMT du 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 (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début du mois en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de ce mois.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisMonth());Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisMonth().
GlideSystem : beginningOfThisQuarter()
Renvoie la date et l’heure du début du trimestre en cours, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début du trimestre en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début du trimestre en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisQuarter());Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisQuarter() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisQuarter().
GlideSystem - début de cette semaine()
Renvoie la date et l’heure du début de cette semaine (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début de la semaine en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de la semaine en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisWeek());Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisWeek().
GlideSystem : début de cette année()
Renvoie la date et l’heure du début de cette année, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début de l’année en cours. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple définit la valeur de l’enregistrement de date/heure Glide actuel au début de l’année en cours.
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.beginningOfThisYear());Équivalent dans le champ d’application
Pour utiliser la méthode beginningOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : beginningOfThisYear().
GlideSystem : beginningOfToday()
Récupère la date et l’heure du début de la journée (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début de la journée actuelle. 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 - début de demain()
Récupère le début de la journée de demain (UTC) ajusté au fuseau horaire de la session en cours.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT début de demain. Format : aaaa-mm-jj hh :mm :ss |
var today = new GlideDateTime(gs.beginningOfTomorrow()).getNumericValue();GlideSystem : beginningOfYesterday()
Récupère la date et l’heure du début de la journée d’hier (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Le début GMT d’hier, au format aaaa-mm-jj hh :mm :ss. |
var start = new GlideDateTime();
start.setValue(gs.beginningOfYesterday());GlideSystem : calDateDiff(String startDate, String endDate, Boolean numericValue)
Calculez la différence entre deux dates à l’aide du calendrier par défaut.
Les calendriers sont désormais hérités. Si des calendriers sont utilisés, reportez-vous à la section « Calculer selon un calendrier donné » de la rubrique Cas d’utilisation de scripts de planification.
| 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 d’heure 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 », elle 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 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 de retour sera au format 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, elle renvoie la différence entre les deux dates au format JJJ hh :mm :ss. |
// Given two date/times as DateTime objects
// Set the values this way to ensure a consistent input time
var date1 = new GlideDateTime();
var date2 = new GlideDateTime();
date1.setDisplayValueInternal('2014-01-01 12:00:00');
date2.setDisplayValueInternal('2014-01-01 13:00:00');
// Determine the difference as number of seconds (returns a string)
// Use getDisplayValue() to convert the string to the format expected by dateDiff()
var diffSeconds = gs.dateDiff(date1.getDisplayValue(), date2.getDisplayValue(), true);
// JavaScript will coerce diffSeconds from a string to a number
// since diffSeconds is being compared to a number
var msg = (diffSeconds <= 0) ? ' is on or after ' : ' is before ';
gs.print(date1.getDisplayValue() + msg + date2.getDisplayValue())GlideSystem : dateGenerate(date de chaîne, plage de chaînes)
Génère une date et une heure pour la date spécifiée en GMT.
| Nom | Type | Description |
|---|---|---|
| date | Chaîne | Date à générer en GMT. Format : aaaa-mm-jj |
| gamme | 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : dateGenerate().
GlideSystem : daysAgo(nombre de jours)
Renvoie la date et l’heure d’il y a un certain nombre de jours.
| Nom | Type | Description |
|---|---|---|
| Jours | Numéro | Nombre de jours |
| Type | Description |
|---|---|
| Chaîne | GMT du nombre spécifié de jours. Format : aaaa-mm-jj hh :mm :ss. |
function contractNoticeDue() {
var now_GR = new GlideRecord("contract");
now_GR.addQuery("u_contract_status", "Active");
now_GR.query();
while (now_GR.next()) {
if ((now_GR.u_termination_date <= gs.daysAgo(-90)) && (now_GR.u_contract_duration == "Long")) {
now_GR.u_contract_status = "In review";
}
else if ((now_GR.u_termination_date <= gs.daysAgo(-50)) && (now_GR.u_contract_duration == "Medium")) {
now-GR.u_contract_status = "In review";
}
else if ((now_GR.u_termination_date <= gs.daysAgo(-10)) && (now_GR.u_contract_duration == "Short")) {
now_GR.u_contract_status = "In review";
}
}
now_GR.update();
}Équivalent dans le champ d’application
Pour utiliser la méthode daysAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgo().
GlideSystem : daysAgoEnd(Nombre de jours)
Renvoie la date et l’heure de fin de la journée un nombre spécifié de jours plus tôt.
| Nom | Type | Description |
|---|---|---|
| Jours | Numéro | Nombre entier de jours |
| Type | Description |
|---|---|
| Chaîne | La fin de la journée GMT 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgoEnd().
GlideSystem : daysAgoLocal(Nombre de jours)
Renvoie la date et l’heure de début de la journée pour le nombre spécifié de jours passé. 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 de 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 la date et l’heure du début de la journée un nombre spécifié de jours plus tôt.
| Nom | Type | Description |
|---|---|---|
| Jours | Chaîne | Nombre entier de jours |
| 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();Équivalent dans le champ d’application
Pour utiliser la méthode daysAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : daysAgoStart().
GlideSystem : endOfLastMonth()
Renvoie la date et l’heure de la fin du mois dernier en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT de la fin du mois dernier. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment interroger un enregistrement de rapport 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 (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT 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, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT au format aaaa-mm-jj hh :mm :ss. |
Cet exemple montre comment interroger les enregistrements créés pour tous les enregistrements créés au cours de la dernière année.
var inc = new GlideRecord('incident');
inc.addEncodedQuery('sys_created_onONLast year@javascript:gs.beginningOfLastYear()@javascript:gs.endOfLastYear()');
inc.query();
while(inc.next()){
inc.assignment_group = "d625dccec0a8016700a222a0f7900d06";
inc.update();
}Équivalent dans le champ d’application
Pour utiliser la méthode endOfLastYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfLastYear().
GlideSystem : endOfNextMonth()
Renvoie la date et l’heure de la fin du mois prochain, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Données et heure GMT. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment interroger les enregistrements de connaissances de la base de connaissances créés depuis le début 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 NextSemaine()
Renvoie la date et l’heure de la fin de la semaine prochaine (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT pour la fin de la semaine prochaine. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfNextWeek() dans une requête pour obtenir tous les visiteurs de la semaine écoulée.
var title = 'Visitors arriving this Week';
var visitorQuery = 'active=true^category=visitor_request^u_my_start_dateONThis week@javascript:gs.beginningOfThisWeek()@javascript:gs.endOfNextWeek()';Équivalent dans le champ d’application
Pour utiliser la méthode endOfNextWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextWeek().
GlideSystem : fin de NextYear()
Renvoie la date et l’heure de la fin de l’année prochaine, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT pour la fin de l’année prochaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfNextYear() pour définir l’objet GlideDateTime à la fin de l’année prochaine.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfNextYear());
}Équivalent dans le champ d’application
Pour utiliser la méthode endOfNextYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfNextYear().
GlideSystem : fin de ce mois()
Renvoie la date et l’heure de la fin de ce mois, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT pour la fin de ce mois. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisMonth() pour définir l’objet GlideDateTime à la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisMonth());
}Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisMonth() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisMonth().
GlideSystem : endOfThisQuarter()
Renvoie la date et l’heure de la fin de ce trimestre, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT 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 à 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 (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT pour la fin de cette semaine. Format : aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisWeek() pour définir l’objet GlideDateTime à la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisWeek());
}Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisWeek() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisWeek().
GlideSystem : fin de cette année()
Renvoie la date et l’heure de la fin de cette année, en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure GMT pour la fin de cette année. Format aaaa-mm-jj hh :mm :ss |
Cet exemple montre comment utiliser endOfThisYear() pour définir l’objet GlideDateTime à la fin du mois en cours.
setEndDate : function(dt) {
var gdt2 = new GlideDateTime(dt);
gdt2.setValue(gs.endOfThisYear());
}Équivalent dans le champ d’application
Pour utiliser la méthode endOfThisYear() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : endOfThisYear().
GlideSystem : fin de Today()
Récupère la date et l’heure de fin de la journée (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT au format aaaa-mm-jj hh :mm :ss. |
var beginToday = gs.beginningOfToday();
var endToday = gs.endOfToday();
var beginTomorrow = gs.beginningOfTomorrow();
var endTomorrow = gs.endOfTomorrow();
var beginYesterday = gs.beginningOfYesterday();
var endYesterday = gs.endOfYesterday();
gs.info('beginningOfToday: ' + beginToday);
gs.info('endOfToday: ' + endToday);
gs.info('-----------');
gs.info('beginningOfTomorrow: ' + beginTomorrow);
gs.info('endOfTomorrow: ' + endTomorrow);
gs.info('beginningOfYesterday: ' + beginYesterday);
gs.info('endOfYesterday: ' + endYesterday);
gs.info('-----------');
var gdt1 = new GlideDateTime(beginToday);
var gdt2 = new GlideDateTime(beginTomorrow);
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info('BeginTomorrow: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(endToday);
var gdt2 = new GlideDateTime(endTomorrow);
var dur = GlideDateTime.subtract(gdt1, gdt2); //the difference between gdt1 and gdt2
gs.info('EndTomorrow: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(beginToday);
var gdt2 = new GlideDateTime(beginYesterday);
var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2
gs.info('BeginningYesterday: ' + dur.getDisplayValue());
var gdt1 = new GlideDateTime(endToday);
var gdt2 = new GlideDateTime(endYesterday);
var dur = GlideDateTime.subtract(gdt2, gdt1); //the difference between gdt1 and gdt2
gs.info('EndYesterday: ' + dur.getDisplayValue());GlideSystem - endOfTomorrow()
Récupère la date et l’heure de fin de la journée de demain (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT 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 (GMT).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT au format (aaaa-mm-jj huh :mm :ss). |
var yesterdayEnd = new GlideDateTime();
yesterdayEnd.setValue(gs.endOfYesterday());GlideSystem : eventQueue(nom de chaîne, objet glideRecord, chaîne parm1, chaîne parm2, file d’attente de chaî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é. |
| parm2 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifié. |
| 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : eventQueue().
GlideSystem : eventQueueScheduled(nom de chaîne, objet glideRecord, chaîne parm1, chaîne parm2, expiration de l’objet)
Met en file d’attente un événement pour le gestionnaire d’événements à une date et une heure spécifiées.
| 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é. |
| parm2 | Chaîne | (Facultatif) Enregistré avec l’instance si spécifié. |
| 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 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 |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| nul |
Cet exemple montre comment analyser et renvoyer les messages d’erreur, puis effacer les messages à l’aide de flushMessages().
MySessionUtil.getSessionError = function() {
var msg = null;
var msgs = gs.getErrorMessages().toArray();
if (msgs.length > 0) {
msg = msgs[0] + '';
gs.flushMessages();
}
return msg;
};
GlideSystem : getAvatar()
Renvoie le chemin d’accès du fichier à l’avatar de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| 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=smallGlideSystem : getCurrentScopeName()
Renvoie le nom du périmètre de l’application actuel.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Nom du périmètre actuel. |
Cet exemple montre comment utiliser getCurrentScopeName() pour obtenir la portée du processeur.
var incident_GR = new GlideRecord('Incident');
if (incident_GR.get("2e3f6baddb9ad600added8fdbf9618cb")) {
gs.debug("processor scope = "+ gs.getCurrentScopeName());
var w = new global.Workflow();
var context = w.startFlow('1f4a4baddb9ad600affed8fdbf9619bc', incident_GR, "update"); //id = id workflow
}Équivalent dans le champ d’application
Pour utiliser la méthode getCurrentScopeName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getCurrentScopeName().
GlideSystem : getDateFormat()
Renvoie le format de date associé à l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| 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-ddGlideSystem : getDateTimeFormat()
Renvoie le format de date et d’heure associé à l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| 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:ssGlideSystem : getDisplayColumn(String tableName)
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 la 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 |
|---|---|---|
| Aucun |
| 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 périmètre, utilisez la méthode incluse dans le périmètre 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é de 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 qui emprunte l’identité.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Nom d’affichage de l’utilisateur qui emprunte l’identité. |
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 qui emprunte l’identité ou un nom nul s’il n’emprunte pas l’identité.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Nom de l’utilisateur empruntant l’identité |
Cet exemple montre comment obtenir le nom d’utilisateur de l’emprunteur d’identité.
var name = gs.getImpersonatingUserName();
var actual_user = null;
if (name == null || name == '')
actual_user = user;
else
actual_user = Packages.com.glide.sys.User.getUser(name);
var recent_impersonations = actual_user.getPreference('recent.impersonations');
var admin_role=actual_user.hasRole("admin");GlideSystem : getInfoMessages()
Récupère la liste des messages d’information de la session qui ont été ajoutés par addInfoMessage().
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Liste des messages d’information. |
Cet exemple montre comment obtenir les messages d’information.
var messages = gs.getInfoMessages();
if (messages.toString().indexOf('Conflicts Detected') == -1)
gs.addInfoMessage(msg);GlideSystem : getInitials()
Renvoie les initiales de l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Les initiales de l’utilisateur. |
var userInitials = gs.getUser().getInitials();
gs.addInfoMessage('User initials: ' + userInitials);Sortie :
User initials: SAGlideSystem : 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 Message, consultez Table Message.
| 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 des chaînes ou 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ánCet 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 périmètre, utilisez la méthode correspondante dans le champ d’application : getMessage().
GlideSystem : getMessageS(String messageID, Object args)
Récupère les messages traduits à afficher dans l’interface utilisateur et échappe tous les ticks (').
Si l’identificateur de message spécifié (clé) existe dans la table Message [sys_ui_message] pour la langue actuelle, la méthode renvoie le message traduit. Si l’identificateur de message spécifié n’existe pas pour la langue actuelle, la méthode renvoie la version anglaise du message. Si l’identificateur 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.
Utile si vous insérez 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 des chaînes ou 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 graduations échappé. |
/*
"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 FranceGlideSystem : 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 des chaînes ou 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ónicoL’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 SmithGlideSystem : 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é de 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é de la propriété dont la valeur doit être renvoyée. |
| Alt | Objet | Facultatif. Autre objet à renvoyer si la propriété est introuvable. |
| 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 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 GlideDate.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Objet GlideSession | Objet GlideSession pour la session en cours |
if(!gs.hasRole("admin") && gs.getSession().isInteractive() && gs.getUserName() != "guest"){
var qc = current.addQuery('u_visibility', "both");
qc.addOrCondition('u_visibility', '');
if (gs.getImpersonatingUserName() != null) {
gs.getSession().clearClientData('navQuery');
}
var navQuery = gs.getSession().getClientData('navQuery');
if (navQuery == null) {
var isManager = gs.getUser().getRecord().getValue('u_is_manager');
if (!isManager) {
qc.addOrCondition('u_visibility', 'nonmanager');
gs.getSession().putClientData('navQuery', 'nonmanager');
} else {
qc.addOrCondition('u_visibility', 'manager');
gs.getSession().putClientData('navQuery', 'manager');
}
} else {
qc.addOrCondition('u_visibility', navQuery);
}
}Équivalent dans le champ d’application
Pour utiliser la méthode getSession() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getSession().
GlideSystem : getSessionID()
Retourne l’ID de session GlideSession.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | ID de session |
var gr_NOW = new GlideRecord('v_user_session');
var sessionId = gs.getSessionID();
gs.log("Session ID is: " + sessionId);Sortie
Session ID is: FEE589B3DB7EE4103DD9C39D139619D7Équivalent dans le champ d’application
Pour utiliser la méthode getSessionID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getSessionID.
GlideSystem : getStyle(String tableName, String fieldName, String fieldValue)
Renvoie le style défini pour la table, le champ et la valeur du 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 |
|---|---|---|
| Aucun |
| 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:ssGlideSystem : getUser()
Renvoie une référence à l’objet utilisateur pour l’utilisateur actuel.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| 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 périmètre, 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 |
|---|---|---|
| Aucun |
| 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 |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Sys_id de l’utilisateur actuel. |
Cet exemple obtient 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 |
|---|---|---|
| Aucun |
| 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 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : 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(String xml)
Construit un tableau de tous les nœuds et valeurs dans un document XML.
| Nom | Type | Description |
|---|---|---|
| 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 de 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(String xml, String xpathQuery)
Renvoie le texte XML du premier élément de la chaîne XML qui correspond à la requête XPath.
| Nom | Type | Description |
|---|---|---|
| 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 dispose d’au moins un des rôles transmis.
| Nom | Type | Description |
|---|---|---|
| roleName | Chaîne | Liste des rôles séparés par des virgules. |
| Type | Description |
|---|---|
| Booléen | Marqueur indiquant si l’utilisateur actuel dispose d’au moins l’un des rôles spécifiés. Valeurs possibles :
|
L’exemple suivant montre comment vérifier si l’utilisateur actuel dispose du rôle administrateur ou groups_admin.
if (!gs.hasRole("admin, groups_admin") && gs.getSession().isInteractive()) {
var qc = current.addQuery("u_hidden", "!=", "true"); //cannot see hidden groups...
qc.addOrCondition("sys_id", "javascript:getMyGroups()"); //...unless in the hidden group
}Équivalent dans le champ d’application
Pour utiliser la méthode hasRole() dans une application incluse dans le périmètre, utilisez la méthode correspondante : hasRole().
GlideSystem : hasRoleInGroup(Objet roleName, groupe d’objets)
Détermine si l’utilisateur actuel dispose du 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 la date et l’heure correspondant au 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 pour le nombre d’heures spécifié. Format : aaaa-mm-jj hh :mm :ss |
var currentDateTime = gs.hoursAgo(0);
gs.info("Current date/time: " + currentDateTime);
var agoDateTime = gs.hoursAgo(1);
gs.info("Ago date/time: " + agoDateTime);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ées passées. 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 pour la fin du nombre d’heures spécifié. 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 périmètre, utilisez la méthode incluse dans le périmètre 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 pour la fin du nombre d’heures spécifié. 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : hoursAgoStart().
GlideSystem : isFirstDayOfMonth(date de l’objet)
Vérifie si la date de 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 de date spécifié est le premier jour du mois. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date de l’objet de date spécifié est le premier jour du mois.
var gdt = new GlideDateTime();
gdt.setValue('2021-04-01 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);
gdt.setValue('2021-04-21 12:00:00');
var currentDay = gs.isFirstDayOfMonth(gdt);
gs.print("First day of month: " + currentDay);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 de 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 de 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 de 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 celui où un utilisateur se connecte à l’aide de l’écran de connexion. Un exemple d’une session non interactive est l’utilisation d’une demande SOAP pour récupérer des données.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : isInteractive().
GlideSystem : isLastDayofMonth(Date de l’objet)
Vérifie si la date de 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 de l’objet de date spécifié est le dernier jour du mois. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date de l’objet de date spécifié est le dernier jour du mois.
var gdt = new GlideDate();
gdt.setValue('2020-12-31 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);
gdt.setValue('2021-01-01 12:00:00');
var currentDay = gs.isLastDayOfMonth(gdt);
gs.print("First day of year: " + currentDay);Last day of month: true
Last day of month: falseGlideSystem : isLastDayOfWeek(date de l’objet)
Vérifie si la date de 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 de l’objet de date spécifié est le dernier jour de la semaine.
var gdt = new GlideDate();
gdt.setValue('2021-03-01 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);
gdt.setValue('2021-03-21 12:00:00');
var currentDay = gs.isLastDayOfWeek(gdt);
gs.info("Last day of week: " + currentDay);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 de l’objet de date actuel est le dernier jour de l’année. Valeurs possibles :
|
Cet exemple montre comment déterminer si la date de 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 |
|---|---|---|
| Aucun |
| 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : isLoggedIn().
GlideSystem : isMobile()
Détermine si la demande provient d’un 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 |
|---|---|---|
| Aucun |
| 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : isMobile().
GlideSystem : lastWeek()
Renvoie la date et l’heure il y a une semaine en GMT.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure il y a une semaine. Format : aaaa-MM-jj hh :mm :ss |
Cet exemple montre comment obtenir la date qui est une semaine après 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 : journal (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 à consigner. |
| 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 à consigner. |
| 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 passées.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre de minutes dans le passé à 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 de minutes)
Renvoie la date et l’heure de fin de la minute il y a un certain nombre de minutes.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre entier de minutes passé, tel que 5 ou 11. |
| 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.print("Now: " + nowDateTime);
var thirtyMinutesAgoDateTime = gs.minutesAgoEnd(30);
gs.print("Thirty minutes ago end time: " + thirtyMinutesAgoDateTime);Sortie
Now: 2021-10-20 15:22:13
Thirty minutes ago end time: 2021-10-20 14:52:59Équivalent dans le champ d’application
Pour utiliser la méthode minutesAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : minutesAgoEnd().
GlideSystem : minutesAgoStart(Nombre de minutes)
Renvoie la date et l’heure du début de la minute il y a un certain nombre de minutes.
| Nom | Type | Description |
|---|---|---|
| minutes | Numéro | Nombre entier de minutes passé, tel que 15 ou 112. |
| 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Équivalent dans le champ d’application
Pour utiliser la méthode minutesAgoStart() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : minutesAgoStart().
GlideSystem : monthsAgo(nombre de mois)
Renvoie une date et une heure correspondant à un certain nombre de mois passé.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre entier de mois plus tôt. |
| 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Équivalent dans le champ d’application
Pour utiliser la méthode monthsAgo() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : monthsAgo().
GlideSystem : monthsAgoEnd(Nombre de mois)
Renvoie la date et l’heure du dernier jour du mois un nombre spécifié de mois plus tôt.
| Nom | Type | Description |
|---|---|---|
| Mois | Nombre (entier) | Nombre de mois, par exemple 4 ou 16. |
| 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:59GlideSystem : monthsAgoStart(Nombre de mois)
Renvoie la date et l’heure du début du mois il y a un certain nombre de mois.
| Nom | Type | Description |
|---|---|---|
| Mois | Numéro | Nombre entier de mois passé, tel que 5 ou 14. |
| 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É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 true si l’objet est nul ou contient une chaîne vide.
| Nom | Type | Description |
|---|---|---|
| obj. | Objet | Objet à vérifier. |
| Type | Description |
|---|---|
| Booléen | Vrai si chaîne nulle ou vide ; sinon, faux. |
if ((!current.u_date1.nil()) && (!current.u_date2.nil())) {
var start = current.u_date1.getGlideObject().getNumericValue();
var end = current.u_date2.getGlideObject().getNumericValue();
if (start > end) {
gs.addInfoMessage('start must be before end');
current.u_date1.setError('start must be before end');
current.setAbortAction(true);
}
}Équivalent dans le champ d’application
Pour utiliser la méthode nil() dans une application incluse dans le périmètre, utilisez la méthode correspondante : nil().
GlideSystem : now()
Renvoie la date actuelle en UTC.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | La date actuelle au format défini par l’utilisateur, en 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 |
|---|---|---|
| Aucun |
| 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 |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Date et heure actuelles au format défini par l’utilisateur. Pour plus d’informations sur la définition du format de date et d’heure du système, consultez 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 à la date et à l’heure actuelles, utilisez la méthode setDisplayValue( ). Le script suivant définit la variable de workflow end_date à la date et à l’heure actuelles.
current.variables.end_date.setDisplayValue(gs.nowDateTime());GlideSystem : nowGlideDateTime()
Obtient un objet GlideDateTime avec la date et l’heure actuelles.
Une fois que vous avez obtenu un objet GlideDateTime avec la date et l’heure actuelles, vous pouvez utiliser les méthodes GlideDateTime pour effectuer des opérations de date heure, telles que des calculs de date et d’heure, la mise en forme d’une date et heure ou la conversion entre les formats de date et d’heure.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Objet | Objet GlideDateTime avec la date et l’heure actuelles au format GMT. |
Définit le u_target_date de champ sur la date et l’heure actuelles au format GMT.
current.u_target_date = gs.nowGlideDateTime();GlideSystem : print (message de chaîne)
Écrit un message dans le journal système.
Cette méthode n’écrit pas le message dans la table syslog à moins que le débogage n’ait été activé.
| Nom | Type | Description |
|---|---|---|
| message | Chaîne | Message à journaliser |
| 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é.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier des trimestres passés. |
| Type | Description |
|---|---|
| Chaîne | GMT du trimestre qui était le nombre de trimestres spécifié il y a peu. 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 quatre trimestres à la même heure.
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:32GlideSystem : quartersAgoEnd(Nombre, trimestres)
Renvoie la date et l’heure du dernier jour du trimestre, pour un nombre de trimestres passé.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier de trimestres |
| 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 |
Équivalent dans le champ d’application
Pour utiliser la méthode quartersAgoEnd() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : quartersAgoEnd().
GlideSystem : quartersAgoStart(Nombre, trimestres)
Renvoie la date et l’heure du premier jour du trimestre, pour un nombre de trimestres passé.
| Nom | Type | Description |
|---|---|---|
| trimestres | Numéro | Nombre entier de trimestres |
| 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 |
Équivalent dans le champ d’application
Pour utiliser la méthode quartersAgoStart() dans une application incluse dans le périmètre, utilisez la méthode correspondante : 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 : bar
Équivalent dans le champ d’application
Pour utiliser la méthode setProperty() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : setProperty().
GlideSystem : setRedirect(URI 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 en tant que paramètre.
gs.setRedirect("com.glideapp.servicecatalog_cat_item_view.do?sysparm_id=d41ce5bac611227a0167f4bf8109bf70&sysparm_user="
+ current.sys_id + "&sysparm_email=" + current.email)Équivalent dans le champ d’application
Pour utiliser la méthode setRedirect() dans une application à portée, utilisez la méthode correspondante : setRedirect().
GlideSystem : setReturn(URI de l’objet)
Définit l’URI de retour pour cette transaction. Cela 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 reviendra à la page actuelle lorsqu’il aura terminé la suivante.
gs.setReturn (current.getLink(true));GlideSystem : tableExists(String tableName)
Détermine s’il existe une table de base de données 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 périmètre, utilisez la méthode incluse dans le périmètre correspondante : tableExists().
GlideSystem : userID()
Renvoie le sys_id de l’utilisateur associé à cette session. Utilisez getUserID() à la place.
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | Sys_id de l’utilisateur actuel. |
L’exemple suivant montre comment annuler l’affectation de tous les enregistrements d’incident actifs affectés à l’utilisateur actuel.
var incidentGR = new GlideRecord('incident');
incidentGR.addActiveQuery();
// Filter results to incidents assigned to the current user
var currentUserSysId = gs.userID();
incidentGR.addQuery('assigned_to', currentUserSysId);
incidentGR.query();
while (incidentGR.next()) {
incidentGR.setValue('assigned_to', 'NULL');
incidentGR.update();
gs.info(
'Unassigned Incident: {0}: {1}',
incidentGR.number.toString(),
incidentGR.short_description.toString()
);
}Sortie :
Unassigned Incident: INC0000057: Performance problems with wifi
Unassigned Incident: INC0009001: Unable to post content on a Wiki page
Unassigned Incident: INC0008111: ATF : Test1GlideSystem : 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 une date et une heure pour un certain nombre d’années passées.
| Nom | Type | Description |
|---|---|---|
| années | Numéro | Nombre entier d’années |
| 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. |
É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).
| Nom | Type | Description |
|---|---|---|
| Aucun |
| Type | Description |
|---|---|
| Chaîne | GMT pour il y a 24 heures, au format aaaa-mm-jj hh :mm :ss |
Équivalent dans le champ d’application
Pour utiliser la méthode yesterday() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : yesterday().