M_Form – Client

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/Uhrzeit
• Anzahl
• Referenz
• Zeichenfolge

Diese API kann mit verwendet werden MobileScriptIncludeCaller – Client API zum automatischen Ausfüllen von Eingaben auf Eingabeformularbildschirmen. Weitere Informationen zu Eingabeformularbildschirmen finden Sie unter Input form screen.

Verwenden Sie diese API in Client-Skript Feld einer Mobile 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.

M_Form – addErrorMessage(Zeichenfolgennachricht)

Zeigt oben im Eingabeformularbildschirm eine Fehlermeldung an.

Tabelle : 1. Parameter

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

Tabelle : 2. Ausgabe

Typ	Beschreibung
Keine

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)

Zeigt oben im Eingabeformularbildschirm eine Informationsnachricht an.

Tabelle : 3. Parameter

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

Tabelle : 4. Ausgabe

Typ	Beschreibung
Keine

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)

Gibt den Wert einer angegebenen Eingabe auf einem Eingabeformularbildschirm zurück.

Tabelle : 5. Parameter

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

Tabelle : 6. Rückgaben

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 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, mit der die Eingabe „Business_title“ auf dem Eingabeformularbildschirm automatisch ausgefüllt 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 den angegebenen Eingaben einen flimmernden Effekt hinzu, der angibt, dass der Wert von einem Skript festgelegt wird.

Der Shimmering-Effekt endet, sobald der Wert für die Eingabe festgelegt ist.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
InputNames	Array	Array von Zeichenfolgen mit den Namen der Eingaben, auf die der Shimmer-Effekt angewendet werden soll.

Tabelle : 8. Rückgaben

Typ	Beschreibung
Keine

Dieses Clientskript 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(String inputName, Objektwert, String DisplayValue)

Legt den Wert einer angegebenen Eingabe auf einem Eingabeformularbildschirm fest.

Tabelle : 9. Parameter

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 vom Typ „Referenz“ festlegen.

Tabelle : 10. Rückgaben

Typ	Beschreibung
Keine

In diesem Beispiel wird ein ganzzahliger Wert für die Auftragseingabe 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 verwendet, das den Wert und den Anzeigewert enthält, um eine Referenztypeingabe festzulegen.

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