---
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


---

# M_Form -- Client

# M_Form -- Client {#ariaid-title1}

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

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

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

Diese API kann mit verwendet werden [MobileScriptIncludeCaller -- Client](https://servicenow-prod.fluidtopics.net/uvfnIHPimm9wWI6RS3fLRw#MobileScriptInclCallerClientAPI "Stellt Methoden zum Aufrufen von Skripteinbindungen aus mobilen UI-Regelaktionen bereit.")API zum automatischen Ausfüllen von Eingaben auf Eingabeformularbildschirmen. Weitere Informationen zu Eingabeformularbildschirmen finden Sie unter [Input form screen](https://www.servicenow.com/docs/access?context=parameter-input-screen&version=yokohama&pubname=yokohama-mobile&ft:locale=en-US).

Verwenden Sie diese API in Client-Skript Feld einer mobilen UI-Regelaktion. Anweisungen zum Konfigurieren einer mobilen 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=yokohama&pubname=yokohama-mobile&ft:locale=en-US).

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

Zeigt oben im Eingabeformularbildschirm eine Fehlermeldung an.
{#mform-addErrorMessage_S__table_g3q_js2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die anzuzeigende Nachricht. |
[Tabelle : 1. Parameter]

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

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

{#mform-addErrorMessage_S__table_h3q_js2_mbc}  
In diesem Beispiel wird je nach eingegebenem Wert für die Priorität 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 oben im Eingabeformularbildschirm eine Informationsnachricht an.
{#mform-addInfoMessage_S__table_ofb_3s2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Nachricht | Zeichenfolge | Die anzuzeigende Nachricht. |
[Tabelle : 3. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Rückgaben]

{#mform-addInfoMessage_S__table_pfb_3s2_mbc}  
In diesem Beispiel wird je nach eingegebenem Wert für die Priorität 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 auf einem Eingabeformularbildschirm zurück.
{#mform-getValue_S__table_lpp_tr2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Eingabename | 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. Rückgaben]

{#mform-getValue_S__table_mpp_tr2_mbc}  
Dieses Clientskript übergibt den Eingabewert „Employee_ID" an die Skripteinbindung, die die ID verwendet, um den Titel des Mitarbeiters zu suchen. Der Titel wird der Rückruffunktion bereitgestellt, die verwendet wird, um die Eingabe „Business_title" auf dem Eingabeformularbildschirm automatisch auszufüllen.

    // 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 den angegebenen Eingaben einen flimmernden Effekt hinzu, der angibt, dass der Wert von einem Skript festgelegt wird.
Der Shimmereffekt endet, 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 mit den Namen der Eingaben, auf die der Shimmer-Effekt 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. Rückgaben]

{#mform-setAffectedInputs_O__table_e1p_ms2_mbc}  
Dieses Client-Skript fügt der Anrufereingabe einen Shimmer-Effekt hinzu, um anzuzeigen, dass es 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 (Zeichenfolge inputName, Objektwert, Zeichenfolge DisplayValue) {#ariaid-title6}

Legt den Wert einer angegebenen Eingabe auf einem Eingabeformularbildschirm fest.
{#mform-setValue_S_S_S__table_tp1_wr2_mbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Eingabename | Zeichenfolge | Name der Eingabe, deren Wert festgelegt werden soll. |
| Wert | Objekt | Wert, auf den die Eingabe festgelegt werden soll. Der Datentyp des Werts variiert je nach festgelegter Eingabe. |
| displayValue | Zeichenfolge | Optional. Verwenden Sie diesen Parameter, wenn Sie den Wert der Eingaben des Referenztyps festlegen. |
[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. Rückgaben]

{#mform-setValue_S_S_S__table_up1_wr2_mbc}  
In diesem Beispiel wird ein ganzzahliger Wert für die Auftragseingabe festgelegt.

    m_form.setValue("order", 5);

Dieses Beispiel legt einen Zeichenfolgenwert für die Beschreibungseingabe fest.

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

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

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


