Freigeben über

Seite mit einheitlicher Oberfläche (gehostetes Steuerelement)

  • Artikel

Verwenden Sie das gehostete Steuerelement vom Typ der Seite mit einheitlicher Oberfläche, um eine URL oder Seite aus Apps mit einheitlicher Oberfläche in modellgesteuerten Apps zu laden. Wenn eine modellgesteuerte App-Seite innerhalb eines gehosteten Steuerelements dieses Typs geladen wird, wird die Seite automatisch nach Daten für die Entität durchsucht, und die Ersetzungsparameter automatisch ausgefüllt.

Dieses gehostete Steuerelement stellt eine Reihe von vordefinierten UII-Aktionen und Ereignissen zur Verfügung, die für die Handhabung modellbasierter Apps Windows einzigartig sind. Dazu gehören Aktionen zur Listenmanipulation und eine Suchaktion zur Anzeige einer Schnellsuche oder einer erweiterten Suchseite.

Einheitliche Oberflächenseite gehostetes Steuerelement erstellen

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 Einheitliche Obeflächenseite.

Gehen Sie auf der Anzeige Neues gehostetes Steuerelement wie folgt vor:

  • Wählen Sie im Bereich Unified Service Desk aus der Dropdown-Liste Unified Service Desk Komponententyp die Option Unified Benutzeroberfläche Seite.

  • Wählen Sie Daten im Voraus abrufen, um die zu einem Entitätsdatensatz zugehörigen Informationen im Kontext zusammen mit der Entitätsdatensatzseite zu laden, ohne darauf warten zu müssen, dass die vollständige Entitätswebseite in der Client-Anwendung geladen wird. Die abgerufenen Informationen zur Entität werden in den Unified Service Desk-Kontext eingefügt, so dass jedes gehostete Steuerelement die relevanten Informationen zur Entität in der Client-Anwendung schnell anzeigen kann. Dies kann Hilfe-Agents dabei helfen, sofort zu reagieren oder Gespräche mit Kunden zu beginnen, wodurch wichtige Interaktionszeit eingespart wird.

  • Wählen Sie in der Dropdown-Liste Mehrere Seiten zulassen die Option Nein (Standard), um die aktuell angezeigte modellbasierte App-Seite zu ersetzen und den Browserverlauf zu aktualisieren, wenn Unified Service Desk einen Aufruf der Navigationsaktion erhält oder eine Seite auf die Registerkarte weitergeleitet wird. Wählen Sie Ja, um automatisch eine Dropdown-Liste zu erstellen, wenn eine zweite URL aufgerufen wird oder eine Fensternavigationsregel eine Seite auf die Registerkarte leitet. Dies lässt eine schnelle Suche zwischen den modellbasierten App-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.

  • Im Bereich Allgemeine Eigenschaften wählen Sie das Kontrollkästchen Anwendung ist global aus, um das gehostete Steuerelement als global festzulegen. Globale gehostete Steuerelemente können außerhalb einer Kundensitzung angezeigt werden. Steuerelemente wie das Dashboard, die Pinnwand oder Suche des Agent sind typische Einsatzgebiete für gehostete Steuerelemente. Globale Steuerelemente haben keinen sitzungsspezifischen Status. Wenn Sie Sitzungen wechseln, bleiben die gehosteten Steuerelemente daher bestehen. Wenn dieses 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 Seiten der vorherigen Sitzung ausgeblendet.

  • Das Feld Anzeigegruppe zeigt das Fenster an, in dem dieses gehostete Steuerelement angezeigt wird. MainPanel ist die üblichste Wahl für diese Art gehosteter Steuerelemente.

Weitere Information: Erstellen oder Bearbeiten eines gehosteten Steuerelements

Vordefinierte UII-Aktionen

Im Folgenden finden Sie die vordefinierten Aktionen für diese Art gehosteter Steuerelemente.

AssociatedView

Durch diese Aktion wird eine bestimmte zugeordnete Ansicht geladen. Auf diese Ansichten wird normalerweise durch Erweitern des Entitätsdatensatzes auf der Navigationsleiste und die Auswahl der zugehörigen Entitäten zugegriffen.

