GlideForm mobile (g_form) : client

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’API Mobile GlideForm (g_form) fournit des méthodes d’utilisation des formulaires sur la plateforme mobile.

    Utilisez ces méthodes dans tout script qui cible un équipement 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 Le titre du texte de l’icône (utilisé pour les lecteurs d’écran).
    Tableau 2. Renvoie
    Type Description
    nul

    Cet exemple ajoute une icône VIP en regard 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(nom du champ de chaîne)

    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 True 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. Elle peut toujours être masquée, 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(nom de champ de chaîne, icône de chaîne, texte de chaîne)

    Supprime une icône décorative située en regard 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 Le titre du 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)');
      }