Scripts uitvoeren met behulp van scriptlets in Volledige servicedesk

Gepubliceerd: november 2016

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Scriptlets zijn stukjes JavaScript die worden uitgevoerd wanneer een speciale syntaxis wordt gebruikt voor uw vervangingsparameter. Soms bevatten de door het systeem gegenereerde vervangingsparameters de juiste gegevens die voor deze functies nodig zijn, maar hebben de gegevens niet de gewenste indeling. In Computer Telephone Integration (CTI) komen telefoonnummers meestal van het telefoonsysteem als een reeks cijfers van, bijvoorbeeld "3035551212", zonder opmaak. Echter, Microsoft Dynamics 365 slaat telefoonnummers op als tekenreeksen met opmaaktekens zoals (303) 555-1212. Als u uw Dynamics 365-entiteit zou zoeken met de gegevens die direct door het telefoonsysteem worden geleverd, is de kans klein dat er ooit een overeenkomst wordt gevonden. U lost dit op met behulp van scriptlets in Unified Service Desk.

In dit onderwerp

Hoe gebruikt u scriptlets?

Naar globale gehoste besturingselementen verwijzen vanuit uw scriptlets

Hoe gebruikt u scriptlets?

U definieert een scriptlet in het gebied Scriptjes (Instellingen > Scriptjes) in Microsoft Dynamics 365. Nadat u een scriptlet hebt gedefinieerd, kunt u de scriptlet in de volgende indeling als vervangingsparameter in uw query's of parameters voor de actieoproepen gebruiken.

[[script.<Scriptlet_Name>]]

Wanneer het systeem een dergelijke vervangingsparameter ziet die begint met script., wordt gezocht naar een script met de naam die overeenkomst met de tekst die erop volgt in uw scriptletlijst. Als een scriptlet wordt gevonden met de opgegeven naam, worden eerst de parameters in dat script vervangen en wordt vervolgens het script uitgevoerd als een JavaScript-expressie. De waarde van de expressie wordt gebruikt om de waarde te vervangen van de bovenstaande vervanging.

Naar globale gehoste besturingselementen verwijzen vanuit uw scriptlets

Scriptlets kunnen tijdens de uitvoering verwijzen naar globale gehoste besturingselementmethoden. Alle globale (niet-dynamische) gehoste besturingselementen worden bij het opstarten toegevoegd als scriptbare objecten aan de scriptletengine. Omdat JavaScript niet kan verwijzen naar namen met spaties erin, vervangt de scriptletengine automatisch spaties in de naam van uw globale gehoste besturingselement door onderstrepingstekens ("_"). U kunt daarom de volgende geldige JavaScript gebruiken.

Connection_Manager.ConfigurationReader.ReadAppSettings(“maxNumberOfSessions”);

Er bestaat een speciaal aanvraagscenario voor de Algemene beheerder. U kunt er ook naar verwijzen via CRMGlobalManager, ongeacht hoe het heet in de configuratie.

If (CRMGlobalManager.SessionCount == 0) // er zijn geen klantsessies geladen. Er is alleen een globale sessie geladen.

Stel u een situatie voor waarin u gegevens van het sessieoverzicht in uw Sessieregels-onderdeel wilt weergeven maar de gegevens zich bevinden in een extern systeem dat via webservices toegankelijk is, in plaats van beschikbaar te zijn op uw Dynamics 365-server. U kunt een gehost besturingselement maken met een openbare functie die de externe webservice aanroept. U configureert vervolgens dit gehoste besturingselement als een algemeen gehost besturingselement en plaatst het op het HiddenPanel. Deze functie en de webserviceoproep is nu bruikbaar vanuit een scriptlet. U kunt vervolgens de volgende scriptlet maken om de nieuwe functie aan te roepen.

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

Deze code geeft het accountnummer van de account door aan uw functie, als eerste parameter. Als u de scriptlet Webservice aanroepen noemt, kunt u de volgende Sessieregel gebruiken om het resultaat van de webserviceoproep weer te geven.

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

Zie ook

Vervangingsparameters
Algemene en sessiegebaseerde gehoste Unified Service Desk-besturingselementen

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht