GlideForm (Next Experience) : client

GlideForm(Next Experience) : addAdditionalParams(String parameterName, valeur de chaîne)

Ajoute une entrée masquée avec le nom et le paramètre de valeur donnés au formulaire.

Tableau 1. Paramètres
Nom	Type	Description
parameterName	Chaîne	Nom du paramètre à ajouter.
valide	Chaîne	Valeur du paramètre à ajouter.

Tableau 2. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : addChoice(String fieldName, String choiceValue, String choiceLabel)

Ajoute un choix à la fin d’un champ de liste de choix spécifié.

Tableau 3. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel ajouter l’option de champ de choix.
choiceValue	Chaîne	Valeur à stocker dans la base de données.
Étiquette de choix	Chaîne	Valeur à afficher.

Tableau 4. Renvoie
Type	Description
Aucun

g_form.addChoice('priority', '6', '6 - Really Low');

GlideForm (Next Experience) : addDecoration(Nom de champ de chaîne, icône de chaîne, titre de chaîne)

Ajoute une icône sur l’étiquette d’un champ.

L’ajout du même élément deux fois est évité ; Toutefois, vous pouvez ajouter la même icône avec un titre différent.

Remarque :

Cette méthode n’est pas prise en charge par Catalogue de services.

Tableau 5. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ.
icône	Chaîne	Nom de l’icône à afficher en regard du champ spécifié. Valeurs valides : icon-add icône : alerte icon-book Icône : Livre : Ouvrir icon-calendar cartes d’icônes Icône : panier : complet icône : catalogue Icône : cocher : cercle icon-cog Icône : commentaire icône console Icône : tableau de bord icon-database Icône : supprimer icône : tiroir Icône : modifier icon-filter icône : dossier icône : forme icon-help Icône : accueil icon-image icon-info icône étiquette icon-lightbulb liste d’icônes Icône : LiveFeed icon-locked icon-mail Icône : mobile Icône : nouveau ticket Icône : trombone icon-power icône : script icon-search icône : trier par ordre croissant Icône étoile Icône : étoile : vide icône : onglet icône : corbeille icon-tree icon-tree-right icon-user icon-user-group vue icône
Titre	Chaîne	Titre de l’icône.

Tableau 6. Renvoie
Type	Description
Aucun

g_form.addDecoration('caller_id', 'icon-star', 'preferred member');

GlideForm (Next Experience) : addDecoration(Nom de champ de chaîne, icône de chaîne, titre de chaîne, couleur de chaîne)

Ajoute une icône sur l’étiquette d’un champ.

L’ajout du même élément deux fois est évité ; Toutefois, vous pouvez ajouter la même icône avec un titre différent.

Remarque :

Cette méthode n’est pas prise en charge par Catalogue de services.

Tableau 7. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ.
icône	Chaîne	Nom de l’icône à afficher en regard du champ spécifié. Valeurs valides : icon-add icône : alerte icon-book Icône : Livre : Ouvrir icon-calendar cartes d’icônes Icône : panier : complet icône : catalogue Icône : cocher : cercle icon-cog Icône : commentaire icône console Icône : tableau de bord icon-database Icône : supprimer icône : tiroir Icône : modifier icon-filter icône : dossier icône : forme icon-help Icône : accueil icon-image icon-info icône étiquette icon-lightbulb liste d’icônes Icône : LiveFeed icon-locked icon-mail Icône : mobile Icône : nouveau ticket Icône : trombone icon-power icône : script icon-search icône : trier par ordre croissant Icône étoile Icône : étoile : vide icône : onglet icône : corbeille icon-tree icon-tree-right icon-user icon-user-group vue icône
Titre	Chaîne	Titre de l’icône.
couleur	Chaîne	Couleur CSS.

Tableau 8. Renvoie
Type	Description
Aucun

g_form.addDecoration('caller_id', 'icon-star', 'Mark as Favorite', 'color-green');

GlideForm (Next Experience) : addErrorMessage(Message de chaîne)

Affiche le message d’erreur spécifié en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 9. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 10. Renvoie
Type	Description
Aucun

g_form.addErrorMessage('This is an error');

GlideForm (Next Experience) : addFormMessage (message de chaîne, type de chaîne, options d’objet)

Affiche un message de formulaire flottant en haut de la section des détails du formulaire. Le message ne couvre pas les actions d’interface utilisateur.

Voir aussi :

Tableau 11. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher.
type	Chaîne	Type de message. Valeurs valides : erreur infos avertissement
options	Objet	Facultatif. Boutons à ajouter au message du formulaire et toutes les métadonnées nécessaires pour gérer un clic sur un bouton. `{ buttons: [Array], meta: {Object} }`
Options.Boutons	Tableau	Liste des boutons à ajouter au message du formulaire. `buttons: [ { actionName: "String", label: "String" } ]`
options.boutons.nom de l’action	Chaîne	Nom utilisé par les gestionnaires `d’événements FORM_MESSAGE_BUTTON_CLICKED` pour déterminer le bouton sur lequel l’utilisateur a cliqué. Par exemple, si vous ajoutez un bouton avec le actionName `assign_to_me`, vous devez créer un gestionnaire d’événements sur UIB l’événement `FORM_MESSAGE_BUTTON_CLICKED` qui ne s’exécute que lorsque le actionName est `assigned_to_me`.
Options.Boutons.Étiquette	Chaîne	Texte à afficher sur le bouton.
options.meta	Objet	Carte de toutes les métadonnées nécessaires pour gérer le clic sur le bouton, formatées sous forme de paires clé-valeur. `meta: { 'key': 'value' }` Par exemple, pour un bouton Me l’affecter , le gestionnaire d’événements a besoin du sys_id de l’utilisateur auquel affecter l’enregistrement.

Tableau 12. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment ajouter des messages de formulaire de chaque type.

g_form.addFormMessage('info message','info');
g_form.addFormMessage('warning message','warning');
g_form.addFormMessage('error message','error');
g_form.addFormMessage('info2 message','info');
g_form.addFormMessage('warning2 message','warning');
g_form.addFormMessage('error2 message','error');
g_form.addFormMessage('Would you like to reassign this to yourself?', 'info', {buttons: [{label: "Assign to me", actionName: "assign_to_me"}], meta: {'userId': '46d44a23a9fe19810012d100cca80666'}});

GlideForm (Next Experience) : addInfoMessage(message de chaîne)

Ajoute le message d’information spécifié en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 13. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 14. Renvoie
Type	Description
Aucun

g_form.addInfoMessage('The top five fields in this form are mandatory');

GlideForm (Next Experience) : addHighMessage (message de chaîne)

Affiche un message de priorité élevée en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 15. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher sur le formulaire.

Tableau 16. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher un message de priorité élevée en haut du formulaire.

g_form.addHighMessage(“This is a high priority message");

GlideForm (Next Experience) : addLowMessage(message de chaîne)

Affiche un message de priorité faible en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 17. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher sur le formulaire.

Tableau 18. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher un message de priorité faible en haut du formulaire.

g_form.addLowMessage(“This is a low priority message ");

GlideForm (Next Experience) : addModerateMessage (message de chaîne)

Affiche un message de priorité modérée en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 19. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher sur le formulaire.

Tableau 20. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher un message de priorité modérée en haut du formulaire.

g_form.addModerateMessage(“This is a moderate priority message");

GlideForm (Next Experience) – addOption(String fieldName, String choiceValue, String choiceLabel)

Ajoute un choix à la fin d’un champ de liste de choix spécifié.

Tableau 21. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel ajouter l’option de champ de choix.
choiceValue	Chaîne	Valeur à stocker dans la base de données.
Étiquette de choix	Chaîne	Valeur à afficher.

Tableau 22. Renvoie
Type	Description
Aucun

g_form.addOption('priority', '6', '6 - Really Low');

GlideForm (Next Experience) : addOption(String fieldName, String choiceValue, String choiceLabel, Number choiceIndex)

Ajoute un choix au champ de liste à la position spécifiée.

Remarque :

Les étiquettes de liste en double ne sont pas prises en charge dans Portail de services. Par exemple, les éléments dont le texte d’étiquette correspond à une autre étiquette sont ignorés et ne sont pas ajoutés à la liste.

Tableau 23. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel ajouter l’option de champ de choix.
choiceValue	Chaîne	Valeur à stocker dans la base de données.
Étiquette de choix	Chaîne	Valeur à afficher.
index de choix	Numéro	Ordre du choix dans la liste. L’index est un tableau de base zéro.

Tableau 24. Renvoie
Type	Description
Aucun

g_form.addOption('priority', '2.5', '2.5 - Moderately High', 3);

GlideForm (Next Experience) : addSuccessMessage(Message de chaîne)

Affiche un message confirmant une action réussie en haut du formulaire.

Ce message s’affiche pendant environ quatre secondes, puis disparaît. Ce délai n’est pas configurable pour l’instant.

Tableau 25. Paramètres
Nom	Type	Description
message	Chaîne	Message de réussite à afficher.

Tableau 26. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher un message de confirmation d’un message de réussite en haut du formulaire.

g_form.addSuccessMessage(“This is a success message");

GlideForm (Next Experience) : clearAllFormMessages()

Supprime tous les messages de formulaire de n’importe quel type.

Voir aussi :

Tableau 27. Paramètres
Nom	Type	Description
Aucun

Tableau 28. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment effacer tous les messages du formulaire.

g_form.clearAllFormMessages();

GlideForm (Next Experience) : clearChoices(String fieldName)

Supprime tous les choix d’un champ de liste de choix spécifié.

Tableau 29. Paramètres

Fieldname	Chaîne	Nom du champ pour lequel effacer la liste complète des choix.

Tableau 30. Renvoie
Type	Description
Aucun

g_form.clearChoices('priority');

GlideForm(Next Experience) : clearFormMessages(type de chaîne)

Supprime tous les messages de formulaire d’un type spécifié.

Voir aussi :

Tableau 31. Paramètres
Nom	Type	Description
type	Chaîne	Type de message. Valeurs valides : erreur infos avertissement

Tableau 32. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment effacer tous les messages d’erreur du formulaire.

g_form.clearFormMessages('error');

GlideForm (Next Experience) : clearMessages()

Supprime tous les messages d’information et d’erreur du haut du formulaire.

Supprime les messages d’information et d’erreur ajoutés avec g_form.addInfoMessage() et g_form.addErrorMessage().

Tableau 33. Paramètres
Nom	Type	Description
Aucun

Tableau 34. Renvoie
Type	Description
Aucun

g_form.clearMessages();

GlideForm (Next Experience) : clearOptions(String fieldName)

Supprime toutes les options de la liste de choix spécifiée.

Tableau 35. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ pour lequel effacer les options de choix.

Tableau 36. Renvoie
Type	Description
Aucun

g_form.clearOptions('priority');

GlideForm (Next Experience) : clearValue(String fieldName)

Supprime toutes les valeurs du champ spécifié.

Tableau 37. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à effacer.

Tableau 38. Renvoie
Type	Description
Aucun

GlideForm(Next Experience) : disableAttachments()

Empêche l’ajout de pièces jointes au formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 39. Paramètres
Nom	Type	Description
Aucun

Tableau 40. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : disableChoice(String fieldName, String choiceValue)

Désactive par programmation un choix spécifique dans le champ déroulant, si le choix existe. Aucun changement n’est apporté si le choix est déjà désactivé.

Tableau 41. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ à désactiver. Type de données : chaîne
choiceValue	Chaîne	Valeur du choix à désactiver. Type de données : chaîne

Tableau 42. Renvoie
Type	Description
Booléen	Marqueur indiquant si le choix donné est désactivé ou actif dans le formulaire. Valeurs valides : vrai : le choix est désactivé. faux : l’option est déjà désactivée ou est introuvable. Type de données : booléennes

L’exemple suivant appelle disableChoice() pour désactiver le choix loading_dock dans le champ de formulaire delivery_location.

if (g_form.getValue('address_type') == 'home') {
	g_form.disableChoice('delivery_location', 'loading_dock');
}

// Only itil_admin users can select the "Closed" option  

function onLoad() {
	if (g_user.hasRole('itil_admin')) return;

	if (g_form.getValue('incident_state') != '7')
		g_form.disableChoice('incident_state', 7);

	if (g_form.getValue('state') != '7') {
		g_form.disableChoice('state', 7);
	}

}

GlideForm (Next Experience) : enableAttachments()

Permet d’ajouter des pièces jointes au formulaire. Affiche l’icône du trombone.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 43. Paramètres
Nom	Type	Description
Aucun

Tableau 44. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : enableChoice(String fieldName, String choiceValue)

Active par programmation un choix spécifique dans le champ déroulant, si le choix existe. Aucun changement n’est apporté si l’option est déjà activée.

Tableau 45. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ du choix à activer.
choiceValue	Chaîne	Valeur du choix à activer.

Tableau 46. Renvoie
Type	Description
Booléen	Marqueur indiquant si le choix donné est activé avec succès. Valeurs valides : vrai : le choix est activé. faux : le choix est déjà activé ou introuvable. Type de données : booléennes

L’exemple suivant appelle enable() pour activer un nouveau choix déroulant, 1, dans le champ de formulaire de priorité .

var shortDescription = g_form.getValue('shortDescription');

// Allow priority 1 selection if short description mentions security 
if (shortDescription.includes('security')) {
	var p1Choice = g_form.getChoice('priority', '1');
	g_form.enableChoice('priority', '1');
}

GlideForm (Next Experience) : flash(Nom de champ de chaîne, couleur de chaîne, nombre de numéros)

Utilisez cette propriété pour attirer l’attention sur un champ. Fait clignoter la couleur spécifiée pendant une durée spécifiée dans le champ spécifié.

Cette méthode n’est pas prise en charge par Catalogue de services.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 47. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Champ à mettre en surbrillance au format suivant : `« <nom-table>.<nom-de-champ>` ».
couleur	Chaîne	Couleur RVB ou couleur CSS acceptable.
compter	Numéro	Durée pendant laquelle l’étiquette clignotera. Valeurs valides : 2 : Clignote pendant 1 seconde 0 : clignote pendant 2 secondes -2 : Clignote pendant 3 secondes -4 : Clignote pendant 4 secondes

Tableau 48. Renvoie
Type	Description
Aucun

g_form.flash("incident.number", "#FFFACD", 0);

GlideForm (Next Experience) : getActionName()

Renvoie le nom de l’action la plus récente ou, pour un script client, le sys_id de l’action d’interface utilisateur cliquée.

Remarque :

Non disponible dans les scripts clients de l’Assistant.

Tableau 49. Paramètres
Nom	Type	Description
Aucun

Tableau 50. Renvoie
Type	Description
Chaîne	Nom de l’action actuelle ou sys_id de l’action d’interface utilisateur cliquée.

function onSubmit() {
   var action = g_form.getActionName();
   alert('You pressed ' + action);
}

GlideForm(Next Experience) : getAnnotations()

Renvoie une liste de toutes les annotations sur un formulaire.

Les annotations sont des séparateurs visuels entre les éléments de formulaire, ou des blocs de texte coloré utilisés pour mettre en surbrillance des éléments de formulaire. Utilisez cette option GlideForm (Next Experience) : getAnnotationByName(nom de la chaîne) pour renvoyer une annotation spécifique par son nom.

Tableau 51. Paramètres
Nom	Type	Description
Aucun

Tableau 52. Renvoie
Propriété	Description
Tableau d'objets	Contenu de l’annotation. Type de données : tableau d’objets `[{content: "String", name: "String", visible: Boolean}]`
tableau.contenu	Texte de l’annotation renvoyée. Type de données : chaîne
array.name	Nom de l’annotation renvoyée. Type de données : chaîne Emplacement de la table : Annotations de formulaire [sys_ui_annotation], Champ : name
tableau.visible	Marqueur indiquant si l’annotation est visible sur le formulaire. Valeurs valides : true : l’annotation est visible. false : l’annotation n’est pas visible. Type de données : booléennes

L’exemple suivant appelle d’abord getAnnotations() pour renvoyer toutes les annotations d’un formulaire, puis appelle hideAnnotation() pour masquer toutes les annotations du formulaire.

const annotations = getAnnotations();

/* returns:  
[ 
    { 
        "name": "test-annotation-msg-1", 
        "visible": true, 
        "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    }, 
    { 
        "name": "test-annotation-msg-2", 
        "visible": true, 
        "content": "Test 2<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
    } 

]*/
annotations.forEach(function(annotation) {
	g_form.hideAnnotation(annotation.name);
});

// this script hides all annotations on the form.

GlideForm (Next Experience) : getAnnotationByName(nom de la chaîne)

Renvoie une annotation de formulaire d’un nom donné.

Les annotations sont des séparateurs visuels entre les éléments de formulaire, ou des blocs de texte coloré utilisés pour mettre en surbrillance des éléments de formulaire. Utilisez cette propriété GlideForm(Next Experience) : getAnnotations() pour renvoyer toutes les annotations dans un formulaire.

Tableau 53. Paramètres
Nom	Type	Description
nom	Chaîne	Nom de l’annotation à renvoyer. Table : Annotations de formulaire [sys_ui_annotation], Champ : Nom

Tableau 54. Renvoie
Propriété	Description
Tableau d'objets	Contenu de l’annotation. Type de données : tableau d’objets `[{content: "String", name: "String", visible: Boolean}]`
tableau.contenu	Texte de l’annotation renvoyée. Type de données : chaîne
array.name	Nom de l’annotation renvoyée. Type de données : chaîne Emplacement de la table : Annotations de formulaire [sys_ui_annotation], Champ : name
tableau.visible	Marqueur indiquant si l’annotation est visible sur le formulaire. Valeurs valides : true : l’annotation est visible. false : l’annotation n’est pas visible. Type de données : booléennes

L’exemple suivant montre comment utiliser la méthode getAnnotationByName() pour récupérer une annotation de formulaire en fonction de son nom donné, test-annotation-msg-1.

   var sampleAnnotation = g_form.getAnnotationByName("test-annotation-msg-1");

   /* returns:  
   { 
       "name": "test-annotation-msg-1", 
       "visible": true, 
       "content": "Test<input id=\"make_spacing_ok\" style=\"visibility:hidden; width:0px;\">" 
   }
   */

GlideForm (Next Experience) : getBooleanValue(String fieldName)

Renvoie une valeur booléenne pour le champ spécifié.

Tableau 55. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Champ à mettre en surbrillance au format suivant : `« <nom-table>.<nom-de-champ>` ».

Tableau 56. Renvoie
Type	Description
Booléen	Renvoie la valeur false si la valeur du champ est fausse ou indéfinie ; sinon, renvoie la valeur vrai.

GlideForm (Next Experience) : getChoice(String fieldName, String choiceValue)

Renvoie un objet avec des propriétés représentant un champ et une valeur de choix donnés.

Tableau 57. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ du choix à récupérer.
choiceValue	Chaîne	Valeur du choix à récupérer.

Tableau 58. Renvoie
Propriété	Description
Objet GlideFormChoice ou nul	Objet GlideFormChoice pour le champ et la valeur de choix spécifiés. Renvoie null si aucun choix correspondant n’existe. Type de données : objet `("label", "value", "disabled", "index")`
GlideFormChoice.label	Texte d’affichage en lecture seule au choix. Type de données : chaîne
GlideFormChoice.value	Valeur en lecture seule du choix. Type de données : chaîne
GlideFormChoice.disabled	Marqueur indiquant si le choix est désactivé dans le formulaire. Valeurs valides : vrai : le choix est désactivé faux : le choix est activé. Type de données : booléennes
GlideFormChoice.index	Indique la position du choix dans la liste déroulante. Type de données : nombre

L’exemple suivant montre comment appeler g_form.getChoice() pour renvoyer des informations sur les choix de champs de priorité .

var priority = g_form.getValue('priority'); 

var priorityLabel = g_form.getChoice('priority', priority).label;

GlideForm (Next Experience) : getControl(String fieldName)

Renvoie l’élément HTML pour le champ spécifié.

Les champs composés peuvent contenir plusieurs éléments HTML. Cette méthode n’est généralement pas nécessaire, car il existe des méthodes intégrées qui utilisent les champs d’un formulaire.

Si le champ est un champ de référence et que le contrôle est une liste de choix, getControl() peut ne pas renvoyer de contrôle comme prévu. Dans ce cas, utilisez sys_select.<table name>.<nom de champ>.

Cette méthode n’est pas disponible dans les scripts ou Portail de services scripts mobiles.

Tableau 59. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ pour lequel renvoyer l’élément HTML.

Tableau 60. Renvoie
Type	Description
HTMLElement	Élément HTML du champ.

GlideForm (Next Experience) : getDecimalValue(String fieldName)

Renvoie la valeur décimale du champ spécifié.

Tableau 61. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dont la valeur décimale doit être renvoyée.

Tableau 62. Renvoie
Type	Description
Chaîne	Valeur décimale du champ spécifié.

function onChange(control, oldValue, newValue, isLoading) {
   alert(g_form.getDecimalValue('percent_complete'));
}

GlideForm (Next Experience) : getDisplayValue(String fieldName)

Renvoie la valeur d’affichage d’un formulaire dans Portail de services.

Voir aussi :

Remarque :

Dans l’interface utilisateur principale, l’appel de cette méthode en tant que g_form.getDisplayValue() sans argument renvoie la valeur d’affichage de l’enregistrement plutôt que la valeur d’affichage d’un champ individuel.

Tableau 63. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à partir duquel vous souhaitez récupérer une valeur dans le formulaire.

Tableau 64. Renvoie
Type	Description
Chaîne	Valeur d’affichage du champ spécifié.

L’exemple suivant montre comment obtenir la valeur d’affichage d’une variable de référence dans l’interface utilisateur principale ou Portail de services. Le cas d’utilisation de cet exemple se trouve sur le site de la communauté .

function onChange(control, oldValue, newValue, isLoading) {
     if (isLoading || newValue == '') {
          return;
     }
     if(window == null){
          var valuePortal = g_form.getDisplayValue('requester');
          alert('Portal->' + valuePortal);
     }
     else{
          var valueNative = g_form.getDisplayBox('requester').value;     
          alert('CoreUI->' + valueCoreUI);
     }
     //Type appropriate comment here, and begin script below
}

GlideForm (Next Experience) : getElement(ID de chaîne)

Renvoie l’élément HTML spécifié par le paramètre.

Les champs composés peuvent contenir plusieurs éléments HTML. Cette méthode n’est généralement pas nécessaire, car il existe des méthodes intégrées qui utilisent les champs d’un formulaire.

Cette méthode n’est pas disponible dans les scripts ou Portail de services scripts mobiles.

Tableau 65. Paramètres
Nom	Type	Description
id	Chaîne	ID de champ.

Tableau 66. Renvoie
Type	Description
HTMLElement	Élément HTML du champ.

GlideForm(Next Experience) : getFormElement()

Renvoie l’élément HTML pour le formulaire.

Cette méthode n’est pas disponible dans les scripts ou Portail de services scripts mobiles.

Tableau 67. Paramètres
Nom	Type	Description
Aucun

Tableau 68. Renvoie
Type	Description
HTMLFormElement	Élément HTML pour le formulaire.

GlideForm (Next Experience) : getIntValue(String fieldName)

Renvoie la valeur entière du champ spécifié.

Tableau 69. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ.

Tableau 70. Renvoie
Type	Description
Numéro	Valeur entière du champ.

GlideForm (Next Experience) : getLabelOf(String fieldName)

Renvoie la valeur en texte brut de l’étiquette du champ.

Tableau 71. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ.

Tableau 72. Renvoie
Type	Description
Chaîne	Texte de l’étiquette.

if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

GlideForm (Next Experience) : getOptions(String fieldName)

Renvoie les options disponibles et sélectionnées pour un champ de choix ou de référence sur le formulaire. Cette méthode est utile pour les formulaires dynamiques, les variables de catalogue et les jeux de variables, ainsi que pour les intégrations qui doivent inspecter ou filtrer les options de champ au moment de l’exécution.

Par exemple, vous pouvez utiliser g_form.getOptions() pour :

Obtenez et définissez les paires nom-valeur dans un type de champ watch_list.
Recherchez ou filtrez les options disponibles par un terme de recherche.
Activez l’accès aux mêmes résultats de saisie semi-automatique via un rappel.
Obtenez et définissez des options sur les champs de choix, les champs de référence et les types de champs avancés tels que watch_list, glide_list, field_list et zone de liste double.

Tableau 73. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Le nom du champ de choix ou de référence à récupérer.

Tableau 74. Renvoie
Propriété	Description
Tableau d’objets ou nul	Tableau en lecture seule d’objets contenant la valeur et l’étiquette de chaque option sélectionnée. Renvoie null si le champ ne prend pas en charge les options. Type de données : tableau d’objets `[{value: "String", displayValue: "String"}]`
tableau.valeurdisplayValue	Valeur d’affichage du choix. Type de données : chaîne
tableau.valeur	Valeur de l’option. Type de données : chaîne
getAvailable(terme)	Fonction permettant de retourner toutes les options disponibles. Un terme de recherche peut être fourni comme argument pour filtrer les options par valeur d’affichage (une correspondance de sous-chaîne non sensible à la casse). Renvoie une promesse de tableau d’objets avec la valeur d’affichage et la valeur du choix correspondant. Type de données : tableau d’objets `[{value: "String", displayValue: "String"}]`

L’exemple suivant appelle g_form.getOptions() pour renvoyer tous les choix disponibles pour les champs de formulaire spécifiés, tels que état, work_notes_list et autres.

g_form.getOptions("state"); //table: incident, field: state, type: integer, choice: Dropdown without --None--
/*
returns [{"value":"1","displayValue":"New"},{"value":"2","displayValue":"In Progress"},{"value":"3","displayValue":"On Hold"},{"value":"6","displayValue":"Resolved"},{"value":"7","displayValue":"Closed"},{"value":"8","displayValue":"Canceled"}]
*/

g_form.getOptions("category"); //table: incident, field: category, type: string, choice: Dropdown with --None--
/*
returns [{"value":"","displayValue":"-- None --"},{"value":"inquiry","displayValue":"Inquiry / Help"},{"value":"software","displayValue":"Software"},{"value":"hardware","displayValue":"Hardware"},{"value":"network","displayValue":"Network"},{"value":"database","displayValue":"Database"}]
*/

g_form.getOptions("work_notes_list") //table: incident, field: work_notes_list, type: glide_list
/*
returns [{"value":"62826bf03710200044e0bfc8bcbe5df1","displayValue":"Abel Tuter"},{"value":"a8f98bb0eb32010045e1a5115206fe3a","displayValue":"Abraham Lincoln"},{"value":"5137153cc611227c000bbd1bd8cd2005","displayValue":"Fred Luddy"},{"value":"6a826bf03710200044e0bfc8bcbe5dec","displayValue":"Alissa Mountjoy"}]
*/

g_form.getOptions("restricted_fields") //table: std_change_properties, field: restricted_fields, type: field_list
/*
[{"value":"activity_due","displayValue":"Activity due"},{"value":"additional_assignee_list","displayValue":"Additional assignee list"},{"value":"comments","displayValue":"Additional comments"},{"value":"assignment_group","displayValue":"Assignment group"},{"value":"backout_plan","displayValue":"Backout plan"},{"value":"business_duration","displayValue":"Business duration"},{"value":"cab_delegate","displayValue":"CAB delegate"},...]
*/

g_form.getOptions('table') //table: sys_script_client, field: table, type: table_name
/*
[{"value":"","displayValue":"-- None --"},{"value":"cmdb_ci_appl_dot_net","displayValue":".NET Application [cmdb_ci_appl_dot_net]"},{"value":"evaluation","displayValue":"A/B Testing Evaluation [evaluation]"},{"value":"evaluation_execution","displayValue":"A/B Testing Evaluation Execution [evaluation_execution]"},{"value":"evaluation_parameter","displayValue":"A/B Testing Evaluation Parameter [evaluation_parameter]"},{"value":"sn_access_analyzer_request","displayValue":"Access Analyzer Query [sn_access_analyzer_request]"},{"value":"sn_access_analyzer_access_comparison_request","displayValue":"Access Comparison Request [sn_access_analyzer_access_comparison_request]"},{"value":"sys_security_acl","displayValue":"Access Control [sys_security_acl]"},...]
*/

g_form.getOptions('mandatory_fields'); //table: kb_knowledge_base, field: mandatory_fields, type: slushbucket
/*
[{"value":"active","displayValue":"Active"},{"value":"article_id","displayValue":"Article ID"},{"value":"displayValue","displayValue":"Article body"},{"value":"article_type","displayValue":"Article type"},{"value":"direct","displayValue":"Attachment link"},{"value":"author","displayValue":"Author"},{"value":"base_version","displayValue":"Base Version"},...]
*/

L’exemple de script suivant montre comment appeler g_form.getOptions() avec la fonction getAvailable().

const options = g_form.getOptions('priority');
if (options) {
  console.log('Selected:', options.selected);
  options.getAvailable('high').then(available => {
    console.log('Available matching "high":', available);
  });
}

GlideForm (Next Experience) : getReference(String fieldName, Function callBack)

Retourne le GlideRecord pour un champ spécifié.

Si une fonction de rappel est présente, cette routine s’exécute de manière asynchrone. Le traitement du navigateur (et du script) se poursuit normalement jusqu’à ce que le serveur renvoie la valeur de référence, auquel cas la fonction de rappel est invoquée. Si une fonction de rappel n’est pas présente, cette routine s’exécute de manière synchrone et le traitement s’arrête (provoquant le blocage du navigateur) pendant l’attente d’une réponse du serveur.

Important :

Il est fortement recommandé d’utiliser une fonction de rappel.

La prise en charge de la fonction de rappel pour ServiceCatalogForm.getReference est disponible.

Remarque :

L’utilisation de cette méthode nécessite un appel au serveur, ce qui nécessite plus de temps et peut introduire une latence sur votre page. Utilisez cette méthode avec prudence. Pour plus d’informations, voir Conception et traitement du script client.

Tableau 75. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Rappel	Fonction	Nom de la fonction de rappel.

Tableau 76. Renvoie
Type	Description
GlideRecord	Objet GlideRecord pour le champ spécifié. Si la référence spécifiée est introuvable, elle renvoie un objet GlideRecord initialisé où `currentRow = -1` et `rows.length = 0`.

function onChange(control, oldValue, newValue, isLoading) {
    g_form.getReference('caller_id', doAlert); // doAlert is our callback function
}
 
function doAlert(caller) { // reference is passed into callback as first arguments
   if (caller.getValue('vip') == 'true') {
      alert('Caller is a VIP!');
   }
}

GlideForm (Next Experience) : getRelatedListNames()

Renvoie un tableau de noms de listes connexes à partir du formulaire actuel.

Tableau 77. Paramètres
Nom	Type	Description
Aucun

Tableau 78. Renvoie
Type	Description
Tableau de chaînes	Liste des noms de listes connexes du formulaire actuel. Les noms des listes connexes sont répertoriés dans l’ordre dans lequel ils apparaissent sur le formulaire.

var listNames = g_form.getRelatedListNames();

for (var i = 0; i < listNames.length; i++) {  
  this.showRelatedList(listNames[i]);
 }

GlideForm (Next Experience) : getSectionNames()

Renvoie tous les noms de section, qu’ils soient visibles ou non.

Tableau 79. Paramètres
Nom	Type	Description
Aucun

Tableau 80. Renvoie
Type	Description
Tableau de chaînes	Noms des sections.

GlideForm (Next Experience) : getSections()

Renvoie un tableau des sections du formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 81. Paramètres
Nom	Type	Description
Aucun

Tableau 82. Renvoie
Type	Description
Tableau d’éléments HTML	Sections du formulaire.

function onChange(control, oldValue, newValue, isLoading) {
   //this example was run on a form divided into sections (Change form)
   // and hid a section when the "state" field was changed
   var sections = g_form.getSections();
   if (newValue == '2') {
      g_form.setSectionDisplay(sections[1], false);
   } else {
      g_form.setSectionDisplay(sections[1], true);
   }
}

GlideForm (Next Experience) : getTableName()

Renvoie le nom de la table à laquelle cet enregistrement appartient.

Côté serveur, la table de l’enregistrement actuel peut être récupérée avec current.sys_class_name ou current.getTableName().

Tableau 83. Paramètres
Nom	Type	Description
Aucun

Tableau 84. Renvoie
Type	Description
Chaîne	Nom de la table.

function onLoad() {
    if (g_form.isNewRecord()) {
        var tableName = g_form.getTableName(); //Get the table name
    }
}

GlideForm (Next Experience) : getUniqueValue()

Renvoie le sys_id de l’enregistrement affiché dans le formulaire.

Tableau 85. Paramètres
Nom	Type	Description
Aucun

Tableau 86. Renvoie
Type	Description
Chaîne	sys_id de l’enregistrement.

function onLoad() {
   var incSysid = g_form.getUniqueValue();
   alert(incSysid);
}

GlideForm (Next Experience) : getValue(String fieldName)

Renvoie la valeur du champ de formulaire spécifié.

Cette méthode prend également en charge l’obtention de valeurs à partir d’un jeu de variables à plusieurs lignes (MRVS). Pour obtenir des données à partir des champs d’un MRVS, vous devez d’abord utiliser JSON.parse(getValue('<mrvs_field_name>') || '[]') pour obtenir le tableau MRVS, puis utiliser l’indexation pour accéder aux champs dans les objets de ligne. Pour plus de détails, consultez l’exemple de code ci-dessous.

Tableau 87. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dont la valeur doit être renvoyée.

Tableau 88. Renvoie
Type	Description
Chaîne	Valeur du champ spécifié.

L’exemple suivant montre comment obtenir la description brève à partir du formulaire actuel.

function onChange(control, oldValue, newValue, isLoading) {
   alert(g_form.getValue('short_description'));
}

L’exemple suivant montre comment obtenir des valeurs à partir d’un MRVS. Dans cet exemple, les salaires sont gérés via le Service Catalog. Le script client recherche dans toutes les lignes du MRVS la valeur saisie dans le titre de la fonction , puis met à jour les entrées correspondantes dans le MRVS avec ce qui est saisi dans le champ Salaire . Le MRVS est nommé « variable_set_1 » et contient les champs suivants dans chaque objet de ligne : Nom de l’employé [employee_name], Fonction [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Fonction [job_title] et Salaire [salaire].

function onChange(control, oldValue, newValue, isLoading) {
if (isLoading || newValue == '') {
return;
}
 
// Get the MRVS
var vs1 = g_form.getValue('variable_set_1') || '[]';
var multiRowVariableSet = JSON.parse(vs1);
 
for (var i = 0; i < multiRowVariableSet.length; i++) {
// Check if the entered job title matches the title in the current MRVS row
  if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
    // Update the value of a matching field with the new salary
    multiRowVariableSet[i].employee_salary = newValue;
  }
}
 
// Update the MRVS
g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
}

GlideForm (Next Experience) : hideAllFieldMsgs()

Masque tous les messages de champ.

Tableau 89. Paramètres
Nom	Type	Description
Aucun

Tableau 90. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : hideAllFieldMsgs(type de chaîne)

Masque tous les messages de champ du type spécifié.

Tableau 91. Paramètres
Nom	Type	Description
type	Chaîne	>Type de message. Valeurs valides : erreur infos

Tableau 92. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : hideAnnotation(nom de chaîne)

Masque une annotation avec un nom donné sur l’interface utilisateur du formulaire.

Les annotations sont des séparateurs visuels entre les éléments de formulaire, ou des blocs de texte coloré utilisés pour mettre en surbrillance des éléments de formulaire. Voir aussi :

GlideForm(Next Experience) : showAnnotation(nom de chaîne) pour afficher une annotation spécifique sur le formulaire.
GlideForm(Next Experience) - toggleAnnotations() pour activer et désactiver les annotations avec une plus grande flexibilité.

Tableau 93. Paramètres
Nom	Type	Description
nom	Chaîne	Nom de l’annotation à masquer dans le formulaire. Table : Annotations de formulaire [sys_ui_annotation], Champ : Nom

Tableau 94. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment masquer par programmation l’annotation nommée test-annotation-msg-1 sur le champ de formulaire à l’aide de la méthode hideAnnotation( ).

g_form.hideAnnotation('test-annotation-msg-1');

GlideForm (Next Experience) : hideErrorBox(String fieldName)

Masque le message d’erreur placé par showErrorBox().

Dans la mesure du possible, utilisez hideFieldMsg() plutôt que cette méthode dans la mesure du possible.

Tableau 95. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ ou du contrôle dont le message d’erreur doit être masqué.

Tableau 96. Renvoie
Type	Description
Aucun

GlideForm(Next Experience) : hideFieldMsg(String fieldName, booléen clearAll)

Masque le premier message qui apparaît dans le champ spécifié sur le formulaire actuel.

Utilisez les méthodes showFieldMsg (champ de chaîne, message de chaîne, type de chaîne) ou showFieldMsg (champ de chaîne, message de chaîne, type de chaîne, forme de défilement booléen) pour afficher des messages sur un formulaire.

Par exemple, l’extrait de code suivant montre comment afficher deux messages dans le champ work_notes d’un formulaire, puis masquer le premier message :

g_form.showFieldMsg('work_notes', 'First message', "error");
g_form.showFieldMsg('work_notes', 'Second message', "error");
g_form.hideFieldMsg('work_notes', false); // This call hides the 'First message'

Tableau 97. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel masquer le message.
clearAll	Booléen	Facultatif. Marqueur indiquant s’il faut masquer tous les messages pour le champ spécifié. Valeurs valides : vrai : masquer tous les messages. faux : masque uniquement le premier message affiché. Valeur par défaut : false

Tableau 98. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment effacer tous les messages d’un champ de formulaire spécifié, puis afficher un message d’erreur de chiffrement.

function submitEncryptedInputs() {
  return processEncryptedInputs(function(inputName, fieldName) {
    if (!checkEncryptedFieldValue(fieldName)) {
      g_form.hideFieldMsg(fieldName, true); // Hide all messages for the specified field
      g_form.showFieldMsg(fieldName, "Your activity requires an encrypted input.", "error");
      return false;
    }
    return true;
  });
}

GlideForm (Next Experience) : hideRelatedList(String listTableName)

Masque la liste connexe spécifiée sur le formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 99. Paramètres
Nom	Type	Description
listTableName	Chaîne	Nom de la liste connexe. Utilisez la sys_id pour masquer une liste par le biais d’une relation.

Tableau 100. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : hideRelatedLists()

Masque toutes les listes connexes sur le formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 101. Paramètres
Nom	Type	Description
Aucun

Tableau 102. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : isMandatory(String fieldName)

Renvoie la valeur vrai si le champ est obligatoire.

Tableau 103. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 104. Renvoie
Type	Description
Booléen	Vrai si le champ est obligatoire, faux dans les autres cas.

GlideForm (Next Experience) : isNewRecord()

Renvoie la valeur vrai si l’enregistrement n’a jamais été sauvegardé.

Tableau 105. Paramètres
Nom	Type	Description
Aucun

Tableau 106. Renvoie
Type	Description
Booléen	Renvoie la valeur true si l’enregistrement n’a pas été sauvegardé ; sinon faux.

function onLoad() {
   if(g_form.isNewRecord()){
      alert('New Record!');
   }
}

GlideForm (Next Experience) : isVisible(String fieldName)

Détermine si le champ associé au nom de champ transmis est visible sur le formulaire actuel.

Tableau 107. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ permettant de vérifier s’il est visible sur le formulaire actuel.

Tableau 108. Renvoie
Type	Description
Booléen	Marqueur indiquant si le champ spécifié est visible sur le formulaire actuel. Valeurs possibles : vrai : le champ est visible sur le formulaire. faux : le champ n’est pas visible sur le formulaire.

L’exemple de code suivant montre comment vérifier si le champ user_address est visible sur le formulaire actuel.

if(g_form.isVisible('user_address')) {
    alert('is visible');
}
else {
    alert('is hidden');
}

GlideForm (Next Experience) : onUserChangeValue(fonction fn)

Enregistre un écouteur d’événement personnalisé qui détecte quand un champ du formulaire actuel est modifié par un utilisateur.

Lorsqu’un champ de formulaire est modifié, l’écouteur d’événements appelle la fonction transmise lors de l’enregistrement initial de l’écouteur. Cet écouteur n’est déclenché que lorsqu’un utilisateur apporte un changement à un champ du formulaire. Les changements apportés aux scripts clients, aux politiques d’interface utilisateur ou à toute autre interaction non-utilisateur ne déclenchent pas l’écouteur.

Remarque :

Cette méthode ne fonctionne pas pour les champs ou Catalogue de services éléments journaux dans l’environnement classique.

Tableau 109. Paramètres
Nom	Type	Description
Fn	Fonction	Fonction à appeler lorsqu’un utilisateur modifie la valeur d’un champ dans le formulaire actuel. Il s’agit en fait du code de fonction, pas seulement du nom de la fonction. Cette fonction doit accepter les trois arguments suivants : nom de champ Valeur d’origine du champ Valeur de champ mise à jour

Tableau 110. Renvoie
Type	Description
Fonction	Fonction à appeler pour annuler l’enregistrement de l’écouteur d’événement onUserChangeValue.

var handler = function(fieldname, originalValue, newValue) {
  console.log('The field ('+ fieldname + ') has a new value of: ' + newValue); // function code
}
 
var unregister = g_form.onUserChangeValue(handler);
 
// To unregister the event listener
unregister();

GlideForm (Next Experience) : removeChoice(String fieldName, String choiceValue)

Supprime le choix spécifié du champ de la liste de choix spécifiée.

Tableau 111. Paramètres

Fieldname	Chaîne	Nom du champ duquel supprimer un choix unique de la liste de choix.
choiceValue	Chaîne	Valeur du choix à supprimer de la liste de choix.

Tableau 112. Renvoie
Type	Description
Aucun

g_form.removeChoice('priority', '1');

GlideForm (Next Experience) - removeDecoration(nom de champ de chaîne, icône de chaîne, titre de chaîne)

Supprime l’icône du champ spécifié qui correspond à l’icône et au titre spécifiés.

Remarque :

Cette méthode n’est pas prise en charge par Catalogue de services.

Tableau 113. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ dans lequel supprimer la décoration.
icône	Chaîne	Nom de l’icône à supprimer.
Titre	Chaîne	Titre du texte de l’icône (nom).

Tableau 114. Renvoie
Type	Description
Aucun

function onChange(control, oldValue, newValue, isLoading) {
	// if the caller_id field is not present, then we can't add an icon anywhere
	if (!g_form.hasField('caller_id'))
		return;
 
	if (!newValue)
		return;
 
	g_form.getReference('caller_id', function(ref) {
		g_form.removeDecoration('caller_id', 'icon-star', 'VIP');
 
		if (ref.getValue('vip') == 'true')
			g_form.addDecoration('caller_id', 'icon-star', 'VIP');			
	});
}

GlideForm (Next Experience) : removeDecoration(nom de champ de chaîne, icône de chaîne, titre de chaîne, couleur de chaîne)

Supprime l’icône du champ spécifié qui correspond à l’icône, au titre et à la couleur spécifiés.

Remarque :

Cette méthode n’est pas prise en charge par Catalogue de services.

Tableau 115. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ dans lequel supprimer la décoration.
icône	Chaîne	Nom de l’icône à supprimer.
Titre	Chaîne	Titre du texte de l’icône (nom).
couleur	Chaîne	Couleur CSS assortie.

Tableau 116. Renvoie
Type	Description
Aucun

g_form.removeDecoration('caller_id', 'icon-star', 'VIP', 'blue');

GlideForm (Next Experience) : removeOption(String fieldName, String choiceValue)

Supprime l’option spécifiée de la liste de choix spécifiée.

Tableau 117. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel supprimer l’option de la liste de choix.
choiceValue	Chaîne	Valeur stockée dans la base de données. Ce n’est pas l’étiquette.

Tableau 118. Renvoie
Type	Description
Aucun

g_form.removeOption('priority', '1');

GlideForm (Next Experience) - save()

Enregistre l’enregistrement sans naviguer ailleurs (mettre à jour et rester).

Tableau 119. Paramètres
Nom	Type	Description
Aucun

Tableau 120. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : setChoiceLabel(String fieldName, String choiceValue, String newLabel)

Met à jour l’étiquette d’un choix spécifique dans le champ déroulant.

Lors de l’appel de cette méthode, la position d’index de l’option mise à jour dans la liste déroulante reste inchangée. L’état activé ou désactivé de l’option est conservé.

Tableau 121. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ qui contient le choix de mise à jour. Type de données : chaîne
choiceValue	Chaîne	Valeur de l’étiquette de choix à mettre à jour avec une nouvelle étiquette. Type de données : chaîne
newLabel	Chaîne	Nom d’étiquette pour mettre à jour l’étiquette de choix existante. Type de données : chaîne

Tableau 122. Renvoie
Type	Description
Booléen	Marqueur indiquant si l’étiquette de l’option a été mise à jour avec succès. Valeurs valides : vrai : l’étiquette de choix est mise à jour. faux : l’étiquette de choix n’est pas mise à jour, car le choix spécifié à mettre à jour peut avoir été en lecture seule ou n’existe pas, ou la nouvelle étiquette existe et est déjà associée à une autre option.

L’exemple suivant appelle setChoiceLabel() pour mettre à jour les choix de champ « bonus » (10, 20 et 30) vers de nouvelles valeurs.

// Show the calculated bonus next to the percentage label
var salary = parseInt(g_form.getValue('salary'), 10); 
g_form.setChoiceLabel('bonus', '10', '10% ($'+ (salary * .10) +')'); 
g_form.setChoiceLabel('bonus', '20', '20% ($'+ (salary * .20) +')'); 
g_form.setChoiceLabel('bonus', '30', '30% ($'+ (salary * .30) +')');

GlideForm (Next Experience) : setDisabled(String fieldName, booléen désactiver)

Rend le champ spécifié disponible ou indisponible.

Tableau 123. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à activer ou désactiver.
Désactiver	Booléen	Marqueur indiquant s’il faut désactiver ou non le champ spécifié. Valeurs valides : vrai : désactiver le champ. faux : active le champ. Valeur par défaut : false

Tableau 124. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) - setDisplay(String fieldName, affichage booléen)

Affiche ou masque un champ spécifié sur le formulaire.

Cette méthode ne peut pas masquer un champ obligatoire sans valeur. Si le champ est masqué, l’espace est utilisé pour afficher d’autres éléments. Dans la mesure du possible, utilisez une politique d’interface utilisateur au lieu de cette méthode.

Tableau 125. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
affichage	Booléen	Marqueur indiquant s’il faut afficher ou non le champ spécifié. Valeurs valides : true : afficher le champ. false : masquer le champ.

Tableau 126. Renvoie
Type	Description
Aucun

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   //If the page isn't loading
   if (!isLoading) {
      //If the new value isn't blank
      if (newValue != '') {
         g_form.setDisplay('priority', false);   
      }
      else 
         g_form.setDisplay('priority', true);
      }
   }

GlideForm (Next Experience) : setLabelOf(String fieldName, String label)

Définit la valeur en texte brut de l’étiquette du champ spécifié.

Remarque :

Cette méthode n’est pas prise en charge par Catalogue de services.

Tableau 127. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ pour lequel définir l’étiquette.
étiquette	Chaîne	Valeur en texte brut à définir dans l’étiquette.

Tableau 128. Renvoie
Type	Description
Aucun

if (g_user.hasRole('itil')) {
    var oldLabel = g_form.getLabelOf('comments');
    g_form.setLabelOf('comments', oldLabel + ' (Customer visible)');
}

GlideForm(Next Experience) – setMandatory(String fieldName, booléen obligatoire)

Rend le champ spécifié obligatoire.

Dans la mesure du possible, utilisez une politique d’interface utilisateur plutôt que cette méthode.

Tableau 129. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à rendre obligatoire.
obligatoire	Booléen	Marqueur indiquant si le champ est obligatoire. Valeurs valides : vrai : le champ est obligatoire. false : le champ est facultatif. Valeur par défaut : false

Tableau 130. Renvoie
Type	Description
Aucun

GlideForm(Next Experience) : setReadOnly(String fieldName, booléen readOnly)

Rend le champ spécifié en lecture seule ou modifiable.

Dans la mesure du possible, utilisez une politique d’interface utilisateur au lieu de cette méthode.

Pour rendre un champ obligatoire en lecture seule, vous devez d’abord supprimer l’exigence obligatoire pour ce champ à l’aide de la méthode setMandatory( ).

Une fois que vous avez défini un champ en lecture seule, vous ne pouvez pas utiliser la méthode setValue() pour mettre à jour la valeur de ce champ. Si vous devez définir la valeur de cette manière, vous devez définir la readOnly valeur sur faux.

Tableau 131. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ dont la valeur d’accès doit être définie.
readOnly	Booléen	Marqueur qui détermine si le champ associé est modifiable ou en lecture seule. Valeurs valides : vrai : définir le champ en lecture seule. faux : définir le champ comme modifiable.

Tableau 132. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment définir l’éditeur de variables sur lecture seule. Pour effectuer cette action dans Catalogue de services les tables, utilisez setVariablesReadOnly().

// Create a Client Script on a table (e.g., incident) and paste this script
// Uncheck (set to false) the "isolate script" checkbox (not available by default)
// To add the isolate script checkbox to the form, configure form layout to add the checkbox
function onLoad() { 
  $("variable_map").querySelectorAll("item").forEach(function(item){
    var variable = item.getAttribute("qname"); 
    g_form.setReadOnly("variables."+ variable, true); 
  }); 
}

GlideForm (Next Experience) - setSectionDisplay(String sectionName, affichage booléen)

Affiche ou masque une section spécifiée dans le formulaire.

Tableau 133. Paramètres
Nom	Type	Description
sectionName	Chaîne	Le nom de la section est en minuscules, un trait de soulignement remplaçant le premier espace du nom et les espaces restants étant supprimés. Par exemple, « La section quatre est ici » devient « section_fourishere ». Les autres caractères non alphanumériques, tels que les esperluettes (&), sont supprimés. Les noms de section peuvent être trouvés à l’aide de la méthode getSectionNames( ).
affichage	Booléen	Marqueur indiquant s’il faut afficher la section ou non. Valeurs valides : vrai : afficher la section. false : masquer la section.

Tableau 134. Renvoie
Type	Description
Booléen	Renvoie la valeur vrai en cas de réussite.

GlideForm (Next Experience) : setValue(String fieldName, valeur de chaîne)

Définit la valeur d’un champ de formulaire spécifié sur la valeur spécifiée.

Cette méthode prend également en charge la définition de valeurs dans un jeu de variables à plusieurs lignes (MRVS). Vous devez d’abord utiliser JSON.parse(getValue('<mrvs_field_name>')) pour obtenir le tableau MRVS, puis utiliser l’indexation pour mettre à jour les champs dans les objets de ligne. Une fois que toutes les valeurs sont mises à jour dans le MRVS, utilisez la méthode setValue() pour enregistrer le tableau MRVS mis à jour. Pour plus de détails, consultez l’exemple de code ci-dessous.

Remarque :

La méthode setValue() peut provoquer un débordement de pile lorsqu’elle est utilisée dans un script client OnChange. En effet, chaque fois que la valeur est définie, elle est enregistrée comme un changement, ce qui peut redéclencher le script client OnChange. Pour éviter cela, effectuez une vérification qui validera que la nouvelle valeur sera différente de l’ancienne valeur. Par exemple, avant d’effectuer setValue(shortDesc, newValue.toUpperCase()) ;, vérifiez que la description brève n’est pas déjà en majuscules. Cela empêchera le script client d’appliquer toUpperCase() plus d’une fois.

Tableau 135. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ de formulaire à mettre à jour.
valide	Chaîne	Valeur à définir dans le champ spécifié. Remarque : Lorsque vous définissez une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l’étiquette.

Tableau 136. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment définir la description brève dans le formulaire actuel.

g_form.setValue('short_description', 'replace this with appropriate text');

L’exemple suivant montre comment définir des valeurs dans un MRVS. Dans cet exemple, les salaires sont gérés via le Service Catalog. Le script client recherche dans toutes les lignes du MRVS la valeur saisie dans le titre de la fonction , puis met à jour les entrées correspondantes dans le MRVS avec ce qui est saisi dans le champ Salaire . Le MRVS est nommé « variable_set_1 » et contient les champs suivants dans chaque objet de ligne : Nom de l’employé [employee_name], Fonction [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Fonction [job_title] et Salaire [salaire].

function onChange(control, oldValue, newValue, isLoading) {
if (isLoading || newValue == '') {
return;
}

// Get the MRVS
var multiRowVariableSet = JSON.parse(g_form.getValue('variable_set_1'));

for (var i = 0; i < multiRowVariableSet.length; i++) {
// Check if the entered job title matches the title in the current MRVS row
  if (multiRowVariableSet[i].employee_job_title == g_form.getValue("job_title")){
    // Update the value of a matching field with the new salary
    multiRowVariableSet[i].employee_salary = newValue;
  }
}

// Update the MRVS
g_form.setValue('variable_set_1', JSON.stringify(multiRowVariableSet));
}

GlideForm (Next Experience) : setValue(String fieldName, String value, String displayValue)

Définit la valeur d’un champ de formulaire spécifié sur la valeur d’une valeur d’affichage spécifiée dans un enregistrement de référence.

Pour améliorer les performances en évitant un aller-retour lors de la définition de la valeur d’un champ de référence, utilisez cette méthode, et non setValue(fieldName, value). Lorsque vous définissez plusieurs valeurs de référence pour un champ de collecteur de liste, transmettez des tableaux dans les value paramètres and displayValue .

Remarque :

La méthode setValue() peut provoquer un débordement de la pile lorsqu’elle est utilisée dans un script client onchange . En effet, chaque fois que la valeur est définie, elle est enregistrée comme un changement, ce qui peut redéclencher le script client OnChange. Pour éviter cela, effectuez une vérification qui validera que la nouvelle valeur sera différente de l’ancienne valeur. Par exemple, avant d’effectuer setValue(shortDesc, newValue.toUpperCase()) ;, vérifiez que la description brève n’est pas déjà en majuscules. Cela empêchera le script client d’appliquer toUpperCase() plus d’une fois.

Tableau 137. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ de formulaire à mettre à jour.
valide	Chaîne ou tableau	Sys_id de l’enregistrement de référence à utiliser pour mettre à jour le champ. Si le champ spécifié est un GlideList, ce paramètre peut contenir un tableau de sys_ids. Dans ce cas, la méthode effectue une recherche de tous les enregistrements spécifiés dans le tableau et ces valeurs sont utilisées pour mettre à jour le contenu du champ spécifié (liste connexe). Remarque : Lorsque vous définissez une valeur dans une liste de choix, veillez à utiliser une valeur numérique plutôt qu’une étiquette.
displayValue	Chaîne ou tableau	Champ dans l’enregistrement de référence spécifié à utiliser pour mettre à jour le champ spécifié. Par exemple, dans la table Utilisateur [sys_user], il peut s’agir de userName. Si le champ spécifié est une GlideList, ce paramètre peut contenir un tableau de noms de valeurs d’affichage. Pour plus d’informations sur les valeurs d’affichage, voir Valeur d’affichage.

Tableau 138. Renvoie
Type	Description
Aucun

Cet exemple montre la transmission du sys_id de l’enregistrement de référence qui contient le champ userName à utiliser pour mettre à jour le champ de formulaire assigned_to .

g_form.setValue('assigned_to', userSysID, userName);

Cet exemple montre la transmission d’un tableau de sys_ids d’enregistrement de référence et d’un tableau de noms de valeurs d’affichage correspondants à utiliser pour mettre à jour les champs de formulaire dans le list_field_name GlideList Glide.

g_form.setValue('glide-list_field_name', sysIDArray, displayNameArray);

GlideForm (Next Experience) : setVariablesReadOnly(booléen isReadOnly)

Met un éditeur de Catalogue de services variables en lecture seule

Remarque :

Cette méthode ne s’applique qu’aux Catalogue de services éditeurs de variables dans l’interface utilisateur principale. Cette méthode n’est pas prise en charge dans le Catalogue de services formulaire.

La méthode doit être placée dans le script client de la table dans laquelle l’éditeur de variables est ajouté, tel que Requested Item [sc_req_item], Incident [incident], etc. Pour définir les variables en lecture seule dans d’autres tables, utilisez la méthode setReadOnly( ).

Voir aussi : Éditeurs de variables de Catalogue de services

Tableau 139. Paramètres
Nom	Type	Description
isReadOnly	Booléen	Marqueur qui détermine si l’éditeur de variables est en lecture seule. Valeurs valides : true : définit l’éditeur de variables en lecture seule. false : définit l’éditeur de variables comme modifiable. Valeur par défaut : false

Tableau 140. Renvoie
Type	Description
Aucun

L’ajout de la ligne suivante à un script client définit l’éditeur de variables en lecture seule.

g_form.setVariablesReadOnly(true);

GlideForm (Next Experience) - setVisible(String fieldName, affichage booléen)

Affiche ou masque le champ spécifié.

Sur l’interface utilisateur de bureau, l’espace est laissé vide lorsqu’il est masqué. Sur mobile ou Portail de services interface utilisateur, l’espace est rempli dans mes autres champs lorsqu’ils sont masqués. Cette méthode ne peut pas masquer les champs obligatoires sans valeur.

Dans la mesure du possible, utilisez la politique d’interface utilisateur plutôt que cette méthode.

Tableau 141. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à afficher ou masquer.
affichage	Booléen	Marqueur indiquant s’il faut afficher ou non le champ spécifié. Valeurs valides : true : afficher le champ. false : masquer le champ.

Tableau 142. Renvoie
Type	Description
Aucun

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   //If the page isn't loading
   if (!isLoading) {
      //If the new value isn't blank
      if(newValue != '') {
         g_form.setVisible('priority', false); 
      }
      else
         g_form.setVisible('priority', true); 
      }
   }

GlideForm(Next Experience) : showAnnotation(nom de chaîne)

Affiche une annotation avec un nom donné sur l’interface utilisateur du formulaire.

Les annotations sont des séparateurs visuels entre les éléments de formulaire, ou des blocs de texte coloré utilisés pour mettre en surbrillance des éléments de formulaire. Voir aussi :

GlideForm (Next Experience) : hideAnnotation(nom de chaîne) pour masquer une annotation spécifique sur le formulaire.
GlideForm(Next Experience) - toggleAnnotations() pour activer et désactiver les annotations avec une plus grande flexibilité.

Tableau 143. Paramètres
Nom	Type	Description
nom	Chaîne	Nom de l’annotation à afficher dans le formulaire. Table : Annotations de formulaire [sys_ui_annotation], Champ : Nom

Tableau 144. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher par programmation l’annotation nommée test-annotation-msg sur le champ de formulaire à l’aide de la méthode showAnnotation( ).

g_form.showAnnotation('test-annotation-msg');

GlideForm (Next Experience) : showErrorBox(nom de chaîne, message de chaîne)

Affiche un message d’erreur sous le champ de formulaire spécifié (objet de contrôle ou nom du champ). Si le contrôle ou le champ est actuellement hors de l’écran, le formulaire défile automatiquement vers le contrôle ou le champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible qui contrôle le défilement automatique des messages lorsque le champ de formulaire est hors écran (fait défiler le formulaire jusqu’au contrôle ou au champ). La méthode showFieldMsg() est une méthode similaire qui nécessite un paramètre type.

Tableau 145. Paramètres
Nom	Type	Description
nom	Chaîne	Nom du champ ou du contrôle sous lequel afficher le message d’erreur.
message	Chaîne	Message d’erreur à afficher.

Tableau 146. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : showErrorBox(Nom de chaîne, Message de chaîne, Booléen scrollForm)

Affiche un message d’erreur sous le champ de formulaire spécifié (objet de contrôle ou nom du champ). Si le contrôle ou le champ est actuellement hors de l’écran et que le scrollForm paramètre est vrai, le formulaire défile jusqu’au contrôle ou au champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible qui contrôle le défilement automatique des messages lorsque le champ de formulaire est hors écran (fait défiler le formulaire jusqu’au contrôle ou au champ). La méthode showFieldMsg() est une méthode similaire qui nécessite un paramètre type.

Tableau 147. Paramètres
Nom	Type	Description
nom	Chaîne	Nom du champ ou du contrôle sous lequel afficher le message d’erreur.
message	Chaîne	Message d’erreur à afficher.
formulaire de défilement	Booléen	Marqueur indiquant s’il faut faire défiler automatiquement le formulaire vers le champ de message d’erreur. Valeurs valides : true : faites défiler jusqu’au champ de message d’erreur. faux : ne faites pas défiler jusqu’au champ de message d’erreur. Par défaut : true

Tableau 148. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne)

Affiche un message sous le champ de formulaire spécifié (objet de contrôle ou nom du champ). Si le contrôle ou le champ n’apparaît pas à l’écran, la méthode fait automatiquement défiler le formulaire vers ce champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible qui contrôle le défilement automatique des messages lorsque le champ de formulaire est hors écran (fait défiler le formulaire jusqu’au contrôle ou au champ).

La méthode showErrorBox() est une méthode abrégée qui ne nécessite pas le paramètre type.

Remarque :

Cette méthode ne fonctionne pas avec le champ type journal_field dans Interface utilisateur principale.

Tableau 149. Paramètres
Nom	Type	Description
champ	Chaîne	Nom du champ ou du contrôle sous lequel afficher le message.
message	Chaîne	Message à afficher.
type	Chaîne	Type de message. Valeurs valides : erreur infos avertissement

Tableau 150. Renvoie
Type	Description
Aucun

g_form.showFieldMsg('impact','Low impact response time can be one week','info');

GlideForm (Next Experience) : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne, Booléen scrollForm)

Affiche un message sous le champ de formulaire spécifié (objet de contrôle ou nom du champ). Si le contrôle ou le champ est actuellement hors de l’écran et scrollFormqu’il est vrai, la méthode fait défiler le formulaire jusqu’à ce champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible qui contrôle le défilement automatique des messages lorsque le champ de formulaire est hors écran (fait défiler le formulaire jusqu’au contrôle ou au champ).

La méthode showErrorBox() est une méthode abrégée qui ne nécessite pas le paramètre type.

Remarque :

Cette méthode ne fonctionne pas avec le champ type journal_field dans Interface utilisateur principale.

Tableau 151. Paramètres
Nom	Type	Description
champ	Chaîne	Nom du champ ou du contrôle sous lequel afficher le message.
message	Chaîne	Message à afficher.
type	Chaîne	Type de message. Valeurs valides : erreur infos avertissement
formulaire de défilement	Booléen	Marqueur indiquant s’il faut faire défiler automatiquement le formulaire jusqu’au champ de message. Valeurs valides : vrai : faites défiler jusqu’au champ de message. faux : ne faites pas défiler jusqu’au champ de message. Par défaut : true

Tableau 152. Renvoie
Type	Description
Aucun

g_form.showFieldMsg('impact','Low impact not allowed with High priority','error',false);

GlideForm (Next Experience) : showRelatedList(String listTableName)

Affiche la liste connexe spécifiée sur le formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 153. Paramètres
Nom	Type	Description
listTableName	Chaîne	Nom de la liste connexe à afficher.

Tableau 154. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) : showRelatedLists()

Affiche toutes les listes connexes du formulaire.

Cette méthode n’est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plateforme mobile, aucune action ne se produit.

Tableau 155. Paramètres
Nom	Type	Description
Aucun

Tableau 156. Renvoie
Type	Description
Aucun

GlideForm(Next Experience) - submit()

Enregistre l’enregistrement.

L’utilisateur est retiré du formulaire et le renvoie à l’endroit où il se trouvait.

Tableau 157. Paramètres
Nom	Type	Description
Aucun

Tableau 158. Renvoie
Type	Description
Aucun

GlideForm (Next Experience) - submit(verbe de chaîne)

Effectue l’action d’interface utilisateur spécifiée.

Tableau 159. Paramètres
Nom	Type	Description
verbe	Chaîne	Une action_name d’un enregistrement sys_ui_action. Le nom de l’action doit être pour un bouton de formulaire visible.

Tableau 160. Renvoie
Type	Description
Aucun

GlideForm(Next Experience) - toggleAnnotations()

Masque ou affiche toutes les annotations sur le formulaire.

Les annotations sont des séparateurs visuels entre les éléments de formulaire, ou des blocs de texte coloré utilisés pour mettre en surbrillance des éléments de formulaire. Si des annotations sont visibles sur le formulaire, l’appel de toggleAnnotations() les masque. De même, si les annotations sont masquées sur le formulaire, l’appel de cette méthode les affiche. Voir aussi :

Tableau 161. Paramètres
Nom	Type	Description
Aucun

Tableau 162. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment appeler toggleAnnotations() pour afficher ou masquer des annotations de formulaire. Par conséquent, les annotations sont masquées ou affichées en fonction de leur état précédent.

g_form.toggleAnnotations();