Mobile GlideForm (g_form) - Client

Les méthodes Mobile GlideForm (g_form) vous permettent d’utiliser des formulaires sur Mobile Platform.

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

MobileGlideForm (g_form) - addDecoration(String fieldName, String icon, String text)

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

Tableau 1. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le nom du champ.
icône	Chaîne	Icône de police à afficher à côté du champ.
Texte	Chaîne	Le 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	Le 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	Champ à rechercher.

Tableau 6. Renvoie

Type	Description
Booléen	Vrai si le champ est présent sur le formulaire ; false, 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 est 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	Le nom du champ.
icône	Chaîne	L’icône à supprimer.
Texte	Chaîne	Le 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, String label)

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

Tableau 9. Paramètres

Nom	Type	Description
Fieldname	Chaîne	Le nom du champ.
étiquette	Chaîne	Texte de l’étiquette de 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)');
      }