Parameter Beschreibung
etn Der Name der Entität, für die Sie die Datensatzliste der zugeordneten Entität laden möchten. Dieser Parameter ist erforderlich.
Kennung Die ID des Hauptentitätsdatensatzes, für den die zugehörigen Entitätsdatensätze angezeigt werden sollen.
navItemId Die ID des Navigationselements gemäß der zugeordneten Entität. Weitere Informationen: formContext.ui.navigation
HideCommandBar Wenn dieser Parameter bereitgestellt wird und False ist, wird die Seite zusammen mit der modellgesteuerten App angezeigt.
hideNavigationBar Wenn dieser Parameter bereitgestellt wird und False ist, wird die Seite zusammen mit der modellgesteuerten Navigationsleiste angezeigt.

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, schließt diese Aktion alle auf der Registerkarte in Ihrer Client-Anwendung angezeigten Seiten.

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. Für gehostete Steuerelemente vom Typ der Seite mit einheitlicher Oberfläche, die nicht mehrere Seiten zulassen (Mehrere Seiten erlauben = Nein), entspricht diese Aktion der Aktion Schließen.

CloseAndPrompt

Diese Aktion schließt das gehostete Steuerelement, fordert den Benutzer jedoch auf, seine Änderungen vor dem Schließen zu speichern oder zu verwerfen.

Sunden

Navigieren Sie zur Schnellsuchelistenansicht der angegebenen Entität.

Parameter Beschreibung
Siehe 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 Fall oder Vorfall, um die Schnellsuchelistenansicht für Fälle anzuzeigen.
- Verwenden Sie Aktivitäten oder Aktivität, um die Schnellsuchelistenansicht für Aktivitäten anzuzeigen.
hideNavigationBar Auf „Wahr“ setzen, um die Navigationsleiste auszublenden, sonst auf „Falsch“.
HideCommandBar Auf „Wahr“ setzen, um die Befehlsleiste auszublenden, sonst auf „Falsch“.

FireEvent

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

Parameter Beschreibung
Name Der Name des benutzerdefinierten Ereignisses.

Alle folgenden Namen-/Wertpaare werden die Parameter des Ereignisses. Weitere Informationen: Benutzerdefinierte Ereignisse erstellen

GetSelectedIds

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

Parameter Beschreibung
Siehe Beschreibung Der Datenparameter sollte den Namen der Liste angeben, von der die ausgewählten ID erfasst werden sollen.

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

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
Siehe Beschreibung Der Datenparameter sollte den Namen der Liste angeben, von der aus die ausgewählten ID abgerufen werden sollen.

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

GoHome

Diese Aktion wechselt zur anfänglichen URL, die für diese Browserinstanz angegeben wurde.

GoBack

Diese Aktion entspricht dem Auswählen der Zurück-Schaltfläche in der Browserinstanz.

GoForward

Diese Aktion entspricht dem Auswählen der Zurück-Schaltfläche in der Browserinstanz.

MoveToPanel

Diese Aktion verschiebt ein gehostetes Steuerelement einer Einheitlichen Oberflächenseite auf einen anderen Bereich zur Laufzeit.

Parameter Beschreibung
Siehe Beschreibung Der Datenparameter sollte den Zielbereichsnamen definieren, um das gehostete Steuerelement zu verschieben (z. B. FloatingPanel).

Durch diese Aktion wird zu einer modellgesteuerten App-URL navigiert. Die App-ID für die App, die Sie im Fenster App-Modul auswählen auswählen, wird automatisch angehängt.

Parameter Beschreibung
URL Die URL, zu der navigiert werden soll. Dieser Parameter ist erforderlich.
HideCommandBar Wenn dieser Parameter bereitgestellt wird und Wahr ist, wird der innere Rahmen angezeigt ohne die Befehlsleiste für modellgesteuerte Apps zu laden.
HideNavigationBar Wenn dieser Parameter bereitgestellt wird und Wahr ist, wird das Formular angezeigt ohne die Befehlsleiste für modellgesteuerte Apps zu laden.
Rahmen Wenn auf der Seite Rahmen vorhanden sind, gibt dieser Parameter den Namen des zu navigierenden Rahmens an und navigiert nicht zum Hauptfenster.
Daten bereitstellen Daten, die an den Server als Bestandteil einer HTTP POST-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 durch die Verwendung von „`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 postdata-Parameter in der Navigieren-Aktion verwendet wird, sollten Sie auch einen geeigneten Wert für den Header-Parameter angeben, z. B. Inhaltstyp: application/x-www-form-urlencoded.

Wenn ein Unified Service Desk-POST-Ereignis die Navigieren-Aktion auslöst, sollte der Standardwert dieses Parameters header=[[header]+] sein.

Um mehrere Header hinzuzufügen, sollte der Wert dieses Parameters wie folgt lauten:

header=$Multiline(Kopfzeilen durch Zeilenumbruch getrennt )

Beispiel: header=$Multiline(accessToken;dummyAccessToken==

refreshToken;dummyRefreshToken===)

New_CRM_Page

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

Parameter Beschreibung
LogicalName Der logische Name der Entität zum Erstellen einer neuen Instanz.

Notiz

Der Rest der Parameter sollte aus Namen-/Wert-Paaren bestehen. Dies sind die zusätzlichen vorausgefüllten Werte im Formular zum Erstellen eines neuen Datensatztyps für die angegebene Entität.

Open_CRM_Page

Öffnet eine neue vorhandene Instanz der angegebenen und von der ID identifizierten Entität und behandelt die Seite wie ein Popup-Fenster vom angegebenen gehosteten Steuerelement. Die Fensternavigationsregeln werden evaluiert, um den Standort zu bestimmen, an dem das Popup-Fenster 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-Fenster an den richtigen Ort zu leiten.

Parameter Beschreibung
URL Leitet ein Popup-Fenster von diesem gehosteten Steuerelement mit dieser URL weiter, als wäre dies ein von dem angezeigten Steuerelement angefragtes Popup-Fenster.
frame Der Rahmen, von dem dieses Popup-Fenster stammt.

RealignWindow

Zeigt das gehostete Steuerelement an der angegebenen Stelle auf einem Bildschirm. Sie können die gehostete Steuerelemente 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.
links Gibt die Position in Prozent von der linken Bildschirmkante auf dem Zielbildschirm an, auf dem das gehostete Steuerelement angezeigt werden soll. Die gültigen Werte reichen von 0 bis 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. Die gültigen Werte reichen von 0 bis 100. Wird dieser Parameter nicht angegeben, wird 0 als Standard verwendet.
Breite Gibt die Breite in Prozent auf dem Zielbildschirm an, die das gehostete Steuerelement haben soll. Die gültigen Werte reichen von 1 bis 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. Die gültigen Werte reichen von 1 bis 100. Wird dieser Parameter nicht angegeben, wird 100 als Standard verwendet.

Refresh

Durch diese Aktion wird die aktuelle Seite aktualisiert.

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
Siehe Beschreibung Der Datenparameter ist das JavaScript, das in das Formular eingefügt wird. Hinweis: Beachten Sie, dass Ersetzungsparameter im Skript verwendet werden können und ersetzt werden, bevor das Skript ausgeführt wird.
Rahmen Wenn auf der Seite Rahmen vorhanden sind, gibt dieser Parameter den Namen des Rahmens an, in dem JavaScript ausgeführt werden soll.

RunXrmCommand

Diese Aktion wird verwendet, um JavaScript Code auszuführen, der in modellgesteuerten Apps Client API Reference in der Einheitlichen Oberflächenseite (Entitätsformular und Raster) verwendet wird.

Sie müssen das Skript als Funktion von modellgesteuerten Apps JavaScript Webresssource konfigurieren. Der erste Parameter der Funktionen steht ein Kontextparameter (Parameter reservierter), der einen der folgenden Werte haben kann:

  • FormContext auf Entitätsformularseiten
  • GridContext auf Entitätsrasterseiten
  • nicht definiert auf anderen Seiten
Parameter Beschreibung
webResourceName Der Namen der Webressource, in der die JavaScript-Funktion, die Sie ausführen möchten, vorhanden ist.
functionName Der Name der Funktion.

Die anderen Parameter zur Funktion sind vom Kunden definiert und können verwendet werden, um Ersetzungsparameter des Unified Service Desk zur Runtime zu übergeben. Diese Aktion akzeptiert eine Liste optionaler Parameter ohne Schlüssel. Die Liste optionaler Parameter werden wie Anfragen in derselben Reihenfolge von der zweiten Position nach Kontextersetzung zur Runtime übergeben.

Beispiel

Sie möchten die RunXrmCommand-Aktion ausführen, um die Formularattribute eines Entitätsformulars auszufüllen, wobei das Entitätsformular von einem gehosteten Steuerelement vom Typ der Seite der einheitlichen Oberfläche gehostet wird. Der Wert, den Sie aus der Sicht von Unified Service Desk füllen möchten, ist ein Ersatzparameter - [[$Context.Key1]].

Um die Aktion auszuführen, müssen Sie JavaScript vom Typ Webressource schreiben (z. B. webResource1) und dann eine Funktion in der Webressource schreiben.

function fillAttributeValue(context, attrValue)
{
 context.getAttribute(<attributeName>).setValue(attrValue);
}   

Sie müssen die Daten im Aktionsanruf konfigurieren, wie folgt:

webResourceName = webResource1
functionName = fillAttributeValue
'[[$Context.Key1]]'

Notiz

Achten Sie im oben aufgeführten Beispiel auf die einfachen Anführungszeichen um den Ersetzungsparameter [[$Context.Key1]]. Unified Service Desk berücksichtigt nur den Wert des Parameters (nicht den Datentyp) und übergibt der JavaScript-Funktion alle Zeichen des im Kontext ersetzten Wertes. Sie sollten vorsichtig sein und sich um den Datentyp beim Konfigurieren kümmern.

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
Breite Die Breite des gehosteten Steuerelements.
height Die Höhe des gehosteten Steuerelements.

SaveAndClose

Hierdurch werden die ungültigen Daten im modellgesteuerten Apps-Formular gespeichert und das gehostete Steuerelement geschlossen.

SaveAll

Mit dieser Aktion werden alle Formulare in einem 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.

Speichern

Durch diese Aktion wird die aktuelle Einheitliche Oberflächenseite gespeichert.

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 ein, sobald die zugehörigen Informationen für einen Datensatz einer Entität in den Unified Service Desk-Kontext geladen werden. Dieses Ereignis tritt vor PageReadyFor Ereignis auf. Wenn die Option Daten vorab Abrufen für die Steuerelementinstanz aktiviert ist, kommt es zu diesem Ereignis, sobald die Entitätsdaten in einem anderen parallelen Aufruf des Servers abgerufen werden. Es wird dann nicht gewartet, bis die ganze Seite geladen wurde. Die Entitätsdaten werden vorab abgerufen und das DataReady-Ereignis wird für die Inline-Navigation ausgelöst.

Notiz

Bei Dashboards, Webressourcen und Suchseiten wird das DataReady-Ereignis nicht ausgelöst.

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 modellgesteuerten Apps-Seite gespeichert ist.

Parameter Beschreibung
newId Die ID des neu erstellten Datensatzes.

Tritt auf, wenn die Navigation innerhalb der Apps mit einheitlicher Oberfläche auftritt.

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

PageReady

Tritt auf, wenn das Laden der Seite abgeschlossen ist. Auf einer Einheitlichen Oberflächenseite des Typs gehostetes Steuerelement tritt dieses Ereignis auf, nachdem die Daten in der Ersetzungsparameterliste gespeichert wurden.

Parameter Beschreibung des Dataflows
url Die URL der Seite, deren Laden abgeschlossen ist.

Notiz

Bei Dashboards, Webressourcen und Suchseiten wird das DataReady-Ereignis nicht ausgelöst.

BrowserWindowReady

Das BrowserWindowReady-Ereignis wird aufgerufen, wenn das Browserfenster in der Unified Service Desk-Client-Anwendung bereit ist. Verwenden Sie BrowserWindowReady für Dashboards und Webressourcen.

OnClickToAct

Das OnClickToAct-Ereignis wird ausgelöst, wenn der Benutzer das Feld der ausgehenden Kommunikation (ClickToAct) in einem Formular auswählt.

Sie können auch benutzerdefinierte Steuerelemente schreiben, um das ClickToAct-Fensterereignis des Channel Integration Framework auszulösen und eventData nach den geschäftlichen Anforderungen zu übergeben.

Weitere Informationen: onclicktoact

OnSendKbArticle

Das OnSendKbArticle-Ereignis wird ausgelöst, wenn der Benutzer die Schaltfläche Senden im Steuerelement für die Wissensdatenbank auswählt. Die eventData sind die URL und der Titel des Wissensdatenbankartikels, die Sie übergeben müssen.

Weitere Informationen: onsendkbarticle

Notiz

Wir empfehlen Ihnen, in den modellbasierten Formularen für Apps keine window.IsUSD zu verwenden. Verwenden Sie stattdessen PageReady oder andere Ereignisse, die in diesem Thema aufgeführt sind.

Siehe auch

Support für Einheitliche-Oberflächen-Apps in Unified Service Desk
Exemplarische Vorgehensweisen für Unified Service Desk und die Konfiguration der einheitlichen Oberfläche
Exemplarische Vorgehensweise 1: Erstellen einer einfachen Agent-Anwendung für einheitliche Oberflächen-Apps
Walkthrough 2: Anzeigen einer externen Webseite ain Ihrer Agent-Anwendung
Exemplarische Vorgehensweise 3: Anzeigen Einheitlicher Oberflächen-Apps in Ihrer Agent-Anwendung
Exemplarische Vorgehensweise 4: Anzeigen eines Datensatzes der einheitlichen Oberflächen Apps in einer Sitzung in Ihrer Agent-Anwendung
Walkthrough 5: Anzeigen erweiterter Sitzungsinformationen durch Anzeigen des Sitzungsnamens und von Übersichtsdaten
Walkthrough 6: Konfigurieren des gehosteten Steuerelements Debugger in ihrer Agent-Anwendung
Walkthrough 7: Konfigurieren des Agentskriptings in Ihrer Agent-Anwendung