---
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 mobile (g_form) : client

# GlideForm mobile (g_form) : client {#ariaid-title1}

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

L'API Mobile GlideForm (g_form) fournit des méthodes pour travailler avec des formulaires sur la plateforme mobile.

Utilisez ces méthodes dans n'importe quel script qui cible un équipement mobile.

## MobileGlideForm (g_form) : addDecoration(String fieldName, icône de chaîne, texte de chaîne) {#ariaid-title2}

Ajoute une icône décorative à côté d'un champ.
{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| icône | Chaîne | Icône de police à afficher à côté du champ. |
| Texte | Chaîne | Titre de texte de l'icône (utilisé pour les lecteurs d'écran). |
[Tableau 1. Paramètres]

{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt} {#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt__entry__2}

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

{#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt}  
Dans cet exemple, une icône VIP est ajoutée à côté de l'appelant.

    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');			
          });
          }

## MobileGlideForm (g_form) : getLabel(String fieldName) {#ariaid-title3}

Obtient le texte de l'étiquette du formulaire.
{#r_MGF-getLabel_S__table_jbc_4dw_mt__entry__3}

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

{#r_MGF-getLabel_S__table_jbc_4dw_mt} {#r_MGF-getLabel_S__table_kbc_4dw_mt__entry__2}

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

{#r_MGF-getLabel_S__table_kbc_4dw_mt}  

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

## MobileGlideForm (g_form) : hasField(String fieldName) {#ariaid-title4}

Détermine si un champ est présent sur le formulaire.
Présent signifie qu'il peut être montré, pas qu'il est visible.
{#r_MGF-hasField_S__table_lbc_4dw_mt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Le champ à rechercher. |
[Tableau 5. Paramètres]

{#r_MGF-hasField_S__table_lbc_4dw_mt} {#r_MGF-hasField_S__table_mbc_4dw_mt__entry__2}

| Type | Description |
|-|-|
| Booléen | Vrai si le champ est présent sur le formulaire ; faux, s'il ne l'est pas. Sur le formulaire signifie que le champ fait partie de g_form. Il peut toujours être masqué, en lecture seule, obligatoire ou non valide. |
[Tableau 6. Renvoie]

{#r_MGF-hasField_S__table_mbc_4dw_mt}  
Cet exemple rend le champ assigned_to obligatoire si le champ assignment_group se trouve sur le formulaire.

    if (g_form.hasField('assignment_group'))
          g_form.setMandatory('assigned_to', true);
        
## MobileGlideForm (g_form) - removeDecoration(String fieldName, icône de chaîne, texte de chaîne) {#ariaid-title5}

Supprime une icône décorative à côté d'un champ.
{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| icône | Chaîne | Icône à supprimer. |
| Texte | Chaîne | Titre textuel de l'icône. |
[Tableau 7. Paramètres]

{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt} {#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt__entry__2}

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

{#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt}  

    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');			
          });
          }

## MobileGlideForm (g_form) : setLabel(String fieldName, étiquette de chaîne) {#ariaid-title6}

Définit le texte de l'étiquette du formulaire.
{#r_MGF-setLabel_S_S__table_fbc_4dw_mt__entry__3}

| Nom | Type | Description |
|-|-|-|
| Fieldname | Chaîne | Nom du champ. |
| étiquette | Chaîne | Texte de l'étiquette du champ. |
[Tableau 9. Paramètres]

{#r_MGF-setLabel_S_S__table_fbc_4dw_mt} {#r_MGF-setLabel_S_S__table_gbc_4dw_mt__entry__2}

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

{#r_MGF-setLabel_S_S__table_gbc_4dw_mt}  
Cet exemple modifie l'étiquette des commentaires.

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