GlideModalForm – Client

Die GlideModalForm Die API bietet Methoden zum Anzeigen eines Formulars in einem GlideModal.

Allgemeine Nutzung von GlideModalForm Die Klasse umfasst das Erstellen des Objekts, das Festlegen aller Einstellungen und das Rendern des GlideModalForm.

var dialog = new GlideModalForm('dialog title', 'table_name_or_form_name', [callback on completion of submit])
  dialog.setPreference('name', 'value');
  dialog.render();

Geben Sie die Abfrageparameter an, die mit an das Formular übergeben werden SetPreference() Methode. Jedes Name/Wert-Paar, das Sie mit setPreference() angeben, wird zusammen mit der Formular-POST-Anforderung gesendet, um das Formular anzuzeigen.

Das GlideModalForm ist so festgelegt, dass es die Höhe des Dokumentfensters ausfüllt.

GlideModalForm – GlideModalForm(Zeichenfolgentitel, ZeichenfolgentableName, Function onCompletionCallback, boolescher Wert schreibgeschützt)

Erstellt eine Instanz der GlideModalForm-Klasse.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
title	Zeichenfolge	Titel des modalen Formulars.
tableName	Zeichenfolge	Tabelle, die angezeigt wird.
onCompletionCallback	Funktion	Funktion, die aufgerufen werden soll, nachdem das Formular übermittelt und auf dem Server verarbeitet wurde. Die Rückruffunktion hat das Formular CallbackFunction(Zeichenfolge action_verb, Zeichenfolge sys_ID, Zeichenfolgentabelle, Zeichenfolge DisplayValue) Wobei: action_verb: Name der ausgeführten UI-Aktion. Beispiele sind sysverb_insert (Schaltfläche „Absenden“), sysverb_cancel und sysverb_save (Schaltfläche „Speichern“). sys_id: SYS_ID des betroffenen Datensatzes. table: Name der Tabelle, die den Datensatz enthält. displayValue: Wert, der im Formular angezeigt wird.
Monatlich	Boolean	Optional. Kennzeichnung, die angibt, ob das modale Formular als schreibgeschützt festgelegt werden soll. Gültige Werte: Wahr: Formular auf schreibgeschützt festlegen. Falsch: Für festgelegt, um zu lesen/schreiben. Standardwert: false

Dieses Beispiel zeigt, wie ein GlideModalForm-Objekt instanziiert wird.

function openDevice(deviceSysID, deviceName) {
  var uName = gel('hidden_user_name').value + "'s ";
  deviceName = new String(deviceName).escapeHTML();
  var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
  gp.addParm('sys_id', deviceSysID);
  gp.render();
}

GlideModalForm – addParm(Zeichenfolgenname, Zeichenfolgenwert)

Legt das angegebene Formularfeld auf den angegebenen Wert fest.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Formularfeldname. Wenn der angegebene Name kein Feld im zugehörigen modalen Formular ist, wird er ignoriert.
Wert	Zeichenfolge	Wert, auf den das angegebene Formularfeld festgelegt werden soll.

Tabelle : 3. Rückgaben

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie Sie anrufen AddParm() Zum Festlegen des Werts des Felds „sys_ID“ im modalen Formular.

function openDevice(deviceSysID, deviceName) {
  var uName = gel('hidden_user_name').value + "'s ";
  deviceName = new String(deviceName).escapeHTML();
  var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
  gp.addParm('sys_id', deviceSysID);
  gp.render();
}

GlideModalForm – setSysID(Zeichenfolge sys_ID)

Legt die sys_id-Voreinstellung des Objekts fest.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
sys_id	Zeichenfolge	Id-Voreinstellung Einer der an das Formular übergebenen Abfrageparameter.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
void

Dieses Beispiel zeigt die Verwendung von SetSysID() Methode zum Initialisieren des Werts der sys_ID

function(startDate, endDate) {
  var dialog = new GlideModalForm("Add Schedule Item", "cmn_schedule_span");
  dialog.setSysID("-1");
  dialog.addParm("sysparm_collection", "cmn_schedule");
  dialog.addParm("sysparm_collectionID", this.sysId);
  dialog.addParm("sysparm_collection_key", "schedule");
 
  var q = "schedule=" + this.sysId + "^start_date_time="
   + startDate.serializeInUserFormat() + "^end_date_time="
   + endDate.serializeInUserFormat() + "^";

  if (startDate.isAllDay(endDate))
    q += "^all_day=true^";
 
  dialog.addParm("sysparm_query", q);
  dialog.render();
}

GlideModalForm – setCompletionCallback(function callbackFunction)

Legt fest, dass die Funktion aufgerufen wird, wenn das Formular erfolgreich vom Server übermittelt und verarbeitet wurde.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
callbackFunction	Funktion	Rückruffunktion, die aufgerufen wird, wenn das Formular erfolgreich verarbeitet wurde. Die Rückruffunktion hat das Formular CallbackFunction(Zeichenfolge action_verb, Zeichenfolge sys_ID, Zeichenfolgentabelle, Zeichenfolge DisplayValue) Wobei: action_verb: Action_Name aus einem sys_ui_action-Datensatz sys_id: SYS_ID des betroffenen Datensatzes table: Name der Tabelle, die den Datensatz enthält displayValue: Wert, der im Formular angezeigt wird

Tabelle : 7. Rückgaben

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie die Rückruffunktion beim Laden des zugehörigen Modals festgelegt wird.

function handleCreateOrEdit(targetFieldName, sourceFieldName, adapterRuleId, transformerSysId){
  dialog = new GlideModalForm('Edit Adapter Rule', "sys_adapter_rule");
  dialog.setSysID(adapterRuleId); //Pass in sys_id to edit existing record
  dialog.addParm('sysparm_form_only', 'true'); //Add or remove related lists
  dialog.setOnloadCallback(hideModalForm);
  dialog.setCompletionCallback(handleAdapterCreatedOrUpdated);
  dialog.render(); //Open the dialog
}
function handleAdapterCreatedOrUpdated(action_verb, sys_id, table, displayValue) {
  var draftRecordTransformer = g_form.getValue("draft_record_transformer");
  if(draftRecordTransformer == null || draftRecordTransformer.length == 0) {
    //sync Sticky Replications if it is enabled.
    var ajax = new GlideAjax('ReplicationPoolUtil');
    ajax.addParam('sysparm_name', 'syncStickyReplicationSet');
    ajax.addParam('sysparm_entry_set', g_form.getValue("entry_set"));
    ajax.getXMLWait();
  }
}

GlideModalForm – setOnloadCallback(function callbackFunction)

Legt fest, dass die Funktion aufgerufen wird, nachdem das Formular geladen wurde.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
callbackFunction	Funktion	Funktion, die aufgerufen werden soll, nachdem das Formular geladen wurde. Die Rückruffunktion hat das Formular callBackFunction(GlideModalForm obj).

Tabelle : 9. Ergebnisse

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie die Rückruffunktion beim Laden des zugehörigen Modals festgelegt wird.

function handleCreateOrEdit(targetFieldName, sourceFieldName, adapterRuleId, transformerSysId){
  dialog = new GlideModalForm('Edit Adapter Rule', "sys_adapter_rule");
  dialog.setSysID(adapterRuleId); //Pass in sys_id to edit existing record
  dialog.addParm('sysparm_form_only', 'true'); //Add or remove related lists
  dialog.setOnloadCallback(hideModalForm);
  dialog.setCompletionCallback(handleAdapterCreatedOrUpdated);
  dialog.render(); //Open the dialog
}

GlideModalForm – Rendern()

Zeigt das modale Formular an.

Tabelle : 10. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 11. Ergebnisse

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie Sie anrufen Rendern () Zum Anzeigen des modalen Elements.

function openDevice(deviceSysID, deviceName) {
  var uName = gel('hidden_user_name').value + "'s ";
  deviceName = new String(deviceName).escapeHTML();
  var gp = new GlideModalForm(uName + deviceName, "cmn_notif_device", refreshNotifPage);
  gp.addParm('sys_id', deviceSysID);
  gp.render();
}