Macros e Terminal Host

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:

Ignorar Tela
As macros ignorar tela são macros navegacionais que movem o usuário de uma tela para outra sem exibir telas de intervenção.
Prompt
As macros de prompt contêm etapas para solicitar a entrada dos usuários durante a sessão do host. Elas também podem definir os prompts de uma lista do usuário. Por exemplo, você pode utilizar uma macro de prompt para solicitar a um usuário o seu ID de usuário e senha antes de criar um log em um aplicativo host.
Nota:
Os prompts da lista de usuários podem ser utilizados apenas em macros de conexão.

As macros de prompt também podem ser utilizadas por desenvolvedores para fornecer valores constantes ou valores obtidos de variáveis globais.

Extrair
As macros Extrair contêm eventos para extrair informações da tela do host como uma cadeia, uma lista de cadeias ou uma tabela. Por exemplo, você pode utilizar uma macro extrair para se conectar a um aplicativo host de tipo de diretório e extrair os resultados fazendo uma procura no diretório.

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.

Nota:
O suporte para o Editor de Macros e o Editor de Macros Avançado é reprovado no HATS V7.5.1. Embora o suporte continue por enquanto, a IBM reserva-se o direito de remover estas capacidades em um release subsequente do produto. Este suporte foi substituído pelo Editor de Macros Visual.

Editor de Macros

As seções a seguir descrevem cada guia do editor da macro.

Visão Geral

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.

Figura 63. Gravação de Macro do HATS
Gravação de macro utilizando o terminal host

Abrir Terminal Host

É 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.

Terminal Host

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.

Nota:
Notas:
  1. O HATS requer que você defina os critérios de reconhecimento de tela para determinadas telas. Estas telas são:
  2. As funções recortar, copiar e colar são fornecidas no terminal host utilizando as seguintes combinações de teclas:

A Tabela 4 mostra os ícones de macro que aparecem na barra de ferramentas da tela do terminal host.

Tabela 4. Ícones de Macro
Ícone Descrição
abrir macro
Abrir uma macro. Utilize a lista suspensa para selecionar uma macro.
executar macro
Executar uma macro. Utilize a lista suspensa para selecionar uma macro.
gravar macro
Iniciar gravação de uma macro
interromper macro
Interromper a gravação de uma macro
salvar macro
Salvar a macro gravada
avançar para
Avançar Para (F5) a macro para fins de depuração
avançar sobre
Avançar sobre (F6) a macro para fins de depuração
retornar
Retornar (F7) à macro para fins de depuração
retomar
Retomar (F8) reprodução da macro
definir critérios de reconhecimento da tela da macro
Definir os critérios de reconhecimento de tela para uma tela de macro
 incluir uma ação de prompt
Incluir uma ação de prompt na macro atual (ativado apenas ao gravar uma macro)
 incluir uma ação extrair
Incluir uma ação extrair na macro atual (ativado apenas ao gravar uma macro)
gravar uma macro de loop
Gravar um loop na macro atual (ativado apenas ao gravar uma macro)
incluir ações de prompt para todos os campos
Incluir ações de prompt na macro atual para todos os campos na tela (ativado apenas ao gravar uma macro)
 incluir ações de extração para todos os campos
Incluir ações extrair na macro atual para todos os campos na tela (ativado apenas ao gravar uma macro)
mostrar/ocultar teclado numérico
Mostrar ou ocultar o teclado numérico na janela de terminal host
OIA do texto
Mostrar ou ocultar OIA (Operator Information Area) textual
Ícones Relacionados a Macro

A seguir está uma lista de ícones relacionados a macros na barra de ferramentas do Terminal Host:

Gravar macro

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á.

Nota:
Se você planejar criar um Objeto de Integração a partir de uma macro, certifique-se de seguir estes requisitos ao nomear a macro:
  • O nome da macro deve consistir apenas em letras, dígitos ou sublinhados.
  • O primeiro caractere do nome não pode ser um numeral.
  • Não são permitidos caracteres de byte duplo (largura completa).
Parar Macro
Quando tiver terminado de registrar sua macro, clique no ícone Parar Macro.
Salvar Macro
Depois de parar a gravação de sua macro, será necessário salvá-la clicando no ícone Salvar Macro.
Avançar para (F5)
Clicar no ícone Avançar para (F5) permite avançar de uma tela para sua primeira ação incluída e de uma ação para outra. Utilizar a tecla F5 no teclado executará a mesma função. Isto é utilizado para fins de depuração.
Avançar sobre (F6)
Clicar em Avançar sobre (F6) permite ir de tela em tela (executando todas as ações de intervenção). Utilizar a tecla F6 no teclado executará a mesma função. Isto é utilizado para fins de depuração.
Retornar (F7)
Clique em Retornar (F7) permite concluir a reprodução das ações em uma tela e ir para a próxima tela. Utilizar a tecla F7 no teclado executará a mesma função. Isto é utilizado para fins de depuração.
Retomar (F8)
Para retomar a reprodução de sua macro, você pode clicar no ícone Retomar (F8) ou pressionar a tecla F8 em seu teclado. Isto pode ser utilizado para executar o restante de sua macro se você estiver passando por ela.
Definir Critérios de Reconhecimento de Tela

É 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.

Incluir Ação do Prompt

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.

Nota:
Os valores padrão que você especificar para os prompts são armazenados em arquivos de macro não criptografados. Os valores padrão são exibidos quando você edita prompts utilizando os editores de macros. Portanto, ao mesmo tempo que utilizar um prompt para especificar uma senha é algo apropriado, por razões de segurança você não deve especificar um valor padrão para a 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:

Mostrar Manipulador
Para projetos da Web do HATS, você pode selecionar um arquivo .jsp 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 default.jsp, é enviado com o HATS. É possível encontrar esse arquivo, clicando na visualização Projetos HATS do HATS Toolkit, expandindo o nome do projeto e expandindo Conteúdo da Web > 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.
Notas:
  1. Os Objetos de Integração ignoram o manipulador .jsp selecionado. Em vez disso, é criada uma página de entrada para o Objeto de Integração e um prompt para o valor será colocado nessa página de entrada. A página de saída gerada copia o valor fornecido pela página de entrada para o Objeto de Integração antes da execução do Objeto de Integração.
  2. A opção Mostrar Manipulador é desativada quando a macro é extraída de um plano que não o plano de texto.
Nota:

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.

Definir Prompt para Cadeia
Se você souber qual valor deve ser retornado de um prompt, será possível inserir essa cadeia no campo Cadeia.
Definir Prompt para Variável Global
Se você deseja que o valor do prompt seja fornecido por uma variável global, insira um nome para a variável global no campo Nome ou selecione uma variável existente utilizando o menu suspenso junto ao campo Variável Global. Se você clicar no botão Avançado, poderá especificar se sua variável será compartilhada ou indexada. Se for uma variável indexada, você também precisará especificar se é necessário mostrar todos os índices ou um único índice. Para obter informações adicionais, consulte Interagindo com Variáveis Globais.
Nota:

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.

Definir Prompt para Propriedade a partir da Lista de Usuários
Se desejar que o prompt acesse uma lista de usuários, selecione Perfil do Usuário da lista suspensa. O perfil do usuário é a chave para determinar se é necessário utilizar o ID do usuário ou senha como a Propriedade da Lista de Usuários. Para obter informações adicionais, consulte Lista de Usuários.
Nota:
Os prompts da lista de usuários podem ser utilizados apenas em macros de conexão.
Utilize o Web Express Logon
Se você tiver configurado seu aplicativo do HATS para utilizar o Web Express Logon, digite o tipo de prompt como o ID do usuário ou senha na lista suspensa Tipo de Prompt e digite o ID do aplicativo no campo ID do Aplicativo.
Nota:
O Tipo de Prompt deve ser previamente preenchido com o valor correto.

Clique em OK após ter feito as seleções.

Incluir Ação Extrair

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:

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:

Mostrar Manipulador
Para aplicativos da Web do HATS, você pode selecionar um arquivo .jsp para exibir as informações extraídas para o usuário. Um manipulador de macro padrão é enviado com o HATS e é nomeado default.jsp. É possível encontrar isso na visualização Projetos HATS expandindo o nome do projeto e expandindo Conteúdo da Web > 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.
Nota:
Os Objetos de Integração não utilizam esta opção. Em vez disso, a página de saída recuperará os dados extraídos do Objeto de Integração e os exibirá.

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.

Salvar Como Variável Global
Você pode inserir um nome para a variável global no campo Nome ou selecionar uma variável existente utilizando o menu suspenso. Se você selecionou uma variável global existente no campo Nome, será necessário especificar como tratar a variável existente, selecionando um dos seguintes botões de opções:
  • Sobrescrever o valor existente por esse novo valor
  • Sobrescrever o valor existente por esse novo valor, começando com o índice específico.
  • Anexar esse novo valor ao final do valor existente.
  • Inserir esse novo valor no valor existente, no índice específico.
Também é possível especificar se essa variável é compartilhada, selecionando a caixa de opções Compartilhado.
Nota:
Se você extrair um valor e designá-lo a uma variável global definida por uma extração, e estiver planejando utilizar o valor da variável global para um prompt, deverá definir promptall como false. Quando promptall estiver definido como true, a ação de extração não será executada antes da recuperação de valores de prompts. Por isso, a variável global utilizada pelo prompt não contém um valor.

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.

Gravar um Loop

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.

Nota:
Deve ser colocada ênfase significante sobre os critérios de reconhecimento da tela para as telas iniciais e finais do loop. Em alguns casos, você pode ter uma tela inicial que seja quase idêntica à tela final. Tenha cuidado ao distinguir essas telas umas das outras.
Incluir Ações do Prompt para Todos os Campos
Se você selecionar esse ícone, a janela Inserir Todos os Campos das Variáveis Globais será aberta. Nesse local, você poderá selecionar um Nome de Tela Armazenada a partir da lista suspensa. Você também possui a opção de criar uma captura de tela, selecionando a caixa de opções Criar uma Captura de Tela. Selecionando a caixa de opções Compartilhado, a variável global será obtida a partir da lista compartilhada.
Notas:
  1. Os valores padrão que você especificar para os prompts são armazenados em arquivos de macro não criptografados. Os valores padrão são exibidos internamente quando você edita prompts no editor de macro do terminal host ou no editor de macro avançado. Portanto, ao mesmo tempo que utilizar um prompt para especificar uma senha é algo apropriado, por razões de segurança você não deve especificar um valor padrão para a senha.
  2. Se você utilizar esta opção com Objetos de Integração, o HATS incluirá campos no Objeto de Integração para cada variável global definida. É necessário gravar o código para definir valores de variáveis globais e copiá-los para o Objeto de Integração antes de sua execução. Isto pode ser feito na página .jsp que executa o Objeto de Integração. Para obter informações adicionais, consulte Inserir Propriedades do Objeto de Integração. Lembre-se de que apenas as variáveis globais compartilhadas podem ser acessadas por Objetos de Integração.
Incluir Ações Extrair para Todos os Campos
Se você selecionar este ícone, a janela Extrair Todos os Campos de Variáveis Globais será aberta. Nesse local, você poderá selecionar um Nome de Tela Armazenada a partir da lista suspensa. A qual será utilizada como um prefixo para as variáveis globais criadas para todos os campos. Se o texto dos campos protegidos tiver que ser apanhado no tempo de execução, selecione a opção Todos os campos. Se o texto para os campos protegidos ficar estático no JSP de transformação, selecione a opção Campos de Entrada. Selecionando a caixa de opções Compartilhado, a variável global será obtida a partir da lista compartilhada.
Nota:
Se você utilizar esta opção com Objetos de Integração, o HATS incluirá campos no Objeto de Integração para cada variável global definida. É necessário gravar o código para copiar os dados do Objeto de Integração para variáveis globais compartilhadas após a execução do Objeto de Integração. Isto pode ser feito na página .jsp que executa o Objeto de Integração. Para obter informações adicionais, consulte Inserir Propriedades do Objeto de Integração. Lembre-se de que apenas as variáveis globais compartilhadas podem ser acessadas por Objetos de Integração.
Mostrar/Ocultar Teclado Numérico

Este ícone permite mostrar ou ocultar o teclado numérico do terminal.

Mostrar OIA Textual

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.

Visualização da Tela do Host

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.

Nota:
A guia Visualização da Tela do Host somente é vista se seu terminal host atual estiver associado com a conexão padrão. Se você abrir um terminal host em uma conexão em segundo plano, você não verá esta visualização.

Editor Avançado

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.

Prompts e Extrações

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.

Origem

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.

Trabalhando com erros 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.

Importando uma Macro

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.

Nota:
As macros do Host Publisher com loops de iteração fixa reconhecem continuamente a mesma tela e executam diferentes ações. No HATS, não é possível criar uma customização de tela para reconhecer a mesma tela uma segunda vez e executar uma ação diferente da primeira vez em que foi reconhecida. Se você tentar utilizar uma macro do Host Publisher com um loop de interação fixa, seu projeto pode entrar em um ciclo infinito. As macros do Host Publisher com loop de iteração fixa podem ser identificadas, consultando o código fonte para a macro. A macro contém as tags customreco com atributos de ID HPubFixedIterationLoop e tags custom com atributos de ID HPubIncrementLoop.

Exportando uma Macro

É 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.

Nota:

Para obter considerações sobre o uso do suporte ao DBCS, consulte Gravando uma Macro.

Sugestões e Sugestões da Macro

Prevenindo um Ciclo Infinito

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.

Manipulando Telas Temporárias

É 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.