Fügen Sie Formulare zu UI Builder-Seiten hinzu

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer

    • Verwenden Sie die Formularkomponente, um ein oder mehrere Formulare zu hinzuzufügen UI BuilderSeiten.

    Fügen Sie Funktionalität zu hinzu UI BuilderSeiten durch Einbeziehen von Formularen. Sie definieren die Felder im Formular und ihre Eigenschaften, z. B. als erforderlich festlegen. Erfassen Sie dann Daten, während das Formular ausgefüllt und übermittelt wird.
    Abbildung : 1. Beispiel für Formularkomponente
    Beispielformularkomponente mit der Bezeichnung „Aufgabe für Transferauftragsposition“ auf einer Seite.
    Sie können einer einzelnen Seite mehr als ein Formular hinzufügen. Sie können auch ein Formular zu einer Seite hinzufügen, die bereits eine Komponente mit einem geschachtelten Formular enthält. Beispiele für Anwendungsfälle:
    • Erweitern Sie Datensatzseiten, indem Sie eine Inline-Registerkarte mit einem Formular mithilfe einer eigenen Formular-Controller-Instanz hinzufügen.
    • Fügen Sie modale Elemente mit einem Formular auf einer Datensatzseite hinzu.
    Für vorhandene Seiten mit Formularen, die in einem vor-Xanadu erstellt wurden ServiceNowRelease: Sie müssen eine Voreinstellung auf das ursprüngliche Formular anwenden, bevor Sie der Seite ein weiteres Formular hinzufügen. Das Anwenden der Voreinstellung ist eine Voraussetzung, um einer Seite mehrere Formulare hinzuzufügen, und ermöglicht es, dass mehrere Formulare wie erwartet auf einer Seite funktionieren. Die Formular-Controller-Voreinstellung sollte auf alle Formular-Controller angewendet werden.
    1. Öffnen Sie die Seite mit einem vorhandenen Formular.
    2. Erweitern Sie im Datendrawer Datenressourcen Listen Sie den ursprünglichen Formular-Controller auf, und wählen Sie ihn aus.

      Daten-Drawer mit erweiterter Datenressourcenliste und schwarzem Pfeil, der auf den Formular-Controller zeigt.

    3. Wählen Sie aus Voreinstellung Feld.
    4. Wählen Sie Aus Formular-Controller-Voreinstellung .

      Popup-Fenster „Formular-Controller bearbeiten“ mit einem schwarzen Pfeil, der auf das Voreinstellungsfeld zeigt, und einem zweiten schwarzen Pfeil, der auf die Voreinstellungsoption des Formularcontrollers zeigt.

    5. Wählen Sie Übernehmen.
    6. Wählen Sie aus X Um zu schließen Bearbeiten Sie Den Formularcontroller Popup.

      Genau einer Ihrer Formular-Controller sollte über verfügen Ist der App-Shell zugeordnet Eigenschaft auf „wahr“ festgelegt. Diese Eigenschaft wird verwendet, um das primäre Formular auf der Seite anzugeben. Das primäre Formular ist für die Verarbeitung globaler Ereignisse verantwortlich. Sie sollten die Eigenschaft nicht für mehr als einen Formular-Controller auf „wahr“ festlegen oder Null-Formular-Controller mit der Eigenschaft „wahr“ haben.

    7. Öffnen Sie die Seite mit einem oder mehreren Formularen.
    8. Wählen Sie in der Inhaltsstruktur ein Formular aus.

      Inhaltsstruktur mit schwarzem Pfeil, der auf eine Formularkomponente verweist.

    9. Im Konfigurationsbereich auf Konfigurieren Registerkarte auswählen Formularcontroller .

      Formularkonfigurationsbereich mit angezeigter Registerkarte „Konfigurieren“ und einem schwarzen Pfeil, der auf den Formular-Controller-Link zeigt.

    10. Auf Bearbeiten Sie Den Formularcontroller Popup, scrollen Sie in nach unten Formularcontroller Liste, um zu suchen Ist der App-Shell zugeordnet Option.

      Das Popup-Fenster „Formular-Controller bearbeiten“ mit dem schwarzen Pfeil, der auf zeigt, ist der App-Shell-Option zugeordnet.

    11. Aktivieren oder deaktivieren Sie die Option für jede Formularkomponente auf der Seite, um zu bestätigen, dass der App-Shell genau ein Formular-Controller zugeordnet ist.

    Erweiterte Verarbeitung von Formularereignissen

    Erfahrene Entwickler mit Kenntnissen in der Handhabung von Konfliktereignissen finden die folgenden Details nützlich.

    Wenn „isMapping zu App-Shell“ auf „wahr“ festgelegt ist, verarbeitet das Formular diese Ereignisse automatisch:
    Bildschirmstatus geändert
    • Beschreibung: Aktion, die angibt, dass ein Formular fehlerhaft ist.
    • Ausgabe: STRG_RECORD#BILDSCHIRM_STATUS_CHANGED
    Update-Konfigurationsmenü Angefordert
    • Beschreibung: Aktion zum Festlegen von Datensatzkonfigurationsmenüelementen im Avatar-Menü.
    • Ausgabe: STRG_RECORD#UPDATE_CONFIGURATION_MENU_REQUEST
    Telefon Angefordert
    • Beschreibung: Aktion zum Tätigen eines Anrufs, wenn das CTI-Plugin aktiviert ist.
    • Ausgabe: STRG_RECORD#PHONE_REQUESTED
    Ladestatus Des Formulars Geändert
    • Beschreibung: Aktion zum Anzeigen einer sich drehenden Ladebewegung, wenn dieses Formular Daten lädt.
    • Ausgabe: STRG_RECORD#FORM_LOADING_STATE_CHANGED

    Detaillierte Informationen zur Formularkomponente und ihren Eigenschaften finden Sie unter Formularübersicht Auf ServiceNowEntwicklerwebsite.