Freigeben über


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.

Gehostetes Globaler Manager-Steuerelement

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
[[account.Id]]
[[incident.Id]]

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
function IsAccountLoaded()
{
return “[[account.Id]$+]” != “”;
}
IsAccountLoaded();

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.

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:

value=$Escaped("my string<br>new line\\\"my text\\\"")
value=[[myapp.myparam]^]
value=$Escaped([[myapp.myparam]$])

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