Køre scripts med scriptlets i Unified Service Desk

 

Udgivet: november 2016

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Scriptlets er kodestykker af JavaScript, der køres, når du bruger en speciel syntaks til erstatningsparameteren. Nogle gange indeholder de systemgenererede erstatningsparametre de korrekte data, der er nødvendige for disse funktioner, men indeholder muligvis ikke dataene i det ønskede format. For eksempel kommer i CTI-telefonnumre (Computer Telephone Integration) typisk fra telefonsystem som en streng af cifre som "3035551212" uden formatering. Men Microsoft Dynamics 365 gemmer dog telefonnumre som en streng, der typisk indeholder formateringstegn som tankestreger i (303) 555-1212. Hvis du skulle søge i dit Dynamics 365-objekt ved hjælp af de data, der leveres direkte af telefonsystemet, er ændringerne så små, at der altid kan findes et match. Du løser dette ved hjælp af scriptlets i Unified Service Desk.

Dette emne indeholder

Sådan bruges scriplets

Referencer til globale tilknyttede kontrolelementer fra dine scriptlets

Sådan bruges scriplets

Du kan definere et scriptlet i området Scriptlets (Indstillinger > Scriptlets) i Microsoft Dynamics 365. Når du har defineret et scriptlet, kan du bruge dette scriptlet i følgende format som en erstatningsparameter i dine forespørgsler eller parametre til handlingsopkald.

[[script.<Scriptlet_Name>]]

Når systemet ser sådan en erstatningsparameter, der begynder med script., kigger det efter et script med navnet, der svarer til teksten, der efterfølger det på listen over scriptlet. Hvis der findes et scriptlet med det angivne navn, vil den først erstatte parametre i det pågældende script og derefter køre scriptet som et JavaScript-udtryk. Værdien af udtrykket skal bruges til at erstatte værdien af ovenstående udskiftning.

Bemærk

Hvis erstatningsparametrene i dette scriptlet indeholder en anden scriptlet-erstatning, og så videre, indtil den opretter en løkke, får det systemet til kontinuerligt at erstatte parametre, indtil der forekommer stakoverløb. Derfor kan det anbefales, at du aldrig bruger [[script.ReplacementParameters]] i dine scriptlets.

Referencer til globale tilknyttede kontrolelementer fra dine scriptlets

Scriptlets kan henvise til globale tilknyttede kontrolelementmetoder under udførelse. Alle globale (ikke-dynamiske) tilknyttede kontrolelementer tilføjes som script-bare objekter til scriptlet-motoren ved start. Da JavaScript ikke kan referere til navne med mellemrum i dem, erstatter scriptlet-motoren automatisk mellemrum i navnet på dit globale tilknyttede kontrolelement med "_" understregningstegn. Du kan derfor bruge de følgende gyldige JavaScript.

Connection_Manager.ConfigurationReader.ReadAppSettings(“maxNumberOfSessions”);

Der findes særlige tilfælde for Global Manager. Det kan også henvises til via CRMGlobalManager, uanset hvad det hedder i konfigurationen.

Hvis (CRMGlobalManager.SessionCount == 0) / / ingen kundesessioner er indlæst. Kun en global session er indlæst.

Bemærk

Kun offentlige funktioner er tilgængelige via denne metode.

Lad os antage, at du vil have vists oplysninger om sessionsoversigten i din Sessionslinje-komponent, men oplysningerne ligger faktisk i et eksternt system, der er tilgængeligt via webtjenester i stedet for Dynamics 365-serveren. Du kan oprette et tilknyttet kontrolelement, der viser en offentlig funktion, som kalder den eksterne webtjeneste. Du konfigurerer derefter dette tilknyttede kontrolelement som et globalt tilknyttet kontrolelement og placerer det på HiddenPanel. Denne funktion og dette webtjenesteopkald kan nu bruges fra et scriptlet. Du kan derefter oprette følgende scriptlet for at kalde den nye funktion.

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

Denne kode sender firmanummeret fra firmaet i din funktion som den første parameter. Hvis du navngiver dit scriptlet Kalde webtjenesten, kan du derefter bruge følgende linje i sessionen til at vise resultatet af kaldet til webtjenesten.

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

Se også

Erstatningsparametre
Globale og sessionsbaserede Unified Service Desk-tilknyttede kontrolelementer

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret