Partager via


IA-Connect Mainframe (préversion)

IA-Connect est une plateforme RPA (Robot Process Automation) qui ajoute des fonctionnalités RPA du cloud aux machines virtuelles locales ou via des connexions Citrix ou Microsoft Remote Desktop (RDS). Il s’agit du module permettant d’automatiser les sessions mainframe 5250 et 3270 à l’aide d’applications d’émulation terminal qui prennent en charge l’API HLLAPI.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Ultima Labs
URL https://www.ultima.com/ultima-labs
Messagerie électronique IAConnect@ultima.com
Métadonnées du connecteur
Éditeur Ultima Labs
Site web https://www.ultima.com/ultima-labs
Politique de confidentialité https://www.ultima.com/privacy-policy
Catégories Opérations informatiques ; Productivité

IA-Connect est une plateforme RPA (Robot Process Automation) qui ajoute des fonctionnalités RPA de Power Automate Cloud Flow à des machines virtuelles locales ou via des connexions Citrix ou Bureau à distance (RDS). Les connecteurs IA-Connect fournissent plus de 650 actions, ce qui vous permet d’automatiser chaque type d’application locale directement à partir d’un flux cloud Power Automate. Toutes les actions de IA-Connect sont disponibles directement à partir de votre flux Cloud Power Automate, ce qui facilite l’intégration entre les applications cloud et locales, la possibilité d’exploiter les conditions Power Automate existantes, les boucles, le contenu dynamique, les expressions et la gestion des exceptions dans vos processus RPA. L’utilisation des connecteurs IA-Connect fournit également un historique d’exécution complet et une auditabilité de l’historique des exécutions de flux, tout en supprimant également la nécessité d’avoir une application/console/studio distincte pour développer vos processus RPA.

Prerequisites

Pour utiliser l’un des connecteurs IA-Connect, vous devez installer le logiciel IA-Connect. Il est gratuit de tester pendant 30 jours, après quoi vous aurez besoin d’une licence IA-Connect.

Le logiciel IA-Connect se compose de deux composants principaux :

  • Le IA-Connect Orchestrator, qui est une application web Azure que vous hébergeriez dans votre propre locataire Azure. Cela gère le routage et la sécurité des flux RPA vers une ou plusieurs machines virtuelles locales ou cloud.

  • L’agent et le directeur IA-Connect, installés sur les machines virtuelles où le logiciel que vous souhaitez automatiser est accessible. En outre, l’agent IA-Connect peut s’exécuter à l’intérieur d’une session Citrix ou Microsoft Remote Desktop Services (RDS), où les commandes RPA sont transmises à un canal virtuel dans la session à distance pour l’exécution. L’agent IA-Connect peut être exécuté à partir d’un partage réseau et ne nécessite pas d’installation.

Connecteurs IA-Connect disponibles

Les connecteurs IA-Connect disponibles sont les suivants :

  • code dynamique IA-Connect
  • IA-Connect Java
  • IA-Connect Mainframe
  • IA-Connect Microsoft Office
  • IA-Connect GUI SAP
  • session IA-Connect
  • interface utilisateur IA-Connect
  • navigateur web IA-Connect

Comment obtenir des informations d’identification

Pour recevoir votre licence et commencer votre essai gratuit de 30 jours, envoyez une demande sur notre site web (https://www.ultima.com/IA-Connect/Power-Automate).

Une fois qu’une demande d’essai est reçue, nous vous contacterons via l’adresse e-mail fournie pour vous aider à configurer le logiciel IA-Connect et à vous fournir la licence d’évaluation. Il s’agit d’une version d’évaluation complète et vous permet de tester l’une des 650 actions sur les 8 connecteurs IA-Connect au sein de votre propre environnement pendant la période d’évaluation.

Bien démarrer avec votre connecteur

Après avoir envoyé une demande d’essai pour IA-Connect, vous pourrez télécharger un fichier ZIP contenant le logiciel IA-Connect et la documentation couvrant l’installation et la configuration. Nous vous contacterons également pour fournir du support et des conseils au cours du processus d’installation en fonction des besoins.

Support

Pendant la période d’essai, vous pouvez contacter Ultima Labs (IAConnect@ultima.com) pour obtenir du support et de l’aide.

Lors de l’achat de licences IA-Connect, vous recevrez des jetons de support qui peuvent être échangés pour une formation sur mesure ou un support du Centre de services techniques (TSC) basé sur Ultima au Royaume-Uni.

Problèmes connus, erreurs courantes et FAQ

Notre Base de connaissances contient un certain nombre d’articles couvrant les problèmes connus, les erreurs courantes qui peuvent se produire lors de l’utilisation des connecteurs IA-Connect et des questions fréquemment posées. Il est accessible au https://support.ultima.com/ultimalabs niveau du compte et un compte pour accéder à ces ressources est fourni pendant la version d’évaluation IA-Connect et lors de l’achat d’une licence IA-Connect.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Clé d’API securestring Clé API pour cette API Vrai
adresse d’orchestrateur IA-Connect ficelle Spécifiez l’adresse IA-Connect Orchestrator sans le composant HTTP(S) Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Attendre la chaîne dans la session d’émulation de terminal

Attend qu’une chaîne spécifiée s’affiche dans la session de l’émulateur de terminal. Cette action peut être utilisée lors du déplacement entre les écrans pour vérifier que vous êtes sur l’écran approprié.

Attendre que le clavier d’émulation de terminal soit déverrouillé

Attend que l’émulateur de terminal signale que le clavier est déverrouillé. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Attendre que le système d’émulation de terminal soit prêt

Attend que l’émulateur de terminal signale que le système est prêt. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Déconnecter de la session d’émulation de terminal

Déconnecte le sous-système HLLAPI en IA-Connect cours d’exécution (IA-HLLAPI) d’un ID de session Mainframe connecté spécifié. L’ID de session est un ID attribué par l’émulateur de terminal que vous utilisez pour les connexions mainframe.

Définir la position du curseur d’émulation de terminal

Définit la position actuelle du curseur dans une session Mainframe à la position spécifiée.

Définir le paramètre de session dans la session d’émulation de terminal

Cette action définit un paramètre de session HLLAPI avancé. Cette action ne doit être utilisée que si vous êtes familiarisé avec les paramètres de session HLLAPI.

Définir l’émulation de terminal HLLAPI DLL

Démarre le sous-système IA-Connect HLLAPI (IA-HLLAPI) et le connecte à la DLL HLLAPI de l’émulateur de terminal spécifié (composant du logiciel d’émulation de terminal utilisé pour se connecter aux sessions mainframe).

Envoyer la clé de réinitialisation à la session d’émulation de terminal

Envoie une clé de réinitialisation à la session de l’émulateur de terminal. Cela réinitialise toutes les entrées et efface un état d’entrée non valide.

Envoyer un mot de passe à la session d’émulation de terminal

Envoie un mot de passe à une session Mainframe à la position actuelle du curseur. Si vous souhaitez envoyer un mot de passe à une position de curseur spécifique, vous pouvez utiliser l’action « Envoyer le mot de passe à la session d’émulation de terminal à la position ».

Envoyer un mot de passe à la session d’émulation de terminal à la position

Envoie un mot de passe à une session Mainframe à la position de curseur spécifiée.

Envoyer une chaîne à la session d’émulation de terminal

Envoie une chaîne à une session Mainframe à la position actuelle du curseur. Si vous souhaitez envoyer une chaîne à une position de curseur spécifique, vous pouvez utiliser l’action « Envoyer une chaîne à la session d’émulation de terminal à la position ».

Envoyer une chaîne à la session d’émulation de terminal à la position

Envoie une chaîne à une session Mainframe à la position de curseur spécifiée.

Get est le clavier d’émulation de terminal déverrouillé

Retourne si l’émulateur de terminal signale que le clavier est déverrouillé. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Get Terminal Emulation Operator Information Area (OIA)

Retourne la zone d’informations de l’opérateur affichée par l’émulateur de terminal. Il s’agit de la ligne située en bas de l’écran de l’émulateur de terminal et indique généralement les informations d’état telles que si le système attend ou est dans un état d’entrée non valide.

Interroger l’état de la session d’émulation du terminal

Retourne des informations sur la session mainframe connectée. Certains émulateurs de terminal peuvent ne pas retourner de valeurs pour toutes les sorties.

Lire les lignes de l’écran d’émulation de terminal

Lit les lignes d’écran d’une session Mainframe spécifiée. Cette action est couramment utilisée pour lire de grandes quantités de données qui peuvent ensuite être filtrées si nécessaire.

Obtenir la position du curseur d’émulation de terminal

Obtient la position actuelle du curseur dans une session mainframe.

Obtenir l’état de la connexion d’émulation de terminal

Retourne l’état de connexion d’émulation de terminal actuel dans la session spécifiée.

Rechercher une chaîne dans la session d’émulation de terminal

Recherche une chaîne spécifiée dans l’affichage actuel de l’émulateur de terminal. Si la chaîne est trouvée, sa position et son index sont retournés.

Réinitialiser la session d’émulation de terminal

Réinitialise la session mainframe actuelle. L’action déconnecte IA-Connect Agent de la session et annule les paramètres de session qui ont été définis. Après avoir appelé cette action, vous devez vous reconnecter à la session à l’aide de l’action « Se connecter à la session » pour continuer à interagir avec celle-ci.

Se connecter à la session d’émulation de terminal

Connecte tout sous-système HLLAPI en IA-Connect cours d’exécution (IA-HLLAPI) à l’ID de session Mainframe connecté spécifié. L’ID de session est un ID attribué par l’émulateur de terminal que vous utilisez pour les connexions mainframe. La session Mainframe doit être en cours d’exécution avant de vous y connecter à l’aide de cette action.

Supprimer la DLL HLLAPI de l’émulation de terminal

Arrête tout sous-système HLLAPI en cours d’exécution IA-Connect (IA-HLLAPI).

Écran d’émulation du terminal en lecture à la position du curseur

Lit le nombre spécifié de caractères de la session Mainframe, en commençant à la position de curseur spécifiée.

Attendre la chaîne dans la session d’émulation de terminal

Attend qu’une chaîne spécifiée s’affiche dans la session de l’émulateur de terminal. Cette action peut être utilisée lors du déplacement entre les écrans pour vérifier que vous êtes sur l’écran approprié.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Chaîne de recherche
SearchString True string

Chaîne à attendre.

Écran entier de la recherche
SearchEntireScreen boolean

L’écran entier doit-il être recherché ? Si la valeur est false, les entrées « Index de ligne de démarrage de la recherche » et « Index de colonne de démarrage de la recherche » peuvent être utilisées pour restreindre la zone de recherche.

Index de ligne de début de recherche
SearchStartRowIndex integer

Index de ligne à partir duquel commencer la recherche de la chaîne spécifiée, à partir de 1. Cette valeur n’est utilisée que si l’option « Rechercher dans l’écran entier » a la valeur false.

Index de colonne de début de recherche
SearchStartColIndex integer

Index de colonne auquel commencer la recherche de la chaîne spécifiée, à partir de 1. Cette valeur n’est utilisée que si l’option « Rechercher dans l’écran entier » a la valeur false.

Secondes à attendre
SecondsToWait True double

Nombre maximal de secondes à attendre l’affichage de la chaîne spécifiée.

Secondes delta à attendre
DeltaSecondsToWait double

Nombre de secondes entre chaque recherche de la chaîne spécifiée.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Chaîne trouvée
StringFound boolean

Retourne true si la chaîne spécifiée a été trouvée avant la période d’attente maximale.

Position de la chaîne trouvée
StringFoundPosition integer

Si la chaîne a été trouvée, ce paramètre conserve la position absolue du premier caractère dans la chaîne de recherche. Par exemple, en supposant une session de 24 lignes par 80 colonnes, la position est retournée comme 321 si la chaîne a été trouvée dans la première colonne de la cinquième ligne, car la cinquième ligne contiendrait des positions 321 à 400.

Index de ligne trouvé par chaîne
StringFoundRowIndex integer

Si la chaîne a été trouvée, ce paramètre contient l’index de ligne du premier caractère de la chaîne de recherche.

Index de colonne trouvé par chaîne
StringFoundColIndex integer

Si la chaîne a été trouvée, ce paramètre contient l’index de colonne du premier caractère de la chaîne de recherche.

Attendre que le clavier d’émulation de terminal soit déverrouillé

Attend que l’émulateur de terminal signale que le clavier est déverrouillé. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Paramètres

Nom Clé Obligatoire Type Description
Secondes à attendre
SecondsToWait True double

Nombre maximal de secondes à attendre que l’émulateur de terminal signale que le clavier est déverrouillé.

Secondes delta à attendre
DeltaSecondsToWait double

Nombre de secondes entre chaque requête et l’émulateur de terminal pour vérifier l’état du déverrouillage du clavier.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Le clavier est déverrouillé
KeyBoardIsUnlocked boolean

Retourne true si l’émulateur de terminal signale que le clavier est déverrouillé.

Attendre que le système d’émulation de terminal soit prêt

Attend que l’émulateur de terminal signale que le système est prêt. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Paramètres

Nom Clé Obligatoire Type Description
Secondes à attendre
SecondsToWait True double

Nombre maximal de secondes à attendre que l’émulateur de terminal signale que le système est prêt.

Secondes delta à attendre
DeltaSecondsToWait double

Nombre de secondes entre chaque requête et l’émulateur de terminal pour vérifier l’état du système.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Le système est prêt
SystemReady boolean

Retourne true si l’émulateur de terminal signale que le système est prêt.

Déconnecter de la session d’émulation de terminal

Déconnecte le sous-système HLLAPI en IA-Connect cours d’exécution (IA-HLLAPI) d’un ID de session Mainframe connecté spécifié. L’ID de session est un ID attribué par l’émulateur de terminal que vous utilisez pour les connexions mainframe.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Définir la position du curseur d’émulation de terminal

Définit la position actuelle du curseur dans une session Mainframe à la position spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Index de ligne du curseur
CursorRowIndex True integer

Index de ligne du curseur auquel définir le curseur.

Index de colonne de curseur
CursorColIndex True integer

Index de colonne de curseur auquel définir le curseur.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Définir le paramètre de session dans la session d’émulation de terminal

Cette action définit un paramètre de session HLLAPI avancé. Cette action ne doit être utilisée que si vous êtes familiarisé avec les paramètres de session HLLAPI.

Paramètres

Nom Clé Obligatoire Type Description
Paramètre
Parameter True string

Paramètre(s) HLLAPI à définir. Plusieurs paramètres peuvent être séparés par des virgules ou des espaces.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Définir l’émulation de terminal HLLAPI DLL

Démarre le sous-système IA-Connect HLLAPI (IA-HLLAPI) et le connecte à la DLL HLLAPI de l’émulateur de terminal spécifié (composant du logiciel d’émulation de terminal utilisé pour se connecter aux sessions mainframe).

Paramètres

Nom Clé Obligatoire Type Description
Nom de fichier DLL HLLAPI
DLLFilename True string

Chemin complet du fichier vers la DLL HLLAPI fournie par l’émulateur.

nom de fichier IA-HLLAPI
IAHLLAPIPath string

Emplacement facultatif de la DLL COM IA-HLLAPI 32 bits utilisée comme interface COM pour la DLL HLLAPI spécifiée (uniquement si la DLL HLLAPI est de 32 bits). Cela n’est généralement pas obligatoire, car IA-Connect a une DLL HLLAPI intégrée nommée « IA-HLLAPI ». DLL utilisée pour configurer l’interface COM sur la DLL HLLAPI de l’émulateur. Par défaut, IA-Connect extrait ceci dans le répertoire «%TEMP%\IA-Connect » dans le profil de l’utilisateur.

Nom du point d’entrée
EntryPointName string

Nom du point d’entrée DLL. Cela varie en fonction du logiciel d’émulateur utilisé et s’il reste vide, IA-Connect essaie les points d’entrée courants suivants : hllapi, HLLAPI, HLLAPI32, EHLLAPI, EHLLAPI32.

Interface améliorée
IsEnhancedInterface boolean

Ce paramètre doit être défini sur true si la DLL utilise l’interface améliorée HLLAPI.

DLL HLLAPI 64 bits
Is64BitHLLAPIDLL boolean

Ce paramètre doit être défini sur true si la DLL HLLAPI que vous essayez de charger est de 64 bits.

Utiliser COM pour la DLL HLLAPI 64 bits
UseCOMFor64BitHLLAPIDLL boolean

Défini sur true si la DLL HLLAPI que vous essayez de charger est de 64 bits et que vous souhaitez l’exécuter via une DLL COM hors processus au lieu d’appeler directement (en mémoire) à partir d’IA-Connect.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Envoyer la clé de réinitialisation à la session d’émulation de terminal

Envoie une clé de réinitialisation à la session de l’émulateur de terminal. Cela réinitialise toutes les entrées et efface un état d’entrée non valide.

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Envoyer un mot de passe à la session d’émulation de terminal

Envoie un mot de passe à une session Mainframe à la position actuelle du curseur. Si vous souhaitez envoyer un mot de passe à une position de curseur spécifique, vous pouvez utiliser l’action « Envoyer le mot de passe à la session d’émulation de terminal à la position ».

Paramètres

Nom Clé Obligatoire Type Description
Mot de passe d’entrée
InputPassword True password

Mot de passe à entrer. Cela prend en charge un ensemble complet de symboles clavier, par exemple « @E » pour entrée.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Envoyer un mot de passe à la session d’émulation de terminal à la position

Envoie un mot de passe à une session Mainframe à la position de curseur spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Index de ligne du curseur
CursorRowIndex True integer

Index de ligne de curseur actuel.

Index de colonne de curseur
CursorColIndex True integer

Index de colonne de curseur actuel.

Mot de passe d’entrée
InputPassword True password

Mot de passe à entrer. Cela prend en charge un ensemble complet de symboles clavier, par exemple « @E » pour entrée.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Envoyer une chaîne à la session d’émulation de terminal

Envoie une chaîne à une session Mainframe à la position actuelle du curseur. Si vous souhaitez envoyer une chaîne à une position de curseur spécifique, vous pouvez utiliser l’action « Envoyer une chaîne à la session d’émulation de terminal à la position ».

Paramètres

Nom Clé Obligatoire Type Description
Chaîne d’entrée
InputString True string

Chaîne à entrer. Cela prend en charge un ensemble complet de symboles clavier, par exemple « @E » pour entrée.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Envoyer une chaîne à la session d’émulation de terminal à la position

Envoie une chaîne à une session Mainframe à la position de curseur spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Index de ligne du curseur
CursorRowIndex True integer

Index de ligne de curseur actuel.

Index de colonne de curseur
CursorColIndex True integer

Index de colonne de curseur actuel.

Chaîne d’entrée
InputString True string

Chaîne à entrer. Cela prend en charge un ensemble complet de symboles clavier, par exemple « @E » pour entrée.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Get est le clavier d’émulation de terminal déverrouillé

Retourne si l’émulateur de terminal signale que le clavier est déverrouillé. La sortie de cette action dépend de la façon dont l’émulateur spécifique a implémenté HLLAPI et la sortie peut varier de l’émulateur à l’émulateur.

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Le clavier est déverrouillé
KeyBoardIsUnlocked boolean

Retourne true si l’émulateur de terminal signale que le clavier est déverrouillé.

Get Terminal Emulation Operator Information Area (OIA)

Retourne la zone d’informations de l’opérateur affichée par l’émulateur de terminal. Il s’agit de la ligne située en bas de l’écran de l’émulateur de terminal et indique généralement les informations d’état telles que si le système attend ou est dans un état d’entrée non valide.

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Format OIA
OIAFormat string

Format OIA (Operator Information Area), par exemple PC400.

Attente du système
SystemWait boolean

Retourne true si l’émulateur de terminal signale que le système attend actuellement la fin d’une action, ou false si ce n’est pas le cas.

CASQUETTES
CAPS boolean

Retourne true si l’émulateur de terminal signale que la touche CAPS est actuellement enfoncée ou false si ce n’est pas le cas.

Touche majuscule
ShiftKey boolean

Retourne true si l’émulateur de terminal signale que la touche Maj est actuellement enfoncée ou false si ce n’est pas le cas.

Sous-système prêt
SubsystemReady boolean

Retourne la valeur true si l’émulateur de terminal signale que le sous-système est prêt ou false si ce n’est pas le cas.

Mode d’insertion
InsertMode boolean

Retourne true si l’émulateur de terminal signale que le mode d’insertion est actuellement activé, ou false si ce n’est pas le cas.

entrée non valide
InvalidInput boolean

Retourne true si l’émulateur de terminal signale que la session mainframe est actuellement dans un état d’entrée non valide ou false si ce n’est pas le cas.

Type d’entrée
InputType string

Type d’entrée de session mainframe. Il peut s’agir d’APL, Katakana, Alphanumérique, Hiragana ou Double octet.

Interroger l’état de la session d’émulation du terminal

Retourne des informations sur la session mainframe connectée. Certains émulateurs de terminal peuvent ne pas retourner de valeurs pour toutes les sorties.

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Nom long de session
SessionLongName string

Nom long de la session mainframe, par exemple SessionA.

Type de session
SessionType string

Type de session Mainframe, par exemple 3270 ou 5250.

Nombre de lignes
NumberOfRows integer

Nombre de lignes dans l’affichage.

Nombre de colonnes
NumberOfCols integer

Nombre de colonnes dans l’affichage.

Page de codes
CodePage integer

Page de codes, indiquant l’encodage de caractères utilisé.

Lire les lignes de l’écran d’émulation de terminal

Lit les lignes d’écran d’une session Mainframe spécifiée. Cette action est couramment utilisée pour lire de grandes quantités de données qui peuvent ensuite être filtrées si nécessaire.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Démarrer l’index de ligne
StartRowIndex True integer

Index de ligne de début à partir duquel commencer la lecture.

Index de ligne de fin
EndRowIndex True integer

Index de ligne de fin à arrêter la lecture.

Nombre de lignes dans la session
NumberOfRowsInSession integer

Nombre de lignes affichées par la session. Si la valeur est 0, IA-Connect interroge la session pour récupérer le nombre de lignes.

Nombre de colonnes dans la session
NumberOfColumnsInSession integer

Nombre de colonnes affichées par la session. Si la valeur est 0, IA-Connect interroge la session pour récupérer le nombre de colonnes.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Lignes d’écran JSON
ScreenRowsJSON string

Les lignes lues à partir de la session Mainframe, au format JSON.

Obtenir la position du curseur d’émulation de terminal

Obtient la position actuelle du curseur dans une session mainframe.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Index de ligne du curseur
CursorRowIndex integer

Index de ligne de curseur actuel.

Index de colonne de curseur
CursorColIndex integer

Index de colonne de curseur actuel.

Position du curseur
CursorPos integer

Position absolue du curseur. Par exemple, en supposant une session de 24 lignes par 80 colonnes, la première colonne de la première ligne serait la position 1 et la première colonne de la deuxième ligne serait la position 81.

Obtenir l’état de la connexion d’émulation de terminal

Retourne l’état de connexion d’émulation de terminal actuel dans la session spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Connecté à la session
ConnectedToSession boolean

Retourne true si vous êtes connecté à l’ID de session spécifié, ou false si ce n’est pas le cas.

Système occupé
SystemBusy boolean

Retourne true si le système mainframe signale qu’il est actuellement occupé ou false si ce n’est pas le cas.

Clavier verrouillé
KeyboardLocked boolean

Retourne true si la session Mainframe signale que le clavier est actuellement verrouillé ou false si ce n’est pas le cas.

Session utilisée par une autre application HLLAPI
SessionInUseByAnotherHLLAPIApplication boolean

Retourne true si la session mainframe est actuellement utilisée par une autre application HLLAPI, ou false si ce n’est pas le cas.

HLLAPI thread ID
HLLAPIThreadID integer

Signale l’ID de thread HLLAPI dans IA-Connect. Cette sortie est uniquement à des fins de diagnostic.

COM thread ID
COMThreadID integer

Signale l’ID de thread COM dans IA-Connect. Cette sortie est uniquement à des fins de diagnostic.

Nombre d’appels
CallCount integer

Signale le nombre d’actions HLLAPI effectuées par IA-Connect dans cette session. Cette sortie est uniquement à des fins de diagnostic.

Rechercher une chaîne dans la session d’émulation de terminal

Recherche une chaîne spécifiée dans l’affichage actuel de l’émulateur de terminal. Si la chaîne est trouvée, sa position et son index sont retournés.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Chaîne de recherche
SearchString True string

Chaîne à rechercher.

Écran entier de la recherche
SearchEntireScreen boolean

L’écran entier doit-il être recherché ? Si la valeur est false, les entrées « Index de ligne de démarrage de la recherche » et « Index de colonne de démarrage de la recherche » peuvent être utilisées pour restreindre la zone de recherche.

Index de ligne de début de recherche
SearchStartRowIndex integer

Index de ligne à partir duquel commencer la recherche de la chaîne spécifiée, à partir de 1. Cette valeur n’est utilisée que si l’option « Rechercher dans l’écran entier » a la valeur false.

Index de colonne de début de recherche
SearchStartColIndex integer

Index de colonne auquel commencer la recherche de la chaîne spécifiée, à partir de 1. Cette valeur n’est utilisée que si l’option « Rechercher dans l’écran entier » a la valeur false.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Chaîne trouvée
StringFound boolean

Retourne true si la chaîne spécifiée a été trouvée.

Position de la chaîne trouvée
StringFoundPosition integer

Si la chaîne a été trouvée, ce paramètre conserve la position absolue du premier caractère dans la chaîne de recherche. Par exemple, en supposant une session de 24 lignes par 80 colonnes, la position est retournée comme 321 si la chaîne a été trouvée dans la première colonne de la cinquième ligne, car la cinquième ligne contiendrait des positions 321 à 400.

Index de ligne trouvé par chaîne
StringFoundRowIndex integer

Si la chaîne a été trouvée, ce paramètre contient l’index de ligne du premier caractère de la chaîne de recherche.

Index de colonne trouvé par chaîne
StringFoundColIndex integer

Si la chaîne a été trouvée, ce paramètre contient l’index de colonne du premier caractère de la chaîne de recherche.

Réinitialiser la session d’émulation de terminal

Réinitialise la session mainframe actuelle. L’action déconnecte IA-Connect Agent de la session et annule les paramètres de session qui ont été définis. Après avoir appelé cette action, vous devez vous reconnecter à la session à l’aide de l’action « Se connecter à la session » pour continuer à interagir avec celle-ci.

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Se connecter à la session d’émulation de terminal

Connecte tout sous-système HLLAPI en IA-Connect cours d’exécution (IA-HLLAPI) à l’ID de session Mainframe connecté spécifié. L’ID de session est un ID attribué par l’émulateur de terminal que vous utilisez pour les connexions mainframe. La session Mainframe doit être en cours d’exécution avant de vous y connecter à l’aide de cette action.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Supprimer la DLL HLLAPI de l’émulation de terminal

Arrête tout sous-système HLLAPI en cours d’exécution IA-Connect (IA-HLLAPI).

Paramètres

Nom Clé Obligatoire Type Description
Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Écran d’émulation du terminal en lecture à la position du curseur

Lit le nombre spécifié de caractères de la session Mainframe, en commençant à la position de curseur spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID session
SessionID True string

ID de session mainframe à caractère unique, par exemple A.

Index de ligne du curseur
CursorRowIndex True integer

Index de ligne de curseur actuel.

Index de colonne de curseur
CursorColIndex True integer

Index de colonne de curseur actuel.

Nombre de caractères à lire
ReadScreenLength True integer

Nombre de caractères à lire à partir de la session Mainframe.

Flux de travail
Workflow True string

Ajoutez l’expression suivante ici : workflow()

Retours

Nom Chemin d’accès Type Description
Contenu de l’écran
ScreenContents string

Contenu de l’écran lu à partir de la session Mainframe.