Mobile GlideForm (g_form) : Client

Die Mobile GlideForm-API (g_form) bietet Methoden zum Arbeiten mit Formularen auf der mobilen Plattform.

Verwenden Sie diese Methoden in jedem Skript, das auf ein mobiles Gerät abzielt.

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

Fügt ein dekoratives Symbol neben einem Feld hinzu.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Der Feldname.
icon	Zeichenfolge	Das Schriftartsymbol, das neben dem Feld angezeigt wird.
text	Zeichenfolge	Der Texttitel für das Symbol (wird für Bildschirmleseprogramme verwendet).

Tabelle : 2. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel wird ein VIP-Symbol neben dem Aufrufer hinzugefügt.

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)

Ruft den Formularbeschriftungstext ab.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Der Feldname.

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Beschriftungstext.

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

MobileGlideForm (g_form) – hasField(String fieldName)

Bestimmt, ob ein Feld im Formular vorhanden ist.

Vorhanden bedeutet, dass es anzeigt werden kann, nicht dass es sichtbar ist.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Das zu suchende Feld.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Boolean	„true“, wenn das Feld im Formular vorhanden ist. Andernfalls „false“. Im Formular bedeutet, dass das Feld Teil von g_form ist. Es kann immer noch ausgeblendet, schreibgeschützt, obligatorisch oder ungültig sein.

In diesem Beispiel ist das Feld „assigned_to“ ein Pflichtfeld, wenn sich das Feld „assignment_group“ im Formular befindet.

if (g_form.hasField('assignment_group'))
      g_form.setMandatory('assigned_to', true);
    

MobileGlideForm (g_form) – removeDecoration(String fieldName, String icon, String text)

Entfernt ein dekoratives Symbol neben einem Feld.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Der Feldname.
icon	Zeichenfolge	Zu entfernendes Symbol.
text	Zeichenfolge	Texttitel für das Symbol.

Tabelle : 8. Ergebnisse

Typ	Beschreibung
void

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)

Legt den Text der Formularbeschriftung fest.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
fieldName	Zeichenfolge	Der Feldname.
label	Zeichenfolge	Feldbeschriftungstext.

Tabelle : 10. Ergebnisse

Typ	Beschreibung
void

In diesem Beispiel wird die Kommentarbezeichnung geändert.

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