Trabalhando com Eventos de Tela

Um evento do HATS é um recurso que executa um conjunto de ações com base de um determinado estado sendo atingido. Existem dois tipos de eventos do HATS, eventos de aplicativos e eventos de tela. Para obter informações adicionais sobre eventos do aplicativo, consulte Eventos do Aplicativo. Um evento de tela é um evento do HATS que é acionado quando uma tela do host é reconhecida por atender a critérios de reconhecimento de tela específicos. Há dois tipos de eventos de tela, customizações de tela e combinações de telas.

Uma customização de tela é um evento de tela do HATS projetado para realizar um conjunto de ações quando uma tela do host é reconhecida. Exemplos de customizações de telas incluem o reconhecimento de uma tela e sua transformação em uma GUI para o usuário ou a ativação de uma macro para ignorar essa tela. A definição de customização de tela inclui um conjunto de critérios de reconhecimento de tela e uma lista de ações que podem ser tomadas quando uma tela do host atende aos critérios de reconhecimento de tela. As regras globais do nível de tela e as configurações de substituição de texto também são incluídas. Utilize o assistente Criar uma Customização de Tela para criar uma nova customização de tela.

Uma combinação de telas é um evento de tela do HATS projetado para reunir dados de saída de telas de host consecutivas e semelhantes, combiná-las e exibi-las em uma única página de saída. Um exemplo de uma combinação de telas inclui reconhecer uma tela que contém apenas dados de saída parciais e navegar por todas as telas subseqüentes para reunir todos os dados restantes para exibir para o usuário. A definição de combinação de telas inclui um conjunto de critérios de reconhecimento de tela para as telas inicial e final a serem combinadas, como navegar de tela em tela e o componente e widget a serem utilizados para reconhecer e exibir os dados reunidos de cada tela. Além disso, como a customização de tela, ela inclui uma lista de ações a serem executadas, regras globais no nível da tela e configurações de substituição de texto. Utilize o assistente Criar uma Combinação de Tela para criar uma nova combinação de tela.

Assistente para Criar uma Customização de Tela

Em seu projeto do HATS, utilize o assistente Criar uma Customização de Tela para definir customizações de tela. Você deve ter o terminal do host aberto ou uma captura de tela antes de utilizar o assistente de customização de tela. Os mapas do BMS também podem ser utilizados para criar capturas de telas utilizadas para customizações de telas. Para obter informações adicionais sobre conjuntos de mapas BMS, consulte Importando Conjuntos de Dados do BMS.

Você pode realizar qualquer uma das seguintes ações para acessar o assistente:

Para obter detalhes sobre as configurações disponíveis no assistente, consulte Editando Eventos de Telas.

As configurações definidas para a customização da tela são salvas em um arquivo (.evnt) de customização de tela. Você pode ver este arquivo expandindo a pasta Customizações de Tela na visualização Projetos HATS. Utilize o editor de evento de tela para visualizar e modificar o arquivo de customização de tela.

Assistente para Criar uma Combinação de Telas

Em seu projeto do HATS, utilize o assistente Criar uma Combinação de Telas para definir combinações de telas. Você deve ter o terminal do host aberto ou uma captura de tela antes de utilizar o assistente de combinação de tela. Os mapas do BMS também podem ser utilizados para criar capturas de telas utilizadas para combinações de telas. Para obter informações adicionais sobre conjuntos de mapas BMS, consulte Importando Conjuntos de Dados do BMS.

Você pode realizar qualquer uma das seguintes ações para acessar o assistente:

Para obter detalhes sobre as configurações disponíveis no assistente, consulte Editando Eventos de Telas.

As configurações definidas para a combinação de telas são salvas em um arquivo (.evnt) de combinação de telas. Você pode consultar este arquivo expandindo a pasta Combinações de Telas na visualização Projetos HATS. Utilize o editor de evento de tela para visualizar e modificar o arquivo de combinações de telas.

Editando Eventos de Telas

Você pode chamar o editor de evento de tela dando um clique duplo no nome de um arquivo .evnt de customização de tela ou de combinação de telas. As seguintes seções descrevem cada guia do editor de evento de tela.

Visão Geral

A guia Visão Geral do editor de evento de tela resume todas as informações especificadas ao criar o evento de tela. Ela contém o nome e a descrição do evento de tela, o nome e uma imagem da tela que foi utilizada para criar os critérios de reconhecimento de tela, um resumo das ações a serem realizadas e um resumo dos critérios de reconhecimento de tela. Para combinações de telas, esta guia também contém um resumo das configurações de navegação, componente e de critérios de reconhecimento de tela final. Nesta guia, é possível modificar a descrição do evento de tela e selecionar uma tela diferente para associar ao evento de tela. A tela selecionada é utilizada sempre que você faz alterações no evento de tela, tal como modificar critérios de reconhecimento de tela ou incluir ações.

Critérios de Reconhecimento de Tela ou Tela de Início

A guia Critérios de Reconhecimento de Tela exibe quando um evento de customização de tela é editado. A guia Tela de Início exibe quando um evento de combinação de telas é editado. Em ambos os casos as guias exibem os critérios de reconhecimento de tela que você configurou para corresponder às telas do host que acionarão o evento de tela. As telas do host podem ser reconhecidas por qualquer combinação de critérios, incluindo quantos campos totais ou campos de entrada estão na tela, as coordenadas da posição do cursor e as cadeias de texto na tela dentro de um retângulo definido ou qualquer lugar na tela. É possível incluir, editar ou remover os critérios nessa guia.

Nota:

Para obter considerações ao utilizar o suporte a DBCS, consulte Critérios de Reconhecimento de Tela/Tela Inicial.

Captura de Tela Associada

Esta opção é exibida apenas na guia Tela de Início para um evento de combinação de telas. Clique no botão Alterar para selecionar uma captura de tela diferente para associar à tela de início da combinação de telas.

Critérios de Campos

É possível utilizar o Número Total de Campos em uma tela, o Número de Campos de Entrada em uma tela, ou ambos, como os critérios de reconhecimento de tela. A configuração do Número Total de Campos inclui campos de entrada, campos de texto protegidos e campos ocultos. Estes são os primeiros dois critérios mostrados na guia.

Se você selecionar a caixa de opções para esses critérios, eles serão utilizados para reconhecer a tela. Os campos próximos a cada critério de campo mostram o número total de campos e campos de entrada para a tela especificada na guia Visão Geral. Se você alterar a tela que está sendo utilizada para este evento de tela, clique em Atualizar para atualizar os valores para a tela selecionada.

Nota:
Se você estiver utilizando os critérios do campo para reconhecer as telas que possuem um determinado número de campos e a outra tela não contiver o mesmo número de campo, essa tela não será reconhecida. Por exemplo, uma tela pode ter uma lista de dez arquivos com dez campos. Se o host exibir uma tela com apenas oito arquivos na lista e oito campos, a segunda tela não corresponderá ao número de critérios de campos do evento de tela que corresponderam na primeira tela.

Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Critérios de Posição do Cursor

Para utilizar a posição inicial do cursor como um critério de reconhecimento de tela, seja sozinho ou em conjunto com outros critérios, selecione a caixa de opções Posição do Cursor. Os campos próximos aos critérios de posição do cursor mostram a linha e a coluna da posição do cursor para a tela especificada na guia Visão Geral. Se você alterar a tela que está sendo utilizada para este evento de tela, clique em Atualizar para atualizar os valores para a linha e coluna da posição inicial do cursor na tela selecionada.

Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Critérios de Reconhecimento da Tela Opcional versus Não-Opcional

Você pode selecionar se os critérios de reconhecimento de tela configurados são opcionais ou não-opcionais. Se você não selecionar a caixa de opções Opcional, o critério de reconhecimento será considerado não-opcional. A forma como você utiliza a caixa de opções Opcional corresponde ao atributo do descritor de tela do Host On Demand, opcional.

Se você possui critérios de reconhecimento opcionais e critérios de reconhecimento não-opcionais, o HATS verificará primeiro os critérios não-opcionais. Se todos os critérios não-opcionais forem correspondentes, a tela será correspondente. Se pelo menos um dos critérios não-opcionais não for correspondente, o HATS verificará os critérios opcionais. Para que uma tela corresponda aos critérios, o HATS deve localizar todos os critérios não-opcionais ou pelo menos um critério opcional. Caso contrário, a tela falhará na correspondência. O exemplo a seguir explica esse conceito com maiores detalhes.

Nota:
Não-opcional não significa obrigatório.

Imagine que você tenha definido a localização da posição do cursor e duas cadeias de texto com os valores mostrados no seguinte exemplo:

Cursor position recognition  Opcional     
                             Row: 1   Column: 1

String recognition           Non-optional   
                             String 1: Welcome
                             Start position: Row: 1   Column: 6
                             End position:   Row: 1   Column: 12

                             String 2: Username
                             Start position: Row 20   Column 10
                             End position:   Row 20   Column 17

Nesse exemplo, o HATS deve localizar as cadeias de texto e a posição do cursor para que a tela seja correspondente. Como o HATS verifica primeiro os critérios não-opcionais, o HATS procura primeiro pelas cadeias de texto. Se o HATS não puder localizar as duas cadeias de texto nas regiões especificadas da tela do host, ele verificará se o critério opcional (posição do cursor) pode ser localizado.

Correspondência Invertida dos Critérios de Reconhecimento da Tela

Você pode selecionar se os critérios de reconhecimento de tela configurados correspondem ou não à tela do host. Se você selecionar a caixa de opções Inverter, o critério de reconhecimento não deve corresponder à tela para o critério a ser considerado verdadeiro.

Reciprocamente, se você limpar a caixa de opções Inverter, o critério de reconhecimento deve corresponder à tela para que o critério seja considerado verdadeiro.

A forma como você utiliza a caixa de opções Inverter corresponde ao atributo do descritor de tela, invertmatch.

Critérios Adicionais

Critério da Cadeia

Os critérios de local da cadeia de texto são mostrados na seção Critérios Adicionais da guia. Se você definiu uma localização da cadeia como um critério de reconhecimento de tela, ela será mostrada na tabela. A tabela mostra o tipo de local de tela que contém o texto, alguns dos caracteres do texto selecionado e se o texto faz distinção entre maiúsculas e minúsculas, é optional ou invertido.

Se você realçar uma linha da tabela que define um critério de cadeia e clicar em Editar ou se você clicar em Incluir, o diálogo Critérios de Tela aparecerá. No painel de diálogo, é possível modificar ou especificar as informações da cadeia de texto. Também é possível selecionar os atributos para a cadeia (distinção entre maiúsculas e minúsculas, opcional ou invertido). O painel mostra a tela selecionada na guia Visão Geral.

É possível selecionar qualquer texto na tela, arrastando um retângulo ao redor do texto. Coloque seu cursor no ponto na tela, clique e mantenha pressionado o botão esquerdo do mouse e mova o cursor para outra localização na tela, para desenhar o retângulo. Os campos à direta do diálogo mostram o texto que você selecionou e os números de linha e coluna iniciais e finais do retângulo. É possível especificar a parte da tela que deve conter o texto, clicando em um dos botão de opções para Qualquer local na tela, Em uma posição especificada ou Dentro da região retangular. Se o texto que você selecionou tiver que fazer distinção entre maiúsculas e minúsculas para ser reconhecido como correspondente aos critérios de reconhecimento de tela, selecione a caixa de opções Distinção entre maiúsculas e minúsculas.

Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Clique em OK quando tiver concluído suas seleções.

Critério de Variável Global

Você pode utilizar variáveis globais para definir seus critérios de reconhecimento de tela clicando na seta para baixo ao lado do botão Incluir e selecionando Critério de Variável Global. Se você utilizar o critério de variável global, deverá especificar uma variável global na lista suspensa Variável Global ou digitar o valor. Especifique a Lógica de Verificação selecionando um dos cinco marcadores:

Para obter uma explicação das caixas de opção Opcional e Invertida, na seção Atributos, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Para obter mais informações sobre a programação de variáveis globais, consulte a publicação HATS Web Application Programmer's Guide ou HATS Rich Client Platform Programmer's Guide, dependendo do seu ambiente de aplicativos.

Critério de Cor

Você pode definir seus critérios de reconhecimento de tela por cor, clicando na seta para baixo ao lado do botão Incluir e selecionando o Critério de Cor. Isso abrirá um painel no qual você poderá selecionar a posição da linha e da coluna bem como cores de primeiro plano e de fundo.

Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Comparar Região ao Critério de Valor

Comparar região ao critério de valor permite a comparação de texto de uma região selecionada da tela de host e para um valor fisicamente codificado.

Inicie desenhando uma caixa ao redor da região do terminal ou digite as coordenadas para o reconhecimento da seção Definir Região. O valor Atual no terminal também será mostrado na caixa de texto.

Em seguida, você poderá especificar a qual região será comparada e como será comparada. Na seção Definir Comparação, selecione como sua região será comparada, selecionando na lista suspensa ao lado da Região e informe com o que será comparado na caixa de texto Valor.

O Tipo de Comparação será Numérico ou Texto (com uma opção da caixa de opções Distinção entre maiúsculas e minúsculas).

Os atributos também podem ser definidos. Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Clique em OK quando tiver concluído suas seleções.

Comparar a Região ao Critério de Região

Comparar região ao critério de região permite a comparação de uma região na tela de host para outra região da mesma tela de host.

Primeiramente, selecione a guia Primeira Região e inicie, desenhando uma caixa ao redor da região do terminal ou digite as coordenadas para o reconhecimento da seção Definir Região. O valor Atual no terminal também será mostrado na caixa de texto.

Em seguida, você poderá especificar como essas regiões serão comparadas na seção Definir Comparação, selecionando no menu suspenso entre a Região 1 e a Região 2.

O Tipo de Comparação será Numérico ou Texto (com uma opção da caixa de opções Distinção entre maiúsculas e minúsculas).

Os atributos também podem ser definidos. Para obter uma explicação das caixas de opçãoOpcional e Inverter, consulte Critérios de Reconhecimento da Tela Opcional versus Não-Opcional e Correspondência Invertida dos Critérios de Reconhecimento da Tela.

Repita as mesmas etapas para a guia Segunda Região e, em seguida, clique em OK quando tiver terminado.

Renderização (Apenas Combinação de Telas)

A guia Renderização é exibida apenas para um evento de combinação de telas. Utilize esta guia para configurar qual componente utilizar para reconhecer as informações a serem reunidas pela combinação de telas. Além disso, utilize esta guia para configurar qual widget utilizar para renderizar o componente. Um subconjunto dos componentes e widgets do HATS é suportado nos eventos de combinação de telas. Consulte Inserir Componente do Host para obter informações adicionais sobre a utilização dos componentes e widgets do HATS.

Você pode clicar no botão Alterar Região para alterar a captura de tela e a região da tela a ser considerada pelo componente.

Você também pode utilizar a seguinte configuração em projetos que não são de portlet para controlar quando os resultados da combinação de telas são exibidos pela primeira vez para o usuário em relação a quando a combinação de telas é concluída.

usar carregamento e conteúdo dinâmico de modo em cache  Apenas Web 
Deixe esta caixa limpa para especificar que o HATS deve navegar através de todas as telas da combinação de telas e combinar todos os resultados antes de exibi-los ao usuário. Selecione esta caixa para especificar que o HATS deve começar a exibição dos resultados ao usuário assim que os resultados da primeira tela forem reunidos e deve continuar atualizando a exibição dos resultados conforme as telas forem navegadas.

Navegação (Apenas Combinação de Telas)

A guia Navegação é exibida apenas para um evento de combinação de telas. Esta guia exibe os comandos necessários para navegar a partir da tela de início, através de telas intermediárias, até a tela final da combinação de telas. Utilize os botões Incluir, Editar e Remover para configurar comandos para as direções de navegação Movimento para Cima e Movimento para Baixo. No diálogo Incluir Comando ou Editar Comando que aparece, há três opções de comandos. Vários comandos por direção de navegação podem ser configurados clicando no botão Incluir várias vezes. Abaixo estão as três opções de comandos que podem ser configuradas.

Enviar Tecla
Utilize esta opção para selecionar uma tecla do host para enviar ao sistema do host.
Inserir texto
Utilize esta opção para inserir texto no local do cursor atual.
Definir posição do cursor
Utilize esta opção para configurar a posição atual do cursor na tela do host.

Tela Final (Apenas Combinação de Telas)

A guia Tela Final é exibida apenas para um evento de combinação de telas. Esta guia exibe os critérios configurados que definem o final da combinação de telas. É possível incluir, editar ou remover os critérios nessa guia. Você pode selecionar um de três tipos de critérios finais, Apenas Contagem de Iteração, Apenas Descritor de Tela ou Primeira Correspondência da Contagem de Iteração ou do Descritor de Tela.

Selecionar Critérios de Encerramento

Apenas Contagem de Interação
Selecione isto, juntamente com a configuração do Número de Iterações, para especificar que esta combinação de telas termina após um número fixo de telas.
Apenas Descritor de Tela
Selecione isto, juntamente com as outras configurações de reconhecimento de tela, por exemplo o Número Total de Campos, o Número de Campos de Entrada, a Posição do Cursor ou os Critérios Adicionais, para definir a tela final para a combinação de telas.
Primeira correspondência da contagem de iterações ou do descritor de tela
Selecione isto, juntamente com todas as outras configurações, para especificar que a combinação de telas finaliza após um número fixo de telas ou quando a tela final é reconhecida, o que ocorrer primeiro.

Número de Iterações

Selecione esta caixa para configurar o número de vezes para desempenhar a navegação definida na guia de navegação. Quando o número é alcançado, a tela final é assumida como sendo alcançada.

Captura de Tela Associada

Clique no botão Alterar para selecionar uma captura de tela diferente para associar à tela final da combinação de telas.

Configurações do Descritor de Tela

As configurações do descritor de tela para a tela final são as mesmas que as configurações de critérios de reconhecimento para a tela de início. Consulte Critérios de Reconhecimento de Tela ou Tela de Início para obter uma explicação destas configurações.

Ações

A guia Ações do editor de evento de tela exibe as ações configuradas para o evento de tela.

Se você deseja alterar a ordem das ações, selecione uma e clique em Para Cima ou Para Baixo para mover a ação para cima ou para baixo na lista.

Você também pode Editar ou Remover as ações que aparecem na lista e também Incluir uma nova ação.

Estas ações são executadas pelo tempo de execução do HATS na ordem em que elas estão listadas. Se você desejar exibir a tela do host transformada para o usuário com alguns campos previamente preenchidos, por exemplo, certifique-se de modificar a tela do host (utilizando uma ação Inserir Dados, por exemplo) antes de exibir a tela do host transformada (utilizando uma ação Aplicar Transformação). Se você utilizar uma ação Reproduzir Macro ou uma ação Enviar Tecla em um evento de tela, essa ação deverá ser a última ação na lista.

Quando todas as ações no evento de tela tiverem sido desempenhadas, o HATS poderá enviar um comando padrão ao host de transformação para conduzir o aplicativo do host para fora da tela reconhecida atualmente. Caso contrário, um loop infinito poderá ocorrer através das ações no evento de tela. Selecionar Enviar uma tecla do host quando a lista for concluída para causar uma alteração na tecla permite determinar qual tecla enviar após a conclusão da lista de ações. Por padrão, o tempo de execução do HATS enviará um [enter] para o host de transformação no final da lista de ações. Uma tecla de auxílio será enviada se:

Portanto, se a lista de ações contiver uma ação Aplicar Transformação e o usuário enviar o comando F2 em resposta à transformação, o comando [pf2] será enviado em vez de qualquer comando padrão. De forma semelhante, se o evento de tela for enviado com uma ação Reproduzir Macro, nenhum comando padrão será enviado.

É possível incluir, editar ou remover as ações nessa guia. Estas são as ações possíveis:

Todos os tipos de ações definidos para o evento de tela e suas descrições serão mostrados na tabela na guia Ações. Se você realçar uma linha da tabela e clicar em Editar, o diálogo Editar Ação aparecerá.

Se você clicar em Incluir, o assistente para Selecionar uma Ação aparecerá. O primeiro painel mostra uma lista de todas as ações disponíveis. É possível selecionar a ação que você deseja que ocorra, clicando no botão de opções dessa ação e clicando em Avançar. Dependendo da ação selecionada, o resto do painel exibirá informações que poderão ser especificadas para essa ação.

Nota:
Não é possível alterar o tipo de ação no diálogo Editar Ação. É possível alterar apenas as informações que se aplicam à ação.

Ação Aplicar Transformação

Se você decidir aplicar uma transformação como uma ação deste evento de tela para projetos da Web do HATS, poderá selecionar a transformação que deseja aplicar a partir da lista suspensa de transformações definida no projeto.

Para projetos rich client do HATS , é possível utilizar o botão Procurar para exibir uma lista de transformações de telas no caminho da classe do projeto atual. Isto geralmente inclui apenas transformações no projeto atual, mas também pode incluir outras transformações de outros plug-ins referidos pelo projeto ou transformações atuais contidas nos arquivos .jar referidos pelo projeto atual.

Para obter informações adicionais, consulte Trabalhando com Transformações.

O campo Modelo possui o (modelo padrão) selecionado por padrão. A menos que você selecione um modelo diferente a ser aplicado com esta transformação específica, o modelo que circunda a transformação na GUI é o modelo especificado como o modelo padrão para o projeto. A lista suspensa contém todos os modelos definidos no projeto.

Clique em Teclas do Host Imediatas se desejar que alguma tecla do host que o usuário pressiona seja enviada para o host imediatamente em vez de aguardar até que todas as ações tenham sido desempenhadas. Selecione as caixas de opções das teclas que devem ser enviadas imediatamente ao host. Se uma tecla do host for enviada imediatamente, nenhuma outra ação ocorrerá. O envio imediato dessas teclas se aplica apenas à transformação atual e não a todas as transformações no projeto.

Você pode desativar o processamento das regras globais no nível do projeto e no nível da tela limpando a caixa de opções Aplicar regras globais no nível do projeto e no nível da tela.

Ação Executar Lógica de Negócios

Se você decidir executar alguma lógica de negócios como a ação deste evento de tela, deverá especificar nos campos fornecidos o nome da classe Java™ completo e o método Java para a lógica de negócios que deseja executar. É possível clicar em Procurar ao lado do campo Nome da classe para selecionar uma classe na qual o método da lógica de negócios é definido. É possível selecionar qualquer classe definida na pasta Origem na guia da visualização Projetos HATS do HATS Toolkit. Se você não tiver criado o código Java para esta lógica de negócios, clique com o botão direito do mouse na guia da visualização Projetos HATS e clique em Novo HATS > Lógica de Negócios para chamar o assistente Criar Lógica de Negócios.

Para obter mais informações sobre a lógica de negócios, consulte a publicação HATS Web Application Programmer's Guide ou HATS Rich Client Platform Programmer's Guide, dependendo do seu ambiente de aplicativos.

Ação Extrair Variável Global

Para obter a região da tela de host, defina as linhas e colunas iniciais e finais para a área da tela que você deseja atribuir como uma variável global. É possível extrair as informações da tela e defini-las como uma variável global. Ao extrair uma variável global, é possível especificar um nome ou selecionar um nome de variável global existente da lista drop down para o campo Nome.

Para especificar como o texto extraído das múltiplas linhas na tela de host é definido em uma variável global, clique em Avançado. Você deve selecionar um dos botões de opções para especificar se a extração deve ser tratada como uma cadeia ou como uma lista de cadeias (indexada). Se você selecionou uma variável global existente no campo Nome antes de ter clicado em Avançado, deve clicar em um dos seguintes botões de opções, especificando como o HATS deve tratar dos dados extraídos:

Para as duas opções que utilizam o índice especificado, você deve inserir o número do índice no campo Índice.

O exemplo a seguir ilustra como o valor da variável é modificado com base na opção selecionada. Comece com uma variável indexada existente denominada "sample". Os valores de "amostra" são "a b c d". O "a" no valor possui um índice 0, portanto, o valor de "sample[0]" é "a" e o "b" no valor possui um índice 1, portanto, o valor de "sample[1]" é "b" e assim por diante. Imagine que você extraia um novo conjunto de valores "e f g".

A seleção da caixa de opção Compartilhado permitirá que a variável global seja compartilhada.

Para obter informações adicionais sobre variáveis globais, consulte o Interagindo com Variáveis Globais.

Ação Inserir Dados

Utilize o mouse ou as configurações de Linha Inicial e Coluna Inicial para configurar a região na tela do host na qual você deseja inserir os dados. Você pode realçar determinados campos na tela do host selecionando as diferentes opções ao lado dos campos Realçar. Se quiser ver onde os campos de entrada estão definidos na tela, selecione a caixa de opções Entrada. Se quiser ver quais campos estão protegidos, selecione a caixa de opções Protegido. Se quiser destacar quaisquer campos ocultos, selecione a caixa de opções Oculto. Para modificar as cores dos campos de entrada, protegidos ou ocultos que estão em destaque, consulte Utilizando Preferências do HATS.

Clique em Avançar, em seguida selecione se os dados são uma cadeia ou uma variável global, clicando no botão de opções apropriado. Para inserir uma cadeia, digite o texto no campo de entrada fornecido. Para inserir uma variável global, selecione o nome de uma variável global existente a partir da lista suspensa ou digite o nome da variável global. Se você deseja utilizar uma variável global compartilhada a partir de um aplicativo diferente, precisará digitar o nome no campo.

Se o valor da variável global for indexado (contém uma lista de cadeias), clique em Avançado. Você deve clicar em um dos botões de opções para especificar se todas as cadeias são inseridas na posição especificada, uma após a outra, ou se as cadeias são inseridas como linhas separadas em uma região retangular da tela.

A seleção da caixa de opção Compartilhado permitirá que a variável global seja compartilhada.

Para obter informações adicionais sobre variáveis globais, consulte o Interagindo com Variáveis Globais.

Nota:
A inserção de informações em uma tela do host deverá ocorrer antes que qualquer transformação ocorra para que a variável global apareça na GUI. Consulte Ações para obter informações sobre a modificação da ordem das ações.

Ação Definir Variável Global

É possível definir as variáveis globais a serem utilizadas por outros objetos dentro do seu projeto e também por outros projetos no .ear. Ao definir uma variável global, é possível especificar um nome ou selecionar um nome de variável global existente da lista suspensa para o campo Nome. Se você selecionar uma variável global indexada existente, clique em Avançado para especificar como tratar da definição do valor. As seguintes opções estão disponíveis:

Para as duas opções que utilizam o índice especificado, você deve inserir o número do índice no campo Índice.

Para obter um exemplo de como um valor de variável é configurado com base na opção selecionada, consulte Ação Extrair Variável Global.

Se você estiver definindo a variável global para um valor fixo, digite o valor no campo de entrada.

Se você estiver definindo a variável global para um valor calculado, especifique os operandos a serem utilizados e a operação do cálculo. Os operandos podem ser valores fixos que você digita no campo ou você pode utilizar variáveis globais existentes para o cálculo. Se você utilizar um valor global indexado existente e deseja especificar um índice da variável a ser utilizado como operando, clique em Avançado. Insira o número do índice no campo Índice.

A seleção da caixa de opção Compartilhado permitirá que a variável global seja compartilhada.

Para obter informações adicionais sobre variáveis globais, consulte o Interagindo com Variáveis Globais.

Ação Remover Variável Global

Use essa ação para remover uma ou mais variáveis globais. É possível mover uma variável global local ou uma compartilhada, todas as variáveis globais locais, todas as variáveis globais compartilhadas ou todas as variáveis globais locais e compartilhadas. Para a opçãoUma Local ou Uma Compartilhada, insira o nome da variável global que deseja remover ou selecione o nome da lista drop-down correspondente.

Nota:
Nomes de variáveis globais compartilhadas, criadas em outro aplicativo da Web do HATS executado no mesmo arquivo .ear ou criadas em outro aplicativo rich client do HATS executado no mesmo ambiente de rich client podem não aparecer na lista suspensa de variáveis globais. Para remover uma das variáveis globais compartilhadas, insira seu nome no campo de entrada para a opção Uma Compartilhada.

Para obter informações adicionais sobre variáveis globais, consulte o Interagindo com Variáveis Globais.

Ação Enviar Variável Global

Esta ação é aplicável apenas aos projetos de portlet padrão do HATS (JSR 168). Ela pode ser utilizada para ajudar a desenvolver uma solução de comunicação de portlet. Para obter informações adicionais, consulte Comunicação de Portlet.

Utilize esta ação para enviar o valor de uma variável global como um valor java.lang.String em uma propriedade de um portlet JSR 168 do HATS para outros portlets JSR 168 (HATS ou não HATS) no servidor de portal. No campo Propriedade, insira o nome da propriedade que está sendo enviada. O nome deve corresponder ao nome da propriedade utilizado pelo portlet de recebimento, por exemplo, o mesmo nome de propriedade definido nas configurações de Portlet na guia Outro em um portlet de recebimento JSR 168 do HATS. No campo Variável Global, insira o nome da variável global. Se o valor da variável global for indexado, clique em Avançado. Em seguida, especifique se irá utilizar Enviar todos os Índices da variável, opcionalmente separados por um delimitador de cadeia ou Enviar um Índice Único incluindo qual Índice enviar. Selecione a caixa de opção Compartilhada se a variável global for uma variável global compartilhada.

Ao clicar em Concluir, a ação será incluída no arquivo de evento da tela (.evnt). Além disso, um arquivo WSDL (Web Services Description Language) é criado, caso ainda não exista, e uma propriedade de envio é definida no arquivo WSDL. O nome do arquivo WSDL é <nome_do_projeto>.wsdl. O arquivo WSDL é necessário para conectar os portlets utilizando a ferramenta de conexão do WebSphere Portal. O arquivo portlet.xml foi atualizado para referenciar o local do arquivo WSDL.

Se você clicar em Remover, a ação é removida do arquivo de evento da tela, mas a propriedade não é removida do arquivo WSDL. É possível editar o arquivo WSDL e usar o editor de WSDL para remover a propriedade.

Nota:
Se você não remover a propriedade do arquivo WSDL, o portlet do HATS é executado de forma adequada no estado em que se encontra.
Notas:
  1. Esta ação deve se seguir à ação Aplicar Transformação para o evento.
  2. As seguintes ações são as únicas ações suportadas entre a ação Aplicar Transformação e a ação Enviar Variável Global:
  3. As ações acima são úteis se você deseja processar a variável global antes de enviá-la para outros portlets. Por exemplo, você deseja enviar o ID do usuário inserido na tela de login para outros portlets. Nesse exemplo, você inclui a ação Aplicar Transformação para transformar a tela de login e uma ação Extrair Variável Global para extrair a região do campo de entrada do ID do usuário e salvá-la em uma variável global. Em seguida, você inclui a ação Enviar Variável Global para enviar o ID do usuário armazenado na variável global para outros portlets.
  4. As seguintes ações não são suportadas entre a ação Aplicar Transformação e a ação Enviar Variável Global. Se alguma dessas ações for executada entre as ações Aplicar Transformação e Enviar Variável Global, serão executadas normalmente, mas a variável global não será enviada.

Ação Mostrar URL ou SWT Composto Apenas RCP 

Utilize essa ação para mostrar uma página da Web ou um composto SWT na área de transformação da visualização Transformação. Para mostrar uma página da Web, especifique o endereço de URL (Localizador Uniforme de Recursos) da página da Web no campo URL. Para mostrar um SWT composto, digite seu nome de classe no campo Classe Composta ou utilize o botão Procurar para selecionar um SWT Composto dentro do projeto do rich client. A página da Web ou SWT composto é mostrado circundado pelo modelo selecionado a partir da lista de modelos. Após a página da Web ou SWT composto ser carregado, o usuário deve clicar em um botão Continuar para retornar ao aplicativo do HATS.

Nota:
Para obter informações sobre como implementar o SWT composto, incluindo um botão Continuar, consulte a publicação HATS Rich Client Platform Programmer's Guide.

Ação Mostrar URL  Apenas Web 

Se desejar mostrar uma página da Web como a ação deste evento de tela, você deverá especificar um endereço de URL (Localizador Uniforme de Recursos) da página da Web no campo URL. A página da Web é mostrada cercada pelo modelo padrão, semelhante ao modo como uma transformação é mostradas. Após a página da Web ser carregada, o usuário retorna para o aplicativo do HATS clicando no botão Continuar na parte inferior da página da Web.

Se objetos incorporados não são suportados ou não são permitidos pelo navegador, por exemplo, objetos com tipos de dados de html, essa ação mostra um link para a página da Web ao invés de mostrar o conteúdo da página da Web. Para obter uma lista de navegadores da Web suportados e limitações, consulte a seção de pré-requisitos do HATS do Centro de Informações do HATS no endereço http://publib.boulder.ibm.com/infocenter/hatshelp/v75/index.jsp.

Quando você especificar o destino da ação Mostrar URL, a estação de trabalho do cliente deverá ter acesso à página de destino. Por causa disto, você pode não conseguir especificar uma página da Web de destino protegida por seu firewall corporativo, por exemplo, a menos que a estação de trabalho do cliente tenha acesso direto à página de destino. Certifique-se de fornecer a URL completa para o destino, caso contrário, o cliente poderá não conseguir resolver o nome do host da página de destino. Se a página de destino não estiver no servidor de aplicativos que hospeda o aplicativo do HATS (um acesso de "domínio cruzado"), as configurações do navegador poderão precisar ser ajustadas para permitir que a página de destino fora do servidor seja carregada.

Por exemplo, no Internet Explorer V6.0, ou posterior, acesse o menu Ferramentas e selecione Opções da Internet, em seguida, a guia Segurança. O navegador exibe a zona de conteúdo da Web no canto inferior direito da janela do navegador. Se a página estiver na zona da Internet, por exemplo, poderá ser necessário ajustar as configurações de zona da Internet para permitir que a página de destino seja carregada. Escolha a zona correta e, em seguida, pressione o botão Nível Personalizado. Role até as configurações Diversos e selecione uma configuração para Acessar origens de dados nos domínios. Selecione Ativar para permitir que a página de destino seja carregada. Selecione Avisar para ser avisado antes de carregar a página de destino. Se você selecionar Desativar, talvez não seja possível carregar a página da Web de destino.

Ação Redirecionar para URL  Apenas Web 

A ação redirecionar para URL permite transmitir o controle de um aplicativo da Web do HATS orientado por transformação para uma JSP que chama um ou mais Objetos de Integração encadeados. Isso permite que você utilize os Objetos de Integração que já criou. Os Objetos de Integração podem utilizar a conexão existente ou uma conexão em segundo plano.

Esta ação é suportada nos projetos da Web do HATS e nos projetos de portlet padrão do HATS, mas não nos projetos de portlet IBM® do HATS.

Para incluir uma ação avançar em um evento, você deve especificar os seguintes parâmetros:

Nota:
Se você estiver planejando executar um JSP grande, defina a propriedade do sistema da JVM com.sun.tools.javac.main.largebranch=true e, em seguida, reinicie o servidor. Você poderá configurar as propriedades da JVM utilizando o console administrativo, configurando argumentos para a JVM ou criando uma Propriedade Customizada.

Avançar para URL permite várias formas de se gerenciar a conexão que será utilizada pela lógica do JSP/Objeto de Integração. Por exemplo:

Ao usar a ação redirecionar, o controle não volta automaticamente para o aplicativo do HATS depois que os Objetos de Integração tiverem sido executados. A JSP deve transferir o controle explicitamente de volta para o aplicativo do HATS. Se a conexão padrão não foi feita antes da ação redirecionar e os Objetos de Integração utilizaram a conexão padrão, você deve transmitir a conexão para o aplicativo do HATS a ser usado como a conexão padrão. Neste caso, você deve configurar um conjunto de parâmetros de pedido no HttpServletRequest antes de encaminhar o pedido para o aplicativo do HATS. O parâmetro é CommonConstants.HATS_EXISTING_CONN. É possível obter o valor necessário para esse parâmetro, chamando o método getHPubEndChainName no último Objeto de Integração na cadeia.

Por exemplo, em um projeto da Web, o FORM pode se parecer com o seguinte:

<FORM NAME="exampleLink" METHOD="GET" 
ACTION='<%= response.encodeURL(request.getContextPath()+"/entry")%>'>
<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>" 
VALUE="<%= ExampleIO.getHPubEndChainName()%>" />
<INPUT TYPE="submit" VALUE="Return to HATS application" />
</FORM>

Você também pode usar o menu Ferramentas do HATS para inserir encaminhar para Aplicativo do HATS. Essa opção vai inserir automaticamente o código com uma exceção. Ela não incluirá a seguinte linha:

<INPUT TYPE="HIDDEN" NAME="<%= CommonConstants.HATS_EXISTING_CONN %>"
       VALUE="<%= IntegrationObjectName.getHPubEndChainName() %>" />

Se deseja transmitir a conexão para o aplicativo do HATS, você deve editar a JSP e incluir a linha de códigos imediatamente após a linha de códigos "FORM NAME=".

Em todos os outros casos (quando a conexão padrão tiver sido aberta antes que a ação de avançar tenha sido chamada ou quando os Objetos de Integração não utilizarem a conexão padrão), você não terá que retornar à conexão. É possível omitir a primeira instrução INPUT a partir do exemplo nesses casos.

Nota:
É possível que a lógica do JSP/Objeto de Integração seja a primeira entrada no seu aplicativo HATS. Nesse caso, é possível usar o código identificado para orientar seu aplicativo do HATS e transmitir a conexão estabelecida pela lógica de JSP/Objeto de Integração para o aplicativos do HATS a ser usado como a conexão padrão (se a conexão foi criada a partir da definição de conexão padrão).

Reproduzir Macro

Se você gravou uma macro, poderá selecioná-la a partir da caixa drop-down para reproduzi-la. A macro começará a ser reproduzida sempre que esse evento for selecionado. Deve ser observado que a ação Reproduzir macro executa uma macro na conexão atual. Executar transação de macro, entretanto, cria uma nova conexão na qual executar a macro.

Para reproduzir uma macro, selecione o marcador Reproduzir macro na lista Incluir Ação, em seguida selecione o nome da macro a ser reproduzida da lista drop down. Se você definir que uma macro deve ser reproduzida como uma ação deste evento de tela, esta será a última ação aplicada. Certifique-se de utilizar critérios bem específicos para reconhecer essa tela, para assegurar que a macro não será reproduzida em outras telas. Por exemplo, se você estiver utilizando um critério de cadeia, especifique que ela deve ser encontrada na localização exata, e não em qualquer parte da tela. Certifique-se de que a tela na qual a macro termina não atenda aos critérios para iniciar a macro. Quando você registrar uma macro, certifique-se de que a tela final não seja a tela reconhecida pelo evento de tela. Se a tela reconhecida for a tela final da macro, será criado um loop e a opção para enviar um tecla para forçar a tela a alterar não será executada quando reproduzir macro for desempenhada.

Geralmente você não aplica uma transformação e reproduz uma macro como ações na mesma tela. Se ambas as ações forem especificadas, a transformação será aplicada e a macro será executada apenas após o usuário interagir com a tela transformada. A reprodução de uma macro é sempre a última ação a ser executada. Se você desejar reproduzir uma macro automaticamente quando uma tela for reconhecida, não aplique uma transformação a essa tela. Quando você criar o evento de tela para essa tela, deverá limpar a caixa de opções Aplicar uma Transformação na página Ações do assistente. Você pode criar outro evento de tela para a última tela do host para a qual sua macro navegará e aplicar uma transformação para controlar a aparência da página da Web derivada dessa tela final.

Você pode inserir um botão de macro em uma transformação para permitir que o usuário execute uma macro a partir da tela transformada. Neste caso, o usuário poderá interagir com a tela transformada ou clicar no botão da macro para fazer com que uma macro comece a executar na tela do host atual.

É possível gravar macros no HATS Toolkit utilizando o terminal host. Para obter informações adicionais sobre a importação de macros, consulte Macros e Terminal Host.

Executar Transação de Macro

Selecionar esta ação permite reproduzir uma macro registrada em uma nova instância de uma conexão designada, mesmo uma conexão com um host diferente. Depois de clicar no botão Executar transação da macro, selecione qual macro você deseja reproduzir na lista suspensa Reproduzir uma macro e qual conexão utilizar na lista Executar na Conexão.

Nota:
Se houver uma macro de conexão definida para a conexão designada, a macro de conexão será executada antes de sua macro selecionada.

Enviar Tecla

Essa ação envia uma tecla especificada para a tela de host. Depois de ter selecionado o local na tela para aplicar sua ação, selecione qual tecla enviar para sua tela do host.

Selecione as teclas PF e PA ou Outras teclas de host a partir da lista com marcadores. Em seguida, clique no menu suspenso do marcador que você selecionou e selecione a tecla.

Tenha em mente que a tecla que você selecionar deve alterar a tela de host de alguma forma ou o resultado será um ciclo infinito da ação.

A ação Enviar Tecla sempre deve ser executada por último ao considerar a ordem de sua lista de ações.

Desconectar

A ação Desconectar executa imediatamente o evento de desconexão. Por padrão, o evento de desconexão desconecta e libera a conexão padrão.

Pausar

A ação Pausar permite especificar o período de tempo (em milissegundos) antes de continuar com o processamento normal.

Pré-apresentação do Portlet

Ao utilizar a Pré-apresentação do Portlet, você poderá incluir os delimitadores Início e Final da Pré-apresentação utilizando o botão Incluir Delimitador de Bloco na guia Ações.

Esta ação não é suportada para portlets padrão do HATS.

O Início e Fim da Pré-apresentação permitem colocar ações que devem ser executadas na fase de pré-apresentação de processamento do portlet. Utilize o botão Incluir Delimitador de Bloco quando implementar o sistema de mensagens do portlet ou portlets cooperativos. Clique no botão Incluir Delimitador de Bloco uma vez para inserir o delimitador de início de pré-apresentação e clique novamente em Incluir Delimitador de Bloco para inserir o delimitador de fim de pré-apresentação. Utilize os botões Para Cima e Para Baixo para mover a ação que precisa ser executada no delimitador de bloco mais para cima ou mais para baixo na lista. Quando for necessário chamar a ação será determinado o local do bloco de pré-apresentação. Ao executar um evento de tela, você poderá acionar a ação de pré-apresentação primeiro ou no início da lista Ações. Se desejar executar a ação de pré-apresentação após a interação com o usuário na tela, você deverá acionar o evento na parte inferior da lista Ações. Para obter mais informações sobre como utilizar o delimitador de blocos com portlets, consulte a publicação HATS Web Application Programmer's Guide.

Regras Globais

As regras globais permitem o reconhecimento padrão e a transformação de campos de entrada do host e trabalham com telas (exibidas por padrão) customizadas e não-customizadas. Elas podem ser definidas no nível do projeto e no nível da tela. Utilize esta guia para especificar regras globais no nível da tela. Consulte Regras Globais para obter detalhes sobre como definir uma regra global.

As regras globais de nível de tela permitem que você utilize exibição padrão para uma tela e, além disso, customize os campos de entrada na tela. Por exemplo, utilizando o tipo padrão Localizar Campos de Entrada Dentro de uma Região Especificada em sua regra global no nível da tela, você poderá identificar um campo de entrada para customizar em uma tela, por exemplo dados dentro de uma tabela, enquanto ainda utiliza a renderização padrão para a tela.

Se uma regra global no nível do projeto e uma no nível da tela estiverem definidas para o mesmo campo de entrada, a regra no nível da tela terá prioridade.

Substituição de Texto

A guia Substituição de Texto exibe uma tabela na qual você pode especificar o texto da tela do host protegida original que deseja substituir, juntamente com o texto, conteúdo HTML  Apenas Web  ou imagem a ser utilizada como a substituição. Também é mostrado se a procura de texto faz distinção entre maiúsculas e minúsculas e se o suporte à expressão comum está sendo utilizado. Clique no botão Incluir para criar os novos parâmetros de substituição de texto.

Você pode selecionar o texto que deseja substituir a partir da janela de seleção, ou digitar o texto na caixa de texto Substituir.

Se a caixa de opções Distinção Entre Maiúsculas e Minúsculas for selecionada, ela procurará apenas o texto exato digitado na caixa de texto Substituir.

Para substituir por texto, digite o texto que deseja substituir na janela abaixo.

Se você digitar o código HTML  Apenas Web , o HATS o realçará em vermelho, permitindo que você saiba se seu código é válido ou não.

Clicar no ícone Inserir permite incluir um botão ou link. As configurações para Inserir Botão e Inserir Link são:

Legenda
O texto que deve aparecer nos botões ou links processados
Tecla de Ação
A tecla AID do host a ser enviada para o host quando botões ou links forem clicados.
Classe de Estilo Apenas Web 
O nome da classe Cascading Stylesheet (CSS) que controla a aparência dos botões ou links. O padrão para botões é 'HATSBUTTON'. O padrão para links é 'HATSLINK'

