GlideForm : client

L’API GlideForm fournit des méthodes pour personnaliser les formulaires.

GlideForm.js s’agit de la classe JavaScript contenant les méthodes. N’utilisez que les méthodes GlideForm sur le client. Vous pouvez utiliser ces méthodes pour apporter des modifications personnalisées à la vue de formulaire des enregistrements. Toute la validation des exemples a été effectuée à l’aide de scripts clients.

Vous pouvez également utiliser certaines de ces méthodes dans d’autres scripts clients (tels que les scripts clients de catalogue ou les scripts clients d’assistants), mais vous devez d’abord tester cette méthode pour déterminer si elles fonctionneront comme prévu.

Remarque :

Les méthodes getControl(),getHelpTextControl(), getElement() et getFormElement() sont déconseillées pour les appareils mobiles. Pour plus d’informations sur l’utilisation de GlideForm pour mobile, consultez Client mobile GlideForm (g_form) Scripting and Migration.

Il n’existe aucun constructeur pour la classe GlideForm . Accédez aux méthodes GlideForm à l’aide de l’objet global g_form .

GlideForm : addDecoration(String fieldName, icône de chaîne, titre de la chaîne)

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

Il est interdit d’ajouter deux fois le même élément ; Cependant, 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 du champ.
icône	Chaîne	Icône de police à afficher à côté du champ. Icônes prises en charge : icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form et icon-livefeed.
Titre	Chaîne	Titre textuel de l’icône.

Tableau 2. Renvoie

Type	Description
nul

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

GlideForm : addDecoration(String fieldName, icône de chaîne, titre de la chaîne, couleur de la chaîne)

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

Il est interdit d’ajouter deux fois le même élément ; Cependant, 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 du champ.
icône	Chaîne	Icône de police à afficher à côté du champ. Icônes prises en charge : icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form et icon-livefeed.
Titre	Chaîne	Titre textuel de l’icône.
couleur	Chaîne	Une 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 de détails du formulaire. Le message ne couvre pas les actions d’interface utilisateur.

Voir aussi :

• clearAllFormMessages()
• clearFormMessages()

Tableau 7. Paramètres

Nom	Type	Description
message	Chaîne	Message à afficher.
type	Chaîne	Le type de message. Valeurs valides : erreur infos avertissement
options	Objet	Facultatif. Objet contenant des 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	Tableau de boutons à ajouter au message du formulaire. buttons: [ { label: "String", actionName: "String" } ]
options.boutons.étiquette	Chaîne	Texte à afficher sur le bouton.
options.boutons.actionName	Chaîne	Nom utilisé par FORM_MESSAGE_BUTTON_CLICKED gestionnaires d’événements pour déterminer le bouton sur lequel l’utilisateur a cliqué. Par exemple, si vous ajoutez un bouton avec le assign_to_me actionName, vous devez créer un gestionnaire d’événements dans UIB l’événement FORM_MESSAGE_BUTTON_CLICKED qui ne s’exécute que lorsque le actionName est assigned_to_me.
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 de l’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 : 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 9. Paramètres

Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 10. Renvoie

Type	Description
nul

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

GlideForm : addOption(String fieldName, String choiceValue, String choiceLabel)

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

Tableau 11. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Valeur du choix	Chaîne	Valeur à stocker dans la base de données.
Étiquette de choix	Chaîne	La valeur affichée.

Tableau 12. 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 13. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Valeur du choix	Chaîne	Valeur stockée dans la base de données.
Étiquette de choix	Chaîne	La valeur affichée.
Index de choix	Numéro	Ordre du choix dans la liste. L’index est dans un tableau de base zéro.

Tableau 14. Renvoie

Type	Description
nul

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

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 15. Paramètres

Nom	Type	Description
Aucun

Tableau 16. Renvoie

Type	Description
nul

g_form.clearMessages();

GlideForm : clearAllFormMessages()

Supprime tous les messages de formulaire, quel que soit leur type.

Voir aussi :

• addFormMessage()
• clearFormMessages()

Tableau 17. Paramètres

Nom	Type	Description
Aucun

Tableau 18. 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 donné.

Voir aussi :

• addFormMessage()
• clearAllFormMessages()

Tableau 19. Paramètres

Nom	Type	Description
type	Chaîne	Le type de message. Valeurs valides : erreur infos avertissement

Tableau 20. Renvoie

Type	Description
Aucun

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

g_form.clearFormMessages('error');

GlideForm : clearOptions(String fieldName)

Supprime toutes les options de la liste de choix.

Tableau 21. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 22. Renvoie

Type	Description
nul

GlideForm : clearValue(String fieldName)

Supprime toute valeur du champ.

Tableau 23. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 24. Renvoie

Type	Description
nul

GlideForm : disableAttachments()

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

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

Tableau 25. Paramètres

Nom	Type	Description
Aucun

Tableau 26. Renvoie

Type	Description
nul

GlideForm : enableAttachments()

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

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

Tableau 27. Paramètres

Nom	Type	Description
Aucun

Tableau 28. Renvoie

Type	Description
nul

GlideForm - flash(String fieldName, String color, Number count)

Utilisé pour attirer l’attention sur un champ particulier. 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 plate-forme mobile, aucune action ne se produit.

Tableau 29. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Spécifie le champ à mettre en surbrillance au format suivant : « <nom-table>.<nom-champ> ».
couleur	Chaîne	Couleur RVB ou couleur CSS acceptable.
compter	Numéro	Spécifie la durée pendant laquelle l’étiquette clignotera. Les options incluent : 2 : Clignote pendant 1 seconde 0 : Clignote pendant 2 secondes -2 : Clignote pendant 3 secondes -4 : Clignote pendant 4 secondes

Tableau 30. Renvoie

Type	Description
nul

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

GlideForm : getActionName()

Renvoie le nom de l’action la plus récente ou, dans le cas d’un script client, le sys_id de l’action d’interface utilisateur sur laquelle vous avez cliqué.

Remarque :

Non disponible dans les scripts clients de l’assistant.

Tableau 31. Paramètres

Nom	Type	Description
Aucun

Tableau 32. Renvoie

Type	Description
Chaîne	Nom de l’action actuelle.

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

GlideForm : getBooleanValue(String fieldName)

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

Tableau 33. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 34. Renvoie

Type	Description
Booléen	Renvoie la valeur false si la valeur du champ est false ou non définie ; sinon, renvoie la valeur true.

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 un 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 Mobile ou les scripts Service Portal.

Tableau 35. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 36. Renvoie

Type	Description
HTMLElement	Élément HTML du champ.

GlideForm : getDecimalValue(String fieldName)

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

Tableau 37. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 38. 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)

Obtient 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 :

• getValue()
• Obtenir la valeur d’affichage d’une variable de référence

Tableau 39. Paramètres

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

Tableau 40. Renvoie

Type	Description
Aucun

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)

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

Remarque :

Pour obtenir une valeur d’affichage à partir d’un formulaire dans l’interface utilisateur principale, utilisez la méthode getDisplayBox().

Voir aussi :

• getValue()
• Obtenir la valeur d’affichage d’une variable de référence

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 41. Paramètres

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

Tableau 42. Renvoie

Type	Description
Aucun

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 Mobile ou les scripts Service Portal.

Tableau 43. Paramètres

Nom	Type	Description
id	Chaîne	ID du champ.

Tableau 44. Renvoie

Type	Description
HTMLElement	Élément HTML du champ.

GlideForm : getFormElement()

Renvoie l’élément HTML du formulaire.

Cette méthode n’est pas disponible dans les scripts Mobile ou les scripts Service Portal.

Tableau 45. Paramètres

Nom	Type	Description
Aucun

Tableau 46. Renvoie

Type	Description
HTMLFormElement (en anglais seulement)	É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 s’applique uniquement aux variables du catalogue de services.

Tableau 47. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 48. Renvoie

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

GlideForm : getIntValue (String fieldName)

Renvoie la valeur entière du champ.

Tableau 49. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 50. Renvoie

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

GlideForm : getLabelOf(String fieldName)

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

Tableau 51. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le nom du champ

Tableau 52. Renvoie

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

Remarque :

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

Tableau 53. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Valeur du choix	Chaîne	Valeur de l’option.

Tableau 54. Renvoie

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

L’exemple suivant montre comment obtenir l’étiquette pour 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 : getReference(String fieldName, rappel de fonction)

Renvoie 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, moment auquel la fonction de rappel est appelé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 (ce qui donne l’impression que le navigateur se bloque) 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 un temps supplémentaire et peut introduire une latence sur votre page. Utilisez cette méthode avec prudence. Pour plus d’informations, reportez-vous à la section Conception et traitement d’un script client.

Tableau 55. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Rappel	Fonction	Nom de la fonction de rappel.

Tableau 56. 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 57. Paramètres

Nom	Type	Description
Aucun

Tableau 58. Renvoie

Type	Description
Tableau	Tableau de chaînes de noms de listes connexes provenant 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 sections, qu’ils soient visibles ou non.

Tableau 59. Paramètres

Nom	Type	Description
Aucun

Tableau 60. Renvoie

Type	Description
Tableau de chaînes	Les 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 plate-forme mobile, aucune action ne se produit.

Tableau 61. Paramètres

Nom	Type	Description
Aucun

Tableau 62. Renvoie

Type	Description
Tableau d’éléments HTML	Les 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 appartient cet enregistrement.

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

Tableau 63. Paramètres

Nom	Type	Description
Aucun

Tableau 64. 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 65. Paramètres

Nom	Type	Description
Aucun

Tableau 66. Renvoie

Type	Description
Chaîne	Le 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 permet également d’obtenir des valeurs à partir d’un jeu de variables à plusieurs lignes (MRVS). Pour obtenir des données à partir de champs au sein d’un MRVS, vous devez d’abord utiliser JSON.parse(getValue('<mrvs_field_name>') || '[]') pour obtenir le tableau MRVS, puis utilisez l’indexation pour accéder aux champs à l’intérieur des objets de ligne. Pour plus de détails, consultez l’exemple de code ci-dessous.

Tableau 67. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ dont la valeur doit être renvoyée.

Tableau 68. 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 Catalogue de services. Le script client recherche la valeur saisie dans l’intitulé de la fonction dans toutes les lignes du MRVS, 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 [salary].

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 69. Paramètres

Nom	Type	Description
Aucun

Tableau 70. Renvoie

Type	Description
nul

GlideForm : hideAllFieldMsgs (type de chaîne)

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

Tableau 71. Paramètres

Nom	Type	Description
type	Chaîne	Le type de message. Valeurs valides : erreur infos

Tableau 72. Renvoie

Type	Description
nul

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 73. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ ou du contrôle.

Tableau 74. Renvoie

Type	Description
nul

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

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

Utilisez les GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne) méthodes ou GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne, 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 75. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ dans lequel masquer le message.
Tout effacer	Booléen	Facultatif. Marqueur indiquant s’il faut masquer tous les messages pour le champ spécifié. Valeurs valides : true : Masquer tous les messages. false : masquer uniquement le premier message affiché. Valeur par défaut : false

Tableau 76. Renvoie

Type	Description
nul

L’exemple suivant montre comment effacer tous les messages pour 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 : hideFieldMsg(String fieldName, booléen clearAll)

Masque les messages placés par showFieldMsg().

Tableau 77. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Tout effacer	Booléen	Si la valeur est vrai, tous les messages du champ sont effacés. Si la valeur est false, seul le dernier message est supprimé.

Tableau 78. Renvoie

Type	Description
nul

g_form.hideFieldMsg('impact', true);

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 plate-forme mobile, aucune action ne se produit.

Tableau 79. Paramètres

Nom	Type	Description
listTableName (en anglais seulement)	Chaîne	Nom de la liste connexe. Utilisez le sys_id pour masquer une liste par le biais d’une relation.

Tableau 80. Renvoie

Type	Description
nul

GlideForm : hideRelatedLists()

Masque 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 plate-forme mobile, aucune action ne se produit.

Tableau 81. Paramètres

Nom	Type	Description
Aucun

Tableau 82. Renvoie

Type	Description
nul

GlideForm : isLiveUpdating()

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

Cela peut être utilisé dans un script client onChange() pour déterminer si une modification de l’enregistrement est due à une mise à jour en direct d’une autre session. Le script client peut alors décider de l’action à entreprendre ou de ne pas entreprendre. Cela s’applique aux systèmes utilisant des Interface utilisateur principale formulaires actifs activés.

Tableau 83. Paramètres

Nom	Type	Description
Aucun

Tableau 84. Renvoie

Type	Description
Booléen	Renvoie la valeur true si une mise à jour active est en cours sur l’enregistrement affiché par le formulaire.

GlideForm : isMandatory(String fieldName)

Renvoie la valeur true si le champ est obligatoire.

Tableau 85. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 86. Renvoie

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

GlideForm : isNewRecord()

Renvoie la valeur true si l’enregistrement n’a jamais été enregistré.

Tableau 87. Paramètres

Nom	Type	Description
Aucun

Tableau 88. Renvoie

Type	Description
Booléen	Renvoie la valeur true si l’enregistrement n’a pas été sauvegardé ; Sinon, c’est faux.

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

GlideForm : isSectionVisible (String sectionName)

Renvoie la valeur true si la section est visible.

Important :

La fonction isSectionVisible() n’est pas prise en charge dans Workspace.

Tableau 89. Paramètres

Nom	Type	Description
Aucun

Tableau 90. Renvoie

Type	Description
Booléen	Renvoie la valeur true lorsque la section est visible ; Dans le cas contraire, la valeur false est renvoyée.

GlideForm : onUserChangeValue(Function 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 est uniquement déclenché lorsqu’un utilisateur apporte une modification à un champ du formulaire. Les modifications apportées 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 de journal dans l’environnement classique.

Tableau 91. 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 la 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 92. Renvoie

Type	Description
Fonction	Fonction à appeler pour annuler l’inscription de l’écouteur d’événements 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 93. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom de la zone de liste double.

Tableau 94. 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.

Remarque :

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

Tableau 95. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom de champ.
icône	Chaîne	Nom de l’icône à supprimer.
Titre	Chaîne	Le texte de l’icône, le titre (nom).

Tableau 96. 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 la chaîne, couleur de la chaîne)

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

Remarque :

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

Tableau 97. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom de champ.
icône	Chaîne	Nom de l’icône à supprimer.
Titre	Chaîne	Le texte de l’icône, le titre (nom).
couleur	Chaîne	Une couleur CSS

Tableau 98. 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.

Tableau 99. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Valeur du choix	Chaîne	Valeur stockée dans la base de données. Ce n’est pas l’étiquette.

Tableau 100. Renvoie

Type	Description
nul

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

GlideForm - save()

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

Tableau 101. Paramètres

Nom	Type	Description
Aucun

Tableau 102. Renvoie

Type	Description
nul

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 103. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
obligatoire	Booléen	Si la valeur est vrai, le champ est obligatoire. Si la valeur est définie sur faux, le champ est facultatif.

Tableau 104. Renvoie

Type	Description
nul

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

Affiche ou masque une section.

Tableau 105. Paramètres

