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 équipement mobile.

MobileGlideForm (g_form) : addDecoration(String fieldName, icône de chaîne, texte de chaîne)

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

Tableau 1. Paramètres

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 2. Renvoie

Type	Description
nul

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)

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	Le 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 montré, 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, 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.

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)

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	Icône à supprimer.
Texte	Chaîne	Titre textuel 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, étiquette de chaîne)

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