Também é possível substituir o texto pelas imagens, clicando no botão de opções Imagem e selecionando uma na lista suspensa ou clicando no botão Importar.

Selecionar a caixa de opção Expressão Comum permite que você utilize o suporte à expressão comum Java como parte do algorítmo de substituição de texto. Expressões comuns são padrões de caracteres que descrevem um conjunto de cadeias. Você pode utilizar expressões comuns para localizar e modificar ocorrências de um padrão. Por exemplo, especificar:

Substituir: ([\.\-|_\w]+)@([\-\_\.\w]+)
Por: <a href="mailto:$1@$2" class="HATSLINK">$1@$2</a>

resultaria na seguinte substituição, que converte um endereço de e-mail em uma tela do host em um link.

Texto da tela do host original: user@company.com
Texto de Substituição: 
<a href="mailto:user@company.com" class="HATSLINK">user@company.com</a>

Você pode incluir, modificar ou remover qualquer especificação de substituição de texto, utilizando os botões à direita da tabela de valores. O texto pode ser substituído no nível do projeto, no nível do item de processamento, no nível de transformação e também no nível do componente.

Se você possuir uma lista de substituições de textos, o texto ou o HTML criado por uma substituição de texto poderá ser substituído por uma substituição de textos subseqüente. Por exemplo, se você substituir uma cadeia na tela do host por <img src="yourImage.jpg"> e uma substituição de texto subseqüente substituir sr por outra cadeia, a tag <img> não funcionará mais corretamente, pois o parâmetro src foi alterado. Você pode evitar esta situação reordenando seus itens de substituição de texto ou tornando-os mais específicos para assegurar que eles não substituirão acidentalmente cadeias anteriores.

Notas:
  1. Deve-se tomar cuidado ao utilizar substituição de texto. A substituição de texto por um número diferente de caracteres nas cadeias poderá causar alterações na representação da GUI da tela. Dependendo do widget utilizado para apresentar uma região de uma tela, o texto em uma linha da tela poderá ser contraído, expandido ou forçado em uma nova linha. Além disso, geralmente não é eficiente substituir cadeias que consistem em um único caractere ou texto que tenha campos protegidos entre ele.
  2. Por padrão, a substituição de texto trunca cadeias que não forem mais longas que o texto que está sendo substituído. Às vezes o texto é truncado para manter o layout da tela do host original na transformação. O truncamento ocorre apenas no texto processado utilizando o widget campo (ou em alguns casos do widget de tabela).

    Para ativar a substituição de texto de cadeias curtas por cadeias longas, é possível incluir uma configuração de origem, truncateToPreserveLength. Os valores para esta configuração são true e false. O valor padrão quando a configuração não for especificada é true, o que não possui efeito em seu projeto. Especificar false ativa a substituição de textos mais longos. Para utilizar esta configuração, você não deve utilizar a renderização padrão. Se você utilizar a renderização padrão, a configuração é ignorada.

    A configuração truncateToPreserveLength é uma configuração de nível de projeto. Ela afeta todas as substituições de texto no projeto. Se você utilizar esta configuração, verifique se todas as suas renderizações aparecem como você deseja e que todos os problemas de alinhamento que podem surgir não são problemas.

    Para ativar a configuração para todo o projeto, abra a visualização da origem do arquivo application.hap. Localize a classe para a transformação, e inclua a configuração ressaltada como mostrado no exemplo a seguir:

    <class name="com.ibm.hats.transform">
       <setting name="truncateToPreserveLength" value="false" />
    </class>
  3. Utilizar a janela de texto de seleção pode ser muito útil, mas o texto real que aparece no campo Substituir é o que realmente será substituído. A substituição de texto não pode ser aplicada em várias linhas ou em campos não protegidos. Você não pode selecionar e substituir várias linhas de texto utilizando o campo de visualização.
  4. Existem limitações relacionadas à utilização da substituição de texto por imagens em combinação com a utilização de determinados widgets SWT nos aplicativos do rich client. Para obter informações adicionais, consulte Considerações e Limitações do Rich Client do HATS.

Próxima Tela

A guia Próxima Tela permite identificar as próximas telas prováveis que ocorrerão após a tela em que você está.

Clique no botão Incluir para incluir telas na lista. Você pode utilizar os botões Para Cima ou Para Baixo para modificar a ordem na qual suas telas são comparadas ou o botão Remover para remover uma tela.

Se nenhuma das próximas telas prováveis na lista corresponder, seu aplicativo poderá Procurar a Lista de Prioridade de Eventos do Aplicativo ou Executar o Evento do Aplicativo.

A opção Procurar Lista de Prioridades de Eventos do Aplicativo procura a lista de prioridades de eventos em suas configurações de projetos para a próxima tela. Este é o padrão. A lista suspensa Executar Evento do Aplicativo permite selecionar um evento de erro (ou outro) se nenhuma das próximas telas prováveis na lista corresponder. Os eventos listados são:

Para obter informações adicionais, consulte Eventos do Aplicativo.

Utilizar a Próxima Tela pode aprimorar o desempenho se você puder prever qual tela provavelmente aparecerá em seguida.

Origem

A guia Origem exibe as tags e valores no arquivo se-name.evnt para todas as informações fornecidas para o evento de tela, em que se-name é o nome que você forneceu para o evento de tela quando o criou. Conforme você faz alterações nas outras guias no editor de evento de tela, as tags e valores exibidos na guia Origem são alterados para correspondência.

Você também pode fazer alterações nas tags e valores no arquivo de origem e elas serão refletidas nas guias apropriadas do editor de evento de tela.

Telas Inibidas

O status da OIA (Operator Information Area) de uma conexão do HATS é um dos critérios de correspondência de tela utilizados pelo HATS para determinar se uma tela corresponde a um dos eventos de tela configurados. Se o status da OIA não for uma correspondência, o HATS não corresponderá ao evento de tela correspondente e você verá a transformação padrão em vez da transformação ou ação customizada. Esta seção fornece métodos que podem ser utilizados para manipular telas que são inibidas por entrada (teclado bloqueado) ou que possuem um status de OIA não correspondente.

Critérios de Reconhecimento

O HATS, por padrão, inclui os seguintes critérios de reconhecimento para o status da OIA para todos os eventos de tela:

<oia invertmatch="false" optional="false" status="NOTINHIBITED"/>

Isso significa que o status de OIA deve ser NOTINHIBITED, além de outros critérios de correspondência, para que o HATS avalie a tela como uma correspondência. Se o status de OIA for qualquer outro, a tela não será considerada uma correspondência mesmo se outros critérios foram atendidos. Como um resultado, a transformação padrão será exibida no navegador.

Para que o HATS ignore o status da OIA para um evento de tela específico, basta alterar os critérios de reconhecimento de NOTINHIBITED para DONTCARE, seguindo estas etapas:

  1. Na visualização do Projetos HATS, expanda seu projeto e a lista de eventos de tela (customizações de tela ou combinações de tela).
  2. Dê um clique duplo no evento de tela para iniciar o editor do evento de tela.
  3. Na parte inferior do editor, clique na guia Origem.
  4. Localize a linha que contém a cadeia status="NOTINHIBITED". Altere NOTINHIBITED para DONTCARE.
  5. Salve a alteração, clicando em Arquivo > Salvar ou pressionando Ctrl+S.

Se a tela do host for de fato inibida ou bloqueada, você deve pressionar uma tecla ou combinações de teclas específicas, como Ctrl+R (Reconfiguração do Host) ou Escape (Limpeza do Host) para desbloquear a tela ou para ir para a próxima tela.

Manipulação Automática de Telas Inibidas

É possível ativar o HATS par reconhecer e manipular automaticamente uma tela inibida ou bloqueada através da criação de uma customização de tela especial para essa finalidade. Para fazer isso:

  1. Na guia Critérios de Reconhecimento de Tela da customização de tela, desmarque e remova todos os critérios.
  2. Na guia Origem da customização de tela, altere a linha da OIA para que apresente invertmatch="true". Ao terminar, ela deve estar parecida com esta:
    <oia invertmatch="true"
    optional="false" status="NOTINHIBITED"/>
  3. Na guia Ações da customização de tela, inclua uma ação que limpará o status da OIA e o restaurará de volta para NOTINHIBITED. A ação correta a ser tomada pode ser diferente em cada caso. Por exemplo, em alguns casos, o simples envio de uma tecla de host de Enter (ou alguma outra tecla do host) pode ser suficiente para limpar o status da OIA e restaurá-la de volta para NOTINHIBITED. No entanto, em outros casos, pode ser necessário executar uma macro que alterará a posição do cursor ou enviará uma seqüência de várias teclas de host para voltar a conexão do host para um estado no qual o status da OIA é NOTINHIBITED.
  4. No editor Configurações de Projeto do HATS, selecione a guia Eventos e, em seguida, classifique a lista Prioridade do Evento de Tela de forma que a customização de tela especial esteja no topo da lista. Isto assegura que o HATS detectará e manipulará telas com um status de OIA INHIBITED primeiro, antes de tentar corresponder qualquer outro evento de tela.

Manipulando Várias Telas Inibidas

Em alguns casos, pode haver mais de uma tela inibida ou bloqueada, cada uma com uma ação necessária diferente para limpar essa condição. Portanto, pode ser necessário criar ou usar mais de uma customização de tela especial para tratar desses casos. Além de alterar invertmatch para true na linha da OIA na guia Origem, pode ser necessário incluir outros critérios na guia Critérios de Reconhecimento de Tela, de forma que cada customização de tela seja exclusiva e acionada apenas quando apropriado.

Por exemplo, uma tela de host pode ser bloqueada se o usuário tentar digitar um texto em um campo protegido. Nesse caso, talvez apareça uma mensagem Cursor em Área Protegida de Exibição. Para limpar essa condição, o usuário deve mover o cursor para uma área não protegida. Uma customização de tela especial pode ser criada para automatização desse processo. Além de apresentar invertmatch="true" para a área de OIA, ele também procurará pelo texto de mensagem Cursor em Área Protegida de Exibição. Se houver uma correspondência, a customização pode apresentar uma ação de execução de uma macro para mover o cursor para fora da área protegida e, assim, limpar o status da OIA.

No mesmo sistema, talvez haja uma segunda condição na qual a tela possa se tornar bloqueada se, por exemplo, o usuário pressionar uma tecla de função inválida. Nesse caso, o texto na tela de erro diz Tecla de Função Inválida Pressionada. Para limpar essa condição, o usuário pode ter que pressionar a tecla Enter. Outra customização de tela especial pode ser criada para automatização desse processo. Ela também apresentará invertmatch="true" para a área de OIA, mas corresponderá ao texto Tecla de Função Inválida Pressionada. Para a ação, essa customização de tela enviará a tecla Enter para o host.

Dependendo do ambiente específico, pode ser mais fácil manipular telas inibidas simplesmente configurando os critérios da OIA para DONTCARE e permitindo que os usuários tratem a situação da forma como o fariam com um emulador de terminal. No entanto, como mostrado acima, também é possível ativar o HATS para reconhecer e manipular automaticamente as telas inibidas caso você crie uma ou mais customizações de telas especiais.

Importando Conjuntos de Dados do BMS

O HATS permite que você crie capturas de telas a partir dos conjuntos de mapas BMS (Basic Mapping Support) do CICS (Customer Information Control System). Os mapas BMS são arquivos de definições de telas para o CICS. Cada mapa define toda ou parte de uma tela e um aplicativo do CICS geralmente exibe um ou mais mapas para criar uma imagem de tela completa. Os mapas contêm áreas ou campos estáticos e dinâmicos.

A origem de mapas do BMS está organizada em grupos chamados de conjuntos de mapas. Um conjunto de mapas contém um ou mais mapas. Os conjuntos de mapas existem no formato de origem como um conjunto de mapas por arquivo de origem. Quando o HATS importa Mapas do BMS, a importação ocorre no nível do conjunto de mapas. Não é possível importar um mapa individual.

Os mapas existem inicialmente no sistema host e devem ser colocados em seu sistema de arquivos local (ou parece que estão no sistema de arquivos local) e possuem uma extensão .bms antes de serem importados para o HATS.

Primeiro é necessário copiar os conjuntos de mapas do BMS do host para seu sistema de arquivos local. Esta é uma etapa manual fora do HATS, que pode ser feita copiando fisicamente os arquivos para o sistema de arquivos ou conectando o sistema de arquivos ao host utilizando o software de rede. O arquivo não deve ser transferido como um arquivo binário. Ele deve ser legível localmente em sua estação de trabalho.

  1. Clique em Arquivo > Importar > HATS > Conjuntos de Mapas BMS para HATS para abrir o assistente de Importação.
  2. Selecione os arquivos do conjunto de mapas do BMS que deseja importar da lista e o destino dos arquivos importados.
  3. Clique na seta pull down para selecionar a Página de Códigos do Host do país. Esta é a página de códigos utilizada para criar o mapa do BMS no host.
  4. Clique na seta pull-down para selecionar a Página de Códigos do Arquivo do BMS. Esta é a página de códigos utilizada para o arquivo do BMS quando ele foi transferido para a estação de trabalho.
  5. Você tem a opção de Sobrescrever os Mapas Existentes Sem Aviso e de Gerar uma Captura de Tela por Mapa Utilizando o Nome do Mapa como o Nome da Captura de Tela.
    Nota:
    Talvez você não queira criar automaticamente as capturas de telas se algum dos mapas precisar ser combinado com outros mapas para formar uma tela.
  6. Você também pode selecionar Sobrescrever Capturas de Telas Existentes sem Aviso.
  7. Clique em Concluir.

Os arquivos de captura do BMS são armazenados em uma pasta Mapas separada no projeto do HATS. Por padrão, a pasta Mapas não fica visível na visualização Projetos HATS, a menos que haja mapas importados. Na pasta Mapas existe uma pasta separada para cada conjunto de mapas e, em cada pasta, um arquivo separado para cada mapa (utilizando a extensão .bmc). Além disso, a origem original está armazenada no sistema de arquivos (extensão .bms) e é mostrada na pasta que contém seus mapas associados. É possível editar a origem dando um clique duplo no arquivo. Se a origem for editada e salva, os mapas serão automaticamente gerados outra vez e sobrescritos, exceto os mapas que foram modificados por meio da visualização Propriedades.

Também é possível importar mapas do BMS arrastando um arquivo de origem do BMS para a pasta <projeto>/bmsmaps na visualização Navegador. O arquivo deve ser colocado diretamente na pasta bmsmaps e não deve ser colocado em nenhuma das subpastas. Se ocorrerem erros durante a importação de mapas desta maneira, as mensagens serão exibidas na visualização Problemas.

Nota:
A origem é salva como uma referência apenas e não possui nenhuma função no projeto além de ser exibida no editor. Quando é exibida, todo o conjunto de mapas é exibido e não é feita nenhuma tentativa de destacar a definição do mapa específico que está sendo exibido no editor.

Após os mapas BMS serem importados, há várias ações que podem ser realizadas a partir da visualização Projetos HATS.

Depois que suas capturas de tela forem criadas, você poderá começar a criação de eventos de tela do HATS.