Verknüpfen Sie ein Ereignis mit einer anderen Seite

Fügen Sie dem Ziel-Ereignis-Handler in einen Link hinzu UI BuilderDamit eine Ereignisaktion eine andere Seite öffnen kann. Sie können den Ereignis-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, mit der eine andere Seite geöffnet werden soll, wenn ein Anwender darauf klickt. Die Dashboard-Übersicht ist ein Beispiel für eine solche Komponente. Komponenten wie Link zum Ziel Unterstützen Sie das Ereignis-Handle „Link zu Ziel“ nicht. Die Komponentenlink-Eigenschaft hat Priorität vor dem Link zum Ziel-Ereignis-Handler.

Erforderliche Rolle: ui_Builder_admin

Warum und wann dieser Vorgang ausgeführt wird

Um eine Ereignisaktion zum Öffnen einer anderen Seite zu konfigurieren, müssen Sie wissen, welche Seite Sie öffnen möchten, welche erforderlichen und optionalen Parameter für diese Seite sind und welche Nutzlastwerte im Ereignis-Handler festgelegt werden sollen, um die erforderlichen Parameter an die Zielseite zu übergeben.

Tipp:

Möglicherweise finden Sie Beispiele für die Komponenten, von denen Sie eine Verknüpfung herstellen möchten, und die Zielseiten, mit denen Sie einen Link erstellen möchten, in der Basis-Mitarbeiterbereich-Experience. Dies Next ExperienceWird in bereitgestellt Basissystem. 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 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, mit der die Seitenparameter verwendet werden sollen @context.props.<parameter-name> Werte.

   Sie können die Seite aus einer Seitenvorlage erstellen. Die Basis-Mitarbeiterbereich-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. 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 Konfigurationsdatensatz der Agenten-App [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 wie die Experience mit den Seitenvorlagen haben.

3. Wechseln Sie zu der Seite, die Sie mit der Zielseite verknüpfen möchten.
4. Navigieren Sie zur relevanten Komponente, und wählen Sie sie aus.
5. Wählen Sie die Registerkarte Events aus.
6. Wählen Sie Aus + Ereigniszuordnung hinzufügen .
7. Wählen Sie das Ereignis aus, das Sie verwenden möchten.
8. Wählen Sie Aus + Ereignishandler hinzufügen .
   
9. Wählen Sie im Abschnitt geerbte Ereignishandler die Option aus Link zum Ziel .
   
10. Klicken Sie Auf Wählen Sie das Ziel aus .
    
11. Erweitern Seiten Und wählen Sie die Seite in der Experience aus, mit 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 (*) markiert.
12. Füllen Sie jedes erforderliche Parameterfeld und die entsprechenden Parameterfelder mit einem entsprechenden aus @Payload.* Wert.
    Wenn die Entwickler Ihrer Komponente Standardnutzlastwerte in Ihrem Ereignis enthalten 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, mit einer externen URL zu verknüpfen, anstatt eine anzugeben App-Route .

    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 das erforderliche immer noch nicht finden können @Payload.* Werte, Kontakt Kundenservice und Support.

    Tipp:

    Wenn Sie Ihre Verknüpfungskomponente erstellen, indem Sie eine Seite aus einer Basis-Mitarbeiterbereich-Seitenvorlage erstellen, enthält die Komponente Relais-Ereignis-Handler „Link zu Ziel“. Diese Ereignis-Handler funktionieren nicht. Sie enthalten jedoch die zutreffende @Payload.* Werte für die Parameter.

Konfigurieren der Ereignishandler für eine Analytics-F&A-Komponente

Nehmen wir an, Sie möchten einen neuen nehmen Next ExperienceUnd fügen Sie eine Seite mit einer Analytics-F&A-Komponente hinzu. Zuerst erstellen Sie die Seite aus der Analytics Center-Seitenvorlage, die in der Basis-Mitarbeiterbereich-Experience bereitgestellt wird. Als Nächstes erstellen Sie eine Zielseite für das erste der drei Ereignisse in Analytics F&A und konfigurieren dann einen Ereignishandler für dieses Ereignis.

Indem Sie zu navigieren Now Experiences-Framework > Erfahrungen, Sie sehen die Test-Experience-UX Anwendung . Da dieselbe App-Shell-UI für Mitarbeiterbereich wie der Basis-Mitarbeiterbereich verwendet wird, können Sie die Seitenvorlagen aus dem Basis-Mitarbeiterbereich verwenden.

Wählen Sie als Nächstes den Administratorbereich des Testarbeitsbereichs aus, suchen Sie einen UX-App-Konfigurationsdatensatz ohne UX-App-Routen oder -Seiten, und klicken Sie dann auf Offen .

Wie das Beispiel zeigt, in UI Builder, Sie haben eine 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, nur den Inhalt der Seitenvorlage zu kopieren.

Sie wählen die Komponente Analytics F&A 1 aus und öffnen Ereignisse Registerkarte. Von hier aus können Sie öffnen Relais „Link zu Ziel“ Ereignis-Handler für Berichtsvisualisierung Angeklickt Ereignis. 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. In Route Wird angezeigt, dass das Ziel voraussichtlich eine Seite ist, die auf der Seitenvorlage „einfache Liste“ basiert. Sie sehen auch die Parameter der Seite, die @Payload.* Werte entsprechen, und denen Titel Feld kann mit ausgefüllt werden @Payload.listTitle .

Tabelle : 1. Parameter der vorgeschlagenen Zielseite für einfache Liste und entsprechende Nutzlasten

Parameter	@Payload.* Wert
Tabelle (erforderlich)	@Payload.table
listTitle	@Payload.listTitle
query	@Payload.query
disableInlineEditing	Keine

Als Nächstes navigieren Sie zu Menü > Seite erstellen Und erstellen Sie eine Seite, die auf der Vorlage „einfache Liste“ basiert. Nehmen wir an, Sie benennen die Seite als Datensatzliste. Sie folgen dann einem ähnlichen Prozess wie beim Erstellen der Analytics Center-Seite. Dieses Mal würden Sie in den letzten Schritten des Prozesses hinzufügen Tabelle Als erforderlicher Parameter und ListTitle , Abfrage , Und InlineEditing deaktivieren Als optionale Parameter.

Da diese Seite bereits eine Listenkomponente enthält, wenn Sie öffnen Konfig Registerkarte für diese Komponente sehen Sie, dass die Parameter bereits in übergeben wurden @context.props.* Werte.

Jetzt kehren Sie zur Analytics-Center-Seite zurück. In Berichtsvisualisierung Angeklickt Ereignis, fügen Sie einen neuen Ereignis-Handler hinzu. Als Nächstes wählen Sie die Datensatzlistenseite aus, die Sie erstellt haben, und fügen den hinzu @Payload.* Werte in Tabelle , ListTitle , Und Abfrage Felder, die den Informationen folgen, die Sie von erhalten haben Relais „Link zu Ziel“ Ereignis-Handler. Die prädiktive Eingabe hilft Ihnen, diese Felder auszufüllen.

Nachdem Sie auf geklickt haben OK Und hinzufügen @Payload.listTitle Als Titel , Der Ereignis-Handler ist abgeschlossen. Sie können jetzt löschen Relais „Link zu Ziel“ Ereignis-Handler für dieses Ereignis.

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. Durch Klicken auf eine Spalte wird auch ausgelöst Berichtsvisualisierung Angeklickt Ereignis. Mit dem Ereignis-Handler können Sie eine einfache Liste der Incidents im Bericht anzeigen.

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