GlideForm (g_form) : client

GlideForm : 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 1. 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 2. Renvoie
Type	Description
nul

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

GlideForm : 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 3. 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 4. Renvoie
Type	Description
nul

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

GlideForm : 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 5. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 6. Renvoie
Type	Description
nul

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

GlideForm : 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 7. 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 8. 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 : 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 9. Paramètres
Nom	Type	Description
message	Chaîne	Message de priorité élevée à afficher sur le formulaire.

Tableau 10. 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 : 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 11. Paramètres
Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 12. Renvoie
Type	Description
nul

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

GlideForm : 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 13. Paramètres
Nom	Type	Description
message	Chaîne	Message de priorité faible à afficher sur le formulaire.

Tableau 14. 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 : addModerateMessage(message de chaîne)

Affiche un message de priorité de niveau modéré 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 de priorité modérée à afficher sur le formulaire.

Tableau 16. 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 : addOption(String fieldName, String choiceValue, String choiceLabel)

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

Tableau 17. 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 18. Renvoie
Type	Description
nul

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

GlideForm : 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 19. 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 20. Renvoie
Type	Description
nul

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

GlideForm : addSuccessMessage(Message de chaîne)

Affiche un message de réussite 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 21. Paramètres
Nom	Type	Description
message	Chaîne	Message de réussite à afficher sur le formulaire.

Tableau 22. 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 : clearAllFormMessages()

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

Voir aussi :

Tableau 23. Paramètres
Nom	Type	Description
Aucun

Tableau 24. Renvoie
Type	Description
Aucun

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

g_form.clearAllFormMessages();

GlideForm : clearFormMessages(type de chaîne)

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

Voir aussi :

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

Tableau 26. Renvoie
Type	Description
Aucun

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

g_form.clearFormMessages('error');

GlideForm : 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 27. Paramètres
Nom	Type	Description
Aucun

Tableau 28. Renvoie
Type	Description
nul

g_form.clearMessages();

GlideForm : clearOptions(String fieldName)

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

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

Tableau 30. Renvoie
Type	Description
nul

GlideForm : clearValue(String fieldName)

Supprime toutes les valeurs du champ spécifié.

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

Tableau 32. Renvoie
Type	Description
nul

GlideForm : 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 33. Paramètres
Nom	Type	Description
Aucun

Tableau 34. Renvoie
Type	Description
nul

GlideForm : 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 35. 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 36. 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 : 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 37. Paramètres
Nom	Type	Description
Aucun

Tableau 38. Renvoie
Type	Description
nul

GlideForm : 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 39. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de champ du choix à activer.
choiceValue	Chaîne	Valeur du choix à activer.

Tableau 40. 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 : flash(String fieldName, String color, Number count)

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 41. 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 42. Renvoie
Type	Description
nul

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

GlideForm : 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 43. Paramètres
Nom	Type	Description
Aucun

