Actions d’émulation du terminal
Power Automate assure l’intégration avec des émulateurs de terminal via les actions Émulation de terminal. Ces actions vous permettent de gérer les terminaux et les ordinateurs centraux et d’y effectuer diverses opérations, comme le déplacement du curseur, la définition et l’obtention de texte et l’envoi de touches.
Avant de déployer des actions de terminal, utilisez l’action Ouvrir une session de terminal pour ouvrir une nouvelle connexion avec le fournisseur installé.
Important
Avant d’essayer de vous connecter à une session de terminal, assurez-vous que celle actuelle est déjà ouverte sur votre ordinateur.
Si vous avez installé Micro Focus Reflection sur votre machine, choisissez l’option correspondante dans le paramètre Fournisseur de l’action et remplissez la configuration requise.
Si vous avez installé un autre fournisseur, sélectionnez HLLAPI qui fonctionne avec la plupart des fournisseurs d’émulation de terminal.
Selon le fournisseur que vous utilisez, sélectionnez le fichier DLL HLLAPI approprié situé dans son dossier d’installation. Dans la liste suivante, vous pouvez voir les noms de fichiers HLLAPI DLL de certains fournisseurs d’émulation de terminal populaires :
- RocketSoftware BlueZone : ehlapi64.dll
- IBM Personal Communications : EHLAPI32.dll
- MicroFocus Rumba : System/ehlapi32.Dll
- Cybelesoft zScope : zHllap32.dll
Note
Actuellement, la DLL Windows HLLAPI (WinHLLAPI) n’est pas prise en charge.
Après avoir ouvert une session de terminal et effectué toutes les opérations souhaitées, mettez fin à la connexion à l’aide de l’action Fermer la session de terminal. Si vous ne fermez pas la connexion, certains fournisseurs ne vous permettront pas de vous reconnecter à la session déjà ouverte sans redémarrer le logiciel ou la connexion.
Ouvrir une session de terminal
Ouvrir une nouvelle session de terminal.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Fournisseur | N/A | Réflexion Micro focus, HLLAPI | Réflexion Micro focus | Émulation du terminal à utiliser |
| Chemin d’accès à HLLAPI DLL | Non | Fichier | Le DLL HLLAPI du fournisseur. Nom par défaut de RocketSoftware BlueZone : « ehlapi64.dll ». Nom par défaut d’IBM Personal Communications : « EHLAPI32.dll ». Chemin par défaut de MicroFocus Rumba : « System/ehlapi32.Dll ». Nom par défaut de Cybelesoft zScope : « zHllap32.dll ». Tout autre fournisseur qui propose une DLL HLLAPI dans son dossier d’installation. | |
| Chemin d’accès à l’installation | Non | Dossier | Chemin d’accès à l’installation de l’application du fournisseur sur le système de fichiers de l’utilisateur | |
| configuration | N/A | Profil existant, Spécifier la connexion | Profil existant | Choisissez « Profil existant » pour sélectionner un fichier contenant une connexion d’émulation de terminal préconfigurée. Choisissez « Spécifier la connexion » pour spécifier le type de connexion, l’adresse de l’hôte et le port. |
| Nom de la session | Non | Valeur de texte | Nom de la session à laquelle se connecter. Le nom court HLLAPI, il s’agit d’un identificateur unique pour la session hôte. Il se trouve dans les paramètres de configuration de l’émulateur de terminal. | |
| Type d’hôte | N/A | IBM 3270, IBM 5250 | IBM 3270 | Type d’hôte de la connexion |
| Profil | Non | Fichier | Fichier contenant la connexion préconfigurée | |
| Adresse de l’hôte | Non | Valeur de texte | Adresse de l’hôte à laquelle se connecter | |
| Port | Non | Valeur numérique | Port à utiliser pour cette connexion | |
| Joindre à la session en cours d’exécution | N/A | Valeur booléenne | Faux | Indique s’il convient de joindre ou non la pièce à une session de terminal actuellement ouverte/en cours d’exécution. |
Variables produites
| Argument | Type | Description |
|---|---|---|
| TerminalSession | Session de terminal | Session de terminal spécifique à utiliser avec les commandes d’émulation de terminal ultérieures |
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Erreur de profil | Erreur de profil |
Fermer une session de terminal
Fermer une session de terminal ouverte.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal à fermer | Non | Session de terminal | Session de terminal précédemment ouverte |
Variables produites
Cette action ne produit aucune variable.
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
Déplacer le curseur sur la session du terminal
Déplacer le curseur du terminal à la position spécifiée.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session du terminal à utiliser | |
| Ligne | Non | Valeur numérique | Position verticale du curseur à l’écran | |
| Column | Non | Valeur numérique | Position horizontale du curseur à l’écran |
Variables produites
Cette action ne produit aucune variable.
Exceptions
| Exception | Description |
|---|---|
| Position de l’écran hors des limites | Indique que la position de l’écran est en dehors des limites. |
| Les commandes de position utilisées ne sont pas prises en charge par l’émulateur. | Indique que les commandes de position utilisées ne sont pas prises en charge par l’émulateur. |
| L’opération n’est pas disponible pour ce type de session. | Indique que l’opération n’est pas disponible pour ce type de session. |
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
Obtenir le texte d’une session de terminal
Obtenez du texte à partir d’une session de terminal.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session du terminal à utiliser | |
| Récupérer le texte de | N/A | Champ, Écran entier, Position du curseur, Position spécifique | Champ | Emplacement à partir duquel obtenir le texte |
| Obtenir un champ par | N/A | Étiquette, Index, Position | Label | Indique comment rechercher le champ. |
| Label | Non | Valeur de texte | Étiquette du champ à rechercher | |
| Index | Non | Valeur numérique | Index du champ à rechercher | |
| Longueur du texte | Non | Valeur numérique | Longueur du texte à recevoir | |
| Ligne | Non | Valeur numérique | Position verticale du champ à l’écran | |
| Column | Non | Valeur numérique | Position horizontale du champ à l’écran |
Variables produites
| Argument | Type | Description |
|---|---|---|
| TerminalText | Valeur de texte | Texte récupéré de la session du terminal |
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Index de champ hors limites | Indique que l’index de champ est en dehors des limites. |
| Étiquette de champ introuvable | Indique que l’étiquette de champ n’existe pas. |
| Position de l’écran hors des limites | Indique que la position de l’écran est en dehors des limites. |
| Aucun champ n’a été trouvé au poste donné. | Indique qu’aucun champ n’existe à l’emplacement donné. |
| L’écran de terminal n’est pas formaté. | Indique que l’écran du terminal n’est pas formaté. |
| Les commandes de position utilisées ne sont pas prises en charge par l’émulateur. | Indique que les commandes de position utilisées ne sont pas prises en charge par l’émulateur. |
| L’opération n’est pas disponible pour ce type de session. | Indique que l’opération n’est pas disponible pour ce type de session. |
Définir le texte sur une session de terminal
Définissez le texte sur une session de terminal.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session du terminal à utiliser | |
| Text | Non | Saisie directe chiffrée ou valeur de texte | Texte à définir sur l’emplacement spécifié | |
| Définir le texte | S.O. | Position du curseur, Champ | Champ | Emplacement où définir le texte |
| Obtenir un champ par | N/A | Étiquette, Index, Position | Label | Spécifie la manière de rechercher le champ |
| Label | Non | Valeur de texte | Étiquette du champ à rechercher | |
| Index | Non | Valeur numérique | Index du champ à l’écran | |
| Ligne | Non | Valeur numérique | Position verticale du champ à l’écran | |
| Column | Non | Valeur numérique | Position horizontale du champ à l’écran | |
| Traiter le caractère « @ » comme une valeur littérale | S.O. | Valeur booléenne | False | Cocher cette case pour envoyer le caractère « @ » de manière littérale. Laisser cette option désactivée pour l’envoyer en tant que caractère spécial |
Variables produites
Cette action ne produit aucune variable.
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Index de champ hors limites | Indique que l’index de champ est en dehors des limites. |
| Étiquette de champ introuvable | Indique que l’étiquette de champ n’existe pas. |
| Position de l’écran hors des limites | Indique que la position de l’écran est en dehors des limites. |
| Aucun champ n’a été trouvé au poste donné. | Indique qu’aucun champ n’existe à l’emplacement donné. |
| L’écran de terminal n’est pas formaté. | Indique que l’écran du terminal n’est pas formaté. |
| Les commandes de position utilisées ne sont pas prises en charge par l’émulateur. | Indique que les commandes de position utilisées ne sont pas prises en charge par l’émulateur. |
| L’opération n’est pas disponible pour ce type de session. | Indique que l’opération n’est pas disponible pour ce type de session. |
| Le texte en entrée a été rejeté. | Indique que le texte en entrée a été rejeté. |
Envoyer une clé à la session de terminal
Envoyer une clé de contrôle à une session de terminal.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session du terminal à utiliser | |
| Clé de contrôle | N/A | Transmettre, Curseur Alt, Attention, Retour arrière, Tabulation arrière, Activer/Désactiver le bloc, Pause, Annuler, Centrer, Effacer, Effacer comm, Effacer affichage, Effacer ligne, Effacer page, Effacer partition, Virgule, Ligne de commande, Fenêtre de commande, Rédiger, Ctrl+F1, Ctrl+F2, Ctrl+F3, Ctrl+F4, Ctrl+F5, Ctrl+F6, Ctrl+F7, Ctrl+F8, Ctrl+F9, Ctrl+F10, Ctrl+F11, Ctrl+F12, Ctrl+Maj+F1, Ctrl+Maj+F2, Ctrl+Maj+F3, Ctrl+Maj+F4, Ctrl+Maj+F5, Ctrl+Maj+F6, Ctrl+Maj+F7, Ctrl+Maj+F8, Ctrl+Maj+F9, Ctrl+Maj+F10, Ctrl+Maj+F11, Ctrl+Maj+F12, Curseur clignotant, Sélection du curseur, Décimal, Supprimer, Supprimer le caractère, Supprimer la ligne, Supprimer le mot, Espace arrière destructif, Déconnecter, Faire, Bas, Double vers le bas, Dup, Dupliquer, Modifier script, Fin de clé, Fin de champ, Effacer fin de champ, Effacer fin de ligne, Effacer fin de page, Effacer entrée, Echap, ExtGr, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F26, F27, F28, F29, F30, F31, F32, F33, F34, F35, F36, F37, F38, F39, F40, F41, F42, F43, F44, F45, F46, F47, F48, Délimiteur de champ, Sortie de champ, Marque de champ, Champ moins, Champ plus, Rechercher, Réinitialisation matérielle, Aide, Hex, Hex 00, Hex 01, Hex 02, Hex 03, Hex 04, Hex 05, Hex 06, Hex 07, Hex 08, Hex 09, Hex 0A, Hex 0B, Hex 0C, Hex 0D, Hex 0E, Hex 0F, Hex 10, Hex 11, Hex 12, Hex 13, Hex 14, Hex 15, Hex 16, Hex 17, Hex 18, Hex 19, Hex 1A, Hex 1B, Hex 1C, Hex 1D, Hex 1E, Hex 1F, Hex 7F, Maintenir, Maintenir Effacer, Maintenir Set, Début, Début bas, Début haut, Insérer, Insérer un caractère, Insérer ici, Insérer une ligne, Mode insertion, Touche non valide,Pavé numérique0, Pavé numérique 1, Pavé numérique 2, Pavé numérique 3, Pavé numérique 4, Pavé numérique 5, Pavé numérique 6, Pavé numérique 7, Pavé numérique 8, Pavé numérique 9, Gauche, Double gauche, Saut de ligne, Moins, Basculer écran, Nouvelle ligne, Page suivante, Écran suivant, Mot suivant, Nul, Verr.Num., PA1, PA2, PA3, Page, Page suivante, Page précédente, Panoramique à gauche, Panoramique à droite, Saut de partition, PF1, PF2, PF3, PF4, Plus Cr, Mot précédent, Page précédente, Écran précédent, Imprimer, Imprimer ligne, Imprimer msg, Écran précédent, Supprimer, Remplacer, Réinitialiser, Retour, Champ réservé, Droite, Double à droite, Déployer vers le bas, Déployer vers le haut, Ligne à droite, Exécuter le script, Défiler vers le bas, Défiler vers la gauche, Défiler vers la droite, Défiler vers le haut, Sélectionner, Envoyer, Envoyer une réponse, Envoyer la suppression, Envoyer la ligne, Envoyer un message, Maj+Retour arrière, Maj+Supprimer, Maj+Bas, Maj+F1, Maj+F2, Maj+F3, Maj+F4, Maj+F5, Maj+F6, Maj+F7, Maj+F8, Maj+F9, Maj+F10, Maj+F11, Maj+F12, Maj+F13, Maj+F14, Maj+F15, Maj F16, Maj+F17, Maj+F18, Maj+F19, Maj+F20, Maj+Début, Maj+Insertion, Maj+Gauche, Maj+Imprimer écran, Maj+Droite, Maj+Haut, Réinitialisation logicielle, Requête système, Tabulation, Zoom Tek, Terme page suivante, Terme page précédente, Test, Début du mode Text Assist en gras, Début de ligne du mode Text Assist, Début soulignement du mode Texte Assist, Bas de page mode Text Assist, Retour chariot mode Text Assist, Centrer mode Text Assist, Centrer mode Text Assist, Fin de ligne du mode Text Assist, Demi-index vers le bas mode Text Assist, Demi-index vers le haut mode Text Assist, Insérer des symboles mode Text Assist, Arrêt suivant mode Text Assist, Colonne de texte suivante mode Text Assist, Fin de page mode Text Assist, Espace requis mode Texte Assist, Onglet requis mode Text Assist, Arrêt mode Text Assist, Onglet avancé Texte mode Text Assist, Haut de page mode Text Assist, Soulignement des mots mode Text Assist, Activer/Désactiver la trace, Udk 10, Udk 6, Udk 7, Udk 8, Udk 9, Udk 11, Udk 12, Udk 13, Udk 14, Udk 15, Udk 16, Udk 17, Udk 18, Udk 19, Udk 20, Haut, Double vers le haut | Transmettre | Clé à envoyer à la session |
Variables produites
Cette action ne produit aucune variable.
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Clé non prise en charge | Indique que la clé n’est pas prise en charge. |
Attendre le texte sur la session de terminal
Attendre l’affichage d’un texte spécifique dans une session de terminal.
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session de terminal précédemment ouverte | |
| Texte à attendre | Non | Valeur de texte | Texte ou expression régulière à attendre avant d’apparaître sur l’écran du terminal ou sur un champ spécifié | |
| Expression régulière | N/A | Valeur booléenne | Faux | Spécifie si une expression régulière doit être attendue à la place d’un texte brut. |
| Attendre l’emplacement du texte | N/A | Écran, Champ | Écran | Emplacement d’attente de l’affichage du texte |
| Obtenir un champ par | N/A | Étiquette, Index, Position | Label | Spécifie la manière de rechercher le champ |
| Label | Non | Valeur de texte | Étiquette du champ à rechercher | |
| Index | Non | Valeur numérique | Index du champ à rechercher | |
| Ligne | Non | Valeur numérique | Position verticale du champ à l’écran | |
| Column | Non | Valeur numérique | Position horizontale du champ à l’écran | |
| Délai d’attente | Oui | Valeur numérique | 0 | Durée d’attente maximale |
Note
Le moteur d’expressions régulières de Power Automate est .NET. Pour plus d’informations concernant les expressions régulières, accédez à Langage d’expression régulière - Référence rapide.
Variables produites
Cette action ne produit aucune variable.
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Index de champ hors limites | Indique que l’index de champ est en dehors des limites. |
| Étiquette de champ introuvable | Indique que l’étiquette de champ n’existe pas. |
| Position de l’écran hors des limites | Indique que la position de l’écran est en dehors des limites. |
| Aucun champ n’a été trouvé au poste donné. | Indique qu’aucun champ n’existe à l’emplacement donné. |
| L’écran de terminal n’est pas formaté. | Indique que l’écran du terminal n’est pas formaté. |
| Les commandes de position utilisées ne sont pas prises en charge par l’émulateur. | Indique que les commandes de position utilisées ne sont pas prises en charge par l’émulateur. |
| L’opération n’est pas disponible pour ce type de session. | Indique que l’opération n’est pas disponible pour ce type de session. |
| Délai expiré | Indique que le délai a expiré. |
Rechercher du texte dans la session de terminal
Rechercher toutes les occurrences d’un texte spécifique dans une session de terminal
Paramètres d’entrée
| Argument | Facultatif | Accepte | Valeur par défaut | Description |
|---|---|---|---|---|
| Session de terminal | Non | Session de terminal | Session de terminal précédemment ouverte | |
| Texte à rechercher | Non | Valeur de texte | Texte ou expression régulière à rechercher sur l’écran de terminal | |
| Expression régulière | S.O. | Valeur booléenne | False | Spécifie si une expression régulière doit être recherchée à la place d’un texte brut |
| Taille de colonne | Non | Valeur numérique | 80 | Nombre de colonnes sur l’écran du terminal |
Note
Le moteur d’expressions régulières de Power Automate est .NET. Pour plus d’informations concernant les expressions régulières, accédez à Langage d’expression régulière - Référence rapide.
Variables produites
| Argument | Type | Description |
|---|---|---|
| FindResults | Table de données | Résultats de la recherche récupérés à partir de l’écran de session de terminal |
Exceptions
| Exception | Description |
|---|---|
| Erreur de communication avec l’émulateur | Indique un problème de connexion à l’émulateur. |
| Texte introuvable | Indique que le texte recherché est introuvable |
| Expression régulière non valide | Indique que l’expression régulière utilisée n’est pas valide |