Del via

Integrere med Citrix-programmer

  • Artikel

 

Udgivet: november 2016

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

Integrer dine Citrix-programmer med Unified Service Desk ved at hoste dem i Unified Service Desk. Det giver kundeservicemedarbejdere mulighed for at interagere med Citrix-programmerne inde fra Unified Service Desk-klienten, mens de arbejder med kundedata i Microsoft Dynamics 365. Du kan også konfigurere et Windows-program som et virtuelt program i Citrix XenApp 7.6, der kører som et værtsprogram i Unified Service Desk. Flere oplysninger: TechNet: Softwarekrav til Citrix XenApp-programvirtualisering

Citrix-programmet, der er hostet i Unified Service Desk-klienten ICA-protokollen (Independent Computing Architecture) til at fjernkommunikere med programmet på en Citrix-server. En Citrix .ica-fil indeholder oplysninger til at oprette forbindelse til fjernserveren, såsom serveradressen, sessionsegenskaber og godkendelsesoplysninger.

Yderligere oplysninger om integration af Unified Service Desk med Citrix, se Blog: Citrix og Unified Service Desk

Dette emne indeholder oplysninger om konfiguration af server - og komponenter på klientsiden til integration af Unified Service Desk med Citrix-programmer, Citrix-prøvekort og nogle best practices.

Dette emne indeholder

Konfiguration af serverbaserede komponent til Citrix-integration

Konfiguration af komponent på klientsiden til Citrix-integration

Citrix-integration: hvordan fungerer det?

Eksempel på Citrix-kort

Citrix-integration: bedste fremgangsmåder

Konfiguration af serverbaserede komponent til Citrix-integration

Den serverbaserede komponent er implementeret som en eksekverbar fil (Microsoft.Uii.Csr.CitrixIntegration.exe), der er konfigureret som et startprogram, der starter automatisk, når et Citrix-program startes. Den eksekverbare fil afslutter hurtigt sig selv, hvis Citrix-programmet ikke startes fra en Unified Service Desk-klient. Den serverbaserede komponent skal konfigureres på hver Citrix-server.

  1. DownloadUser Interface Integration (UII) SDK-pakken.

  2. Dobbeltklik på pakkefilen for at pakke indholdet ud.

  3. Naviger til <ExtractedFolder>\UII\Bin\UII\Citrix Server Component-mappen, og kopier derefter alle filerne i denne mappe til en mappe (f.eks. ServerSideComponent) på Citrix-serveren.

  4. I ServerSideComponent-mappen på Citrix-serveren, skal du redigere RegPatch Install StartupPrograms on Citrix Server.reg-filen ved hjælp af Notesblok for at angive værdien af "StartupPrograms"-parameteren til den fulde sti til den Microsoft.Uii.Csr.CitrixIntegration.exe-eksekverbare fil.

  5. Anvend programrettelsen til registreringsdatabasen på Citrix-serveren ved at køre RegPatch Install StartupPrograms on Citrix Server.reg-filen. Programrettelsen af registreringsdatabasen angiver en eksekverbar fil som et startprogram, der vil blive startet sammen med et Citrix-program.

Konfiguration af komponent på klientsiden til Citrix-integration

Konfigurationen for Citrix-integration på klientsiden indebærer to ting:

  • Konfigurer et UII tilknyttet program (Remote Hosted Application) forekomst i din Dynamics 365-forekomst, der kan anvendes direkte uden nogen brugerdefineret kode eller kan forlænges efter behov. Handlinger, der udløses på UII-tilknyttede programforekomster overføres til den serverbaserede komponent ved hjælp af en .ica-fil, hvor det udsendes til de programkort, der eventuelt er konfigureret. Du kan finde flere oplysninger om Ull-tilknyttede programmer i UII-værtsprogrammer.

  • Kopiér de Citrix-programeksekverbare og andre nødvendige assemblyer i Unified Service Desk-klientinstallationsmappen, anvend programrettelsen af registreringsdatabase på klientsiden og tilføj Citrix-specifikke indstillinger i Unified Service Desk-konfigurationsfilen for klientappen. Dette trin skal udføres på alle computere, hvor Unified Service Desk-klientprogrammet er installeret.

Konfigurere et hostet fjernprogram

  1. Log på Microsoft Dynamics 365.

  2. Gå til Indstillinger > Unified Service Desk.

  3. Klik på Tilknyttede kontrolelementer, og klik derefter på Ny.

  4. På siden Nyt tilknyttet kontrolelement under området Generelt skal du angive et navn, sorteringsrækkefølge og vist navn for værtsprogrammet. Hvert værtsprogram skal have et entydigt navn. Sorteringsrækkefølgen angiver den rækkefølge, de tilknyttede programmer hentes og vises i i Unified Service Desk.

  5. Under området Unified Service Desk skal du vælge CCA-hostet program på listen USD-komponenttype.

  6. Under området Type af værtsapp skal du vælge Hostet fjernprogram på listen Hostet program.

  7. I sektionen Kortkonfiguration er der tre kortkonfigurationer at vælge mellem i Kort rullelisten:

    1. Brug ikke kort: Angiver, at det tilknyttede program ikke kræver automatisering.

    2. Brug automatiseringskort (HAT): Angiver, at standardkonfigurationen bruges til HAT Software Factory. Hvis værtsprogrammet bruger et automatiseringskort (HAT), skal du angive værtsprogrammets bindingsoplysninger i feltet Automatiserings-XML i sektionen Automatisering. Du kan få flere oplysninger om bindinger under Bruge UII inspektøren til at oprette bindinger til det tilknyttede program.

    3. Brug kort: Angiver, at det tilknyttede program bruger et brugerdefineret kort.

    Få mere at vide om brug af kort til Citrix integration på Eksempel på Citrix-kort

  8. I området Indstillinger for Citrix-program skal du angive følgende værdier:

    • ICA-filnavn: Angiv den fulde sti til .ica-filen, der kræves til start af Citrix-programmet. En .ica-fil indeholder oplysninger til at oprette forbindelse til fjernserveren, såsom serveradressen, sessionsegenskaber og godkendelsesoplysninger.

    • Forsøg på proceshentning: Angiv antallet af gange, den eksekverbare fil på serversiden skal scanne procestab for at søge efter den proces, der kører det startede Citrix-program. Det tager et lille øjeblik, før Citrix-programprocessen vises i procestabellen.

    • Forsinkelse af proceshentning: Angiv forsinkelsen i millisekunder mellem hver procestabelscanning.

    • Filnavn på proceshentning: Angiv den fulde sti til filnavnet for Citrix-programmet. Denne værdi bruges af den eksekverbare fil på serversiden til at sammenligne med filnavnene på de kørende processer for at finde et match.

  9. Gem det tilknyttede kontrolelement.

Kopiere eksekverbar fil, anvende programrettelse til registreringsdatabase og tilføje Citrix-konfigurationsindstillinger

Dette trin skal udføres på alle computere, hvor Unified Service Desk-klientprogrammet er installeret.

  1. Naviger til <ExtractedFolder>\UII\Bin\UII\Citrix Server Component-mappen, hvor <ExtractedFolder> er den placering, hvor du udpakkede den hentede UII SDK-pakkefil i det Konfiguration af serverbaserede komponent til Citrix-integration tidligere afsnit.

  2. Kopier følgende filer fra <ExtractedFolder>\UII\Bin\UII\Citrix Server Component-mappen til Unified Service Desk-klientmappen (typisk C:\Program Files\Microsoft Dynamics CRM USD\USD):

    • Microsoft.Uii.Csr.CitrixIntegration.exe

    • AxWFICALib.dll

    • WFICALib.dll

  3. Du kan installere programrettelsen til registreringsdatabasen på din Unified Service Desk-klientcomputer for at aktivere brugen af brugerdefinerede virtuelle kanaler ved at køre følgende filer, der er tilgængelige i <ExtractedFolder>\UII\Bin\UII\Citrix Server Component-mappen:

    • For x86-klient: RegPatch Allow Custom Virtual Channels in ICAClient.reg

    • For x64-klient: RegPatch Allow Custom Virtual Channels in ICAClient x64 Client.reg

    System_CAPS_noteBemærkning

    Hvis programrettelsen til registreringsdatabasen ikke anvendes, er kommunikation mellem klienten og serveren ikke mulig.

  4. Føj følgende app-indstillinger til UnifiedServiceDesk.exe.config-filen i Unified Service Desk-klientinstallationsmappen. App-indstillingerne skal tilføjes under <configuration>-rodnoden:

    <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>
    System_CAPS_noteBemærkning

    Disse app-indstillinger er også tilgængelige i den serverbaserede komponent i Microsoft.Uii.Csr.CitrixIntegration.exe.config-filen.

    Her er en beskrivelse af hver nøgle:

    Nøgle

    Beskrivelse

    CitrixIntegration.VirtualChannelNamePrefix

    For hvert startet Citrix-program oprettes to tydeligt navngivne virtuelle kanaler, der deler et fælles præfiks. Denne indstilling viser præfiksen for tilpasning, men det er normalt ikke nødvendigt. Denne indstilling skal være identisk, både på klientsiden og serversiden.

    CitrixIntegration.XmitFragmentSize

    Virtuelle kanaltransmissioner er fragmenteret til den grænse, der er angivet her. Nøglen lukkes internt, hvis den overskrider interne grænser (sporingsmeddelelser bør rapportere, når dette sker.) Denne indstilling kan variere mellem klient- og serversiden.

    CitrixIntegration.RecvTimeoutInMilliseconds

    Som med al netværkskommunikation er timeouts nødvendige for at afgøre, når peer-kommunikation er tilgængelig. Citrix-integrationskommunikation er anmodning/svar-orienteret, og denne indstilling angiver, hvor lang tid det tager at returnere svaret, før systemet ikke længere venter på svaret. Denne indstilling kan variere mellem klient- og serversiden.

    CitrixIntegration.HeartbeatMaxWaitInMilliseconds

    En virtuel kanalkommunikationsaktivitet tælles som en "impuls". Denne indstilling angiver den maksimale mængde tid, der kan gå uden nogen mellemliggende kommunikation, hvorefter begge sider af kommunikationskanalerne (klient eller server) konkluderer, at den modsatte peer er utilgængelig. Den serverbaserede eksekverbare fil (Microsoft.Uii.Csr.CitrixIntegration.exe) slutter, når denne konklusion er nået. Forekomsten af tilknyttede kontrolelement på klientsiden afsluttes den interne impulstimer. Denne indstilling kan variere mellem klient- og serversiden.

    CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds

    Angiver perioden for en timer, der udløser PING-meddelelser til den serverbaserede eksekverbare fil (Microsoft.Uii.Csr.CitrixIntegration.exe), som til gengæld svarer med tilsvarende PONG-meddelelser. Dette er for at forhindre, at både klient- og serverkomponenter forkert afslutter deres kommunikation. Denne indstilling er kun tilgængelig for klientsiden.

Citrix-integration: hvordan fungerer det?

Nu hvor du ved, hvordan du konfigurerer Citrix-integration i Unified Service Desk, kan du her se, hvordan Citrix-integrationen fungerer fra en Helpdesk-medarbejder starter det tilknyttede kontrolelement i Unified Service Desk-klienten til når det tilknyttede kontrolelement lukkes.

  1. Kundeservicemedarbejderen starter det tilknyttede Citrix-kontrolelement fra Unified Service Desk-klienten, som starter Citrix-programmet på Citrix-serveren ved hjælp af ICA-filnavnet, der konfigureret for det tilknyttede kontrolelement.

  2. Den serverbaserede eksekverbar fil (Microsoft.Uii.Csr.CitrixIntegration.exe) starter automatisk og anmoder om Citrix-programindstillinger, der er konfigureret for det tilknyttede kontrolelement fra Unified Service Desk-klienten. Disse oplysninger er konfigureret i trin 8 i afsnittet Konfigurere et hostet fjernprogram

  3. Hvis indstillingerne for programmet anmoder om timeout baseret på den værdi, der er angivet i CitrixIntegration.RecvTimeoutInMilliseconds-appindstillingen, konkluderer den serverbaserede eksekverbare fil (Microsoft.Uii.Csr.CitrixIntegration.exe), at Citrix-programforekomsten ikke er et UII-tilknyttet program, og afslutter.

    Hvis programindstillingerne ikke anmoder om timeout, kan du fortsætte til næste trin.

  4. Ved hjælp af programindstillinger i det tilknyttede kontrolelement i Citrix, fortsætter den serverbaserede eksekverbare fil (Microsoft.Uii.Csr.CitrixIntegration.exe) med at identificere Citrix-programmet.

    • Hvis Citrix-programprocessen ikke kunne identificeres, fortsætter den serverbaserede eksekverbare fil med at køre og sender en meddelelse til klienten om det samme. Hvis du har aktiveret sporing, kan du se meddelelsen.

    • Hvis Citrix-programprocessen identificeres, erhverver den serverbaserede eksekverbare fil processen og fortsætter med at identificere det udpegede øverste vindue til programmet. Den konfiguration, der normalt bruges til eksterne programmer, refereres til af den serverbaserede eksekverbare fil og kan bruges til at vælge et øverste vindue, der ikke er standard. Hvis det øverste vindue ikke kunne findes, fortsætter den serverbaserede eksekverbare med at køre og sender en info-meddelelse til klienten, der kan ses, når sporing er aktiveret.

  5. Slutteligt skal programkort for det tilknyttede kontrolelement instantieres. Den erhvervede proces og det øverste vindue leveres til kortet, kortoperationer sendes mellem klienten og serveren på dette tidspunkt.

    System_CAPS_noteBemærkning

    Værdien er null, hvis processen ikke blev fundet. Værdien er null, hvis vinduet ikke blev fundet. Hvis kortet ikke kunne instantieres, fortsætter den serverbaserede eksekverbare med at køre og sender en info-meddelelse til klienten, der kan ses, hvis sporing er aktiveret.

  6. Når kundeservicemedarbejderen lukker det tilknyttede Citrix-kontrolelement i Unified Service Desk-klienten, afbrydes den serverbaserede eksekverbare fil også.

Eksempel på Citrix-kort

Her er nogle Citrix-eksempelkort, du kan gennemse/prøve.

Eksempel på programkort

Et eksempel på et programkort til Citrix findes i UII SDK-overførselspakken. Gennemse/prøv dette kort:

  1. DownloadUser Interface Integration (UII) SDK-pakken.

  2. Dobbeltklik på pakkefilen for at pakke indholdet ud.

  3. Naviger til <ExtractedFolder>\UII\SampleCode\UII\Citrix\ApplicationAdapter-mappen. Filen Vigtigt.txt i mappen indeholder oplysninger om dette kort.

Eksempeldatastyret kort

For at lette anvendelsen af eksisterende datastyrede kort (DDA'er) uden at skulle udvikle et brugerdefineret kort indeholder Unified Service Desk følgende kort, der kan bruge DataDrivenAdapterBindings-mærket til at instantiere DDA'en samt til at oversætte DDA-handlinger til opkald på den instantierede DDA: Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.dll. Denne assembly er som standard tilgængelig i din Unified Service Desk-klientinstallationsmappe.

Hvis du vil bruge DDA-eksempelkortet med det tilknyttede Citrix-kontrolelement, skal du opdatere definitionen af det tilknyttede kontrolelement for at angive følgende værdier i området Kortkonfiguration for det tilknyttede kontrolelement:

Felt

Værdi

Kort

Brug kort

URI

Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter

Type

Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.DdaAutomationAdapter

Citrix-integration: bedste fremgangsmåder

Her er nogle ting, du kan overveje at gøre under opsætning af integration med Citrix-programmer.

  • Sørg for, at Citrix-programmet, som skal være vært i Unified Service Desk, selv kan startes ved, at du starter det.

  • Brug sporing til at identificere og løse problemer. Sporingsmeddelelsen hjælper dig identificere og foretage fejlfinding af problemer, hvis der er nogen. Som standard er Verbose-sporing aktiveret i Microsoft.Uii.Csr.CitrixIntegration.exe.config-filen, så udførselsmeddelelser logges på serveren:

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

    Du kan derefter bruge en af standard User Interface Integration (UII)-logføringsudbydere, for eksempel, (fillogføringsudbyder, for at skrive sporingslogfilerne til en fil. Sporingerne vises også i alle tilknyttede fejlfindingsprogrammer. De samme indstillinger på klientsiden (UnifiedServiceDesk.exe.config-fil) aktiverer sporing på klientsiden.

  • I Windows deler flere processer, der kører det samme program, deres hukommelsessider, der indeholder eksekverbar kode. Arten af .NET-programmer er, at JIT (just-in-time)-kompilering kompilerer IL (intermediate language) til maskininstruktioner (eksekverbar kode) på kørselstidspunktet, når programmet startes. Denne kørselskompilering forhindrer deling af ellers identiske kodesider, hvilket forhindrer at kodesiden deler optimering. Da den serverbaserede eksekverbare fil (Microsoft.Uii.Csr.CitrixIntegration.exe) er et .NET-program, hvor du kan køre flere forekomster på en enkelt computer, vil det være effektivt at udnytte Ngen.exe (Native Image Generator)-værktøjet for at oprette oprindelige billeder af de afhængige assemblyer for den serverbaserede eksekverbare fil og installere dem i oprindeligt billedcache på den lokale computer. Dette vil fremme en bedre ressourceudnyttelse af serveren, da der bruges oprindelige billeder fra cache i stedet for JIT-compiler til at kompilere den oprindelige assembly.

Se også

UII-værtsprogrammer
Oprette og administrere UII-værtsprogrammer
Udvide Unified Service Desk

Unified Service Desk 2.0

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret