Erstellen eines gehosteten Steuerelements des CTI Desktop Managers
Verwenden Sie den Typ CTI Desktop Manager gehostetes Steuerelement, um einen Computer Telephony Integration (CTI)-Adapter in Unified Service Desk einzubinden, um Bildschirmaufrufe, Anrufweiterleitung, Softphone-Steuerung und andere CTI-Funktionen zu handhaben.
Erstellen eines gehosteten Steuerelements des CTI Desktop Managers
Informationen zum Erstellen eines CTI-Desktop-Managers und zum Konfigurieren des entsprechenden gehosteten Steuerelements finden Sie unter CTI Desktop Manager erstellen
Vordefinierte UII-Aktionen
Dies sind die vordefinierten Aktionen für diese Art gehosteter Steuerelemente.
Schließen
Durch diese Aktion wird das gehostete Steuerelement geschlossen. Im Gegensatz zur CloseActivd-Aktion gilt: Wenn diese Registerkarte (gehostetes Steuerelement) mehr als eine Seite anzeigt, werden alle auf der Registerkarte in Ihrer Clientanwendung angezeigten Seiten geschlossen.
CloseAndPrompt
Diese Aktion schließt das gehostete Steuerelement, fordert den Benutzer jedoch auf, die Änderungen vor dem Schließen zu speichern oder zu verwerfen.
DisableToolbarButton
Durch diese Aktion wird die angegebene Symbolleistenschaltfläche auf der Symbolleiste in Ihrer Agent-Anwendung deaktiviert.
| Parameter | Beschreibung |
|---|---|
| Name der zu deaktivierenden Symbolleistenschaltfläche. |
EnableToolbarButton
Durch diese Aktion wird die angegebene Symbolleistenschaltfläche auf der Symbolleiste in Ihrer Agent-Anwendung aktiviert.
| Parameter | Beschreibung |
|---|---|
| Name der zu aktivierenden Symbolleistenschaltfläche. |
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 Fall oder Vorfall, um die Schnellsuchelistenansicht für Fälle anzuzeigen. - Verwenden Sie advfind, um die erweiterte Suchansicht anzuzeigen. - Verwenden Sie Aktivitäten oder Aktivität, 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.
GoBack
Diese Aktion entspricht der Zurück-Schaltfläche in der Browserinstanz.
GoForward
Diese Aktion entspricht der Vorwärts-Schaltfläche in der Browserinstanz.
GoHome
Diese Aktion wechselt zur anfänglichen URL, die für diese Browserinstanz angegeben wurde.
LoadArea
Mit dieser Aktion wird ein bestimmter Bereich vom modellgesteuerten Apps geladen. Dieses entspricht der Auswahl eines Bereichs im Navigationsbereich (beispielsweise Sales, Service und Marketing.) Der einzige Parameter ist der Name des anzuklickenden Bereichs. Zum Beispiel: areaService.
| Parameter | Beschreibung |
|---|---|
| frame | Der name des betreffenden Rahmens. Wenn Sie keinen Namen angeben, wird automatisch der erste Rahmen auf der Seite genommen. |
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. |
Navigate
Durch diese Aktion wird zur modellgesteuerten Apps-URL navigiert.
| 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 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, würde dieser Parameter den Namen des zu navigierenden Rahmens angeben und nicht im Hauptfenster navigiert. |
| 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-urlencodedWenn 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 modellgesteuerten-Apps-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.
| Parameter | Beschreibung |
|---|---|
| LogicalName | Der logische Name der Entität zum Erstellen einer neuen Instanz. |
Notiz
Der Rest der Parameter sollte aus Name=Wert-Paaren bestehen. Dies sind die zusätzlichen vorausgefüllten Werte im Formular zum Erstellen eines neuen Datensatztyps für die angegebene Entität. Weitere Informationen zur Verwendung dieses Aktionsanrufs finden Sie in Schritt 4 Walkthrough 7: Konfigurieren von Agenten-Scripting einer externen Webseite Ihrer Agent-Anwendung
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. |
Popup
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. |
| Frame | Der Frame, von dem dieses Popup stammt. |
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. |
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. Hinweis: Die Ersetzungsparameter können im Skript verwendet werden und werden ersetzt, bevor das Skript ausgeführt wird. |
RunXrmCommand
Diese Aktion wird zum Injizieren von Dataverse-SDK JavaScript in das modellgesteuerte Apps-Formular verwendet.
| Parameter | Beschreibung |
|---|---|
| Der Datenparameter ist das JavaScript, das in das Formular eingefügt wird. Hinweis: Die Ersetzungsparameter können im Skript verwendet werden und werden ersetzt, bevor das Skript ausgeführt wird. |
Speichern
Durch diese Aktion wird die aktuelle Seite gespeichert.
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 geänderten Daten im modellgesteuerten Apps Formular 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 |
|---|---|
| Breite | Die Breite des gehosteten Steuerelements. |
| height | Die Höhe des gehosteten Steuerelements. |
ToggleNavigation
Hierdurch wird der Navigationsbereich im linken Bereich des modellgesteuerte -Apps-Fensters ausgeblendet oder erweitert. Die Navigation muss einen Navigationsbereich enthalten, damit diese Aktion funktioniert.
ToggleRibbon
Diese Aktion reduziert oder erweitert das Menüband. Wenn Sie das Menüband in der Aktion Navigate ausblenden, wird es nicht angezeigt und diese Aktion funktioniert nicht. Diese Aktion funktioniert nur, wenn das Menüband zunächst geladen wurde.
WaitForComplete
Diese Aktion kann verwendet werden, um die Verarbeitung anzuhalten, bis das Laden der URL abgeschlossen ist.
Notiz
Einige Webseiten, besonders modellgesteuerte Apps-Seiten, haben mehrere Rahmen. Bei dieser Aktion wird nur auf den Abschluss des Ladens des Hauptframes gewartet.
| Parameter | Beschreibung |
|---|---|
| Millisekunden | Optionaler Parameter zu Angabe, wie lange (in Millisekunden) bis zum Timeout zu warten ist. |
Vordefinierte Ereignisse
Dies sind die vordefinierten Ereignisse für diese Art gehosteter Steuerelemente.
BrowserDocumentComplete
Tritt auf, wenn das Laden der Seite abgeschlossen ist.
| Parameter | Beschreibung |
|---|---|
| URL | Die URL der Seite, deren Laden abgeschlossen ist. |
FrameLoadComplete
Tritt immer auf, wenn das Laden eines Rahmens abgeschlossen ist. Dieses Ereignis kann mehrmals pro Seitenladung auftreten, wenn ein iFrame oder ein Rahmen auf der Seite verwendet wird. Dieses Ereignis entspricht den einzelnen BrowserDocumentComplete-Ereignissen im Code.
| Parameter | Beschreibung |
|---|---|
| frame | Der Name des Rahmens, dessen Laden abgeschlossen ist. |
| URL | Die URL des Rahmens, dessen Laden abgeschlossen ist. |
PopupRouted
Tritt auf, nachdem ein Popup vom System weitergeleitet wurde.
| Parameter | Beschreibung |
|---|---|
| URL | Die URL des Popup-Fensters, das weitergeleitet wurde. |