Kofax RPA permet de se connecter à des terminaux 3270, 5250, 6530 et aux terminaux de flux (vt100 et ANSI) et d'interagir avec eux.

Le délai d'attente de la commande pour l'automatisation des terminaux est fixé soit dans l'onglet Desktop Automation de la fenêtre Paramètres Design Studio pour l'exécution du workflow dans Design Studio, ou dans la section Dispositif d'automatisation de l'onglet Sécurité de la fenêtre Paramètres du RoboServer pour l'exécution de RoboServer. Voir Exécution > Sécurité dans le Guide de l'administrateur Kofax RPA.

Polices de caractères

Kofax RPA regroupe plusieurs polices de caractères pour que les terminaux puissent afficher leurs écrans. Elles se trouvent ici :

C:\Program Files\Kofax RPA 11.3.0\nativelib\hub\windows-x32\XXX\fonts

où XXX est un nombre de trois chiffres à des fins internes.

Si une connexion de terminal est établie avec un hôte qui utilise des caractères qui ne se trouvent pas dans les polices groupées, les caractères sont remplacés par des carrés sur l'écran. Ce problème peut être résolu en ajoutant le chemin d'accès à une police Truetype dans le fichier fontlist.txt qui se trouve dans le même répertoire des polices Kofax RPA. Par exemple :

C:\TerminalFonts\MyTerminalFont.ttf

Terminaux tn6530

Pour vous connecter aux terminaux 6530, insérez l'étape Terminal, sélectionnez Nonstop (tn6530) et spécifiez tous les paramètres nécessaires, tels que le type de connexion, les identifiants et les options de connexion.

Kofax RPA émule un terminal TN6530-8 avec un affichage 80 x 24. Le terminal démarre en mode conversationnel.

Support clavier

Les touches 6530 suivantes sont prises en charge en mode Bloc protégé :

• Retour, Maj + Retour, Ctrl + Retour

• Origine, Ctrl + Origine

• Fin

• Retour arrière

• Tab, Maj + Tab

• Insérer, Alt + Insérer, Ctrl + Insérer

• Supprimer, Alt + Supprimer, Ctrl + Supprimer

• Alt + 2, Maj + Alt + 2

• Touches du curseur

• Touches de fonction F1-F16. (Pour la compatibilité, les touches Alt+F1 – F6 sont également associées à F11-F16)

• Touches de fonction 6530 : Alt + Haut, Alt + Bas, Page préc.,Alt + Page préc., Page suiv., Alt + Page suiv.

Kofax RPA prend en charge les touches 6530 suivantes en mode conversationnel :

• Retour, Maj + Retour

• Touches de fonction F1-F16. (Pour la compatibilité, les touches Alt+F1 - F6 sont également associées à F11-F16)

En outre, les touches calculées suivantes sont prises en charge :

• VK_CLOSE

  Cette touche met fin à la session et ferme le terminal tn6530.

• VK_F11 - VK_F16

  Ces touches offrent une alternative aux combinaisons de touches Alt+F1 – Alt+F6 6530 associées aux touches de fonction F11 – F16.

Options de connexion

Les options de connexion sont spécifiées dans le champ Options de l'étape Terminal. Les options sont divisées par l'esperluette (&). La chaîne d'option peut contenir des caractères d'échappement pourcentage (%).

Par exemple, NetworkTrace=MyLogfile.log&LineBuffer=2048

L'action tn6530 Se connecter permet de se connecter au service Telnet (port 23), à moins qu'un autre port soit explicitement spécifié dans le champ Hôte, par exemple, TerminalHost:11625.

Les options suivantes sont prises en charge :

• NetworkTrace=<fichier journal>

  Crée un fichier de trace contenant toutes les données échangées avec l'hôte.

• ColorMap=<mappe de couleurs>

  Configure le terminal pour la prise en charge des couleurs et fournit éventuellement la mappage de couleurs par défaut.

• LineBuffer=<lignes>

  Définit le nombre de lignes mises en mémoire tampon du terminal. Ces lignes sont disponibles pour la pagination/le défilement. Les valeurs acceptées sont comprises entre 24 et 65536. Si aucune valeur n'est pas spécifiée, le terminal conserve une mémoire tampon de 1 024 lignes (mode conversationnel uniquement).

L'action ssh6530 Se connecter (SSH) se connecte au service SSH (port 22), à moins qu'un autre port soit explicitement spécifié dans le champ Hôte, par exemple, TerminalHost:11625. Les identifiants de connexion SSH peuvent être spécifiés à l'aide de l'option Identifiants dans l'étape Terminal.

Les options suivantes sont prises en charge :

• SessionFile=<modèle>

  Configure le fichier de configuration par défaut PuTTY. Si cette option est omise, le fichier session.plink dans le répertoire bin est utilisé.

• PublicKeyFile=<fichier>

  Fournit un fichier de clé SSH pour l'authentification. Ce fichier doit être au format de clé privée PuTTY.

• SSHUser=<utilisateur>

  Utilisateur SSH. Ce paramètre remplace le nom d'utilisateur dans le champ Nom d'utilisateur de l'étape. Si aucun utilisateur n'est spécifié, le robot reçoit une invite de manière interactive.

• SSHPassword=<mot de passe>

  Mot de passe SSH. Ce paramètre remplace le mot de passe dans le champ Mot de passe de l'étape. Si cette option est omise, le robot reçoit une invite de manière interactive.

• SSHHostKey=<clé d'hôte>

  Configure la clé d'hôte SSH identifiant l'hôte. Si ce paramètre est utilisé et que la valeur ne correspond pas à la clé d'hôte envoyée par l'hôte, la connexion est rejetée.

  Si ce paramètre est omis et qu'aucune clé d'hôte n'est configurée par le biais du fichier de configuration PuTTY, le robot reçoit une invite de manière interactive et doit gérer cette boîte de dialogue pour accepter la clé. Notez que le robot ignore les paramètres du registre Windows et ne stocke pas les clés d'hôte.

• SSHLog=<fichier journal>

  Active la journalisation au niveau SSH à des fins de dépannage.

• NetworkTrace=<fichier journal>

  Crée un fichier de trace contenant toutes les données échangées avec l'hôte.

• ColorMap=<mappe de couleurs>

  Configure le terminal pour la prise en charge des couleurs et fournit éventuellement la mappage de couleurs par défaut.

• LineBuffer=<lignes>

  Définit le nombre de lignes mises en mémoire tampon du terminal. Ces lignes sont disponibles pour la pagination/le défilement. Les valeurs acceptées sont comprises entre 24 et 65536. Si aucune valeur n'est pas spécifiée, le terminal conserve une mémoire tampon de 1 024 lignes (mode conversationnel uniquement).

Toutes les autres options sont utilisées pour remplacer les paramètres du modèle SessionFile. Les options qui ne sont pas définies dans le modèle SessionFile sont ignorées.

Les paramètres logfile effectuent les substitutions suivantes lors de la création d'un fichier journal :

Expression rationnelle	Remplacement	Exemples
$P	PID du processus qui exécute le robot (la valeur dépend de la plate-forme).	12928
$T	Heure UTC au format Unix epoch.	1524649335
$D	Heure locale au format ISO 8601.	20180425T114215
$H	Adresse IP de l'hôte.	127.0.0.1
$P	Port de l'hôte.	22
$$	Un seul signe dollar ($).	$

Prise en charge des couleurs

Le paramètre ColorMap= fait passer le terminal du mode Monochrome au mode Couleur non configurable. L'hôte peut mettre à jour la mappe de couleurs en envoyant des codes d'échappement. La mappe de couleurs initiale peut être configurée dans la chaîne de connexion en fournissant une chaîne de 32 octets au format hexadécimal spécifiant la mappe de couleurs pour les 32 combinaisons d'attributs. Consultez la documentation 6530 pour la description du schéma de mappage attributs-couleurs.

Problèmes connus et limitations

• La prise en charge du mode conversationnel et du mode Bloc non protégé est limitée.

• La prise en charge étendue des couleurs et le mode EM3270 ne sont pas disponibles.

• Les commandes qui effectuent des opérations locales sur le terminal ne sont pas prises en charge.

Les séquences d'échappement et les clés non prises en charge sont suivies du marqueur **ERRORS: dans la ligne de message.

Activités d'application

Le menu Activité d'application est disponible lorsque vous cliquez avec le bouton droit de la souris sur l'onglet de terminal dans la Vue de l'enregistreur. Le menu contient les options suivantes pour les terminaux tn6530.

Activité	Description
Fermer	Ferme la fenêtre du terminal.
Aller à(ligne, col)	Place le curseur dans l'emplacement spécifié en fonction des coordonnées de ligne/colonne utilisées dans l'arborescence d'application. Les paramètres sont facultatifs pour permettre un déplacement horizontal et vertical fluide.

Terminaux tn5250

Pour vous connecter aux terminaux 5250, insérez l'étape Terminal sélectionnez iSeries (tn5250) et spécifiez tous les paramètres nécessaires, tels que le nom d'hôte, le type de connexion et les options de connexion. Pour ne pas utiliser le port par défaut, indiquez-le dans le champ Hôte, par exemple TerminalHost:11625.

Options de connexion

Les options de connexion sont spécifiées dans le champ Options de l'étape Terminal. Les options sont divisées par l'esperluette (&). La chaîne d'option peut contenir des caractères d'échappement pourcentage (%).

env.TERM est la valeur du type de terminal client après le changement de mode par l'URL. Le type de terminal par défaut est « IBM-3179-2 ». Notez que le paramètre env.TERM n'est valide que pour le terminal tn5250. Kofax RPA prend en charge les types de terminaux suivants :

• « IBM-3477-FC »

• « IBM-3477-FG »

• « IBM-3180-2 »

• « IBM-3179-2 » (par défaut)

• « IBM-3196-A1 »

• « IBM-5292-2 »

• « IBM-5291-1 »

• « IBM-5251-11 »

• « IBM-5555-B01 » (DBCS activé)

• « IBM-5555-C01 » (DBCS activé)

Kofax RPA prend en charge les terminaux en mode 80 x 24 et 132 x 27.

Le terminal 5250 utilisait un clavier spécial avec de nombreuses touches qui ne sont pas disponibles sur les claviers des PC actuels. Pour entrer ces touches, utilisez les touches calculées suivantes dans l'étape Appuyer sur une touche.

• VK_RETURN

• VK_ENTER

• VK_TAB

• VK_BACKTAB

• VK_UP

• VK_DOWN

• VK_LEFT

• VK_RIGHT

• VK_CLEAR

• VK_BACKTAB

• VK_F1

• VK_F2

• VK_F3

• VK_F4

• VK_F5

• VK_F6

• VK_F7

• VK_F8

• VK_F9

• VK_F10

• VK_F11

• VK_F12

• VK_F13

• VK_F14

• VK_F15

• VK_F16

• VK_F17

• VK_F18

• VK_F19

• VK_F20

• VK_F21

• VK_F22

• VK_F23

• VK_F24

• VK_ROLLDN

• VK_ROLLUP

• VK_BACK

• VK_HOME

• VK_END

• VK_INSERT

• VK_DELETE

• VK_RESET

• VK_PRINT

• VK_HELP

• VK_SYSREQ

• VK_CLEAR

• VK_REFRESH

• VK_FIELDEXIT

• VK_TESTREQ

• VK_TOGGLE

• VK_ERASE

• VK_ATTENTION

• VK_DUPLICATE

• VK_FIELDMINUS

• VK_FIELDPLUS

• VK_PREVWORD

• VK_NEXTWORD

• VK_PREVFLD

• VK_NEXTFLD

• VK_FIELDHOME

• VK_EXEC

• VK_MEMO

• VK_COPY_TEXT

• VK_PASTE_TEXT

• VK_NEWLINE

• VK_ERASE_EOF

• VK_KANJI

Pour plus d'informations, consultez la documentation du terminal 5250.

Pour faciliter l'automatisation, Kofax RPA a ajouté les touches suivantes :

• VK_VIRTUAL_FIELDEXIT

  Cette touche fonctionne comme VK_FIELDEXIT, mais seulement si le curseur ne se trouve pas à la première position d'un champ. Vous pouvez l'utiliser pour quitter un champ s'il n'est pas complètement rempli, mais elle supprime FieldExit si le curseur vient de passer au champ suivant.

• VK_DBCS_SPACE

  Tape un espace DBCS.

Codage des caractères

Pour spécifier le codage des caractères de l'hôte, ajoutez un paramètre LineCodePage dans le champ Options. Par exemple : LineCodePage=cp838

Pour les terminaux tn5250, Kofax RPA prend en charge toutes les pages de codes EBCDIC prises en charge par la bibliothèque ICU. Le paramètre LineCodePage doit correspondre au paramètre de page de codes de l'émulateur de terminal utilisé pour se connecter à l'hôte ou à la valeur de la propriété QCHRID de la session de terminal.

Des pages de codes fréquemment utilisées sont répertoriées dans ce tableau.

Jeu de caractères	Page de code de l'hôte
États-Unis/Canada	cp037 (par défaut)
Multinational	cp500
Thaï	cp838
Japonais	cp930, cp939
Chinois simplifié	cp935
Coréen	cp933
EBCDIC 273 avec la mise à jour de la devise Euro	cp1141

Affectation des dispositifs

Par défaut, l'hôte 5250 attribue le premier dispositif disponible compatible avec le type de terminal demandé ou essaie de créer un dispositif. Si le robot doit se connecter à un dispositif donné, ajoutez un paramètre env.DEVNAME=<device> dans le champ Options. Par exemple, pour vous connecter au dispositif DEVROBOT sur l'hôte iSeries :

env.DEVNAME=DEVROBOT

Si le dispositif demandé n'existe pas ou ne prend pas en charge le type de terminal, ou qu'il est éteint/en cours d'utilisation, la connexion échoue.

Prise en charge de l'interface étendue 5250

Pour activer l'interface étendue des postes de travail non programmables sur l'hôte, ajoutez le paramètre de requête enhanced=on dans le champ Options.

Ce paramètre permet de prendre en charge les champs de saisie continue.

Les fenêtres DirectDraw Surface et les fonctions graphiques ne sont pas prises en charge lorsque l'interface étendue est activée.

Activités d'application

Le menu Activité d'application est disponible lorsque vous cliquez avec le bouton droit de la souris sur l'onglet de terminal dans la Vue de l'enregistreur. Le menu contient les options suivantes pour les terminaux tn5250.

Activité	Description
Fermer	Ferme la fenêtre du terminal.
Aller à(ligne, col)	Place le curseur dans l'emplacement spécifié en fonction des coordonnées de ligne/colonne utilisées dans l'arborescence d'application. Les paramètres sont facultatifs pour permettre un déplacement horizontal et vertical fluide.
Saisir un champ (texte)	Saisit le texte spécifié dans un champ et passe au champ suivant en utilisant la touche [FieldExit].

3270 Terminaux

Kofax RPA prend en charge le terminal 3279-4 couleur 80 x 43, qui est la valeur par défaut de l'émulateur de terminal sous-jacent.

Le terminal 3270 utilisait un clavier spécial dont certaines touches ne sont pas disponibles sur les claviers des PC actuels. Pour entrer ces touches, les touches calculées suivantes peuvent être utilisées dans le Appuyer sur une touche.

• VK_RETURN

• VK_TAB

• VK_BACKTAB

• VK_Up

• VK_Down

• VK_Left

• VK_Right

• VK_F1

• VK_F2

• VK_F3

• VK_F4

• VK_F5

• VK_F6

• VK_F7

• VK_F8

• VK_F9

• VK_F10

• VK_F11

• VK_F12

• VK_F13

• VK_F14

• VK_F15

• VK_F16

• VK_F17

• VK_F18

• VK_F19

• VK_F20

• VK_F21

• VK_F22

• VK_F23

• VK_F24

• VK_ATTENTION

• VK_BACKSPACE

• VK_CLEAR

• VK_DELETE

• VK_DUPLICATE

• VK_HOME

• VK_INSERT

• VK_PA1

• VK_PA2

• VK_PA3

Codage des caractères

Pour spécifier le codage des caractères de l'hôte, ajoutez un paramètre charset dans le champ Options. Par exemple :

charset=cp930

Kofax RPA prend en charge les jeux de caractères suivants pour les terminaux tn3270 :

Nom du caractère	Page de code de l'hôte
belge	500
euro belge	1148
crochet	037
brésilien	275
chinois gb18030	1388
cp1047	1047
cp870	870
finnois	278
euro finnois	1143
français	297
euro français	1147
allemand	273
euro allemand	1141
grec	423
hébreu	424
islandais	871
euro islandais	1149
italien	280
euro italien	1144
kana japonais	930
latin japonais	939
norvégien	277
euro norvégien	1142
russe	880
chinois simplifié	935
slovène	870
espagnol	284
euro espagnol	1145
suédois	278
euro suédois	1143
thaï	1160
chinois traditionnel	937
turc	1026
r-u	285
euro r-u	1146
euro américain	1140
us-intl	037

connecttimeout

Pour spécifier le temps d'attente du pilote lorsque l'hôte est temporairement indisponible (c'est-à-dire si l'hôte est inaccessible ou que la connexion est refusée), ajoutez le paramètre connecttimeout dans le champ Options en indiquant le délai d'attente en secondes. Par exemple :

connecttimeout=5

Lorsque ce paramètre est omis, le pilote attend 20 secondes.

Si la connexion échoue pour des raisons qui ne peuvent être résolues ou que la tentative de connexion ne peut pas être réessayée (c'est-à-dire que le nom d'hôte ne peut être résolu), le pilote échoue immédiatement.

Activités d'application

Le menu Activité d'application est disponible lorsque vous cliquez avec le bouton droit de la souris sur l'onglet de terminal dans la Vue de l'enregistreur. Le menu contient les options suivantes pour les terminaux tn3270.

Activité	Description
Fermer	Ferme la fenêtre du terminal.
Aller à(ligne, col)	Place le curseur dans l'emplacement spécifié en fonction des coordonnées de ligne/colonne utilisées dans l'arborescence d'application. Les paramètres sont facultatifs pour permettre un déplacement horizontal et vertical fluide.

Paramètres SSH/Telnet (vt100 et ANSI)

Pour utiliser la connexion SSH, sélectionnez Se connecter (SSH) pour l'émulateur dans l'étape Terminal. Le client SSH sous-jacent Kofax RPA est basé sur PuTTY et peut être potentiellement configuré pour accéder à un système auquel PuTTY peut accéder. Vous pouvez configurer les mêmes paramètres que ceux d'une session PuTTY, mais au lieu d'exiger que le client PuTTY définisse les sessions, vous pouvez définir les paramètres de session en ajoutant des paramètres facultatifs dans le champ Options.

Le terminal sans interface ne détecte pas automatiquement la page de codes sur le serveur. C'est pourquoi l'envoi et la réception des caractères non-ASCII nécessitent que vous spécifiiez la page de codes à utiliser pour le codage et le décodage des caractères. Si vous ne spécifiez pas de page de codes, le robot suppose que les paramètres régionaux du serveur sont définis sur UTF-8. Vous pouvez spécifier la page de codes en utilisant le paramètre LineCodePage dans le champ Options de l'étape. Le terminal Kofax RPA est construit en utilisant « libicu » pour le codage des caractères. Utilisez l'explorateur de convertisseur libicu à l'adresse http://demo.icu-project.org/icu-bin/convexp?s=ALL pour inspecter les pages de codes et leurs alias. La liste des jeux de caractères pris en charge est identique à celle de la bibliothèque ICU (International Components for Unicode). Consultez la documentation ICU pour plus d'informations.

Voici la liste des paramètres les plus couramment utilisés pour les terminaux de flux.

TermWidth	Définit la largeur du terminal (par défaut, 80).
TermHeight	Définit la hauteur du terminal (par défaut, 24).
AutoWrap	Contrôle le retour automatique à la ligne (par défaut N). Définissez la valeur Y pour activer le retour à la ligne. Ce paramètre s'applique uniquement aux terminaux vt100.
TerminalType	Définit le type de terminal (par défaut « xterm »).
LineCodePage	Spécifie la page de codes à utiliser pour le codage et le décodage des caractères (par défaut, UTF-8).

Pour définir les paramètres de votre session, entrez-les dans le champ Options de l'étape Terminal. Les options sont divisées par l'esperluette (&).

Les options de connexion suivantes sont prises en charge.

SessionFile	Configure le fichier de configuration par défaut PuTTY. Si cette option est omise, le fichier session.plink dans le répertoire bin est utilisé.
PublicKeyFile	Fournit un fichier de clé SSH pour l'authentification. Ce fichier doit être au format de clé privée PuTTY.
SSHUser	Ce paramètre remplace le nom d'utilisateur dans la partie user@host de l'URI. Si aucun utilisateur n'est spécifié, le robot reçoit une invite de manière interactive.
Mot de passe SSHP	Ce paramètre remplace le mot de passe dans la partie user:password@host de l'URI. Si cette option est omise, le robot reçoit une invite de manière interactive.
SSHHostKey	Configure la clé d'hôte SSH identifiant l'hôte. Si ce paramètre est utilisé et que la valeur ne correspond pas à la clé d'hôte envoyée par l'hôte, la connexion est rejetée. Si ce paramètre est omis et qu'aucune clé d'hôte n'est configurée par le biais du fichier de configuration PuTTY, le robot reçoit une invite de manière interactive et doit gérer cette boîte de dialogue pour accepter la clé. Notez que le robot ignore les paramètres du registre Windows et ne stocke pas les clés d'hôte.
SSHLog	Active la journalisation au niveau SSH à des fins de dépannage.
NetworkTrace	Crée un fichier de trace contenant toutes les données échangées avec l'hôte.

Activités d'application

Le menu Activité d'application est disponible lorsque vous cliquez avec le bouton droit de la souris sur l'onglet de terminal dans la Vue de l'enregistreur. Le menu contient les options suivantes pour les terminaux vt100.

Activité	Description
Fermer	Ferme la fenêtre du terminal.

Guide d'authentification et de sécurité SSH

Lors de l'automatisation des applications utilisant SSH, l'utilisateur peut être authentifié de quatre manières différentes.

1. Le client ssh sous-jacent demande un mot de passe. Entrez le mot de passe en utilisant l'étape « Saisir du texte » suivie d'une étape « Appuyer sur une touche » (retour).
2. Une clé privée non chiffrée peut être placée sur le système de fichiers de Design Studio et de vos RoboServers. Ajoutez la ligne PublicKeyFile=<chemin de la clé> dans le champ Options de l'étape Terminal.

   Il est important que le fichier de clé ait le format PuTTY. Sous Linux, vous pouvez utiliser puttygen pour transformer une clé privée open-ssh.

3. Une clé privée chiffrée peut être placée sur le système de fichiers de Design Studio et de vos RoboServers. Ajoutez PublicKeyFile=<path to key> au champ « Options ». Le client ssh sous-jacent doit demander un mot de passe à la connexion. Pour entrer le mot de passe, utilisez l'étape « Saisir du texte » suivie d'une étape « Appuyer sur une touche » (retour).
4. Utilisez Pageant sous Windows et ssh-agent sous Linux avec une clé chiffrée sur le système de fichiers local.
   • Sous Windows, lancez Pageant en tant qu'utilisateur exécutant RoboServer et ajoutez la clé.

   • Sous Linux, exécutez ssh-agent et ssh-add et copiez les variables d'environnement SSH_AUTH_SOCK et SSH_AGENT_PID vers l'environnement RoboServer et Design Studio. Vous pouvez le faire en ajoutant les lignes suivantes à RoboServer.conf et DesignStudio.conf, comme suit.

     • set.SSH_AUTH_SOCK=<valeur produite par ssh-agent>
     • set.SSH_AGENT_PID=<valeur produite par ssh-agent>

     Ou bien, vous pouvez définir les variables d'environnement avant de lancer le RoboServer et Design Studio.

Les méthodes d'authentification ci-dessus sont répertoriées ci-dessous, de la moins sûre à la plus sûre.

1. Un utilisateur qui peut lire le robot peut extraire le mot de passe et se connecter au système.
2. L'attaquant doit disposer de la clé privée de votre système de fichiers. Il ne suffit donc pas d'obtenir le robot à partir d'une Management Console.
3. L'attaquant à besoin à la fois du robot et du fichier de clé privée.
4. L'attaquant doit obtenir le mot de passe de la clé privée pour obtenir un accès.

Utiliser TLS/SSL

Kofax RPA prend en charge la communication TLS/SSL dans les terminaux. Pour utiliser TLS/SSL, utilisez le terminal stn3270 ou stn5250 dans l'étape Terminal, indiquez le nom d'hôte ou l'adresse IP avec un numéro de port approprié et sélectionnez Connexion sécurisée. Notez que Kofax RPA ne vérifie pas le certificat présenté par le serveur.