GlideForm (g_form) : client

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

GlideForm.js’agit de la classe JavaScript contenant les méthodes. Utiliser uniquement 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’assistant), mais vous devez d’abord tester cela 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 Scripting et migration de GlideForm (g_form) pour client mobile.

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(Nom de champ de chaîne, icône de chaîne, titre de chaîne)

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

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

Remarque :

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

Tableau 1. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
icône	Chaîne	L’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-trabe, 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	Le titre de texte de l’icône.

Tableau 2. Renvoie

Type	Description
nul

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

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

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

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

Remarque :

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

Tableau 3. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
icône	Chaîne	L’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-trabe, 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	Le titre de texte de l’icône.
couleur	Chaîne	Couleur CSS.

Tableau 4. Renvoie

Type	Description
nul

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

GlideForm : addErrorMessage(Message de chaîne)

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

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

Tableau 5. Paramètres

Nom	Type	Description
message	Chaîne	Message à afficher.

Tableau 6. Renvoie

Type	Description
nul

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

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

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

Voir aussi :

• clearAllFormMessages()
• clearFormMessages()

Tableau 7. Paramètres

Nom	Type	Description
message	Chaîne	Message à afficher.
type	Chaîne	Type de message. Valeurs valides : erreur infos avertissement
options	Objet	Facultatif. 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.nom de l’action	Chaîne	Nom utilisé par les gestionnaires d’événements FORM_MESSAGE_BUTTON_CLICKED pour déterminer le bouton sur lequel l’utilisateur a cliqué. Par exemple, si vous ajoutez un bouton avec l’assign_to_me actionName, vous devez créer un gestionnaire d’événements sur UIB l’événement FORM_MESSAGE_BUTTON_CLICKED qui ne s’exécute que lorsque l’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 du 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 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	Le nom du champ.
valeur de 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	Nom du champ.
valeur de choix	Chaîne	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 est 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 de n’importe quel 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	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 la plateforme mobile. Si cette méthode est exécutée sur une plateforme 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 du trombone.

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

Tableau 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 plateforme 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, pour un script client, le sys_id de l’action d’interface utilisateur cliquée.

Remarque :

Non disponible dans les scripts clients de l’Assistant.

Tableau 31. Paramètres

Nom	Type	Description
Aucun

Tableau 32. Renvoie

Type	Description
Chaîne	Le 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 fausse ou indéfinie ; sinon, renvoie la valeur vrai.

GlideForm : getControl(String fieldName)

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

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

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

Cette méthode n’est pas disponible dans les scripts 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’é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	Le 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
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, 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
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(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’é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
HTMLFormElement	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 est applicable uniquement aux variables de 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 du champ.

Tableau 51. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le nom du champ

Tableau 52. Renvoie

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

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

GlideForm : getOption(String fieldName, String choiceValue)

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

Remarque :

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

Tableau 53. Paramètres

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

Tableau 54. Renvoie

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

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

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

GlideForm : getReference(String fieldName, rappel de fonction)

Retourne le GlideRecord pour un champ spécifié.

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

Important :

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

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

Remarque :

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

Tableau 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 à partir du formulaire actuel. Les noms des listes connexes sont répertoriés dans l’ordre dans lequel ils apparaissent sur le formulaire.

var listNames = g_form.getRelatedListNames();

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

GlideForm : getSectionNames()

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

Tableau 59. Paramètres

Nom	Type	Description
Aucun

Tableau 60. Renvoie

Type	Description
Tableau de chaînes	Noms des sections.

GlideForm : getSections()

Renvoie un tableau des sections du formulaire.

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

Tableau 61. Paramètres

Nom	Type	Description
Aucun

Tableau 62. Renvoie

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

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

GlideForm : getTableName()

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

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

Tableau 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’album.

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

GlideForm : getValue(String fieldName)

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

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

Tableau 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 le Service Catalog. Le script client recherche dans toutes les lignes du MRVS la valeur saisie dans le titre de la fonction , puis met à jour les entrées correspondantes dans le MRVS avec ce qui est saisi dans le champ Salaire . Le MRVS est nommé « variable_set_1 » et contient les champs suivants dans chaque objet de ligne : Nom de l’employé [employee_name], Fonction [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Fonction [job_title] et Salaire [salaire].

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

GlideForm : hideAllFieldMsgs()

Masque tous les messages de champ.

Tableau 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	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, booléen clearAll)

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

Utilisez la méthode ou GlideForm : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne, Booléen scrollForm) pour afficher les GlideForm : showFieldMsg(Champ de chaîne, Message de chaîne, Type de chaîne) messages sur un formulaire.

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

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

Tableau 75. Paramètres

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

Tableau 76. Renvoie

Type	Description
nul

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

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

GlideForm : hideRelatedList(String listTableName)

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

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

Tableau 77. Paramètres

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

Tableau 78. Renvoie

Type	Description
nul

GlideForm : hideRelatedLists()

