Overzicht: De algemene listener-adapter gebruiken voor CTI-gebeurtenisroutering

Gepubliceerd: november 2016

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

Dit overzicht toont hoe u de CTI-bureaubladmanager en de algemene listener in Unified Service Desk gebruikt om de CTI-gebeurtenissen beschikbaar te maken als schermpops in Unified Service Desk. Voor dit overzicht gebruiken we een voorbeeldtoepassing met een CTI-simulator die CTI-aanvragen verzendt naar Unified Service Desk.

In dit overzicht doet u het volgende:

• Zoek een contactpersoonrecord in de Microsoft Dynamics 365-voorbeeldgegevens op basis van een e-mailadres dat is opgegeven in de voorbeeldtoepassing CTI Call Tester.

• Maak een vensternavigatieregel om de overeenkomende record weer te geven in een sessie in Unified Service Desk.

In dit onderwerp

Vereisten

Stap 1: Een gehost besturingselement van het type CTI-bureaubladbeheerder configureren in Unified Service Desk.

Stap 2: Testen of de CTI-gebeurtenissen worden geactiveerd in Unified Service Desk

Stap 3: Een vensternavigatieregel definiëren om de CTILookUpRequest te routeren

Uw CTI-adapter testen

Vereisten

• Microsoft .NET Framework 4.5.2

• Unified Service Desk-clienttoepassing, vereist om het gehoste besturingselement te testen.

• Microsoft Visual Studio 2012 of Visual Studio 2013

• Download het Visual Studio-voorbeeldproject met de CTI-simulator naar uw computer. Maak het project en voer de toepassing (.exe-bestand) uit vanuit de map bin\debug van het voorbeeldtoepassingproject. U moet de USD CTI Simulator-toepassing op dezelfde computer uitvoeren als waarop de Unified Service Desk-client wordt uitgevoerd om de toepassing te testen.

Stap 1: Een gehost besturingselement van het type CTI-bureaubladbeheerder configureren in Unified Service Desk.

1. Aanmelden bij Microsoft Dynamics 365.

2. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk.

3. Kies op de pagina Unified Service DeskGehoste besturingselementen.

4. Kies op de pagina Gehoste besturingselementenNieuw.

5. Geef op de pagina Nieuw gehost besturingselement de volgende waarden op.

   Veld	Waarde
   Naam	CTITest
   Onderdeeltype van Volledige servicedesk	CTI Desktop Manager
   Weergavegroep	HiddenPanel
   Assemblage-URI	Microsoft.Crm.UnifiedServiceDesk.GenericListener
   Assemblagetype	Microsoft.Crm.UnifiedServiceDesk.GenericListener.DesktopManager

   Notitie

   De waarden die worden opgegeven in de velden Assemblage-URI en Assemblagetype zijn de algemene listenerwaarden voor het gehoste besturingselement van het type CTI-bureaubladbeheerder.

   

6. Klik op Opslaan om het gehoste besturingselement te maken.

Stap 2: Testen of de CTI-gebeurtenissen worden geactiveerd in Unified Service Desk

1. Start de Unified Service Desk-client en maak verbinding met uw Dynamics 365-exemplaar. Wanneer de client actief is, kiest u Instellingen in de rechterbovenhoek om het foutopsporingsbesturingselement weer te geven en kiest u vervolgens Uitvoer van foutopsporing wissen om het bureaublad leeg te maken.

   

2. Start de USD CTI Simulator-toepassing, typ E-mail in de kolom Sleutel en geef een willekeurige waarde op in de kolom Waarde. Klik op Verzenden naar USD.

   

3. Een schermpop-up wordt in de clienttoepassing weergegeven voor de CTI-gebeurtenis. In dit geval wordt CTILookUpRequest gestart met de waarde die is opgegeven in de USD CTI Simulator-toepassing. Omdat u dit verder niet hebt voorzien van een vensternavigatieregel, gebeurt er verder niets.

   

Stap 3: Een vensternavigatieregel definiëren om de CTILookUpRequest te routeren

Maak een vensternavigatieregel om een sessie te maken als een overeenkomst wordt gevonden, en geef vervolgens de overeenkomende contactpersoonrecord weer in een sessie in Unified Service Desk

1. Aanmelden bij Microsoft Dynamics 365.

2. Navigeer naar de geavanceerde zoekmogelijkheden voor contactpersonen en maak een query voor actieve contactpersonen waarbij de velden voor e-mail, e-mailadres 2 of e-mailadres 3 een bepaalde waarde bevatten, bijvoorbeeld someone_c@example.com.

   

3. Klik op FetchXML downloaden om de query op te slaan als FetchXML.

4. Kies op de navigatiebalk Microsoft Dynamics 365 > Instellingen > Unified Service Desk > Vensternavigatieregels.

5. Klik op Nieuw en geef in het venster Nieuwe vensternavigatieregel de volgende waarden op.

   Veld	Waarde
   Naam	CTITestRoute
   Order	50
   Van	CTITest Notitie Dit is de naam van uw gehost besturingselement van het type CTI-bureaubladbeheerder.
   Richting	Beide

   

6. Sla de regel op. Hierdoor worden de overige besturingselementen op de pagina geactiveerd.

7. Voeg nu de FetchXML-query toe die eerder voor deze regel is opgeslagen. Kies onder het gebied CTI-zoekopdrachten Toevoegen .

8. Geef in het venster Nieuwe CTI-zoekactie de volgende waarden op.

   Veld	Waarde
   Naam	CTIContactSearch
   Order	1
   FetchXML	<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="contact"> <attribute name="fullname" /> <attribute name="parentcustomerid" /> <attribute name="telephone1" /> <attribute name="emailaddress1" /> <attribute name="contactid" /> <order attribute="fullname" descending="false" /> <filter type="and"> <condition attribute="statecode" operator="eq" value="0" /> <filter type="or"> <condition attribute="emailaddress1" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress2" operator="eq" value="[[cti.Email]]" /> <condition attribute="emailaddress3" operator="eq" value="[[cti.Email]]" /> </filter> </filter> </entity> </fetch> Notitie Het adres someone_c@example.com is vervangen door [[cti.Email]] zodat de zoekactie wordt uitgevoerd op basis van de waarde die is opgegeven voor de E-mail-sleutel in de Unified Service Desk CTI Simulator-toepassing.

   

9. Sla de CTI-zoekactieregel op en ga terug naar de regel van de vensternavigatie.

10. Selecteer onder Enkele overeenkomst in het veld BeslissingSessie maken, Overeenkomst laden en daarna Actie uitvoeren.

11. Onder Enkele overeenkomst, in het veld Actie klikt u op het zoekpictogram om een waarde te selecteren, en klikt u vervolgens op Nieuw.

12. Voor de pagina Nieuwe Actieoproep maakt u een actieoproep waarmee een contactpersoonrecord wordt geopend, door de volgende waarden op te geven.

    Veld	Waarde
    Naam	CTIOpenContact
    Gehost besturingselement	Dynamics 365 Algemene beheerder
    Actie	Open_CRM_Page
    Gegevens	Id=[[$Context.Id]]LogicalName=[[$Context.LogicalName]]

    

13. Sla de actieoproep op en sluit vervolgens de pagina met de actieoproep om terug te gaan naar de pagina met de definities voor navigatieregels voor het venster.

14. Onder het gebied Resultaat:

    1. Kies in het veld DoelTabblad om de juiste contactpersoonrecord in een tabblad weer te geven.

    2. In het veld Doeltabblad kiest u het gehoste besturingselement Contactpersoon. Het gehoste besturingselement Contactpersoon is gemaakt toen u een voorbeeldtoepassing van Unified Service Desk implementeerde op uw Dynamics 365-server met behulp van Hulpmiddel Pakketimplementatie. Voor meer informatie, zie TechNet: Voorbeeldtoepassingen van Unified Service Desk op CRM-server implementeren met behulp van Package Deployer.

    3. In het veld Tabblad tonen kiest u het gehoste besturingselement Contactpersoon.

    

15. Sla de vensternavigatieregel op.

Uw CTI-adapter testen

1. Start de Unified Service Desk-client en maak verbinding met uw Dynamics 365-exemplaar. Wanneer de client actief is, kiest u Instellingen in de rechterbovenhoek om het foutopsporingsbesturingselement weer te geven en kiest u vervolgens Uitvoer van foutopsporing wissen om het bureaublad leeg te maken.

   

2. Start de USD CTI Simulator-toepassing, type E-mail in de kolom Sleutel en geef een geldige e-mail-id op voor de contactpersoon die u wilt zoeken. Typ in dit geval someone_d@example.com in de kolom Waarde. Klik op Verzenden naar USD.

   

3. De overeenkomende contactpersoonrecord wordt weergegeven in een sessie in Unified Service Desk.

   

4. Controleer het gehoste besturingselement van het type Debugger om de gebeurtenissen weer te geven die zijn geactiveerd als resultaat van de CTI-zoekopdracht. Controleer ook het tabblad Gegevensparameters om de contextinformatie weer te geven in de variabele $Context en de CTI-informatie in de variabele CTI.

Zie ook

Integreren met CTI-systemen met behulp van CTI-adapters
UII CTI (Computer Telephony Integration) framework

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht