Freigeben über

Erstellen eines gehosteten Steuerelements des CTI Desktop Managers

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Verwenden Sie das gehostete Steuerelement CTI Desktop Manager, um ein CIT-Adapter mit Unified Service Desk zu verbinden, um Bildschirm-Popups, Rufumleitungen, Softphone-Kontrolle und andere CTI-Funktionen zu verarbeiten.

In diesem Thema

Erstellen eines gehosteten Steuerelements des CTI Desktop Managers

Vordefinierte UII-Aktionen

Vordefinierte Ereignisse

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 Erstellen Sie einen CTI-Desktop-Manager

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 -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 Agentenanwendung deaktiviert.

Parameter

Beschreibung

Name der zu deaktivierenden Symbolleistenschaltfläche.

EnableToolbarButton

Durch diese Aktion wird die angegebene Symbolleistenschaltfläche auf der Symbolleiste in Ihrer Agentenanwendung 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 Anfrage oder Vorfall, um die Schnellsuchelistenansicht für Anfragen anzuzeigen.

  • Verwenden Sie advfind zur Anzeige der erweiterten Suchansicht.

  • 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 Ereignisses finden Sie unter Erstellen eines benutzerdefinierten 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 von Dynamics 365 geladen. Dieses entspricht der Auswahl eines Bereichs im Navigationsbereich (beispielsweise Vertrieb, 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.

panel

Zielbereich für das gehostete Steuerelement.

Durch diese Aktion wird zu einer Dynamics 365-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 Dynamics 365 zu laden.

HideNavigationBar

Wenn dieser Parameter bereitgestellt wird und Wahr ist, wird das Formular angezeigt ohne die Navigationsleiste für Dynamics 365 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.

postdata

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 die Daten von jedem Ereignis empfangen werden, das unter Verwendung von "http://event/?" ausgelöst wird. Beispiel: [[postdata]+]

Sie können die Daten alternativ als codierte Zeichenfolge mit dem Kopfzeilentyp im beabsichtigten Format übergeben.

header

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 DeskPOST-Ereignis die Navigate-Aktion auslöst, sollte der Standardwert dieses Parameters header=[[header]+] sein

New_CRM_Page

Erstellt eine Seite zum Erstellen eines neuen Dynamics 365 -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.

Hinweis

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 dieser Aktion finden Sie unter Schritt 4 in Walkthrough 7: Konfigurieren des Agentskriptings in Ihrer Agentenanwendung.

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.

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 Dynamics 365-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 ersetzt werden, bevor das Skript ausgeführt wird.

RunXrmCommand

Diese Aktion wird zum Injizieren von Dynamics 365 SDK JavaScript in das Dynamics 365-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 ersetzt werden, bevor das Skript ausgeführt wird.

Speichern

Durch diese Aktion wird die aktuelle Dynamics 365-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 Dynamics 365-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

width

Die Breite des gehosteten Steuerelements.

height

Die Höhe des gehosteten Steuerelements.

ToggleNavigation

Hierdurch wird der Navigationsbereich im linken Bereich des Dynamics 365-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.

Hinweis

Einige Webseiten, besonders Dynamics 365-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.

Siehe auch

Integrieren mit CTI-Systemen mithilfe von CTI-Adaptern

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright