GlideForm : client

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

GlideForm.js est la classe JavaScript contenant les méthodes. La g_form d’objet global est utilisée pour accéder aux méthodes GlideForm . Les méthodes GlideForm ne sont utilisées que sur le client. Ces méthodes sont utilisées 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.

Certaines de ces méthodes peuvent également être utilisées dans d’autres scripts clients (tels que les scripts clients de catalogue ou les scripts clients d’assistants), mais vous devez d’abord les tester pour déterminer si elles fonctionneront comme prévu.

Remarque :

Les méthodes getControl(),getHelpTextControl(), getElement() et getFormElement() sont déconseillées pour les équipements 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 chaîne)

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

L’ajout de deux fois le même élément 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 Service Catalog.

Tableau 1. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le 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, 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	Le 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, String icon, String title, String color)

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

L’ajout de deux fois le même élément 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 Service Catalog.

Tableau 3. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le 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, 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	Le 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 apparaît 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.buttons.actionName	Chaîne	Nom utilisé par les gestionnaires d’événements FORM_MESSAGE_BUTTON_CLICKED pour déterminer le bouton sur lequel vous avez 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 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, au format 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
Néant

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 apparaît 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	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	Le nom du champ.
Valeur du choix	Chaîne	La valeur stockée dans la base de données.
Étiquette de choix	Chaîne	Valeur affichée.
Index de choix	Numéro	Ordre du choix dans la liste. L’index se trouve dans un tableau basé sur 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
Néant

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
Néant

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 toutes les valeurs 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 Mobile Platform. 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 de fichier. Affiche l’icône de trombone.

Cette méthode n’est pas disponible sur Mobile Platform. 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(Nom du champ de chaîne, Couleur de la chaîne, Nombre de nombres)

Utilisé pour attirer l’attention sur un domaine 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 Service Catalog.

Cette méthode n’est pas disponible sur Mobile Platform. 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 : « <table-name>.<field-name> ».
couleur	Chaîne	Couleur RVB ou couleur CSS acceptable.
compter	Numéro	Spécifie la durée de clignotement de l’étiquette. 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, pour un script client, la 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>.&lt;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 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
Néant

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, appeler 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
Néant

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(String id)

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	L’ID du champ.

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

Tableau 45. Paramètres

Nom	Type	Description
Aucun

Tableau 46. Renvoie

Type	Description
Élément HtmlForm	L’é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	Le nom du champ.

Tableau 50. Renvoie

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

GlideForm : getLabelOf(String fieldName)

Renvoie la valeur de 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 pour 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 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 la valeur 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 : getReference(String fieldName, Function callBack)

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 retourne 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) en attendant 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, reportez-vous à la section Conception et traitement de scripts clients.

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 Mobile Platform. 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 la 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 disque est sys_id.

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 de 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 dans les 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 brève description à 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 Service Catalog. Le script client recherche la valeur saisie dans l’intitulé Tâche 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], Titre du poste [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Titre du poste [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 info

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)

Masque le dernier message placé par showFieldMsg().

Tableau 75. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 76. Renvoie

Type	Description
nul

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.
clearAll (effacer)	Booléen	Si la valeur est vrai, tous les messages du champ sont effacés. Si la propriété est définie sur 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 Mobile Platform. 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 la 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 sur le formulaire.

Cette méthode n’est pas disponible sur Mobile Platform. 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 pendant qu’une mise à jour active est effectuée sur l’enregistrement affiché dans 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 de l’action à entreprendre ou de ne pas entreprendre. Cela s’applique aux systèmes utilisant Interface utilisateur principale des formulaires opérationnels 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 en direct se produit 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	True si le champ est obligatoire, false dans les autres cas.

GlideForm : isNewRecord()

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

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é enregistré ; 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 ; sinon, la valeur false est renvoyée.

GlideForm : onUserChangeValue(Function fn)

Enregistre un écouteur d’événement personnalisé qui détecte lorsqu’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 qui est transmise lors de l’enregistrement initial de l’écouteur. Cet écouteur est uniquement déclenché lorsqu’un utilisateur modifie un champ du formulaire. Les changements apportés par les scripts clients, les 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 du champ d’origine Valeur de champ mise à jour

Tableau 92. Renvoie

Type	Description
Fonction	Fonction à appeler pour annuler l’inscription de l’écouteur d’événements onUserChangeValue.

Exemple

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 Collecteur de liste.

Tableau 93. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom de la zone de sélection.

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 Service Catalog.

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 titre (nom) du texte de l’icône.

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 chaîne, couleur de 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 Service Catalog.

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 titre (nom) du texte de l’icône.
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	La 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 false, 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 section peuvent être trouvés à l’aide de la méthode getSectionNames().
affichage	Booléen	Si la valeur est définie sur vrai, affiche la section. Si la valeur est définie sur faux, la section est masquée.

Tableau 106. Renvoie

Type	Description
Booléen	Renvoie la valeur true en cas de réussite.

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 et displayValue .

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 s’enregistre en tant que 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()) ;, vérifiez que la description courte n’est pas déjà en majuscules. Cela empêchera le script client d’appliquer la fonction 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 : Lorsque vous définissez une valeur dans une liste de choix, assurez-vous d’utiliser une 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 d’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 le glide-list_field_name GlideList.

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 est actuellement hors de l’écran 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 du formulaire est hors de 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 propriété est définie sur faux, 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 un message d’erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit 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 du formulaire est hors de 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 journal_field champ type 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, scrollForm booléen)

Affiche un message d’information ou un message d’erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit le nom du champ). Si le champ ou le contrôle est actuellement hors de l’écran et que scrollForm a la valeur true, 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 du formulaire est hors de 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 journal_field champ type 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 propriété est définie sur false, 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, active le champ.

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
Fieldname	Chaîne	Nom du champ.
affichage	Booléen	Si la valeur est vrai, affiche le champ, dans le champ défini sur faux, il est masqué.

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, String label)

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

Remarque :

Cette méthode n’est pas prise en charge par Service Catalog.

Tableau 119. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le nom du champ.
étiquette	Chaîne	L’é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é accessible en lecture seule ou modifiable.

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

Pour qu’un champ obligatoire soit 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 false.

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 : true : définir le champ en lecture seule false : définir le champ à modifier

Tableau 122. Renvoie

Type	Description
Néant

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, String value)

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 de valeurs dans un jeu de variables de 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 s’enregistre en tant que 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()) ;, vérifiez que la description courte n’est pas déjà en majuscules. Cela empêchera le script client d’appliquer la fonction toUpperCase() plus d’une fois.

Remarque :

Lorsque vous définissez 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 Service Catalog. Le script client recherche la valeur saisie dans l’intitulé Tâche 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], Titre du poste [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Titre du poste [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 ne s’applique qu’aux éditeurs de Catalogue de services variables de 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 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 variable en lecture seule. false : définit l’éditeur de variable comme modifiable. Valeur par défaut : false

Tableau 126. Renvoie

Type	Description
Néant

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

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é. Dans l’interface utilisateur Mobile ou Service Portal, 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	Le nom du champ.
affichage	Booléen	Si la valeur est définie sur Vrai, affiche le champ. 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 champ ou le champ n’est pas affiché, 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 du formulaire est hors de 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 Mobile Platform. 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 Mobile Platform. 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, ce qui le renvoie à l’endroit où il se trouvait.

Tableau 135. Paramètres

Nom	Type	Description
Aucun

Tableau 136. Renvoie

Type	Description
nul

GlideForm - submit(verbe à chaîne)

Effectue 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 pour un bouton de formulaire visible.

Tableau 138. Renvoie

Type	Description
nul