Standardwebanwendung (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

Das gehostete Steuerelement Standard-Webanwendung ist ähnlich wie der Typ CRM-Seite, außer dass er dafür bestimmt ist, Nicht-Dynamics 365Seiten, wie externe Webseiten zu hosten und Scripteinführungen für relevante Funktionen von externen Webseiten bereitstellt. Wie das gehostete Steuerelement CRM-Seite können diese Seiten automatisiert werden. Die bevorzugte Automatisierungsmethode ist über die JavaScript-Einfügung, einschließlich des Aufrufs von JavaScript-Funktionen, die bereits auf der Seite definiert sind, oder die Manipulation des DOM. Auch die RunScript-Aktion kann verwendet werden, um Werte von der Seite abzurufen.

Hinweis

Diese Art gehosteter Steuerelemente unterstützt nicht das Hosted Application Toolkit (HAT), das die Aufgabe der Automatisierung der Benutzeroberfläche einer gehosteten Anwendung erleichtert. HUT besteht aus den datengesteuerten Adaptern (DDA), deskriptiven Bindungen und Automatisierungen (Windows-Workflows) zur Automatisierung der Anwendungen.Weitere Informationen:Verwenden den UII-Automatisierungsadapter, um mit externem und Webanwendungen zu interagieren

In diesem Thema

Erstellen eines gehosteten Steuerelement des Typs Standard-Webanwendung

Vordefinierte UII-Aktionen

Vordefinierte Ereignisse

Erstellen eines gehosteten Steuerelement des Typs Standard-Webanwendung

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 Standard-Webanwendung. 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 DeskStandard-Webanwendung aus der Dropdownliste USD-Komponententyp.

• Wählen Sie in der Dropdownliste Mehrere Seiten zulassenJa, 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 Seiten zu suchen, die mit diesem Steuerelement verbunden sind. Wenn Sie Nein auswählen, wenn Unified Service Desk einen Navigationsaktionsaufruf erhält oder eine Seite zur Registerkarte weitergeleitet wird, ersetzt es die Seite, die derzeit angezeigt wird und aktualisiert den Browserverlauf.

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

• Geben Sie im Feld Anzeigegruppe einen Bereich an, in dem dieses gehostete Steuerelement angezeigt wird. Informationen zu den verschiedenen Fenstern in Unified Service Desk finden Sie unter Bereiche im Unified Service Desk.

Vordefinierte UII-Aktionen

Dies sind die verfügbaren vordefinierten UII-Aktionen für diese Art gehosteter Steuerelemente.

Schließen

Durch diese Aktion wird das gehostete Steuerelement geschlossen.

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.

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

Durch diese Aktion wird zu einer 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 und nicht die Seitenbefehlsleiste geladen.
HideNavigationBar	Wenn dieser Parameter bereitgestellt wird und True ist, wird der Navigationsbereich auf der Ziel-Webseite nicht angezeigt.
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 HTTPPOST-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 den 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.

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.

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

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

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

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.

PopupRouted

Tritt auf, nachdem ein Popup vom System weitergeleitet wurde.

Parameter	Beschreibung
URL	Die URL des Popup-Fensters, das weitergeleitet wurde.

Siehe auch

UII-Aktionen
Ereignisse
Vordefinierte Aktionen und Ereignisse für ein gehostetes Steuerelement anzeigen
Erstellen oder Bearbeiten eines gehosteten Steuerelements
Walkthrough 2: Anzeigen einer externen Webseite ain Ihrer Agentenanwendung
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen

Unified Service Desk 2.0

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright