Globaler Manager (Gehostetes Steuerelement)
Der Typ Global Manager gehostetes Steuerelement ist das Herzstück von Unified Service Desk und eine Instanz dieses gehosteten Steuerelements wird von Unified Service Desk benötigt. Dieses gehostete Steuerelement lädt und liest beim Anwendungsstart alle Unified Service Desk-Konfigurationsdaten aus Microsoft Dataverse, interpretiert die Regeln für die Fensternavigation, stellt den Komponenten der Symbolleiste und den Skripts der Bearbeiter Daten zur Verfügung 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 je einer Instanz des gehosteten Steuerelements Global Manager vorkonfiguriert. Weitere Informationen über die Beispielanwendungen finden Sie unter Unified Service Desk-Beispielanwendungen für den CRM-Server mithilfe des Package Deployer bereitstellen.
Der gehostete Steuerelement-Typ Global Manager stellt nicht nur die Interpretation für die meisten Funktionen in Unified Service Desk bereit, sondern auch die mehrsprachigen Funktionen im System, so dass Sie UI-Zeichenfolgen und Nachrichten in Ihrer Anwendung in mehreren Sprachen lokalisieren 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.
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 Aufgabendatensatzes siehe Gehostete Steuerelement erstellen und anzeigen.
Wählen Sie in der Anzeige Neues gehostetes Steuerelement unter dem Bereich Unified Service Desk die Option Globaler Manager aus der Dropdownliste Unified Service Desk--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 Dataverse hergestellt wurde, mithilfe des gehosteten Steuerelements des Typs Verbindungs-Manager. Informationen zu den Allgemein Feldern finden Sie unter Gehostete Steuerelemente erstellen oder bearbeiten
Als nächstes wählen Sie die Registerkarte Sprachdienstleistungen aus, um Ressourcen zum Hinzufügen lokalisierter Zeichenfolgen für die Benutzeroberfläche Ihrer Agent-Anwendung hinzuzufügen. Informationen zum Hinzufügen dazugehöriger lokalisierten Ressourcen siehe Mehrsprachensupport für Agent-Anwendung hinzufügen, anzeigen.
Vordefinierte UII-Aktionen
Globaler Manager bietet eine Reihe vordefinierter Aktionen, mit denen Sie Dataverse-Datensatzdaten über Webservices bearbeiten können. Die vordefinierten Aktionen können während der Konfiguration verwendet werden, um in Dataverse erweiterte Aufgaben durchzuführen.
Folgende vordefinierte UII-Aktionen sind für gehostete Steuerelemente des Typs Globaler Manager verfügbar:
Audit
Fügen Sie einen Audit-Eintrag zu den Unified Service Desk Audit-Protokollen hinzu. Weitere Informationen finden Sie unter Konfigurieren der Überwachung in Unified Service Desk
| Parameter | Beschreibung |
|---|---|
| Name | Der Name des Überwachungseintrags.. Sie müssen eine Option unter dem Bereich Optionen hinzufügen (Einstellungen>Unified Service Desk> Optionen (Wie komme ich dahin?)) wobei der Wert auf 1 festgelegt ist. |
| 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 | Daten, die in den Audit-Eintrag geschrieben werden sollen. 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 | Panel zum Auffinden der aktiven Anwendung, wenn keine Anwendung angegeben ist. |
| Aktion | Aktion, um das gehostete Steuerelement aufzurufen. |
| -Daten | Datenparameter zur Übergabe an die Aktion. |
| Anwendung | Name des gehosteten Steuerelements, für das Sie einen Aktionsaufruf ausführen möchten. Wenn der Name des gehosteten Steuerelements angegeben ist, wird der Parameter Panel 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 möchten, dass die an die globale Sitzung gebundenen Suchergebnisse gelöscht werden. Sie müssen beim Speichern von Suchergebnissen in der globalen Sitzung vorsichtig sein, da die Suchergebnisse 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. 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
Enthält einen Aktivitätsdatensatz in modellgesteuerten Apps.
| Parameter | Beschreibung |
|---|---|
| Kennung | 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. |
Um beispielsweise eine Telefonanruf-Aktivität zu schließen, müssen Sie die folgenden Parameter und Werte angeben:
Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed
Wenn der Aktivitätsdatensatz geschlossen wird, wird der $Return-Systemersatzparameter mit einem Booleschen Wert aufgefüllt, der angibt, ob die Aktion erfolgreich war oder nicht.
CreateEntity
Erstellt einen neuen Datensatz in den modellgesteuerten Apps.
| Parameter | Beschreibung |
|---|---|
LogicalName |
Der logische Name der zu erstellenden Entität. |
RunAsync |
Setzen Sie den Parameter auf True, um den Entitätsdatensatz asynchron zu erstellen, damit Unified Service Desk nicht blockiert wird und während der Ausführung der Aktion ansprechbar bleibt. Hinweis: Die zugeordneten Teilhandlungsaufforderungen und die folgenden Handlungsaufforderungen für die Aktion CreateEntity warten nicht darauf, dass das asynchrone Erstellen abgeschlossen wird. Wird die Aktion CreateEntity asynchron ausgeführt, müssen Sie daher die Teilhandlungsaufforderungen, die vom erstellten Datensatz abhängen, so konfigurieren, dass sie erst ausgeführt werden, wenn der Zieldatensatz vollständig ist. Dies erfolgt mit der Aktion ExecuteOnDataAvailable im gehosteten Steuerelement „Globaler Manager“. |
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.
| Parameter | Beschreibung |
|---|---|
| BackGround | Setzen Sie den Wert des Parameters auf True. Eine Sitzung wird erstellt, aber der Fokus wird nicht sofort auf die neue Sitzung geändert. Alle Unteraktionen dieses Aktionsaufrufs werden nur dann ausgeführt, wenn Sie manuell zu dieser Sitzung wechseln. |
| SessionName | Name des Sitzungsregisters für die neu erstellte Sitzung. Dieser Parameter ist abhängig vom BackGround-Parameter. |
DeleteEntity
Löscht einen neuen Datensatz in den modellgesteuerten Apps.
| Parameter | Beschreibung |
|---|---|
| Kennung | Die ID (GUID) des zu löschenden Datensatzes. |
| 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 Dataverse-Webdienste mithilfe von FetchXML auf, die als eine Entitätssuche in Unified Service Desk definiert sind. Weitere 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 möchten, dass die an die globale Sitzung gebundenen Suchergebnisse gelöscht werden. Sie müssen beim Speichern von Suchergebnissen in der globalen Sitzung vorsichtig sein, da die Suchergebnisse 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. |
Notiz
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 finden Sie unter: Optionen für Unified Service Desk verwalten
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: $Return.
DisplayMessage
Zeigt dem Benutzer ein Meldungsfeld an.
| Parameter | Beschreibung |
|---|---|
| Text | Der im Meldungsfeld angezeigte Text. Wenn dieser Parameter nicht angegeben ist, wird eventuell verbleibender Text (Restparameter) oder eine leere Zeichenfolge verwendet. |
| Beschriftung | Im Meldungsfeld angezeigte Beschriftung. Wenn keine Beschriftung angegeben ist, wird Dataverse Meldung verwendet. |
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: Wie Sie die speziellen Aktionen ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue verwenden
| 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: Wie Sie die speziellen Aktionen ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue verwenden
| 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 Unteraktionen, bis ein angegebener JavaScript-Ausdruck true zurückgibt. 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: Wie Sie die speziellen Aktionen ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue verwenden
| 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 JavaScript-Ausdruck, der ausgewertet werden soll. Wenn dieser Ausdruck trueist, werden Teilhandlungen ausgeführt.Daten-Parameter-Beispiel: milliseconds=5000 Funktion IsAccountLoaded() { Rückgabe “[[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 Berichts 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 die gewählte Nummer. |
| Alle Alle überigen Parameter werden zum CTI-Ereignisprozessor als Parameter ü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 |
|---|---|
| Kennung | 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 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. |
Notiz
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 dieses Aktionsanrufs finden Sie in Schritt 4 Walkthrough 7: Konfigurieren von Agenten-Scripting einer externen Webseite Ihrer Agent-Anwendung
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 auf Zwischenspeichern festgelegte Version dieser Einstellungen lesen möchten.
False oder fehlt sonst. |
RedoScreenPop
Zeigt den letzten Bildschirm erneut. Dies kann in Fällen nützlich sein, in denen das Sitzungslimit erreicht wurde und das Popup nicht erfolgreich war, oder wenn Sie die Sitzung geschlossen haben, aber mehr Arbeit erforderlich ist. Diese Aktion benötigt keine Parameter.
ResetLocalCache
Setzt den Zwischenspeicher der Konfiguration in Unified Service Desk zurück. Wenn Unified Service Desk das nächste Mal gestartet wird, lädt es die Konfiguration vom Server herunter. Der Benutzer muss über Schreibzugang zu msdyusd_usersettings verfügen, damit diese Aktion ausgeführt werden kann.
RouteToQueue
Dadurch wird eine Entität in modellgesteuerten Apps an eine Warteschlange weitergeleitet.
| 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: Verwenden Sie Designs, um das Erscheinungsbild Ihrer Anwendung anzupassen
| Parameter | Beschreibung |
|---|---|
| löschen |
True, wenn Sie das aktuelle Design vollständig löschen möchten, bevor Sie das angegebene Design anwenden. 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 ein roher XML-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 |
|---|---|
| Breite | 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 startet eine URL oder eine Befehlszeile. 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 Dialogfeld „Info“ für Unified Service Desk an, das Informationen wie den Namen des aktuellen Benutzers, den Server Dataverse und die Organisation, mit der der Benutzer verbunden ist, die Versionsnummer der Unified Service Desk Client-Anwendung und die URL der Support-Site enthält.
ShowTab
Setzt den Fokus auf eine Registerkarte (gehostetes Steuerelement) in Ihrer Agent-Anwendung.
| 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 Aktionsanrufs finden Sie in Schritt 4 Walkthrough 2: Anzeigen einer externen Webseite ain Ihrer Agent-Anwendung |
StopEventTimer
Beendet einen Ereigniszeitgeber.
| Parameter | Beschreibung |
|---|---|
| Name | Name des anzuhaltenden Ereigniszeitgebers. |
TriggerEdgeWebView2PoolCleanUp
Bereinigt den Edge WebView2-Pool.
TriggerChromePoolCleanUp
Bereinigt den Chrome-Pool.
Übersetzen
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 Ersetzungsschlüssel in 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, die Sie von Azure für Übersetzungsdienste erhalten haben. Informationen zum Registrieren bei Azure. |
| clientsecret | Ein Client-Geheimnis, das Sie von Azure für Übersetzungsdienste erhalten haben. Informationen zum Registrieren bei Azure. |
Der übersetzte Wert wird unter dem $Return-Ersetzungsparameter angezeigt.
UpdateEntity
Aktualisiert einen neuen Datensatz in den modellgesteuerten Apps.
| Parameter | Beschreibung |
|---|---|
| Kennung | 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 ER-Einträgen verwenden, um E-Mail-Adressen bzw. Entitätsreferenzen darzustellen.
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 |
|---|---|
| Kennung | Dies ist die ID des queueitems. 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 Dataverse 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-AktionenEreignisseVordefinierte Aktionen und Ereignisse für ein gehostetes Steuerelement anzeigenEingebettete Hilfe für Aktionen und Ereignisse anzeigenUnified Service Desk Configuration WalkthroughsGehostete Steuerelementtypen und Referenz für Aktionen/Ereignisse