Session de terminal (Terminal Session)

UiPath.Terminal.Activities.TerminalSession

Description

A container that connects to a terminal and enables you to perform multiple actions within it.

Compatibilité du projet

Windows - Héritage | Fenêtres

Configuration

Module Designer

• Configurer la connexion... (Configure Connection...) : permet de configurer une connexion. Une fois l’activité déplacée vers le concepteur de workflow, la fenêtre Configurer la connexion (Configure Connection) s’ouvre. Si elle est fermée, elle peut être rouverte à l’aide de cette option.
• Démarrer l’enregistreur (Start Recorder) : une fois qu’une connexion est établie, le bouton Démarrer l’enregistreur (Start Recorder) peut être utilisé pour se connecter au terminal et enregistrer les actions nécessaires.

Panneau propriétés

Commun

• Continuer en cas d'erreur (Continue on error) : précise si l’automatisation doit se poursuivre même si l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False)). La valeur par défaut est Faux (False). Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire Vrai (True), l'exécution du projet se poursuit même en cas d'erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur (Continue On Error) est vraie, aucune erreur ne sera détectée lors de l'exécution du projet.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Nouvelle session

• Chaîne de connexion ( Connection String) - Chaîne qui contient les détails de connexion. Ce champ ne prend en charge que les chaînes et les variables String .
• Connexion de sortie ( Output Connection) - La connexion établie est stockée dans une variable TerminalSession . Cette variable peut être transmise aux autres activités Session du terminal ( Terminal Session ) dans le champ de propriété Connexion existante ( Existing Connection ) si vous souhaitez réutiliser la connexion déjà établie. Ce champ prend uniquement en charge les variables TerminalSession .

Options

• DelayMS : délai (en millisecondes) avant que l'activité ne commence à effectuer des opérations. La valeur par défaut est de 1000 millisecondes (1 seconde).
• TimeoutMS (TimeoutMS) - Spécifie la durée (en millisecondes) à attendre pour que l'activité s'exécute avant qu'une erreur soit générée. La valeur par défaut est de 50 000 millisecondes (50 secondes).

Propriétés de la connexion SSH

• Mot depasse SSH : le mot de passe SecureShell utilisé pour se connecter au terminal spécifié, stocké dans une variable SecureString . Ce champ ne prend en charge que SecureString variables.
• Nom d'utilisateur SSH : le nom d'utilisateur SecureShell utilisé pour se connecter au terminal spécifié, stocké dans une variable String . Ce champ prend uniquement en charge les chaînes et les String variables.

Utiliser la connexion existante

• Fermer la connexion ( Close Connection) - Si cette case est cochée, la connexion existante est fermée après l'arrêt de l'exécution de l'activité. Par défaut, cette case est cochée. Notez que cette propriété est ignorée si la propriété Connexion de sortieest définie.
• Connexion existante ( Existing Connection) - L'indication d'une variable TerminalSession dans ce champ de propriété utilise la connexion stockée dans la variable pour se connecter à un terminal. Ce champ prend uniquement en charge les variables TerminalSession .

La fenêtre Configurer la connexion

La fenêtre Configurer la connexion (Configure Connection) contient diverses options de configuration qui varient en fonction du type de fournisseur choisi pour effectuer la connexion à l’environnement du terminal.

Propriétés indépendantes du fournisseur choisi :

• Afficher l’application cliente (Show client application) : si cette option est cochée, elle affiche une vue de l’écran du terminal lors du runtime.

Le fournisseur de connexion directe

Le fournisseur de connexion directe est un fournisseur interne UiPath qui n'a besoin d'aucun logiciel d'émulation de terminal tiers sur la machine robot. L'émulation est effectuée par le robot, au moment de l'exécution.

Paramètres de connexion

• Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal.
• Port - Numéro de port où le système d'environnement du terminal accepte les connexions.
• Type (Type) - Type d'émulation de terminal nécessaire :
  • TN3270 : couramment utilisé par les systèmes IBM de la série Z.
  • TN5250 : couramment utilisé par les systèmes IBM de série I (AS-400).
  • VT : terminaux compatibles DEC VT.
  • Série HP (HP Series) : émulation de terminal spécifique à HP.
  • Tandem : émulation de terminal Tandem Systems.
  • Wyse : émulation de terminal de série Wyse.
  • ANSI : émulation de terminal basée sur la spécification ANSI.
  • Sco ANSI : extension de la spécification ANSI utilisée par les systèmes SCO Unix.
• Protocole (Protocole) - Protocole de communication à utiliser pour la connexion :
  • Telnet : protocole Telnet.
  • SSH : protocole SSH utilisé par la plupart des systèmes Unix/Linux.
  • HPVT : protocole spécifique à HP utilisé en conjonction avec l’émulation de terminal de série HP.
• Mode terminal ( Terminal Mode ) - Version spécifique de l'émulation de terminal. La valeur disponible ici dépend de la valeur choisie dans le champ Type.
• Encodage (Encoding) : page de code utilisée par l’environnement système du terminal. La valeur par défaut est IBM037 pour les terminaux de la gamme IBM et ASCII pour les autres types de terminaux.
• Activer SSL/TLS : utilisé conjointement avec le protocole telnet, pour spécifier que le système d'environnement du terminal utilise une connexion chiffrée SSL ou TLS.
• Nom LU : le nom de l'unité logique, utilisé avec les types de terminaux de la famille IBM.
• Réponse : un message texte à envoyer au système hôte lorsque le terminal reçoit le caractère de commande ENQ . Le message peut contenir la touche de contrôle Entrée, encodée dans la valeur de chaîne sous la forme ^M. Cette option de configuration est disponible uniquement lorsque le type de terminal sélectionné est VT.
• Type de proxy (Proxy type) : type de protocole utilisé par le serveur proxy :
  • Aucun (None) (par défaut) : aucun de proxy
  • Tunnel : proxy HTTPS.
  • SOCKS4
  • SOCKS5
  • SOCKS4A
• Hôte du proxy (Proxy Host) : adresse IP ou nom d’hôte du serveur proxy.
• Port du proxy (Proxy Port) : numéro du port utilisé par le serveur proxy.
• Utilisateur du proxy (Proxy User) : nom d’utilisateur à utiliser pour l’authentification sur le serveur proxy.
• Mot de passe du proxy (Proxy Password) : mot de passe à utiliser pour l'authentification sur le serveur proxy.

Remarque : le fournisseur de connexion directe utilise une bibliothèque DLL native non signée par UiPath. La bibliothèque se nomme ttermdotnet.dll. Si vous utilisez ce fournisseur, vous devez autoriser le chargement et l’exécution de cette bibliothèque.

Le fournisseur IBM EHLLAPI

Le fournisseur IBM EHLLAPI fonctionne avec n'importe quel logiciel d'émulation de terminal tiers qui implémente l'API EHLL. Les détails de l'implémentation de l'API EHLL doivent être trouvés dans la documentation du logiciel d'émulateur de terminal tiers.

Remarque : le logiciel d'émulation de terminal doit être démarré et connecté avant de tenter de s'y connecter via EHLLAPI.

Paramètres de connexion

• DLL EHLL : chemin d'accès à la DLL utilisée pour implémenter l'APIEHLLAPI dans le logiciel émulateur de terminal tiers.
• Fonction EHLL : le nom de la fonction du point d'entrée dans la DLL EHLL. Généralement, « hlapi ».
• Session EHLL ( EHLL session) - Nom de la session tel qu'il apparaît dans le logiciel d'émulation du terminal. Habituellement « A », mais lors de l’utilisation de plusieurs sessions simultanées, la valeur peut varier.
• Encodage EHLL ( EHLL encoding ) : l'encodage utilisé par le logiciel d'émulation de terminal pour la connexion donnée.
• EHLL amélioré : utilisé pour spécifier si l'émulateur de terminal tiers implémente la version standard ou améliorée de l'API EHLL.
• Encodage (Encoding) : page de code utilisée par l’environnement système du terminal. La valeur par défaut est IBM037 pour les terminaux de la gamme IBM et ASCII pour les autres types de terminaux.
• Mode basique (Basic mode) : mode qui désactive le traitement au niveau du champ pour de meilleures performances. Les activités au niveau du champ (Obtenir le champ (Get Field), Définir le champ (Set Field), etc.) fonctionnent dans ce mode.
• Exécuter dans le processus (Run in process) : contrôle la façon dont la communication avec l’émulation du terminal tiers est effectuée via l’API EHLL. Par défaut, cette option est désactivée et, dans ce cas, la communication s’effectue via un processus proxy, un programme exécutable différent qui fait partie du package d’activités du terminal. Lors du runtime, le processus proxy communique avec le processus UiPath Executor par un canal WCF. Lorsqu’elle est activée, la communication avec le logiciel d’émulation de terminal tiers s’effectue à l’intérieur du processus UiPath Executor. Cette option ne doit être activée que si un logiciel antivirus ou des politiques de sécurité logicielle empêchent le bon fonctionnement du processus proxy.
  Remarque : le fait de passer le paramètre Exécuter dans le processus (Run in process) sur Vrai (True) peut entraîner un dysfonctionnement de la session de terminal en raison de la différence d’architecture (32 bits contre 64 bits) entre l’émulateur tiers et le processus UiPath Studio/Executor. Les bibliothèques EHLL 32 bits ne fonctionnent correctement que dans les projets hérités depuis Windows, tandis que les bibliothèques EHLL 64 bits ne fonctionnent correctement que dans les projets Windows.

Remarque : En raison d'une limitation dans la spécification d ' EHLLAPI, la version améliorée d' EHLLAPI ne prend pas en charge le travail avec plusieurs sessions EHLLAPI lorsque l'option Exécuter dans le processus (Run in process) est cochée. Seule l'implémentation standard d'EHLLAPI prend en charge un tel scénario. Cela signifie que l'option EHLL amélioré n'est pas cochée et que le fichier DLL répertorié dans le champ dll EHLL est une version qui implémente la spécification EHLLAPI standard.

Le fournisseur de réflexion Attachmate

Le fournisseur Attachmate Reflection fonctionne avec l’émulateur de terminal Attachmate Reflection.

Disponible uniquement pour les projets hérités depuis Windows.

Paramètres de connexion

• Se connecter à la session existante (Attach to existing session) : dans ce mode, l’émulateur de terminal doit être déjà démarré et connecté. Aucun profil de configuration n’est utilisé dans ce cas.
• Utiliser un profil existant (Use an existing profile) : dans ce mode, le chemin d’accès à un profil de configuration doit être fourni. L’émulateur de terminal démarre automatiquement.
• Spécifier manuellement l’adresse (Manually specify address) : dans ce mode, aucun profil de configuration n’est utilisé. Les propriétés de configuration doivent être spécifiées manuellement :
  • Adresse (Address) : adresse IP ou nom d’hôte de l’environnement système du terminal.
  • Port : numéro du port de l’environnement système du terminal. qui accepte les connexions.
  • Type (Type) - Type d'émulation de terminal nécessaire :
    • TN3270
    • TN5250
    • VT

Le fournisseur Attachmate Extra

Le fournisseur Attachmate Extra fonctionne avec Attachmate Extra ! émulateur de terminal.

Paramètres de connexion

Utiliser un profil existant (Use an existing profile) : un chemin d'accès vers un profil de configuration doit être fourni. L'émulateur de terminal démarre automatiquement.

Le fournisseur Reflection for UNIX

Le fournisseur Reflection for UNIX fonctionne avec l'émulateur de terminal Reflection for Unix.

Paramètres de connexion

Utiliser un profil existant (Use an existing profile) : un chemin d'accès vers un profil de configuration doit être fourni. L'émulateur de terminal démarre automatiquement.

Le fournisseur de Reflection for IBM

Le fournisseur Reflection for IBM fonctionne avec l’émulateur de terminal Reflection for IBM.

Paramètres de connexion

• Utiliser un profil existant (Use an existing profile) : dans ce mode, le chemin d’accès à un profil de configuration doit être fourni. L’émulateur de terminal démarre automatiquement.
• Spécifier manuellement l’adresse (Manually specify address) : dans ce mode, aucun profil de configuration n’est utilisé. Les propriétés de configuration doivent être spécifiées manuellement :
  • Adresse (Address) : adresse IP ou nom d’hôte de l’environnement système du terminal.
  • Port : numéro du port de l’environnement système du terminal. qui accepte les connexions.
  • Type (Type) - Type d'émulation de terminal nécessaire :
    • TN3270
    • TN5250
    • VT

Le fournisseur de Rocket BlueZone

Le fournisseur Rocket BlueZone fonctionne avec l’émulateur de terminal Rocket BlueZone.

Paramètres de connexion

• Utiliser un profil existant (Use an existing profile) : dans ce mode, le chemin d’accès à un profil de configuration doit être fourni. L’émulateur de terminal démarre automatiquement.
• Spécifier manuellement l’adresse (Manually specify address) : dans ce mode, aucun profil de configuration n’est utilisé. Les propriétés de configuration doivent être spécifiées manuellement :
  • Adresse (Address) - Adresse IP ou nom d'hôte du système d'environnement du terminal.
  • Port - Numéro de port où le système d'environnement du terminal accepte les connexions.
  • Type (Type) - Type d'émulation de terminal nécessaire :
    • TN3270
    • TN5250
    • VT

Le fournisseur IBM Personal Communications

Le fournisseur IBM Personal Communications fonctionne avec l'émulateur de terminal IBM Personal Communications.

Paramètres de connexion

• Utiliser un profil existant (Use an existing profile) : dans ce mode, le chemin d’accès à un profil de configuration doit être fourni. L’émulateur de terminal démarre automatiquement.