Interagindo com Variáveis Globais

Uma variável global contém um valor que pode ser utilizado para transmitir informações de um objeto do HATS para outro. Por exemplo, você pode extrair as informações de diversas localizações em uma tela do host, executar cálculos e inserir o resultado na tela atual ou em uma futura tela. Você pode construir uma matriz de cadeias de uma ou mais telas de host e inseri-las em uma transformação. Você pode extrair uma cadeia que um usuário insere em um campo na GUI e utilizá-la em qualquer outro local.

As variáveis globais que só são visíveis dentro do escopo de um único aplicativo do HATS são chamadas variáveis globais locais. Variáveis globais visíveis e que podem ser utilizadas por todos os aplicativos da Web do HATS no mesmo arquivo .ear ou por todos os aplicativos rich client do HATS em execução no mesmo ambiente do rich client são chamadas variáveis globais compartilhadas. Sempre que uma variável global for usada ou criada, você deve especificar se ela é local ou compartilhada. A seção Configurações Avançadas permite especificar o compartilhamento. A configuração padrão para todas as variáveis globais é local.

Nota:
Podem coexistir duas variáveis globais com o mesmo nome se uma for local e a outra compartilhada.

Para aplicativos da Web do HATS você pode compartilhar variáveis globais entre aplicativos no mesmo arquivo .ear durante uma única sessão HTTP. Para aplicativos rich client do HATS você pode compartilhar variáveis globais entre aplicativos em execução no mesmo ambiente do rich client. Se o ambiente do rich client for fechado e reiniciado, os valores de variáveis globais compartilhadas anteriormente não são preservados.

Uma variável global pode conter um valor numérico, uma cadeia ou uma matriz indexada de cadeias. Se você utilizar uma variável global para conter uma matriz de cadeias, será possível especificar para qualquer ação se deseja utilizar uma matriz inteira, um índice específico ou todos os valores que comecem em um índice específico. Todas as operações nas variáveis globais fazem distinção entre maiúsculas e minúsculas. Não utilize nomes que comecem com HATS, hats ou Hats para variáveis globais.

Você pode definir o valor de uma variável global dessas formas:

Depois que uma variável global tiver um valor, você poderá utilizar esse valor das seguintes maneiras:

Se você inserir uma variável global em um tela do host, terá que listar essa ação antes de aplicar uma transformação, para que a variável global apareça na GUI criada a partir da tela do host. Entretanto, pode ter lógica inserir uma variável global na tela do host depois que uma transformação for retornada ou antes que a tela do host seja enviada de volta ao host. Consulte Ações para obter informações adicionais sobre a especificação de ações para eventos de tela. Para obter informações sobre como inserir as variáveis globais nas transformações e modelo, consulte Inserir Variável Global.

As variáveis globais podem ser utilizadas com prompt e extrair as macros para fornecerem um valor para um prompt ou para armazenar um valor extraído da tela do host. As variáveis globais podem ser utilizadas em conjunto com as macros para combinar as várias telas de host em uma única GUI. Consulte o Macros e Terminal Host e o Combinando Telas para obter informações adicionais sobre o uso de variáveis globais com macros.

Você pode substituir variáveis globais para transmitir dados da GUI para o aplicativo. As variáveis globais locais e compartilhadas podem ser substituídas. Para obter informações adicionais, consulte Substituições de Variáveis Globais.

Elas também podem ser utilizadas para o reconhecimento da tela. Para obter informações adicionais, consulte Critérios de Reconhecimento de Tela ou Tela de Início.

Para obter informações sobre a utilização de variáveis globais na 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.

Se deseja utilizar uma variável global para acumular cadeias ou um valor numérico a partir de várias telas, é possível inicializá-la incluindo uma ação Enviar Variável Global para iniciar ou se conectar ao evento de aplicativo.

Dê um clique duplo em Configurações do Projeto de seu projeto HATS na visualização Projetos HATS. Vá para a guia Eventos.

Para configurar variáveis globais no evento de conexão, dê um clique duplo em Conectar para abrir o editor de eventos. Em seguida, você pode incluir a variável global na guia Ações. Assim, a variável global é vinculada à ação que está sendo executada.

O mesmo pode ser feito para o evento Iniciar.

É possível remover as variáveis globais locais e compartilhadas usando a ação Remover Variável Global em um evento de tela ou evento de aplicativo. Para obter mais informações, consulte Ação Remover Variável Global.

Renomeando Variáveis Globais

Você pode renomear cada instância de uma variável global. Para obter uma lista de todas as variáveis globais localizadas em um projeto do HATS específico, execute as seguintes etapas:

  1. Selecione Janela > Mostrar Visualização > Variáveis Globais do HATS na barra de menus do HATS. A visualização Variáveis Globais do HATS será colocada logo abaixo da visualização Paleta.
  2. Clique em um projeto na visualização Projetos HATS para preencher a visualização Variáveis Globais do HATS com todas as variáveis globais localizadas nos macros e eventos do projeto selecionado. Se você selecionar um projeto diferente, a visualização Variáveis Globais do HATS serão atualizadas. O conteúdo é atualizado quando uma macro ou evento do projeto selecionado é incluído, excluído ou editado.
  3. Você pode renomear uma variável global através da visualização Variáveis Globais do HATS clicando com o botão direito na variável global para editar o nome. Você também pode dar um clique duplo sobre as macros ou eventos listados sob cada variável global para abri-las. Quando criar ou editar as macros ou eventos, a visualização Variáveis Globais do HATS será automaticamente atualizada.
Nota:
A renomeação de variáveis globais é suportada apenas para variáveis globais definidas em macros e eventos; portanto, a visualização Variáveis Globais do HATS exibirá apenas essas variáveis globais. A renomeação de variáveis globais não renomeará as variáveis globais na lógica de negócios, transformações ou outro lugar em seu projeto do HATS.

Diferenças Entre Variáveis Globais e Variáveis de Macro

No HATS, existem dois tipos principais de variáveis; variáveis globais e variáveis de macro. As diferenças entre elas são descritas a seguir.

Variáveis Globais

Variáveis globais são variáveis criadas no HATS Toolkit e utilizadas por projetos do HATS. As variáveis globais são armazenadas fora do script de macro no arquivo de origem .hma do HATS. Elas são mantidas e atualizadas pelo tempo de execução do HATS. Existem dois tipos de variáveis globais:

Local
Uma variável global local é uma variável criada em um projeto do HATS e fica visível apenas para o projeto.
Compartilhado
Uma variável global compartilhada é aquela que pode ser vista e usada por todos os aplicativos da Web em um arquivo .ear ou por todos os aplicativos do rich client em um ambiente do rich client.

Se uma variável global será considerada local ou compartilhada depende da caixa de opções Compartilhada na GUI estar selecionada quando a variável global for criada ou do valor do atributo compartilhado de uma tag set, prompt ou extract estar especificada como yes ou no no arquivo de origem .hma do HATS.

Variáveis de Macro

As variáveis de macro são variáveis criadas no Visual Macro Editor ou no Advanced Macro Editor. As variáveis de macro são internas para as macros. Elas não são utilizadas fora de macros. As variáveis de macro são criadas, armazenadas e utilizadas pelo mecanismo da macro e listadas no script da macro. Para obter informações adicionais sobre variáveis de macro, consulte o capítulo, Variáveis e Classes Java™ Importadas, na publicação HATS Advanced Macro Guide.

Na origem de um arquivo de macro (.hma) do HATS que utiliza prompts e extrações do HATS para variáveis globais, os prompts e extrações estão contidos no arquivo de origem antes do script da macro. A sintaxe de script da macro está entre as tags <HAScript> e </HAScript>.