CRM-Seite (gehostetes Steuerelement)

 

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 den gehosteten Steuerelementtyp CRM-Seite, um eine URL oder eine Seite aus Dynamics 365 zu laden. Wenn eine Dynamics 365-Seite innerhalb eines gehosteten Steuerelements dieses Typs geladen wird, wird die Seite automatisch nach Daten für die Entität durchsucht, und die Ersetzungsparameter werden automatisch ausgefüllt.

Dieser gehostete Steuerelementtyp macht eine Reihe vordefinierter UII-Aktionen und -Ereignisse verfügbar, die für die Verarbeitung von Dynamics 365-Fenstern spezifisch sind, einschließlich Aktionen zur Listenmanipulierung und Suchaktionen für die Anzeige einer Schnellsuche oder erweiterten Suchseite

In diesem Thema

Erstellen eines gehosteten Steuerelements des Typs "CRM-Seite"

Vordefinierte UII-Aktionen

Vordefinierte Ereignisse

Erstellen eines gehosteten Steuerelements des Typs "CRM-Seite"

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 CRM-Seite. Ausführliche Informationen zum Erstellen eines gehosteten Steuerelements finden Sie unter Erstellen oder Bearbeiten eines gehosteten Steuerelements.

Gehen Sie im Bildschirm Neues gehostetes Steuerelement wie folgt vor:

• Wählen Sie im Bereich Unified Service DeskCRM-Seite aus der Dropdownliste USD-Komponententyp aus.

• Wählen Sie aus der Dropdownliste Mehrere Seiten zulassen die Option Nein (Standard) aus, um die Dynamics 365-Seite zu ersetzen, die derzeit angezeigt wird, und den Browserverlauf zu aktualisieren, wenn Unified Service Desk einen negativen Aktionsanruf empfängt, oder eine Seite auf die Registerkarte weitergeleitet wird. Wählen Sie Ja, um automatisch eine Dropdownliste zu erstellen, wenn eine zweite URL aufgerufen wird, oder wenn eine Fensternavigationsregel eine Seite zu der Registerkarte leitet. Dies ermöglicht dem Benutzer, schnell in den Dynamics 365-Seiten zu suchen, 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.

• Die Dropdownliste Hosting-Typ zeigt an, wie dieses Steuerelement gehostet werden soll. Sie können IE-Prozess (Standard) oder Internes WPF auswählen. Weitere Informationen finden Sie unter Auswählen einer Hostingmethode für Ihre Steuerelemente.

• Wählen Sie im Bereich Allgemeine Eigenschaften 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 zu den verschiedenen Fenstern in Unified Service Desk finden Sie unter Bereiche, Bereichstypen und Bereichslayouts in Unified Service Desk.

Informationen zu anderen Allgemein-Feldern finden Sie unter Erstellen oder Bearbeiten eines gehosteten Steuerelements.

Vordefinierte UII-Aktionen

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

AssociatedView

Durch diese Aktion wird eine bestimmte zugeordnete Ansicht von Dynamics 365 geladen. 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 Dynamics 365. Beispiele: areaSales oder areaService.

Weitere Informationen zur Verwendung dieser Aktion finden Sie unter Schritt 5 in Walkthrough 7: Konfigurieren des Agentskriptings in Ihrer Agentenanwendung.

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.

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 des Typs CRM Page, 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, 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.

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.

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.

GoHome

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

GoBack

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

GoForward

Diese Aktion entspricht der Vorwärts-Schaltfläche in der Browserinstanz.

LoadArea

Mit dieser Aktion wird ein bestimmter Bereich von Dynamics 365 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.

LookupInfo

Zeigt ein Dynamics 365-Nachschlage-Informationsfeld an, damit ein Benutzer eine Entität aus einer Liste auswählen kann.

Parameter	Beschreibung
AllowFilterOff	"0 " oder "1 ", damit der Benutzer die Filter ausschalten kann.
DefaultType	Der logische Name der Standardansicht. Dies sollte einer der numerischen Werte sein, die im Paramater objecttypes angegeben werden.
DefaultViewId	"0" oder "1", um die Standardansicht anzuzeigen.
DisableQuickFind	"0" oder "1", um das Schnellsuchefeld anzuzeigen.
DisableViewPicker	"0" oder "1", um die Ansichtauswahl anzuzeigen.
LookupStyle	Einzeln oder mehrere
ShowNewButton	"0" oder "1", um die Schaltfläche "Neu" anzuzeigen.
ShowPropButton	"0" oder "1", um die Schaltfläche "Eigenschaften" anzuzeigen.
Durchsuchen	"0" oder "1", um anzugeben, ob der Browsingmodus verwendet werden soll. Die folgenden Angaben gelten, wenn dies als "1" festgelegt ist.
Currentid	Die GUID für den aktuellen Wert.
objecttypes	Liste der anzuzeigenden Objekttypen. Dies sind die ETC-Typen aus Dynamics 365. Beispiel: "1,2" zur Anzeige von Konten und Kontakten.

MoveToPanel

Diese Aktion verschiebt ein gehostetes Steuerelement einer CRM-Seite auf einen anderen Bereich zur Laufzeit.

Parameter	Beschreibung
	Der Datenenparameter sollte den Zielbereichsnamen definieren, um das gehostete Steuerelement zu verschieben. Beispiel: FloatingPanel.

Navigieren

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

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.

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

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 geänderten Daten im Dynamics 365-Formular gespeichert und das gehostete Steuerelement geschlossen.

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.

Speichern

Durch diese Aktion wird die aktuelle CRM-Seite gespeichert.

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.

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.

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.

BrowserDocumentComplete

Tritt auf, wenn das Laden der Seite abgeschlossen ist. Auf einem gehosteten Steuerelement des Typs CRM-Page tritt dieses Ereignis auf, nachdem die Daten in der Ersetzungsparameterliste gespeichert wurden. Dieses Ereignis tritt nur einmal auf, auch wenn mehrere Rahmen einzeln ihre BrowserDocumentComplete-Ereignisse ausgelöst haben.

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

PageLoadComplete

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 für den Rahmen, dessen Laden abgeschlossen ist, falls verfügbar.
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.

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 ein Datensatz auf der Dynamics 365-Seite gespeichert wurde.

Parameter	Beschreibung
newId	Die ID des neu erstellten Datensatzes.

Siehe auch

CRM-Dialog (Gehostetes Steuerelement)
UII-Aktionen
Ereignisse
Exemplarische Vorgehensweise 3: Anzeigen von Microsoft Dynamics 365-Datensätzen in der Agent-Anwendung
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen
Verwaltungshandbuch für Unified Service Desk für Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright