GlideForm mobile (g_form) : client

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 appareil mobile.

MobileGlideForm (g_form) : addDecoration(Nom de champ de chaîne, icône de chaîne, texte de chaîne)

Ajoute une icône décorative en regard d’un champ.

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.
Texte	Chaîne	Titre de texte de l’icône (utilisé pour les lecteurs d’écran).

Tableau 2. Renvoie

Type	Description
nul

Cet exemple ajoute une icône VIP à 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)

Obtient le texte de l’étiquette du formulaire.

Tableau 3. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.

Tableau 4. Renvoie

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

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

MobileGlideForm (g_form) : hasField(String fieldName)

Détermine si un champ est présent sur le formulaire.

Présent signifie qu’il peut être affiché, pas qu’il est visible.

Tableau 5. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le champ à rechercher.

Tableau 6. Renvoie

Type	Description
Booléen	Vrai si le champ est présent sur le formulaire ; faux, si ce n’est pas le cas. Sur le formulaire signifie que le champ fait partie de g_form. Il peut toujours être masqué, en lecture seule, obligatoire ou non valide.

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, String icon, String text)

Supprime une icône décorative à côté d’un champ.

Tableau 7. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
icône	Chaîne	L’icône à supprimer.
Texte	Chaîne	Le titre de texte de l’icône.

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

MobileGlideForm (g_form) : setLabel(String fieldName, String label)

Définit le texte de l’étiquette du formulaire.

Tableau 9. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Nom du champ.
étiquette	Chaîne	Le texte de l’étiquette du champ.

Tableau 10. Renvoie

Type	Description
nul

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