Intégration aux applications Citrix

Date de publication : novembre 2016

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

Intégrez vos applications Citrix avec Unified Service Desk en les hébergeant dans Unified Service Desk. Cela permet aux agents du service clientèle d'interagir avec les applications Citrix du client Unified Service Desk tout en travaillant sur les données client dans Microsoft Dynamics 365. Configurez une application Windows comme une application virtuelle sur Citrix XenApp 7.6 qui s'exécute comme une application hébergée dans Unified Service Desk. Pour plus d'informations : TechNet : Configuration logicielle requise pour la virtualisation d'applications Citrix XenApp

L'application Citrix hébergée dans le client Unified Service Desk utilise le protocole Independent Computing Architecture (ICA) pour communiquer à distance avec l'application sur un serveur Citrix. Un fichier Citrix .ica contient des informations pour se connecter au serveur distant, telles que l'adresse du serveur, les propriétés de session et les informations d'authentification.

Pour plus d'informations sur l'intégration de Unified Service Desk avec Citrix, consultez Blog : Citrix et Unified Service Desk

Cette rubrique fournit des informations sur la configuration des composants serveur et client pour intégrer Unified Service Desk avec les applications Citrix, des exemples d'adaptateurs Citrix et quelques conseils.

Contenu de la rubrique

Configurez le composant côté serveur pour l'intégration Citrix

Configurez le composant côté client pour l'intégration Citrix

Intégration de Citrix : Comment cela fonctionne-t-il ?

Exemple d'adaptateurs Citrix

Intégration Citrix : Méthodes conseillées

Configurez le composant côté serveur pour l'intégration Citrix

Le composant côté serveur est implémenté dans un fichier exécutable (Microsoft.Uii.Csr.CitrixIntegration.exe) configuré comme un programme de démarrage pour démarrer automatiquement lorsqu'une application Citrix démarre. Le fichier exécutable prend fin automatiquement et rapidement si l'application Citrix n'a pas été appelée depuis un client Unified Service Desk. Le composant côté serveur doit être configuré sur chaque serveur Citrix.

1. Téléchargez le package Kit de développement logiciel (SDK) User Interface Integration (UII).

2. Double-cliquez sur le fichier du package pour extraire le contenu.

3. Accédez au dossier <ExtractedFolder>\UII\Bin\UII\Citrix Server Component, puis copiez tous les fichiers dans ce dossier vers un dossier (ServerSideComponent par exemple) sur votre serveur Citrix.

4. Dans le dossier ServerSideComponent sur votre serveur Citrix, modifiez le fichier RegPatch Install StartupPrograms on Citrix Server.reg à l'aide du Bloc-notes pour définir la valeur du paramètre "StartupPrograms" vers le chemin d'accès complet du fichier exécutable Microsoft.Uii.Csr.CitrixIntegration.exe.

5. Appliquez le correctif de Registre sur votre serveur Citrix en exécutant le fichier RegPatch Install StartupPrograms on Citrix Server.reg. Ce correctif de Registre indique un fichier exécutable comme programme de démarrage qui sera lancé en même temps qu'une application Citrix.

Configurez le composant côté client pour l'intégration Citrix

La configuration côté client pour l'intégration Citrix implique deux éléments :

• Configurez une instance d'application hébergée UII (Remote Hosted Application) dans votre instance Dynamics 365 qui peut être utilisée directement sans code personnalisé, ou peut être étendue si nécessaire. Des actions déclenchées sur les instances d'applications hébergées UII sont transmises au composant côté serveur dans un fichier de type .ica, où il est affecté aux adaptateurs d’application configurés, le cas échéant. Pour plus d’informations sur les applications hébergées UII, consultez Applications hébergées UII.

• Copiez l'application exécutable Citrix et les autres assemblys obligatoires dans le répertoire d'installation client Unified Service Desk, appliquez le correctif de Registre côté client, et ajoutez des paramètres spécifiques Citrix dans le fichier de configuration de l'application client Unified Service Desk. Cette étape doit être effectuée sur chaque ordinateur où l'application cliente Unified Service Desk est installée.

Configurer une application hébergée à distance

1. Connectez-vous à Microsoft Dynamics 365.

2. Accédez à Paramètres > Unified Service Desk.

3. Cliquez sur Contrôles hébergés, puis sur Nouveau.

4. Sur la page Nouveau contrôle hébergé, sous la zone Général, spécifiez un nom, un ordre de tri et un nom complet pour l’application hébergée. Chaque application hébergée doit avoir un nom unique. L’ordre de tri spécifie l’ordre dans lequel les applications hébergées sont récupérées et affichées dans Unified Service Desk

5. Dans la zone Unified Service Desk, sélectionnez Application hébergée CCA à partir de la liste Type de composant USD.

6. Dans la zone Type d'Applications hébergé, sélectionnez Application hébergée à distance dans la liste Application hébergée.

7. Dans la section Configuration de l’adaptateur, vous pouvez choisir entre trois fonctionnalités d’adaptateur dans la liste déroulante Adaptateur :

   1. N’utiliser aucun adaptateur : Spécifie que l’application hébergée ne requiert aucune automatisation.

   2. Utiliser un adaptateur d’automatisation (HAT) : Spécifie la configuration par défaut utilisée pour la fabrique logicielle HAT. Si l’application hébergée utilise un adaptateur d’automatisation (HAT), spécifiez les informations de liaison de l’application hébergée dans le champ XML d’automatisation dans la section Automatisation. Pour plus d’informations sur les liaisons, consultez Utiliser l’Inspecteur UII pour créer des liaisons pour l’application hébergée.

   3. Utiliser un adaptateur : Spécifie que l’application hébergée utilise un adaptateur personnalisé.

   Pour plus d'informations sur l'utilisation d'adaptateurs pour l'intégration Citrix, voir Exemple d'adaptateurs Citrix

8. Dans la zone Paramètres de l'application Citrix, spécifiez les valeurs suivantes :

   • Nom de fichier ICA: Indiquez le chemin d'accès complet au fichier .ica requis pour lancer l'application Citrix. Un fichier .ica contient des informations pour se connecter au serveur distant telles que l'adresse du serveur, les propriétés de session et les informations d'authentification.

   • Tentatives d'acquisition de processus : Spécifiez le nombre de fois où le fichier exécutable côté serveur doit analyser la table de processus pour rechercher le processus de fonctionnement de l'application Citrix lancée. Le processus d'application de Citrix peut mettre un peu de temps avant d'apparaître dans la table de processus.

   • Retard d'acquisition de processus : Spécifiez le délai en millisecondes entre chaque analyse de table de processus.

   • Nom de fichier d'acquisition de processus : Indiquez le chemin d'accès complet au nom de fichier de l'application Citrix. Cette valeur est utilisée par le fichier exécutable côté serveur pour la comparer aux noms de fichier des processus d'exécution pour rechercher une correspondance.

9. Enregistré le contrôle hébergé.

Copiez le fichier exécutable, appliquez le correctif de Registre et ajoutez les paramètres de configuration de Citrix

Cette étape doit être effectuée sur chaque ordinateur où l'application cliente Unified Service Desk est installée.

1. Accédez au dossier <ExtractedFolder>\UII\Bin\UII\Citrix Server Component où <ExtractedFolder> représente l'emplacement où vous avez extrait le fichier de package SDK UII téléchargé dans la section Configurez le composant côté serveur pour l'intégration Citrix précédente.

2. Copiez les fichiers suivants du dossier <ExtractedFolder>\UII\Bin\UII\Citrix Server Component au dossier client Unified Service Desk (généralement C:\Program Files\Microsoft Dynamics CRM USD\USD) :

   • Microsoft.Uii.Csr.CitrixIntegration.exe

   • AxWFICALib.dll

   • WFICALib.dll

3. Appliquez le correctif de Registre sur l'ordinateur client Unified Service Desk pour activer l'utilisation des canaux virtuels personnalisés en exécutant les fichiers suivants disponibles dans le dossier <ExtractedFolder>\UII\Bin\UII\Citrix Server Component :

   • Pour le client x86 : RegPatch autorise les canaux virtuels personnalisés dans ICAClient.reg

   • Pour le client x64 : RegPatch autorise les canaux virtuels personnalisés dans ICAClient x64 Client.reg

   Notes

   Si ce correctif de Registre n'est pas appliqué, les communications entre le client et le serveur ne seront plus possibles.

4. Ajoutez les paramètres d'application suivants dans le fichier UnifiedServiceDesk.exe.config disponible dans le répertoire d'installation client Unified Service Desk. Ces paramètres d'applications doivent être ajoutés sous le nœud racine <configuration> :

   <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>
   

   Notes

   Ces paramètres d'applications sont également disponibles dans le composant côté serveur dans le fichier Microsoft.Uii.Csr.CitrixIntegration.exe.config.

   Voici une description de chaque clé :

   Clé	Description
   CitrixIntegration.VirtualChannelNamePrefix	Pour chaque application Citrix lancée, deux canaux virtuels distinctement nommés sont créés et partagent un préfixe commun. Ce paramètre expose le préfixe à la personnalisation, mais normalement ce n'est pas nécessaire. Ce paramètre doit être identique à ceux du côté client et du côté serveur.
   CitrixIntegration.XmitFragmentSize	Les communications des canaux virtuels sont réduites en fragments jusqu'à la limite spécifiée ici. La touche sera couverte en interne si elle dépasse les limites internes (un courrier de suivi doit signaler si cela se produit.) Ce paramètre peut être différent entre le côté client et le côté serveur.
   CitrixIntegration.RecvTimeoutInMilliseconds	Comme pour toutes les communications réseau, les délais d'expiration sont nécessaires pour décider quand l'homologue de communication est indisponible. La communication d'intégration Citrix est de type demande/réponse et ce paramètre indique la durée nécessaire pour retourner la réponse avant que le système abandonne l'attente de la réponse. Ce paramètre peut être différent entre le côté client et le côté serveur.
   CitrixIntegration.HeartbeatMaxWaitInMilliseconds	Toute activité de communication de canal virtuel est comptée comme une « pulsation ». Ce paramètre indique une durée maximum pouvant s'écouler sans aucune communication d'intervention, après quoi, chaque côté des canaux de communication (client et serveur) décide que l'homologue opposé est devenu indisponible. Pour le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe), il se termine une fois cette conclusion effectuée. Pour l'instance de contrôle hébergée côté client, il termine le minuteur interne de ping de pulsation. Ce paramètre peut être différent entre le côté client et le côté serveur.
   CitrixIntegration.ClientOnly.HeartbeatIntervalInMilliseconds	Spécifie la période du minuteur qui déclenche des messages PING vers le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe), qui, à son tour répondra avec les messages PONG correspondants. Il s'agit d'éviter que les composants client et serveur concluent incorrectement leur communication. Ce paramètre s'applique uniquement pour le côté client.

Intégration de Citrix : Comment cela fonctionne-t-il ?

Maintenant que vous savez comment configurer l'intégration de Citrix dans Unified Service Desk, voici comment fonctionne l'intégration de Citrix depuis l'instant où un agent démarre le contrôle hébergé dans le client Unified Service Desk jusqu'à la fermeture du contrôle hébergé.

1. L'agent du service clientèle démarre le contrôle hébergé Citrix depuis le client Unified Service Desk, ce qui lance l'application Citrix sur le serveur Citrix en utilisant le nom de fichier ICA configuré pour le contrôle hébergé.

2. Le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe) démarre automatiquement, et demande que les paramètres de l'applications Citrix soient configurés pour le contrôle hébergé à partir de Unified Service Desk client. Vous avez configuré ces informations à l'étape 8 dans la section Configurer une application hébergée à distance

3. Si les paramètres d'application demande un délai d'attente selon la valeur spécifiée dans le paramètre d'application CitrixIntegration.RecvTimeoutInMilliseconds, le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe) en conclut que l'instance d'application Citrix n'est pas une application hébergée UII, et se termine.

   Si la demande des paramètres de l'application ne dépasse pas le délai d'attente, passez à l'étape suivante.

4. Utilisation des paramètres d'application du contrôle hébergé Citrix, le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe) traite l'identification du processus d'application Citrix.

   • Si le processus d'application Citrix ne peut pas être identifié, le fichier exécutable côté serveur continue de s'exécuter et envoie un message semblable au client. Vous pouvez afficher le message si vous avez activé le suivi.

   • Si le processus d'application Citrix est identifié, le fichier exécutable côté serveur acquiert le processus et exécute l'identification de la fenêtre supérieure désignée pour l'application. La configuration couramment utilisée pour des applications externes est référencée par le fichier exécutable côté serveur et peut être exploitée pour sélectionner une fenêtre supérieure non définie par défaut. Si la fenêtre supérieure est introuvable, le fichier exécutable côté serveur continue de s'exécuter et envoie un message d'information au client qui peut être vu lorsque le suivi a été activé.

5. Enfin, l'adaptateur d'application du contrôle hébergé est instancié. Les processus et la fenêtre supérieure acquis sont fournis à l'adaptateur et toutes les fonctionnalités de l'adaptateur sont transmises entre le client et le serveur.

   Notes

   Si le processus n'a pas été trouvé, la valeur sera null. Si la fenêtre n'a pas été trouvée, la valeur sera 0. Si l'adaptateur n'a pas pu être instancié, le fichier exécutable côté serveur continue de s'exécuter et envoie un message d'information au client qui peut être vu lorsque le suivi a été activé.

6. Lorsque l'agent du service clientèle ferme le contrôle hébergé par Citrix dans le client Unified Service Desk, le fichier exécutable côté serveur est également fermé.

Exemple d'adaptateurs Citrix

Voici quelques exemples d'adaptateurs Citrix disponibles pour votre vérification/évaluation.

Exemple d'adaptateur d'application

Un exemple d'adaptateur d'application pour Citrix est disponible dans le package de téléchargement du Kit de développement logiciel (SDK) UII. Pour vérifier/évaluer cet adaptateur :

1. Téléchargez le package Kit de développement logiciel (SDK) User Interface Integration (UII).

2. Double-cliquez sur le fichier du package pour extraire le contenu.

3. Accédez au dossier <ExtractedFolder>\UII\SampleCode\UII\Citrix\ApplicationAdapter. Le fichier README.txt dans le dossier fournit des informations sur cet adaptateur.

Exemple d'adaptateur piloté par des données

Pour faciliter l'utilisation des adaptateurs pilotés par des données (DDA) existants sans nécessiter le développement d'un adaptateur personnalisé, Unified Service Desk fournit l'adaptateur suivant pour consommer la balise DataDrivenAdapterBindings afin d'instancier le DDA et traduire des actions de DDA en appels sur le DDA instancié : Microsoft.Uii.HostedApplicationToolkit.DataDrivenAdapter.dll. Par défaut, cet assembly est disponible dans votre répertoire d'installation du client Unified Service Desk.

Pour utiliser l'exemple d'adaptateur DDA avec votre contrôle hébergé Citrix, mettre à jour la définition du contrôle hébergé pour spécifier les valeurs suivantes sous la zone Configuration de l'adaptateur pour votre contrôle hébergé :

Intégration Citrix : Méthodes conseillées

Voici quelques conseils que vous pourriez envisager d'appliquer lors de la configuration de l'intégration avec les applications Citrix.

• Assurez-vous que l'application Citrix que vous souhaitez héberger dans Unified Service Desk peut être correctement lancée seule en la démarrant explicitement.

• Utilisez le suivi pour identifier et résoudre les problèmes. L'aide de messagerie de suivi vous permet d'identifier et de résoudre des problèmes potentiels. Par défaut, le suivi Verbose est activé dans le fichier Microsoft.Uii.Csr.CitrixIntegration.exe.config pour enregistrer les messages d'exécution sur le serveur :

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

  Vous pouvez ensuite utiliser un des fournisseurs de journalisation User Interface Integration (UII), par exemple, le fournisseur de journalisation de fichier, pour créer des journaux de suivi dans un fichier. Les traces apparaitront également dans tous les débogueurs joints. Les mêmes paramètres sur le côté client (fichier UnifiedServiceDesk.exe.config) activeront le suivi du côté client.

• Dans Windows, plusieurs processus exécutant le même programme partagent leurs fichiers d'échange contenant le code exécutable. La nature des programmes .NET est que la compilation juste-à-temps (JIT) compile le langage intermédiaire (IL) à des instructions d'ordinateur (code exécutable) au moment de l'exécution lorsque l'application est lancée. Cette compilation du temps d'exécution empêche le partage de pages de codes sinon identiques, ce qui empêche la page de codes de partager des performances. Comme le fichier exécutable côté serveur (Microsoft.Uii.Csr.CitrixIntegration.exe) est un programme .NET où plusieurs instances peuvent être exécutées sur un ordinateur unique, il est efficace de bénéficier de l'outil Ngen.exe (générateur d'image native) pour créer des images natives des assemblys dépendants pour le fichier exécutable côté serveur et les installer dans le cache d'image native sur l'ordinateur local. Cela permettra de faciliter l'utilisation des ressources serveur en utilisant les images natives du cache au lieu d'utiliser le compilateur JIT pour compiler l'assembly d'origine.

Voir aussi

Applications hébergées UII
Créer et gérer des applications hébergées UII
Étendre le Centre de services unifié

Unified Service Desk 2.0

© 2017 Microsoft. Tous droits réservés. Copyright