Masque toutes les listes connexes sur le formulaire.

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

Tableau 79. Paramètres

Nom	Type	Description
Aucun

Tableau 80. Renvoie

Type	Description
nul

GlideForm : isLiveUpdating()

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

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

Tableau 81. Paramètres

Nom	Type	Description
Aucun

Tableau 82. Renvoie

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

GlideForm : isMandatory(String fieldName)

Renvoie la valeur vrai si le champ est obligatoire.

Tableau 83. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 84. Renvoie

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

GlideForm : isNewRecord()

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

Tableau 85. Paramètres

Nom	Type	Description
Aucun

Tableau 86. Renvoie

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

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

GlideForm : isSectionVisible(String sectionName)

Renvoie la valeur vrai si la section est visible.

Important :

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

Tableau 87. Paramètres

Nom	Type	Description
Aucun

Tableau 88. Renvoie

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

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

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

Tableau 89. Paramètres

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

Tableau 90. Renvoie

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

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

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

GlideForm : onUserChangeValue (fonction fn)

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

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

Remarque :

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

Tableau 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 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’enregistrement de l’écouteur d’événement onUserChangeValue.

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

GlideForm : refreshSlushbucket(String fieldName)

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

Tableau 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 titre du texte de l’icône (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 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 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 titre du texte de l’icône (nom).
couleur	Chaîne	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 de 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 ailleurs (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 devient obligatoire. Si la valeur est définie sur faux, le champ devient 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 avec les espaces restants 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 vrai, affiche la section. Si faux, la section est masquée.

Tableau 106. Renvoie

Type	Description
Booléen	Renvoie la valeur vrai 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 évitant un aller-retour lors de la définition de la valeur d’un champ de référence, utilisez cette méthode, et non setValue(fieldName, value). Lorsque vous définissez plusieurs valeurs de référence pour un champ de collecteur de liste, transmettez des tableaux dans les value paramètres and displayValue .

Remarque :

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

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

Tableau 108. Renvoie

Type	Description
nul

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

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

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

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

GlideForm : showErrorBox(Nom de chaîne, Message de chaîne, booléen scrollForm)

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

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

Tableau 109. Paramètres

Nom	Type	Description
nom	Chaîne	Nom du champ ou du contrôle.
message	Chaîne	Message à afficher.
formulaire de défilement	Booléen	Si la valeur est vrai, fait défiler le formulaire jusqu’au champ. Si la valeur est faux, le formulaire ne défile pas vers le 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é (objet de contrôle ou nom du champ). Si le contrôle ou le champ est hors de l’écran, le formulaire défile jusqu’au champ.

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

La méthode 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, Booléen scrollForm)

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

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

La méthode 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 ».
formulaire de défilement	Booléen	Si la valeur est Vrai, le formulaire défile vers le 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, booléen désactiver)

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 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
nom de champ	Chaîne	Nom du champ.
affichage	Booléen	Si vrai, affiche le champ, sinon faux, 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, String label)

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	L’étiquette du 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 manière, 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 en lecture seule faux : définir le champ comme modifiable

Tableau 122. Renvoie

Type	Description
Néant

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

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

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

Remarque :

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

Tableau 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é. Remarque : Lorsque vous définissez une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l’étiquette.

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 le Service Catalog. Le script client recherche dans toutes les lignes du MRVS la valeur saisie dans le titre de la fonction , puis met à jour les entrées correspondantes dans le MRVS avec ce qui est saisi dans le champ Salaire . Le MRVS est nommé « variable_set_1 » et contient les champs suivants dans chaque objet de ligne : Nom de l’employé [employee_name], Fonction [employee_job_title] et Salaire [employee_salary]. En outre, l’élément de catalogue contient : Fonction [job_title] et Salaire [salaire].

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

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

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

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

GlideForm : setVariablesReadOnly(booléen isReadOnly)

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

Remarque :

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

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

Voir aussi : Éditeurs de variables de Catalogue de services

Tableau 125. Paramètres

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

Tableau 126. Renvoie

Type	Description
Néant

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

g_form.setVariablesReadOnly(true);

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

Affiche ou masque le champ.

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’il est masqué. 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 Vrai, affiche le champ. Si faux, masque le champ.

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é (objet de contrôle ou nom du champ). Si le contrôle ou le champ est actuellement hors de l’écran, le formulaire défile jusqu’au contrôle ou au champ.

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

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

Tableau 131. Paramètres

Nom	Type	Description
listTableName	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 plateforme mobile, aucune action ne se produit.

Tableau 133. Paramètres

Nom	Type	Description
Aucun

Tableau 134. Renvoie

Type	Description
nul

GlideForm : soumettre()

Enregistre l’enregistrement.

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

Tableau 135. Paramètres

Nom	Type	Description
Aucun

Tableau 136. Renvoie

Type	Description
nul

GlideForm : soumettre(verbe de 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	Une action_name 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