Extension pour Citrix

En installant l’extension pour Citrix, vous êtes capable d’automatiser nativement les applis Citrix. Elle peut être installée depuis Studio ou l’invite de commande.

Remarque : vous devez installer le client Citrix (Citrix Receiver ou Citrix Workspace) par machine pour installer l'extension UiPath pour Citrix.

À partir de Studio UiPath

1. Ouvrez Studio.
2. Accédez à Accueil (Home) > Outils (Tools) > Extensions UiPath (UiPath Extensions).
3. Sélectionnez Citrix > Installer (Install). Une boîte de dialogue de confirmation s'affiche.
4. Veuillez redémarrer toutes vos applications Citrix pour que les modifications soient effectives.

L’extension UiPath pour Citrix est désormais installée dans le répertoire d’installation de Citrix.

À partir d'une ligne de commande

1. Cliquez sur le bouton Démarrer de Windows et tapez cmd dans le champ de recherche.
2. Cliquez avec le bouton droit de la souris sur l'outil Invite de commandes et exécutez-le en tant qu'administrateur.
3. Remplacez le répertoire par le dossier d'installation UiPath (cd C:\Program Files\UiPath\Studio\UiPath pour les installations par machine, cd %localappdata%\Programs\UiPath\Studio\UiPath pour les installations par utilisateur).
4. Utilisez la commande SetupExtensions /CitrixClient pour installer l'extension. La boîte de dialogue de confirmation s'affiche.
5. Redémarrez toutes vos applications Citrix pour que les modifications prennent effet. L'extension UiPath pour Citrix est désormais installée.
   Remarque : pour générer des sélecteurs natifs pour la technologie Citrix, vous devez également déployer le composant UiPath Remote Runtime sur tous vos serveurs d’applications Citrix, comme expliqué sur cette page. Le programme d’installation UiPathRemoteRuntime.msi est obtenu en le demandant ici.

Désinstallation de l'extension UiPath pour Citrix

Depuis Studio

1. Ouvrez Studio.
2. Accédez à Accueil (Home) > Outils (Tools) > Extensions UiPath (UiPath Extensions).
3. Sélectionnez Citrix > Désinstaller (Uninstall) et confirmez votre choix.

L'extension UiPath pour Citrix est maintenant désinstallée.

À partir de la ligne de commande

1. Fermez toutes vos applications Citrix en cours d'exécution.
2. Cliquez sur le bouton Démarrer de Windows et tapez cmd dans le champ de recherche.
3. Cliquez avec le bouton droit sur Invite de commande (Command Prompt) et exécutez-la en tant qu'administrateur.
4. Remplacez le répertoire par le dossier d'installation UiPath (cd C:\Program Files\UiPath\Studio\UiPath pour les installations par machine, cd %localappdata%\Programs\UiPath\Studio\UiPath pour les installations par utilisateur).
5. Utilisez la commande SetupExtensions /CitrixClient /uninstall pour désinstaller l'extension. Une boîte de dialogue de confirmation s'affiche.

L'extension UiPath pour Citrix est maintenant désinstallée.

Résolution des problèmes

Cette page explique comment résoudre les problèmes que vous pouvez rencontrer lors de l'exécution de l'automatisation dans les environnements Citrix.

La sélection interactive dans les applis Citrix se bloque et aucun élément n'est sélectionné

Comportement observé

Après avoir installé l'extension UiPath pour Citrix et essayé de sélectionner les éléments d'IU à partir d'une application Citrix, la sélection interactive se bloque pendant une minute, et aucun élément n'est sélectionné.

Origine

Cela se produit si UiPath Remote Runtime n'est pas en cours d'exécution dans la session de l'appli Citrix.

Solution

• Vérifiez si UiPathRemoteRuntime.msi est installé sur le serveur d'applications Citrix à partir duquel l'appli Citrix est ouverte.

• Sur le serveur d'applications Citrix, vérifiez si le processus UiPathRemoteRuntime.exe est en cours d'exécution. Si UiPathRemoteRuntime.msi est installé, le processus est démarré automatiquement lors de la connexion de la session de l'appli Citrix.

  
  

  

  
  
  Remarque : si vous ne pouvez pas installer UiPathRemoteRuntime.msi sur les serveurs d'applications Citrix, il est recommandé de désinstaller l'extension UiPath pour Citrix depuis la machine cliente, comme indiqué ici.

Impossible d'écraser le fichier « C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll ». Il est actuellement utilisé par un autre processus.

Comportement observé

Lorsque vous essayez d'installer l'extension UiPath pour Citrix, Le message d'erreur suivant est affiché :

Origine

Cela se produit lorsque l'extension UiPath pour Citrix est déjà installée et qu'une application Citrix ouverte l'utilise.

Solution

Fermez toutes vos sessions actives de l'application Citrix, comme décrit ici, puis essayez de réinstaller l'extension UiPath pour Citrix.

Impossible de lire la clé de Registre Citrix : 'SOFTWARECitrixInstallICA du client  : 'InstallFolder'

Comportement observé

Lorsque vous essayez d'installer l'extension UiPath pour Citrix, le message d'erreur suivant est affiché :

Origine

Ce message d'erreur s'affiche lorsque Citrix Receiver n'est pas installé. Il s'affiche également si Citrix Receiver pour la plateforme Windows universelle est installé.

Solution

Téléchargez et installez Citrix Receiver ou Citrix Workspace.

Exception non gérée dans wfica32.exe 0xC0000094: division entière par zéro

Comportement observé

L'application Citrix cible ne démarre pas et le client Citrix ICA se bloque.

Origine

Les activités qui utilisent la fonction GetWindowText (telles que Element Exists ) sont exécutées avant le chargement de l'application Citrix.

Solution

Attendez que l'application Citrix se charge en ajoutant un délai avant l'activité.