Interaktiver Servicehub-Seite (gehostetes Steuerelement)

Artikel
06/27/2024

Verwenden Sie das gehostete Steuerelement Interaktive Service Hub Seite, um interaktive Formulare des Service Hubs in Unified Service Desk zu hosten und die Funktionalitäten beider Anwendungen zu integrieren. Der interaktive Servicehub bietet eine intuitive Schnittstelle und zeigt alle wesentlichen kundenbezogenen Informationen an einer Stelle an, damit sich Kundensupportmitarbeiter auf Sachen konzentrieren können, die Aufmerksamkeit erfordern.

Wenn ein interaktives Formular für den Hub innerhalb des gehosteten Steuerelements Interaktive Seite für den Hub geladen wird, wird die Seite automatisch nach Daten durchsucht und die Ersetzungsparameter werden automatisch in Unified Service Desk ausgefüllt. Der Steuerelementtyp Interaktive Servicehubseite macht eine Reihe vordefinierter UII-Aktionen und -Ereignisse verfügbar, die für die Verarbeitung von interaktiven Servicehubseiten spezifisch sind, einschließlich Aktionen zur Listenmanipulierung und Suchaktionen für die Anzeige einer Schnellsuche oder erweiterten Suchseite

Unified Service Desk bietet Ihnen das einfaches Beispielpaket Interaktives Serviceshub, das zeigt, wie leicht Sie interaktive Servicehubseiten im Unified Service Desk integriert werden können. Weitere Informationen finden Sie unter TechNet: Unified Service Desk Beispielanwendungen

Notiz

Sie können Ihren vorhandenen CRM-Seite Typ gehosteter Steuerelemente zum Typ Interaktive Servicehubseite konvertieren, um die Formulare für interaktive Funktionen anzuzeigen, die von den Formularen interaktive Erfahrung durch die interaktive Service-Hub-Anwendung anstelle der modellgesteuerten Apps-Formularen verwendet werden. Es gibt jedoch einige Überlegungen dazu, die Sie in Betracht ziehen sollten. Weitere Informationen finden Sie unter Blog: Support for Interaction Centric Forms within Unified Service Desk

Erstellen eines gehosteten Steuerelements für die interaktiver Servicehubseite

Beim Erstellen eines neuen gehosteten Steuerelements variieren die Felder auf dem Bildschirm Neues gehostetes Steuerelement basierend auf dem Typ des gehosteten Steuerelements, das Sie erstellen möchten. Dieser Abschnitt enthält Informationen zu den spezifischen Feldern für gehostete Steuerelemente des Typs Interaktive Servicehubseite. Ausführliche Informationen zum Erstellen eines Aufgabendatensatzes siehe Gehostete Steuerelement erstellen und anzeigen.

Interaktiver Servicehub-Seite gehostetes Steuerelement.

Gehen Sie im Bildschirm Neues gehostetes Steuerelement wie folgt vor:

Wählen Sie im Bereich Unified Service Desk die Option Interaktive Servicehubseite aus der Dropdownliste Unified Service Desk-Komponententyp aus.
Wählen Sie in der Dropdown-Liste Mehrere Seiten zulassen die Option Nein (Standard), um die aktuell angezeigte interaktive Seite des Service Hubs zu ersetzen und den Browserverlauf zu aktualisieren, wenn Unified Service Desk einen Aktionsaufruf zum Navigieren erhält oder eine Seite auf die Registerkarte geleitet wird. Wählen Sie Ja, um automatisch eine Dropdown-Liste zu erstellen, wenn eine zweite URL aufgerufen wird oder eine Fenster-Navigationsregel eine Seite auf die Registerkarte leitet. Dies lässt den Benutzer eine schnelle Suche zwischen den interaktiven Service Hub-Seiten zu, die mit diesem Steuerelement verbunden sind. Auch wenn Sie Ja auswählen, wird ein zusätzliches Feld Maximale Browser verfügbar, in das Sie die Höchstzahl von den in der Dropdown-Liste anzuzeigenden Seiten spezifizieren können.
IE-Prozess ist der Standard-Hostingtyp für dieses gehostete Steuerelement, und Sie können keinen weiteren Hostingtyp auswählen. Informationen über unterstützte Hosting-Methoden in Unified Service Desk finden Sie unter Wählen Sie eine Hosting-Methode für gehostete Steuerelemente.
Aktivieren Sie das Kontrollkästchen Anwendung ist global, um das gehostete Steuerelement als global festzulegen. Globale gehostete Steuerelemente können außerhalb einer Kundensitzung angezeigt werden. Steuerelemente wie das Dashboard des Agenten, Pinnwand oder Suche sind typische Einsatzgebiete für gehostete Steuerelemente. Globale Steuerelemente haben keinen sitzungsspezifischen Status; wenn Sie Sitzungen wechseln, bleiben die gehosteten Steuerelemente daher bestehen. Wenn das Kontrollkästchen nicht aktiviert ist, wird das gehostete Steuerelement sitzungsbasiert. Sitzungsbasierte Steuerelemente bestehen im Kontext mit Kundensitzungen. Wenn der Benutzer in eine andere Sitzung wechselt, werden alle Sitzungsseiten der vorherigen Sitzung ausgeblendet.
Das Feld Anzeigegruppe zeigt das Fenster an, in dem dieses gehostete Steuerelement angezeigt wird. MainPanel ist der üblichste Ort für diese Art gehosteter Steuerelemente. Informationen über die verschiedenen in Unified Service Desk verfügbaren Bedienfelder finden Sie unter Bedienfelder, Bedienfeldtypen und Bedienfeldlayouts in Unified Service Desk.
Wählen Sie Ja oder Nein in der Liste Anwendung ist dynamisch aus, um anzugeben, ob es ein dynamisches gehostetes Steuerelement ist. Steuerelemente von Dynamics ermöglichen einem Agenten bei Bedarf ein gehostetes Steuerelement zu starten oder zu schließen, entweder über die UI oder programmgesteuert über Code. Weitere Informationen: Dynamische Unified Service Desk-gehostete Steuerelemente

Wenn Sie Ja auswählen, wird das Kontrollkästchen Benutzer kann schließen verfügbar. Wählen Sie dieses Kontrollkästchen aus, damit Benutzer dieses gehostete Steuerelement schließen können.

Informationen zu den Allgemein Feldern finden Sie unter Gehostete Steuerelemente erstellen oder bearbeiten

Vordefinierte UII-Aktionen

Dies sind die vordefinierten Aktionen für diese Art gehosteter Steuerelemente.

Notiz

Der gehostete Steuerelementtyp Interaktive Servicehubseite unterstützt alle UII-Aktionen, die vom gehosteten Steuerelementtyp CRM Seite unterstützt werden. Jedoch sind einige UII-Aktionen nicht verfügbar, wenn Sie zum ersten Mal eine Instanz des gehosteten Steuerelementtyps Interaktive Servicehubseite erstellen und speichern. Jede folgende Aktualisierung der gehosteten Steuerelementinstanz fügt die fehlenden UII-Aktionen hinzu.

AssociatedView

Diese Aktion lädt eine bestimmte zugewiesene Ansicht des interaktiven Servicehubs. Auf diese Ansichten wird normalerweise durch Klicken auf den Abwärtspfeil neben dem Namen eines Entitätsdatensatzes auf der Navigationsleiste und die Auswahl der zugehörigen Entitäten zugegriffen.

Parameter	Beschreibung
`navItemName`	Die zugehörige Entität, die Sie anzeigen möchten. Beispiel: Anfragen
`Id`	Die ID des Hauptentitätsdatensatzes, für den die zugehörigen Entitätsdatensätze angezeigt werden sollen.
`tabset`	Der Bereich in den modellgesteuerten Apps. Beispiele: areaSales oder areaService.

Schließen

Durch diese Aktion wird das gehostete Steuerelement geschlossen. Im Gegensatz zur CloseActive-Aktion gilt: Wenn diese Registerkarte (gehostetes Steuerelement) mehr als eine Seite anzeigt, werden alle auf der Registerkarte in Ihrer Clientanwendung angezeigten Seiten geschlossen.

CloseActive

Diese Aktion wird verwendet, um das aktive Fenster innerhalb dieses gehosteten Steuerelements zu schließen. Wenn das aktive Fenster das einzige in dem gehosteten Steuerelement angezeigte Fenster ist, wird das gehostete Steuerelement selbst geschlossen. Wenn Sie keine mehrfachen Seiten für gehostete Steuerelemente (Mehrere Seiten erlauben = Nein) zulassen, entspricht diese Aktion der Aktion Schließen.

CloseAndPrompt

Diese Aktion fordert den Benutzer auf, die Änderungen vor dem Schließen des gehosteten Steuerelements zu speichern oder zu verwerfen.

Suchen

Navigieren Sie zur Schnellsuchelistenansicht der angegebenen Entität.

Parameter Beschreibung

Der Datenparameter sollte den logischen Namen der Entität der anzuzeigenden Schnellsuchenlistenansicht angeben. Es gibt außerdem einige Werte für spezialle Fälle:

Verwenden Sie case oder incident, um die Schnellsuchelistenansicht für Anfragen anzuzeigen.

Verwenden Sie advfind zur Anzeige der erweiterten Suchansicht.

Verwenden Sie activities oder activity, um die Schnellsuchelistenansicht für Aktivitäten anzuzeigen.

Parameter	Beschreibung
	Der Datenparameter sollte den logischen Namen der Entität der anzuzeigenden Schnellsuchenlistenansicht angeben. Es gibt außerdem einige Werte für spezialle Fälle: Verwenden Sie `case` oder `incident`, um die Schnellsuchelistenansicht für Anfragen anzuzeigen. Verwenden Sie `advfind` zur Anzeige der erweiterten Suchansicht. Verwenden Sie `activities` oder `activity`, um die Schnellsuchelistenansicht für Aktivitäten anzuzeigen.

FireEvent

Löst ein benutzerdefiniertes Ereignis von diesem gehosteten Steuerelement aus.

Parameter	Beschreibung
`name`	Name des benutzerdefinierten Ereignisses.

Alle folgenden Name=Wert-Paare werden die Parameter des Ereignisses. Weitere Informationen zum Erstellen eines benutzerdefinierten Berichts Ereignisses.

GetSelectedCount

Diese Aktion ruft die Anzahl der Elemente ab, die ausgewählt werden. Verwenden Sie die Aktion GetSelectedIds, um die Liste der tatsächlichen IDs für die Entität abzurufen.

Parameter	Beschreibung
	Der Datenparameter sollte den Listennamen zur Erfassung der ausgewählten IDs angeben.

Der Rückgabewert enthält eine Zahl, die die Menge der ausgewählten Elemente angibt.

GetSelectedIds

Diese Aktion wird zur Erfassung der ausgewählten IDs aus den Listen verwendet.

Parameter	Beschreibung
	Der Datenparameter sollte den Listennamen zur Erfassung der ausgewählten IDs angeben.

Der Rückgabewert enthält eine durch Semikolon getrennte Liste mit ID, die die ausgewählten Elemente enthalten.

GoBack

Diese Aktion ist mit dem Anklicken der Zurückschaltfläche im interaktiven Servicehub identisch. Damit gelangen Sie zurück zum Navigationsstapel des interaktiven Servicehubs.

GoHome

Mit dieser Aktion gelangen Sie zur Startseite, die vom Benutzer in modellgesteuerten Apps angegeben wurde.

MoveToPanel

Diese Aktionen wird verwendet, um gehostete Steuerelemente zur Laufzeit zwischen Bereichen zu verschieben.

Parameter	Beschreibung
App	Name des zu verschiebenden gehosteten Steuerelements.
Bereich	Zielbereich für das gehostete Steuerelement.

Navigieren

Diese Aktion wird verwendet, um zur interaktiven Servicehub-URL zu gelangen.

Parameter	Beschreibung
URL	Die URL, zu der navigiert werden soll. Dieser Parameter ist erforderlich.
Noscan	Wenn dieser Parameter und True angegeben sind, werden die Datenparameter nicht von der Seite erfasst.
HideCommandBar	Wenn dieser Parameter bereitgestellt wird und Wahr ist, wird der innere Rahmen angezeigt ohne die Befehlsleiste für den interaktiven Servicehub zu laden.
HideNavigationBar	Wenn dieser Parameter bereitgestellt wird und Wahr ist, wird das Formular angezeigt ohne die Navigationsleiste für den interaktiven Servicehub zu laden.
Daten bereitstellen	Daten, die an den Server als Bestandteil einer HTTPOST-Transaktion gesendet werden. Eine POST-Transaktion wird normalerweise verwendet, um die Daten zu senden, die über eine HTML-Seite gesammelt werden. In Unified Service Desk können diese Daten von jedem Ereignis empfangen werden, das mit „`<https://event/?>`“ ausgelöst wird. Beispiel: `[[postdata]+]` Sie können die Daten alternativ als codierte Zeichenfolge mit dem Kopfzeilentyp im beabsichtigten Format übergeben.
Kopfzeile	Ein Zeichenfolgenwert, der zusätzliche HTTP-Kopfzeilen enthält, um sie an den Server zu senden. Wenn der Parameter `postdata` in der `Navigate`-Aktion verwendet wird, sollten Sie auch einen entsprechenden Wert für den Parameter `header` angeben. Beispiel: `Content-Type:application/x-www-form-urlencoded` Wenn ein Unified Service Desk POST Ereignis die Aktion `Navigate` auslöst, sollte der Standardwert dieses Parameters `header=[[header]+]` sein.

New_CRM_Page

Erstellt eine Seite zum Erstellen eines neuen Datensatzes der angegebenen Entität und behandelt die Seite als Popup von dem angegebenen gehosteten Steuerelement. Die Fensternavigationsregeln werden geprüft, um den Standort zu ermitteln, an dem die Seite für die Erstellung des Entitätsdatensatzes angezeigt wird.

Sie können Attribut-Werte in name=value-Paaren als Datenparameter für diese Aktion übergeben. Beispiel:

LogicalName=incident  
title=Sample Case

Open_CRM_Page

Öffnet eine neue vorhandene Instanz der angegebenen und von der ID identifizierten Entität und behandelt die Seite wie ein Popup vom angegebenen gehosteten Steuerelement. Die Fensternavigationsregeln werden evaluiert, um den Standort zu bestimmen, an dem das Popup angezeigt werden soll.

Parameter	Beschreibung
LogicalName	Der logische Name der zu öffnenden Entität
id	Die ID des zu öffnenden Entitätsdatensatzes.

Zeigt eine URL aus dem gehosteten Steuerelement an und führt die Fensternavigationsregeln dafür aus, um das Popup an den richtigen Ort zu leiten.

Parameter	Beschreibung
URL	Leitet ein Popup von diesem gehosteten Steuerelement mit dieser URL weiter, als wäre dies ein von dem angezeigten Steuerelement angefragtes Popup.

RealignWindow

Zeigt das gehostete Steuerelement an der angegebenen Stelle auf einem Bildschirm. Sie können das gehostete Steuerelement auf bis zu zwei Monitoren anzeigen. Diese Aktion ist für gehostete Steuerelementinstanzen verfügbar, die zur Platzierung in einem Bereich des Typs USDFloatingPanel oder USDFloatingToolPanel konfiguriert sind.

Parameter	Beschreibung
Bildschirm	Gibt den Bildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 1 oder 2. Wird dieser Parameter nicht angegeben, wird 1 als Standard verwendet.
left	Gibt die Position in Prozent von der linken Bildschirmkante auf dem Zielbildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 0–100. Wird dieser Parameter nicht angegeben, wird 0 als Standard verwendet.
oben	Gibt die Position in Prozent von der oberen Bildschirmkante auf dem Zielbildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Gültige Werte sind 0–100. Wird dieser Parameter nicht angegeben, wird 0 als Standard verwendet.
width	Gibt die Breite in Prozent auf dem Zielbildschirm an, die das gehostete Steuerelement haben soll. Gültige Werte sind 1–100. Wird dieser Parameter nicht angegeben, wird 100 als Standard verwendet.
height	Gibt die Höhe in Prozent auf dem Zielbildschirm an, die das gehostete Steuerelement haben soll. Gültige Werte sind 1–100. Wird dieser Parameter nicht angegeben, wird 100 als Standard verwendet.

Aktualisieren

Durch diese Aktion wird die aktuelle Seite aktualisiert.

ReRoute

Hierdurch wird die derzeit angezeigte URL durch die Fensternavigationsregeln von dem aktuellen gehosteten Steuerelement gesendet, als würde es sich um ein Popup handeln.

RunScript

Durch diese Aktion wird JavaScript in den Hauptrahmen der Anwendung eingefügt. Vermeiden Sie die Verwendung von Microsoft Dataverse-Client-SDK-Aufrufen mit dieser Aktion; verwenden Sie stattdessen die Aktion RunXrmCommand.

Parameter	Beschreibung
	Der Datenparameter ist das JavaScript, das in das Formular eingefügt wird. Die Ersetzungsparameter können im Skript verwendet werden und ersetzt werden, bevor das Skript ausgeführt wird.

RunXrmCommand

Diese Aktion wird verwendet, um Dataverse-SDK JavaScript in das Formular des interaktiven Servicehubs zu injizieren.

Parameter	Beschreibung
	Der Datenparameter ist das JavaScript, das in das Formular eingefügt wird. Die Ersetzungsparameter können im Skript verwendet werden und ersetzt werden, bevor das Skript ausgeführt wird.

Speichern

Diese Aktion speichert die derzeitigen Daten auf dem Formular des interaktiven Servicehubs.

SaveAll

Mit dieser Aktion werden alle Formulare in dem gehosteten Steuerelement gespeichert, das die Anzeige mehrerer Seiten erlaubt(Mehrere Seiten erlauben = Ja). Wenn das gehostete Steuerelement nur die Anzeige einer Seite erlaubt (Mehrere Seiten erlauben = Nein), ist dies äquivalent mit der Aktion Speichern.

SaveAndClose

Hierdurch werden die derzeitigen Daten im Formular des interaktiven Servicehubs gespeichert und das gehostete Steuerelement geschlossen.

SetSize

Diese Aktion legt explizit die Breite und Höhe des gehosteten Steuerelements fest. Dies ist besonders dann nützlich, wenn Sie in Ihren Bereichslayouts "Auto" verwenden.

Parameter	Beschreibung
`width`	Die Breite des gehosteten Steuerelements.
`height`	Die Höhe des gehosteten Steuerelements.

Vordefinierte Ereignisse

Das folgenden vordefinierten Ereignisse sind mit dem gehosteten Steuerelement dieses Typs verknüpft.

ActiveClosed

Tritt auf, wenn das aktive gehostete Steuerelement mit der Aktion CloseActive geschlossen wird.

Parameter	Beschreibung
`url`	Die URL, die in dem gehosteten Steuerelement angezeigt wurde, als es geschlossen wurde.

DataReady

Tritt auf, nachdem die Daten auf der interaktiven Servicehubseite in der Ersatzparameterliste gespeichert worden sind.

Parameter	Beschreibung
`url`	Die URL der Seite.

NavigationRequested

Tritt auf, wenn Navigation innerhalb des interaktiven Servicehubs auftritt.

Parameter	Beschreibung
`url`	Das URL der Seite, zu der navigiert wird.

RefreshRequested

Tritt auf, wenn eine Aktualisierung auf der aktuellen Seite angefragt wird. Die Aktualisierung kann mithilfe der Taste F5 oder durch Aufruf der Aktualisierungsaktion durch die Anwendung angefragt werden.

Parameter	Beschreibung
`url`	Die URL, die angezeigt wurde, als die Aktualisierung angefragt wurde.

Gespeichert

Tritt auf, nachdem eine Aufzeichnung in der interaktiven Servicehubseite gespeichert ist.

Parameter	Beschreibung
`newId`	Die ID des neu erstellten Datensatzes.

Siehe auch

Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen
CRM Seite (gehostetes Steuerelement)

Freigeben über