Verknüpfen Sie ein Event mit einer anderen Seite

Fügen Sie einen Link zum Ziel-Event-Handler in UI Builder hinzu, damit eine Event-Aktion eine andere Seite öffnen kann. Sie können den Event Handler 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 Benutzer darauf klickt. Die Dashboard-Übersicht ist ein Beispiel für eine solche Komponente. Komponenten wie „Link zu Ziel“ unterstützen das Event-Handle „Link zu Ziel “ nicht. Die Komponenten-Link-Eigenschaft hat Priorität gegenüber dem Link zum Ziel-Ereignishandler.

Erforderliche Rolle: ui_builder_admin

Warum und wann dieser Vorgang ausgeführt wird

Um eine Event-Aktion zum Öffnen einer anderen Seite zu konfigurieren, müssen Sie wissen, welche Seite Sie öffnen möchten, was die erforderlichen und optionalen Parameter für diese Seite sind und welche Nutzlastwerte für den Event-Handler 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 einen Link erstellen möchten, und die Zielseiten, auf die Sie in der Basis-Experience des Mitarbeiterbereichs verweisen möchten. Dieser 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 Verweisen auf eine Seitenvorlage finden Sie unter Erstellen Sie eine Seite aus einer Vorlage.

Prozedur

1. Öffnen Sie Ihre Experience in UI Builder.
2. Wahlweise: Wenn die Zielseite in Ihrer Experience nicht vorhanden ist, erstellen Sie eine.
   Weitere 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 einbeziehen. 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 aus einer Seitenvorlage erstellen. Die Basis-Experience des Arbeitsbereichs für Service Desk-Mitarbeiter 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. Alle erforderlichen 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 „App-Konfiguration für Mitarbeiter“ [sys_ux_app_config] der Experience kopieren, die die Seitenvorlagen enthält.

   Um sicherzustellen, dass die Seiten, die Sie erstellen, zuverlässig als Ziele in Ihrer Experience funktionieren, muss Ihre Experience dieselbe App-Shell-UI aufweisen wie die Experience mit den Seitenvorlagen.

3. Wechseln Sie zu der Seite, die Sie mit der Zielseite verknüpfen möchten.
4. Navigieren Sie zur entsprechenden Komponente, und wählen Sie sie aus.
5. Wählen Sie die Registerkarte Events aus.
6. Wählen Sie + Event-Zuordnung hinzufügen aus.
7. Wählen Sie das Event aus, das Sie verwenden möchten.
8. Wählen Sie + Event-Handler hinzufügen.
   
9. Wählen Sie im Abschnitt „Übernommene Event-Handler“ 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.
    Felder werden für jeden der Parameter auf der Zielseite angezeigt, zu der die Route führt. Erforderliche Parameter sind mit einem Sternchen (*) gekennzeichnet.
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 Event aufgenommen haben, können Sie einen durch automatische Vervollständigung auswählen. Wie im folgenden Beispiel gezeigt, stimmt der Nutzlastwert möglicherweise nicht mit dem Parameternamen überein.

    

    Hinweis:

    Sie haben die Möglichkeit, einen Link zu einer externen URL zu erstellen, anstatt eine App-Routeanzugeben.

    Wenn keine Standardwerte angegeben sind oder Sie nicht bestimmen können, welche Werte für einige Felder korrekt sind, finden Sie weitere Informationen in der 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 Basis-Agent Workspace-Seitenvorlage erstellen, enthält die Komponente Relais-Event-Handler Link zu Ziel. Diese Ereignishandler funktionieren nicht. Sie enthalten jedoch die entsprechenden @payload.*- Werte für die Parameter.

Event Handler für eine Analytics Q&A-Komponente konfigurieren

Angenommen, Sie möchten ein neues Next Experience verwenden und eine Seite mit einer Analytics F&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 Events in Analytics F&A und konfigurieren dann einen Event Handler für dieses Event.

Durch Navigieren zu Now Experiences Framework > Erfahrungen, sehen Sie die Anwendung Test Experience UX . Da dieselbe 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 des Testarbeitsbereichs 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 Analytics Center-Seitenvorlage aus dem Basis-Mitarbeiterbereich basiert. Als Nächstes wählen Sie die Option aus, um nur den Inhalt der Seitenvorlage zu kopieren.

Sie wählen die Komponente „Analytics F&A 1“ aus und öffnen die Registerkarte Events. Hier können Sie denRelais-Ereignishandler Link zu Ziel für das Ereignis Berichtsvisualisierung angeklickt öffnen. Wenn eine Frage in Analytics F&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 dass das Titelfeld mit @payload.listTitle ausgefülltwerdenkann.

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

Parameter	@payload.* Wert
Tabelle (erforderlich)	@nutzlast.tabelle
listTitle	@Nutzlast.Listentitel
query	@nutzlast.query
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 beim Erstellen der Analytics Center-Seite. Diesmal fügen Sie in den letzten Schritten des Prozesses „ table “ als erforderlichen Parameter und „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 Analytics Center-Seite zurück. Fügen Sie im Ereignis „ Berichtvisualisierung angeklickt “ einen neuen Ereignishandler hinzu. Als Nächstes wählen Sie die von Ihnen erstellte Datensatzlistenseite aus und fügen die @payload .*- Werte in den Feldern „ table“, „listTitle“und „ query “ hinzu, indem Sie den Informationen folgen, die Sie vom Event Handler des Relais „Link zu Ziel “ erhalten haben. Die vorausschauende Eingabe hilft Ihnen beim Ausfüllen dieser Felder.

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

Das folgende Beispiel zeigt eine Analytikcenter-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 ein Ereignis Berichtsvisualisierung angeklickt aus. Mit dem Event Handler können Sie eine einfache Liste der Incidents im Bericht anzeigen.

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