Fügen Sie UI Builder-Seiten Formulare hinzu

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Verwenden Sie die Formularkomponente, um ein oder mehrere Formulare zu Seiten UI Builder hinzuzufügen.

    Fügen Sie Ihren UI Builder -Seiten Funktionalität hinzu, indem Sie Formulare einfügen. Sie definieren die Felder im Formular und ihre Eigenschaften, z. B. was sie zu Pflichtfeldern machen. Erfassen Sie dann Daten, während das Formular ausgefüllt und übermittelt wird.
    Abbildung : 1. Beispiel für Formularkomponente
    Beispiel für eine Formularkomponente mit dem Namen „Transferauftrags-Positionsaufgabe“ auf einer Seite.
    Sie können einer Seite mehrere Formulare hinzufügen. Sie können ein Formular auch einer Seite hinzufügen, die bereits eine Komponente mit einem geschachtelten Formular enthält. Beispielanwendungsfälle:
    • Erweitern Sie Datensatzseiten durch Hinzufügen einer Inline-Registerkarte mit einem Formular, das eine eigene Formular-Controller-Instanz verwendet.
    • Modale Elemente mit einem Formular auf einer Datensatzseite hinzufügen
    Bei vorhandenen Seiten mit Formularen, die in einem Release vor Xanadu ServiceNow erstellt wurden, müssen Sie eine Voreinstellung auf das ursprüngliche Formular anwenden, bevor Sie der Seite ein weiteres Formular hinzufügen. Das Anwenden der Voreinstellung ist eine Voraussetzung für das Hinzufügen mehrerer Formulare zu einer Seite und ermöglicht es, dass mehrere Formulare auf einer Seite wie erwartet funktionieren. Die Voreinstellung des Formular-Controllers sollte auf alle Formular-Controller angewendet werden.
    1. Öffnen Sie die Seite, die ein vorhandenes Formular enthält.
    2. Erweitern Sie im Daten-Drawer die Liste Datenressourcen, und wählen Sie den ursprünglichen Formular-Controller aus.

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

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

      Popup „Formular-Controller bearbeiten“ mit einem schwarzen Pfeil, der auf das Voreinstellungsfeld zeigt, und einem zweiten schwarzen Pfeil, der auf die Voreinstellungsoption für den Formular-Controller zeigt.

    5. Wählen Sie Übernehmen.
    6. Wählen Sie X aus, um das Popup „Formular-Controller bearbeiten“ zu schließen.

      Für genau einen Ihrer Formular-Controller muss die Eigenschaft „Ist der App-Shell zugeordnet“ auf „wahr“ festgelegt sein. 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 „true“ festlegen oder null Formular-Controller haben, bei denen die Eigenschaft auf „true“ festgelegt ist.

    7. Öffnen Sie die Seite, die mindestens ein Formular enthält.
    8. Wählen Sie in der Inhaltsstruktur ein Formular aus.

      Inhaltsstruktur mit schwarzen Pfeil, der auf eine Formularkomponente zeigt.

    9. Wählen Sie im Konfigurationsbereich auf der Registerkarte Konfigurieren die Option Formular-Controlleraus.

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

    10. Scrollen Sie im Popup „Formular-Controller bearbeiten“ in der Liste „Formular-Controller“ nach unten, um die Option Ist der App-Shell zugeordnet zu finden.

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

    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, die über Kenntnisse in der Behandlung von Konfliktereignissen verfügen, können die folgenden Details hilfreich finden.

    Wenn der App-Shell ismapped auf „true“ festgelegt ist, verarbeitet das Formular diese Ereignisse automatisch:
    Bildschirmstatus geändert
    • Beschreibung: Aktion, um anzugeben, dass ein Formular fehlerhaft ist.
    • Ausgabe: CTRL_RECORD#SCREEN_STATUS_CHANGED
    Aktualisierung des Konfigurationsmenüs angefordert
    • Beschreibung: Aktion zum Festlegen von Datensatzkonfigurationsmenüelementen im Avatar-Menü.
    • Ausgabe: CTRL_RECORD#UPDATE_CONFIGURATION_MENU_REQUEST
    Telefon angefordert
    • Beschreibung: Aktion zum Tätigen eines Anrufs, wenn das CTI-Plugin aktiviert ist.
    • Ausgabe: CTRL_RECORD#PHONE_REQUESTED
    Formularladestatus geändert
    • Beschreibung: Aktion zum Anzeigen eines Ladevorgangs, der sich ändert, wenn dieses Formular Daten lädt.
    • Ausgabe: CTRL_RECORD#FORM_LOADING_STATE_CHANGED

    Ausführliche Informationen zur Komponente „Formular“ und ihren Eigenschaften finden Sie unter Formularübersicht auf der Developer Site ServiceNow.