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


---

# GlideModalFormular -- Client

# GlideModalFormular -- Client {#ariaid-title1}

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

Die GlideModalFormular Die API bietet Methoden zum Anzeigen eines Formulars in einem GlideModal.  
Allgemeine Nutzung von GlideModalFormular 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 mithilfe von an das Formular übergeben werden SetEinstellung() Methode. Beliebiges Name/Wert-Paar, das Sie mit angeben SetEinstellung() Wird zusammen mit der FORMULARPOSTANFORDERUNG 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) {#ariaid-title2}

Erstellt eine Instanz der GlideModalForm-Klasse.
{#r_GMFV3-GlideModalForm_S_S_F_B__table_ikc_xjm_qv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Modaler Formulartitel. |
| tableName | Zeichenfolge | Tabelle wird angezeigt. |
| OnCompletionRückruf | 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, Zeichenfolgentabelle, ZeichenfolgendisplayValue) `Wobei: * action_verb: Name der ausgeführten UI-Aktion. Beispiele sind „sysverb_insert" (Schaltfläche „Absenden"), „sysverb_Cancel", „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 als schreibgeschützt festlegen. * Falsch: Für festgelegt, um zu lesen/schreiben. {#r_GMFV3-GlideModalForm_S_S_F_B__ul_rmh_jnx_p4b} Standard: Falsch |
[Tabelle : 1. Parameter]

{#r_GMFV3-GlideModalForm_S_S_F_B__table_ikc_xjm_qv}  
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) {#ariaid-title3}

Legt das angegebene Formularfeld auf den angegebenen Wert fest.
{#r_GMFV3-addParm_S_S__table_tb2_xny_kv__entry__3}

| 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 : 2. Parameter]

{#r_GMFV3-addParm_S_S__table_tb2_xny_kv} {#r_GMFV3-addParm_S_S__table_ub2_xny_kv__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 3. Rückgaben]

{#r_GMFV3-addParm_S_S__table_ub2_xny_kv}  
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) {#ariaid-title4}

Legt die sys_ID-Einstellung des Objekts fest.
{#r_GMFV3-setSysID_S__table_krd_1ly_kv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sys_id | Zeichenfolge | Die ID-Einstellung. Einer der Abfrageparameter, die an das Formular übergeben wurden. |
[Tabelle : 4. Parameter]

{#r_GMFV3-setSysID_S__table_krd_1ly_kv} {#r_GMFV3-setSysID_S__table_lrd_1ly_kv__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#r_GMFV3-setSysID_S__table_lrd_1ly_kv}  
Dieses Beispiel zeigt, wie verwendet wird 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) {#ariaid-title5}

Legt die Funktion fest, die aufgerufen werden soll, wenn das Formular erfolgreich übermittelt und vom Server verarbeitet wurde.
{#r_GMFV3-setCompletionCallback_F__table_aqr_ply_kv__entry__3}

| 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, Zeichenfolgentabelle, ZeichenfolgendisplayValue) `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 {#r_GMFV3-setCompletionCallback_F__ul_udl_4jy_kv} |
[Tabelle : 6. Parameter]

{#r_GMFV3-setCompletionCallback_F__table_aqr_ply_kv} {#r_GMFV3-setCompletionCallback_F__table_bqr_ply_kv__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 7. Rückgaben]

{#r_GMFV3-setCompletionCallback_F__table_bqr_ply_kv}  
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) {#ariaid-title6}

Legt die Funktion fest, die nach dem Laden des Formulars aufgerufen werden soll.
{#r_GMFV3-setOnloadCallback_F__table_uqr_qmy_kv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| CallbackFunction | Funktion | Funktion, die aufgerufen werden soll, nachdem das Formular geladen wurde. Die Rückruffunktion hat das Formular `CallBackFunction (GlideModalForm-Objekt) ` |
[Tabelle : 8. Parameter]

{#r_GMFV3-setOnloadCallback_F__table_uqr_qmy_kv} {#r_GMFV3-setOnloadCallback_F__table_vqr_qmy_kv__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 9. Rückgaben]

{#r_GMFV3-setOnloadCallback_F__table_vqr_qmy_kv}  
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() {#ariaid-title7}

Zeigt das modale Formular an.
{#r_GMFV3-render__table_upp_jny_kv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 10. Parameter]

{#r_GMFV3-render__table_upp_jny_kv} {#r_GMFV3-render__table_vpp_jny_kv__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 11. Rückgaben]

{#r_GMFV3-render__table_vpp_jny_kv}  
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();
    }


