Freigeben über

Ausführen von Skripts mithilfe der Skriptlets in Unified Service Desk

  • Artikel

Skriptlets sind Ausschnitte von JavaScript, die ausgeführt werden bei Verwendung einer besonderen Syntax für den Ersetzungsparameter. Gelegentlich enthalten vom System generierte Ersetzungsparameter die entsprechenden Daten, die für diese Funktionalität gebraucht werden, aber die Daten sind nicht im gewünschten Format enthalten. Z. B. kommen der Computer-Telefon-Integration (CTI) Telefonnummern in der Regel aus dem Telefonsystem als Zeichenfolge von Ziffern, z. B. "3035551212" ohne jde Formatierung. Microsoft Dataverse speichert jedoch Telefonnummern als Zeichenfolgen, die in der Regel Formatierungszeichen wie Bindestrich wie in (303) 555-1212 enthalten. Wenn Sie Ihre Entität mithilfe von Daten durchsuchen möchten, die direkt vom Telefonsystem angegeben wurden, sind die Chancen schlecht, Übereinstimmung zu finden. Sie können dies mit Scriptlets in Unified Service Desk erreichen.

Wie werden Skriptlets verwendet?

Definieren Sie im Bereich Skriptlets (Einstellungen>Skriptlets) in Dataverse. Nachdem Sie ein Skriptlet definiert haben, verwenden Sie das Skriptlet im folgenden Format als Ersetzungsparameter in Abfragen oder Parametern für Aktionsaufrufe.

[[script.<Scriptlet_Name>]]

Wenn das System solch einen Ersetzungsparameter sieht, der mit Skript. beginnt, sucht es nach einem Skript mit dem Namen, der dem Text entspricht, der ihm in der Skriptletliste folgt. Wenn ein Skriptlet mit dem angegebenen Namen gefunden wird, ersetzt es zunächst Parameter in dem Skript, und führt dann das Skript als JavaScript-Ausdruck aus. Der Wert des Ausdrucks wird verwendet, um den Wert der Ersetzung oben zur zu ersetzen.

Warnung

Wenn die Ersetzungsparameter in dem Skriptlet eine andere Skriptletersetzung enthalten, usw. bis es eine Schleife erstellt, führt dies dazu, dass das System kontinuierlich Parameter ersetzt, bis der Stapel überläuft. Daher wird es dringend empfohlen, dass Sie in den Skriptlets niemals [[script.ReplacementParameters]] verwendet.

Verweisen auf globale gehostete Steuerelemente von den Skriptlets aus

Skriptlets können bei der Ausführung auf globale gehostete Steuermethoden verweisen. Alle globalen gehostete (nixt-dynamischen) Steuerelemente werden beim Start als skriptfähige Objekte dem Skriptletmodul hinzugefügt. Da JavaScript nicht auf Namen mit Leerzeichen verweisen kann, ersetzt das Skriptletmodul automatisch Leerzeichen in dem Namen Ihres globalen gehosteten Steuerelements durchl Unterstriche "_". Sie können daher das folgende gültige JavaScript verwenden.

Connection_Manager.ConfigurationReader.ReadAppSettings(“maxNumberOfSessions”);

Es gint ein Szenario für Sonderfälle für den globalen Manager. Es kann auch über CRMGlobalManager darauf verwiesen werden, unabhängig davon, wie es in der Konfiguration genannt wird.

If (CRMGlobalManager.SessionCount == 0) // Es werden keine Kundensitzungen geladen. Nur eine globale Sitzung wird geladen.

Notiz

Nur öffentliche Funktionen sind über diese Methode verfügbar.

Angenommen, Sie möchten Sitzungsübersichtsinformationen in der Sitzungs-Zeilenkomponente anzeigen, aber bei all die Informationen befinden sich in einem externen System, das über die Webdienste zugägnglich ist und nicht in Ihrem Dataverse-Server. Sie könen ein gehostetes Steuerelement erstellen, das eine öffentlichen Funktion zur Verfügung stelt, die den externen Webdienst aufruft. Konfigurieren Sie dann das gehostete Steuerelement als globales Steuerelement und platzieren Sie es auf dem HiddenPanel. Diese Funktion und der Webdienstaufruf ist jetzt von einem Skriptlet verwendbar. Sie könnten dann das folgende Skriptlet erstellen, um Ihre neue Funktion aufzurufen.

My_Global_Application.CallExternalWebService(“[[account.accountnumber]$]”);

Der Code übegibt die Kontonummer von dem Konto an Ihre Funktion als ersten Parameter. Wenn Sie Ihr Skriptlet Webdienstaufruf nennen, können Sie es in der folgenden Sitzungszeile verwenden, um das eegebnis des des Webdienstaufrufs anzuzeigen.

<Grid Margin="0"  
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"  
  xmlns:CCA="clr-namespace:Dynamics;assembly=Dynamics">  
<Grid.RowDefinitions>  
 <RowDefinition Height="auto" />  
</Grid.RowDefinitions>  
<Grid.ColumnDefinitions>  
 <ColumnDefinition Width="100"/>  
 <ColumnDefinition Width="*" />  
 <ColumnDefinition Width="auto" />  
</Grid.ColumnDefinitions>  
<Label Margin="3,0,5,3" Content="Web Service Data" Padding="0" Grid.Row="4" HorizontalAlignment="Right" FontFamily="Tohoma" FontSize="12" FontWeight="Bold" />  
<TextBlock Text="[[script.Call Web Service]]" Margin="0" Grid.Column="1" Grid.Row="4" Padding="3,0,0,3" FontFamily="Tohoma" FontSize="12"/>  
</Grid>

Siehe auch

Ersetzungsparameter
Globale und sitzungsbasierte Unified Service Desk-gehostete Steuerelemente