---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideForm : client

# GlideForm : client {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 33 minutes de lecture

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

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

Vous pouvez également utiliser certaines de ces méthodes dans d'autres scripts clients (tels que les scripts clients de catalogue ou les scripts clients d'assistants), mais vous devez d'abord tester cette méthode pour déterminer si elles fonctionneront comme prévu.  
Remarque :  
Les méthodes getControl(),getHelpTextControl(), getElement() et getFormElement() sont déconseillées pour les appareils mobiles. Pour plus d'informations sur l'utilisation de GlideForm pour mobile, consultez [Client mobile GlideForm (g_form) Scripting and Migration](https://www.servicenow.com/docs/access?context=r_MobilePlatformMigrationImpacts&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).

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

## GlideForm : addDecoration(String fieldName, icône de chaîne, titre de la chaîne) {#ariaid-title2}

Ajoute une icône sur l'étiquette d'un champ.
Il est interdit d'ajouter deux fois le même élément ; Cependant, vous pouvez ajouter la même icône avec un titre différent.  
Remarque :  
Cette méthode n'est pas prise en charge par Catalogue de services.
{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| icône | Chaîne | Icône de police à afficher à côté du champ. Icônes prises en charge : icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form et icon-livefeed. |
| Titre | Chaîne | Titre textuel de l'icône. |
[Tableau 1. Paramètres]

{#r_GlideForm-AddDecoration_S_S_S__table_vyw_1dw_ts} {#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

{#r_GlideForm-AddDecoration_S_S_S__table_wyw_1dw_ts}  

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

## GlideForm : addDecoration(String fieldName, icône de chaîne, titre de la chaîne, couleur de la chaîne) {#ariaid-title3}

Ajoute une icône sur l'étiquette d'un champ.
Il est interdit d'ajouter deux fois le même élément ; Cependant, vous pouvez ajouter la même icône avec un titre différent.  
Remarque :  
Cette méthode n'est pas prise en charge par Catalogue de services.
{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| icône | Chaîne | Icône de police à afficher à côté du champ. Icônes prises en charge : icon-user, icon-user-group, icon-lightbulb, icon-home, icon-mobile, icon-comment, icon-mail, icon-locked, icon-database, icon-book, icon-drawer, icon-folder, icon-catalog, icon-tab, icon-cards, icon-tree-right, icon-tree, icon-book-open, icon-paperclip, icon-edit, icon-trash, icon-image, icon-search, icon-power, icon-cog, icon-star, icon-star-empty, icon-new-ticket, icon-dashboard, icon-cart-full, icon-view, icon-label, icon-filter, icon-calendar, icon-script, icon-add, icon-delete, icon-help, icon-info, icon-check-circle, icon-alert, icon-sort-ascending, icon-console, icon-list, icon-form et icon-livefeed. |
| Titre | Chaîne | Titre textuel de l'icône. |
| couleur | Chaîne | Une couleur CSS. |
[Tableau 3. Paramètres]

{#r_GlideForm-AddDecoration_S_S_S_S__table_gzh_fyd_5s} {#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 4. Renvoie]

{#r_GlideForm-AddDecoration_S_S_S_S__table_hzh_fyd_5s}  

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

## GlideForm : addErrorMessage (message de chaîne) {#ariaid-title4}

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.
{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| message | Chaîne | Message à afficher. |
[Tableau 5. Paramètres]

{#r_GlideFormAddErrorMessage_String__table_fyn_vnd_5s} {#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 6. Renvoie]

{#r_GlideFormAddErrorMessage_String__table_gyn_vnd_5s}  

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

## GlideForm : addFormMessage(message de chaîne, type de chaîne, options d'objet) {#ariaid-title5}

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()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-clearAllFormMessages "Supprime tous les messages de formulaire, quel que soit leur type.")
* [clearFormMessages()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-clearFormMessages_S "Supprime tous les messages de formulaire d’un type donné.")
{#GF-addFormMessage_S_S__ul_unz_vkt_4pb}
{#GF-addFormMessage_S_S__table_f2v_zym_4pb__entry__3}

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

{#GF-addFormMessage_S_S__table_f2v_zym_4pb} {#GF-addFormMessage_S_S__table_g2v_zym_4pb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 8. Renvoie]

{#GF-addFormMessage_S_S__table_g2v_zym_4pb}  
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) {#ariaid-title6}

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.
{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s__entry__3}

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

{#r_GlideFormAddInfoMessage_String__table_pcg_n4d_5s} {#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 10. Renvoie]

{#r_GlideFormAddInfoMessage_String__table_qcg_n4d_5s}  

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

## GlideForm : addOption(String fieldName, String choiceValue, String choiceLabel) {#ariaid-title7}

Ajoute un choix à la fin d'un champ de liste de choix.
{#r_GF-AddOption_S_S_S__table_omk_pgd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Valeur du choix | Chaîne | Valeur à stocker dans la base de données. |
| Étiquette de choix | Chaîne | La valeur affichée. |
[Tableau 11. Paramètres]

{#r_GF-AddOption_S_S_S__table_omk_pgd_5s} {#r_GF-AddOption_S_S_S__table_pmk_pgd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 12. Renvoie]

{#r_GF-AddOption_S_S_S__table_pmk_pgd_5s}  

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

## GlideForm : addOption(String fieldName, String choiceValue, String choiceLabel, Number choiceIndex) {#ariaid-title8}

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.
{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Valeur du choix | Chaîne | Valeur stockée dans la base de données. |
| Étiquette de choix | Chaîne | La valeur affichée. |
| Index de choix | Numéro | Ordre du choix dans la liste. L'index est dans un tableau de base zéro. |
[Tableau 13. Paramètres]

{#r_GlideForm-AddOption_S_S_S_N__table_k5s_qhd_5s} {#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 14. Renvoie]

{#r_GlideForm-AddOption_S_S_S_N__table_l5s_qhd_5s}  

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

## GlideForm : clearMessages() {#ariaid-title9}

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().
{#r_GlideFormClearMessages__table_krr_y4d_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 15. Paramètres]

{#r_GlideFormClearMessages__table_krr_y4d_5s} {#r_GlideFormClearMessages__table_lrr_y4d_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 16. Renvoie]

{#r_GlideFormClearMessages__table_lrr_y4d_5s}  

    g_form.clearMessages();

## GlideForm : clearAllFormMessages() {#ariaid-title10}

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

* [addFormMessage()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-addFormMessage_S_S "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.")
* [clearFormMessages()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-clearFormMessages_S "Supprime tous les messages de formulaire d’un type donné.")
{#GF-clearAllFormMessages__ul_unz_vkt_4pb}
{#GF-clearAllFormMessages__table_qpm_dzm_4pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 17. Paramètres]

{#GF-clearAllFormMessages__table_qpm_dzm_4pb} {#GF-clearAllFormMessages__table_rpm_dzm_4pb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 18. Renvoie]

{#GF-clearAllFormMessages__table_rpm_dzm_4pb}  
L'exemple suivant montre comment effacer tous les messages du formulaire.

    g_form.clearAllFormMessages();

## GlideForm : clearFormMessages (type de chaîne) {#ariaid-title11}

Supprime tous les messages de formulaire d'un type donné.
Voir aussi :

* [addFormMessage()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-addFormMessage_S_S "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.")
* [clearAllFormMessages()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-clearAllFormMessages "Supprime tous les messages de formulaire, quel que soit leur type.")
{#GF-clearFormMessages_S__ul_unz_vkt_4pb}
{#GF-clearFormMessages_S__table_ilw_bzm_4pb__entry__3}

| Nom | Type | Description |
|-|-|-|
| type | Chaîne | Le type de message. Valeurs valides : * erreur * infos * avertissement {#GF-clearFormMessages_S__ul_gzv_bbn_4pb} |
[Tableau 19. Paramètres]

{#GF-clearFormMessages_S__table_ilw_bzm_4pb} {#GF-clearFormMessages_S__table_jlw_bzm_4pb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 20. Renvoie]

{#GF-clearFormMessages_S__table_jlw_bzm_4pb}  
L'exemple suivant montre comment effacer tous les messages d'erreur du formulaire.

    g_form.clearFormMessages('error');

## GlideForm : clearOptions(String fieldName) {#ariaid-title12}

Supprime toutes les options de la liste de choix.
{#r_GlideFormClearOptions_String__table_bdt_v3d_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 21. Paramètres]

{#r_GlideFormClearOptions_String__table_bdt_v3d_5s} {#r_GlideFormClearOptions_String__table_cdt_v3d_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 22. Renvoie]

{#r_GlideFormClearOptions_String__table_cdt_v3d_5s}

## GlideForm : clearValue(String fieldName) {#ariaid-title13}

Supprime toute valeur du champ.
{#r_GlideFormClearValue_String__table_tlr_znc_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 23. Paramètres]

{#r_GlideFormClearValue_String__table_tlr_znc_5s} {#r_GlideFormClearValue_String__table_ulr_znc_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 24. Renvoie]

{#r_GlideFormClearValue_String__table_ulr_znc_5s}

## GlideForm : disableAttachments() {#ariaid-title14}

Empêche l'ajout de pièces jointes.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormDisableAttachments__table_ggk_bqd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 25. Paramètres]

{#r_GlideFormDisableAttachments__table_ggk_bqd_5s} {#r_GlideFormDisableAttachments__table_hgk_bqd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 26. Renvoie]

{#r_GlideFormDisableAttachments__table_hgk_bqd_5s}

## GlideForm : enableAttachments() {#ariaid-title15}

Permet d'ajouter des pièces jointes. Affiche l'icône de trombone.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormEnableAttachments__table_i3c_ppd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 27. Paramètres]

{#r_GlideFormEnableAttachments__table_i3c_ppd_5s} {#r_GlideFormEnableAttachments__table_j3c_ppd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 28. Renvoie]

{#r_GlideFormEnableAttachments__table_j3c_ppd_5s}

## GlideForm - flash(String fieldName, String color, Number count) {#ariaid-title16}

Utilisé pour attirer l'attention sur un champ particulier. Fait clignoter la couleur spécifiée pendant une durée spécifiée dans le champ spécifié.
Cette méthode n'est pas prise en charge par Catalogue de services.

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

| 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 {#r_GlideFormFlash_String_String_Number__ul_qcc_4fw_ts} |
[Tableau 29. Paramètres]

{#r_GlideFormFlash_String_String_Number__table_htn_w2w_ts} {#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 30. Renvoie]

{#r_GlideFormFlash_String_String_Number__table_itn_w2w_ts}  

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

## GlideForm : getActionName() {#ariaid-title17}

Renvoie le nom de l'action la plus récente ou, dans le cas d'un script client, le sys_id de l'action d'interface utilisateur sur laquelle vous avez cliqué.
Remarque :  
Non disponible dans les scripts clients de l'assistant.
{#r_GlideFormGetActionName__table_zhn_xjd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 31. Paramètres]

{#r_GlideFormGetActionName__table_zhn_xjd_5s} {#r_GlideFormGetActionName__table_a3n_xjd_5s__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom de l'action actuelle. |
[Tableau 32. Renvoie]

{#r_GlideFormGetActionName__table_a3n_xjd_5s}  

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

## GlideForm : getBooleanValue(String fieldName) {#ariaid-title18}

Renvoie une valeur booléenne pour le champ spécifié.
{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 33. Paramètres]

{#r_GlideFormGetBooleanValue_String__table_vfk_25b_5s} {#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur false si la valeur du champ est false ou non définie ; sinon, renvoie la valeur true. |
[Tableau 34. Renvoie]

{#r_GlideFormGetBooleanValue_String__table_wfk_25b_5s}

## GlideForm : getControl(String fieldName) {#ariaid-title19}

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

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

Cette méthode n'est pas disponible dans les scripts Mobile ou les scripts Service Portal.
{#r_GlideFormGetControl_String__table_lzt_x5b_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 35. Paramètres]

{#r_GlideFormGetControl_String__table_lzt_x5b_5s} {#r_GlideFormGetControl_String__table_mzt_x5b_5s__entry__2}

| Type | Description |
|-|-|
| HTMLElement | Élément HTML du champ. |
[Tableau 36. Renvoie]

{#r_GlideFormGetControl_String__table_mzt_x5b_5s}

## GlideForm : getDecimalValue(String fieldName) {#ariaid-title20}

Renvoie la valeur décimale du champ spécifié.
{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 37. Paramètres]

{#r_GlideFormGetDecimalValue_String__table_izt_31c_5s} {#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur décimale du champ spécifié. |
[Tableau 38. Renvoie]

{#r_GlideFormGetDecimalValue_String__table_jzt_31c_5s}  

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

## GlideForm : getDisplayBox(String fieldName) {#ariaid-title21}

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().](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-getDisplayValue_S "Obtient la valeur d’affichage d’un formulaire dans Portail de services.")  
Voir aussi :

* [getValue()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GlideFormGetValue_String "Renvoie la valeur du champ de formulaire spécifié.")
* [Obtenir la valeur d'affichage d'une variable de référence](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayBox_S__ul_djx_h4g_cvb}
{#GF-getDisplayBox_S__table_nf2_bfp_zw__entry__3}

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

{#GF-getDisplayBox_S__table_nf2_bfp_zw} {#GF-getDisplayBox_S__table_ydf_qpc_5s__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 40. Renvoie]

{#GF-getDisplayBox_S__table_ydf_qpc_5s}  

    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) {#ariaid-title22}

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().](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#GF-getDisplayBox_S "Obtient la valeur d’affichage à partir d’un formulaire dans l’interface utilisateur principale.")  
Voir aussi :

* [getValue()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GlideFormGetValue_String "Renvoie la valeur du champ de formulaire spécifié.")
* [Obtenir la valeur d'affichage d'une variable de référence](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763)
{#GF-getDisplayValue_S__ul_djx_h4g_cvb}  
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.
{#GF-getDisplayValue_S__table_nf2_bfp_zw__entry__3}

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

{#GF-getDisplayValue_S__table_nf2_bfp_zw} {#GF-getDisplayValue_S__table_ydf_qpc_5s__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 42. Renvoie]

{#GF-getDisplayValue_S__table_ydf_qpc_5s}  
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é](https://www.servicenow.com/community/developer-blog/get-display-value-of-reference-variable-service-catalog/ba-p/2287763) .

    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) {#ariaid-title23}

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.
{#r_GlideFormGetElement_String__table_l1k_vvb_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| id | Chaîne | ID du champ. |
[Tableau 43. Paramètres]

{#r_GlideFormGetElement_String__table_l1k_vvb_5s} {#r_GlideFormGetElement_String__table_m1k_vvb_5s__entry__2}

| Type | Description |
|-|-|
| HTMLElement | Élément HTML du champ. |
[Tableau 44. Renvoie]

{#r_GlideFormGetElement_String__table_m1k_vvb_5s}

## GlideForm : getFormElement() {#ariaid-title24}

Renvoie l'élément HTML du formulaire.
Cette méthode n'est pas disponible dans les scripts Mobile ou les scripts Service Portal.
{#r_GlideFormGetFormElement__table_fs4_kkd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 45. Paramètres]

{#r_GlideFormGetFormElement__table_fs4_kkd_5s} {#r_GlideFormGetFormElement__table_gs4_kkd_5s__entry__2}

| Type | Description |
|-|-|
| HTMLFormElement (en anglais seulement) | Élément HTML pour le formulaire. |
[Tableau 46. Renvoie]

{#r_GlideFormGetFormElement__table_gs4_kkd_5s}

## GlideForm : getHelpTextControl(String fieldName) {#ariaid-title25}

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.
{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 47. Paramètres]

{#r_GF-getHelpTextControl_S__table_nf2_bfp_zw} {#r_GF-getHelpTextControl_S__table_of2_bfp_zw__entry__2}

| Type | Description |
|-|-|
| HTMLElement | Élément HTML du champ de texte d'aide. |
[Tableau 48. Renvoie]

{#r_GF-getHelpTextControl_S__table_of2_bfp_zw}

## GlideForm : getIntValue (String fieldName) {#ariaid-title26}

Renvoie la valeur entière du champ.
{#r_GlideFormGetIntValue_String__table_unc_nwb_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 49. Paramètres]

{#r_GlideFormGetIntValue_String__table_unc_nwb_5s} {#r_GlideFormGetIntValue_String__table_vnc_nwb_5s__entry__2}

| Type | Description |
|-|-|
| Numéro | Valeur entière du champ. |
[Tableau 50. Renvoie]

{#r_GlideFormGetIntValue_String__table_vnc_nwb_5s}

## GlideForm : getLabelOf(String fieldName) {#ariaid-title27}

Renvoie la valeur en texte brut de l'étiquette de champ.
{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Le nom du champ |
[Tableau 51. Paramètres]

{#r_GlideFormGetLabelOf_String__table_gfz_kgw_ts} {#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts__entry__2}

| Type | Description |
|-|-|
| Chaîne | Le texte de l'étiquette. |
[Tableau 52. Renvoie]

{#r_GlideFormGetLabelOf_String__table_hfz_kgw_ts}  

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

## GlideForm : getOption(String fieldName, String choiceValue) {#ariaid-title28}

Renvoie l'élément d'option d'une zone sélectionnée nommée fieldName où choiceValue correspond la valeur d'option.
Remarque :  
Cette méthode ne fonctionne pas sur les champs en lecture seule.
{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Valeur du choix | Chaîne | Valeur de l'option. |
[Tableau 53. Paramètres]

{#r_GlideFormGetOption_String_String__table_u1p_1xb_5s} {#r_GlideFormGetOption_String_String__table_v1p_1xb_5s__entry__2}

| Type | Description |
|-|-|
| HTMLElement | Le HTMLElement de l'option. Renvoie null si le champ ou l'option est introuvable. |
[Tableau 54. Renvoie]

{#r_GlideFormGetOption_String_String__table_v1p_1xb_5s}  
L'exemple suivant montre comment obtenir l'étiquette pour une valeur de liste de choix.

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

## GlideForm : getReference(String fieldName, rappel de fonction) {#ariaid-title29}

Renvoie le GlideRecord pour un champ spécifié.
Si une fonction de rappel est présente, cette routine s'exécute de manière asynchrone. Le traitement du navigateur (et du script) se poursuit normalement jusqu'à ce que le serveur renvoie la valeur de référence, moment auquel la fonction de rappel est appelée. Si une fonction de rappel n'est pas présente, cette routine s'exécute de manière synchrone et le traitement s'arrête (ce qui donne l'impression que le navigateur se bloque) pendant l'attente d'une réponse du serveur.  
Important :  
Il est fortement recommandé d'utiliser une fonction de rappel.

La prise en charge de la fonction de rappel pour ServiceCatalogForm.getReference est disponible.  
Remarque :  
L'utilisation de cette méthode nécessite un appel au serveur, ce qui nécessite un temps supplémentaire et peut introduire une latence sur votre page. Utilisez cette méthode avec prudence. Pour plus d'informations, reportez-vous à [la section Conception et traitement d'un script client](https://www.servicenow.com/docs/access?context=client-script-best-practices&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US).
{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Rappel | Fonction | Nom de la fonction de rappel. |
[Tableau 55. Paramètres]

{#r_GlideForm-GetReference_S_F__table_k4c_1yb_5s} {#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s__entry__2}

| 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. |
[Tableau 56. Renvoie]

{#r_GlideForm-GetReference_S_F__table_l4c_1yb_5s}  

    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() {#ariaid-title30}

Renvoie un tableau de noms de listes connexes à partir du formulaire actuel.
{#GF-getRelatedListNames__table_vfp_grv_dhb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 57. Paramètres]

{#GF-getRelatedListNames__table_vfp_grv_dhb} {#GF-getRelatedListNames__table_wfp_grv_dhb__entry__2}

| 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. |
[Tableau 58. Renvoie]

{#GF-getRelatedListNames__table_wfp_grv_dhb}  

    var listNames = g_form.getRelatedListNames();

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

## GlideForm : getSectionNames() {#ariaid-title31}

Renvoie tous les noms de sections, qu'ils soient visibles ou non.
{#r_GlideFormGetSectionNames__table_rsg_vkd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 59. Paramètres]

{#r_GlideFormGetSectionNames__table_rsg_vkd_5s} {#r_GlideFormGetSectionNames__table_ssg_vkd_5s__entry__2}

| Type | Description |
|-|-|
| Tableau de chaînes | Les noms des sections. |
[Tableau 60. Renvoie]

{#r_GlideFormGetSectionNames__table_ssg_vkd_5s}

## GlideForm : getSections() {#ariaid-title32}

Renvoie un tableau des sections du formulaire.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormGetSections__table_sg4_hld_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 61. Paramètres]

{#r_GlideFormGetSections__table_sg4_hld_5s} {#r_GlideFormGetSections__table_tg4_hld_5s__entry__2}

| Type | Description |
|-|-|
| Tableau d'éléments HTML | Les sections du formulaire. |
[Tableau 62. Renvoie]

{#r_GlideFormGetSections__table_tg4_hld_5s}  

    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() {#ariaid-title33}

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().
{#r_GlideFormGetTableName__table_gqk_5ld_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 63. Paramètres]

{#r_GlideFormGetTableName__table_gqk_5ld_5s} {#r_GlideFormGetTableName__table_hqk_5ld_5s__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom de la table. |
[Tableau 64. Renvoie]

{#r_GlideFormGetTableName__table_hqk_5ld_5s}  

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

## GlideForm : getUniqueValue() {#ariaid-title34}

Renvoie le sys_id de l'enregistrement affiché dans le formulaire.
{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 65. Paramètres]

{#r_GlideFormGetUniqueValue__table_xxg_lmd_5s} {#r_GlideFormGetUniqueValue__table_yxg_lmd_5s__entry__2}

| Type | Description |
|-|-|
| Chaîne | Le sys_id de l'enregistrement. |
[Tableau 66. Renvoie]

{#r_GlideFormGetUniqueValue__table_yxg_lmd_5s}  

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

## GlideForm : getValue(String fieldName) {#ariaid-title35}

Renvoie la valeur du champ de formulaire spécifié.
Cette méthode permet également d'obtenir des valeurs à partir d'un jeu de variables à plusieurs lignes (MRVS). Pour obtenir des données à partir de champs au sein d'un MRVS, vous devez `d'abord utiliser JSON.parse(getValue('<mrvs_field_name>') || '[]')` pour obtenir le tableau MRVS, puis utilisez l'indexation pour accéder aux champs à l'intérieur des objets de ligne. Pour plus de détails, consultez l'exemple de code ci-dessous.
{#r_GlideFormGetValue_String__table_nxm_wzb_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ dont la valeur doit être renvoyée. |
[Tableau 67. Paramètres]

{#r_GlideFormGetValue_String__table_nxm_wzb_5s} {#r_GlideFormGetValue_String__table_oxm_wzb_5s__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur du champ spécifié. |
[Tableau 68. Renvoie]

{#r_GlideFormGetValue_String__table_oxm_wzb_5s}  
L'exemple suivant montre comment obtenir la description brève à partir du formulaire actuel.

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

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

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

## GlideForm : hideAllFieldMsgs() {#ariaid-title36}

Masque tous les messages de champ.
{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 69. Paramètres]

{#r_GlideFormHideAllFieldMsgs__table_mr1_3hw_ts} {#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 70. Renvoie]

{#r_GlideFormHideAllFieldMsgs__table_nr1_3hw_ts}

## GlideForm : hideAllFieldMsgs (type de chaîne) {#ariaid-title37}

Masque tous les messages de champ du type spécifié.
{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| type | Chaîne | Le type de message. Valeurs valides : * erreur * infos {#r_GlideFormHideAllFieldMsgs_String__ul_gzv_bbn_4pb} |
[Tableau 71. Paramètres]

{#r_GlideFormHideAllFieldMsgs_String__table_y2c_qhw_ts} {#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 72. Renvoie]

{#r_GlideFormHideAllFieldMsgs_String__table_z2c_qhw_ts}

## GlideForm : hideErrorBox(String fieldName) {#ariaid-title38}

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.
{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ ou du contrôle. |
[Tableau 73. Paramètres]

{#r_GlideFormHideErrorBox_String__table_kll_t4w_ts} {#r_GlideFormHideErrorBox_String__table_lll_t4w_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 74. Renvoie]

{#r_GlideFormHideErrorBox_String__table_lll_t4w_ts}

## GlideForm : hideFieldMsg(String fieldName, booléen clearAll) {#ariaid-title39}

Masque le premier message qui apparaît dans le champ spécifié du formulaire actuel.
Utilisez les [GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne)](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GF-ShowFieldMsg_S_S_S "Affiche un message d’information ou d’erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le champ ou le champ n’apparaît pas à l’écran, le formulaire défile jusqu’au champ.") méthodes ou [GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne, défilement booléen)](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GF-ShowFieldMsg_S_S_S_B "Affiche un message d’information ou d’erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le contrôle ou le champ n’est pas affiché et que scrollForm a la valeur vrai, le formulaire bascule jusqu’au champ.") pour afficher des messages sur un formulaire.  
Par exemple, l'extrait de code suivant montre comment afficher deux messages dans le champ `work_notes` d'un formulaire, puis masquer le premier message :

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

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ dans lequel masquer le message. |
| Tout effacer | Booléen | Facultatif. Marqueur indiquant s'il faut masquer tous les messages pour le champ spécifié. Valeurs valides : * true : Masquer tous les messages. * false : masquer uniquement le premier message affiché. Valeur par défaut : false |
[Tableau 75. Paramètres]

{#r_GlideFormHideFieldMsg_String__table_xnf_3pw_ts} {#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 76. Renvoie]

{#r_GlideFormHideFieldMsg_String__table_ynf_3pw_ts}  
L'exemple suivant montre comment effacer tous les messages pour un champ de formulaire spécifié, puis afficher un message d'erreur de chiffrement.

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

## GlideForm : hideFieldMsg(String fieldName, booléen clearAll) {#ariaid-title40}

Masque les messages placés par showFieldMsg().
{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Tout effacer | Booléen | Si la valeur est vrai, tous les messages du champ sont effacés. Si la valeur est false, seul le dernier message est supprimé. |
[Tableau 77. Paramètres]

{#r_GlideForm-HideFieldMsg_S_B__table_gvy_vpw_ts} {#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 78. Renvoie]

{#r_GlideForm-HideFieldMsg_S_B__table_hvy_vpw_ts}  

    g_form.hideFieldMsg('impact', true);

## GlideForm : hideRelatedList(String listTableName) {#ariaid-title41}

Masque la liste connexe spécifiée sur le formulaire.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| listTableName (en anglais seulement) | Chaîne | Nom de la liste connexe. Utilisez le sys_id pour masquer une liste par le biais d'une relation. |
[Tableau 79. Paramètres]

{#r_GlideFormHideRelatedList_String__table_syn_wqw_ts} {#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 80. Renvoie]

{#r_GlideFormHideRelatedList_String__table_tyn_wqw_ts}

## GlideForm : hideRelatedLists() {#ariaid-title42}

Masque toutes les listes connexes du formulaire.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 81. Paramètres]

{#r_GlideFormHideRelatedLists__table_zmg_jrw_ts} {#r_GlideFormHideRelatedLists__table_ang_jrw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 82. Renvoie]

{#r_GlideFormHideRelatedLists__table_ang_jrw_ts}

## GlideForm : isLiveUpdating() {#ariaid-title43}

Renvoie la valeur true lorsqu'une mise à jour active est en cours sur l'enregistrement affiché par le formulaire.
Cela peut être utilisé dans un script client onChange() pour déterminer si une modification de l'enregistrement est due à une mise à jour en direct d'une autre session. Le script client peut alors décider de l'action à entreprendre ou de ne pas entreprendre. Cela s'applique aux systèmes utilisant des Interface utilisateur principale formulaires actifs activés.
{#r_GF-isLiveUpdating__table_fjz_sks_kx__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 83. Paramètres]

{#r_GF-isLiveUpdating__table_fjz_sks_kx} {#r_GF-isLiveUpdating__table_gjz_sks_kx__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si une mise à jour active est en cours sur l'enregistrement affiché par le formulaire. |
[Tableau 84. Renvoie]

{#r_GF-isLiveUpdating__table_gjz_sks_kx}

## GlideForm : isMandatory(String fieldName) {#ariaid-title44}

Renvoie la valeur true si le champ est obligatoire.
{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
[Tableau 85. Paramètres]

{#r_GlideFormIsMandatory_String__table_kpt_nnc_5s} {#r_GlideFormIsMandatory_String__table_lpt_nnc_5s__entry__2}

| Type | Description |
|-|-|
| Booléen | Vrai si le champ est obligatoire, faux dans les autres cas. |
[Tableau 86. Renvoie]

{#r_GlideFormIsMandatory_String__table_lpt_nnc_5s}

## GlideForm : isNewRecord() {#ariaid-title45}

Renvoie la valeur true si l'enregistrement n'a jamais été enregistré.
{#r_GlideFormIsNewRecord__table_wlm_wmd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 87. Paramètres]

{#r_GlideFormIsNewRecord__table_wlm_wmd_5s} {#r_GlideFormIsNewRecord__table_xlm_wmd_5s__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si l'enregistrement n'a pas été sauvegardé ; Sinon, c'est faux. |
[Tableau 88. Renvoie]

{#r_GlideFormIsNewRecord__table_xlm_wmd_5s}  

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

## GlideForm : isSectionVisible (String sectionName) {#ariaid-title46}

Renvoie la valeur true si la section est visible.
Important :  
La fonction isSectionVisible() n'est pas prise en charge dans Workspace.
{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 89. Paramètres]

{#r_GlideFormIsSectionVisible_String__table_msy_jnd_5s} {#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true lorsque la section est visible ; Dans le cas contraire, la valeur false est renvoyée. |
[Tableau 90. Renvoie]

{#r_GlideFormIsSectionVisible_String__table_nsy_jnd_5s}

## GlideForm : onUserChangeValue(Function fn) {#ariaid-title47}

Enregistre un écouteur d'événement personnalisé qui détecte quand un champ du formulaire actuel est modifié par un utilisateur.
Lorsqu'un champ de formulaire est modifié, l'écouteur d'événements appelle la fonction transmise lors de l'enregistrement initial de l'écouteur. Cet écouteur est uniquement déclenché lorsqu'un utilisateur apporte une modification à un champ du formulaire. Les modifications apportées aux scripts clients, aux politiques d'interface utilisateur ou à toute autre interaction non-utilisateur ne déclenchent pas l'écouteur.  
Remarque :  
Cette méthode ne fonctionne pas pour les champs ou Catalogue de services éléments de journal dans l'environnement classique.
{#GF-onUserChangeValue_F__table_m5y_wll_1hb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fn | Fonction | Fonction à appeler lorsqu'un utilisateur modifie la valeur d'un champ dans le formulaire actuel. Il s'agit en fait du code de la fonction, pas seulement du nom de la fonction. Cette fonction doit accepter les trois arguments suivants : * Nom de champ * Valeur d'origine du champ * Valeur de champ mise à jour {#GF-onUserChangeValue_F__ul_fnz_j4l_1hb} |
[Tableau 91. Paramètres]

{#GF-onUserChangeValue_F__table_m5y_wll_1hb} {#GF-onUserChangeValue_F__table_n5y_wll_1hb__entry__2}

| Type | Description |
|-|-|
| Fonction | Fonction à appeler pour annuler l'inscription de l'écouteur d'événements onUserChangeValue. |
[Tableau 92. Renvoie]

{#GF-onUserChangeValue_F__table_n5y_wll_1hb}  

    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) {#ariaid-title48}

Vous pouvez mettre à jour une variable de collecteur de liste.
{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom de la zone de liste double. |
[Tableau 93. Paramètres]

{#r_GF-refreshSlushbucket_S__table_n3v_plp_cv} {#r_GF-refreshSlushbucket_S__table_o3v_plp_cv__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 94. Renvoie]

{#r_GF-refreshSlushbucket_S__table_o3v_plp_cv}  

    g_form.refreshSlushbucket('bucket');

## GlideForm - removeDecoration(nom de champ de chaîne, icône de chaîne, titre de chaîne) {#ariaid-title49}

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.
{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom de champ. |
| icône | Chaîne | Nom de l'icône à supprimer. |
| Titre | Chaîne | Le texte de l'icône, le titre (nom). |
[Tableau 95. Paramètres]

{#r_GF-RemoveDecoration_S_S_S__table_x23_vrw_ts} {#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 96. Renvoie]

{#r_GF-RemoveDecoration_S_S_S__table_y23_vrw_ts}  

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

## GlideForm - removeDecoration(nom de champ de chaîne, icône de chaîne, titre de la chaîne, couleur de la chaîne) {#ariaid-title50}

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.
{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom de champ. |
| icône | Chaîne | Nom de l'icône à supprimer. |
| Titre | Chaîne | Le texte de l'icône, le titre (nom). |
| couleur | Chaîne | Une couleur CSS |
[Tableau 97. Paramètres]

{#r_GF-RemoveDecoration_S_S_S_S__table_mcg_5zd_5s} {#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 98. Renvoie]

{#r_GF-RemoveDecoration_S_S_S_S__table_ncg_5zd_5s}  

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

## GlideForm : removeOption(String fieldName, String choiceValue) {#ariaid-title51}

Supprime l'option spécifiée de la liste de choix.
{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Valeur du choix | Chaîne | Valeur stockée dans la base de données. Ce n'est pas l'étiquette. |
[Tableau 99. Paramètres]

{#r_GlideFormRemoveOption_String_String__table_p4k_hjd_5s} {#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 100. Renvoie]

{#r_GlideFormRemoveOption_String_String__table_q4k_hjd_5s}  

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

## GlideForm - save() {#ariaid-title52}

Enregistre l'enregistrement sans naviguer (mettre à jour et rester).
{#r_GlideFormSave__table_xgb_3qd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 101. Paramètres]

{#r_GlideFormSave__table_xgb_3qd_5s} {#r_GlideFormSave__table_ygb_3qd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 102. Renvoie]

{#r_GlideFormSave__table_ygb_3qd_5s}

## GlideForm : setMandatory(String fieldName, booléen obligatoire) {#ariaid-title53}

Rend le champ spécifié obligatoire.
Dans la mesure du possible, utilisez une politique d'interface utilisateur plutôt que cette méthode.
{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| obligatoire | Booléen | Si la valeur est vrai, le champ est obligatoire. Si la valeur est définie sur faux, le champ est facultatif. |
[Tableau 103. Paramètres]

{#r_GF-SetMandatory_S_B__table_xnx_z4c_5s} {#r_GF-SetMandatory_S_B__table_ynx_z4c_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 104. Renvoie]

{#r_GF-SetMandatory_S_B__table_ynx_z4c_5s}

## GlideForm : setSectionDisplay(String sectionName, affichage booléen) {#ariaid-title54}

Affiche ou masque une section.
{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s__entry__3}

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

{#r_GF-SetSectionDisplay_S_B__table_pqq_qqd_5s} {#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s__entry__2}

| Type | Description |
|-|-|
| Booléen | En cas de réussite, renvoie la valeur vrai. |
[Tableau 106. Renvoie]

{#r_GF-SetSectionDisplay_S_B__table_qqq_qqd_5s}

## GlideForm : setValue(String fieldName, String value, String displayValue) {#ariaid-title55}

Définit la valeur d'un champ de formulaire spécifié sur la valeur d'une valeur d'affichage spécifiée dans un enregistrement de référence.
Pour améliorer les performances en empêchant un aller-retour lors de la définition de la valeur d'un champ de référence, utilisez cette méthode, et non setValue(fieldName, value). Lors de la définition de plusieurs valeurs de référence pour un champ de collecteur de liste, transmettez des tableaux dans les value paramètres and displayValue .  
Remarque :  
La méthode setValue() peut provoquer un débordement de la pile lorsqu'elle est utilisée dans un script client OnChange. Cela est dû au fait qu'à chaque fois que la valeur est définie, elle est enregistrée comme un changement, ce qui peut redéclencher le script client OnChange. Pour éviter cela, effectuez une vérification qui validera que la nouvelle valeur sera différente de l'ancienne. Par exemple, avant d'exécuter `setValue(shortDesc, newValue.toUpperCase()) ;`, validez que la description brève n'est pas déjà en majuscules. Cela empêchera le script client d'appliquer toUpperCase() plus d'une fois.
{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ de formulaire à mettre à jour. |
| valide | Chaîne ou tableau | Sys_id de l'enregistrement de référence à utiliser pour mettre à jour le champ. Si le champ spécifié est une GlideList, ce paramètre peut contenir un tableau de sys_ids. Dans ce cas, la méthode effectue une recherche de tous les enregistrements spécifiés dans le tableau et ces valeurs sont utilisées pour mettre à jour le contenu du champ spécifié (liste connexe). Remarque : Lors de la définition d'une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l'étiquette. |
| displayValue | Chaîne ou tableau | Champ dans l'enregistrement de référence spécifié, à utiliser pour mettre à jour le champ spécifié. Par exemple, dans la table Utilisateur \[sys_user\], il peut s'agir du nom de l'utilisateur. Si le champ spécifié est une GlideList, ce paramètre peut contenir un tableau de noms de valeurs d'affichage. Pour plus d'informations sur les valeurs d'affichage, reportez-vous à [la rubrique Valeur d'affichage](https://www.servicenow.com/docs/access?context=c_DisplayValues&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). |
[Tableau 107. Paramètres]

{#r_GlideForm-SetValue_S_S_S__table_oxn_vrc_5s} {#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 108. Renvoie]

{#r_GlideForm-SetValue_S_S_S__table_pxn_vrc_5s}  
Cet exemple montre le passage de la sys_id de l'enregistrement de référence qui contient le champ userName à utiliser pour mettre à jour le champ de formulaire assigned_to .

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

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

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

## GlideForm : showErrorBox(nom de chaîne, message de chaîne, scrollForm booléen) {#ariaid-title56}

Affiche un message d'erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit le nom du champ). Si le contrôle ou le champ n'est pas affiché et que le paramètre scrollForm est défini sur true, le formulaire défile jusqu'au contrôle ou au champ.
Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n'est pas à l'écran (fait défiler le formulaire vers le contrôle ou le champ). La méthode showFieldMsg() est une méthode similaire qui nécessite un paramètre type.
{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du champ ou du contrôle. |
| message | Chaîne | Message à afficher. |
| scrollForm | Booléen | Si la valeur est \<\< vrai \>\>, le formulaire fait défiler jusqu'au champ. Si la valeur est définie sur false, le formulaire ne défile pas jusqu'au champ. |
[Tableau 109. Paramètres]

{#r_GF-ShowErrorBox_S_S_B__table_lyr_dww_ts} {#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 110. Renvoie]

{#r_GF-ShowErrorBox_S_S_B__table_myr_dww_ts}

## GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne) {#ariaid-title57}

Affiche un message d'information ou d'erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le champ ou le champ n'apparaît pas à l'écran, le formulaire défile jusqu'au champ.
Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n'est pas à l'écran (fait défiler le formulaire vers le contrôle ou le champ).

La méthode showErrorBox() est une méthode abrégée qui ne nécessite pas le paramètre type.  
Remarque :  
Cette méthode ne fonctionne pas avec le champ type journal_field dans Interface utilisateur principale.
{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts__entry__3}

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

{#r_GF-ShowFieldMsg_S_S_S__table_u3z_hxw_ts} {#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 112. Renvoie]

{#r_GF-ShowFieldMsg_S_S_S__table_v3z_hxw_ts}  

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

## GlideForm : showFieldMsg(champ de chaîne, message de chaîne, type de chaîne, défilement booléen) {#ariaid-title58}

Affiche un message d'information ou d'erreur sous le champ de formulaire spécifié (un objet de contrôle ou le nom du champ). Si le contrôle ou le champ n'est pas affiché et que scrollForm a la valeur vrai, le formulaire bascule jusqu'au champ.
Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n'est pas à l'écran (fait défiler le formulaire vers le contrôle ou le champ).

La méthode showErrorBox() est une méthode abrégée qui ne nécessite pas le paramètre type.  
Remarque :  
Cette méthode ne fonctionne pas avec le champ type journal_field dans Interface utilisateur principale.
{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| champ | Chaîne | Nom du champ ou du contrôle. |
| message | Chaîne | Message à afficher. |
| type | Chaîne | \<\< erreur \>\>, \<\< info \>\> ou \<\< avertissement \>\>. |
| scrollForm | Booléen | Si la valeur est \<\< vrai \>\>, le formulaire défile jusqu'au champ s'il est hors écran. Si la valeur est \<\< faux \>\>, le formulaire ne défile pas. |
[Tableau 113. Paramètres]

{#r_GF-ShowFieldMsg_S_S_S_B__table_wmr_gyw_ts} {#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 114. Renvoie]

{#r_GF-ShowFieldMsg_S_S_S_B__table_xmr_gyw_ts}  

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

## GlideForm : setDisabled(String fieldName, Boolean disable) {#ariaid-title59}

Rend le champ spécifié disponible ou indisponible.
{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| Désactiver | Booléen | Si la valeur est vrai, le champ est désactivé. Si la valeur est définie sur false, le champ est activé. |
[Tableau 115. Paramètres]

{#r_GlideFormSetDisabled_String_Boolean__table_sn2_j4c_5s} {#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 116. Renvoie]

{#r_GlideFormSetDisabled_String_Boolean__table_tn2_j4c_5s}

## GlideForm : setDisplay(String fieldName, affichage booléen) {#ariaid-title60}

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.
{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Nom de champ | Chaîne | Nom du champ. |
| affichage | Booléen | Si la valeur est vrai, affiche le champ, si la valeur est faux, elle masque le champ. |
[Tableau 117. Paramètres]

{#r_GlideFormSetDisplay_String_Boolean__table_k4d_ctw_ts} {#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 118. Renvoie]

{#r_GlideFormSetDisplay_String_Boolean__table_l4d_ctw_ts}  

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

## GlideForm : setLabelOf(String fieldName, étiquette de chaîne) {#ariaid-title61}

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.
{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| étiquette | Chaîne | Étiquette de texte du champ. |
[Tableau 119. Paramètres]

{#r_GlideFormSetLabelOf_String_String__table_h5q_ytw_ts} {#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 120. Renvoie]

{#r_GlideFormSetLabelOf_String_String__table_i5q_ytw_ts}  

    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) {#ariaid-title62}

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()](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GlideFormSetValue_String_String "Définit la valeur d’un champ de formulaire spécifié sur la valeur transmise.") pour mettre à jour la valeur de ce champ. Si vous devez définir la valeur de cette façon, vous devez définir la valeur readOnly sur faux.
{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| readOnly | Booléen | Marqueur qui détermine si le champ associé est modifiable ou en lecture seule. Valeurs possibles : * vrai : définir le champ sur lecture seule * false : définir le champ à modifier {#r_GlideFormSetReadOnly_String_Boolean__ul_ah1_bkw_yqb} |
[Tableau 121. Paramètres]

{#r_GlideFormSetReadOnly_String_Boolean__table_xdf_qpc_5s} {#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 122. Renvoie]

{#r_GlideFormSetReadOnly_String_Boolean__table_ydf_qpc_5s}  
L'exemple suivant montre comment définir l'éditeur de variable en lecture seule. Pour ce faire dans Catalogue de services les tables, utilisez setVariablesReadOnly().

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

## GlideForm : setValue(String, fieldName, valeur de chaîne) {#ariaid-title63}

Définit la valeur d'un champ de formulaire spécifié sur la valeur transmise.
Cette méthode prend également en charge la définition des valeurs dans un jeu de variables à plusieurs lignes (MRVS). Vous devez `d'abord utiliser JSON.parse(getValue('<mrvs_field_name>'))` pour obtenir le tableau MRVS, puis utiliser l'indexation pour mettre à jour les champs dans les objets ligne. Une fois que toutes les valeurs sont mises à jour dans le MRVS, utilisez la méthode setValue() pour enregistrer le tableau MRVS mis à jour. Pour plus de détails, consultez l'exemple de code ci-dessous.  
Remarque :  
La méthode setValue() peut provoquer un débordement de la pile lorsqu'elle est utilisée dans un script client OnChange. Cela est dû au fait qu'à chaque fois que la valeur est définie, elle est enregistrée comme un changement, ce qui peut redéclencher le script client OnChange. Pour éviter cela, effectuez une vérification qui validera que la nouvelle valeur sera différente de l'ancienne. Par exemple, avant d'exécuter `setValue(shortDesc, newValue.toUpperCase()) ;`, validez que la description brève n'est pas déjà en majuscules. Cela empêchera le script client d'appliquer toUpperCase() plus d'une fois.  
Remarque :  
Lors de la définition d'une valeur dans une liste de choix, veillez à utiliser la valeur numérique plutôt que l'étiquette.
{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s__entry__3}

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

{#r_GlideFormSetValue_String_String__table_bqz_pqc_5s} {#r_GlideFormSetValue_String_String__table_cqz_pqc_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 124. Renvoie]

{#r_GlideFormSetValue_String_String__table_cqz_pqc_5s}  
L'exemple suivant montre comment définir la description brève dans le formulaire actuel.

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

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

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

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

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

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

## GlideForm : setVariablesReadOnly(booléen isReadOnly) {#ariaid-title64}

Met un éditeur de Catalogue de services variable en lecture seule.
Remarque :  
Cette méthode est uniquement applicable aux éditeurs de Catalogue de services variables dans l'interface utilisateur principale. Cette méthode n'est pas prise en charge dans le Catalogue de services formulaire.

La méthode doit être placée dans le script client de la table dans laquelle l'éditeur de variable est ajouté, par exemple Élément demandé \[sc_req_item\], Incident \[incident\], etc. Pour définir des variables en lecture seule dans d'autres tables, utilisez la méthode [setReadOnly().](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#r_GlideFormSetReadOnly_String_Boolean "Rend le champ spécifié en lecture seule ou modifiable.")

Voir aussi : [Éditeurs de variables de Service Catalog](https://www.servicenow.com/docs/access?context=service-catalog-variable-editor&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| isReadOnly | Booléen | Marqueur qui détermine si l'éditeur de variable est en lecture seule. Valeurs possibles : * true : définit l'éditeur de variables en lecture seule. * false : définit l'éditeur de variable comme modifiable. {#GF-setVariablesReadOnly_B__ul_ah1_bkw_yqb} Valeur par défaut : false |
[Tableau 125. Paramètres]

{#GF-setVariablesReadOnly_B__table_xdf_qpc_5s} {#GF-setVariablesReadOnly_B__table_ydf_qpc_5s__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 126. Renvoie]

{#GF-setVariablesReadOnly_B__table_ydf_qpc_5s}  
L'ajout de la ligne suivante à un script client entraîne la lecture seule de l'éditeur de variables.

    g_form.setVariablesReadOnly(true);

## GlideForm : setVisible(String fieldName, affichage booléen) {#ariaid-title65}

Affiche ou masque le champ.
Sur l'interface utilisateur de bureau, l'espace est laissé vide lorsqu'il est masqué. Sur l'interface utilisateur Mobile ou du portail de services, l'espace est rempli dans mes autres champs lorsqu'ils sont masqués. Cette méthode ne peut pas masquer les champs obligatoires sans valeur.

Dans la mesure du possible, utilisez la politique d'interface utilisateur plutôt que cette méthode.
{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| affichage | Booléen | Si la valeur est vraie, le champ s'affiche. Si la valeur est définie sur faux, le champ est masqué. |
[Tableau 127. Paramètres]

{#r_GlideFormSetVisible_String_Boolean__table_k24_45w_ts} {#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 128. Renvoie]

{#r_GlideFormSetVisible_String_Boolean__table_l24_45w_ts}  

    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) {#ariaid-title66}

Affiche un message d'erreur sous le champ de formulaire spécifié (soit un objet de contrôle, soit le nom du champ). Si le contrôle ou le champ n'est pas affiché à l'écran, le formulaire défile jusqu'au contrôle ou au champ.
Une propriété globale (glide.ui.scroll_to_message_field) est disponible pour contrôler le défilement automatique des messages lorsque le champ de formulaire n'est pas à l'écran (fait défiler le formulaire vers le contrôle ou le champ). La méthode showFieldMsg() est une méthode similaire qui nécessite un paramètre type.
{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du contrôle ou du champ. |
| message | Chaîne | Le message à afficher. |
[Tableau 129. Paramètres]

{#r_GlideFormShowErrorBox_String_String__table_rxv_2vw_ts} {#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 130. Renvoie]

{#r_GlideFormShowErrorBox_String_String__table_sxv_2vw_ts}

## GlideForm : showRelatedList(String listTableName) {#ariaid-title67}

Affiche la liste connexe spécifiée sur le formulaire.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| listTableName (en anglais seulement) | Chaîne | Nom de la liste connexe. |
[Tableau 131. Paramètres]

{#r_GlideFormShowRelatedList_String__table_mps_2zw_ts} {#r_GlideFormShowRelatedList_String__table_nps_2zw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 132. Renvoie]

{#r_GlideFormShowRelatedList_String__table_nps_2zw_ts}

## GlideForm : showRelatedLists() {#ariaid-title68}

Affiche toutes les listes connexes du formulaire.
Cette méthode n'est pas disponible sur la plateforme mobile. Si cette méthode est exécutée sur une plate-forme mobile, aucune action ne se produit.
{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 133. Paramètres]

{#r_GlideFormShowRelatedLists__table_jcj_rzw_ts} {#r_GlideFormShowRelatedLists__table_kcj_rzw_ts__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 134. Renvoie]

{#r_GlideFormShowRelatedLists__table_kcj_rzw_ts}

## GlideForm : submit() {#ariaid-title69}

Enregistre l'enregistrement.
L'utilisateur est retiré du formulaire et renvoyé à l'endroit où il se trouvait.
{#r_GlideFormSubmit__table_nhk_grd_5s__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 135. Paramètres]

{#r_GlideFormSubmit__table_nhk_grd_5s} {#r_GlideFormSubmit__table_ohk_grd_5s__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 136. Renvoie]

{#r_GlideFormSubmit__table_ohk_grd_5s}

## GlideForm : submit(verbe à chaînes) {#ariaid-title70}

Exécute l'action d'interface utilisateur spécifiée par le paramètre.
{#GF-submit_S__table_o1z_d3p_qx__entry__3}

| Nom | Type | Description |
|-|-|-|
| verbe | Chaîne | Un action_name à partir d'un enregistrement sys_ui_action. Le nom de l'action doit être celui d'un bouton de formulaire visible. |
[Tableau 137. Paramètres]

{#GF-submit_S__table_o1z_d3p_qx} {#GF-submit_S__table_p1z_d3p_qx__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 138. Renvoie]

{#GF-submit_S__table_p1z_d3p_qx}