Algemene beheerder (gehost besturingselement)

 

Gepubliceerd: november 2016

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

Het gehoste besturingselement van het type Algemene beheerder vormt de kern van Unified Service Desk en er is een exemplaar van dit gehoste besturingselement nodig voor Unified Service Desk. Dit gehoste besturingselement wordt geladen en leest alle Unified Service Desk-configuratiegegevens van Microsoft Dynamics 365 bij het opstarten, interpreteert de vensternavigatieregels, biedt gegevens aan de werkbalkonderdelen en agentscripts aan en beheert de gegevens voor de sessie. Er kan slechts één exemplaar van het gehoste besturingselement van het type Algemene beheerder worden geladen.

Belangrijk

Alle drie de voorbeeldtoepassingen voor Unified Service Desk en Interactive Service Hubzijn vooraf geconfigureerd met een exemplaar van het gehoste besturingselement van het type New EnvironmentVerbindingsbeheerCRM Web Client. Voor meer informatie, zie TechNet: Voorbeeldtoepassingen van Unified Service Desk op CRM-server implementeren met behulp van Package Deployer.

Naast het bieden van interpretatie voor de meeste functies in Unified Service Desk, biedt het gehoste besturingselement van het type Algemene beheerder ook de meertalige functies in het systeem, zodat u UI-tekenreeksen en -berichten in uw toepassing in meerdere talen kunt lokaliseren. Zie Meertalige ondersteuning voor uw agenttoepassingen toevoegen voor meer informatie. Het biedt ook de zoekactieprovider, die algemeen is ontworpen en kan worden aangepast door middel van configuratie.

In dit onderwerp

Een gehost besturingselement van het type Algemene beheerder maken

Vooraf gedefinieerde UII-acties

Vooraf gedefinieerde gebeurtenissen

Een gehost besturingselement van het type Algemene beheerder maken

Bij het maken van een nieuw, gehost besturingselement variëren de velden in het scherm Nieuw gehost beheer afhankelijk van het type gehost besturingselement dat u wilt maken. Deze sectie bevat informatie over de specifieke velden die uniek zijn voor het gehoste besturingselement van het type Globale beheerder. Voor gedetailleerde informatie over het maken van gehost besturingselement raadpleegt u Een gehost besturingselement maken of bewerken.

Algemene beheerder (gehost besturingselement)

In het scherm Nieuw gehost beheer, onder het gebied Unified Service Desk, selecteert u Globale beheerder in de vervolgkeuzelijst Onderdeeltype van Unified Service Desk. Controleer ook of u de waarde Sorteervolgorde van dit gehoste besturingselement op 2 hebt ingesteld om te zorgen dat dit het eerste gehoste besturingselement is dat wordt geladen door uw agenttoepassing onmiddellijk nadat de verbinding tot stand is gebracht met Dynamics 365 met behulp van het gehoste besturingselement Verbindingsbeheer. Voor meer informatie over algemene velden raadpleegt u Een gehost besturingselement maken of bewerken.

Nadat u de record hebt opgeslagen, wordt het gebied Taalservices beschikbaar, waar u resources voor het toevoegen van gelokaliseerde tekenreeksen voor de gebruikersinterface van uw agenttoepassing toevoegt. Voor informatie over hoe u taalresources toevoegt raadpleegt u Meertalige ondersteuning voor uw agenttoepassingen toevoegen.

Vooraf gedefinieerde UII-acties

De Algemene beheerder biedt een reeks vooraf gedefinieerde acties waarmee u Dynamics 365-recordgegevens kunt manipuleren via de webservices. Deze kunnen tijdens de configuratie worden gebruikt om geavanceerde functies uit te voeren in Dynamics 365.

De volgende vooraf gedefinieerde UII-acties zijn beschikbaar voor het gehoste besturingselementtype Algemene beheerder:

Controle

Deze actie voegt een controlevermelding toe aan de Unified Service Desk-controlelogboeken. Zie voor meer informatie Technet: Controle configureren in Unified Service Desk

Parameter

Beschrijving

Naam

De naam van de controlevermelding. U moet een optie toevoegen in het gebied onder Opties (Instellingen > Unified Service Desk > Opties (Hoe kom ik daar?)) met de waarde ingesteld op 1.

Actie

Tekenreeks die de actie vertegenwoordigt die moet worden gecontroleerd.

TargetApplication

Tekenreeks die de doeltoepassing vertegenwoordigt voor de controle.

CustomerId

Tekenreeks die de klant-id vertegenwoordigt.

ContextId

Tekenreeks die de context-id vertegenwoordigt.

ApplicationId

GUID van het gehoste besturingselement voor de controle.

AgentState

Tekenreeks die de agentstatus vertegenwoordigt

ActionData

Dit zijn de gegevens die naar de controlevermelding moeten worden geschreven. Als deze parameter niet expliciet wordt opgegeven, worden alle resterende regels in de het veld Gegevens van de definitie van uw actieoproep gebruikt.

CallDoAction

Roept een actie aan op een ander gehost besturingselement.

Parameter

Beschrijving

panel

Dit is het paneel voor het zoeken van de actieve toepassing wanneer geen toepassing is opgegeven.

actie

Dit is de actie die moet worden aangeroepen in het gehoste besturingselement.

-gegevens

Dit is de gegevensparameter die aan de actie moet worden doorgegeven.

toepassing

Dit is de naam van het gehoste besturingselement waarvoor u een actieoproep wilt uitvoeren. Als deze parameter is opgegeven, wordt de parameter panel genegeerd.

ClearAppBar

Hiermee wordt het opgegeven gehoste besturingselement in de clienttoepassing losgekoppeld.

Parameter

Beschrijving

ApplicationName

De naam van het gehoste besturingselement dat moet worden losgekoppeld. Als deze parameter niet is opgegeven, wordt het clienttoepassinghoofdvenster losgekoppeld.

ClearEntityList

Maakt de lijst met geaccumuleerde zoekresultaten leeg. Moet altijd worden aangeroepen voordat de actie DoSearch wordt aangeroepen.

Parameter

Beschrijving

global

True als u wilt dat de aan de globale sessie gelieerde zoekresultaten worden gewist. Pas op met het opslaan van zoekresultaten in de globale sessie, want ze worden niet automatisch gewist door het systeem. In dit geval moet u de actie ClearEntityList aanroepen voordat u de actie DoSearch aanroept.

Sluiten

Sluit het gehoste besturingselement af. Als op dit tabblad meer dan één pagina wordt weergegeven, worden, anders dan bij de actie CloseActive, alle pagina's gesloten die op het tabblad in uw agenttoepassing worden weergegeven.

CloseActive

Sluit het actieve gehoste besturingselement op het opgegeven paneel.

Parameter

Beschrijving

De eerste regel in de actieoproep moet de naam van het paneel bevatten om de actieve toepassing te vinden. Als geen parameter is opgegeven, wordt MainPanel verondersteld.

CopyToClipboard

Kopieert de URL van het artikel toe naar het Klembord of voegt het eraan toe.

Parameter

Beschrijving

-gegevens

Gegevens die u wilt kopiëren. U kunt ook vervangingsparameters gebruiken. Bijvoorbeeld: data=[[$context.title]]

append

Geeft aan of u de gegevens al dan niet aan het Klembord wilt toevoegen. Stel in op true of op false. Voorbeeld: append=false.

CopyToContext

Kopieert een waarde of een reeks waarden naar contextvariabelen. Contextvariabelen kunnen met de sessie worden geserialiseerd. Deze actie gebruikt een reeks name=value-paren. De naam is de naam van de contextvariabele.

CopyLogicalEntityToContext

Kopieert waarden van een volledige sectie van gegevensparameters naar de context.

Parameter

Beschrijving

LogicalName

Het type of de sectie gegevensparameters waaruit waarden moeten worden gekopieerd.

CloseActivity

Sluit een activiteitenrecord af in Dynamics 365.

Parameter

Beschrijving

Id

De GUID van de te sluiten activiteitsrecord.

LogicalName

De logische naam van de te sluiten activiteit.

StatusCode

De weergavenaam van de definitieve statuscode nadat de activiteit is afgesloten.

StateCode

De weergavenaam van de definitieve statuscode nadat de activiteit is afgesloten.

Bijvoorbeeld, om een telefoongesprekactiviteit te sluiten, moet u het volgende opgeven:

Id=<GUID of the phone activity record>
LogicalName=phonecall
statuscode=Received
statecode=Completed

Nadat de activiteitsrecord is gesloten, wordt de systeemvervangingsparameter $Return gevuld met een Booleaanse waarde die aangeeft of de actie succesvol was.

CreateEntity

Hiermee wordt een nieuw record in Dynamics 365 gemaakt.

Parameter

Beschrijving

LogicalName

De logische naam van de te maken entiteit

Elke volgende regel in de parameterlijst bevat een reeks Name=Value-paren die uw andere velden definiëren die moeten worden gevuld wanneer de entiteit wordt gemaakt.

Entiteitsverwijzingen kunnen als volgt worden beschreven:

Param=EntityReference(“logicalname”, “id”)

OptionSetValues kan worden opgegeven zoals de volgende:

Param=OptionSetValue(value)

Booleaanse waarden kunnen worden beschreven zoals de volgende:

Param=Boolean(value)

PartyList (met e-mail gebruikt) kan worden beschreven zoals de volgende:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

U kunt een willekeurig aantal email- en er-items gebruiken om respectievelijk e-mailadressen en entiteitsverwijzingen voor te stellen.

Andere waarden zoals tekenreekswaarden kunnen worden opgegeven zoals de volgende:

Param=value

Als de record is gemaakt, wordt de $Return-waarde gevuld met de GUID van de nieuw gemaakte record.

CreateSession

Hiermee wordt een sessie gemaakt.

DeleteEntity

Verwijdert een record in Dynamics 365.

Parameter

Beschrijving

Id

De ID van de te verwijderen waarde. Dit moet de GUID van de record zijn die u wilt verwijderen.

LogicalName

De logische naam van de te verwijderen entiteit.

DoRoute

Kan worden gebruikt om uw vensternavigatieregels te testen door een pop-upvenster te simuleren vanuit een specifiek gehost besturingselement. Dit kan in productie worden gebruikt om de vensternavigatieregels handmatig te activeren volgens de vereiste.

Parameter

Beschrijving

naam

De ID van de entiteit die het doel is van het queueItem

entiteit

De logische naam van de entiteit die in een pop-upvenster is geopend.

id

De logische naam van de entiteit die in een pop-upvenster wordt geopend.

frame

Het frame van waaruit de pop-up moet optreden.

DoSearch

Roept de Dynamics 365-webservices aan met behulp van de FetchXML die als een entiteitzoekactie is gedefinieerd in Unified Service Desk Voor meer informatie over het definiëren van een entiteitzoekacties, zie Gegevens zoeken met entiteitzoekacties in Volledige servicedesk.

Parameter

Beschrijving

name

De naam van de entiteitzoekactie die voor het zoeken van de record moet worden gebruikt.

global

True als u wilt dat de aan de globale sessie gelieerde zoekresultaten worden gewist. Pas op met het opslaan van zoekresultaten in de globale sessie, want ze worden niet automatisch gewist door het systeem. In dit geval moet u de actie ClearEntityList aanroepen voordat u deze actie aanroept.

maxcount

Het maximale aantal records dat wordt opgeslagen in de EntityList-resultaten vanuit deze oproep.

Notitie

De paginatelling (aantal records per pagina) voor een resultaatset is standaard ingesteld op 50. Dit impliceert dat als er meer dan 50 records worden geretourneerd, dit in pagina's wordt weergegeven. Als u een andere waarde voor de paginatelling voor de actie DoSearch wilt opgeven, geeft u de nieuwe waarde op bij de optie EntitySearchPageCount.Meer informatie:TechNet: Opties beheren voor Unified Service Desk

Als u de actie DoSearch aanroept, geeft de vervangingsparameter $Return het aantal als gevolg van deze zoekactie gevonden en in EntityList opgeslagen records weer.Meer informatie:$Return.

DisplayMessage

De gebruiker krijgt een berichtvenster te zien.

Parameter

Beschrijving

text

Dit is de tekst die in het berichtvenster wordt weergegeven. Als deze parameter niet is gespecificeerd, wordt eventuele resterende tekst (restparameter) of een lege tekenreeks gebruikt.

caption

Dit is het bijschrift dat in het berichtvenster wordt weergegeven. Als er geen bijschrift is opgegeven, wordt Dynamics 365-bericht gebruikt.

ExecuteOnDataAvailable

Vertraagt de uitvoering van de subacties totdat een opgegeven reeks vervangingsparameters beschikbaar komt. Er kan een time-outwaarde worden opgegeven om de wachttijd te beperken voordat de vervangingsparameters beschikbaar komen. Als geen time-out is opgegeven, wordt voor onbepaalde tijd gewacht of totdat de sessie eindigt.Meer informatie:Blog: De speciale acties, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue gebruiken

Parameter

Beschrijving

milliseconds

De tijd, in milliseconden, die de hoeveelheid tijd aangeeft dat moet worden gewacht voordat deze actie verloopt en wordt geannuleerd. De resterende parameters dienen vervangingsparameters te bevatten die moeten bestaan voordat subacties kunnen worden uitgevoerd.

Voorbeeld van gegevensparameter:

milliseconds=5000
[[account.Id]]
[[incident.Id]]

Belangrijk

Deze actie geldt voor alle typen gehoste besturingselementen. Deze actie komt niet standaard beschikbaar als u een exemplaar van een type gehost besturingselement maakt. Als u de actie ExecuteOnDataAvailable wilt gebruiken met een exemplaar van een type gehost besturingselement, moet u expliciet een UII-actie genaamd ExecuteOnDataAvailable toevoegen aan het desbetreffende exemplaar van het gehoste besturingselement.Meer informatie:Een UII-actie aan een gehost besturingselement toevoegen

ExecuteOnTimeout

Vertraagt de uitvoering van de subacties totdat een bepaalde tijd is verstreken. Een time-outwaarde is vereist om aan te geven wanneer de subacties moeten worden uitgevoerd.Meer informatie:Blog: De speciale acties, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue gebruiken

Parameter

Beschrijving

milliseconds

De tijd, in milliseconden, die de hoeveelheid tijd aangeeft dat moet worden gewacht voordat de subacties worden uitgevoerd.

Voorbeeld van gegevensparameter:

milliseconds=5000

Belangrijk

Deze actie geldt voor alle typen gehoste besturingselementen. Deze actie komt niet standaard beschikbaar als u een exemplaar van een type gehost besturingselement maakt. Als u de actie ExecuteOnTimeout wilt gebruiken met een exemplaar van een type gehost besturingselement, moet u expliciet een UII-actie genaamd ExecuteOnTimeout toevoegen aan het desbetreffende exemplaar van het gehoste besturingselement.Meer informatie:Een UII-actie aan een gehost besturingselement toevoegen

ExecuteOnExpressionTrue

Vertraagt de uitvoering van de subacties totdat een bepaalde JavaScript-expressie de waarde true retourneert. Er kan een time-outwaarde worden opgegeven om de hoeveelheid tijd te beperken dat moet worden gewacht voordat de actie verloopt. Als geen time-out is opgegeven, wordt voor onbepaalde tijd gewacht of totdat de sessie eindigt.Meer informatie:Blog: De speciale acties, ExecuteOnTimeout, ExecuteOnDataAvailable, ExecuteOnExpressionTrue gebruiken

Parameter

Beschrijving

milliseconds

De tijd, in milliseconden, die de hoeveelheid tijd aangeeft dat moet worden gewacht voordat deze actie verloopt en wordt geannuleerd. De resterende parameter is een te evalueren JavaScript-expressie. Wanneer deze expressie true is, worden de subacties uitgevoerd.

Voorbeeld van gegevensparameter:

milliseconds=5000
function IsAccountLoaded()
{
return “[[account.Id]$+]” != “”;
}
IsAccountLoaded();

Belangrijk

Deze actie geldt voor alle typen gehoste besturingselementen. Deze actie komt niet standaard beschikbaar als u een exemplaar van een type gehost besturingselement maakt. Als u de actie ExecuteOnExpressionTrue wilt gebruiken met een exemplaar van een type gehost besturingselement, moet u expliciet een UII-actie genaamd ExecuteOnExpressionTrue toevoegen aan het desbetreffende exemplaar van het gehoste besturingselement.Meer informatie:Een UII-actie aan een gehost besturingselement toevoegen

ExecuteScriptlet

Hiermee wordt de opgegeven scriptlet uitgevoerd.

Parameter

Beschrijving

Geef de naam van de uit te voeren scriptlet op in het veld Gegevens.

FireEvent

Activeert een door de gebruiker gedefinieerde gebeurtenis vanuit dit gehoste besturingselement.

Parameter

Beschrijving

naam

Naam van de door de gebruiker gedefinieerde gebeurtenis.

Alle volgende name=value-paren worden de parameters van de gebeurtenis. Voor meer informatie over het maken van een door de gebruiker gedefinieerde gebeurtenis raadpleegt u Een door de gebruiker gedefinieerde gebeurtenis maken.

GetTemplate

Hiermee wordt de inhoud van een samengevoegde e-mailsjabloon opgehaald.

Parameter

Beschrijving

naam

Naam van de op te halen sjabloon.

id

De id van de entiteit die aan deze sjabloon moet worden gekoppeld voor de samenvoeging.

InvokeCTI

Simuleert CTI-gebeurtenissen

Parameter

Beschrijving

type

Dit is het type CTI-gebeurtenis zoals een telefoongesprek of een chat.

appname

De naam van de bureaubladbeheerder die moet worden gebruikt voor deze pop-upsimulatie.

ani

De automatische nummeridentificatie (ANI) of het telefoonnummer van de beller.

dnis

De DNIS of het gekozen nummer.

Alle overige parameters worden als parameters doorgegeven aan de CTI-gebeurtenisprocessor.

LaunchURL

Start een URL in Internet Explorer buiten de toepassing Unified Service Desk. U moet de URL als parameter in het veld Gegevens opgeven.

LookupQueueItem

Zoekt een queueitem in het systeem haalt de informatie op.

Parameter

Beschrijving

Id

De ID van de entiteit die het doel is van het queueItem

EntityType

Het type of de logische naam van de entiteit waarnaar in het Id-veld wordt verwezen.

De uiteindelijke queueitem-gegevens worden in de vervangingsparameter queueitem geplaatst en er kan later naar worden verwezen.

MoveApplicationToPanel

Hiermee wordt een gehost besturingselement naar het opgegeven paneel in de clienttoepassing verplaatst.

Parameter

Beschrijving

-app

Naam van het te verplaatsen gehoste besturingselement.

panel

Naam van het doelpaneel.

MoveToPanel

Verplaatst de gehoste besturingselementen van het ene naar het andere paneel in runtime.

Parameter

Beschrijving

-app

Naam van het te verplaatsen gehoste besturingselement.

panel

Doelpaneel voor het gehoste besturingselement.

New_CRM_Page

Maakt een pagina voor het maken van een nieuwe Dynamics 365-record van de opgegeven entiteit en behandelt de pagina als een pop-up vanuit het opgegeven gehoste besturingselement. De vensternavigatieregels worden geëvalueerd om de locatie te bepalen waar de pagina voor het maken van de entiteitrecord wordt weergegeven.

Parameter

Beschrijving

LogicalName

De logische naam van de entiteit voor het maken van een nieuw exemplaar.

Notitie

De rest van de parameters moet uit name=value-paren bestaan. Dit zijn de extra vooraf gevulde waarden in het formulier voor het maken van een nieuwe record voor de opgegeven entiteit. Zie voor meer informatie over het gebruik van deze actie stap 4 in Analyse 7: Agentscripts configureren in uw agenttoepassing.

Open_CRM_Page

Opent een bestaande entiteit van het opgegeven type en geïdentificeerd door de id, en behandelt de pagina als een pop-up vanuit het opgegeven gehoste besturingselement. De vensternavigatieregels worden geëvalueerd om de locatie te bepalen waar de pop-up moet worden weergegeven.

Parameter

Beschrijving

LogicalName

De logische naam van de te openen entiteit.

id

De id van de te openen entiteitrecord.

Onderbreken

Hiermee wordt de uitvoering van de actie onderbroken zonder berichtverwerking te blokkeren. Deze actie is anders dan het onderbreken van de huidige thread voor de aangegeven periode (Thread.Sleep) omdat de actie de verwerking toestaat om door te gaan. Deze actie is handig wanneer u wacht tot er webbewerkingen zijn voltooid.

Parameter

Beschrijving

milliseconds

Het aantal te pauzeren milliseconden.

Pop-up

Geeft een URL weer vanuit het gehoste besturingselement en voert er de vensternavigatieregels op uit om de pop-up naar de juiste locatie te routeren.

Parameter

Beschrijving

url

Routeert een pop-up vanuit dit besturingselement met deze URL alsof het een pop-up is die vanuit het weergegeven besturingselement is aangevraagd.

frame

Het frame waaruit deze pop-up voortkomt.

RealignWindow

Geeft het gehoste besturingselement weer op de opgegeven locatie op een monitor. U kunt het gehoste besturingselement op maximaal twee monitoren weergeven. Deze actie is toepasbaar op exemplaren van gehoste besturingselementen die zijn geconfigureerd om te worden geplaatst op een paneel van het type USDFloatingPanel of USDFloatingToolPanel.

Parameter

Beschrijving

screen

Geeft het scherm op waarop het gehoste besturingselement moet worden weergegeven. Geldige waarden zijn 1 en 2. Als u deze parameter niet opgeeft, wordt standaard 1 doorgegeven.

left

Geeft in een percentage vanaf de linkerzijde van het scherm de positie op de doelmonitor op waar het gehoste besturingselement moet worden weergegeven. Geldige waarden lopen van 0 tot 100. Als u deze parameter niet opgeeft, wordt standaard 0 doorgegeven.

top

Geeft in een percentage vanaf de bovenzijde van het scherm de positie op de doelmonitor op waar het gehoste besturingselement moet worden weergegeven. Geldige waarden lopen van 0 tot 100. Als u deze parameter niet opgeeft, wordt standaard 0 doorgegeven.

width

Geeft in een percentage de breedte van het venster van het gehoste besturingselement op de doelmonitor op. Geldige waarden lopen van 1 tot 100. Als u deze parameter niet opgeeft, wordt standaard 100 doorgegeven.

height

Geeft in een percentage de hoogte van het venster van het gehoste besturingselement op de doelmonitor op. Geldige waarden lopen van 1 tot 100. Als u deze parameter niet opgeeft, wordt standaard 100 doorgegeven.

ReadSettings

Hiermee worden de eerder opgeslagen instellingen uit de $Settings-vervangingsparameter gelezen.

Parameter

Beschrijving

readfromcache

True als u de lokale cacheversie van deze instellingen wilt lezen. Anders False of ontbrekend.

RedoScreenPop

Zorgt dat laatste scherm opnieuw als pop-up wordt weergegeven. Dit kan handig zijn in gevallen waarin de sessielimiet mogelijk is bereikt en de pop-up niet is geslaagd, of als u de sessie hebt gesloten maar er meer werk vereist is. Deze actie vereist geen parameters.

ResetLocalCache

Hiermee wordt de configuratiecache ingesteld op Unified Service Desk De volgende keer dat Unified Service Desk wordt gestart, wordt de configuratie van de server gedownload. De gebruiker moet schrijftoegang tot de entiteit msdyusd_usersettings hebben anders werkt deze actie niet.

RouteToQueue

Hiermee wordt een entiteit naar een wachtrij in Dynamics 365 gerouteerd.

Parameter

Beschrijving

destination

De ID van de doelwachtrij. Dit sluit de parameter destinationqueuename wederzijds uit

destinationqueuename

Dit is de naam van de wachtrij waarnaar de entiteit moet worden gerouteerd.

entitytype

Dit is de logische naam van de entiteit die moet worden gerouteerd.

entityid

Dit is GUID/Id van de entiteit die in de wachtrij moet worden geplaatst.

SaveAll

Slaat alle formulieren op in een gehost besturingselement dat toestaat dat er meerdere pagina's worden weergegeven (Meerdere pagina's toestaan = Ja). Als het gehoste besturingselement slechts toestaat dat één pagina wordt weergegeven (Meerdere pagina's toestaan = Nee), is dit vergelijkbaar met de actie Opslaan.

SaveSetting

Slaat een gebruikersspecifieke instelling op.

Parameter

Beschrijving

naam

De naam van de instelling. Dit wordt in de$Settings vervangingsparameter weergegeven.

waarde

De waarde van de instelling die moet worden opgeslagen.

SetTheme

Past een thema toe om de indeling of de weergave te wijzigen van onderdelen van de gebruikersinterface.Meer informatie:Het uiterlijk van uw toepassing aanpassen

Parameter

Beschrijving

clear

True als u het huidige thema volledig wilt wissen voordat het opgegeven thema wordt toegepast. Als deze parameter false is of niet is opgegeven, wordt de nieuwe thema-informatie samengevoegd met het huidige thema.

De restparameter (wat over is nadat de overige parameters zijn verwijderd), moet de naam van het te gebruiken thema bevatten. Dit moet de webresourcenaam van een XAML-bestand (hernoemd tot XML en geüpload als een webresource), een URL op een anonieme toegangsserver of de ruwe XAML zijn die het thema vertegenwoordigt.

SetAppBar

Hiermee wordt een gehost besturingselement aan de opgegeven rand van het clienttoepassinghoofdvenster gekoppeld.

Parameter

Beschrijving

ApplicationName

De naam van het gehoste besturingselement dat moet worden gekoppeld. Als deze parameter wordt opgegeven, wordt het bovenliggende venster dat dit gehoste besturingselement host, gekoppeld.

width

De breedte in pixels van het gekoppelde venster. Als dit niet is opgegeven, wordt de huidige breedte van het venster gebruikt.

height

De hoogte in pixels van het gekoppelde venster. Als dit niet is opgegeven, wordt de huidige hoogte van het venster gebruikt.

Edge

De rand waaraan moet worden gekoppeld. Als niets is opgegeven, wordt uitgegaan van Boven. Geef een van de volgende waarden op: Boven, Onder, Links of Rechts.

SetEventTimer

Hiermee wordt een gebeurtenistimer ingesteld voor automatisch starten.

Parameter

Beschrijving

naam

Naam van de gebeurtenistimer.

SetSize

Stelt de breedte en de hoogte van het gehoste besturingselement in. Dit is vooral handig bij het gebruik van "auto" in uw paneelindelingen.

Parameter

Beschrijving

width

De breedte van het gehoste besturingselement.

height

De hoogte van het gehoste besturingselement.

SetWindowProperty

HIermee wordt de vensterstatus voor het clienttoepassinghoofdvenster ingesteld.

Parameter

Beschrijving

WindowState

Een van de volgende waarden: gemaximaliseerd, geminimaliseerd of normaal.

ShellExecute

Deze actie is bedoeld om een URL of opdrachtregel te starten. Opmerking: De gebruiker moet bevoegdheid hebben om de toepassing uit te voeren.

Parameter

Beschrijving

De enige parameter is de opdrachtregel of de URL van de uit te voeren toepassing.

ShowAbout

Hiermee wordt informatiedialoogvenster voor Unified Service Desk weergegeven, dat allerlei informatie bevat, zoals de naam van de huidige gebruiker, de Dynamics 365-server en -organisatie waarmee de gebruiker is verbonden, het versienummer van de Unified Service Desk-clienttoepassing en de URL van de ondersteuningssite.

ShowTab

Stelt de focus in op een tabblad (gehost besturingselement) in uw agenttoepassing.

Parameter

Beschrijving

De eerste regel in de actieoproep moet de naam bevatten van het gehoste besturingselement dat op de voorgrond moet worden weergegeven. Gebruik niet de weergavenaam van het gehoste besturingselement. Zie voor meer informatie over het gebruik van deze actieoproep stap 4 van Analyse 2: Een externe webpagina weergeven in uw agenttoepassing.

StopEventTimer

Hiermee wordt een gebeurtenistimer gestopt.

Parameter

Beschrijving

naam

Naam van de gebeurtenistimer die moet worden gestopt.

Translate

Hiermee kunt u tekst vertalen met Microsoft Translator.

Parameter

Beschrijving

waarde

Dit is de te vertalen tekst. Deze waarde kan escaped zijn voor ondersteuning van meerdere regels.

Enkele geldige voorbeelden:

value=$Escaped("my string<br>new line\\\"my text\\\"")
value=[[myapp.myparam]^]
value=$Escaped([[myapp.myparam]$])

Voor meer informatie over deze vervangingscodes raadpleegt u Vervangingsparameters gebruiken om Volledige servicedesk te configureren.

fromlanguage

Naam van de taal waaruit moet worden vertaald. Als dit leeg is, zal het systeem proberen de taal van de opgegeven waarde te detecteren alvorens te vertalen. Voor een lijst met geldige taalwaarden raadpleegt u Translator-taalcodes

tolanguage

Naam van de taal waarin moet worden vertaald. Voor een lijst met geldige taalwaarden raadpleegt u Translator-taalcodes

clientId

Een client-id die van Microsoft Azure is verkregen voor vertaalservices. Voor informatie over het registreren met Azure raadpleegt u https://datamarket.azure.com.

clientsecret

Een clientgeheim dat van Microsoft Azure is verkregen voor vertaalservices. Voor informatie over het registreren met Azure raadpleegt u https://datamarket.azure.com.

De vertaalde waarde wordt weergegeven onder de vervangingsparameter $Return.

UpdateEntity

Hiermee wordt een record in Dynamics 365 bijgewerkt.

Parameter

Beschrijving

Id

De ID van de bij te werken waarde. Dit moet de GUID van de record zijn die u wilt bijwerken.

LogicalName

De logische naam van de bij te werken entiteit

Elke volgende regel in de parameterlijst bevat een reeks Name=Value-paren die uw andere velden definiëren die moeten worden gevuld wanneer de entiteit wordt bijgewerkt.

Entiteitsverwijzingen kunnen als volgt worden beschreven:

Param=EntityReference(“logicalname”, “id”)

OptionSetValues kunnen worden opgegeven zoals de volgende:

Param=OptionSetValue(value)

Booleaanse waarden kunnen worden beschreven zoals de volgende:

Param=Boolean(value)

PartyList (met e-mail gebruikt) kan worden beschreven zoals de volgende:

Param=PartyList(email[“test@test.com”], er[“contact”, guid])

U kunt een willekeurig aantal e-mail- en ER-items gebruiken om respectievelijk e-mailadressen en entiteitsverwijzingen voor te stellen.

Andere waarden zoals tekenreekswaarden kunnen worden opgegeven zoals de volgende:

Param=value

Toewijzen

Deze actie is vergelijkbaar met het selecteren van een wachtrij-item in een wachtrij en het klikken op de knop WorkOn op het lint. Het wachtrij-item wordt gemarkeerd als zijnde in behandeling door een specifieke agent.

Parameter

Beschrijving

Id

Dit is de ID van het queueitem. Zie LookupQueueItem voor informatie over hoe u de ID voor een specifieke entiteit verkrijgt.

Actie

Optionele parameter waarmee de beheerder kan opgeven dat hij of zij het kenmerk WorkOn wil verwijderen om het weer in de wachtrij te plaatsen.

Geldige waarden:

Verwijderen - verwijdert het WorkOn-kenmerk en retourneert het item naar de wachtrij zodat anderen eraan kunnen werken.

Vooraf gedefinieerde gebeurtenissen

Hier vindt u de vooraf gedefinieerde gebeurtenissen die zijn gekoppeld aan dit gehoste besturingselement.

DesktopReady

Treedt bij opstarten op wanneer alle bureaubladinitialisering is voltooid en de verbindingen met Dynamics 365 tot stand zijn gebracht. Deze gebeurtenis treedt slechts één keer op en wordt vaak gebruikt om thema's in te stellen en andere opstartacties uit te voeren.

SessionActivated

Treedt op wanneer een sessie wordt geactiveerd.

Parameter

Beschrijving

SessionId

Id van de huidige actieve sessie.

IsGlobal

Geeft aan of deze gebeurtenis van toepassing is op de algemene sessie. Retourneert True of False.

Activeren

Dit is ingesteld op Waar.

SessionClosed

Treedt op wanneer een sessie wordt gesloten.

Parameter

Beschrijving

SessionId

Id van de sessie die is gesloten.

IsGlobal

Geeft aan of deze gebeurtenis van toepassing is op de algemene sessie. Retourneert True of False.

SessionDeactivated

Treedt op wanneer een sessie wordt gedeactiveerd.

Parameter

Beschrijving

SessionId

Id van de niet-actieve sessie.

IsGlobal

Geeft aan of deze gebeurtenis van toepassing is op de algemene sessie. Retourneert True of False.

Activeren

Dit is ingesteld op Onwaar.

SessionNew

Treedt op wanneer een nieuwe sessie wordt gemaakt.

Parameter

Beschrijving

SessionId

Id van de zojuist gemaakte sessie.

IsGlobal

Retourneert Waar als de nieuwe sessie een algemene sessie is. Retourneert anders Onwaar.

Zie ook

UII-acties
Gebeurtenissen
Vooraf gedefinieerde acties en gebeurtenissen voor een gehost besturingselement weergeven
Ingesloten help weergeven voor acties en evenementen
Configuratieanalyses van Unified Service Desk importeren
Typen gehoste besturingselementen en actie/gebeurtenisnaslag
TechNet: Beheerhandleiding voor Unified Service Desk for Microsoft Dynamics CRM

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht