Verwalten Sie Aktionen auf UI Builder-Seiten

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

    • Erfahren Sie, wie Sie mit Ereignissen arbeiten, damit Sie Komponenten, Seiten, Datenressourcen und deklarativen Aktionen in Aktionen hinzufügen können UI Builder.

    Aktionen in UI Builder

    UI-Aktionen erzählen UI BuilderVorgehensweise bei EreignisWird ausgelöst. Ein Ereignis ist eine Aktion, die ein Anwender ausführt oder auftritt, die auf einem geschieht Seite. Verwenden Sie UI-Aktionen, um interaktive, anwenderfreundliche Schnittstellen zu erstellen, mit denen Ihre Anwender Aufgaben abschließen können. Jeweils KomponenteIst mit eigenen Ereignissen verknüpft. Ereignisse umfassen:

    • Anwender klickt auf eine Datenvisualisierung
    • Seite ruft Daten erfolgreich ab
    • Anwender wählt eine Optionsschaltfläche aus
    • Seite wird geladen

    Typen von Ereignissen, die Aktionen auslösen können.

    Ereignisse in UI Builder

    Verwenden Sie ein Ereignis, um Ihren Komponenten, Seiten und Datenressourcen Aktionen hinzuzufügen.

    • Ein Komponentenereignis ist eine Aktion, die Sie für eine Komponente eingerichtet haben. Sie richten einen Ereignis-Handler ein, um diese Komponentenaktion zu konfigurieren. Sie können beispielsweise eine Schaltflächenkomponente zu hinzufügen UI BuilderSeite. Dann können Sie einen Ereignis-Handler hinzufügen, um eine Aktion für diese Schaltfläche anzuwenden, z. B. zum Aufrufen einer Webseite.
    • Seitenereignisse führen Aktionen für die gesamte Seite aus. Sie können die folgenden Seitenereignisse konfigurieren:
      • Seitenereigniszuordnungen. Fügen Sie Warnungsbenachrichtigungen auf Ihrer Seite hinzu, entfernen oder löschen Sie sie.
      • Variantenereigniszuordnungen. Fügen Sie Warnungsbenachrichtigungen in Ihrer Seitenvariante hinzu, entfernen oder löschen Sie sie.
      • Gesendete Ereignisse. Erstellen Sie gesendete Ereignisse für Ihre Seite, um weitergeleitete Ereigniszuordnungen zu erstellen, die Ereignisse nach einem übergeordneten Ereignis-Handler modellieren. Wählen Sie einen übergeordneten Ereignis-Handler für das Ziel aus, um die Nutzlastfelder danach zu modellieren.
      • Behandelte Ereignisse. Ein behandeltes Ereignis ist ein Ereignis, das verfügbar ist und von anderen Anwendern verwendet werden kann. Nachdem Sie ein behandeltes Ereignis erstellt haben, ist es unter verfügbar Page event mappingsZur Verwendung durch andere Anwender. Sie können auch Nutzlastfelder einrichten, die Sie manuell erstellen, oder eine Vorlage für Ihr behandeltes Ereignis auswählen, z. B. ein Dialogfeld zum Öffnen oder Schließen eines modalen Dialogfelds.
    • Datenressourcen-Ereignisse ordnen Datenressourcen zu, um Informationen darüber zu benachrichtigen, wann Daten abgerufen werden.
    • Ereignisse für eine Seite oder Komponente bewirken nichts, bis das Ereignis einem oder mehreren Ereignis-Handlern zugeordnet ist.

    Ereignisfortschritt für verschiedene Arten von Ereignissen.

    Ereigniszuordnung in UI Builder

    Ordnen Sie Aktionen Ereignissen zu, z. B. Klicken auf eine Schaltfläche oder Ausfüllen eines Felds. Eine Ereigniszuordnung ist der Prozess, mit dem Sie die Nutzlast oder kontextbezogene Werte eines Ereignisses dem Objekt oder Handler zuordnen können, das bzw. der auf dieses Ereignis reagiert.

    Weitere Informationen zur Ereigniszuordnung finden Sie unter Definieren Sie Zuordnungsereignisse.

    Ereignis-Handler in UI Builder

    Ein Ereignis-Handler ist eine Aktion, die ausgeführt wird, wenn ein Ereignis auftritt. Durch die Zuordnung eines Ereignis-Handlers zu einem Ereignis geben Sie an, welche Aktion oder Aktionen ausgeführt werden sollen, wenn das Ereignis auftritt. Verwenden Sie einen Ereignis-Handler, um eine Aktion für zu konfigurieren UI BuilderSeite oder die Komponenten auf der Seite. Zum Beispiel:
    • Durch Klicken auf eine Datenvisualisierung wird eine Liste der in der Visualisierung dargestellten Datensätze geöffnet
    • Wenn Daten für eine Liste erfolgreich abgerufen werden, wird eine Warnung geöffnet, die angibt, dass der Datenabruf erfolgreich war
    • Wenn Sie eine Optionsschaltfläche auswählen, wird der Filter für eine Liste auf der Seite angepasst
    • Durch das Laden einer Seite wird ein Modal geöffnet, um die Annahme von Cookies zu bestätigen, bevor fortgefahren wird

    Wenn Sie einem einen Ereignis-Handler hinzufügen UI BuilderSeite oder Komponente können Sie verschiedene Arten von Ereignis-Handlern auswählen. Beispielsweise kann eine Schaltflächenkomponente die folgenden Arten von Ereignis-Handlern haben:

    • Geerbte Ereignis-Handler. Ein geerbter Ereignis-Handler wird auf der Seite verfügbar gemacht, auf der Sie arbeiten. Wenn Sie sich im übergeordneten Element befinden UI BuilderSeite, könnte ein geerbter Ereignis-Handler aus der App-Shell verfügbar gemacht werden. Die folgende Tabelle listet die verschiedenen Typen geerbter Ereignishandler auf, die Sie verwenden können, und was Sie damit tun können.
      Tabelle : 1. Übernommene Ereignis-Handler
      Event-Handler Beschreibung
      Breadcrumb-URL geändert
      Link zu Ziel Navigieren Sie zu einem Ziel.
      • App-Routen: Link zu einer anderen Seite in einer App, z. B. einem Startbildschirm.
      • Externe URL: Link zu einer Website oder einer externen URL.
      Beispielskript
          return {
        route: null, /* Page route, e.g. 'record' */
        fields: null, /* Required params, e.g. {"table":"incident","sysId":"X"} */
        params: null, /* Optional params, e.g. {"selectedIndex" : 1} */
        ☑️redirect: null, /* ??? True/false? */
        ☑️passiveNavigation: null, /* Load in background, e.g. 'false' */
        title: null, 
        multiInstField: null, 
        ☑️targetRoute: null, /* ??? */
        ☑️external: null /* ??? True/false? */
    };
      Parameter zu URL hinzufügen Fügen Sie einer URL zusätzliche Parameter hinzu.
      Beispielskript
      { “selectedTabIndex” : 0 }
      Modalen Dialog öffnen oder schließen Nachdem Sie ein modales Element erstellt haben, verwenden Sie Open or close modal dialogZum Auslösen des modalen Elements.
    • Ereignis-Handler auf Seitenebene. Dieser Typ von Ereignis-Handler ist für alle Seiten gemeinsam, und Sie würden diesen Handler verwenden, wenn Sie Warnungsbenachrichtigungen auf Seitenebene hinzufügen oder löschen möchten. Die folgende Tabelle listet die verschiedenen Typen von Ereignis-Handlern auf Seitenebene auf, die Sie verwenden können, und was Sie damit tun können.
      Tabelle : 2. Ereignis-Handler auf Seitenebene
      Event-Handler Beschreibung
      Warnungsbenachrichtigungen hinzufügen Fügen Sie ein Codefragment hinzu, um eine Warnungsbenachrichtigung zu senden. Zum Beispiel: 
      return {
    items: [{"type" : "info", "message" : "Info message", "id" : "optionalID"}] /* Types: info, warning, error */
};
      Entfernen Sie die Warnungsbenachrichtigung Fügen Sie Code hinzu, um Warnungsbenachrichtigungs-IDs aufzurufen, die Sie verwerfen möchten. Klicken Sie beispielsweise auf eine Schaltfläche, um eine Warnungsbenachrichtigung zum Laden einer Seite zu entfernen.
      Warnungsbenachrichtigung löschen Fügen Sie Code hinzu, um alle Warnungsbenachrichtigungs-IDs aufzurufen, die Sie verwerfen möchten. Klicken Sie beispielsweise auf eine Schaltfläche, um alle Warnungsbenachrichtigungen zu entfernen.
      Ladestatus festlegen Laden ein/aus. Sie können beispielsweise das Laden auf umschalten, um die Seite zu laden, wenn Sie auf eine Schaltfläche klicken, oder das Laden umschalten, um die Seite nicht zu laden, wenn auf eine Schaltfläche geklickt wird.
      Statusparameter des Clients aktualisieren Legen Sie den Client-Statusparameter deklarativ fest. Angenommen, Sie haben einen Client-Statusparameter, den Sie mit einem Wert eingerichtet haben. Sie können konfigurieren Update client state parameterEreignis-Handler zum Aktualisieren des Client-Statusparameters mit einem neuen Wert. Sie haben beispielsweise einen Client-Statusparameter, der aufgerufen wird Begrüßung Das mit eingerichtet ist Hallo Als Anfangswert. Sie können hinzufügen Update client state parameterEreignis-Handler, wählen Sie aus Begrüßung Client-Statusparameter, und geben Sie dann einen neuen Wert wie ein Auf Wiedersehen . Wenn Sie auf die Schaltfläche klicken, Auf Wiedersehen Ersetzt Hallo Auf der Seite.
      Laden des UXF-Macroponent-Viewports angefordert Fügen Sie einer Komponente hinzu, z. B. einer Schaltflächenkomponente, um einen Viewport zu öffnen. Weitere Informationen finden Sie unter Fügen Sie Ihrer Seite eine Viewport-Komponente hinzu.
    • Datenressourcen-Handler. Dieser Typ von Ereignis-Handler löst das Abrufen oder Schreiben von Daten auf den Server aus.
      Sie können die Daten der App-Shell-Datenquelle auf aktualisieren UI BuilderSeite durch Klicken auf eine Schaltfläche. Mit einem Datenressourcen-Handler können Sie beispielsweise die folgenden Aktionen ausführen:
      • Binden Sie Daten an die Beschreibung eines Incident-Datensatzes.
      • Ändern Sie den Wert der Incident-Beschreibung.
      • Fügen Sie Ihrer Seite eine Schaltflächenkomponente hinzu.
      • Bezeichnen Sie die Schaltfläche als Aktualisieren Sie den Incident .
      • Fügen Sie ein hinzu Look Up RecordEreignis-Handler für die Schaltfläche.
      • Speichern Sie Ihre Seite.
      • Wenn sich die Beschreibung des Incident-Datensatzes ändert, klicken Sie auf Aktualisieren Um die Beschreibung auf Ihrer Seite zu aktualisieren.
    • Client-Skripts. Skripts, die ausgeführt werden, wenn ein Ereignis für eine Komponente ausgelöst wird. Sie erstellen diese Skripts im Abschnitt Clientskripts in UI Builder. Weitere Informationen finden Sie unter Clientskripts definieren und an Komponenten binden.

    Ereignisse werden an Komponenten in gebunden UI Builder

    Binden Sie Ereignis-Handler an die Ereignisse in einer Komponente. Wenn Sie Komponenten zu hinzufügen UI BuilderSeite, sind diese Komponenten nicht für die Ausführung von Aktionen auf Ihrer Seite konfiguriert. Beispielsweise ist eine Schaltflächenkomponente statisch und führt nichts aus, bis Sie eine Ereignisaktion daran binden, z. B. das Löschen eines Datensatzes. Einige Komponenten haben mehrere Ereignisse, denen Ereignis-Handler zugewiesen werden können. Beispielsweise können Sie in der Listenkomponente einen Navigations-Handler zuweisen Row clickedEreignis. Sie können auch ein geöffnetes modales Element zuweisen Data fetch failedEreignis. Weitere Informationen finden Sie unter Binden Sie ein Ereignis an eine Komponente.

    Ereignisse werden an UI Builder-Seiten gebunden

    Binden Sie ein Ereignis auf Seitenebene, um Ereignis-Handler auf der Seite auszuführen. Verwenden Sie beispielsweise Ereignisse auf Seitenebene für Seitenbenachrichtigungen, Seitenladevorgänge oder wenn sich eine Seiteneigenschaft ändert. Die Zuweisung des Ereignis-Handlers zum Ereignis auf Seitenebene ähnelt der Zuweisung von Handlern zu Ereignissen aus Komponenten.

    Sie können Ereigniszuordnungen mit den folgenden Methoden binden:
    • Seitenereigniszuordnungen. Fügen Sie Warnungsbenachrichtigungen auf Ihrer Seite hinzu, entfernen oder löschen Sie sie.
    • Variantenereigniszuordnungen. Fügen Sie Warnungsbenachrichtigungen in Ihrer Seitenvariante hinzu, entfernen oder löschen Sie sie.
    • Gesendete Ereignisse. Erstellen Sie gesendete Ereignisse für Ihre Seite, um weitergeleitete Ereigniszuordnungen zu erstellen, die Ereignisse nach einem übergeordneten Ereignis-Handler modellieren. Wählen Sie einen übergeordneten Ereignis-Handler für das Ziel aus, um die Nutzlastfelder danach zu modellieren.
    • Behandelte Ereignisse. Fügen Sie ein behandeltes Ereignis für ein Ereignis hinzu, das verfügbar ist und von anderen Anwendern verwendet werden kann.
    Weitere Informationen finden Sie unter Binden Sie ein Ereignis an eine Seite.

    Ereignisse werden an Datenressourcen in gebunden UI Builder

    Binden Sie Ereignis-Handler an einzelne Datenressourcen auf Ihrem UI BuilderSeite. Wenn eine Datenressource beispielsweise erfolgreich neue Daten abruft, führt sie einen Ereignis-Handler wie die Navigation aus, um einen Anwender zum nächsten Schritt in einem Flow zu bringen. Wenn eine Datenressource erfolgreich einen Datensatz zu einer Tabelle hinzufügt, wird ein Erfolgs-Modal angezeigt, das den Ereignishandler „Modal anzeigen“ verwendet. Weitere Informationen finden Sie unter Binden Sie ein Ereignis an eine Datenressource.

    Ereignisse werden an deklarative Aktionen in gebunden UI Builder

    Binden Sie Datenelemente, um Ereignisaktionen zu einer deklarativen Aktionsdefinition in hinzuzufügen Aktionen Und Komponenten In ServiceNow AI Platform®. Sie können beispielsweise ein Datenelement binden, um eine Ereignisaktion hinzuzufügen, um die Arbeit an einer Tabelle abzuschließen.

    Wenn Sie eine Komponente zu hinzufügen UI BuilderSeite mit einer deklarativen Aktion. Sie müssen sie an ein behandeltes Ereignis binden. Das behandelte Ereignis erstellt eine Aktion, die ausgeführt wird, wenn ein Anwender die Komponente auswählt. Durch Auswahl Konfigurieren Sie die Ereigniszuordnung für deklarative Aktionen , Fügen Sie einen neuen Ereignis-Handler hinzu, um zu definieren, was die deklarative Aktion auf der Seite tut.

    Konfigurieren Sie die Option „Zuordnungen deklarativer Aktionsereignisse“ im Bereich „Konfigurieren“.

    Weitere Informationen finden Sie unter Ein Ereignis an eine deklarative Aktion binden.