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


---

# G_Modal -- Client

# G_Modal -- Client {#ariaid-title1}

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

Die G_Modal Mit der API können Sie ein modales Fenster anzeigen, um die Anwendungsfunktionalität zu verbessern.

Verwenden Sie diese API, um modale Elemente in Arbeitsbereichen anzuzeigen.  
Mit dieser API können Sie:

* Zeigt Eingabetypfelder in einem modalen Fenster an.
* Zeigen Sie etwas in einem Frame an, z. B. eine UI-Seite oder einen externen Link.
* Führen Sie eine Aktion für die Anwenderbestätigung aus.
* Laden Sie eine Komponente.
* Verwenden Sie HTML, um den Inhalt eines modalen Elements auszufüllen.

## G_modal -- Warnung (Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt) {#ariaid-title2}

Zeigt eine Warnungsnachricht im Zusammenhang mit einer UI-Aktion an.
{#g_modal_alert_S_S_F__table_ed2_wwj_xnb__entry__3}{#g_modal_alert_S_S_F__g_modal-title-entry}{#g_modal_alert_S_S_F__g_modal-message-entry}{#g_modal_alert_S_S_F__g_modal-callback-entry}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Warnung |
| Nachricht | Zeichenfolge | Nachricht, die im modalen Textkörper angezeigt werden soll. Hinweis: Wenn Sie nur einen Parameter übergeben, behandelt die Methode ihn als messageParameter. |
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| Stil | Objekt | Optional. Stil der Bestätigungsschaltfläche, die im Modal angezeigt werden soll. "style": { "buttonTitle": "String", "buttonType": "String" } |
| Stil.ButtonTitel | Zeichenfolge | Optional. Text, der auf der Bestätigungsschaltfläche angezeigt werden soll. Standard: OK |
| Stil.Schaltflächentyp | Zeichenfolge | Optional. Typ der anzuzeigenden Bestätigungsschaltfläche. Standard: Standard |
[Tabelle : 1. Parameter]

{#g_modal_alert_S_S_F__table_ed2_wwj_xnb} {#g_modal_alert_S_S_F__table_fd2_wwj_xnb__entry__2}{#g_modal_alert_S_S_F__g_modal-promise-entry}

| Typ | Beschreibung |
|-|-|
| Versprechen | Wenn A callbackParameter Wird bestanden, gibt die Zusage zurück, wenn erfolgreich, andernfalls ist ein Fehler aufgetreten. |
[Tabelle : 2. Rückgaben]

{#g_modal_alert_S_S_F__table_fd2_wwj_xnb}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um die Warnungsmeldung „nur der zugewiesene kann diese Aktion beenden" anzuzeigen.

    function onClick(g_form) {

      if (g_user.userID != g_form.getValue('assigned_to')) {
        g_modal.alert('Only the assigned to can end this action.');
        return;
      }

      var msg = getMessage("Are you sure you want to take this action?");
      g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
        if (confirmed) {
          g_form.setValue('state', 'closed_complete');
          g_form.save();
        }
      });

      return false;
    }

## G_modal -- Bestätigen (Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt) {#ariaid-title3}

Zeigt eine Bestätigungsnachricht im Zusammenhang mit einer UI-Aktion an.
{#g_modal_confirm_S_S_F__table_ed2_wwj_xnb__entry__3}{#g_modal_confirm_S_S_F__g_modal-message-entry}{#g_modal_confirm_S_S_F__g_modal-callback-entry}{#g_modal_confirm_S_S_F__g_modal-style-entry}{#g_modal_confirm_S_S_F__g_modal-style_cancelTitle-entry}{#g_modal_confirm_S_S_F__g_modal-style_cancelType-entry}{#g_modal_confirm_S_S_F__g_modal-style_confirmTitle-entry}{#g_modal_confirm_S_S_F__g_modal-style_confirmType-ph}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Bestätigen |
| Nachricht | Zeichenfolge | Nachricht, die im modalen Textkörper angezeigt werden soll. Hinweis: Wenn Sie nur einen Parameter übergeben, behandelt die Methode ihn als messageParameter. |
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| Stil | Objekt | Optional. Stil der Schaltflächen „Bestätigen" und „Abbrechen", die im Modal angezeigt werden sollen. "style": { "cancelTitle": "String", "cancelType": "String", "confirmTitle": "String", "confirmType": "String" } |
| style.cancelTitle | Zeichenfolge | Optional. Text, der auf der Schaltfläche „Abbrechen" angezeigt werden soll. Standard: Abbrechen |
| style.cancelType | Zeichenfolge | Optional. Typ der anzuzeigenden Schaltfläche „Abbrechen". Standard: Bestätigen |
| Stil.BestätigungTitel | Zeichenfolge | Optional. Text, der auf der Bestätigungsschaltfläche angezeigt werden soll. Standard: OK |
| Stil.Bestätigungstyp | Zeichenfolge | Optional. Typ der anzuzeigenden Bestätigungsschaltfläche. Standard: Standard |
[Tabelle : 3. Parameter]

{#g_modal_confirm_S_S_F__table_ed2_wwj_xnb} {#g_modal_confirm_S_S_F__table_fd2_wwj_xnb__entry__2}{#g_modal_confirm_S_S_F__g_modal-promise-entry}

| Typ | Beschreibung |
|-|-|
| Versprechen | Wenn A callbackParameter Wird bestanden, gibt die Zusage zurück, wenn erfolgreich, andernfalls ist ein Fehler aufgetreten. |
[Tabelle : 4. Rückgaben]

{#g_modal_confirm_S_S_F__table_fd2_wwj_xnb}  
Das folgende Codebeispiel zeigt, wie Sie diese Methode aufrufen, um die Bestätigungsnachricht „Möchten Sie diese Aktion wirklich ausführen?" anzuzeigen.

    function onClick(g_form) {

      if (g_user.userID != g_form.getValue('assigned_to')) {
        g_modal.alert('Only the assigned to can end this action.');
        return;
      }

      var msg = getMessage("Are you sure you want to take this action?");
      g_modal.confirm(getMessage("Confirmation"), msg, function (confirmed) {
        if (confirmed) {
          g_form.setValue('state', 'closed_complete');
          g_form.save();
        }
      });

      return false;
    }

Ausgabe:  

<br />

## G_modal -- confirm Destroy (Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt) {#ariaid-title4}

Zeigt eine Bestätigungsnachricht im Zusammenhang mit einer UI-Aktion an, wobei die Bestätigungsschaltfläche als angezeigt wird Ein zerstörerischer Stil .
{#g_modal_confirmDestroy_S_S_F__table_ed2_wwj_xnb__entry__3}{#g_modal_confirmDestroy_S_S_F__g_modal-message-entry}{#g_modal_confirmDestroy_S_S_F__g_modal-callback-entry}{#g_modal_confirmDestroy_S_S_F__g_modal-style-entry}{#g_modal_confirmDestroy_S_S_F__g_modal-style_cancelTitle-entry}{#g_modal_confirmDestroy_S_S_F__g_modal-style_cancelType-entry}{#g_modal_confirmDestroy_S_S_F__g_modal-style_confirmTitle-entry}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Bestätigen |
| Nachricht | Zeichenfolge | Nachricht, die im modalen Textkörper angezeigt werden soll. Hinweis: Wenn Sie nur einen Parameter übergeben, behandelt die Methode ihn als messageParameter. |
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| Stil | Objekt | Optional. Stil der Schaltflächen „Bestätigen" und „Abbrechen", die im Modal angezeigt werden sollen. "style": { "cancelTitle": "String", "cancelType": "String", "confirmTitle": "String", "confirmType": "String" } |
| style.cancelTitle | Zeichenfolge | Optional. Text, der auf der Schaltfläche „Abbrechen" angezeigt werden soll. Standard: Abbrechen |
| style.cancelType | Zeichenfolge | Optional. Typ der anzuzeigenden Schaltfläche „Abbrechen". Standard: Bestätigen |
| Stil.BestätigungTitel | Zeichenfolge | Optional. Text, der auf der Bestätigungsschaltfläche angezeigt werden soll. Standard: OK |
| Stil.Bestätigungstyp | Zeichenfolge | Optional. Typ der anzuzeigenden Bestätigungsschaltfläche. Standard: Destruktiv |
[Tabelle : 5. Parameter]

{#g_modal_confirmDestroy_S_S_F__table_ed2_wwj_xnb} {#g_modal_confirmDestroy_S_S_F__table_fd2_wwj_xnb__entry__2}{#g_modal_confirmDestroy_S_S_F__g_modal-promise-entry}

| Typ | Beschreibung |
|-|-|
| Versprechen | Wenn A callbackParameter Wird bestanden, gibt die Zusage zurück, wenn erfolgreich, andernfalls ist ein Fehler aufgetreten. |
[Tabelle : 6. Rückgaben]

{#g_modal_confirmDestroy_S_S_F__table_fd2_wwj_xnb}  
In diesem Beispiel , ...

```

```

## G_modal -- RichText(Zeichenfolgentitel, ZeichenfolgenrichContent, Funktionsrückruf, Zeichenfolgengröße, ZeichenfolgenabbruchTitel, Zeichenfolge BestätigungTitel, Zeichenfolge cancelType, Zeichenfolge bestätigungType) {#ariaid-title5}

Zeigt ein Modal an, das übergebene HTML verwendet, um den Inhalt innerhalb des Modals zu generieren.
{#g_modal_richText_S_S_F__table_nnj_pgb_h2c__entry__3}{#g_modal_richText_S_S_F__g_modal-title-ph}{#g_modal_richText_S_S_F__g_modal-callback-entry}{#g_modal_richText_S_S_F__g_modal-style_confirmType-ph}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Leer |
| Richtigtext | Zeichenfolge | HTML-Inhalt, der im Modal angezeigt werden soll. Hinweis: Diese Methode entfernt `]]>`Tags, Inline-JavaScript und andere Elemente, die zu Sicherheits-Exploits führen können. |
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| CancelTitle | Zeichenfolge | Optional. Text, der auf der Schaltfläche „Abbrechen" angezeigt werden soll. Standard: Abbrechen |
| BestätigungTitel | Zeichenfolge | Optional. Text, der auf der Bestätigungsschaltfläche angezeigt werden soll. Standard: OK |
| Abbruchtyp | Zeichenfolge | Optional. Typ der anzuzeigenden Schaltfläche „Abbrechen". Standard: Bestätigen |
| Bestätigungstyp | Zeichenfolge | Optional. Typ der anzuzeigenden Bestätigungsschaltfläche. Standard: Standard |
[Tabelle : 7. Parameter]

{#g_modal_richText_S_S_F__table_nnj_pgb_h2c} {#g_modal_richText_S_S_F__table_onj_pgb_h2c__entry__2}{#g_modal_richText_S_S_F__g_modal-promise-entry}

| Typ | Beschreibung |
|-|-|
| Versprechen | Wenn A callbackParameter Wird bestanden, gibt die Zusage zurück, wenn erfolgreich, andernfalls ist ein Fehler aufgetreten. |
[Tabelle : 8. Rückgaben]

{#g_modal_richText_S_S_F__table_onj_pgb_h2c}  
<br />

```

```

## G_modal -- showFields(Zeichenfolgentitel, Array-Felder, Zeichenfolgenanweisung, Funktionsrückruf) {#ariaid-title6}

Zeigt ein modales Fenster an, das die angegebenen Felder enthält. Zeigt standardmäßig die Schaltflächen „OK" und „Abbrechen" an.
{#g_modal_showFields_S_S_F__table_ed2_wwj_xnb__entry__3}{#g_modal_showFields_S_S_F__g_modal-callback-entry}{#g_modal_showFields_S_S_F__g_modal-size-entry}{#g_modal_showFields_S_S_F__g_modal-title-entry}

| Name | Typ | Beschreibung |
|-|-|-|
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| CancelTitle | Zeichenfolge | Optional. Bezeichnung für die Schaltfläche „Abbrechen". Standard: Abbrechen |
| Abbruchtyp | Zeichenfolge | Optional. Typ des Abbruchs Schaltfläche. Standard: Standard |
| BestätigungTitel | Zeichenfolge | Optional. Bezeichnung für die Bestätigungsschaltfläche. Standard: OK |
| Bestätigungstyp | Zeichenfolge | Optional. Typ Der Bestätigungsschaltfläche. Standard: Bestätigen |
| Felder | Objekt-Array | Liste der anzuzeigenden Felder Im Modal. Jedes Feld ist in einem separaten Objekt definiert. Die fieldsParameter, die Sie übergeben, hängen vom Typ des Felds ( fields.type) Angegeben. fields: [ { choices: "String", dispalyValue: "String", label: "String", mandatory: Boolean, name: "String", reference: "String", referringTable: "String", referringRecordId: "String", type: "String", value: "String" } ] |
| Felder. Auswahlmöglichkeiten | Objekt-Array | Erforderlich, wenn fields.typeParameter ist auf festgelegt `Auswahl `. Liste der Optionen, die im zugehörigen Listenfeld angezeigt werden sollen. Zum Beispiel: choices: [ { displayValue: 'Value 1', value: 'Value1' }, { displayValue: 'Value 2', value: 'Value2' } ] |
| Felder.Bezeichnung | Zeichenfolge | Text, der als Bezeichnung für dieses Feld im Modal angezeigt werden soll. |
| Felder.obligatorisch | Boolean | Optional. Kennzeichnung, die angibt, ob das Feld ein Pflichtfeld ist. Gültige Werte: * Wahr: Feld ist ein Pflichtfeld. * Falsch: Feld ist optional. Standard: Falsch |
| fields.name | Zeichenfolge | Interner Name des Felds. Wenn fields.typeParameter ist auf festgelegt `Referenz `, Ist das Referenzfeld im aktuellen Datensatz, der für die Suche verwendet wird. |
| Felder.Referenz | Zeichenfolge | Erforderlich, wenn fields.typeParameter ist auf festgelegt `Referenz `. Name der zu referenzierenden Tabelle. Beispiel: `sys_user ` |
| Felder.Referenzierungstabelle | Zeichenfolge | Erforderlich, wenn fields.typeParameter ist auf festgelegt `Referenz `. Name der Tabelle, aus der Sie referenzieren. Beispiel: `Incident ` |
| Fields.ReferringRecordId | Zeichenfolge | Erforderlich, wenn fields.typeParameter ist auf festgelegt `Referenz `. SYS_ID des Datensatzes, den Sie im UI-Aktionsformular aufrufen. |
| Felder.Typ | Zeichenfolge | Typ des Felds, das im Modal angezeigt werden soll. Gültige Werte: * boolean * Auswahl * Glide_list * html * Referenz * Zeichenfolge * textarea Jeder Feldtyp hat einen Satz von fields.\<\>Optionen, die übergeben werden können. |
| Felder.Wert | Zeichenfolge | Optional. Wert, der im Feld angezeigt werden soll. Für ein Auswahlfeld können Sie beispielsweise eine Anwenderaufforderung anzeigen: `Wert: GetMessage(' -- Auswählen -- ')` Oder für ein Referenzfeld können Sie den Wert eines Felds im zugehörigen Formular anzeigen: `G_Form.getValue('caller_ID')` Standard: Leer |
| Anweisung | Zeichenfolge | Optional. Anweisungen, die im Modal angezeigt werden sollen. |
| size | Zeichenfolge | Größe des modalen Elements . Mögliche modale CSS-Klassen: * Warnung: 300 px * sm: 400 px * md: 600 px * lg: 900 px |
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Leer |
[Tabelle : 9. Parameter]

{#g_modal_showFields_S_S_F__table_ed2_wwj_xnb} {#g_modal_showFields_S_S_F__table_fd2_wwj_xnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler. |
[Tabelle : 10. Rückgaben]

{#g_modal_showFields_S_S_F__table_fd2_wwj_xnb}  
Das folgende Beispiel zeigt, wie Sie einen Anwender mithilfe eines modalen Fensters aus einem Grund auffordern und es dann an das Feld „Arbeitsnotizen" im Datensatz zurückgeben. Die Dann() Methode gibt eine Zusage zurück, die zurückgibt, was das Modal zurückgibt; <var class="keyword varname">FieldValues </var>In diesem Fall. Das Feld „Arbeitsnotizen" auf der Client-Seite mit dem Feldwert befindet sich in <var class="keyword varname">UpdatedFields </var>Array. Da nur ein Feld zurückgegeben wird, nimmt das Beispiel eine Indexposition von an <var class="keyword varname">0 </var>.

    function onClick(g_form) {
        g_modal.showFields({
            title: "Enter your reason",
            fields: [{
                type: 'textarea',
                name: 'work_notes',
                label: getMessage('Reason'),
                mandatory: true
            }],
            size: 'lg'
        }).then(function(fieldValues) {
            g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
            g_form.save();
        });
    }

Ausgabe:

Das folgende Beispiel erweitert das obige Beispiel und fügt Auswahlfelder und Referenzfelder hinzu.

    function onClick(g_form) {

        var fields = [{
            type: 'textarea',
            name: 'work_notes',
            label: getMessage('Reason'),
            mandatory: true
        },
        {
            type: 'choice',
            name: 'reason_code',
            label: getMessage('Reason code'),
            value: getMessage(' -- Select -- '),
            choices: [
              {
                displayValue: 'Duplicate',
                value: 'duplicate'
              },
              {
                displayValue: 'Canceled',
                value: 'canceled'
              }
            ],
            mandatory: true
        },
        {
            type: 'reference',
            name: 'caller_id',
            label: getMessage('What is your name?'),
            mandatory: true,
            reference: 'sys_user',
            referringTable: 'incident',
            referringRecordId: g_form.getUniqueValue(),
    	 value: g_form.getValue('caller_id'),
    	 displayValue: g_form.getDisplayValue('caller_id')
        }
      ];

      g_modal.showFields({
        title: "Enter your reason",
        fields: fields,
        size: 'lg'
      }).then(function(fieldValues) {
            g_form.setValue('work_notes', fieldValues.updatedFields[0].value);
            g_form.setValue('caller_id', fieldValues.updatedFields[2].value);
            g_form.save();
      });
    }

Ausgabe:

## G_modal -- showFrame(Zeichenfolgentitel, Zeichenfolgen-url, Funktionsrückruf, Zeichenfolgengröße, Zeichenfolgenhöhe, Zeichenfolge „AutoCloseOn") {#ariaid-title7}

Zeigt ein modales Element an, das einen Link zu einer externen URL oder UI-Seite für seinen Inhalt verwendet.
{#g_modal_showFrame_S_S_F__table_ed2_wwj_xnb__entry__3}{#g_modal_showFrame_S_S_F__g_modal-title-ph}{#g_modal_showFrame_S_S_F__g_modal-callback-entry}{#g_modal_showFrame_S_S_F__g_modal-size-entry}

| Name | Typ | Beschreibung |
|-|-|-|
| Titel | Zeichenfolge | Optional. Titel, der im Header des Modals angezeigt werden soll. Standard: Leer |
| URL | Zeichenfolge | URL der Informationen, die in den iFrame geladen werden sollen. Hinweis: Wenn nur ein Argument übergeben wird, wird es als behandelt urlParameter. |
| Rückruf | Funktion | Optional. 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: * Sysverb_Cancel (Schaltfläche „Abbrechen") * Sysverb_insert (Schaltfläche „Absenden") * 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. Standard: |
| size | Zeichenfolge | Größe des modalen Elements . Mögliche modale CSS-Klassen: * Warnung: 300 px * sm: 400 px * md: 600 px * lg: 900 px |
| height | Nummer | Höhe Des Modals. Einheit: Pixel |
| Automatisch schließen am | Zeichenfolge | Optional. Bedingung, unter der das modale Element automatisch geschlossen werden soll, z. B. `„URL_CHANGED" `. Standard: Modales Element nicht automatisch schließen. |
[Tabelle : 11. Parameter]

{#g_modal_showFrame_S_S_F__table_ed2_wwj_xnb} {#g_modal_showFrame_S_S_F__table_fd2_wwj_xnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler. Diese Zusage wird gelöst, wenn das modale iFrame-Element geschlossen wird. |
[Tabelle : 12. Rückgaben]

{#g_modal_showFrame_S_S_F__table_fd2_wwj_xnb}  
Das folgende Beispiel zeigt, wie ein KB-artikel in einem Modell mithilfe der sys_ID des KB-artikeldatensatzes und einer Basis-URL angezeigt wird.

    function onClick(g_form) {
      var kbId = '24d9243187032100deddb882a2e3ec33'; //sysId of KB article
      g_modal.showFrame({
        url: '/kb_view.do?sys_kb_id=' + kbId,
        title: 'Test Knowledge Article',
        size: 'lg',
        height: 500
      });
    }

Ausgabe:

Dieses Beispiel zeigt, wie eine eingebettete UI-Seite beim Erstellen eines modalen Elements verwendet wird. Wird verwendet Window.parent.PostMessage() Auf der UI-Seite, um Daten vom iFrame zurück an den Arbeitsbereich seit zu übergeben G_Form API ist auf einer UI-Seite nicht zugänglich, wenn sie sich im iFrame befindet.

    function onClick(g_form) {
      function proposeMIC(data) {
        var workNotes = data.msg + "\n" + data.workNotes;
        var notes = g_form.getValue('work_notes') + ' ' + workNotes;
        var bi = g_form.getValue('business_impact') + ' ' + data.businessImpact;
        g_form.setValue('work_notes', notes.trim());
        g_form.setValue('business_impact', bi.trim());
        g_form.submit('sysverb_mim_propose');
      }
    	
      function openPopup() {
        if(!g_form.getControl('work_notes')) {
          getMessage('Cannot propose major incident as "Worknotes" is not visible', function(msg) {
    	 g_form.addErrorMessage(msg);
          });
          return false;
        }

        var url = "/sn_major_inc_mgmt_mim_propose.do?sysparm_stack=no&sysparm_workspace=" + true;
        g_modal.showFrame({
          title: getMessage("Propose Major Incident"),
          url: url,
          size: 'lg',
          autoCloseOn: 'URL_CHANGED',
          callback: function (ret, data) {
            if (ret)
              proposeMIC(data);
          }
        });
      }
    	
      openPopup();
    }

Ausgabe:  

<br />


