Editando Telas de Macro: Descrição

Lista os descritores utilizados pela macro para identificar uma tela. Informações adicionais sobre a sintaxe de script da macro podem ser localizadas no Guia de Programação de Macros.

Para qualquer campo, exceto Nome da Tela, é possível utilizar um nome de variável ou uma expressão aritmética como o valor do campo. É possível digitar esses nomes de variáveis e expressões diretamente nas áreas de texto ou incluí-los em listas, selecionando um novo descritor ou <Expressão> da lista.

Um nome de variável deve ter o seguinte formato: $var_name$, onde var_name pode ser alfanumérico, travessão e sublinhado. Os nomes de variáveis devem ser colocados entre sinais de dólar. Os nomes de variáveis são sensíveis a maiúsculas e minúsculas.

Para obter mais informações, consulte o Guia de Programação de Macro.

Descritor

Lista todos os descritores definidos para a tela selecionada. Um descritor é um atributo utilizado pela macro para identificar uma tela. Para cada nova tela exibida, a macro compara o que está na janela de sessão com a lista de descritores de cada tela definida até que seja feita uma correspondência. Os descritores devem ser exclusivos para evitar que várias telas correspondam a uma descrição. Se ocorrer essa colisão de tela, as ações erradas poderão ser executadas na tela errada. Isso pode causar falha no reconhecimento da tela em algum ponto na execução, resultando em um erro de tempo limite da macro.

Por padrão, quando o Gerenciador de Macros grava uma macro, os descritores de contagens de campo e OIA são definidos para identificar a tela. Se estiver adequado, não será necessário fazer alterações nesta guia. Entretanto, recomendamos que você inclua descritores de Cadeia para obter um reconhecimento mais completo e exato.

Para modificar um descritor, selecione-o na lista de Descritores. O nome de cada descritor é criado automaticamente, com base no tipo de descritor e em seu conteúdo. Para criar um novo descritor, escolha o tipo de descritor apropriado que deseja criar (por exemplo, <novo descritor de cadeia>). Só pode haver um descritor de Cursor e um de Contagens de Campo e OIA por tela. Podem haver vários descritores de Cadeia e Atributo.

Uma tela é reconhecida por um dos seguintes tipos de descritores:

• Cadeia
  Identifica a tela pelo texto exibido na tela
• Cursor
  Identifica a tela pela posição do cursor
• Atributo
  Identifica a tela pelos atributos planos (por exemplo, cor)
• Contagens de Campo e OIA
  Identifica a tela pelo número de campos, número de campos de entrada e estado da OIA
• Condição
  Especifica uma condição que é avaliada como true ou false.
• Atualizar Variável
  Atualiza uma variável com um novo valor

Se você definir mais de um descritor como opcional, quando o primeiro descritor opcional for correspondido, os outros descritos serão ignorados.

Para excluir um descritor definido, selecione-o e clique em Excluir.

A Captura Automática cria descritores com base nos valores atuais mostrados na janela de sessão atual. Você pode escolher quais tipos de descritores devem ser definidos. Certifique-se de que a tela de sessão correta esteja sendo exibida quando utilizar esta opção. Se você digitar um valor no campo ID do Host e se a sessão referida pelo ID do host estiver ativa, poderá Capturar Automaticamente informações da janela da sessão referida pelo ID do Host. Consulte Especificando um ID do Host.

Cadeia

Identifica a tela com base em uma cadeia exibida na tela em uma posição conhecida. Digite os valores da linha e da coluna ou clique em sessão isto trará para o primeiro plano. Se o Editor de Macros estiver aberto, será necessário movê-lo para a tela da sessão que será trazida para o primeiro plano. Selecione a cadeia desenhando um retângulo ao redor. Os campos de início e fim da linha e da coluna serão preenchidos automaticamente para você. Copie e cole a cadeia em sua área selecionada no campo Cadeia.

Linha Inicial

Posição da linha inicial onde a macro irá procurar a cadeia, começando pela parte de cima da tela. Um número negativo inicia a contagem a partir do final da tela.

Coluna Inicial

Posição da coluna inicial onde a macro procurará a cadeia, começando da coluna mais à esquerda. A utilização de um número negativo inicia a contagem a partir do lado direito da tela.

Linha Final

Posição da linha final onde a macro irá procurar a cadeia em um retângulo. Se a linha e a coluna finais forem especificadas, a macro irá procurar a cadeia em um retângulo.

Coluna Final

Posição da coluna final onde a macro irá procurar a cadeia em um retângulo. Se a linha e a coluna finais forem especificadas, a macro irá procurar a cadeia em um retângulo.

Cadeia

A cadeia utilizada para identificar a tela.

Ignorar Maiúsculas e Minúsculas

A cadeia será sensível a maiúscula e minúscula se selecionar falso.

Opcional

A cadeia não é necessária para reconhecer a tela. Pelo menos um descritor opcional deve ser correspondido para a tela ser reconhecida. Utilize esta opção, por exemplo, se uma de duas cadeias for exibida na tela. Ambos podem ser definidos como descritores opcionais. Entretanto, pelo menos um descritor opcional deve ser correspondido para que esta tela seja identificada. Esta opção assume que há mais de um descritor especificado como opcional. Se apenas um descritor for especificado como opcional, ele se tornará necessário.

Descritor Inverso

Se selecionar verdadeiro, a cadeia definida por este descritor não deverá aparecer na área definida pela Linha Inicial, Coluna Inicial, Linha Final e Coluna Final.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para que o descrito aplique-se à sessão que ativa a macro. Consulte Especificando um ID do Host.

Podem ser digitados números negativos para linhas e colunas. Números negativos são posições virtuais a partir da linha de baixo. Se a Linha e a Coluna Finais não forem especificadas, a posição absoluta será utilizada.

Cursor

Identifica a tela com base na posição do cursor. Especifique a posição do cursor ou clique sobre a tela e em para utilizar a posição atual do cursor na tela de sessão, se souber que está correta.

Linha

Posição da linha do cursor.

Coluna

Posição da coluna do cursor.

Opcional

A posição do cursor não é necessária para reconhecer a tela. Pelo menos um descritor opcional deve ser correspondido para a tela ser reconhecida. Utilize esta opção, por exemplo, se uma de duas posições do cursor for exibida na tela. Ambos podem ser definidos como descritores opcionais. Entretanto, pelo menos um descritor opcional deve ser correspondido para que esta tela seja identificada. Esta opção assume que há mais de um descritor especificado como opcional. Se apenas um descritor for especificado como opcional, ele se tornará necessário.

Descritor Inverso

Se selecionar verdadeiro, o cursor definido por este descritor não deverá estar na Linha e Coluna do cursor especificado.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para aplicar o descritor à sessão que ativa a macro. Consulte Especificando um ID do Host.

Atributos

Identifica a tela pelos atributos planos (cor, campo ou campo estendido) em uma posição de linha e coluna especificadas. Especifique a posição do atributo ou clique em Atual para utilizar a posição atual do cursor na tela de sessão se você souber que ela está correta.

Linha

Posição da linha do atributo.

Coluna

Posição da coluna do atributo.

Plano de Dados

Especifica o plano associado ao Valor Atributo.

• FIELD_PLANE - representa as posições de campo e seus atributos quando aparecem na tela.
• COLOR_PLANE - contém informações sobre cores para cada caractere na tela.
• EXFIELD_PLANE - dados de atributo de caractere estendido, por exemplo, imagem invertida, sublinhado, intermitência, caracteres de byte duplo ou cor do caractere.

Valor do Atributo

Valor hexadecimal que define o atributo para este plano de dados. Clique em Editar Atributos para escolher o valor graficamente.

Nota: Não é necessário colocar o Valor de Atributo entre aspas simples. Para obter mais informações, consulte Utilizar Variáveis e Expressões Aritméticas na Macro.

Opcional

O atributo plano não é necessário para reconhecer a tela. Pelo menos um descritor opcional deve ser correspondido para a tela ser reconhecida. Utilize esta opção, por exemplo, se mais de um atributo for exibido na tela. Ambos podem ser definidos como descritores opcionais. Entretanto, pelo menos um descritor opcional deve ser correspondido para que esta tela seja identificada. Esta opção assume que há mais de um descritor especificado como opcional. Se apenas um descritor for especificado como opcional, ele se tornará necessário.

Descritor Inverso

Se selecionar verdadeiro, o atributo definido por este descritor não deverá aparecer na tela da sessão.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para aplicar o descritor à sessão que ativa a macro. Consulte Especificando um ID do Host.

Contagens de Campo e OIA

Identifica a tela por um dos seguintes itens:

Número de Campos

O número total de campos na tela.

Opcional

Especifica se o descritor deve ser avaliado como true para que os resultados booleanos combinados de todos os descritores sejam avaliados como true. Consulte Avaliação dos Descritores no Guia de Programação de Macro.

Descritor Inverso

Definir esta opção como true faz com que o tempo de execução da macro inverta o resultado quando o descrito é avaliado:

• Se o descritor é avaliado como true, o tempo de execução da macro altera o resultado para false.
• Se o descritor for avaliado como falso, o tempo de execução da macro alterará o resultado para verdadeiro.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para aplicar o descritor à sessão que ativa a macro. Consulte Especificando um ID do Host.

Número de Campos de Entrada

O número total de campos na tela que são campos de entrada.

Opcional

Especifica se o descritor deve ser avaliado como true para que os resultados booleanos combinados de todos os descritores sejam avaliados como true. Consulte Avaliação dos Descritores no Guia de Programação de Macro.

Descritor Inverso

Definir esta opção como true faz com que o tempo de execução da macro inverta o resultado quando o descrito é avaliado:

• Se o descritor é avaliado como true, o tempo de execução da macro altera o resultado para false.
• Se o descritor for avaliado como falso, o tempo de execução da macro alterará o resultado para verdadeiro.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para aplicar o descritor à sessão que ativa a macro. Consulte Especificando um ID do Host.

Aguardar que OIA Seja Liberada

Se você configurar essa opção como verdadeira:

• Durante a reprodução da macro, se o indicador de entrada inibida na janela da sessão for limpo (isto é, a entrada não estiver inibida) o tempo de execução da macro avaliará esse descritor como verdadeiro.
• Caso contrário, o tempo de execução da macro avaliará esse descritor como falso.

Se você configurar essa opção como falsa:

• Durante a reprodução da macro, o tempo de execução da macro sempre avaliará esse descritor como verdadeiro.

Opcional

Especifica se o descritor deve ser avaliado como true para que os resultados booleanos combinados de todos os descritores sejam avaliados como true. Consulte Avaliação dos Descritores no Guia de Programação de Macro.

Descritor Inverso

Definir esta opção como true faz com que o tempo de execução da macro inverta o resultado quando o descrito é avaliado:

• Se o descritor é avaliado como true, o tempo de execução da macro altera o resultado para false.
• Se o descritor for avaliado como falso, o tempo de execução da macro alterará o resultado para verdadeiro.

ID do Host

A sessão a qual este descritor é aplicável. Deixe o campo ID do Host em branco para aplicar o descritor à sessão que ativa a macro. Consulte Especificando um ID do Host.

Condição

Especifica uma expressão que é avaliada como true ou false. Se a expressão for true (assumindo que este é o único descritor e que as caixas de opções Descritor Inverso e Opcional não estão definidas), a tela da macro à qual esta condição pertence será reconhecida como a próxima tela a ser processada. Se a expressão for false (com as mesmas suposições), a tela da macro não será reconhecida.

• Uma expressão pode conter os seguintes operadores de comparação lógica e operadores de comparação aritmética:

  Símbolo	Definição
  ==	igual a
  !=	diferente de
  <	menor que
  >	maior que
  <=	menor que ou igual a
  >=	maior que ou igual a
  ||	ou
  &&	e
  !	não

  Alguns exemplos de expressões condicionais válidas são:
  
  $strA$ == 'abc'
$intB$ != 0
$boolC$ && $boolD$
!$boolE$

• Você pode utilizar parênteses para indicar a prioridade de operações em uma expressão condicional. Por exemplo,
  
  (($strA$ == 'abc') && ($intB$ != 0)) || (!$boolE$)


Atualizar Variável

Atualiza uma variável com um novo valor.

Nome

Seleciona o nome da variável a ser atualizada.

tipo

Exibe o tipo de variável selecionada atualmente. Se a variável não estiver definida na macro atual, não aparecerá nenhum tipo.

Valor

Qualquer expressão válida, por exemplo, 'hello', 5 ou $var$ + 1.

Posição Atual do Cursor

Clique em Atual para atribuir o conteúdo da tela na posição atual do cursor para uma variável. Ao executar a macro, o conteúdo da tela na posição do cursor que você especificou se tornará o valor da variável. Atual é ativado apenas para variáveis de campo.