Uma macro é um script XML que define um conjunto de telas. Cada tela inclui uma descrição da tela, as ações a executar para aquela tela e a tela ou telas que podem ser apresentadas depois que as ações forem executadas.
O HATS suporta personalização baseada em macro para acelerar e personalizar o processo do aplicativo host. As macros podem ser utilizadas para as seguintes funções:
É possível utilizar macros para fazer qualquer ou todas as funções a seguir:
As macros de prompt também podem ser utilizadas por desenvolvedores para fornecer valores constantes ou valores obtidos de variáveis globais.
As macros gravadas ou importadas no HATS Toolkit são salvas em um arquivo de macro HATS (.hma). É possível ver as macros definidas em seu projeto, expandindo o nó Macros da visualização Projetos HATS do HATS Toolkit.
O HATS fornece três editores diferentes que você pode utilizar para visualizar e modificar macros do HATS, o Editor de Macros, O Editor de Macros Avançado e Editor de Macros Visual. O Editor de Macros Visual é o editor padrão para macros do HATS. Quando você clica duas vezes no nome de uma macro, o Editor de Macros Visual é aberto. Para obter mais informações sobre o Editor de Macros Visual, consulte o capítulo Visual Macro Editor, na publicação HATS Advanced Macro Guide.
Para abrir o Editor de Macros, clique com o botão direito do mouse no nome da macro e selecione Abrir Com > Editor de Macros.
O Editor de Macro Avançado é aberto a partir da página de Visão Geral do Editor de Macros. Para obter mais informações sobre o Editor de Macros Avançado, consulte o capítulo Advanced Macro Editor, na publicação HATS Advanced Macro Guide.
As seções a seguir descrevem cada guia do editor da macro.
A guia Visão Geral do editor da macro resume as informações gerais sobre a macro, como o nome, a descrição e a última data e hora modificada. Os itens que você pode modificar nessa guia são a descrição da macro, o tempo de pausa, o tempo limite e a conexão.
Tempo de Pausa é o número de milissegundos de atraso após cada ação ser executada. Tempo Limite é o número de milissegundos para ser aguardado antes de terminar a macro e Conexão permite selecionar qual conexão utilizar a partir do menu suspenso.
Os botões Abrir Terminal Host e Editor Avançado são descritos detalhadamente abaixo.

É possível clicar em Abrir Terminal Host para criar ou trabalhar com sua macro utilizando o terminal host. Depois que o terminal é aberto, você pode utilizar qualquer um dos ícones na barra de ferramentas para registrar e criar sua macro.
Também é possível utilizar o Terminal Host para editar uma macro anteriormente gravada, clicando com o botão direito do mouse nos nós na árvore da macro e selecionando Editar. Se você selecionar uma tela para edição, isso ativará o editor de critérios de reconhecimento de tela que permitirá modificar sua tela. Se você editar alguma entrada que você tenha inserido na sua tela, uma janela será aberta e permitirá alterar ou modificar a entrada. Se você editar o nó Próximas Telas, será apresentada uma lista das telas disponíveis para seleção para sua próxima tela. Selecione na lista a ordem em que deseja que suas telas apareçam.
Para depurar os erros de reprodução de macro, existem quatro ícones na barra de ferramentas Terminal Host. Os ícones foram projetados para ajudá-lo a passar por uma macro, onde é definida uma etapa como reprodução de uma ação ou reconhecimento de uma tela. Os ícones são Avançar Para, Avançar Sobre, Retornar e Retomar.
Cada um dos ícones possui teclas de função associadas a eles. Dependendo da visualização ativa (Navegador de Macro ou Terminal Host), as teclas F5, F6, F7 e F8 funcionarão de forma diferente. Por exemplo, se o Navegador de Macro estiver ativo, pressionar F5 executará Avançar Para e pressionar F6 executará Avançar Sobre. Se o Terminal Host estiver ativo, pressionar F5 ou F6 enviará a tecla AID para o host. Para obter informações adicionais sobre esses ícones e outros ícones relacionados a macros, consulte Ícones Relacionados a Macro.
A Tabela 4 mostra os ícones de macro que aparecem na barra de ferramentas da tela do terminal host.
A seguir está uma lista de ícones relacionados a macros na barra de ferramentas do Terminal Host:
Você pode registrar macros em HATS Toolkit utilizando o terminal do host do HATS. Na tela do terminal do host do HATS, clique no ícone Gravar Macro. O assistente Gravar Macro aparece e permite que você selecione o projeto de destino, nomeie a macro, dê uma descrição e veja onde a macro será salva. A opção Criar capturas de tela automaticamente durante a gravação, permite que você especifique se uma captura de tela deve ser automaticamente criada para cada tela navegada durante a gravação da macro. Essas capturas de tela podem então ser utilizadas dentro do Editor de Macros Visual se posteriormente tiver que fazer mudanças na macro. Esta opção é selecionada por padrão. Clique em Concluir quando tiver terminado de especificar esses itens.
Em seguida, aparecerá a janela Definir Critérios de Reconhecimento de Tela, porque o HATS força a primeira tela a definir explicitamente o reconhecimento de tela. É possível então utilizar a tela do terminal host do HATS para navegar através do aplicativo host até qualquer tela.
Se você tiver uma macro já aberta no terminal host do HATS, o ícone Gravar Macro perguntará se você deseja gravar uma nova macro ou anexar à macro aberta. Se você anexar à macro aberta, será iniciada a gravação da macro e suas ações serão anexadas à macro atual. O local de início de gravação na macro depende do que está selecionado na árvore Navegador de Macro à esquerda, e se a tela do terminal atual corresponder aos critérios de reconhecimento de tela do nó selecionado. Especificamente:
Não crie uma macro cuja única etapa é inserir uma extração ou inclusão de prompt. Se fizer isso, quando o usuário fornecer um valor, a página não será alterada, e não haverá maneira do usuário mover-se para outra página. Se uma macro não retornar ao host, ela ficará estática e seu tempo limite se esgotará.
É possível definir os critérios de reconhecimento de tela que o HATS utiliza para corresponder as telas de host. As telas de host podem ser reconhecidas por qualquer combinação de critérios, incluindo quantos campos de entrada ou campos totais estão na tela, as coordenadas da posição do cursor e cadeias de texto na tela dentro de um retângulo definido ou em qualquer local da tela. Para obter informações adicionais, consulte Critérios de Reconhecimento de Tela ou Tela de Início.
Se você deseja que a macro solicite as informações do usuário, clique em Incluir Ação do Prompt para exibir o assistente para Incluir Ação do Prompt. Você pode fornecer ao prompt um nome e um valor padrão. Se as informações que o usuário fornecer, como uma senha, não tiverem que ser exibidas na tela do host, clique na caixa de opções Entrada Protegida por Senha.
Os campos Linha e Coluna da seção Posição do assistente definem onde na tela de host são colocadas as informações do prompt que o usuário fornece. Se você colocar seu cursor em um local na tela de host, como o campo para uma senha, antes de começar a gravar a macro, os campos Linha e Coluna serão preenchidos com esses valores. A seção Tratar Prompt de Macro do assistente permite determinar como o prompt será processado. É possível selecionar um dos seguintes botões de opções:
Para projetos do HATS rich client, é possível especificar um manipulador de macros customizado ou navegar para selecionar em uma lista de manipuladores de macro customizados definidos no projeto do rich client, para solicitar ao usuário as informações necessárias e incluir um botão para que o usuário envie as informações. Um manipulador de macro padrão, denominado DefaultMacroHandler, é enviado com o HATS. Você pode localizar este arquivo na visualização Projetos HATS, expandindo o nome do projeto e expandindo Rich Client Content > Macro Event Handlers. Se você deseja criar seu próprio manipulador, assegure-se de retornar o controle ao tempo de execução do HATS chamando os métodos createButtonArea() e createButtons() no método render() de seu manipulador de macro customizada. Esses métodos são chamados na implementação padrão do método RcpMacroHandler.render(). Para obter informações adicionais sobre RcpMacroHandler, consulte a seção Referência da API do HATS RCP no Centro de Informações do HATS em http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.
Se um valor de prompt for baseado em uma variável global definida por uma extração e promptall estiver configurado como true, a ação de extração não será executada antes da recuperação dos valores de prompts. Por isso, a variável global utilizada pelo prompt não contém um valor. Se você utilizar variáveis globais com extrações e prompts, será necessário definir promptall como false.
Os Objetos de Integração não acessam as variáveis globais diretamente. Em vez disso, as páginas de entrada e de saída para o Objeto de Integração recuperam o valor da variável global e o definem para o Objeto de Integração antes de sua execução. Apenas variáveis globais compartilhadas podem ser acessadas pelos Objetos de Integração.
Clique em OK após ter feito as seleções.
Se você deseja que a macro extraia as informações da tela de host, selecione uma área da tela de host e depois clique em Incluir Ação Extrair para exibir o assistente Incluir Ação Extrair. É possível especificar um nome para a extração. Os campos Iniciar Linha, Iniciar Coluna, Encerrar Linha e Encerrar Coluna da seção Posição do assistente definem de onde são extraídas as informações na tela de host. Quando você marca uma região da tela de host com um retângulo e, em seguida, clica em Incluir Ação Extrair, os campos da seção Posição são preenchidos com os valores quando o assistente Incluir Ação Extrair for exibido.
É possível especificar o Formato de Extração como:
Especifica que o texto extraído deve ser salvo como uma única cadeia de caracteres horizontal. Esta opção é suportada para Objetos de Integração, variáveis globais e manipuladores de macro.
Especifica que o texto extraído deve ser salvo como uma lista de cadeias vertical. Esta opção é suportada para variáveis globais e rotinas de tratamento de macros. Para um Objeto de Integração, uma lista de cadeias é tratada como uma cadeia contínua.
Especifica que o texto extraído deve ser salvo como uma tabela de cadeias horizontais e verticais, com linhas e colunas. Esta opção é suportada pelos Objetos de Integração e manipuladores de macro. Para uma variável global, as cadeias extraídas como uma tabela se tornam uma cadeia contínua.
Utilize este campo para alterar o cabeçalho da coluna selecionada.
Expandir uma coluna move os caracteres entre as colunas. Ao realçar uma coluna, o botão Esquerdo move o último caractere em cada linha da coluna para a esquerda da coluna realçada para se tornar o primeiro caractere de cada linha da coluna realçada. O botão Direito move o primeiro caractere de cada linha da coluna para a direita da coluna realçada para se tornar o último caractere de cada linha da coluna realçada.
Reduzir uma coluna move os caracteres entre as colunas. Ao realçar uma coluna, o botão Esquerdo move o primeiro caractere de cada linha da coluna realçada para se tornar o último caractere de cada linha da coluna à esquerda da coluna realçada. O botão Direito move o último caractere de cada linha da coluna realçada para se tornar o primeiro caractere de cada linha da coluna à direita da coluna realçada.
Utilize este botão para combinar duas colunas realçadas em uma única coluna. Os caracteres nas colunas realçadas são unidos em uma coluna.
Utilize este botão para dividir a coluna realçada em duas colunas separadas. Os caracteres na coluna realçada são divididos igualmente entre as duas novas colunas. Se houver um número desigual de caracteres, a coluna da esquerda irá conter um ou mais caracteres que a coluna da direita.
Para obter considerações ao utilizar esta função com suporte DBCS, consulte Gravando uma Macro.
A seção Tratar da Macro Extrair do assistente permite determinar como o prompt será processado. É possível selecionar as seguintes caixas de opções:
Para projetos do HATS rich client, é possível especificar um manipulador de macros customizado ou navegar para selecionar em uma lista de manipuladores de macro customizados definidos no projeto do rich client, para solicitar ao usuário as informações necessárias e incluir um botão para que o usuário envie as informações. Um manipulador de macro padrão é enviado com o HATS e é nomeado DefaultMacroHandler. É possível encontrar esse arquivo na visualização Projetos HATS expandindo o nome do projeto e expandindo Conteúdo do Rich > Manipuladores de Eventos da Macro. Se você deseja criar seu próprio manipulador, assegure-se de retornar o controle ao tempo de execução do HATS chamando os métodos createButtonArea() e createButtons() no método render() de seu manipulador de macro customizada. Esses métodos são chamados na implementação padrão do método RcpMacroHandler.render(). Para obter informações adicionais sobre RcpMacroHandler, consulte a seção Referência da API do HATS RCP no Centro de Informações do HATS em http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp?topic=/com.ibm.hats.doc/doc/rcpjavadoc/index.html.
Os Objetos de Integração não são extraídos diretamente para variáveis globais. Em vez disso, a página de saída do Objeto de Integração recuperará os dados do Objeto de Integração após sua execução e os definirá para a variável global. Lembre-se de que apenas as variáveis globais compartilhadas podem ser acessadas por Objetos de Integração.
Clique em OK após ter feito as seleções.
Se você deseja gravar um loop na sua macro, clique em Gravar um Loop, em seguida, navegue na tela onde o loop começará. Clique em Avançar para definir os critérios de reconhecimento de tela para a primeira tela e clique em Avançar para definir critérios adicionais ou em Concluir para retornar ao terminal principal. No terminal principal, execute as ações que serão executadas durante cada ciclo do loop, em seguida, pressione Avançar. Determine como o seu loop será encerrado, selecionando Encerrar Quando uma Tela Exclusiva for Reconhecida ou Encerrar Após um Número Fixo ou Iterações e insira o número de loops abaixo. Clique em Avançar, em seguida, navegue até a tela final do loop e pressione Concluir para concluir o loop.
Este ícone permite mostrar ou ocultar o teclado numérico do terminal.
O ícone Mostrar OIA Textual (Área de Informações do Operador) permite ver a posição exata da linha e da coluna do cursor da tela do seu terminal. Ela também instrui você se a entrada está inibida, ou não.
Para ver qual será o aspecto da tela do host atual, se for transformada pelo servidor, clique na guia Visualização da Tela do Host no início da janela Terminal Host. A tela de visualização exibirá a tela do host em que você está como uma página da Web.
A visualização de tela do host primeiro aplica qualquer customização de tela definida para a tela atual. Se não houver personalizações de telas definidas para a tela atual, o modelo de nível do projeto e as regras de processamento padrão serão aplicados na tela.
A visualização da tela do host aplica a ordem de customizações de telas listada na guia Eventos de suas Configurações de Projetos. Assim que é localizada uma correspondência de reconhecimento de tela, é mostrada a tela transformada pela transformação definida nessa customização de tela (se houver alguma). Se não houver nenhuma correspondência, será mostrada a transformação padrão.
A visualização de tela do host não processará nenhuma customização de tela definida na próxima lista de telas. As próximas telas não serão processadas na visualização de tela do host. Para obter informações adicionais, consulte Próxima Tela.
Também é possível clicar no Editor Avançado na guia Visão Geral para ativar os recursos avançados do editor de macros do HATS e modificar as configurações para a macro. Uma janela separada é aberta para o editor de macros que possui as seguintes guias:
Para obter informações adicionais sobre os recursos do editor avançado do editor de macros, consulte a Guia de Macro Avançada do HATS.
A guia Prompts e Extrações do editor de macro lista os prompts e extrações da macro configurada e como eles são tratados quando a macro é reproduzida. É possível editar as propriedades específicas do HATS de um prompt ou uma extração, selecionando-a na tabela e clicando em Editar.
A guia Origem exibe as tags no arquivo macro-name.hma para todos os atributos e valores para a macro, em que macro-name é o nome que você atribuiu à macro quando a criou ou a importou. Conforme você faz alterações nas outras guias no editor de projetos, as guias e atributos exibidos no arquivo de origem são alterados para correspondência. Também é possível fazer alterações nas tags e atributos no arquivo de origem e elas são refletidas nas guias apropriadas do editor de macro.
Avisos e extrações aparecem no arquivo de origem da macro na ordem que você os gravou. Além disso, ao abrir a macro no editor, o cursor aparece na mesma linha que estava na última vez que a macro foi salva, ao invés de aparecer no topo do arquivo de macro.
Erros em uma macro são resumidos na visualização Problemas , mesmo se estiver usando o editor de macro, de texto ou XML. O código-fonte da macro exibe um marcador, um círculo vermelho com um X branco, o qual aparece em todas as linhas que tiverem um erro.
A macro pode ser salva mesmo quando contiver erros, permitindo que você localize e corrija erros posteriormente, se necessário. Entretanto, as macros contendo erros não podem ser reproduzidas no tempo de execução ou no terminal do host.
Também é possível importar macros gravadas com outros programas, como o IBM® WebSphere Host Publisher ou IBM Host On Demand. Para importar essas macros, selecione Arquivo > Importar > HATS > Macro Host Publisher/HOD e clique em Avançar para exibir o diálogo Importar uma Macro Host Publisher/HOD. Clique em Incluir e navegue até a localização da macro no sistema de arquivos.
É possível exportar as macros do HATS bem como as macros do IBM WebSphere Host Publisher ou IBM Host On Demand. Para exportar essas macros, selecione Arquivo > Exportar > HATS > Macro do HATS ou Arquivo > Exportar > HATS > Macro do Host Publisher/HOD e clique em Avançar. As macros do Host Publisher normalmente estão no caminho do diretório \hostpub\Studio\IntegrationObjects. Essas macros são exportadas como arquivos .macro. Essa extensão de arquivos funciona para o Host Publisher e o Host On-Demand, mas o Host On-Demand utiliza como um padrão e procura por arquivos .mac. Você precisará alterar o filtro do Host On Demand para que procure por *.macro ou *.*.
Selecione Arquivos da Macro a Serem Exportados juntamente com o destino. É possível optar por sobrescrever os recursos existentes selecionando a caixa de opções Sobrescrever recursos existentes com aviso.
Clique em Concluir ao término.
Para obter considerações sobre o uso do suporte ao DBCS, consulte Gravando uma Macro.
A execução de uma macro é uma das ações que podem ser especificadas para serem executadas quando uma tela de host coincide com os critérios de reconhecimento de uma customização de tela. Quando uma macro é gravada, certifique-se de que a tela final não seja a tela reconhecida pela personalização da tela que possui a macro definida como a ação. Se a tela reconhecida for a tela final da macro, um loop será criado.
É possível definir telas temporárias junto com telas não temporárias para suas macros. Entretanto, no tempo de execução, é possível visualizar uma de suas telas temporárias sendo reconhecidas inesperadamente.
Ao comparar macros próximas aos descritores de telas, os descritores de telas não temporárias são comparados primeiro, em seguida, os descritores de telas temporárias são comparados. Se as informações da tela atual forem atualizadas após o início da comparação de descritores de telas não temporárias, as informações de tela atualizadas serão utilizadas para comparação do descritor de tela temporária. Consequentemente, é possível que se uma tela estiver bloqueada (OIA com entrada inibida) quando a comparação de tela não temporária iniciar e, então for desbloqueada, sem outras alterações, antes de a comparação de telas temporárias iniciar, isto poderá fazer com que as telas não temporárias não sejam reconhecidas, mas subsequentemente, as telas temporárias poderão ser reconhecidas, o que não é o comportamento esperado.
Para evitar este comportamento inesperado, é possível controlar se as mesmas informações da tela são utilizadas ao comparar os descritores de telas não temporárias e temporárias. Para fazer isto, inclua a configuração de conexão avançada, screenRecoUseOIASnapshot, e configure seu valor com true. Para obter informações sobre como definir as configurações de conexão avançadas, consulte Configurar definições de conexão opcionais e avançadas.