Integreren met Citrix-toepassingen

 

Gepubliceerd: november 2016

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

Integreer uw Citrix-toepassingen met Unified Service Desk door deze te hosten in Unified Service Desk. Hierdoor kunnen klantenservicemedewerkers interacties aangaan met de Citrix-toepassingen vanuit de client van Unified Service Desk, terwijl zij aan de klantgegevens werken in Microsoft Dynamics 365. U kunt een Windows-toepassing configureren als virtuele toepassing op Citrix XenApp 7.6, die als gehoste toepassing wordt uitgevoerd in Unified Service Desk. Meer informatie: TechNet: Softwarevereisten voor toepassingsvirtualisatie met Citrix XenApp

De Citrix-toepassing die wordt gehost in de client van Unified Service Desk gebruikt het ICA-protocol (Independent Computing Architecture) om op afstand te communiceren met de toepassing op een Citrix-server. Een ICA-bestand van Citrix bevat informatie om verbinding te maken met de externe server, zoals het serveradres, de sessie-eigenschappen en verificatiegegevens.

Voor meer informatie over het integreren van Unified Service Desk met Citrix, raadpleegt u Blog: Citrix en Unified Service Desk

Dit onderwerp biedt informatie over het configureren van server- en clientonderdelen voor het integreren van Unified Service Desk met Citrix, voorbeelden van Citrix-adapters en een aantal aanbevolen procedures.

In dit onderwerp

Serveronderdeel configureren voor Citrix-integratie

Clientonderdeel configureren voor Citrix-integratie

Citrix-integratie: hoe werkt deze?

Voorbeelden van Citrix-adapters

Citrix-integratie: Aanbevolen procedures

Serveronderdeel configureren voor Citrix-integratie

Het serveronderdeel wordt uitgevoerd als een uitvoerbaar bestand (Microsoft.Uii.Csr.CitrixIntegration.exe) dat als startprogramma is geconfigureerd om automatisch te starten wanneer een Citrix-toepassing wordt gestart. Het uitvoerbare bestand bepaalt snel zelf of de Citrix-toepassing niet is aangeroepen vanaf een Unified Service Desk-client. Het serveronderdeel moet worden geconfigureerd op elke Citrix-server.

  1. Download het User Interface Integration (UII) SDK-pakket.

  2. Dubbelklik op het pakketbestand om de inhoud uit te pakken.

  3. Navigeer naar de map <ExtractedFolder>\UII\Bin\UII\Citrix Server Component en kopieer vervolgens alle bestanden onder deze map naar een map (bijv. ServerSideComponent) op uw Citrix-server.

  4. Bewerk in de map ServerSideComponent op uw Citrix-server het bestand RegPatch Install StartupPrograms on Citrix Server.reg met Kladblok om de waarde van de parameter "StartupPrograms" in te stellen op het volledige bestandspad van het uitvoerbare bestand Microsoft.Uii.Csr.CitrixIntegration.exe.

  5. Pas de registerpatch toe op uw Citrix-server door het bestand RegPatch Install StartupPrograms on Citrix Server.reg uit te voeren. Deze registerpatch wijst een uitvoerbaar bestand aan als startprogramma dat samen met een Citrix-toepassing wordt gestart.

Clientonderdeel configureren voor Citrix-integratie

De clientconfiguratie voor Citrix-integratie omvat twee dingen:

  • Configureer een exemplaar van een gehoste UII-toepassing (Remote Hosted Application) in uw exemplaar van Dynamics 365 dat rechtstreeks zonder aangepaste code kan worden gebruikt of dat zo nodig ook kan worden uitgebreid. Acties die worden uitgevoerd op de exemplaren van de gehoste UII-toepassing worden naar het serveronderdeel overgebracht via een ICA-bestand, dat vervolgens wordt doorgestuurd naar eventueel geconfigureerde toepassingsadapters. Voor meer informatie over de gehoste UII-toepassingen raadpleegt u Gehoste UII-toepassingen

  • Kopieer het uitvoerbare bestand van de Citrix-toepassing en andere vereiste assembly's in de installatiedirectory van de Unified Service Desk-client, pas registerpatches op de client toe en voeg Citrix-specifieke instellingen toe in het configuratiebestand van de Unified Service Desk-clientapp. Deze stap hoeft op elke computer worden uitgevoerd waarop de Unified Service Desk - clienttoepassing is geïnstalleerd.

Een externe gehoste toepassing configureren

  1. Aanmelden bij Microsoft Dynamics 365.

  2. Ga naar Instellingen > Unified Service Desk.

  3. Klik op Gehoste besturingselementen en klik vervolgens op Nieuw.

  4. Geef op de pagina Nieuw gehost besturingselement in het gebied Algemeen een naam, sorteervolgorde en weergavenaam voor de gehoste toepassing op. Elke gehoste toepassing moet een unieke naam hebben. De sorteervolgorde geeft de volgorde aan waarin de gehoste toepassingen worden opgehaald en weergegeven in Unified Service Desk

  5. Selecteer in het gebied Unified Service Desk de optie CCA-gehoste toepassing in de lijst Onderdeeltype van Unified Service Desk.

  6. Selecteer in het gebied Type gehoste toepassing de optie Extern gehoste toepassing in de lijst Gehoste toepassing.

  7. In de sectie Adapterconfiguratie kunt u kiezen uit drie adapterconfiguraties in de vervolgkeuzelijst Adapter:

    1. Geen adapter gebruiken: hiermee geeft u op dat de gehoste toepassing geen automatisering vereist.

    2. Geautomatiseerde adapter (HAT) gebruiken: hiermee geeft u de standaardconfiguratie op die wordt gebruikt voor de Hosted Application Toolkit (HAT) Software Factory. Als de gehoste toepassing een Automation Adapter (HAT) gebruikt, geeft u de bindingsgegevens voor de gehoste toepassing op in het veld Automatisering-XML in het gebied Automatisering. Raadpleeg UII-inspector gebruiken om bindingen te maken voor de gehoste toepassing voor meer informatie over bindingen.

    3. Adapter gebruiken: hiermee geeft u op dat de gehoste toepassing een aangepaste adapter gebruikt.

    Voor informatie over het gebruiken van adapters voor Citrix-integratie, raadpleegt u Voorbeelden van Citrix-adapters

  8. Geef in het gebied Instellingen van Citrix-toepassing de volgende waarden op:

    • ICA-bestandsnaam: hiermee geeft u het volledige pad naar het ICA-bestand op dat is vereist voor het starten van de Citrix-toepassing. Een ICA-bestand bevat informatie om verbinding te maken met de externe server, zoals het serveradres, de sessie-eigenschappen en verificatiegegevens.

    • Ophaalpogingen verwerken: hiermee geeft u het aantal keren op dat het uitvoerbare bestand op de server de procestabel moet doorlopen om te zoeken naar het proces waarmee de gestarte Citrix-toepassing wordt uitgevoerd. Het kan enige tijd duren voordat het proces van de Citrix-toepassing in de procestabel wordt weergegeven.

    • Vertraging van ophalen verwerken: hiermee geeft u de vertraging in milliseconden op tussen elke poging om de procestabel te doorlopen.

    • Bestandsnaam ophalen verwerken: hiermee geeft u het volledige pad op naar de bestandsnaam van de Citrix-toepassing. Deze waarde wordt gebruikt door het uitvoerbare bestand op de server voor vergelijking met de bestandsnaam van de uitgevoerde processen om een overeenkomstige naam te vinden.

  9. Sla het gehoste besturingselement op.

Uitvoerbaar bestand kopiëren, registerpatch toepassen en configuratie-instellingen voor Citrix toevoegen

Deze stap hoeft op elke computer worden uitgevoerd waarop de Unified Service Desk-clienttoepassing is geïnstalleerd.

  1. Navigeer naar de map <ExtractedFolder>\UII\Bin\UII\Citrix Server Component, waarbij <ExtractedFolder> de locatie is waar u het gedownloade bestand van het UII SDK-pakket eerder hebt uitgepakt in de sectie Serveronderdeel configureren voor Citrix-integratie.

  2. Kopieer de volgende bestanden vanuit de map <ExtractedFolder>\UII\Bin\UII\Citrix Server Component naar de Unified Service Desk-clientmap (meestal C:\Program Files\Microsoft Dynamics CRM USD\USD):

    • Microsoft.Uii.Csr.CitrixIntegration.exe

    • AxWFICALib.dll

    • WFICALib.dll

  3. Pas de registerpatch toe op uw Unified Service Desk-clientcomputer om het gebruik van aangepaste virtuele kanalen in te schakelen door de volgende bestanden uit te voeren die beschikbaar zijn in de map <ExtractedFolder>\UII\Bin\UII\Citrix Server Component:

    • Voor x86-client: RegPatch Allow Custom Virtual Channels in ICAClient.reg

    • Voor x64-client: RegPatch Allow Custom Virtual Channels in ICAClient x64 Client.reg

    Notitie

    Als deze registerpatch niet wordt toegepast, is geen communicatie mogelijk tussen client en server.

  4. Voeg de volgende appinstellingen toe in het bestand UnifiedServiceDesk.exe.config dat beschikbaar is in de installatiedirectory van de Unified Service Desk-client. Deze appinstellingen moeten worden toegevoegd onder het knooppunt <configuration> van de hoofdmap:

    <appSettings>
    <add key="CitrixIntegration.VirtualChannelNamePrefix" value="CTXUII"/>
    <add key="CitrixIntegration.XmitFragmentSize" value="200"/>
    <add key="CitrixIntegration.RecvTimeoutInMilliseconds" value="2000"/>
    <add key="CitrixIntegration.HeartbeatMaxWaitInMilliseconds" value="60000"/>
    <add key="CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds" value="15000"/>
</appSettings>

    Notitie

    Deze appinstellingen zijn ook beschikbaar in het serveronderdeel in het bestand Microsoft.Uii.Csr.CitrixIntegration.exe.config.

    Hier volgt een beschrijving van elke sleutel:

    Sleutel

    Beschrijving

    CitrixIntegration.VirtualChannelNamePrefix

    Voor elke gelanceerde Citrix-toepassing, worden twee verschillend genoemde virtuele kanalen gemaakt die een gemeenschappelijke prefix delen. Door deze instelling kan het prefix worden aangepast, hoewel dat gewoonlijk niet nodig is. Deze instelling moet identiek zijn op zowel de client als de server.

    CitrixIntegration.XmitFragmentSize

    De hier opgegeven limiet wordt gehanteerd bij het fragmenteren van de virtuele kanaaltransmissies. Aan de sleutel wordt intern een maximum toegewezen voor het geval interne limieten worden overschreden (traceerberichten dienen aan te geven als dit gebeurt). Deze instelling kan verschillen voor client en server.

    CitrixIntegration.RecvTimeoutInMilliseconds

    Net als bij alle netwerkcommunicatie zijn time-outs nodig om te helpen beslissen wanneer de communicatiepeer niet beschikbaar is. Citrix-integratiecommunicatie is aanvraag/responsgeoriënteerd en met deze instelling wordt opgegeven hoe lang het duurt voordat de respons wordt geretourneerd voordat het systeem stopt met wachten op de respons. Deze instelling kan verschillen voor client en server.

    CitrixIntegration.HeartbeatMaxWaitInMilliseconds

    Eventuele communicatieactiviteit voor virtuele kanalen wordt als "heartbeat" beschouwd. Deze instelling geeft de maximale hoeveelheid tijd aan die kan verstrijken zonder tussenliggende communicatie, waarna een van beide kanten van de communicatiekanalen (server of client) besluit dat de peer aan de overkant niet langer beschikbaar is. Voor het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe), wordt de communicatie beëindigd na het trekken van deze conclusie. Voor het exemplaar van het gehoste besturingselement op de client wordt de pingtimer voor de interne heartbeat beëindigd. Deze instelling kan verschillen voor client en server.

    CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds

    Specificeert de periode van een timer die PING-berichten verzendt naar het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe), dat op zijn beurt antwoordt met overeenkomstige PONG-berichten. Dit dient om te voorkomen dat zowel het client- als het serveronderdeel op incorrecte wijze de communicatie serveronderdelen beëindigt. Deze instelling is alleen van toepassing op de client.

Citrix-integratie: hoe werkt deze?

Nu u weet hoe u Citrix-integratie kunt configureren in Unified Service Desk, kunt u hier volgen hoe de Citrix-integratie werkt, vanaf het moment dat een agent het gehoste besturingselement start in de Unified Service Desk-client tot het moment waarop het gehoste besturingselement weer wordt gesloten.

  1. De klantenservicemedewerker start het gehoste Citrix-besturingselement vanuit de Unified Service Desk-client, die de Citrix-toepassing op de Citrix-server start met de ICA-bestandsnaam die is geconfigureerd voor het gehoste besturingselement.

  2. Het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe) start automatisch en vraagt om de instellingen voor de Citrix-toepassing die zijn geconfigureerd voor het gehoste besturingselement vanuit de Unified Service Desk-client. U hebt deze gegevens geconfigureerd in stap 8 in de sectie Een externe gehoste toepassing configureren

  3. Als een time-out optreedt voor het verzoek om toepassingsinstellingen op basis van de waarde die is opgegeven in de CitrixIntegration.RecvTimeoutInMilliseconds-appinstelling, komt het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe) tot de conclusie dat het exemplaar van de Citrix-toepassing geen gehoste UII-toepassing is en sluit af.

    Als er geen time-out optreedt bij het verzoek om toepassingsinstellingen, gaat u verder naar de volgende stap.

  4. Met de toepassinginstellingen van het gehoste Citrix-besturingselement gaat het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe) verder om het Citrix-toepassingsproces te identificeren.

    • Als het Citrix-toepassingsproces niet kon worden herkend, blijft het uitvoerbare bestand op de server actief en wordt een bericht hierover naar de client verzonden. U kunt het bericht bekijken als u tracering hebt ingeschakeld.

    • Als het Citrix-toepassingsproces wordt herkend, verwerft het uitvoerbare bestand op server het proces en gaat het verder met het identificeren van het aangewezen bovenste venster voor de toepassing. Het uitvoerbare bestand op de server refereert aan de configuratie die gewoonlijk wordt gebruikt voor externe toepassingen en gebruikt edeze om een niet-standaard bovenste venster te selecteren. Als het bovenste venster niet kan worden gevonden, blijft het uitvoerbare bestand op de server actief en wordt een informatiebericht naar de client verzonden dat kan worden bekeken als tracering is ingeschakeld.

  5. Tot slot wordt de toepassingsadapter voor het gehoste besturingselement geïnstantieerd. Het verworven proces en het bovenste venster worden aan de adapter verstrekt en alle adapterbewerkingen worden op dit punt gerouteerd tussen client en server.

    Notitie

    Als het proces niet is gevonden, is de waarde null. Als het venster niet is gevonden, is de waarde 0. Als de adapter niet kan worden worden geïnstantieerd, blijft het uitvoerbare bestand op de server actief en wordt een informatiebericht naar de client verzonden dat kan worden bekeken als tracering is ingeschakeld.

  6. Als de medewerker van de klantenservice het gehoste Citrix-besturingselement in de Unified Service Desk-client sluit, wordt het uitvoerbare bestand op de server eveneens afgesloten.

Voorbeelden van Citrix-adapters

Hier volgen enkele voorbeelden van Citrix-adapters die u kunt bekijken/uitproberen.

Voorbeeld van toepassingsadapter

Een voorbeeld van een toepassingsadapter voor Citrix is beschikbaar in het downloadpakket voor de UII SDK. U kunt deze adapter als volgt bekijken/uitproberen:

  1. Download het User Interface Integration (UII) SDK-pakket.

  2. Dubbelklik op het pakketbestand om de inhoud uit te pakken.

  3. Ga naar de map <ExtractedFolder>\UII\SampleCode\UII\Citrix\ApplicationAdapter. Het bestand README.txt in de map biedt informatie over deze adapter.

Voorbeeld van gegevensgestuurde adapter

Om het gebruik door bestaande gegevensgestuurde adapters (DDA's) te vergemakkelijken zonder dat ontwikkeling van een aangepaste adapter is vereist, biedt Unified Service Desk de volgende adapter voor het gebruik van de tag DataDrivenAdapterBindings voor het instantiëren van de DDA en voor het vertalen van DDA-acties naar oproepen aan de geïnstantieerde DDA: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.dll. Standaard is deze assembly beschikbaar in de installatiedirectory van uw Unified Service Desk-client.

Als u het voorbeeld van de DDA-adapter wilt gebruiken met uw gehoste Citrix-besturingselement, werkt u de definitie van het gehoste besturingselement bij om de volgende waarden op te geven in het gebied Adapterconfiguratie voor uw gehoste besturingselement:

Veld

Waarde

Adapter

Adapter gebruiken

URI

Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter

Type

Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DdaAutomationAdapter

Citrix-integratie: Aanbevolen procedures

Hier volgen enkele dingen die u kunt overwegen te doen bij het instellen van de integratie met Citrix-toepassingen.

  • Zorg ervoor dat de Citrix-toepassing die u wilt hosten in Unified Service Desk met succes zelfstandig kan worden gestart door deze expliciet te starten.

  • Gebruik tracering om problemen te identificeren en op te lossen. De traceerberichten helpen u bij het opsporen en oplossen van eventuele problemen. Standaard is Verbose tracering ingeschakeld in het bestand Microsoft.Uii.Csr.CitrixIntegration.exe.config om de uitvoeringsberichten in het logbestand op de server op te nemen:

    <add name="Microsoft.Uii.Common.Logging" value="Verbose"/>

    U kunt vervolgens een van de standaard User Interface Integration (UII)-logboekproviders, bijvoorbeeld de provider van bestandslogboekregistratie gebruiken om de traceerlogboeken weg te schrijven naar een bestand. De traceringen worden ook weergegeven in eventueel gekoppelde foutopsporingsprogramma's. Dezelfde instellingen op de client (bestand UnifiedServiceDesk.exe.config) zorgen voor activering van tracering op de client.

  • In Windows delen meerdere processen die hetzelfde programma uitvoeren hun geheugenpagina's die uitvoerbare code bevatten. De aard van .NET-programma's is dat de JIT-compiler (Just-In-Time) de tussentaal (IL) compileert naar computerinstructies (uitvoerbare code) tijdens runtime als de toepassing wordt gestart. Deze compileerbewerking tijdens runtime voorkomt het delen van verder identieke codepagina's, waardoor optimalisatie bij het delen van codepagina's wordt voorkomen. Omdat het uitvoerbare bestand op de server (Microsoft.Uii.Csr.CitrixIntegration.exe) een .NET-programma is waarbij meerdere exemplaren op één computer kunnen worden uitgevoerd, is het effectief om het hulpprogramma Ngen.exe (Native Image Generator) te gebruiken voor het maken van systeemeigen images van de afhankelijke assembly's voor het uitvoerbare bestand op de server en deze vervolgens te installeren in de systeemeigen image cache op de lokale computer. Dit vergemakkelijkt een beter gebruik van serverresources door het gebruik van systeemeigen images vanuit de cache in plaats van dat de oorspronkelijke assembly wordt gecompileerd met de JIT-compiler.

Zie ook

Gehoste UII-toepassingen
Gehoste UII-toepassingen maken en beheren
Volledige servicedesk uitbreiden

Unified Service Desk 2.0

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht

  • Last updated on