---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Mobiles GlideForm (g_Form) -- Client

# Mobiles GlideForm (g_Form) -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Mobiles GlideForm (g_Form) Die API bietet Methoden für die Arbeit mit Formularen auf der mobilen Plattform.

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

## MobileGlideForm (g_Form) -- addDecoration(Zeichenfolgenfeldname , Zeichenfolgensymbol , Zeichenfolgentext ) {#ariaid-title2}

Fügt einem Feld ein dekoratives Symbol hinzu.
{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Feldname. |
| icon | Zeichenfolge | Das Schriftartsymbol, das neben dem Feld angezeigt werden soll. |
| HTML | Zeichenfolge | Der Texttitel für das Symbol (wird für Bildschirmleser verwendet). |
[Tabelle : 1. Parameter]

{#r_MGF-addDecoration_S_S_S__table_nbc_4dw_mt} {#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#r_MGF-addDecoration_S_S_S__table_obc_4dw_mt}  
In diesem Beispiel wird neben dem Anrufer ein VIP-Symbol 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(Zeichenfolge fieldName) {#ariaid-title3}

Ruft den Formularbezeichnungstext ab.
{#r_MGF-getLabel_S__table_jbc_4dw_mt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Feldname. |
[Tabelle : 3. Parameter]

{#r_MGF-getLabel_S__table_jbc_4dw_mt} {#r_MGF-getLabel_S__table_kbc_4dw_mt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Bezeichnungstext. |
[Tabelle : 4. Rückgaben]

{#r_MGF-getLabel_S__table_kbc_4dw_mt}  

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

## MobileGlideForm (g_Form) -- hasField(String fieldName) {#ariaid-title4}

Bestimmt, ob ein Feld im Formular vorhanden ist.
„Anwesend" bedeutet, dass sie angezeigt werden kann, nicht dass sie sichtbar ist.
{#r_MGF-hasField_S__table_lbc_4dw_mt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Das zu suchende Feld. |
[Tabelle : 5. Parameter]

{#r_MGF-hasField_S__table_lbc_4dw_mt} {#r_MGF-hasField_S__table_mbc_4dw_mt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn das Feld im Formular vorhanden ist; „falsch", wenn nicht. Im Formular bedeutet, dass das Feld Teil von „g_Form" ist. Es kann weiterhin ausgeblendet, schreibgeschützt, obligatorisch oder ungültig sein. |
[Tabelle : 6. Rückgaben]

{#r_MGF-hasField_S__table_mbc_4dw_mt}  
In diesem Beispiel wird das Feld assigned_to obligatorisch, wenn sich das Feld Assignation_Group im Formular befindet.

    if (g_form.hasField('assignment_group'))
          g_form.setMandatory('assigned_to', true);
        
## MobileGlideForm (g_Form) -- removeDecoration (Zeichenfolgenfeldname , Zeichenfolgensymbol , Zeichenfolgentext ) {#ariaid-title5}

Entfernt ein dekoratives Symbol aus einem Feld.
{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Feldname. |
| icon | Zeichenfolge | Das zu entfernende Symbol. |
| HTML | Zeichenfolge | Der Texttitel für das Symbol. |
[Tabelle : 7. Parameter]

{#r_MGF-removeDecoration_S_S_S__table_q5v_wvw_mt} {#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#r_MGF-removeDecoration_S_S_S__table_t5v_wvw_mt}  

    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, Zeichenfolgenbezeichnung ) {#ariaid-title6}

Legt den Text der Formularbezeichnung fest.
{#r_MGF-setLabel_S_S__table_fbc_4dw_mt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| fieldName | Zeichenfolge | Der Feldname. |
| label | Zeichenfolge | Der Feldbezeichnungstext. |
[Tabelle : 9. Parameter]

{#r_MGF-setLabel_S_S__table_fbc_4dw_mt} {#r_MGF-setLabel_S_S__table_gbc_4dw_mt__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

{#r_MGF-setLabel_S_S__table_gbc_4dw_mt}  
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)');
          }


