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 :
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.
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.
Les sections suivantes décrivent les différents onglets de l'éditeur de macro.
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.

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.
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.
Le tableau 4 indique les icônes de macro qui apparaissent dans la barre d'outils de l'écran du terminal hôte.
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.
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.
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.
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.
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 :
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.
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.
Cliquez sur OK lorsque vous avez fait vos sélections.
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 :
Indique que le texte extrait doit être sauvegardé sous la forme d'une seule chaîne de caractères horizontale. Cette option est prise en charge pour les objets d'intégration, les variables globales et les gestionnaires de macros.
Indique que le texte extrait doit être sauvegardé sous la forme d'une liste de chaînes verticale. Cette option est prise en charge pour les variables globales et les gestionnaires de macros. Pour un objet d'intégration, une liste de chaînes est traitée comme une chaîne continue.
Indique que le texte extrait doit être sauvegardé sous la forme d'un tableau de chaînes horizontales et verticales, comportant des lignes et des colonnes. Cette option est prise en charge pour les objets d'intégration et les gestionnaires de macros. Pour une variable globale, les chaînes extraites sous la forme d'un tableau deviennent une chaîne continue.
Cette zone permet de modifier l'en-tête de la colonne sélectionnée.
Lorsque vous agrandissez une colonne, les caractères passent d'une colonne à l'autre. Lorsque vous mettez en évidence une colonne, le bouton Gauche déplace le dernier caractère de chaque ligne de la colonne vers la gauche de la colonne mise en évidence de sorte qu'il devient le premier caractère de chaque ligne de la colonne mise en évidence. Le bouton Droite déplace le premier caractère de chaque ligne de la colonne vers la droite de la colonne mise en évidence de sorte qu'il devient le dernier caractère de chaque ligne de la colonne mise en évidence.
Lorsque vous réduisez une colonne, les caractères passent d'une colonne à l'autre. Lorsque vous mettez en évidence une colonne, le bouton Gauche déplace le premier caractère de chaque ligne de la colonne mise en évidence de sorte qu'il devient le dernier caractère de chaque ligne de la colonne située à gauche de la colonne mise en évidence. Le bouton Droite déplace le dernier caractère de chaque ligne de la colonne mise en évidence de sorte qu'il devient le premier caractère de chaque ligne de la colonne située à droite de la colonne mise en évidence.
Ce bouton permet de fusionner deux colonnes mises en évidence en une seule. Les caractères contenus dans les colonnes mises en évidence sont joints dans une seule colonne.
Ce bouton permet de diviser une colonne mise en évidence en deux colonnes distinctes. Les caractères contenus dans la colonne mise en évidence sont répartis de manière égale entre les deux nouvelles colonnes. Si les caractères sont en nombre impair, la colonne de gauche en contient un de plus que la colonne de droite.
Pour plus d'informations sur l'utilisation de cette fonction avec le support DBCS, voir Enregistrement d'une macro.
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 :
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.
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.
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.
Cette icône permet d'afficher ou de masquer le bloc de touches du terminal.
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.
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.
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.
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.
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.
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.
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.
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.
Pour plus d'informations sur l'utilisation su support DBCS, voir Enregistrement d'une macro.
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.
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.