Nom	Type	Description
sectionName	Chaîne	Le nom de la section est en minuscules avec un trait de soulignement remplaçant le premier espace du nom, et les espaces restants étant supprimés, par exemple « Section Four is Here » devient « section_fourishere ». Les autres caractères non alphanumériques, tels que l’esperluette (&), sont supprimés. Les noms de sections peuvent être trouvés à l’aide de la méthode getSectionNames().
affichage	Booléen	Si la valeur est vraie, affiche la section. Si faux, masque la section.

Tableau 106. Renvoie

Type	Description
Booléen	En cas de réussite, renvoie la valeur vrai.

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 empêchant 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). Lors de la définition de 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. Cela est dû au fait qu’à 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. Par exemple, avant d’exécuter setValue(shortDesc, newValue.toUpperCase()) ;, validez 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 107. 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 une 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 : Lors de la définition d’une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l’é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 du nom de l’utilisateur. 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, reportez-vous à la rubrique Valeur d’affichage.

Tableau 108. Renvoie

Type	Description
nul

Cet exemple montre le passage de la 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 le passage 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 la GlideList glide-list_field_name.

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

GlideForm : showErrorBox(nom de chaîne, message de chaîne, scrollForm booléen)

Affiche un message d’erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit le nom du champ). Si le contrôle ou le champ n’est pas affiché et que le paramètre scrollForm est défini sur true, le formulaire défile jusqu’au contrôle ou au champ.

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

Tableau 109. Paramètres

Nom	Type	Description
nom	Chaîne	Nom du champ ou du contrôle.
message	Chaîne	Message à afficher.
scrollForm	Booléen	Si la valeur est « vrai », le formulaire fait défiler jusqu’au champ. Si la valeur est définie sur false, le formulaire ne défile pas jusqu’au champ.

Tableau 110. Renvoie

Type	Description
nul

GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne)

Affiche un message d’information ou d’erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le champ ou le champ n’apparaît pas à l’écran, le formulaire défile jusqu’au champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n’est pas à l’écran (fait défiler le formulaire vers le contrôle ou le 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 111. Paramètres

Nom	Type	Description
champ	Chaîne	Nom du champ ou du contrôle.
message	Chaîne	Message à afficher.
type	Chaîne	« erreur », « info » ou « avertissement ».

Tableau 112. 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, défilement booléen)

Affiche un message d’information ou d’erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le contrôle ou le champ n’est pas affiché et que scrollForm a la valeur vrai, le formulaire bascule jusqu’au champ.

Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n’est pas à l’écran (fait défiler le formulaire vers le contrôle ou le 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 113. Paramètres

Nom	Type	Description
champ	Chaîne	Nom du champ ou du contrôle.
message	Chaîne	Message à afficher.
type	Chaîne	« erreur », « info » ou « avertissement ».
scrollForm	Booléen	Si la valeur est « vrai », le formulaire défile jusqu’au champ s’il est hors écran. Si la valeur est « faux », le formulaire ne défile pas.

Tableau 114. Renvoie

Type	Description
nul

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

GlideForm : setDisabled(String fieldName, Boolean disable)

Rend le champ spécifié disponible ou indisponible.

Tableau 115. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
Désactiver	Booléen	Si la valeur est vrai, le champ est désactivé. Si la valeur est définie sur false, le champ est activé.

Tableau 116. Renvoie

Type	Description
nul

GlideForm : setDisplay(String fieldName, affichage booléen)

Affiche ou masque un champ.

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 117. Paramètres

Nom	Type	Description
Nom de champ	Chaîne	Nom du champ.
affichage	Booléen	Si la valeur est vrai, affiche le champ, si la valeur est faux, elle masque le champ.

Tableau 118. 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, étiquette de chaîne)

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

Remarque :

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

Tableau 119. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
étiquette	Chaîne	Étiquette de texte du champ.

Tableau 120. Renvoie

Type	Description
nul

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

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 façon, vous devez définir la valeur readOnly sur faux.