Tableau 44. 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 : getAnnotationByName(nom de 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 : getAnnotationByName(nom de chaîne) pour renvoyer toutes les annotations dans un formulaire.

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

Tableau 46. 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 : 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 : getAnnotationByName(nom de chaîne) pour renvoyer une annotation spécifique par son nom.

Tableau 47. Paramètres
Nom	Type	Description
Aucun

Tableau 48. 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 : getBooleanValue(String fieldName)

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

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

Tableau 50. 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 : 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 51. 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 52. 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 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 : 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 53. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ pour lequel renvoyer l’élément HTML.

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

GlideForm : getDecimalValue(String fieldName)

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

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

Tableau 56. 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 : getDisplayBox(String fieldName)

Renvoie la valeur d’affichage à partir d’un formulaire dans l’interface utilisateur principale.

Remarque :

Pour obtenir une valeur d’affichage à partir d’un formulaire dans Portail de services, utilisez la méthode getDisplayValue( ).

Voir aussi :

Tableau 57. Paramètres
Nom	Type	Description
Fieldname	Chaîne

Tableau 58. Renvoie
Type	Description
Aucun	Nom du champ à partir duquel récupérer la valeur dans le formulaire.

var caller = g_form.getDisplayBox('caller_id').value;

var assignee = g_form.getDisplayBox('assigned_to').value;

if (caller == assignee)
{
   alert('in');
}

GlideForm : 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 59. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ à partir duquel vous souhaitez récupérer une valeur dans le formulaire.

Tableau 60. 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 : 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 61. Paramètres
Nom	Type	Description
id	Chaîne	ID de champ.

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

GlideForm : 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 63. Paramètres
Nom	Type	Description
Aucun

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

GlideForm : getHelpTextControl(String fieldName)

Renvoie l’élément HTML du texte d’aide pour le champ spécifié.

Cette méthode est applicable uniquement aux variables de catalogue de services.

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

Tableau 66. Renvoie
Type	Description
HTMLElement	Élément HTML du champ de texte d’aide.

GlideForm : getIntValue(String fieldName)

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

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

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

GlideForm : getLabelOf(String fieldName)

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

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

Tableau 70. 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 : getOption(String fieldName, String choiceValue)

Renvoie l’élément d’option d’une zone sélectionnée nommée fieldName où choiceValue correspond à la valeur de l’option.

Remarque :

Cette méthode ne fonctionne pas sur les champs en lecture seule.

Tableau 71. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
choiceValue	Chaîne	Valeur de l’option.

Tableau 72. Renvoie
Type	Description
HTMLElement	Le HTMLElement pour l’option. Renvoie null si le champ ou l’option est introuvable.

L’exemple suivant montre comment obtenir l’étiquette d’une valeur de liste de choix.

// Get the label for a choice list value
// fieldName is 'category'
 
function onChange(control, oldValue, newValue, isLoading) {
var choiceValue = g_form.getValue('category');
var choiceLabel = g_form.getOption('category', choiceValue).text; 
}

GlideForm : 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 : getReference(String fieldName, rappel de fonction)

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 : 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 : 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 : 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 : 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 : 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 : 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 : hideAllFieldMsgs()

Masque tous les messages de champ.

Tableau 89. Paramètres
Nom	Type	Description
Aucun

Tableau 90. Renvoie
Type	Description
nul

GlideForm : 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
nul

GlideForm : 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 : showErrorBox(Nom de chaîne, Message de chaîne, booléen scrollForm) pour afficher une annotation spécifique sur le formulaire.
GlideForm : 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 : 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
nul

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

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

Utilisez la méthode ou GlideForm : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne, Booléen scrollForm) pour afficher les GlideForm : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne) 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
nul

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 : hideRelatedLinks()

Masque la section Liens connexes d’un formulaire.

Voir aussi :

Tableau 99. Paramètres
Nom	Type	Description
Aucun

Tableau 100. Renvoie
Type	Description
Aucun

L’exemple de script suivant masque les liens connexes dans le formulaire actuel.

// Hide related links
g_form.hideRelatedLinks()

GlideForm : 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 101. 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 102. Renvoie
Type	Description
nul

GlideForm : 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 103. Paramètres
Nom	Type	Description
Aucun

Tableau 104. Renvoie
Type	Description
nul

GlideForm : hideTemplateBar()

Masque la barre de modèle sur le formulaire.

Tableau 105. Paramètres
Nom	Type	Description
Aucun

Tableau 106. Renvoie
Type	Description
Aucun

L’exemple de script suivant masque la barre de modèle sur le formulaire actuel.

g_form.hideTemplateBar()

GlideForm : isLiveUpdating()

Renvoie la valeur true lorsqu’une mise à jour en direct est effectuée sur l’enregistrement affiché par le formulaire.

Cela peut être utilisé dans un script client onChange() pour déterminer si un changement apporté à l’enregistrement est dû à une mise à jour en direct d’une autre session. Le script client peut alors décider des mesures à prendre ou à ne pas prendre. Cela s’applique aux systèmes utilisant Interface utilisateur principale des formulaires opérationnels activés.

Tableau 107. Paramètres
Nom	Type	Description
Aucun

Tableau 108. Renvoie
Type	Description
Booléen	Renvoie la valeur true si une mise à jour en direct se produit sur l’enregistrement affiché par le formulaire.

GlideForm : isMandatory(String fieldName)

Renvoie la valeur vrai si le champ est obligatoire.

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

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

GlideForm : isNewRecord()

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

Tableau 111. Paramètres
Nom	Type	Description
Aucun

Tableau 112. 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 : isSectionVisible(String sectionName)

Renvoie la valeur vrai si la section est visible.

Important :

La fonction isSectionVisible() n’est pas prise en charge dans Espace de travail.

Tableau 113. Paramètres
Nom	Type	Description
Aucun

Tableau 114. Renvoie
Type	Description
Booléen	Renvoie la valeur true lorsque la section est visible ; sinon, la valeur false est renvoyée.

GlideForm : isVisible(nom de champ de chaîne)

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

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

Tableau 116. 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 : 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 117. 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 118. 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 : refreshSlushbucket(String fieldName)

Vous pouvez mettre à jour une variable de collecteur de liste.

Tableau 119. Paramètres
Nom	Type	Description
Fieldname	Chaîne	Nom de la zone de liste double.

Tableau 120. Renvoie
Type	Description
nul

g_form.refreshSlushbucket('bucket');

GlideForm : 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 121. 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 122. Renvoie
Type	Description
nul

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 : 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 123. 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 124. Renvoie
Type	Description
nul

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

GlideForm : removeOption(String fieldName, String choiceValue)

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

Tableau 125. 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 126. Renvoie
Type	Description
nul

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

GlideForm : save()

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

Tableau 127. Paramètres
Nom	Type	Description
Aucun

Tableau 128. Renvoie
Type	Description
nul

GlideForm : 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 129. 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 130. 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 : setDisabled(String fieldName, booléen désactiver)

Rend le champ spécifié disponible ou indisponible.

Tableau 131. 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 132. Renvoie
Type	Description
nul

GlideForm : 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 133. 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 134. Renvoie
Type	Description
nul

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 : 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 135. 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 136. Renvoie
Type	Description
nul

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

GlideForm : 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 137. 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 138. Renvoie
Type	Description
nul

GlideForm : 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 139. 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 140. Renvoie
Type	Description
nul

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 : setRelatedLinksDisplay(affichage booléen)

Afficher ou masquer la section Liens connexes dans l’interface utilisateur du formulaire à l’aide de valeurs booléennes.

GlideForm : hideRelatedLinks() masque les actions d’interface utilisateur du lien connexe sur le formulaire tout en GlideForm : showRelatedLinks() les affichant. La méthode g_form.setRelatedLinksDisplay (boolean : display) peut toutefois être utilisée pour afficher ou masquer des liens connexes avec plus de flexibilité dans vos scripts.

Tableau 141. Paramètres
Nom	Type	Description
affichage	Booléen	Marqueur indiquant s’il faut afficher ou masquer la section Liens connexes d’un formulaire. Valeurs valides : vrai : affiche les liens connexes dans le formulaire. false : masque les liens connexes dans le formulaire. Par défaut : true

Tableau 142. Renvoie
Type	Description
Aucun

L’exemple suivant montre comment afficher ou masquer la section Liens connexes dans un formulaire.

// Displays the Related Links section in the UI
g_form.setRelatedLinksDisplay(true);
// Hides the Related Links section in the UI
g_form.setRelatedLinksDisplay(false);

GlideForm : setSectionDisplay(String sectionName, affichage booléen)

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

Tableau 143. 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 144. Renvoie
Type	Description
Booléen	Renvoie la valeur vrai en cas de réussite.

GlideForm : 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 145. 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 146. Renvoie
Type	Description
nul

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 : 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 147. 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 148. Renvoie
Type	Description
nul

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 : 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 149. 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 150. Renvoie
Type	Description
nul

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

g_form.setVariablesReadOnly(true);

GlideForm : 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 151. 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 152. Renvoie
Type	Description
nul

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 : 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 : hideAnnotation(nom de chaîne) pour masquer une annotation spécifique sur le formulaire.
GlideForm : toggleAnnotations() pour activer et désactiver les annotations avec une plus grande flexibilité.

Tableau 153. 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 154. 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 : 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 155. 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 156. Renvoie
Type	Description
nul

GlideForm : 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 157. 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 158. Renvoie
Type	Description
nul

GlideForm : 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 159. 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 160. Renvoie
Type	Description
nul

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

GlideForm : 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 161. 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 162. Renvoie
Type	Description
nul

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

GlideForm : showRelatedLinks()

Affiche la section Liens connexes d’un formulaire.

Voir aussi :

Tableau 163. Paramètres
Nom	Type	Description
Aucun

Tableau 164. Renvoie
Type	Description
Aucun

L’exemple suivant affiche les liens connexes dans l’interface utilisateur du formulaire.

// Show related links
g_form.showRelatedLinks()

GlideForm : 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 165. Paramètres
Nom	Type	Description
listTableName	Chaîne	Nom de la liste connexe à afficher.

Tableau 166. Renvoie
Type	Description
nul

GlideForm : 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 167. Paramètres
Nom	Type	Description
Aucun

Tableau 168. Renvoie
Type	Description
nul

GlideForm : showTemplateBar()

Si elle est masquée, affiche la barre de modèle au bas du formulaire.

Tableau 169. Paramètres
Nom	Type	Description
Aucun

Tableau 170. Renvoie
Type	Description
Aucun

L’exemple de script suivant affiche la barre de modèle au bas du formulaire actuel.

g_form.showTemplateBar()

GlideForm : soumettre()

Enregistre l’enregistrement.

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

Tableau 171. Paramètres
Nom	Type	Description
Aucun

Tableau 172. Renvoie
Type	Description
nul

GlideForm : soumettre(verbe de chaîne)

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

Tableau 173. 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 174. Renvoie
Type	Description
nul

GlideForm : 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 175. Paramètres
Nom	Type	Description
Aucun

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