---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# m_form : Client

# m_form : Client {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Stellt Methoden zum Abrufen und Festlegen von Eingabewerten auf Eingabeformular-Bildschirmen sowie zum Anzeigen von Nachrichten bereit.  
Diese API unterstützt die folgenden Eingabetypen:

* Boolean
* Auswahl
* Datum/Uhrzeit
* Nummer
* Referenz
* Zeichenfolge
{#m_formClientAPI__ul_hqy_jnl_ccc}

Diese API kann mit der [MobileScriptIncludeCaller : Client](https://www.servicenow.com/docs/3f~Yx~mNekUxB9dgXtCUyw#MobileScriptInclCallerClientAPI "Stellt Methoden zum Aufrufen von Skripteinbindungen in Mobile UI-Regelaktionen bereit.") API verwendet werden, um Eingaben auf Eingabeformular-Bildschirmen automatisch auszufüllen. Weitere Informationen zu Eingabeformular-Bildschirmen finden Sie unter [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US).

Verwenden Sie diese API im Client-Skriptfeld einer Mobile UI-Regelaktion. Anweisungen zum Konfigurieren einer Mobile UI-Regelaktion mit den richtigen Einstellungen für diese API finden Sie unter [Configure auto-fill inputs on input form screens](https://www.servicenow.com/docs/access?context=config-autofil-inputs-nptfrmscrn&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US).

## m_form -- addErrorMessage (Zeichenfolgennachricht) {#ariaid-title2}

Zeigt eine Fehlermeldung oben auf dem Eingabeformular-Bildschirm an.
{#mform-addErrorMessage_S__table_g3q_js2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Meldung, die angezeigt werden soll. |
[Tabelle : 1. Parameter]

{#mform-addErrorMessage_S__table_g3q_js2_mbc} {#mform-addErrorMessage_S__table_h3q_js2_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Ausgabe]

{#mform-addErrorMessage_S__table_h3q_js2_mbc}  
In diesem Beispiel wird abhängig vom für die Priorität eingegebenen Wert eine Informations- oder Fehlermeldung im Formular angezeigt.

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var priority = newValue; 
       if (priority > 0 && priority < 3) { 
          getMessage("This incident should be handled ASAP", function(response){ 
             m_form.addInfoMessage(response); 
          }); 
       } else { 
          getMessage("The selected priority is invalid", function(response){ 
             m_form.addErrorMessage(response); 
          }); 
       }	 
    }

## m_form -- addInfoMessage (Zeichenfolgennachricht) {#ariaid-title3}

Zeigt eine Informationsmeldung oben im Eingabeformular-Bildschirm an.
{#mform-addInfoMessage_S__table_ofb_3s2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Meldung, die angezeigt werden soll. |
[Tabelle : 3. Parameter]

{#mform-addInfoMessage_S__table_ofb_3s2_mbc} {#mform-addInfoMessage_S__table_pfb_3s2_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Ausgabe]

{#mform-addInfoMessage_S__table_pfb_3s2_mbc}  
In diesem Beispiel wird abhängig vom für die Priorität eingegebenen Wert eine Informations- oder Fehlermeldung im Formular angezeigt.

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var priority = newValue; 
       if (priority > 0 && priority < 3) { 
          getMessage("This incident should be handled ASAP", function(response){ 
             m_form.addInfoMessage(response); 
          }); 
       } else { 
          getMessage("The selected priority is invalid", function(response){ 
             m_form.addErrorMessage(response); 
          }); 
       }	 
    }

## m_form -- getValue(String inputName) {#ariaid-title4}

Gibt den Wert einer angegebenen Eingabe in einem Eingabeformular-Bildschirm zurück.
{#mform-getValue_S__table_lpp_tr2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| inputName | Zeichenfolge | Name der Eingabe, deren Wert zurückgegeben werden soll. |
[Tabelle : 5. Parameter]

{#mform-getValue_S__table_lpp_tr2_mbc} {#mform-getValue_S__table_mpp_tr2_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert der angegebenen Eingabe. Hinweis: Wenn die Eingabe eine Auswahlliste mit Mehrfachauswahl ist, ist der Rückgabetyp ein Array von Zeichenfolgen mit den ausgewählten Werten. |
[Tabelle : 6. Ergebnisse]

{#mform-getValue_S__table_mpp_tr2_mbc}  
Dieses Client-Skript übergibt den Eingabewert „employee_id" an die Skripteinbindung, die anhand der ID den Titel des Mitarbeiters sucht. Der Titel wird der Rückruffunktion bereitgestellt, die zum automatischen Ausfüllen der Eingabe „business_title" auf dem Eingabeformularbildschirm verwendet wird.

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var employeeId = m_form.getValue("employee_id"); 
       var caller = new MobileScriptIncludeCaller("UserUtilsTest", "getBusinessTitle"); 
       caller.addParam("employeeId", employeeId); 
       caller.call(function(response) { 
          m_form.setValue("business_title", response); 
       }); 
    }

Skripteinbindung.

    // Mobile callable script include
    var UserUtilsTest = Class.create(); 
    UserUtilsTest.prototype = Object.extendsObject(global.AbstractMobileCallableInclude, { 
       getBusinessTitle: function() { 
          var employeeId = this.getParameter("employeeId"); 
          var gr = new GlideRecord("sys_user"); 
          gr.get(employeeId); 
          return gr.getValue("title"); 
       }, 
       type: 'UserUtilsTest' 
    });

## m_form -- setAffectedInputs(Array inputNames) {#ariaid-title5}

Fügt angegebenen Eingaben einen schmetternden Effekt hinzu, der anzeigt, dass der Wert von einem Skript festgelegt wird.
Der Schattierungseffekt wird beendet, sobald der Wert für die Eingabe festgelegt ist.
{#mform-setAffectedInputs_O__table_d1p_ms2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| inputNames | Array | Array von Zeichenfolgen, die die Namen von Eingaben enthalten, auf die der Schattierungseffekt angewendet werden soll. |
[Tabelle : 7. Parameter]

{#mform-setAffectedInputs_O__table_d1p_ms2_mbc} {#mform-setAffectedInputs_O__table_e1p_ms2_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Ergebnisse]

{#mform-setAffectedInputs_O__table_e1p_ms2_mbc}  
Dieses Client-Skript fügt der Anrufereingabe einen Schattierungseffekt hinzu, um anzuzeigen, dass sie automatisch ausgefüllt wird.

    // Client script in a Mobile UI Rule Action
    function onChange(inputName, newValue) { 
       var affectedInputs = []; 
       affectedInputs.push("Caller"); 
       m_form.setAffectedInputs(affectedInputs); 
       m_form.setValue("Caller", ["800b174138d089c868d09de320f9833b", "46d44a23a9fe19810012d100cca80666"]); 
       var result = m_form.getValue("Caller"); 
       console.log(`Ref test: ${result[0]}`); 
    }

## m_form -- setValue(String inputName, Object value, String displayValue) {#ariaid-title6}

Legt den Wert einer angegebenen Eingabe in einem Eingabeformular-Bildschirm fest.
{#mform-setValue_S_S_S__table_tp1_wr2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| inputName | Zeichenfolge | Name der Eingabe, deren Wert festgelegt werden soll. |
| Wert | Objekt | Wert, auf den die Eingabe festgelegt werden soll. Der Datentyp des Werts hängt von der festgelegten Eingabe ab. |
| displayValue | Zeichenfolge | Optional. Verwenden Sie diesen Parameter, um den Wert von Referenztypeingaben festzulegen. |
[Tabelle : 9. Parameter]

{#mform-setValue_S_S_S__table_tp1_wr2_mbc} {#mform-setValue_S_S_S__table_up1_wr2_mbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 10. Ergebnisse]

{#mform-setValue_S_S_S__table_up1_wr2_mbc}  
In diesem Beispiel wird ein ganzzahliger Wert für die Eingabe „Reihenfolge" festgelegt.

    m_form.setValue("order", 5);

In diesem Beispiel wird ein Zeichenfolgenwert für die Beschreibungseingabe festgelegt.

    m_form.setValue("description", "This is the description content");

In diesem Beispiel wird ein Objekt, das den Wert und den Anzeigewert enthält, verwendet, um eine Referenztypeingabe festzulegen.

    m_form.setValue("Caller", [{"value":"800b174138d089c868d09de320f9833b", "displayValue":"Abel Tuter"}]);