Tableau 121. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
readOnly	Booléen	Marqueur qui détermine si le champ associé est modifiable ou en lecture seule. Valeurs possibles : vrai : définir le champ sur lecture seule false : définir le champ à modifier

Tableau 122. Renvoie

Type	Description
Aucun

L’exemple suivant montre comment définir l’éditeur de variable en lecture seule. Pour ce faire 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 : setValue(String, fieldName, valeur de chaîne)

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

Cette méthode prend également en charge la définition des 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 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 la pile lorsqu’elle est utilisée dans un script client OnChange. Cela est dû au fait qu’à 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. Par exemple, avant d’exécuter setValue(shortDesc, newValue.toUpperCase()) ;, validez 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.

Remarque :

Lors de la définition d’une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l’étiquette.

Tableau 123. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ de formulaire à mettre à jour.
valide	Chaîne	Valeur de chaîne à définir dans le champ spécifié.

Tableau 124. 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 Catalogue de services. Le script client recherche la valeur saisie dans l’intitulé de la fonction dans toutes les lignes du MRVS, 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 [salary].

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 : setVariablesReadOnly(booléen isReadOnly)

Met un éditeur de Catalogue de services variable en lecture seule.

Remarque :

Cette méthode est uniquement applicable aux éditeurs de Catalogue de services 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 variable est ajouté, par exemple Élément demandé [sc_req_item], Incident [incident], etc. Pour définir des variables en lecture seule dans d’autres tables, utilisez la méthode setReadOnly().

Voir aussi : Éditeurs de variables de Service Catalog

Tableau 125. Paramètres

Nom	Type	Description
isReadOnly	Booléen	Marqueur qui détermine si l’éditeur de variable est en lecture seule. Valeurs possibles : true : définit l’éditeur de variables en lecture seule. false : définit l’éditeur de variable comme modifiable. Valeur par défaut : false

Tableau 126. Renvoie

Type	Description
Aucun

L’ajout de la ligne suivante à un script client entraîne la lecture seule de l’éditeur de variables.

g_form.setVariablesReadOnly(true);

GlideForm : setVisible(String fieldName, affichage booléen)

Affiche ou masque le champ.

Sur l’interface utilisateur de bureau, l’espace est laissé vide lorsqu’il est masqué. Sur l’interface utilisateur Mobile ou du portail de services, 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 127. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
affichage	Booléen	Si la valeur est vraie, le champ s’affiche. Si la valeur est définie sur faux, le champ est masqué.

Tableau 128. 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 : showErrorBox(nom de chaîne, message de chaîne)

Affiche un message d’erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit le nom du champ). Si le contrôle ou le champ n’est pas affiché à l’écran, le formulaire défile jusqu’au contrôle ou au champ.

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

Tableau 129. Paramètres

Nom	Type	Description
nom	Chaîne	Nom du contrôle ou du champ.
message	Chaîne	Le message à afficher.

Tableau 130. Renvoie

Type	Description
nul

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 plate-forme mobile, aucune action ne se produit.

Tableau 131. Paramètres

Nom	Type	Description
listTableName (en anglais seulement)	Chaîne	Nom de la liste connexe.

Tableau 132. 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 plate-forme mobile, aucune action ne se produit.

Tableau 133. Paramètres

Nom	Type	Description
Aucun

Tableau 134. Renvoie

Type	Description
nul

GlideForm : submit()

Enregistre l’enregistrement.

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

Tableau 135. Paramètres

Nom	Type	Description
Aucun

Tableau 136. Renvoie

Type	Description
nul

GlideForm : submit(verbe à chaînes)

Exécute l’action d’interface utilisateur spécifiée par le paramètre.

Tableau 137. Paramètres

Nom	Type	Description
verbe	Chaîne	Un action_name à partir d’un enregistrement sys_ui_action. Le nom de l’action doit être celui d’un bouton de formulaire visible.

Tableau 138. Renvoie

Type	Description
nul