G_modal ( Next Experience) – Client

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 17 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:
    • Zeigen Sie 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 bei der Anwenderbestätigung aus.
    • Laden Sie eine Komponente.
    • Verwenden Sie HTML, um den Inhalt eines modalen Elements auszufüllen.

    G_modal ( Next Experience) – Warnung (Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt)

    Zeigt eine Warnungsmeldung im Zusammenhang mit einer UI-Aktion an.

    Tabelle : 1. Parameter
    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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

    Stil Objekt Optional. Stil der Bestätigungsschaltfläche, die im Modal angezeigt werden soll.
    "style": {
      "buttonTitle": "String",
      "buttonType": "String"
    }
    Stil.Schaltflächentitel 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 : 2. Ausgabe
    Typ Beschreibung
    Zusage Wenn ein callbackParameter wird übergeben, gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler.

    Wenn ein callbackParameter wird nicht übergeben, die Methode gibt immer Erfolg zurück.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um die Warnungsmeldung „nur Zugewiesen an 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 ( Next Experience) – Bestätigen (Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt)

    Zeigt eine Bestätigungsnachricht im Zusammenhang mit einer UI-Aktion an.

    Tabelle : 3. Parameter
    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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

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

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    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.

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    Standard: Standard

    Tabelle : 4. Ausgabe
    Typ Beschreibung
    Zusage Wenn ein callbackParameter wird übergeben, gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler.

    Wenn ein callbackParameter wird nicht übergeben, die Methode gibt immer Erfolg zurück.

    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:


    Screenshot, der das vom Code generierte Bestätigungsmodal zeigt

    G_modal ( Next Experience) – BestätigungDestroy(Zeichenfolgentitel, Zeichenfolgennachricht, Funktionsrückruf, Stilobjekt)

    Zeigt eine Bestätigungsnachricht im Zusammenhang mit einer UI-Aktion an, wobei die Schaltfläche „Bestätigen“ einen destruktiven Stil anzeigt.

    Tabelle : 5. Parameter
    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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

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

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    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 : 6. Ausgabe
    Typ Beschreibung
    Zusage Wenn ein callbackParameter wird übergeben, gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler.

    Wenn ein callbackParameter wird nicht übergeben, die Methode gibt immer Erfolg zurück.

    Dieses Codebeispiel zeigt, wie Sie aufrufen ConfirmDestroy() Methode zum Anzeigen eines Bestätigungsmodals mit einem roten Symbol OK Schaltfläche.

    function callback(value){ 
      value ? console.log("confirm destroy callback") : console.log('cancel callback'); 
    }
    
    function onClick(g_form) {
      g_modal.confirmDestroy("Confirm Destroy Title", "Confirm Destroy Message", callback, {
        cancelTitle: "Cancel",
        confirmTitle: "Confirm",
        cancelType: "destructive",
        confirmType: "confirm"
      })
    
      .then( 
    
        function test() {
          g_form.setValue("state', '7");
        }, 
    
        function fail() {
          g_form.setValue("state", 2)
        } 
      )
    }

    Ausgabe:


    Modales Element „Vernichtung bestätigen“

    G_modal ( Next Experience) – RichText(Zeichenfolgentitel, Zeichenfolgenrichtext, Funktionsrückruf, Zeichenfolgengröße, ZeichenfolgenabbruchTitel, Zeichenfolge BestätigungTitel, Zeichenfolge cancelType, Zeichenfolge Bestätigungstyp, Objekt resizableConfig)

    Zeigt ein Modal an, das übergebenes HTML verwendet, um den Inhalt innerhalb des Modals zu generieren.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    title Zeichenfolge Optional. Titel, der im Header des Modals angezeigt werden soll.

    Standard: Leer

    RichText Zeichenfolge HTML-Inhalt, der im Modal angezeigt werden soll.
    Hinweis:
    Diese Methode entfernt ]]>Tags, Inline-JavaScript und andere Elemente, die Sicherheits-Exploits darstellen 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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

    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

    CancelType Zeichenfolge Optional. Typ der anzuzeigenden Schaltfläche „Abbrechen“.

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    Standard: Bestätigen

    Bestätigungstyp Zeichenfolge Optional. Typ der anzuzeigenden Bestätigungsschaltfläche.

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    Standard: Standard

    ResizableConfig Objekt Optional. Konfigurationsparameter zum Ändern der Größe des zugehörigen modalen Elements. Wenn Anwender die Größe des Modals nicht ändern können, übergeben Sie diesen Parameter nicht.
    resizableConfig:
      {
        enableResizable: Boolean,
        resizableMaxHeight: Number,
        resizableMaxWidth: Number,
        resizableMinHeight: Number,
        resizableMinWidth: Number 
      }

    Standard: Modales Element kann nicht skaliert werden.

    ResizableConfig. ​AktivierenGrößenanpassbar Boolean Kennzeichnung, die angibt, ob Anwender die Größe des zugehörigen modalen Elements ändern können.
    Gültige Werte:
    • Wahr: Das modale Element kann in der Größe geändert werden. Handles zur Größenänderung werden an den Rändern des Modals angezeigt.
    • Falsch: Die Größe des Modals kann nicht geändert werden.

    Standardwert: false

    ResizableConfig. ​ResizableMaxHeight Anzahl Maximale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Höhe des Fensters.

    ResizableConfig. ​ResizableMinHeight Anzahl Minimale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 600 px

    ResizableConfig. ​ResizableMaxWidth Anzahl Maximale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Breite des Fensters

    ResizableConfig. ​ResizableMinBreite Anzahl Minimale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 380 px

    Tabelle : 8. Ausgabe
    Typ Beschreibung
    Zusage Wenn ein callbackParameter wird übergeben, gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler.

    Wenn ein callbackParameter wird nicht übergeben, die Methode gibt immer Erfolg zurück.

    Das folgende Codebeispiel zeigt, wie der Text „Dies ist Rich-Text“ im zugehörigen Modal fett angezeigt wird.

    function callback(value){
      value ? console.log("confirm richtext callback") : console.log('cancel rich text callback'); 
    } 
    
    function onClick(g_form) {
      g_modal.richText("RichTextTitle", "<b>This is rich text</b>", callback, {
        cancelTitle: "Rich Cancel",
        confirmTitle: "Rich Confirm"
      }) 
    
      .then(
        function test() {
          g_form.setValue("state', '7"); 
        }, 
    
        function fail() {
          g_form.setValue("state", 2) 
        }
      )
    }

    Ausgabe:


    Rich-Text-Modal

    G_modal ( Next Experience) – ShowFields(Zeichenfolgentitel, Array-Felder, Funktionsrückruf, Zeichenfolgengröße, ZeichenfolgenabbruchTitel, Zeichenfolge BestätigungTitel, Zeichenfolge cancelType, Zeichenfolge Bestätigungstyp, Objekt resizableConfig, Zeichenfolgenanweisung)

    Zeigt ein modales Fenster an, das die angegebenen Felder und enthält OK Und Abbrechen Schaltflächen standardmäßig.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Titel Zeichenfolge Optional. Titel, der im Header des Modals angezeigt werden soll.

    Standard: „ “

    Felder Array von Objekten Liste der Felder, die im Modal angezeigt werden sollen. Jedes Feld ist in einem separaten Objekt definiert. Die fieldsParameter, die Sie übergeben, hängen vom Typ des Felds ( fields.type) Angegeben.

    Die Felder werden im Modal in derselben Reihenfolge angezeigt, in der sie im Array angezeigt werden.

    fields: [
      {
        autoFocus: Boolean,
        choices: "Array",
        display_value_list: "String",
        enableMentions: Boolean,
        label: "String",
        mandatory: Boolean,
        name: "String",
        referringTable: "String",
        referringRecordId: "String",
        type: "String",
        value: "String"
      }
    ]
    Felder. ​Autofokus Boolean Optional. Kennzeichnung, die angibt, ob das Feld beim Laden des modalen Elements standardmäßig automatisch fokussiert werden soll. Dieser Wert darf nur für ein Feld auf „wahr“ festgelegt sein.
    Gültige Werte:
    • Wahr: Autofokus.
    • Falsch: Nicht automatisch fokussieren.

    Standardwert: false

    Felder. ​Auswahlmöglichkeiten Array von Objekten Erforderlich, wenn fields.typeParameter ist auf festgelegt Auswahl . Liste der Optionen, die im zugehörigen Listenfeld angezeigt werden sollen. Jeder Eintrag in der Auswahlliste muss als separates Objekt in angegeben werden Auswahlmöglichkeiten Array.
    Zum Beispiel:
    choices: [
      {
        displayValue: "String",
        value: "String
      }
    ]
    Felder. ​Auswahlmöglichkeiten. ​Anzeigewert Zeichenfolge Optional. Wert, der im Listenfeld angezeigt werden soll.

    Standard: leer

    fields.choices.value Zeichenfolge Optional. Interner Wert des im Listenfeld angezeigten Werts.

    Standard: Null

    Felder. ​Display_value_list Array aus Zeichenfolgen Optional. Liste der anzuzeigenden Zeichenfolgen. Beispiel: [„item1“, „item2“, „item3“] .
    Felder. ​AktivierenMentionen Boolean Erforderlich, wenn fields.typeIst html . Kennzeichnung, die angibt, ob Sie einen Anwender im Modal erwähnen können.
    Gültige Werte:
    • Wahr: Anwender können im Modal erwähnt werden.
    • Falsch: Anwender können im modalen Dialogfeld nicht erwähnt werden.

    Standardwert: false

    Felder.Bezeichnung Zeichenfolge Optional. Text, der als Bezeichnung für dieses Feld im Modal angezeigt werden soll.

    Standard: leer

    Felder. ​Obligatorisch Boolean Optional. Kennzeichnung, die angibt, ob das Feld obligatorisch ist.
    Gültige Werte:
    • Wahr: Feld ist ein Pflichtfeld.
    • Falsch: Feld ist optional.

    Standardwert: false

    Felder. ​Name Zeichenfolge Interner Name des Felds. Wenn fields.typeParameter ist auf festgelegt Referenz Oder Glide_list , Ist das Referenzfeld im aktuellen Datensatz, das für die Suche verwendet wird.
    Felder​.ReferringTable Zeichenfolge Erforderlich, wenn fields.typeParameter ist auf festgelegt Referenz Oder Glide_list . Name der Tabelle, aus der Sie referenzieren.

    Beispiel: Incident

    Felder. ​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.

    Jeder Feldtyp hat einen Satz von fields.<>Elemente, die übergeben werden können. Die Werte in Klammern [ ] unten sind fieldsElemente, die von der zugeordneten unterstützt werden fieldsTyp.

    Gültige Werte:

    • boolescher wert [Autofokus, Bezeichnung, obligatorisch, Name, Wert]
    • Auswahl [Autofokus, Auswahlmöglichkeiten, Bezeichnung, obligatorisch, Name, Wert]
    • Domain_ID [label, referringRecordId, referringTable, value]
    • Glide_list [Autofokus, Display_value_list, label, Name, obligatorisch, ReferringRecordId, ReferringTable, Wert]
    • html [Autofokus, enableMentions, label, obligatorisch, Name, ReferringRecordId, ReferringTable, Wert]
    • Referenz [Autofokus, Bezeichnung, obligatorisch, Name, Referenz, ReferringRecordId, ReferringTable, Wert]
    • Zeichenfolge [Autofokus, Bezeichnung, obligatorisch, Name, Wert]
    • Textbereich [Autofokus, Bezeichnung, obligatorisch, Name, Wert]
    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

    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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

    size Zeichenfolge Optional.
    Größe des modalen Elements.
    Gültige Werte:
    • fw: Volle Breite
    • sm: 420 px x x 315 px
    • md: 600 px x x 450 px
    • lg: 800 px x x 600 px
    Hinweis:
    Wenn ein Pixelwert angegeben ist, greift das Modal den gesamten Browser auf. Beispiel: Durch die Übergabe von „1 px“ wird das Modal auf volle Breite gesetzt.

    Standard: sm

    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

    CancelType Zeichenfolge Optional. Typ der anzuzeigenden Schaltfläche „Abbrechen“.

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    Standard: Bestätigen

    Bestätigungstyp Zeichenfolge Optional. Typ der anzuzeigenden Bestätigungsschaltfläche.

    Gültige Werte:

    • Bestätigen (blauer Hintergrund)
    • Standard (weißer Hintergrund)
    • Destruktiv (roter Hintergrund)

    Standard: Standard

    ResizableConfig Objekt Optional. Konfigurationsparameter zum Ändern der Größe des zugehörigen modalen Elements. Wenn Anwender die Größe des Modals nicht ändern können, übergeben Sie diesen Parameter nicht.
    resizableConfig:
      {
        enableResizable: Boolean,
        resizableMaxHeight: Number,
        resizableMaxWidth: Number,
        resizableMinHeight: Number,
        resizableMinWidth: Number 
      }

    Standard: Modales Element kann nicht skaliert werden.

    ResizableConfig. ​AktivierenGrößenanpassbar Boolean Kennzeichnung, die angibt, ob Anwender die Größe des zugehörigen modalen Elements ändern können.
    Gültige Werte:
    • Wahr: Das modale Element kann in der Größe geändert werden. Handles zur Größenänderung werden an den Rändern des Modals angezeigt.
    • Falsch: Die Größe des Modals kann nicht geändert werden.

    Standardwert: false

    ResizableConfig. ​ResizableMaxHeight Anzahl Maximale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Höhe des Fensters.

    ResizableConfig. ​ResizableMinHeight Anzahl Minimale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 600 px

    ResizableConfig. ​ResizableMaxWidth Anzahl Maximale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Breite des Fensters

    ResizableConfig. ​ResizableMinBreite Anzahl Minimale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 380 px

    Anweisung Zeichenfolge Optional. Anweisungen zur Anzeige im Modal. Dieser Inhalt wird unter dem Titel des Modals und über dem ersten Feld im Modal angezeigt.

    Standard: Keine Anweisungen angezeigt

    Tabelle : 10. Ausgabe
    Typ Beschreibung
    Zusage Wenn ein callbackParameter wird übergeben, gibt Zusage zurück, wenn erfolgreich, andernfalls Fehler.

    Wenn ein callbackParameter wird nicht übergeben, die Methode gibt immer Erfolg zurück.

    Das folgende Beispiel zeigt, wie Sie einen Anwender mithilfe eines modalen Fensters zur Angabe eines Grunds auffordern und ihn dann an das Feld „Arbeitsnotizen“ im Datensatz zurückgeben. Die Then() Methode gibt eine Zusage zurück, die zurückgibt, was das Modal zurückgibt; FieldValues In diesem Fall. Das Feld Arbeitsnotizen auf der Client-Seite mit dem Feldwert befindet sich im UpdatedFields Array. Da nur ein Feld zurückgegeben wird, nimmt das Beispiel eine Indexposition von an 0 .

    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:

    Screenshot des modalen Elements, das vom zugeordneten Code erstellt wird.

    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:

    Screenshot des modalen Elements, das vom zugeordneten Code erstellt wird.

    Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um ein modales Element anzuzeigen, das Textbereich, Auswahlmöglichkeiten, Referenz, Glide_list und Domain_ID-Feldtypen enthält.

    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,
          referringTable: 'incident',
          referringRecordId: g_form.getUniqueValue(),
          value: g_form.getValue('caller_id')
        },
        {
          type: 'glide_list',
          name: 'watch_list',
          label: 'A list', 
          mandatory: false,
          referringTable: 'incident',
          referringRecordId: g_form.getUniqueValue(),
          value: '628,9ee1,f298d',
          display_value_list: ['item1', 'item2', 'item3']
        },
        {
          label: 'Domain ID',
          type: 'domain_id',
          value: 'c90d4b084a362312013398f051272c0d',
          displayValue: 'TOP/ACME',
          referringRecordId: '552c48888c033300964f4932b03eb092',
          referringTable: 'incident'
        }
      ];
    
      g_modal.showFields({
        title: "Enter your reason",
        fields: fields,
        size: 'lg'
      }).then(function(fieldValues) {
    
      });
    }

    Ausgabe:


    Modaler Screenshot

    G_modal ( Next Experience) – ShowFrame(Zeichenfolgentitel, Zeichenfolgen-url, Funktionsrückruf, Zeichenfolgengröße, Zeichenfolgenhöhe, Zeichenfolge modalHeight, Zeichenfolge modalWidth, boolescher Wert showClose, Zeichenfolge autoCloseOn, boolescher Wert hasLoadingMessage, boolescher Wert closeOnEscape, boolescher Wert ausblendenOverlay, Object resizableConfig)

    Zeigt ein Modal an, das einen Link zu einer externen URL oder UI-Seite für seinen Inhalt verwendet.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    title Zeichenfolge Optional. Titel, der im Header des Modals angezeigt werden soll.

    Standard: Leer

    URL Zeichenfolge URL der Informationen, die in 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, Zeichenfolge DisplayValue) 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: Keine zusätzliche Verarbeitung

    size Zeichenfolge Optional. Größe des modalen Elements.
    Gültige Werte:
    • fw: Volle Breite
    • sm: 420 px x x 253 px
    • md: 600 px x x 253 px
    • lg: 800 px x 254 px

    Standard: lg

    height Zeichenfolge Optional. Höhe des Inhaltsabschnitts im Modal. Dieser Wert hat das Format „<number> <unit>“, z. B. „80 %“ oder „300 px“. Wenn Sie nur eine Zahl übergeben, geht die Methode davon aus, dass die Maßeinheit Pixel ist.
    Gültige Maßeinheiten:
    • %
    • EM
    • Pixel
    • vh

    Standard: 100 % oder 153.75px

    ModalHöhe Zeichenfolge Optional. Höhe des Modals. Dieser Wert hat das Format „<number> <unit>“, z. B. „80 %“ oder „300 px“. Wenn Sie nur eine Zahl übergeben, geht die Methode davon aus, dass die Maßeinheit Pixel ist.
    Gültige Maßeinheiten:
    • %
    • EM
    • Pixel
    • vh

    Standard: 254 px

    ModalBreite Zeichenfolge Optional. Breite des Modals. Dieser Wert hat das Format „<number> <unit>“, z. B. „80 %“ oder „300 px“. Wenn Sie nur eine Zahl übergeben, geht die Methode davon aus, dass die Maßeinheit Pixel ist.
    Gültige Maßeinheiten:
    • %
    • EM
    • Pixel
    • vh

    Standard: 800 px

    ShowSchließen Boolean Optional. Kennzeichnung, die angibt, ob das Schließen-Symbol (X) in der oberen rechten Ecke des Modals angezeigt wird.
    Gültige Werte:
    • Wahr: Symbol „Schließen“ anzeigen.
    • Falsch: Das Schließen-Symbol nicht anzeigen.

    Standardwert: wahr

    AutoCloseOn Zeichenfolge Optional. Bedingung, unter der das modale Element automatisch geschlossen werden soll.
    Gültige Werte:
    • LEERER_KÖRPER
    • URL_CHANGED

    Standard: Modales Element nicht automatisch schließen.

    HasLoadingMessage Boolean Optional. Kennzeichnung, die angibt, ob angezeigt werden soll Wird Geladen... Nachricht im Inhalts-Slot des modalen Elements, bevor der modale Inhalt geladen wird.
    Gültige Werte:
    • Wahr: Ladenachricht anzeigen.
    • Falsch: Laden der Nachricht nicht anzeigen. Das Inhalts-Slot des Modals ist leer, bevor der Inhalt geladen wird.
    Hinweis:
    Sie können „wird geladen...“ nicht anpassen. Nachricht; konfigurieren Sie nur, ob sie angezeigt wird oder nicht.

    Standardwert: false

    CloseOnEscape Boolean Optional. Kennzeichnung, die angibt, ob der Anwender das Modal schließen kann, indem er die Esc-Taste drückt.
    Gültige Werte:
    • Wahr: Das Modal wird geschlossen, wenn der Anwender die Esc-Taste drückt.
    • Falsch: Modal wird nicht geschlossen, wenn der Anwender die Esc-Taste drückt.

    Standardwert: false

    AusblendenÜberlagerung Boolean Optional. Kennzeichnung, die angibt, ob die transparente graue Überlagerung über der Datensatzseite angezeigt werden soll.
    Gültige Werte:
    • Wahr: Blenden Sie die transparente graue Überlagerung über der Datensatzseite aus.
    • Falsch: Zeigt die transparente graue Überlagerung über der Datensatzseite an.

    Standardwert: false

    ResizableConfig Objekt Optional. Konfigurationsparameter zum Ändern der Größe des zugehörigen modalen Elements. Wenn Anwender die Größe des Modals nicht ändern können, übergeben Sie diesen Parameter nicht.
    resizableConfig:
      {
        enableResizable: Boolean,
        resizableMaxHeight: Number,
        resizableMaxWidth: Number,
        resizableMinHeight: Number,
        resizableMinWidth: Number 
      }

    Standard: Modales Element kann nicht skaliert werden.

    ResizableConfig. ​AktivierenGrößenanpassbar Boolean Kennzeichnung, die angibt, ob Anwender die Größe des zugehörigen modalen Elements ändern können.
    Gültige Werte:
    • Wahr: Das modale Element kann in der Größe geändert werden. Handles zur Größenänderung werden an den Rändern des Modals angezeigt.
    • Falsch: Die Größe des Modals kann nicht geändert werden.

    Standardwert: false

    ResizableConfig. ​ResizableMaxHeight Anzahl Maximale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Höhe des Fensters.

    ResizableConfig. ​ResizableMinHeight Anzahl Minimale größenanpassbare Höhe des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 600 px

    ResizableConfig. ​ResizableMaxWidth Anzahl Maximale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: Breite des Fensters

    ResizableConfig. ​ResizableMinBreite Anzahl Minimale größenanpassbare Breite des Modals.

    Datentyp: Zahl

    Einheit: Pixel

    Standard: 380 px

    Tabelle : 12. Ausgabe
    Typ Beschreibung
    Zusage Gibt die Zusage zurück, wenn sie erfolgreich ist, andernfalls ist ein Fehler aufgetreten. Diese Zusage wird gelöst, wenn das modale iFrame-Element geschlossen wird.

    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: 500px
      });
    }

    Ausgabe:

    Screenshot des vom Code generierten Modals

    Dieses Beispiel zeigt, wie eine eingebettete UI-Seite beim Erstellen eines modalen Elements verwendet wird. Wird verwendet Fenster.übergeordnetes Element.PostNachricht() Auf der UI-Seite, um Daten aus dem iFrame zurück an den Arbeitsbereich seit dem 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:


    Screenshot des vom Code generierten Modals