m_form : Client

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

Diese API kann mit der MobileScriptIncludeCaller : Client API verwendet werden, um Eingaben auf Eingabeformular-Bildschirmen automatisch auszufüllen. Weitere Informationen zu Eingabeformular-Bildschirmen finden Sie unter Input form screen.

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.

m_form – addErrorMessage (Zeichenfolgennachricht)

Zeigt eine Fehlermeldung oben auf dem Eingabeformular-Bildschirm an.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.

Tabelle : 2. Ausgabe

Typ	Beschreibung
Keine

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)

Zeigt eine Informationsmeldung oben im Eingabeformular-Bildschirm an.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Nachricht	Zeichenfolge	Meldung, die angezeigt werden soll.

Tabelle : 4. Ausgabe

Typ	Beschreibung
Keine

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)

Gibt den Wert einer angegebenen Eingabe in einem Eingabeformular-Bildschirm zurück.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
inputName	Zeichenfolge	Name der Eingabe, deren Wert zurückgegeben werden soll.

Tabelle : 6. Ergebnisse

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.

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)

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.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
inputNames	Array	Array von Zeichenfolgen, die die Namen von Eingaben enthalten, auf die der Schattierungseffekt angewendet werden soll.

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Keine

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)

Legt den Wert einer angegebenen Eingabe in einem Eingabeformular-Bildschirm fest.

Tabelle : 9. Parameter

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 : 10. Ergebnisse

Typ	Beschreibung
Keine

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"}]);