Macros et terminal hôte

Une macro est un script XML qui définit un ensemble d'écrans. Chaque écran inclut une description, les actions à effectuer pour cet écran, et le ou les écrans qui peuvent être présentés une fois les actions exécutées.

HATS prend en charge la personnalisation par macro pour accélérer et personnaliser le processus applicatif hôte. Il est possible d'utiliser une macro pour les fonctions suivantes :

Vous pouvez utiliser des macros pour effectuer tout ou partie des opérations suivantes :

Saut d'écran
Les macros de saut d'écran sont des macros de navigation qui font passer l'utilisateur d'un écran à un autre sans afficher les écrans intermédiaires.
Invite
Les macros d'invite contiennent des étapes permettant de demander aux utilisateurs d'entrer des données au cours de la session hôte. Elles peuvent également définir des invites à partir d'une liste d'utilisateurs. Par exemple, vous pouvez utiliser une macro d'invite pour demander à un utilisateur de fournir son ID utilisateur et son mot de passe lorsqu'il veut se connecter à une application hôte.
Remarque :
Les invites de liste des utilisateurs ne peuvent servir que dans les macros de connexion.

Les macros d'invite peuvent également être utilisées par les développeurs pour fournir des valeurs ou des valeurs d'événements obtenues à partir de variables globales.

Extraction
Les macros d'extraction contiennent des événements qui permettent d'extraire des informations d'écran hôte sous la forme d'une chaîne, d'une liste de chaînes ou d'une table. Par exemple, vous pouvez utiliser une macro d'extraction pour établir la connexion à une application hôte de type annuaire et extraire les résultats d'une recherche effectuée dans l'annuaire.

Les macros enregistrées ou importées dans HATS Toolkit sont sauvegardées dans un fichier de macros HATS (.hma). Vous pouvez voir les macros définies dans votre projet en développant le noeud Macros de la vue Projets HATS de HATS Toolkit.

HATS propose trois éditeurs différents qui servent à consulter et modifier des macros HATS : Macro Editor, Advanced Macro Editor et Visual Macro Editor. Visual Macro Editor est l'éditeur par défaut pour les macro HATS. Quand vous cliquez deux fois sur le nom d'une macro, Visual Macro Editor s'ouvre. Pour plus d'informations sur Visual Macro Editor, voir le chapitre, Visual Macro Editor, du document HATS Advanced Macro Guide.

Pour ouvrir Macro Editor, cliquez avec le bouton droit sur le nom de la macro, puis sélectionnez Ouvrir avec > Macro Editor.

Advanced Macro Editor s'ouvre à partir de la page Présentation de Macro Editor. Pour plus d'informations sur Advanced Macro Editor, voir le chapitre Advanced Macro Editor du document HATS Advanced Macro Guide.

Remarque :
La prise en charge de Macro Editor et de Advanced Macro Editor est obsolète dans HATS V7.5.1. Pour l'instant, la prise en charge est toujours assurée, mais IBM se réserve le droit de ne pas inclure ces fonctions dans les prochaines éditions du produit. Vous pouvez utiliser Visual Macro Editor à la place.

Macro Editor

Les sections suivantes décrivent les différents onglets de l'éditeur de macro.

Présentation

L'onglet Présentation de l'éditeur de macro récapitule les informations générales sur la macro, telles que le nom, la description et la date et l'heure de la dernière modification. Les éléments que vous pouvez modifier dans cet onglet sont la description de la macro, la durée de la pause, le délai et la connexion.

Le paramètre Durée de la pause indique le délai en millisecondes après l'exécution de chaque action. Le paramètre Délai indique le délai d'attente en millisecondes avant l'arrêt de la macro et le paramètre Connexion vous permet de sélectionner la connexion à utiliser dans le menu déroulant.

Les boutons Affichage de l'écran du terminal hôte et Editeur avancé sont décrits en détails ci-après.

Figure 63. Enregistrement d'une macro HATS
Enregistrement d'une macro à l'aide du terminal hôte

Affichage de l'écran du terminal hôte

Vous pouvez cliquer sur le bouton Affichage de l'écran du terminal hôte pour créer ou utiliser votre macro à l'aide du terminal hôte. Une fois l'écran du terminal affiché, vous pouvez utiliser toutes les icônes de la barre d'outils supérieure pour enregistrer et créer votre macro.

Terminal hôte

Vous pouvez également utiliser l'option Terminal hôte pour modifier une macro précédemment enregistrée en cliquant avec le bouton droit de la souris sur le noeud approprié de l'arborescence et en sélectionnant Edition. Si vous sélectionnez un écran à modifier, cela lance l'éditeur de critères de reconnaissance d'écran, qui va vous permettre de modifier votre écran. Si vous choisissez de modifier une entrée que vous avez faites dans votre écran, une fenêtre s'affiche et vous permet de modifier cette entrée. Si vous éditez le noeud Ecrans suivants, une liste d'écrans disponibles s'affiche, dans laquelle vous pouvez sélectionner l'écran suivant. Effectuez votre sélection dans l'ordre dans lequel vous souhaitez voir apparaître les écrans.

Pour le débogage des erreurs d'exécution des macros, quatre icônes sont proposées dans la barre d'outils Terminal hôte. Ces icônes vous aident à avancer étape par étape dans une macro, chaque étape consistant à exécuter une action ou à reconnaître un écran. Ces icônes sont les suivantes : Exécuter pas à pas, Exécuter jusqu'à la ligne suivante, Revenir en arrière et Reprendre.

Des touches de fonction sont associées à chacune de ces icônes. En fonction de la vue active (Navigateur de macro ou Terminal hôte), les touches F5, F6, F7 et F8 ont des comportements différents. Par exemple, si la vue Navigateur de macro est active, la touche F5 entraîne l'action Exécuter pas à pas et la touche F6 l'action Exécuter jusqu'à la ligne suivante. Si la vue Terminal hôte est active et que vous appuyez sur la touche F5 ou F6, la touche AID est envoyée à l'hôte. Pour plus d'informations sur ces icônes et les autres icônes liées aux macros, voir Icônes liées aux macros.

Remarque :
Remarques :
  1. HATS exige que vous définissiez des critères de reconnaissance d'écran pour certains écrans. Ces écrans sont les suivants :
  2. Les fonctions Couper, Copier et Coller sont fournies dans le terminal hôte à l'aide des combinaisons de touches suivantes :

Le tableau 4 indique les icônes de macro qui apparaissent dans la barre d'outils de l'écran du terminal hôte.

Tableau 4. Icônes de macro
Icône Description
Affichage de macro
Affichage d'une macro. Sélectionnez une macro dans la liste déroulante.
Exécution de macro
Exécution d'une macro. Sélectionnez une macro dans la liste déroulante.
Enregistrer une macro
Début de l'enregistrement d'une macro
Arrêter une macro
Arrêt de l'enregistrement d'une macro
Sauvegarder une macro
Sauvegarde de la macro enregistrée
Exécuter pas à pas
Exécution pas à pas (F5) de la macro dans le cadre du débogage
Exécuter jusqu'à la ligne suivante
Exécution de la macro jusqu'à la ligne suivante (F6) dans le cadre du débogage
Revenir en arrière
Retour en arrière (F7) dans la macro à des fins de débogage
Reprendre
Reprise (F8) de l'exécution de la macro
Définir les critères de reconnaissance d'écran
Définition des critères de reconnaissance d'écran pour l'écran d'une macro
Action Ajouter une invite
Ajout d'une invite dans la macro en cours (icône activée uniquement dans le cadre de l'enregistrement d'une macro)
Action Ajouter une extraction
Ajout d'une extraction dans la macro en cours (icône activée uniquement dans le cadre de l'enregistrement d'une macro)
Enregistrer une boucle
Enregistrement d'une boucle dans la macro en cours (icône activée uniquement dans le cadre de l'enregistrement d'une macro)
Actions Ajouter une invite pour toutes les zones
Ajout d'invites dans la macro en cours pour toutes les zones de l'écran (icône activée uniquement dans le cadre de l'enregistrement d'une macro)
Actions Ajouter une extraction pour toutes les zones
Ajout d'extractions dans la macro en cours pour toutes les zones de l'écran (icône activée uniquement dans le cadre de l'enregistrement d'une macro)
Afficher/Masquer le bloc de touches
Affichage/masquage du bloc de touches dans la fenêtre du terminal hôte
Afficher/Masquer la zone d'informations opérateur textuelle
Affichage/masquage de la zone d'informations opérateur textuelle
Icônes liées aux macros

Vous trouverez ci-après la liste des icônes associées aux macros figurant dans la barre d'outils de la vue Terminal hôte.

Enregistrement de macro

Vous pouvez enregistrer des macros dans HATS Toolkit à l'aide du terminal hôte HATS. Sur l'écran du terminal hôte HATS, cliquez sur l'icône Enregistrer une macro. L'assistant d'enregistrement de macro s'affiche alors et vous permet de nommer la macro, d'en donner une description et d'indiquer où elle doit être sauvegardée. L'option Créer des saisies d'écran automatiquement pendant l'enregistrement vous permet d'indiquer que vous souhaitez qu'une saisie d'écran soit automatiquement créée pour chaque écran affiché, lors de l'enregistrement de la macro. Ces caputres d'écran peuvent, par la suite, être utilisées dans Visual Macro Editor, si vous devez, par la suite, apporter des modifications à la macro. Cette option est sélectionnée par défaut. Cliquez sur Fin lorsque vous avez défini tous ces éléments.

La fenêtre Définition de critères de reconnaissance d'écran s'affiche ensuite car HATS force le premier écran à définir explicitement la reconnaissance d'écran. Vous pouvez ensuite utiliser l'écran du terminal hôte HATS pour naviguer vers n'importe quel écran de l'application hôte.

Si une macro est déjà ouverte dans le terminal hôte HATS, l'icône Enregistrer une macro demande si vous souhaitez enregistrer une nouvelle macro ou effectuer un ajout dans la macro ouverte. Si vous effectuez un ajout dans la macro ouverte, l'enregistrement de la macro commence et les actions sont ajoutées à la macro en cours. L'emplacement du début de l'enregistrement au sein de la macro dépend de la sélection effectuée dans l'arborescence Navigateur de macro située sur la gauche et de la correspondance de l'écran de terminal en cours avec les critères de reconnaissance d'écran du noeud sélectionné. Plus particulièrement :

Ne créez pas de macro dont la seule étape consiste à insérer une extraction ou à ajouter une invite. Si vous le faites, lorsque l'utilisateur fournit une valeur, la page ne change pas et l'utilisateur n'a aucun moyen de passer à une autre page. Si une macro ne revient vers l'hôte, elle arrivera à expiration et deviendra inactive.

Remarque :
Si vous envisagez de créer un objet d'intégration à partir d'une macro, veillez à nommer la macro en respectant les consignes ci-après.
  • Le nom de la macro doit contenir uniquement des lettres, des chiffres ou des traits de soulignement.
  • Le premier caractère du nom ne peut pas être une valeur numérique.
  • Les caractères DBCS ne sont pas autorisés.
Arrêter une macro
Lorsque vous avez fini d'enregistrer votre macro, cliquez sur l'icône Arrêter une macro.
Sauvegarder une macro
Une fois l'enregistrement de la macro terminé, vous devez la sauvegarder en cliquant sur l'icône Sauvegarder une macro.
Exécuter pas à pas (F5)
Cliquez sur l'icône Exécuter pas à pas pour passer d'un écran à la première action qu'il inclut, et d'action en action. Vous pouvez également appuyer sur la touche F5 du clavier pour mettre en oeuvre la même fonction. Cette fonction est utilisée dans le cadre du débogage.
Exécuter jusqu'à la ligne suivante (F6)
Cliquez sur Exécuter jusqu'à la ligne suivante pour passer d'écran en écran (en effectuant toutes les actions associées). Vous pouvez également appuyer sur la touche F6 du clavier pour mettre en oeuvre la même fonction. Cette fonction est utilisée dans le cadre du débogage.
Revenir en arrière (F7)
Cliquez sur Revenir en arrière pour mettre fin à l'exécution des actions dans un écran et passer à l'écran suivant. Vous pouvez également appuyer sur la touche F7 du clavier pour mettre en oeuvre la même fonction. Cette fonction est utilisée dans le cadre du débogage.
Reprendre (F8)
Pour reprendre l'exécution de la macro, vous pouvez soit cliquer sur l'icône Reprendre, soit appuyer sur la touche F8 du clavier. Vous pouvez par exemple utiliser cette fonction pour exécuter le reste de la macro si vous l'exécuter étape par étape.
Définir les critères de reconnaissance d'écran

Vous pouvez définir les critères de reconnaissance d'écran que HATS utilise pour établir les correspondances avec les écrans hôte. La reconnaissance des écrans hôte peut s'effectuer via n'importe quelle combinaison de critères, notamment le nombre de zones d'entrée ou le nombre total de zones de l'écran, les coordonnées du curseur et les chaînes de texte présentes dans un rectangle défini ou n'importe où dans l'écran. Pour plus d'informations, voir Critères de reconnaissance d'écran ou Début d'écran.

Action Ajouter une invite

Si vous voulez que la macro invite l'utilisateur à fournir des informations, cliquez sur l'icône Action Ajouter une invite pour afficher l'assistant Action Ajout d'une invite. Vous pouvez affecter un nom et une valeur par défaut à l'invite. Si les informations fournies par l'utilisateur, telles que le mot de passe, ne doivent pas être affichées sur l'écran hôte, cochez la case Saisie protégée du mot de passe.

Remarque :
Les valeurs par défaut que vous spécifiez pour les invites sont stockées dans les fichiers de macros non cryptés. Les valeurs par défaut s'affichent en clair lorsque vous éditez les invites dans les éditeurs de macro. Par conséquent, bien qu'utiliser une invite pour demander un mot de passe soit une bonne solution, vous ne devez pas, pour des raisons de sécurité, spécifier de valeur par défaut pour le mot de passe.

Les zones Ligne et Colonne de la section Position de l'assistant définissent l'endroit de l'écran hôte où les informations fournies par l'utilisateur à l'invite doivent être placées. Si vous placez le curseur à un endroit de l'écran hôte tel qu'une zone de mot de passe avant de commencer à enregistrer la macro, les zones Ligne et Colonne sont complétées avec les valeurs correspondantes. La section Traitement de l'invite de macro de l'assistant vous permet de déterminer comment l'invite doit être traitée. Vous pouvez sélectionner un des boutons d'option suivants :

Afficher le gestionnaire
Pour les projets Web HATS, vous pouvez sélectionner un fichier .jsp pour inviter l'utilisateur à fournir les informations nécessaires et inclure un bouton pour que l'utilisateur puisse envoyer ces informations. Un gestionnaire de macros par défaut, nommé default.jsp, est fourni avec HATS. Vous pouvez trouver ce fichier en cliquant sur la vue Projets HATS de HATS Toolkit, et en développant le nom du projet puis Contenu Web > Gestionnaires d'événements de macro. Si vous voulez créer votre propre gestionnaire, assurez-vous de rendre le contrôle au contexte d'exécution HATS.
Remarques :
  1. Les objets d'intégration ignorent le gestionnaire .jsp sélectionné. A la place, une page en entrée est créée pour l'objet d'intégration et une invite de la valeur est placée dans cette page en entrée. La page en sortie générée copie la valeur fournie par la page en entrée dans l'objet d'intégration avant l'exécution de ce dernier.
  2. L'option Afficher le gestionnaire est désactivée lorsque la macro est extraite à partir d'un plan autre que le plan de texte.
Remarque :

Pour les projets HATS client enrichi, vous pouvez spécifier un gestionnaire de macros personnalisé ou le sélectionner dans la liste des gestionnaires de macros personnalisés définis dans le projet de client enrichi, pour inviter l'utilisateur à fournir les informations nécessaires et inclure un bouton pour que l'utilisateur puisse envoyer ces informations. Un gestionnaire de macros par défaut, nommé DefaultMacroHandler, est fourni avec HATS. Vous pouvez trouver ce fichier en cliquant sur la vue Projets HATS et en développant le nom du projet, puis Contenu du client enrichi > Gestionnaires d'événements de macros. Si vous voulez créer votre propre gestionnaire, veillez à rendre le contrôle au module d'exécution HATS en appelant les méthodes createButtonArea() et createButtons() dans la méthode render() de votre gestionnaire de macros personnalisé. Ces méthodes sont appelées dans l'implémentation par défaut de la méthode RcpMacroHandler.render(). Pour plus d'informations sur RcpMacroHandler, voir la section relative à l'interface API de plateforme client enrichi HATS dans le centre de documentation HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.

Définir l'invite à l'aide d'une chaîne
Si vous connaissez la valeur qui doit être affichée dans l'invite, vous pouvez entrer cette chaîne dans la zone Chaîne.
Définir l'invite à l'aide d'une variable globale
Si vous voulez que la valeur de l'invite soit fournie par une variable globale, entrez un nom de variable globale dans la zone Nom ou sélectionnez une variable existante dans le menu déroulant figurant en regard de la zone Variable globale. Si vous cliquez sur le bouton Paramètres avancés, vous pouvez préciser si votre variable est partagée ou indexée. S'il s'agit d'une variable indexée, vous devez également indiquer si vous voulez afficher tous les index ou un seul. Pour plus d'informations, voir Interaction avec les variables globales.
Remarque :

Si une valeur d'invite est fondée sur une variable globale définie par une extraction et que promptall prend la valeur true, l'action d'extraction n'est pas exécutée avant la récupération des valeurs d'invite. Par conséquent, la variable globale employée par l'invite ne contient pas de valeur. Si vous utilisez des variables globales avec des extractions et des invites, vous devez attribuer la valeur false à promptall.

Les objets d'intégration n'accèdent pas directement aux variables globales. A la place, les pages en entrée et en sortie associées extraient la valeur de la variable globale et la définissent dans l'objet d'intégration avant qu'il ne soit exécuté. Les objets d'intégration ne peuvent accéder qu'aux variables globales partagées.

Définir l'invite d'une propriété à partir de la liste des utilisateurs
Si vous voulez que l'invite accède à une liste d'utilisateurs, sélectionnez le Profil utilisateur dans la liste déroulante. Le profil utilisateur est la clé qui permet de déterminer s'il faut utiliser l'ID utilisateur (userid) ou le mot de passe (password) comme Propriété de la liste des utilisateurs. Pour plus d'informations, voir Liste des utilisateurs.
Remarque :
Les invites de liste des utilisateurs ne peuvent servir que dans les macros de connexion.
Utiliser Web Express Logon
Si vous avez configuré votre application HATS pour utiliser Web Express Logon, sélectionnez ID utilisateur ou Mot de passe dans la liste déroulante Type d'invite et entrez l'ID de l'application dans la zone ID de l'application.
Remarque :
Le Type d'invite doit être prérempli avec la valeur correcte.

Cliquez sur OK lorsque vous avez fait vos sélections.

Action Ajouter une extraction

Si vous voulez que la macro extraie des informations de l'écran hôte, sélectionnez une zone de l'écran hôte, puis cliquez sur Action Ajouter une extraction pour afficher l'assistant Action Ajout d'une extraction. Vous pouvez affecter un nom à l'extraction. Les zones Ligne de début, Colonne de début, Ligne de fin et Colonne de fin de la section Position de l'assistant définissent l'endroit de l'écran hôte d'où les informations sont extraites. Lorsque vous marquez une zone de l'écran hôte avec un rectangle, puis que vous cliquez sur Action Ajout d'une extraction, les zones de la section Position sont complétées avec les valeurs correspondantes lorsque l'assistant Action Ajout d'une extraction s'affiche.

Vous pouvez sélectionner une des options suivantes comme Format d'extraction :

La section Gestion de l'extraction de macro de l'assistant vous permet de déterminer comment l'extraction doit être traitée. Vous pouvez cocher les cases suivantes :

Afficher le gestionnaire
Pour les applications Web HATS, vous pouvez sélectionner un fichier .jsp pour présenter les informations extraites à l'utilisateur. Un gestionnaire de macro par défaut, nommé default.jsp, est fourni avec HATS. Vous pouvez trouver ce fichier en cliquant sur la vue Projets HATS et en développant le nom du projet puis Contenu Web > Gestionnaires d'événements de macro. Si vous voulez créer votre propre gestionnaire, assurez-vous de rendre le contrôle au contexte d'exécution HATS.
Remarque :
Les objets d'intégration n'utilisent pas cette option. A la place, la page en sortie récupère les données extraites à partir de l'objet d'intégration et les affiche.

Pour les projets HATS client enrichi, vous pouvez spécifier un gestionnaire de macros personnalisé ou le sélectionner dans la liste des gestionnaires de macros personnalisés définis dans le projet de client enrichi, pour inviter l'utilisateur à fournir les informations nécessaires et inclure un bouton pour que l'utilisateur puisse envoyer ces informations. Un gestionnaire de macro par défaut, nommé DefaultMacroHandler, est fourni avec HATS. Vous pouvez trouver ce fichier en cliquant sur la vue Projets HATS et en développant le nom du projet puis Contenu enrichi > Gestionnaires d'événements de macro. Si vous voulez créer votre propre gestionnaire, veillez à rendre le contrôle au module d'exécution HATS en appelant les méthodes createButtonArea() et createButtons() dans la méthode render() de votre gestionnaire de macros personnalisé. Ces méthodes sont appelées dans l'implémentation par défaut de la méthode RcpMacroHandler.render(). Pour plus d'informations sur RcpMacroHandler, voir la section relative à l'interface API de plateforme client enrichi HATS dans le centre de documentation HATS à l'adresse http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.

Enregistrer sous variable globale
Vous pouvez entrer un nom de variable globale dans la zone Nom ou sélectionner une variable existante dans le menu déroulant. Si vous sélectionnez une variable globale existante dans la zone Nom, vous devez indiquer comment traiter la variable existante en sélectionnant un des boutons d'option suivants :
  • Remplacement de la valeur existante par la nouvelle valeur
  • Remplacement de la valeur existante par la nouvelle valeur, à partir de l'index indiqué
  • Ajout de la nouvelle valeur à la fin de la valeur existante
  • Insertion de la nouvelle valeur dans la valeur existante, à l'index indiqué
Vous pouvez également indiquer si la variable est partagée en cochant la case Partagé.
Remarque :
Si vous extrayez une valeur et que vous l'affecter à une variable globale définie par une extraction et que vous envisagez d'utiliser la valeur de la variable globale pour une invite, vous devez attribuer la valeur false à promptall. Lorsque promptall prend la valeur true, l'action d'extraction n'est pas exécutée avant la récupération des valeurs d'invite. Par conséquent, la variable globale employée par l'invite ne contient pas de valeur.

Les objets d'intégration n'effectuent pas directement d'extraction vers les variables globales. A la place, la page en sortie de l'objet d'intégration récupère les données à partir de ce dernier une fois qu'il a été exécuté, puis les définit dans les variables globales. Gardez à l'esprit que les objets d'intégration ne peuvent accéder qu'aux variables globales partagées.

Cliquez sur OK lorsque vous avez fait vos sélections.

Enregistrer une boucle

Si vous voulez enregistrer une boucle dans votre macro, cliquez sur Enregistrer une boucle puis naviguez jusqu'à l'écran où la boucle va commencer. Cliquez sur Suivant pour définir des critères supplémentaires ou sur Fin pour revenir à l'écran principal du terminal. A partir de l'écran principal du terminal, effectuez les actions qui seront exécutées au cours de chaque cycle de la boucle, puis cliquez sur Suivant. Déterminez le mode d'arrêt de votre boucle en sélectionnant l'option Arrêt lorsqu'un écran unique est reconnu ou Arrêt après un nombre d'itérations fixé et entrez le nombre de boucles voulu. Cliquez sur Suivant puis naviguez jusqu'à l'écran final de la boucle et cliquez sur Fin pour terminer la boucle.

Remarque :
Vous devez accorder une importance particulière aux critères de reconnaissance d'écran pour les écrans de début et de fin de la boucle. Dans certains cas, vous pouvez en effet avoir un écran de début presque identique à l'écran de fin. Vous devez veiller à distinguer ces écrans l'un de l'autre.
Actions Ajouter une invite pour toutes les zones
Si vous sélectionnez cette icône, la fenêtre Insertions de toutes les zones à partir de variables globales s'affiche. Vous pouvez y sélectionner un Nom d'écran enregistré dans la liste déroulante. Vous avez également la possibilité de créer une capture d'écran en cochant la case Création de capture d'écran. Si vous cochez la case Partagé, la variable globale est issue de la liste partagée.
Remarques :
  1. Les valeurs par défaut que vous spécifiez pour les invites sont stockées dans les fichiers de macros non cryptés. Les valeurs par défaut s'affichent en clair lorsque vous éditez les invites dans l'éditeur de macro du terminal hôte ou l'éditeur de macro avancé. Par conséquent, bien qu'utiliser une invite pour demander un mot de passe soit une bonne solution, vous ne devez pas, pour des raisons de sécurité, spécifier de valeur par défaut pour le mot de passe.
  2. Si vous utilisez cette option avec des objets d'intégration, HATS ajoute des zones dans l'objet d'intégration pour chaque variable globale définie. Vous devez rédiger le code pour définir les valeurs des variables globales et les copier dans l'objet d'intégration avant qu'il ne soit exécuté. Cela peut être effectué dans la page .jsp qui exécute l'objet d'intégration. Pour plus d'informations, voir Insérer des propriétés d'objet d'intégration. Gardez à l'esprit que les objets d'intégration ne peuvent accéder qu'aux variables globales partagées.
Actions Ajouter une extraction pour toutes les zones
Si vous cliquez sur cette icône, la fenêtre Extraire toutes les zones dans des variables globales s'affiche. Vous pouvez y sélectionner un Nom d'écran enregistré dans la liste déroulante. Il sera utilisé comme préfixe pour les variables globales créées pour toutes les zones. Si le texte des zones protégées doit être capturé au moment de l'exécution, sélectionnez l'option Toutes les zones. Si le texte des zones protégées doit être statique dans le fichier JSP de transformation, sélectionnez l'option Zones d'entrée. Si vous cochez la case Partagé, la variable globale est issue de la liste partagée.
Remarque :
Si vous utilisez cette option avec des objets d'intégration, HATS ajoute des zones dans l'objet d'intégration pour chaque variable globale définie. Vous devez rédiger le code pour copier les données de l'objet d'intégration dans les variables globales partagées après l'exécution de l'objet d'intégration. Cela peut être effectué dans la page .jsp qui exécute l'objet d'intégration. Pour plus d'informations, voir Insérer des propriétés d'objet d'intégration. Gardez à l'esprit que les objets d'intégration ne peuvent accéder qu'aux variables globales partagées.
Afficher/Masquer le bloc de touches

Cette icône permet d'afficher ou de masquer le bloc de touches du terminal.

Afficher la zone d'informations opérateur textuelle

L'icône Afficher la zone d'informations opérateur textuelle permet de voir la ligne et la colonne indiquant la position exacte du curseur sur l'écran du terminal. Elle vous indique également si la saisie de données est ou non autorisée à cet emplacement.

Prévisualiser l'écran hôte

Pour avoir un aperçu de l'affichage de l'écran hôte en cours s'il était transformé par le serveur, cliquez sur l'onglet Prévisualiser l'écran hôte en haut de la fenêtre Terminal hôte. L'écran de prévisualisation affiche alors l'écran hôte sur lequel vous vous trouvez sous forme d'une page Web.

La prévisualisation de l'écran hôte applique tout d'abord les personnalisations d'écran définies pour l'écran concerné. S'il n'existe aucune personnalisation d'écran définie pour cet écran, le modèle au niveau du projet et les règles de rendu par défaut sont appliqués à l'écran.

La fonction de prévisualisation de l'écran hôte applique les personnalisations d'écran dans l'ordre dans lequel elles sont indiquées sur l'onglet Evénements des Paramètres de projet. Dès qu'une correspondance à la reconnaissance d'écran est trouvée, cette fonction affiche l'écran transformé par la transformation définie dans cette personnalisation d'écran (le cas échéant). En l'absence de correspondance, la transformation par défaut est affichée.

La fonction de prévisualisation de l'écran hôte ne traite pas les personnalisations d'écran définies dans la liste des écrans suivants. Les écrans suivants ne sont pas traités lors de la prévisualisation. Pour plus d'informations, voir Ecran suivant.

Remarque :
L'onglet Prévisualiser l'écran hôte apparaît uniquement si le terminal hôte en cours est associé à la connexion par défaut (connexion de transformation). Si vous ouvrez un terminal hôte sur une connexion d'arrière-plan, vous ne pourrez pas bénéficier de la prévisualisation.

Editeur avancé

Vous pouvez également cliquer sur Advanced Editor dans l'onglet Présentation pour lancer les fonctions avancées de l'éditeur de macro HATS et modifier les paramètres de la macro. Une fenêtre distincte s'affiche pour l'éditeur de macro, qui comporte les onglets suivants :

Pour plus d'informations sur les fonctions avancées de l'éditeur de macro, consultez le manuel HATS Advanced Macro Guide.

Invites et extractions

L'onglet Invites et extractions de l'éditeur de macro répertorie les extractions et les invites de macro configurées et indique comment elles sont traitées lorsque la macro est exécutée. Vous pouvez modifier les propriétés spécifiques à HATS d'une invite ou d'une extraction en les sélectionnant dans le tableau et en cliquant sur Edition.

Source

L'onglet Source affiche les balises contenues dans le fichier nom_macro.hma pour tous les attributs et les valeurs de la macro, où nom_macro est le nom que vous avez affecté à la macro lors de sa création ou de son importation. Lorsque vous apportez des modifications dans d'autres onglets de l'éditeur de projet, les balises et les attributs affichés dans le fichier source sont modifiés en conséquence. Vous pouvez également apporter des modifications aux balises et aux attributs directement dans le fichier source. Elles sont alors répercutées dans les onglets appropriés de l'éditeur de macro.

Les invites et les extractions apparaissent dans le fichier source de macros dans l'ordre dans lequel elles ont été enregistrées. De plus, lorsque vous ouvrez la macro dans l'éditeur, le curseur s'affiche sur la même ligne que celle du dernier enregistrement de la macro. Le curseur ne s'affiche pas en haut du fichier de macro.

Utilisation des erreurs de macro

Les erreurs comprises dans une macro sont résumées dans la vueProblems, selon que vous utilisiez l'éditeur de macro, l'éditeur de texte ou l'éditeur XML. Le code source de la macro affiche un marqueur, un cercle rouge comportant un X blanc, qui apparaît sur les lignes contenant une erreur.

La macro peut être enregistrée même si elle contient des erreurs, vous permettant ainsi de localiser et de corriger ces erreurs ultérieurement, si nécessaire. Cependant, les macro contenant des erreurs ne peuvent pas être lues au moment de l'exécution ou dans le terminal hôte.

Importation d'une macro

Vous pouvez également importer des macros enregistrées dans d'autres programmes tels qu'IBM® WebSphere Host Publisher ou IBM Host On-Demand. Pour importer de telles macros, sélectionnez Fichier > Importation > HATS > Host Publisher/HOD Macro et cliquez sur Suivant pour afficher la boîte de dialogue Importation d'une macro Host Publisher/HOD. Cliquez sur Ajout et naviguez jusqu'à l'emplacement de la macro dans le système de fichiers.

Remarque :
Les macros Host Publisher avec boucles d'itération fixes reconnaissent continuellement le même écran et exécutent différentes actions. Dans HATS, vous ne pouvez pas créer une personnalisation d'écran pour reconnaître le même écran une seconde fois et exécuter une action différente de celle effectuée lors de la première reconnaissance d'écran. Si vous essayez d'utiliser une macro Host Publisher avec bouclage d'itération fixe, votre projet risque d'entrer dans une boucle infinie. Les macros Host Publisher avec bouclage d'itération fixe peuvent être identifiées en regardant le code source. La macro contient les balises customreco avec les attributs d'ID de HPubFixedIterationLoop et custom avec les attributs d'ID de HPubIncrementLoop.

Exportation d'une macro

Vous pouvez exporter des macros HATS, ainsi que des macros IBM WebSphere Host Publisher ou IBM Host On-Demand. Pour exporter de telles macros, sélectionnez Fichier > Exportation > HATS > Macro HATS ou Fichier > Exportation > HATS > macro Host Publisher/HOD et cliquez sur Suivant. Les macros Host Publisher se trouvent généralement dans un répertoire \hostpub\Studio\IntegrationObjects. Ces macros sont exportées sous la forme de fichiers .macro. Cette extension de fichier est reconnue aussi bien par Host Publisher que par Host On-Demand, mais Host On-Demand utilise une valeur par défaut et recherche des fichiers .mac. Vous devez donc modifier le filtre Host On-Demand afin de rechercher des fichiers *.macro ou *.*.

Sélectionnez l'option Fichiers de macros à exporter ainsi que l'emplacement cible. Vous pouvez choisir d'écraser les ressources existantes en cochant la case Remplacement des ressources existantes sans avertissement préalable.

Cliquez sur Fin quand vous avez fini.

Remarque :

Pour plus d'informations sur l'utilisation su support DBCS, voir Enregistrement d'une macro.

Conseils et suggestions concernant les macros

Prévention contre une boucle infinie

L'exécution d'une macro est une des actions dont vous pouvez définir l'exécution lorsqu'un écran hôte correspond aux critères de reconnaissance d'une personnalisation d'écran. Lorsque vous enregistrez une macro, veillez à ce que l'écran final ne soit pas l'écran qui est reconnu par la personnalisation d'écran ayant pour action définie l'exécution de la macro. Si l'écran reconnu est l'écran final de la macro, une boucle infinie est créée.

Gestion des écrans transitoires

Vous pouvez définir des écrans transitoires et des écrans non transitoires pour vos macros. Cependant, au moment de l'exécution, il peut arriver qu'un de vos écrans transitoires soit reconnu de manière inattendue.

Lorsque la macro est comparée après les descripteurs d'écran, les descripteurs d'écran non transitoire sont comparés en premier, puis sont comparés les descripteurs d'écran transitoire. Si les informations d'écran actuelles sont mises à jour après le début de la comparaison des descripteurs d'écran non transitoire, les informations mises à jours seront utilisées pour la comparaison des descripteurs d'écran transitoire. Par conséquent, si un écran est verrouillé (la zone d'informations opérateur est bloquée en entrée) au moment où la comparaison d'écran non transitoire commence et qu'il est déverrouillé par la suite, avant le début de la comparaison d'écran transitoire, sans aucune autre modification, cela peut entraîner la non-reconnaissance des écrans non transitoires, suivie de la reconnaissance des écrans transitoires ; il s'agit, dans ce cas, d'un comportement inattendu.

Pour éviter ce comportement inattendu, vous pouvez décider si les mêmes informations d'écran doivent être utilisées lors de la comparaison de descripteurs d'écran non transitoire et d'écran transitoire. Pour ce faire, ajoutez le paramètre de connexion avancé screenRecoUseOIASnapshot et définissez-le sur true. Pour plus d'informations sur la définition des paramètres de connexion avancés, voir Configuration de paramètres de connexion avancés en option.