Vervangingsparameters

Gepubliceerd: november 2016

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

Vervangingsparameters kunnen overal in de toepassing worden gebruikt om gegevens uit gegevenselementen (gegevensparameters genoemd) te halen die zijn vastgelegd tijdens het uitvoeren van de toepassing en die de Unified Service Desk-context uitbreiden en omvatten. De context bestaat uit naam/waarde-tekenreeksparen die vaak veranderen omdat er op allerlei manieren gegevens worden gedetecteerd wanneer de toepassing wordt gebruikt. Vervangingsparameters worden gebruikt voor een groot aantal taken zoals het opgeven van URL-querytekenreeksen, het genereren van scriptuitvoer in scriptlets, het opgeven van zoekactiewaarden voor entiteitzoekacties, Computer Telephone Integration (CTI) en het opgeven van invoer voor acties die worden aangeroepen in andere gehoste besturingselementen. Vervangingsparameters zijn de belangrijke elementen die een hoge mate van configuratie of aanpassing in Unified Service Desk mogelijk maken zonder dat code hoeft te worden gebruikt.

Voor informatie over hoe u vervangingsparameters kunt gebruiken om uw agenttoepassing te configureren raadpleegt u Vervangingsparameters gebruiken om Volledige servicedesk te configureren.

In dit onderwerp

De vervangingsparameters weergeven in Unified Service Desk

Systeemvervangingsparameters

De vervangingsparameters weergeven in Unified Service Desk

Het foutopsporingsbesturingselement in de clienttoepassing kan worden gebruikt om op elk gewenst moment de lijst weer te geven met beschikbare vervangingsparameters.

1. Start de Unified Service Desk-client en meld u aan bij Microsoft Dynamics 365 waar u de voorbeeldpakketten hebt geïnstalleerd.

2. Klik in het hoofdscherm van de Unified Service Desk-client op de pijl-omlaag naast het tandwiel in de rechterbovenhoek en selecteer Foutopsporing. De Debugger wordt weergegeven.

   

3. Klik in de Debugger op Gegevensparameters om de vervangingsparameters weer te geven.

   

Er wordt een boomstructuur gebruikt om de beschikbare variabelen voor te stellen. Geef bij het opgeven van de variabele de naam op het hoofdniveau op, gevolgd door een punt (.) en dan de naam in de lijst. Hieronder volgen een aantal voorbeelden:

• [[$Session.IsGlobal]]

• [[$User.fullname]]

Deze waarden veranderen terwijl de gebruiker communiceert met de Unified Service Desk-client. Actieoproepen halen de huidige waarde op en gebruiken die in de parameterlijst, of waar deze ook kan worden gebruikt. Wanneer de variabelen worden bijgewerkt, wordt de gebeurtenis NotifyContextChange geactiveerd in de basisbesturingselementen, zelfs als de Unified Service Desk-context zelf niet is veranderd. Hierdoor kunnen functies zoals de Sessieregels de waarden van de vervangingsparameters opnieuw controleren om te bekijken of de weergave moet worden bijgewerkt.

Systeemvervangingsparameters

Systeemvervangingsparameters zijn de vervangingsparameters die worden gedefinieerd en gevuld door het systeem en de namen beginnen met $ om ze gescheiden te houden van de door de gebruiker gedefinieerde vervangingsparameters. Bijvoorbeeld: $Global.Unified Service Desk heeft de volgende vervangende parameters:

• $Context

• $Debug

• $Global

• $Panel

• $Resources

• $Return

• $Session

• $Settings

• $Subject

• $SystemParameters

• $User

$Context

Deze sectie bevat de inhoud van de User Interface Integration (UII)-sessiecontext en verschaft een handige manier om UII-sessiecontextvariabelen te gebruiken in de Unified Service Desk-toepassing.

$Debug

Dit is een speciale vervangende waarde die alleen in een Scriptlet wordt gebruikt om te bepalen of het door het foutopsporingsvenster wordt aangeroepen. Met name als scriptlets ertoe leiden dat acties worden uitgevoerd op het systeem, testen we deze parameter om te bepalen of we het codeblok moeten overslaan om bijwerkingen te voorkomen tijdens het oplossen van fouten. De volgende scriptlet zou het gehoste besturingselement Account starten en het tabblad weergeven wanneer het foutoplossingsvenster wordt geopend.

CRMGlobalManager.GetApp(“Account”);

Dit komt doordat de scripts worden uitgevoerd in de huidige context om de waarden in de huidige status van het systeem te bepalen. Als u dit effect wilt vermijden, doet u het volgende.

If ([[$Debug]]!= true) CRMGlobalManager.GetApp(“Account”);

Hierdoor wordt de bijwerking voorkomen en toch nuttige informatie verschaft aan de debugger.

$Global

Dit gedeelte wordt automatisch toegevoegd om alle opties die in Dynamics 365-opties zijn geconfigureerd en hun waarden weer te geven. Dit maakt opties eenvoudig toegankelijk omdat ze kunnen worden gebruikt om de uitvoering te controleren of om gedrag te controleren dat is gemaakt in workflows of actieoproepen. Alle controlemarkeringen zijn automatisch zichtbaar van deze sectie.

$Panel

De vervangingsparameter $Panel bevat alle gehoste besturingselementen en de huidige paneelnamen als sleutelwaardeparen die naar een ander paneel zijn verplaatst nadat u voor het laatst de Unified Service Desk-client hebt gestart. De vervangingsparameter is alleen beschikbaar als ten minste één gehost besturingselement gewijzigde panelen heeft nadat u de Unified Service Desk-client voor het laatst hebt gestart. Alle andere gehoste besturingselementen en hun bestaande panelen die momenteel in de Agent Desktop zijn geladen zijn niet beschikbaar in deze vervangingsparameter.

$Resources

Deze verzameling vervangingsparameters wordt gevuld door de Algemene beheerder met taal-id's. In de configuratie van het gehoste besturingselement van het type Algemene beheerder kunt u diverse taalresources opgeven. Deze bronnen hebben de vorm van .resx-bestanden maar worden als XML-bestanden geüpload in webresources. Bij het uploaden van de toepassing leest Unified Service Desk de huidige taalinstelling uit Dynamics 365 en wordt deze taal gezocht in de talenlijst van Algemene beheerder. Als het artikel in de lijst staat, wordt de resource van taal-id's geladen in deze $Resources-verzameling.

Als u van plan bent taalneutrale tekst in de uitvoer op te nemen, kunt u in plaats daarvan de vervangingsparameters uit de $Resources-verzameling gebruiken. U kunt bijvoorbeeld het volgende voor knoptekst gebruiken.

[[$Resources.MyButtonName]+]

Afhankelijk van de geselecteerde taal voor de gebruiker wordt de juiste gelokaliseerde tekst gebruikt.

Het is ook belangrijk op te merken dat deze vervangingsparameters, en daarmee de .resx-bestanden die worden geladen, de vervangingsparametersyntaxis zelf kunnen bevatten. Nadat $Resources-waarden zijn vervangen, worden ze opnieuw gecontroleerd voor meer vervangingsparameters. Op deze manier kunt u, ook al biedt u taalspecifieke tekenreeksen, in deze tekenreeks ook gegevens uit de rest van de toepassing gebruiken.

Voor informatie over het toevoegen van gelokaliseerde resources om Unified Service Desk te configureren, raadpleegt u Meertalige ondersteuning voor uw agenttoepassingen toevoegen.

$Return

Sommige acties geven een tekenreekswaarde als resultaat. De tekenreekswaarde wordt geplaatst in de vervangingsparameter $Return met de naam van de actieoproep. Dit patroon wordt gevolgd:

[[$Return.ActionCallName]]

Een voorbeeld hiervan kan het aanroepen van CreateEntity in Algemene beheerder zijn. Hierdoor wordt een record in Dynamics 365 gemaakt en wordt de GUID van de nieuwe record als resultaat gegeven. Deze nieuwe GUID komt in de $Return-lijst met vervangingsparameters en kan worden gebruikt als invoer voor de volgende actie.

$Session

De sectie $Session bevat nuttige variabelen die nodig zijn voor actieoproepen, zoals de sessietelling, of de actieve sessie algemeen is en de momenteel actieve sessie-id. De StartTime-waarde van de sessie kan worden gebruikt voor het schrijven van de begintijd naar een activiteit. Deze sectie wordt automatisch gevuld.

$Settings

Deze sectie biedt gebruikersinstellingen die alleen van toepassing zijn op de huidige gebruiker. Deze instellingen worden automatisch geladen bij het opstarten en kunnen tijdens de uitvoering worden gelezen met een actieoproep. Ze bevatten vaak instellingen voor de themaselectie van de gebruiker, maar kunnen toegang verlenen tot gebruikerspecifieke instellingen die de configurator beschikbaar wil maken.

Deze gebruikersinstellingen worden gedefinieerd in het gebied Gebruikersinstellingen (Instellingen > Gebruikersinstellingen) in Dynamics 365 tijdens de configuratie van Unified Service Desk.

Deze instellingen kunnen als andere vervangingsparameter in het systeem worden gebruikt. Het gehoste besturingselement van het type Algemene beheerder levert een actie, SaveSetting, die gebruikersinstellingen naar de server schrijft, aangenomen dat de gebruiker schrijftoegang heeft. Dit kan worden gebruikt om gebruikerspecifieke voorkeuren op te slaan, zoals themaselectie en indelingen.

$Subject

Een nuttige mogelijkheid in Unified Service Desk is de onderwerpstructuur automatisch te vullen in een nieuwe aanvraag die namens de gebruiker wordt gemaakt. Soms wilt u het onderwerpveld automatisch vullen, maar u weten welke waarden moeten worden gebruikt, wat van systeem op systeem kan veranderen.

Met dit item kunt u verwijzen naar een specifiek onderwerp als u de aanvraag maakt, door de volgende vervangingsparameter te gebruiken.

[[$Subject.Default Subject.Id]][[$Subject.Default Subject.LogicalName]]

$SystemParameters

Deze sectie bevat een variabele met de naam HighContrast waarmee wordt aangegeven of de hoog-contrastmodus in Windows wordt ingeschakeld of niet (true/false). U kunt deze variabele gebruiken om te bepalen of normale aangepaste kleuren of systeemkleuren (compatibel met de hoog-contrastinstelling) worden ingeschakeld wanneer u uw thema in de client aanpast.Meer informatie:Customize themes for High Contrast settings

$User

Deze vervangingsparametersgroep wordt automatisch gevuld met de inhoud van de huidige systeemgebruikersrecord in Dynamics 365. Als de beheerder bijvoorbeeld de systeemgebruikerentiteit in Dynamics 365 uitbreidt met een agent-id, wordt deze agent-id in deze lijst opgenomen. Dit kan worden gebruikt om speciale gebruikersinstellingen te configureren.

Zie ook

Vervangingsparameters gebruiken om Volledige servicedesk te configureren
Scripts uitvoeren met behulp van scriptlets in Volledige servicedesk
Gegevens zoeken met entiteitzoekacties in Volledige servicedesk
Leren werken met Volledige servicedesk
Algemene beheerder (gehost besturingselement)

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht