Verknüpfen Sie ein Ereignis mit einer anderen Seite

Fügen Sie dem Zielereignishandler in UI Builder einen Link hinzu, damit eine Ereignisaktion eine andere Seite öffnen kann. Sie können den Ereignishandler auch so konfigurieren, dass er der App-Route zur gewünschten Seite folgt.

Vorbereitungen

Sie müssen über eine Arbeitsbereichsseite verfügen, die eine Komponente enthält, die eine andere Seite öffnen soll, wenn ein Anwender darauf klickt. Die Dashboard-Übersicht ist ein Beispiel für eine solche Komponente. Komponenten wie „Link zu Ziel“ unterstützen das Ereignis-Handle „Link zu Ziel “ nicht. Die Komponentenlinkeigenschaft hat Priorität gegenüber dem Link-zu-Ziel-Ereignis-Handler.

Erforderliche Rolle: ui_builder_admin

Warum und wann dieser Vorgang ausgeführt wird

Um eine Ereignisaktion so zu konfigurieren, dass eine andere Seite geöffnet wird, müssen Sie wissen, welche Seite Sie öffnen möchten, welche Parameter für diese Seite erforderlich und optional sind und welche Nutzlastwerte im Ereignishandler festgelegt werden müssen, um die erforderlichen Parameter an die Zielseite zu übergeben .

Tipp:

Möglicherweise finden Sie Beispiele für die Komponenten, von denen aus Sie eine Verknüpfung herstellen möchten, und die Zielseiten, zu denen Sie in der Basis-Mitarbeiterbereich-Experience eine Verknüpfung herstellen möchten. Next Experience wird im Basissystem] bereitgestellt. Wenn Sie eine Seite aus einer Seitenvorlage erstellen, sollten Sie nur den Inhalt der Vorlage kopieren. Verweisen Sie nicht darauf. Weitere Informationen zum Unterschied zwischen dem Kopieren und Referenzieren einer Seitenvorlage finden Sie unter Seite aus einer Vorlage erstellen.

Prozedur

1. Öffnen Sie Ihre -Experience in UI Builder.
2. Wahlweise: Wenn die Zielseite in Ihrer Experience nicht vorhanden ist, erstellen Sie eine.
   Informationen zum Erstellen von Seiten finden Sie unter Erstellen Sie eine Seite in UI Builder. Stellen Sie sicher, dass Sie die erforderlichen und optionalen Parameter für die Seite festlegen, damit Sie sie als Ziel verwenden können. Wenn eine bestimmte Komponente auf der Seite ein Ziel ist, müssen Sie diese Komponente einschließen. Sie müssen auch die Eigenschaften für die Komponente konfigurieren, um die Seitenparameter mit @context.props zu verwenden. <parameter-name> Werte.

   Sie können die Seite auch aus einer Seitenvorlage erstellen. Die Base Agent Workspace Experience verfügt über mehrere Seitenvorlagen, die bereits als Ziele für andere Komponenten konfiguriert sind. Wenn Sie eine Zielseite aus einer Vorlage erstellen, sind die Komponenten bereits mit den richtigen Eigenschaften konfiguriert. Eventuell benötigte Statusparameter oder Client-Skripts werden ebenfalls kopiert. Sie müssen die Seitenparameter hinzufügen. Sie können diese Parameter aus der zugehörigen Liste „UX-App-Routen“ im Datensatz der Agent-App-Konfiguration [sys_ux_app_config] der Experience kopieren, die die Seitenvorlagen enthält.

   Um sicherzustellen, dass die von Ihnen erstellten Seiten zuverlässig als Ziele in Ihrer Experience funktionieren, muss Ihre Experience über dieselbe App-Shell-UI verfügen wie die Experience mit den Seitenvorlagen.

3. Wechseln Sie zu der Seite, die Sie mit der Zielseite verknüpfen möchten.
4. Navigieren Sie zu der entsprechenden Komponente, und wählen Sie sie aus.
5. Wählen Sie die Registerkarte Events aus.
6. Wählen Sie + Ereigniszuordnung hinzufügen aus.
7. Wählen Sie das Ereignis aus, das Sie verwenden möchten.
8. Wählen Sie + Ereignishandler hinzufügen aus.
   
9. Wählen Sie im Abschnitt Übernommene Ereignishandler die Option Link zu Ziel aus.
   
10. Klicken Sie auf Ziel auswählen.
    
11. Erweitern Sie Seiten, und wählen Sie die Seite in der Experience aus, zu der Sie einen Link erstellen möchten.
    Für jeden der Parameter auf der Zielseite, zu der die Route führt, werden Felder angezeigt. Erforderliche Parameter sind mit einem Sternchen (*) markiert.
12. Füllen Sie jedes erforderliche Parameterfeld und die entsprechenden Parameterfelder mit einem entsprechenden @payload.* -Wert aus.
    Wenn die Entwickler Ihrer Komponente Standardnutzlastwerte in Ihr Ereignis aufgenommen haben, können Sie einen durch Autovervollständigung auswählen. Wie im folgenden Beispiel gezeigt, stimmt der Nutzlastwert möglicherweise nicht mit dem Parameternamen überein.

    

    Hinweis:

    Sie können eine Verknüpfung zu einer externen URL erstellen, anstatt eine App-Routeanzugeben.

    Wenn keine Standardwerte angegeben sind oder Sie nicht bestimmen können, welche Werte für einige Felder korrekt sind, lesen Sie die Konfigurations- und API-Dokumentation für die Komponente in ServiceNow® Developer Site. Wenn Sie die erforderlichen @payload.* -Werte immer noch nicht finden können, wenden Sie sich an Kundenservice und Support.

    Tipp:

    Wenn Sie Ihre Verknüpfungskomponente erstellen, indem Sie eine Seite aus einer Seitenvorlage des Basis-Mitarbeiterbereichs erstellen, enthält die Komponente Relais-Ereignishandler für Link zum Ziel. Diese Ereignishandler funktionieren nicht. Sie enthalten jedoch die anwendbaren @payload.*- Werte für die Parameter.

Ereignishandler für eine Analytics F&A-Komponente konfigurieren

Angenommen, Sie möchten ein neues Next Experience verwenden und eine Seite mit einer Analytics Q&A-Komponente hinzufügen. Zuerst erstellen Sie die Seite aus der Analytics Center-Seitenvorlage, die in der Base Agent Workspace-Experience bereitgestellt wird. Als Nächstes erstellen Sie eine Zielseite für das erste der drei Ereignisse in Analytics F&A und konfigurieren anschließend einen Ereignishandler für dieses Ereignis.

Durch Navigieren zu Now Experiences Framework > Erfahrungensehen Sie die Anwendung Test Experience UX . Da die gleiche App-Shell-UI des Mitarbeiterbereichs wie der Basis-Mitarbeiterbereich verwendet wird, können Sie die Seitenvorlagen aus dem Basis-Mitarbeiterbereich verwenden.

Als Nächstes wählen Sie den Administratorbereich für den Test-Arbeitsbereich aus, suchen einen UX-App-Konfigurationsdatensatz ohne UX-App-Routen oder -Seiten und klicken dann auf Öffnen.

Wie das Beispiel zeigt, haben Sie in UI Buildereine Seite mit dem Namen Analytics Center erstellt, die auf der Seitenvorlage Analytics Center aus dem Base Agent Workspace basiert. Als Nächstes wählen Sie die Option, um nur den Inhalt der Seitenvorlage zu kopieren.

Sie wählen die Komponente „Analytics F&A 1“ aus und öffnen die Registerkarte Ereignisse. Von hier aus können Sie den Ereignishandler desRelais „Link zum Ziel “ für das Ereignis „ Berichtsvisualisierung angeklickt “ öffnen. Wenn eine Frage in Analytics Q&A einen Bericht zurückgibt, können Sie dieses Ereignis auslösen, indem Sie auf einen Wert im Bericht klicken. Wenn Sie auf einen Wert klicken, wird auch eine Liste der Datensätze angezeigt, die zu diesem Wert beitragen. Im Feld Route sehen Sie, dass das Ziel voraussichtlich eine Seite ist, die auf der Seitenvorlage „Einfache Liste“ basiert. Sie sehen auch die Parameter der Seite, denen die @payload .* -Werte entsprechen und die das Feld „ Titel “ mit @payload.listTitle ausfüllenkann.

Tabelle : 1. Parameter der vorgeschlagenen Zielseite der einfachen Liste und der entsprechenden Nutzlasten

Parameter	@payload.*-Wert
Tabelle (erforderlich)	@payload.table
listTitle	@payload.listTitle
query	@nutzlast.abfrage
disableInlineEditing	Keine

Als Nächstes navigieren Sie zu Menü > Seite erstellen und erstellen Sie eine Seite, die auf der Vorlage „Einfache Liste“ basiert. Angenommen, Sie nennen die Seite Datensatzliste. Sie folgen dann einem ähnlichen Prozess wie bei der Erstellung der Analytics Center-Seite. Diesmal fügen Sie in den letzten Schritten des Prozesses „ table “ als erforderlichen Parameter sowie „listTitle“, „ query“ und „disableInlineEditing“ als optionale Parameter hinzu.

Da diese Seite bereits eine Listenkomponente enthält, sehen Sie beim Öffnen der Registerkarte „Konfiguration“ für diese Komponente, dass die Parameter bereits in den @context.props.*- Werten übergeben wurden.

Jetzt kehren Sie zur Seite „Analytics Center“ zurück. Im Ereignis „ Berichtsvisualisierung angeklickt “ fügen Sie einen neuen Ereignis-Handler hinzu. Als Nächstes wählen Sie die von Ihnen erstellte Datensatzlistenseite aus und fügen in den Feldern table, listTitleund querydie Werte @payload.* hinzu. Beachten Sie dabei die Informationen, die Sie dem Relais-Ereignis-Handler Link zum Ziel entnommen haben. Die prädiktive Eingabe hilft Ihnen, diese Felder auszufüllen.

Nachdem Sie auf OK geklickt und @payload.listTitle als Titelhinzugefügt haben, ist der Ereignishandler fertig. Sie können jetzt den Ereignishandler desRelais „Link zu Ziel “ für dieses Ereignis löschen.

Das folgende Beispiel zeigt eine Analytics Center-Seite. Auf dieser Seite können Sie eine Abfrage für Incidents nach Priorität eingeben und als Ergebnis einen Bericht abrufen. Außerdem lösen Sie durch Klicken auf eine Spalte das Ereignis „ Berichtsvisualisierung angeklickt “ aus. Mit dem Ereignis-Handler können Sie eine einfache Liste der Incidents im Bericht anzeigen.

Abbildung : 1. Das konfigurierte Ereignis „Berichtsvisualisierung angeklickt“ wird ausgelöst