Globaler Manager (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 des Typs Globaler Manager ist der Kern von Unified Service Desk, und eine Instanz dieses gehosteten ist für Unified Service Desk erforderlich. Dieses gehostete Steuerelement lädt und liest alle Unified Service Desk-Konfigurationsdaten von Microsoft Dynamics 365 beim Start, interpretiert die Fensternavigationsregeln, stellt Daten für die Symbolleistenkomponenten Agentskripten bereit und verwaltet die Daten für die Sitzung. Nur eine einzelne Instanz des Typs Globaler Manager kann geladen werden.
Wichtig
Die drei Beispielanwendungspakete für Unified Service Desk, New Environment, CRM Web Client und Interactive Service Hub sind mit einer Instanz des gehosteten Steuerelements des Typs Globaler Manager vorkonfiguriert. Weitere Informationen über die Beispielanwendungen finden Sie unter TechNet: Unified Service Desk-Beispielanwendungen für den CRM-Server mithilfe des Package Deployers bereitstellen.
Zusätzlich zur Bereitstellung der Interpretation für die meisten der Funktionen in Unified Service Desk bieten gehostete Steuerelemente des Typs Globaler Manager auch die multilingualen Funktionen im System, damit Sie Benutzeroberfläche-Zeichenfolgen und Meldungen in der Anwendung in mehreren Sprachen anzeigen können. Weitere Informationen finden Sie unter Unterstützung für mehrere Spracen für die Agent-Anwendungen hinzufügen. Er enthält außerdem den Suchenanbieter, der allgemein konzipiert ist und durch Konfiguration angepasst werden kann.
In diesem Thema
Erstellen eines gehosteten Steuerelements des Typs Globaler Manager
Vordefinierte UII-Aktionen
Vordefinierte Ereignisse
Erstellen eines gehosteten Steuerelements des Typs Globaler Manager
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 Globaler Manager. Ausführliche Informationen zum Erstellen eines gehosteten Steuerelements finden Sie unter Erstellen oder Bearbeiten eines gehosteten Steuerelements.
Wählen Sie im Bildschirm Neues gehostetes Steuerelement unter dem Bereich Unified Service DeskGlobaler Manager aus der Dropdownliste USD-Komponententyp aus. Außerdem sollten Sie sicherstellen, dass der Wert Sortierreihenfolge dieses gehosteten Steuerelements auf 2 gesetzt ist, um sicherzustellen, dass es von Ihrer Agent-Anwendung unmittelbar geladen wird, nachdem die Verbindung zu Dynamics 365 hergestellt wurde, mithilfe des gehosteten Steuerelements des Typs Verbindungs-Manager. Informationen zu anderen Allgemein-Feldern finden Sie unter Erstellen oder Bearbeiten eines gehosteten Steuerelements.
Nachdem Sie den Datensatz gespeichert haben, ist der Bereich Sprachendiensteverfügbar, in dem Sie Ressourcen zum Hinzufügen lokalisierter Zeichenfolgen für die UI Ihrer Agentenanwendungen hinzufügen können. Informationen dazu, wie Sprachenressourcen hinzufügt werden, finden Sie unter Unterstützung für mehrere Spracen für die Agent-Anwendungen hinzufügen.
Vordefinierte UII-Aktionen
Globaler Manager bietet eine Reihe vordefinierter Aktionen, mit denen Sie Dynamics 365-Datensatzdaten über Webservices bearbeiten können. Diese können während der Konfiguration verwendet werden, um in Dynamics 365 erweiterte Aufgaben durchzuführen.
Folgende vordefinierte UII-Aktionen sind für gehostete Steuerelemente des Typs Globaler Manager verfügbar:
Überwachung
Fügen Sie einen Überwachungseintrag zu den Unified Service Desk-Überwachungsprotokollen hinzu. Weitere Informationen finden Sie unter Technet: Konfigurieren der Überwachung in Unified Service Desk
Parameter |
Beschreibung |
---|---|
Name |
Der Name des Überwachungseintrags.. Sie müssen eine Option im Bereich Optionen (Einstellungen > Unified Service Desk > Optionen (Wie komme ich dorthin?)) hinzufügen, die den Wert von 1 aufweist. |
Aktion |
Zeichenfolge für die überwachte Aktion. |
TargetApplication |
Zeichenfolge für die Zielanwendung der Überwachung. |
CustomerId |
Zeichenfolge für die Kunden-ID. |
ContextId |
Zeichenfolge für die Kunden-ID. |
ApplicationId |
GUID des gehosteten Steuerelements für die Überwachung. |
AgentState |
Zeichenfolge, die den Agentstatus darstellt |
ActionData |
Dies sind die Dasten für den Überwachungseintrag. Wenn dieser Parameter nicht explizit bereitgestellt wird, verwendet er alle verbleibenden Zeilen in dem Daten-Feld der Aktionsaufrufdefinition. |
CallDoAction
Ruft eine Aktion für ein anderes gehostetes Steuerelement auf.
Parameter |
Beschreibung |
---|---|
panel |
Dies ist der Bereich zum Finden der aktiven Anwendung, wenn keine Anwendung angegeben ist. |
Aktion |
Dies ist die Aktion, die auf dem gehosteten Steuerelement aufgerufen werden soll. |
-Daten |
Dies ist der Datenparameter, der an die Aktion übergeben werden soll. |
Anwendung |
Dies ist der Name des gehosteten Steuerelements, für das Sie einen Aktionsanruf ausführen möchten. Wenn dieser angegeben ist, wird der Parameter Bereich ignoriert. |
ClearAppBar
Hebt das Docking des angegebenen gehosteten Steuerelements in der Client-Anwendung auf.
Parameter |
Beschreibung |
---|---|
ApplicationName |
Der Name des gehosteten Steuerelements, dessen Docking aufgehoben werden soll. Wenn dieser Parameter nicht angegeben ist, wird das Client-Anwendungshauptfenster abgedockt. |
ClearEntityList
Löscht die Liste der akkumulierten Suchergebnisse; sie sollte immer vor dem Aufruf der Aktion DoSearch aufgerufen werden.
Parameter |
Beschreibung |
---|---|
global |
True, wenn Sie die Suchergebnisse im Zusammenhang mit der globalen Sitzung löschen möchten. Gehen Sie vorsichtig vor, wenn Sie Suchergebnisse in der globalen Sitzung speichern, da diese nicht automatisch vom System gelöscht werden. In diesem Fall müssen Sie die Aktion ClearEntityList aufrufen, bevor Sie die Aktion DoSearch aufrufen. |
Schließen
Schließt das gehostete Steuerelement. Im Gegensatz zur CloseActive-Aktion gilt: Wenn diese Registerkarte mehr als eine Seite anzeigt, werden alle auf der Registerkarte in Ihrer Clientanwendung angezeigten Seiten geschlossen.
CloseActive
Schließt das aktive gehostete Steuerelement im angegebenen Bereich.
Parameter |
Beschreibung |
---|---|
Die erste Zeile in dem Aktionsaufruf sollte den Namen des Bereichs zum Suchen der aktiven Anwendung enthalten. Wenn kein Parameter angegeben ist, wird MainPanel angenommen. |
CopyToClipboard
Kopiert die Artikel-URL in die Zwischenablage oder fügt sie dieser an.
Parameter |
Beschreibung |
---|---|
-Daten |
Daten, die kopiert werden sollen. Sie können auch Ersetzungsparameter verwenden. Zum Beispiel: data=[[$context.title]] |
anfügen |
Gibt an, ob die Daten der Zwischenablage anfügt werden sollen. Legen Sie true oder false fest. Beispiel: append=false. |
CopyToContext
Kopiert einen Wert oder eine Serie von Werten zu Kontextvariablen. Kontextvariablen können mit der Sitzung serialisiert werden. Diese Aktion verwendet eine Serie von Name=Wert-Paaren. Der Name ist der Name der Kontextvariable.
CopyLogicalEntityToContext
Kopiert Werte aus einem vollständigen Abschnitt der Datenparameter in den Kontext.
Parameter |
Beschreibung |
---|---|
LogicalName |
Der Typ oder Abschnitt der Datenparameter, von dem Werte kopiert werden sollen. |
CloseActivity
Schließt einen Aktivitätsdatensatz in Dynamics 365.
Parameter |
Beschreibung |
---|---|
ID |
Die GUID des zu schließenden Aktivitätsdatensatzes. |
LogicalName |
Der logische Name der zu schließenden Aktivität. |
StatusCode |
Der Anzeigename des endgültigen Statuscodes, nachdem die Aktivität geschlossen wird. |
StateCode |
Der Anzeigename des endgültigen Zustandscodes, nachdem die Aktivität geschlossen wird. |
Wenn Sie beispielsweise eine Telefonanrufaktivität schließen, muss Folgendes angegeben werden:
Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed
Wenn der Aktivitätsdatensatz geschlossen wird, wird der $Rücksendung-Systemersatzparameter mit einem Booleschen Wert aufgefüllt, der angibt, ob die Aktion erfolgreich war oder nicht.
CreateEntity
Erstellt einen neuen Datensatz in Dynamics 365.
Parameter |
Beschreibung |
---|---|
LogicalName |
Der logische Name der zu erstellenden Entität |
Jede folgende Zeile in der Parameterliste enthält eine Reihe von Name=Wert-Paaren, die die anderen Felder definieren, die beim Erstellen zu füllen sind.
Entitätsverweisen können wie die folgenden beschrieben werden:
Param=EntityReference(“logicalname”, “id”)
OptionSetValues können wie folgt angegeben werden:
Param=OptionSetValue(value)
Boolsche Werte können wie folgt beschrieben werden:
Param=Boolean(value)
PartyList (mit E-Mails verwendet) kann wie folgt beschrieben werden:
Param=PartyList(email[“test@test.com”], er[“contact”, guid])
Sie können eine beliebige Anzahl von email- und er Einträgen verwenden, um E-Mail-Adressen und Entitätsreferenzen zu repräsentieren.
Andere Werte wie etwa Zeichenfolgenwerte können wie folgt angegeben werden:
Param=value
Sobald der Datensatz erstellt ist, wird der $Return-Wert mit der GUID des neu erstellten Datensatzes gefüllt.
CreateSession
Erstellt eine Sitzung.
DeleteEntity
Löscht einen Datensatz in Dynamics 365.
Parameter |
Beschreibung |
---|---|
ID |
Die ID des zu löschenden Werts. Die muss die GUID des zu löschenden Datensatzes sein. |
LogicalName |
Der logische Name der zu löschenden Entität. |
DoRoute
Kann verwendet werden, um die Fensternavigationsregeln zu testen, indem ein Popup-Fenster von einem bestimmten gehosteten Steuerelement simuliert wird. Dies kann in einer Produktionsumgebung verwendet werden, um die Fensternavigationsregeln manuell nach Bedarf auszulösen.
Parameter |
Beschreibung |
---|---|
Name |
Die ID der Entität, die Ziel des queueItem ist |
Entität |
Der logische Name der Entität, die in einem Popupfenster geöffnet wird. |
id |
Die ID der Entität, die in einem Popupfenster geöffnet wird. |
frame |
Der Frame, von dem aus das Popup stammt. |
DoSearch
Ruft die Dynamics 365-Webdienste mithilfe von FetchXMLs ab, das als Entitätssuche in Unified Service Desk definiert ist. Mehr Informationen zum Definieren einer Entitätssuche finden Sie unter Suchen von Daten mithilfe von Entitätssuchen in Unified Service Desk
Parameter |
Beschreibung |
---|---|
name |
Der Name der zum Suchen des Datensatzes verwendeten Entitätssuche. |
global |
True, wenn Sie die Suchergebnisse im Zusammenhang mit der globalen Sitzung löschen möchten. Gehen Sie vorsichtig vor, wenn Sie Suchergebnisse in der globalen Sitzung speichern, da diese nicht automatisch vom System gelöscht werden. In diesem Fall müssen Sie die Aktion ClearEntityList aufrufen, bevor Sie diese Aktion aufrufen. |
maxcount |
Die maximale Anzahl von Datensätzen zur Speicherung in den EntityList-Ergebnissen aus diesem Aufruf. |
Hinweis
Standardmäßig ist der Seitenzähler (Zahl der Datensätze pro Seite) für ein Ergebnis auf 50 festgelegt. Dies bedeutet, dass, wenn mehr als 50 Datensätze zurückgegeben werden, dieser in Seiten angezeigt wird. Wenn Sie einen anderen Seitenzählerwert für DoSearch angeben möchten, geben Sie den neuen Wert in der Option EntitySearchPageCount Entity ein.Weitere Informationen:TechNet: Verwalten der Optionen für Unified Service Desk
Wenn Sie diese DoSearch-Aktion anrufen, zeigt der $Return-Ersetzungsparameter die Anzahl der Datensätze an, die gefunden und in der EntityList als Ergebnis dieser Suche gespeichert wurden.Weitere Informationen:$Rücksendung.
DisplayMessage
Zeigt dem Benutzer ein Meldungsfeld an.
Parameter |
Beschreibung |
---|---|
Text |
Dies ist der Text, der in dem Meldungsfeld angezeigt wird. Wenn dieser Parameter nicht angegeben ist, wird eventuell verbleibender Text (Restparameter) oder eine leere Zeichenfolge verwendet. |
Beschriftung |
Dies ist die Beschriftung, die in dem Meldungsfeld angezeigt wird. Wenn keine Beschriftung angegeben ist, wird Dynamics 365 Meldungverwendet. |
ExecuteOnDataAvailable
Verzögert die Ausführung der Teilhandlungen, bis ein angegebener Satz Ersetzungsparameter verfügbar ist. Möglicherweise wird ein Zeitüberschreitungswert angegeben, um zu begrenzen, wie lange die Ersetzungsparameter warten, bevor sie verfügbar werden. Wenn kein Timeout angegeben wurde, wird unbegrenzt gewartet oder bis die Sitzung endet.Weitere Informationen:Blog: So verwenden Sie Sonderaktionen, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue
Parameter |
Beschreibung |
---|---|
milliseconds |
Die Zeit (in Millisekunden), um die Dauer anzugeben, die gewartet wird, bevor diese Aktion abläuft und abgebrochen wird. Die übrigen Parameter sollten Ersetzungsparameter enthalten, die vorhanden sein müssen, bevor die Teilhandlungen ausgeführt werden können. Daten-Parameter-Beispiel: milliseconds=5000 |
Wichtig
Diese Aktion betrifft alle gehosteten Steuerelementtypen. Diese Aktion wird standardmäßig nicht verfügbar gemacht, wenn Sie eine Instanz eines gehosteten Steuerelementtyps erstellen. Um die ExecuteOnDataAvailable-Aktion mit einer Instanz eines gehosteten Steuerelementtyps zu verwenden, müssen Sie der entsprechenden gehosteten Steuerelementinstanz explizit eine UII-Aktion hinzufügen, die ExecuteOnDataAvailable genannt wird.Weitere Informationen:Hinzufügen einer UII-Aktion zu einem gehosteten Steuerelement
ExecuteOnTimeout
Verzögert die Ausführung der Teilhandlungen bis ein bestimmter Zeitpunkt verstreicht. Ein Zeitüberschreitungswert ist erforderlich, um anzugeben, wann die Teilhandlungen ausgeführt werden sollen.Weitere Informationen:Blog: So verwenden Sie Sonderaktionen, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue
Parameter |
Beschreibung |
---|---|
milliseconds |
Die Zeit (in Millisekunden), um die Dauer anzugeben, die gewartet wird, bevor die Teilhandlungen ausgeführt werden. Daten-Parameter-Beispiel: milliseconds=5000 |
Wichtig
Diese Aktion betrifft alle gehosteten Steuerelementtypen. Diese Aktion wird standardmäßig nicht verfügbar gemacht, wenn Sie eine Instanz eines gehosteten Steuerelementtyps erstellen. Um die ExecuteOnTimeout-Aktion mit einer Instanz eines gehosteten Steuerelementtyps zu verwenden, müssen Sie der entsprechenden gehosteten Steuerelementinstanz explizit eine UII-Aktion hinzufügen, die ExecuteOnTimeout genannt wird.Weitere Informationen:Hinzufügen einer UII-Aktion zu einem gehosteten Steuerelement
ExecuteOnExpressionTrue
Verzögert die Ausführung der Teilhandlungen bis ein bestimmter JavaScript Ausdruck zurückgegeben wird true. Ein Zeitüberschreitungswert wird möglicherweise angegeben, um die Dauer zu begrenzen, die vor dem Ablauf gewartet wird. Wenn kein Timeout angegeben wurde, wird unbegrenzt gewartet oder bis die Sitzung endet.Weitere Informationen:Blog: So verwenden Sie Sonderaktionen, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue
Parameter |
Beschreibung |
---|---|
milliseconds |
Die Zeit (in Millisekunden), um die Dauer anzugeben, die gewartet wird, bevor diese Aktion abläuft und abgebrochen wird. Der verbleibende Parameter ist ein auszuwertender JavaScript-Ausdruck. Wenn dieser Ausdruck trueist, werden Teilhandlungen ausgeführt. Daten-Parameter-Beispiel: milliseconds=5000 |
Wichtig
Diese Aktion betrifft alle gehosteten Steuerelementtypen. Diese Aktion wird standardmäßig nicht verfügbar gemacht, wenn Sie eine Instanz eines gehosteten Steuerelementtyps erstellen. Um die ExecuteOnExpressionTrue-Aktion mit einer Instanz eines gehosteten Steuerelementtyps zu verwenden, müssen Sie der entsprechenden gehosteten Steuerelementinstanz explizit eine UII-Aktion hinzufügen, die ExecuteOnExpressionTrue genannt wird.Weitere Informationen:Hinzufügen einer UII-Aktion zu einem gehosteten Steuerelement
ExecuteScriptlet
Führt das angegebene Skriptlet aus.
Parameter |
Beschreibung |
---|---|
Geben Sie den Namen des auszuführenden Skriptlets im Feld Daten an. |
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.
GetTemplate
Ruft den Inhalt einer zusammengeführten E-Mail-Vorlage ab.
Parameter |
Beschreibung |
---|---|
Name |
Name der abzurufenden Vorlage. |
id |
Die ID der mit dieser Vorlage für die Zusammenführung zu verbindenden Entität. |
InvokeCTI
Simuliert CTI-Ereignisse
Parameter |
Beschreibung |
---|---|
typ |
Dies ist der Typ des CTI-Ereignisses, wie z. B. Telefonanrufe oder Chats. |
appname |
Der Name für den Desktopmanager, der für diese Popup-Simulation zu verwenden ist. |
ani |
Die automatische Nummernidentifikation (ANI) oderdie Anrufertelefonnummer. |
dnis |
Die DNIS oder gewählte Nummer. |
Alle übrigen Parameter werden als Parameter an den CTI-Ereignisprozessor übergeben. |
LaunchURL
Startet eine URL in Internet Explorer außerhalb der Unified Service Desk-Anwendung. Sie müssen als Parameter die URL im Feld Daten angegeben.
LookupQueueItem
Sucht ein queueitem im System und ruft die Informationen ab.
Parameter |
Beschreibung |
---|---|
ID |
Die ID der Entität, die Ziel des queueItem ist |
EntityType |
Der Typ oder logische Name der Entität im ID-Feld. |
Die resultierenden queueitem-Details werden in den queueitem-Ersetzungsparameter gesetzt und können später referenziert werden.
MoveApplicationToPanel
Verschiebt ein gehostetes Steuerelement in den angegebenen Bereich in der Client-Anwendung.
Parameter |
Beschreibung |
---|---|
-App |
Name des zu verschiebenden gehosteten Steuerelements. |
panel |
Name des Zielbereichs. |
MoveToPanel
Verschiebt gehostete Steuerelemente zur Laufzeit zwischen Bereichen.
Parameter |
Beschreibung |
---|---|
-App |
Name des zu verschiebenden gehosteten Steuerelements. |
panel |
Zielbereich für das gehostete Steuerelement. |
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. |
Anhalten
Unterbricht das Ausführen der Aktion, ohne die Nachrichtenverarbeitung zu blockieren. Diese Aktion unterscheidet sich vom Anhalten des aktuellen Threads für die angegebene Dauer (Thread.Sleep), da die Aktion die Fortsetzung der Verarbeitung erlaubt. Diese Aktion ist hilfreich, wenn Sie warten, um Webvorgänge zum Abschluss kommen zu lassen.
Parameter |
Beschreibung |
---|---|
milliseconds |
Die Dauer der Pause in Millisekunden. |
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. |
ReadSettings
Dadurch werden die gespeicherten Einstellungen aus dem $Settings-Ersetzungsparameter gelesen.
Parameter |
Beschreibung |
---|---|
readfromcache |
True, wenn Sie die lokal zwischengespeicherte Version dieser Einstellungen lesen möchten.False oder fehlend. |
RedoScreenPop
Zeigt den letzten Bildschirm erneut. Dies kann in Situationen wichtig ist, in denen die Sitzungsgrenze erreicht wurde die die Anzeige nicht erfolgreich war, oder wenn Sie die Sitzung geschlossen haben, aber noch weitere Arbeit erforderlich ist. Diese Aktion benötigt keine Parameter.
ResetLocalCache
Setzt den Konfigurationscache in Unified Service Desk zurück. Beim nächsten Start von Unified Service Desk wird die Konfiguration vom Server heruntergeladen. Der Benutzer muss über Schreibzugang zu msdyusd_usersettings verfügen, damit diese Aktion ausgeführt werden kann.
RouteToQueue
Leitet eine Entität in Dynamics 365 an eine Warteschlange weiter.
Parameter |
Beschreibung |
---|---|
Ziel |
Die Zielwarteschlangen-ID. Dies schließt den Parameter destinationqueuename aus |
destinationqueuename |
Dies ist der Name der Warteschlange zum Weiterleiten der Entität. |
entitytype |
Dies ist der logische Name der weiterzuleitenden Entittät. |
entityid |
Dies ist die GUID/Id der Entität, die in die Warteschlange gesetzt werden soll. |
SaveAll
Speichert alle Formulare in dem gehosteten Steuerelement, 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.
SaveSetting
Speichert eine benutzerspezifische Einstellung.
Parameter |
Beschreibung |
---|---|
Name |
Der Name der Einstellung. Dies wird im $Settings-Ersetzungsparameter angezeigt. |
Wert |
Der Wert der zu speichernden Einstellung. |
SetTheme
Verwendet ein Design zum Verändern des Layouts oder Erscheinungsbilds der Benutzeroberfläche-Komponenten.Weitere Informationen:Das Erscheinungsbild der Anwendung anpassen
Parameter |
Beschreibung |
---|---|
löschen |
True, wenn Sie das aktuelle Design vollständig löschen möchten, bevor das angegebene Design angewendet wird. Wenn dieser Parameter auf "false" festgelegt oder nicht angegeben ist, werden die neuen Designinformationen mit dem aktuellen Design zusammengeführt. |
Der Restparameter (was übrig bleibt, nachdem andere Parameter entfernt wurden) sollte den Namen des zu verwendenden Designs enthalten. Dies sollte eine XAML-Datei sein (umbenannt zu XML und als Webressource hochgeladen), ein Webressourcenname, eine URL von einem anonymen Zugriffsserver oder roher XAML-Code, der das Design repräsentiert. |
SetAppBar
Dockt ein gehostetes Steuerelement an den angegebenen Rand des Client-Anwendungshauptfensters an.
Parameter |
Beschreibung |
---|---|
ApplicationName |
Der Name des anzudockenden gehosteten Steuerelements. Wenn dieser Parameter angegeben ist, wird das übergeordnete Fenster, das dieses gehostete Steuerelement hostet, angedockt. |
width |
Die Breite des angedockten Fensters in Pixeln. Wenn dieser Wert nicht angegeben ist, wird die aktuelle Breite des Fensters verwendet. |
height |
Die Höhe des angedockten Fensters in Pixeln. Wenn dieser Wert nicht angegeben ist, wird die aktuelle Höhe des Fensters verwendet. |
Rand |
Der Rand für den Andockvorgang. Wenn nichts angegeben wird, wird Oben angenommen. Geben Sie einen der folgenden Werte an: Oben, Unten, Links oder Rechts. |
SetEventTimer
Legt den Start eines Ereigniszeitgebers fest.
Parameter |
Beschreibung |
---|---|
Name |
Name des Ereigniszeitgebers. |
SetSize
Legt 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. |
SetWindowProperty
Legt den Fensterstatus für das Client-Anwendungshauptfenster fest.
Parameter |
Beschreibung |
---|---|
WindowState |
Einer der folgenden Werte: maximiert, minimiert oder normal. |
ShellExecute
Diese Aktion ist dafür gedacht, eine URL oder Befehlszeile zu starten. Beachten Sie, dass der Benutzer über die erforderlichen Rechte verfügen muss, um die Anwendung auszuführen.
Parameter |
Beschreibung |
---|---|
Der einzige Parameter ist die Befehlszeile ioder die URL der auszuführenden Anwendung. |
ShowAbout
Zeigt das Standard-Informationsfeld für Unified Service Desk an; dieses enthält Informationen wie etwa den Namen des aktuellen Benutzers, den Dynamics 365-Server und die Organisation, mit der der Benutzer verbunden ist, die Versionsnummer der Unified Service Desk-Client-Anwendung und die URL der Support-Website.
ShowTab
Setzt den Fokus auf eine Registerkarte (gehostetes Steuerelement) in Ihrer Agentenanwendung.
Parameter |
Beschreibung |
---|---|
Die erste Zeile in dem Aktionsaufruf sollte den Namen des gehosteten Steuerelements enthalten, das in den Vordergrund gebracht werden soll. Verwenden Sie nicht den Anzeigenamen des gehosteten Steuerelements. Weitere Informationen zur Verwendung dieses Aktionsaufrufs finden Sie unter Schritt 4 in Walkthrough 2: Anzeigen einer externen Webseite ain Ihrer Agentenanwendung. |
StopEventTimer
Beendet einen Ereigniszeitgeber.
Parameter |
Beschreibung |
---|---|
Name |
Name des anzuhaltenden Ereigniszeitgebers. |
Translate
Ermöglicht die Durchführung von Übersetzungen mit Microsoft Translator.
Parameter |
Beschreibung |
---|---|
Wert |
Dies ist der zu übersetzende Text. Dieser Wert kann für die Unterstützung mehrerer Zeilen übergangen werden. Einige korrekte Beispiele:
Weitere Informationen zu diesen Ersatzschlüsseln finden Sie unter Verwenden Sie Ersetzungsparameter zur Konfiguration des Unified Service Desk. |
fromlanguage |
Name der Quellsprache. Falls nicht angegeben, versucht das System, die Sprache des angegebenen Werts vor der Übersetzung zu erkennen. Eine Liste möglicher Sprachen finden Sie unter Übersetzer-Sprachcodes. |
tolanguage |
Name der Zielsprache. Eine Liste möglicher Sprachen finden Sie unter Übersetzer-Sprachcodes. |
clientId |
Eine Client-ID von Microsoft Azure für Übersetzungsdienste. Informationen zum Registrieren bei Azure finden Sie unter https://datamarket.azure.com. |
clientsecret |
Ein Client-Geheimnis von Microsoft Azure für Übersetzungsdienste. Informationen zum Registrieren bei Azure finden Sie unter https://datamarket.azure.com. |
Der übersetzte Wert wird unter dem $Rücksendung-Ersetzungsparameter angezeigt.
UpdateEntity
Aktualisiert einen Datensatz in Dynamics 365.
Parameter |
Beschreibung |
---|---|
ID |
Die ID des zu aktualisierenden Werts. Die muss die GUID des zu aktualisierenden Datensatzes sein. |
LogicalName |
Der logische Name der zu aktualisierenden Entität |
Jede folgende Zeile in der Parameterliste enthält eine Reihe von Name=Wert-Paaren, die die anderen Felder definieren, die beim Aktualisieren zu füllen sind.
Entitätsverweisen können wie die folgenden beschrieben werden:
Param=EntityReference(“logicalname”, “id”)
OptionSetValues können wie folgt angegeben werden:
Param=OptionSetValue(value)
Boolsche Werte können wie folgt beschrieben werden:
Param=Boolean(value)
PartyList (mit E-Mails verwendet) kann wie folgt beschrieben werden:
Param=PartyList(email[“test@test.com”], er[“contact”, guid])
Sie können eine beliebige Anzahl von E-Mail- und anderen EInträgen verwenden, um E-Mail-Adressen und Entitätsreferenzen zu repräsentieren.
Andere Werte wie etwa Zeichenfolgenwerte können wie folgt angegeben werden:
Param=value
Bearbeiten
Diese Aktion entspricht dem Auswählen eines Warteschlangenelements aus einer Warteschlange und dem Klicken auf die Schaltfläche "WorkOn" im Menüband. Sie markiert das Warteschlangenelement als derzeit von einem bestimmten Agenten bearbeitet.
Parameter |
Beschreibung |
---|---|
ID |
Dies ist die ID des queueitem. Siehe LookupQueueItem für Informationen dazu, wie die ID für eine Zielentität abgerufen wird. |
Aktion |
Optionaler Parameter, mit dem der Administrator angeben kann, dass das WorkOn-Attribut entfernt und in die Warteschlange zurückgesetzt werden soll. Gültige Werte: Entfernen – Entfernt das WorkOn-Attribut und gibt das Element an die Warteschlange zurück, damit andere Personen daran arbeiten. |
Vordefinierte Ereignisse
Dies sind die vordefinierten Ereignisse, die mit dem gehosteten Steuerelement dieses Typs verknüpft sind.
DesktopReady
Tritt beim Start auf, wenn die gesamte Desktopinitialisierung abgeschlossen ist und die Verbindungen zu Dynamics 365 eingerichtet wurden. Dieses Ereignis wird nur einmal ausgelöst, und es ist üblich, dieses Ereignis zu verwenden, um Layouts und andere Startup-Aktionen festzulegen.
SessionActivated
Tritt stets auf, wenn eine Sitzung aktiviert wird.
Parameter |
Beschreibung |
---|---|
Sitzungs-ID |
ID der aktiven Sitzung. |
IsGlobal |
Gibt an, ob dieses Ereignis für die globale Sitzung gilt. Ausgabewert "True" oder "False". |
Aktivieren |
Dies ist auf "True" gesetzt. |
SessionClosed
Tritt auf, wenn eine Sitzung geschlossen wird.
Parameter |
Beschreibung |
---|---|
Sitzungs-ID |
ID der Sitzung, die geschlossen wurde. |
IsGlobal |
Gibt an, ob dieses Ereignis für die globale Sitzung gilt. Ausgabewert "True" oder "False". |
SessionDeactivated
Tritt auf, wenn eine Sitzung deaktiviert wird.
Parameter |
Beschreibung |
---|---|
Sitzungs-ID |
ID der inaktiven Sitzung. |
IsGlobal |
Gibt an, ob dieses Ereignis für die globale Sitzung gilt. Ausgabewert "True" oder "False". |
Aktivieren |
Dies ist auf "False" gesetzt. |
SessionNew
Tritt auf, wenn eine neue Sitzung erstellt wird.
Parameter |
Beschreibung |
---|---|
Sitzungs-ID |
ID der neu erstellten Sitzung. |
IsGlobal |
Gibt "Wahr" aus, wenn es sich bei der neuen Sitzung um eine globale Sitzung handelt. Andernfalls wird "False" ausgegeben. |
Siehe auch
UII-Aktionen
Ereignisse
Vordefinierte Aktionen und Ereignisse für ein gehostetes Steuerelement anzeigen
Eingebettete Hilfe für Aktionen und Veranstaltungen anzeigen
Importieren von exemplarischen Vorgehensweisen zur Unified Service Desk-Konfiguration
Typen gehosteter Steuerelemente und Referenz zu Aktionen/Ereignissen
TechNet: Verwaltungshandbuch für Unified Service Desk für Microsoft Dynamics CRM
Unified Service Desk 2.0
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright