Descrições e Configurações do Componente e do Widget

O HATS fornece o componentes do host e o widgets que são utilizados para converter os elementos de uma tela do host para os objetos que podem ser exibidos em uma página da Web. Algumas configurações de componente e de widget podem ser modificadas utilizando os assistentes e editores no HATS Toolkit. Este capítulo descreve os componentes do host e widgets do HATS e as configurações que você pode modificar.

Você também pode criar seus próprios componentes e widgets personalizados utilizando o assistente do HATS. Para ativar o assistente, selecione HATS > Novo > Componente ou HATS > Novo > Widget no menu do HATS. Também é possível ativar o assistente selecionando Arquivo > Novo > Componente do HATS ou Arquivo > Novo > Widget do HATS.

Para obter mais informações sobre o uso do assistente para criar componentes e widgets customizados, consulte a publicação HATS Web Application Programmer's Guide ou HATS Rich Client Platform Programmer's Guide, dependendo do seu ambiente de aplicativos.

Configurações de Componente e de Widget

Os componentes e widgets fornecidos pelo HATS possuem definições padrão que você pode modificar, seja para um projeto inteiro que utiliza o editor de projeto ou para uma transformação individual que utiliza o assistente Inserir Componente Host. Nem todos os componentes e widgets possuem definições personalizáveis.

Nota:
A barra vertical (|), que é válida em muitas configurações de componente e widget, implica em OR. Por exemplo, o componente da tecla de função possui uma configuração chamada delimitador de início. Você pode especificar PF|F para o valor do delimitador de início. Isso significa que HATS procurará por PFxxxx ou Fxxxx na tela do host ao procurar pelas teclas de função.

Configurações de Componentes de Host

As configurações para um componente host especificam como esse componente será reconhecido na tela do host.

Alguns componentes do host possuem configurações mais complicadas. Por exemplo, diversas configurações são utilizadas para reconhecer uma tecla de função ou uma lista de seleção. Essas configurações serão descritas sob cada componente do host.

O HATS fornece os componentes do host que estão descritos nas seguintes seções.

__________________________________________________________________________

Linha de Comandos

O componente de Linha de Comandos é responsável por reconhecer os campos de entrada que possuem uma cadeia de caracteres específica (o token) que precede o campo de entrada.

Uma linha de comandos reconhecida pode ser processada pelos seguintes widgets:

A figura a seguir mostra como um componente da Linha de Comandos pode aparecer em sua tela do host:

Figura 13. Exemplo de Componente da Linha de Comandos
Exemplo de componente da linha de comandos
  1. Legenda de Campo (extraída)

As seguintes configurações podem ser configuradas para este componente:

Token
A cadeia de caracteres que deve preceder o campo de entrada
Legenda do Campo de Extração
Selecione esta caixa de opções se quiser que as legendas disponíveis sejam extraídas para os campos de entrada selecionados.
Recortar Espaços na Legenda
Consulte Campo de Entrada para obter informações adicionais.
Recortar para Região Selecionada
Consulte Campo de Entrada para obter informações adicionais.

__________________________________________________________________________

Diálogo

O componente Diálogo é utilizado para ajudar na renderização padrão no reconhecimento de quadros modais (pop-ups) na tela do host.

O conceito do componente Diálogo é localizar a menor área em torno do cursor que ajuste a descrição da moldura em uma forma retangular, assumindo que você esteja trabalhando com diálogos modais. Um diálogo modal retém o foco da entrada enquanto está aberto. O usuário deve fechar ou, de alguma forma, satisfazer o diálogo antes de mudar para outra janela.

Para inserir dados e completar um diálogo modal, o HATS assume que o cursor deve ficar dentro da moldura do diálogo. Iniciando nas coordenadas do caractere do cursor na tela, o HATS procura à esquerda um caractere de moldura vertical válido conforme definido pela configuração Caracteres de Moldura Vertical. Se um caractere de moldura vertical válido à esquerda for localizado, o HATS retornará para a mesma coordenada do cursor e procurará à direita um caractere de moldura vertical válido. Se caracteres de moldura vertical válidos forem localizados à esquerda e à direita das coordenadas do cursor, o HATS medirá a distância entre eles para assegurar que existe um comprimento válido.

O HATS também procura os caracteres de moldura horizontal superior e inferior, conforme definido pela configuração Caracteres de Moldura Horizontal, utilizando o mesmo processo da procura de caracteres da moldura vertical.

Como uma janela de diálogo é um retângulo, o HATS utiliza as colunas das molduras esquerda e direita e as linhas das molduras superior e inferior para determinar se as colunas atendem aos critérios verticais e as linhas atendem aos critérios horizontais de um diálogo modal. Se as linhas e colunas externas do retângulo se alinharem, assumindo que o atributo Contagem Mínima de Linhas tenha sido satisfeito, o componente Diálogo declarará a janela como uma correspondência e a área reconhecida será renderizada.

Para configurar este componente, vá para as Configurações do Projeto do projeto HATS, selecione a guia Renderização e clique em Renderização Padrão.

Nota:
O componente diálogo está disponível apenas no processamento padrão.

O componente diálogo é renderizado utilizando o widget Diálogo.

A figura a seguir mostra como um componente Diálogo pode aparecer em sua tela do host:

Figura 14. Exemplo de Componente Diálogo
Exemplo do Componente Diálogo
  1. Caracteres da moldura horizontal
  2. Caracteres da moldura vertical
  3. O cursor deve ser posicionado dentro do diálogo

As seguintes configurações podem ser configuradas para este componente:

Caracteres da moldura horizontal
Especifica os caracteres que compõem as molduras superior e inferior do diálogo. Por padrão, os caracteres da moldura horizontal são quaisquer caracteres de vídeo reversos protegidos, um ponto (.), um hífen (-) ou um sublinhado (_). Vários caracteres são separados por uma barra vertical (|) e avaliados da esquerda para a direita.
Caracteres da moldura vertical
Especifica os caracteres que compõem as molduras laterais do diálogo. Por padrão, os caracteres da moldura vertical são quaisquer caracteres de vídeo reversos protegidos, dois-pontos (:) ou uma barra vertical (|). Vários caracteres são separados por uma barra vertical (|) e avaliados da esquerda para a direita.
Nota:
Como a barra vertical (|) é utilizada como um separador, ao especificar vários caracteres, utilize &vl. para especificar uma barra vertical (|) como um caractere de borda vertical.

Além dos caracteres, os atributos de campo para caracteres de moldura também podem ser especificados nas configurações Caracteres de Moldura Horizontal e Caracteres de Moldura Vertical para este componente. Os seguintes indicadores são utilizados ao especificar os atributos de um campo. Cada especificação de campo é colocada entre um conjunto de chaves ( {...} ). Cada indicador é separado por um espaço. Para indicar uma negativa (NOT), inclua um ponto de exclamação (!) como um prefixo para o indicador, sem espaços entre eles.

Exemplo: {!p hi no} especifica um campo apenas numérico realçado não protegido.

Notas:
  1. Ao especificar atributos de campo para caracteres de moldura, a especificação tem como objetivo ser um modificador para os dados que o precedem diretamente, se houver algum. Por exemplo:
  2. A ordem dos indicadores dentro da definição de atributo de campo não importa, porque todos os indicadores dentro de um par de chaves deve corresponder a um caractere de moldura para ser reconhecido.
Contagem Mínima de Linhas
O número mínimo de linhas que a região deve conter para que seja reconhecida como um diálogo. O padrão é 3.
Contagem Mínima de Colunas
O número mínimo de colunas que a região deve conter para que seja reconhecida como um diálogo. O padrão é 3.
O cursor deve estar posicionado dentro do diálogo
Especifica se o cursor deve estar dentro da região reconhecida como um diálogo. Se não for selecionado, a região reconhecida como um diálogo não precisará conter o cursor e o usuário poderá obter resultados inesperados se os diálogos forem modais.
Permitir interação de diálogo externo
Especifica se a área fora da moldura deve ser desativada.
Nota:
A substituição de texto para conteúdo nas bordas de um diálogo não pode ser definida utilizando as configuração do componente Diálogo. O próprio componente Diálogo é apenas a borda da janela do diálogo (a caixa ao redor dela). O conteúdo dentro das bordas é renderizado por outros componentes da renderização padrão. Para executar a substituição de texto para conteúdo em um diálogo, é possível especificar a substituição de texto para o item de renderização padrão que renderiza o conteúdo do diálogo. Por exemplo, a substituição de texto pode ser especificada por um componente do Campo. Para obter uma visualização precisa da combinação do componente Diálogo e de outros componentes, clique em Visualização Integral da Página.

__________________________________________________________________________

ENPTUI

A ENPTUI (Enhanced Non-Programmable Terminal User Interface) permite que uma interface aprimorada em NPTs (Non-Programmable Terminals) e em PWS (Programmable Work Stations) sobre a interface orientada a menus de tela inteira 5250 tire vantagem das extensões do fluxo de dados de exibição 5250. O HATS suporta um subconjunto do recurso ENPTUI que inclui construções de interfaces gráficas. Estas construções são representadas por dois componentes do HATS: a Barra de Rolagem e o Campo de Seleção.

Você pode incluir suporte a ENPTUI durante a criação de um novo projeto do HATS a partir da barra de ferramentas do HATS, selecionando HATS > Novo > Projeto (ou Arquivo > Novo > Projeto do HATS) para ativar o assistente Criar um Projeto. Quando chegar ao painel Configurações de Conexão e selecionar 5250 ou 5250W para seu tipo de conexão, selecione a caixa de opções Incluir suporte de renderização (ENPTUI) de palavras-chave DDS da interface gráfica para ativar o suporte.

Nota:
Esta opção não está disponível nos projetos aperfeiçoados para dispositivos remotos.

Se a caixa de opções estiver selecionada, a renderização padrão configuradano arquivo application.hap incluirá os itens de renderização padrão ENPTUI e o componente e o registro de widget (ComponentWidget.xml) incluirá os componentes e widgets de ENPTUI para inclusão na renderização padrão ou nas transformações customizadas. Além disso, o objeto de conexão padrão criado terá ENPTUI=true incluído nas propriedades da conexão avançadas, o que é necessário para que o HATS receba os dados ENPTUI do host.

Se a caixa de opções permanecer limpa, o assistente Criar um Projeto editará o componente e o registro de widget e o arquivo application.hap e removerá os itens de renderização, os componentes e os widgets de ENPTUI dos arquivos armazenados pelo assistente no novo projeto.

Nota:
Esta é a única oportunidade de se ter os componentes e widgets do HATS e do ENPTUI no projeto. Se desejar incluir ENPTUI em seu projeto após a criação, todas as edições para ComponentWidget.xml, application.hap e main.hco deverão ser feitas manualmente (comparando para localizar as alterações requeridas). Isto não é recomendado. A criação de um novo projeto é o método recomendado para incluir o suporte a ENPTUI.

A seguir estão os componentes ENPTUI e suas configurações. Esses componentes não aparecem na seção Componentes do HATS na visualização Paleta do Designer de Páginas. Se o suporte ao ENPTUI tiver sido ativado conforme descrito acima, esses componentes estarão acessíveis a partir da barra de menus do Rational SDP clicando em Ferramentas do HATS > Inserir Componente do Host.

Campo Barra de Rolagem (ENPTUI)

O componente (ENPTUI) do campo Barra de Rolagem é responsável por reconhecer os campos de barra de rolagem de ENPTUI no fluxo de dados 5250. Este componente reconhecerá qualquer região de tela do host selecionada e poderá ser processado utilizando o widget Barra de Rolagem (ENPTUI). Não há definições personalizáveis para esse componente.

Campo de Seleção (ENPTUI)

Um campo de seleção de ENPTUI reconhecido pode ser processado pelos seguintes widgets:

As seguintes configurações podem ser configuradas para este componente:

Reconhecimento de Tipo de Campo de Seleção
Os tipos de campos de seleção que você deseja corresponder para qualquer instância especificada do componente
Botões de Comando
Selecione esta caixa se desejar reconhecer os campos de seleção de ENPTUI do botão de comando
Campos de Opções Únicos
Selecione esta caixa se desejar reconhecer o campo de seleção de ENPTUI de opção única
Vários Campos de Opção
Selecione esta caixa se desejar reconhecer campos de seleção de ENPTUI de várias opções
Barras de Menu
Selecione esta caixa se desejar reconhecer os campos de seleção de ENPTUI da barra de menus
Reconhecimento de Atributo de Campo de Seleção
O atributo de campo de seleção que você deseja corresponder para qualquer instância especificada do componente
Reconhecer Campos com Auto-enter
Selecione da lista drop-down se deseja reconhecer os campos de seleção ENPTUI com auto-enter ativado, desativado ou ambos

A figura a seguir mostra como o componente ENPTUI pode aparecer em sua tela do host:

Figura 15. Exemplo de Componentes ENPTUI
Exemplo de Componentes ENPTUI
  1. Componente Campo de seleção
  2. Componente Campo de barra de rolagem

__________________________________________________________________________

Campo

O componente Campo é responsável por reconhecer o texto protegido e os campos de entrada. Este componente reconhecerá qualquer região de tela do host selecionada e poderá ser processado utilizando o widget Campo.

Nota:
O componente Campo inclui apenas a região que você especificar. Se a região selecionada recortar um campo de tela host real, apenas a parte interna da seleção será processada.

A figura a seguir mostra como um componente Campo pode aparecer em sua tela do host:

Figura 16. Exemplo de Componente do Campo
Exemplo de Componente do Campo

A seguinte definição pode ser configurada para este componente:

Suporte para atributos de nível de caractere para campos protegidos

Essa definição permite renderizar exatamente a cor e os atributos estendidos de todos os caracteres em um campo protegido, em vez de renderizar o campo inteiro com a cor e os atributos do primeiro caractere no campo.

Se não for selecionado, o que é o padrão, o primeiro caractere do campo determinará os atributos para cada caractere no campo mesmo que um atributo, como uma cor, seja alterado no meio do campo.

Se essa opção for selecionada, informações sobre cor diferente e atributo estendido (por exemplo, vídeo reverso) serão suportadas dentro de um campo renderizando elementos do componentes Campo como segmentos de caracteres seqüenciais semelhantes. Por exemplo, um campo que tem dez caracteres de comprimento, no qual os primeiros cinco caracteres são verdes e os últimos cinco são vermelhos, será representado pelos dois elementos do componente Campo.

Nota:
Essa configuração aplica-se apenas aos campos protegidos, não aos campos de entrada.

__________________________________________________________________________

Tecla de Função

O componente Tecla de Função é responsável pelo reconhecimento das teclas de função (PF). Esse componente é utilizado para transformar o texto estático na tela do host que representa uma tecla de função em um botão ou link que o usuário pode clicar. Como as teclas de função aparecem de forma diferente nos diferentes sistemas host, o HATS fornece flexibilidade na configuração das diferentes partes. Por exemplo, uma tela do host poderia conter as seguintes teclas de função:

F3: Sair F4: Voltar F5: Encaminhar

Uma tecla de função pode ser processada pelos seguintes widgets:

A figura a seguir mostra como um componente Tecla de Função pode aparecer em sua tela do host:

Figura 17. Exemplo de Componente da Tecla de Função
Exemplo de Componente da Tecla de Função
  1. Cadeia antes do token inicial (um espaço)
  2. Delimitador inicial (#, significando um número)
  3. Delimitador (um sinal de igual (=))
  4. Cadeia após a descrição (um espaço)

As seguintes configurações podem ser configuradas para este componente:

Cadeia Antes do Token Inicial
Opcional. A cadeia que deve preceder o delimitador inicial. Você pode especificar mais de um valor, separado pelo caractere barra vertical (|). Para que um candidato da tecla de função seja reconhecido, ele deve ser precedido por esse valor.
Delimitador Inicial
Requerido. A cadeia que marca o início de uma tecla de função potencial. Você pode especificar mais de um valor, separado pelo caractere barra vertical (|). Qualquer um dos valores será reconhecido como o início de uma tecla de função. Esse valor pode conter um "#" (símbolo de número) - que será avaliado como "um número" durante o reconhecimento.
Delimitador
Opcional. A cadeia que separa o delimitador inicial da descrição. Você pode especificar mais de um valor, separado pelo caractere barra vertical (|).
Cadeia após descrição
Opcional. A cadeia que segue a descrição imediatamente. O padrão é " " (dois espaços) para permitir a detecção de várias descrições de texto para teclas de função.

Ao utilizar definições do componente Tecla de Função, considere o seguinte exemplo. Suponha que uma tela do host tem as seguintes descrições de tecla de função nela:

F1=Ajuda F2=Abrir F3=Sair

em que há apenas um espaço entre cada descrição. O HATS reconhecerá isso como três teclas de função individuais, embora o valor padrão para a configuração Cadeia após descrição seja " " (dois espaços). Isso porque o componente Tecla de Função procura um Delimitador de início, um Delimitador e, em seguida, a Cadeia após descrição. Mas, se ele localizar um novo Delimitador de Início antes de localizar a Cadeia após descrição, o início de uma nova descrição de tecla de função será assumido.

Notas:
  1. O componente Tecla de Função do HATS reconhece e renderiza apenas teclas F#, teclas PA, Enter e Clear. Para desativar o reconhecimento de Enter e Clear, remova o último # da definição do delimitador de início.
  2. O componente Tecla de Função do HATS não reconhece outras teclas de função do host tais como Help, PageUp (também chamada de rollup), PageDown (roll down), System Request, Attention e Print. Estas outras funções estão disponíveis no keypad do host. Você também pode incluir estas teclas do host no JSP em uma transformação do HATS utilizando o item de menu Ferramentas do HATS.
  3. Se usar o widget Drop-down (seleção) para renderizar o componente principal Função na renderização padrão, vários widgets drop-down podem ser renderizados na visualização e durante o tempo de execução. Para corrigir isto durante o tempo de execução, na origem para o arquivo application.hap, localize a tag <renderingItem...> para FunctionKeyComponent com SLDropdownWidget. Em seguida, altere o valor para esta configuração, keepOutputTogether, de false para true. A visualização continuará a exibir vários widgets drop-down.
  4. Se você utilizar os componentes-chave de função na renderização padrão e desejar que eles apareçam em diferentes linhas em sua transformação, deve utilizar a tag <BR> ou mapeá-los para uma tabela para forçar a a mudança. Isto pode ser feito visualizando e editando sua transformação na guia Origem.

__________________________________________________________________________

Palavra-chave DDS HTML Apenas Web 

Utilizar a palavra-chave DDS HTML em arquivos de exibição do IBM® i permite o envio de fragmentos HTML junto com o fluxo de dados 5250. Este recurso não se destina à exibição com programas de emulação padrão; ele é enviado apenas para dispositivos 5250 Workstation Gateway e para produtos de acesso ao host, como HATS, que foram aperfeiçoados para mostrar estes dados HTML em um navegador

O DDS HTML está disponível como um componente quando o tipo de host é especificado como 5250. A utilização deste componente não faz parte do processamento padrão e ele deve ser incluído no processamento padrão ou nas transformações personalizadas, se necessário.

O componente Palavra-chave DDS HTML é responsável por reconhecer estes dados HTML, se estiver presente no fluxo de dados 5250

Este componente pode ser processado utilizando o widget Etiqueta.

As seguintes configurações podem ser configuradas para este componente:

Ignorar Dados de DDS Utilizando Filtro
Clique neste botão se desejar reconhecer os dados de DDS conforme eles foram enviados no fluxo de dados 5250 ou conforme foram enviados, exceto para as tags especificadas por estes filtros "ignore".
Ignorar Estas Tags
Digite quaisquer tags (sem os caracteres < e >) que você deseja ignorar. Os dados entre a tag e sua tag final são mantidos. Por exemplo, especifique um <b>b</b> se desejar manter alguns dados entre as tags de negrito, mas não a própria tag.
Ignorar Todos os Dados de DDS nestas Tags
Digite quaisquer tags (sem os caracteres < e >) para as quais deseja ignorar os dados entre a tag e sua tag final.
Aceitar Dados de DDS Utilizando Filtro
Clique neste botão se desejar reconhecer, a partir dos dados de DDS HTML no fluxo de dados 5250, apenas as tags HTML que passam por estes filtros "accept". Os dados de DDS HTML que não passam por estes filtros são ignorados.
Aceitar Estas Tags
Digite quaisquer tags (sem os caracteres < e >) que você deseja manter. Os dados entre a tag e sua tag final são ignorados
Aceitar Todos os Dados de DDS nestas Tags
Digite quaisquer tags (sem os caracteres < e >) para as quais deseja manter os dados entre a tag e sua tag final.

Você pode incluir uma palavra-chave, HTML, que permitirá incorporar dados HTML brutos no fluxo de dados para interpretação apenas pelos destinatários compatíveis com o navegador. Este suporte no HATS permitirá que os dados enviados de um aplicativo do host na palavra-chave DDS HTML sejam utilizados no processamento padrão ou na transformação personalizada.

Para ativar o suporte à palavra-chave DDS HTML para uma definição de conexão, execute as seguintes etapas:

  1. Abra o Editor de Conexão clicando em sua conexão principal do HATS na visualização Projetos HATS.
  2. Selecione a guia Avançado e clique no botão Incluir para configurar uma definição de conexão avançada.
  3. Selecione HTMLDDS para Nome na lista drop-down e digite true no campo Valor.
  4. Clique em OK.

__________________________________________________________________________

Campo de Entrada

O componente Campo de Entrada destina-se a reconhecer os campos de entrada (campos não-protegidos). Esse componente, além de reconhecer os campos de entrada, também pode extrair a legenda de acompanhamento do campo. Para localizar a legenda do campo, esse componente procura pelo texto protegido que precede diretamente o campo de entrada (na mesma linha) primeiro. Se o algoritmo não puder localizar uma legenda, ele procurará pelo texto protegido diretamente acima do campo.

Um campo de entrada reconhecido pode ser processado pelos seguintes widgets:

A figura a seguir mostra como um componente Campo de Entrada pode aparecer em sua tela do host:

Figura 18. Exemplo de Componente de Campo de Entrada
Exemplo de Componente de Campo de Entrada
  1. Legenda de campo (extraída do componente)

As seguintes configurações podem ser configuradas para este componente:

Legenda do Campo de Extração
Se essa opção for selecionada, uma legenda para o campo de entrada reconhecido será extraída (consulte a descrição acima para obter informações adicionais sobre esse algoritmo). Essa legenda extraída pode ser utilizada pelo widget.
Restringir legenda à região selecionada
Se selecionada, a legenda será limitada ao texto dentro da parte selecionada da tela.
Demarcar Fim da Legenda
Se essa opção for selecionada, o fim da legenda será demarcado após (e incluindo) a primeira ocorrência de qualquer valor especificado na definição Demarcar após. Essa configuração é útil para limpar as legendas extraídas.
Demarcar Após
Requerido. A cadeia (ou conjunto de cadeias) que é utilizada para demarcar a legenda extraída. Por exemplo, se a legenda extraída for Command ==> e o valor para essa configuração for =, tudo o que estiver após (e incluindo) o primeiro = será removido.
Substituir por
Opcional. A cadeia pela qual substituir a parte removida da legenda (se aplicável).
Recortar Espaços na Legenda
Se essa opção for selecionada, o espaço em branco (por exemplo, espaços e tabulações) será removido das duas extremidades da legenda extraída (e demarcada).
Recortar campo de entrada para região selecionada
Se essa opção for selecionada, apenas a parte do campo de entrada dentro da região selecionada será reconhecida e renderizada. Se essa opção for limpa, se alguma parte de um campo de entrada estiver dentro da região selecionada, o campo de entrada inteiro será reconhecido e renderizado. Essa configuração será útil se você precisar dividir um grande campo de entrada da tela do host em vários campos menores de entrada da página da Web.

__________________________________________________________________________

Campo de Entrada com Sugestões

O componente Campo de Entrada com Sugestões destina-se a reconhecer os campos de entrada (campos não-protegidos) que possuem sugestões de acompanhamento (o texto que segue imediatamente o campo de entrada na mesma linha). Esse componente é funcionalmente semelhante ao componente Campo de Entrada, exceto pelo fato de que as sugestões devem estar localizadas perto da entrada do candidato. Por exemplo, supondo que sua tela host tivesse o seguinte campo de entrada:

Código do produto: [ ] (Códigos válidos: A, B, C, D)

Nesse exemplo, o início das sugestões é Códigos Válidos:, o fim das sugestões é um parêntese de fechamento [)], o separador é uma vírgula (,) e o tipo de token inicial é None.

Um campo de entrada reconhecido pode ser processado pelos seguintes widgets:

O campo de entrada também utiliza sugestões de valores válidos. Por padrão, o campo de entrada não reconhece as sugestões, portanto, você terá que modificar as definições do componente a fim de transmiti-las juntamente com o widget de renderização.

A figura a seguir mostra como um componente Campo de Entrada com Sugestões pode aparecer em sua tela do host:

Figura 19. Exemplo de Componente de Campo de Entrada com Sugestões
Exemplo de Componente de Campo de Entrada com Sugestões
  1. Delimitador: posição de delimitador, mas o tipo de token inicial estava configurado como None.
  2. Início das sugestões: parêntese de abertura (
  3. Separador: ou
  4. Fim das sugestões: parêntese de fechamento )

O tipo de token inicial não está marcado. Neste exemplo, o tipo de token inicial é None. Nenhuma letra ou dígito precede as sugestões.

As seguintes configurações podem ser configuradas para este componente:

Legenda do Campo de Extração
Se essa opção for selecionada, uma legenda para o campo de entrada reconhecido será extraída (consulte a descrição acima para obter informações adicionais sobre esse algoritmo). Essa legenda extraída pode ser utilizada pelo widget.
Restringir legenda à região selecionada
Se selecionada, a legenda será limitada ao texto dentro da parte selecionada da tela.
Demarcar Fim da Legenda
Se essa opção for selecionada, o fim da legenda será demarcado após (e incluindo) a primeira ocorrência de qualquer valor especificado na definição Demarcar após. Essa configuração é útil para limpar as legendas extraídas.
Demarcar Após
Requerido. A cadeia (ou conjunto de cadeias) que é utilizada para demarcar a legenda extraída. Por exemplo, se a legenda extraída for Command ==> e o valor para essa configuração for =, tudo o que estiver após (e incluindo) o primeiro = será removido.
Substituir por
Opcional. A cadeia pela qual substituir a parte removida da legenda (se aplicável).
Recortar Espaços na Legenda
Se essa opção for selecionada, o espaço em branco (por exemplo, espaços e tabulações) será removido das duas extremidades da legenda extraída (e demarcada).
Recortar campo de entrada para região selecionada
Se essa opção for selecionada, apenas a parte do campo de entrada dentro da região selecionada será reconhecida e renderizada. Se essa opção for limpa, se alguma parte de um campo de entrada estiver dentro da região selecionada, o campo de entrada inteiro será reconhecido e renderizado. Essa configuração será útil se você precisar dividir um grande campo de entrada da tela do host em vários campos menores de entrada da página da Web.
Início das Sugestões
Opcional. A cadeia de caractere que identifica onde o conjunto de sugestões começa. Vários valores podem ser especificados para essa configuração, separados com o caractere de barra vertical (|).
Final das Sugestões
Opcional. A cadeia de caracteres que identifica onde o conjunto de sugestões termina. Vários valores podem ser especificados para essa configuração, separados com o caractere de barra vertical (|).
Separador
Requerido. A cadeia de caracteres que separa cada sugestão no conjunto de sugestões. Vários valores podem ser especificados para essa configuração, separados com o caractere de barra vertical (|).
Tipo de Token da Letra Inicial
Especifica o que é cada sugestão. Por exemplo, se o conjunto de sugestões fosse M=Maçã,L=Laranja,U=Uva, você configuraria esse valor como Letra (ou Letra ou Dígito) porque M, L e U são todas letras. Você configuraria o delimitador como =.
Comprimento Máximo de Token Inicial
Especifica o comprimento máximo do token inicial. O padrão é 4.
Delimitador
Requerido. A cadeia de caracteres que separa o token inicial da descrição da sugestão. Essa configuração se aplica apenas quando o tipo de token inicial não for None.
Mínimo de Sugestões Requeridas
O número mínimo de sugestões que deve ser encontrado para que esse campo de entrada seja reconhecido por esse componente. Essa configuração é útil para evitar o reconhecimento errôneo.

__________________________________________________________________________

Seleção de Itens

O componente Seleção de Itens é responsável por reconhecer telas com lista de itens, em que a interação serve para selecionar um caractere junto ao item.

O componente Seleção de Itens pode ser renderizado pelos seguintes widgets:

A figura a seguir mostra como um componente Seleção de itens pode aparecer em sua tela do host:

Figura 20. Exemplo do Componente Seleção de Itens
Exemplo do Componente Seleção de Itens
  1. Campo de entrada
  2. Legenda

As seguintes configurações podem ser configuradas para este componente:

Legenda do Campo de Extração
Selecione esta caixa se quiser que as legendas disponíveis sejam extraídas para os campos de entrada selecionados.
Demarcar Fim da Legenda
Ativado apenas se Extrair Legenda dos Campos estiver selecionada. Selecione essa caixa para excluir o texto final de uma legenda. Especifique onde iniciar a exclusão em Demarcar Depois e quaisquer caracteres com os quais substituir o texto da legenda excluído em Substituir por.
Recortar Espaços na Legenda
Ativado apenas se Extrair Legenda dos Campos estiver selecionada. Selecione esta caixa para remover espaços extras no final das legendas.
As Legendas Estão Após os Campos de Entrada
Ativado apenas se Extrair Legenda dos Campos estiver selecionada. Selecione esta caixa se as legendas a serem extraídas estiverem à direita dos campos de entrada. Limpe esta caixa se as legendas estiverem à esquerda dos campos de entrada.
Os Campos de Entrada Devem Ter uma Legenda
Selecione esta caixa se desejar que apenas os campos de entrada com legendas sejam reconhecidos na tela do host.
Recortar campo de entrada para região selecionada
Selecione esta caixa se desejar renderizar apenas a parte selecionada de um campo de entrada. Limpe esta caixa se desejar apresentar o campo inteiro se alguma parte do campo estiver selecionada.

__________________________________________________________________________

Light Pen (Atenção)

O componente light pen (atenção) é responsável por reconhecer o campo de atenção de uma light pen (também conhecida como caneta seletora) em telas do host 3270.

Nota:
Esse componente não aparece na seção Componentes do HATS na visualização Paleta do Designer de Páginas. Se o suporte à light pen tiver sido ativado selecionando a caixa de opções Incluir suporte à renderização da light pen durante a criação inicial de um projeto 3270 ou 3270E, esse componente estará acessível a partir da barra de menus do Rational SDP clicando em Ferramentas do HATS > Inserir Componente do Host.

Um campo de atenção da light pen reconhecido pode ser renderizado pelos seguintes widgets:

Dependendo do caractere designador (o primeiro caractere do campo), clicar no widget de renderização (botão, link ou botão de rádio) fará com que um AID (Identificador de Atenção) [enter] ou [cursel] seja enviado para o host. Se o designador for um e comercial (&), um AID [enter] será enviado. Se o designador for um caractere em branco, um AID [cursel] será enviado.

A figura a seguir mostra como um componente light pen (atenção) poderá aparecer em sua tela do host:

Figura 21. Exemplo do Componente Light Pen (Atenção)
Exemplo do Componente Light Pen (Atenção)
  1. Caractere designador (o primeiro caractere do campo)

As seguintes configurações podem ser configuradas para este componente:

Consumir restante do campo
Especifica se todo o campo ou apenas o primeiro caractere do campo será consumido e renderizado pelo widget. Selecione essa caixa de opções para especificar se o campo inteiro será consumido e renderizado. Por exemplo, o conteúdo do campo é renderizado como a legenda do widget de renderização (botão, link ou botão de rádio). Limpe esta caixa de opções para especificar que somente o primeiro caractere será renderizado pelo widget. Isto será útil para preservar as cores ou os atributos estendidos no restante do campo. Quando estiver na Renderização Padrão, limpar essa caixa de opções fará com que o restante do campo (tudo, exceto o primeiro caractere do campo) seja renderizado por algum outro widget (na maioria dos casos pelo widget Campo). O padrão é selecionado.

__________________________________________________________________________

Light Pen (Seleção)

O componente light pen (seleção) é responsável por reconhecer o campo de seleção de uma light pen (também conhecida como caneta seletora) em telas de host 3270.

Nota:
Esse componente não aparece na seção Componentes do HATS na visualização Paleta do Designer de Páginas. Se o suporte à light pen tiver sido ativado selecionando a caixa de opções Incluir suporte à renderização da light pen durante a criação inicial de um projeto 3270 ou 3270E, esse componente estará acessível a partir da barra de menus do Rational SDP clicando em Ferramentas do HATS > Inserir Componente do Host.

Um campo de seleção da light pen reconhecido pode ser renderizado pelo widget Caixa de Opções.

Se o caractere designador (o primeiro caractere do campo) for um ponto de interrogação (?), a caixa de opções renderizada não será selecionada. Se o caractere designador for um sinal maior que (>), a caixa de opções renderizada será selecionada.

A figura a seguir mostra como um componente light pen (seleção) poderá aparecer em sua tela do host:

Figura 22. Exemplo do Componente Light Pen (Seleção)
Exemplo do Componente Light Pen (Seleção)
  1. Caractere designador (o primeiro caractere do campo)

As seguintes configurações podem ser configuradas para este componente:

Consumir restante do campo
Especifica se todo o campo ou apenas o primeiro caractere do campo será consumido e renderizado pelo widget. Selecione essa caixa de opções para especificar se o campo inteiro será consumido e renderizado. Por exemplo, o conteúdo do campo é renderizado como a legenda do widget de renderização (caixa de opções). Limpe esta caixa de opções para especificar que somente o primeiro caractere será renderizado pelo widget. Isto será útil para preservar as cores ou os atributos estendidos no restante do campo. Quando estiver na Renderização Padrão, limpar essa caixa de opções fará com que o restante do campo (tudo, exceto o primeiro caractere do campo) seja renderizado por algum outro widget (na maioria dos casos pelo widget Campo). O padrão é selecionado.

__________________________________________________________________________

Lista de Seleção

O componente Lista de Seleção é responsável por reconhecer a lista de seleção. As listas de seleção são como menus, mas elas são apresentadas como uma lista de opções, cada uma é precedida por um token inicial e um delimitador, como no seguinte exemplo:

Opção 1. Preparar formulário
Opção 2. Trabalhar com os formulários que você enviou
Opção 3. Trabalhar com os formulários que requerem ação

Neste exemplo, Opção é a cadeia antes do token inicial, 1, 2 e 3 são os tokens iniciais e o delimitador é um ponto seguido por um espaço (. ).

Depois que um item da lista tiver sido selecionado (seja clicado ou selecionado dependendo do widget), seu token inicial será colocado no campo de entrada do host de destino.

Uma lista de seleção reconhecida pode ser processada pelos seguintes widgets:

A figura a seguir mostra como um componente lista de seleção pode aparecer em sua tela do host:

Figura 23. Exemplo de Componente da Lista de Seleção
Exemplo de Componente da Lista de Seleção
  1. Cadeia antes de um token inicial (um espaço)
  2. Tipo de token inicial (dígito)
  3. Delimitador (um ponto (.))
  4. Delimitador final (um espaço)
  5. Opções de lista (ou itens)

As seguintes configurações podem ser configuradas para este componente:

Cadeia Antes do Token Inicial
Opcional. A cadeia que precede o token inicial de cada item da lista.
Tipo de Token da Letra Inicial
Especifica se cada item da lista inicia com as letras, dígitos ou ambos, letras e dígitos.
Comprimento Máximo de Token Inicial
Especifica o comprimento máximo do token inicial. O padrão é 4.
Delimitador
Requerido. A cadeia de caracteres entre token inicial e a descrição. Você pode especificar mais de um valor, separado pelo caractere barra vertical (|).
Delimitador Final
Opcional. A cadeia de caracteres que deve seguir cada item da lista.
Mínimo de Opções Requeridas
O número mínimo de itens da lista que deve ser localizado para que a região selecionada seja reconhecida como uma lista de seleção.
Agrupar Itens Individualmente
Selecione esta caixa se desejar agrupar itens individualmente.
Campo Destino da Seleção
Especifica que o campo de entrada recebe a seleção. Opções: Primeira na tela, Última na tela, Campo anterior, Próximo campo, Posição do cursor ou Definido pelo usuário.
Linha
Especifica a linha do campo de entrada que deve receber a seleção.
Nota:
Essa configuração se aplica apenas se Definido pelo usuário for selecionado como o destino da seleção.
Coluna
Especifica a coluna do campo de entrada que deve receber a seleção.
Nota:
Essa configuração se aplica apenas se Definido pelo usuário for selecionado como o destino da seleção.
Enviar Automaticamente na Seleção
Se selecionado, uma tecla AUXÍLIO é automaticamente enviada para o host, mesmo se o campo de entrada estiver em branco. Se desmarcado, uma tecla AUXÍLIO não é enviada automaticamente.
Tecla de Ação
Opcional. Especifica a tecla de auxílio do host que deve ser pressionada depois que o campo de entrada de destino for atualizado com a seleção do usuário. O valor padrão é [enter] indicando que a tecla Enter será pressionada uma vez depois que o usuário fizer uma seleção.
Opções da Lista de Classificação
Se essa opção for selecionada, os itens da lista serão classificados de acordo com seu token inicial ou descrição (veja abaixo informações adicionais sobre outras configurações).
Classificar por
Especifica se é necessário classificar o conjunto de opções da lista por seu token inicial ou descrição.
Ordem de Classificação
Especifica se é necessário classificar o conjunto de opções da lista na ordem crescente ou decrescente.
Nota:
Os métodos de classificação sensíveis ao código do idioma, construídos no Java™, são utilizados para desempenhar esta operação.
Opções de Marcadores
Especifica se será necessário incorporar itens da lista de marcadores quando existirem intervalos (como espaço vazio) entre os itens da lista. Opções: Real, Nenhum ou Único.
Nota:
Para obter informações sobre o uso desse componente com o suporte DBCS, consulte Lista de Seleção.

__________________________________________________________________________

Subarquivo

O componente Subarquivo é responsável por reconhecer 5250 subarquivos. Este componente não aparece na seção Componentes do HATS na visualização Paleta do Designer de Páginas. Para projetos 5250, este componente estará acessível a partir da barra de menus do Rational SDP clicando em Ferramentas do HATS > Inserir Componente do Host.

Um subarquivo reconhecido pode ser renderizado pelos seguintes widgets:

A figura a seguir mostra como um componente subarquivo pode aparecer em sua tela do host:

Figura 24. Exemplo de Componente de Subarquivo
Exemplo de Componente de Subarquivo
  1. Região de ação
  2. Região de cabeçalho
  3. Região de dados
  4. Região do marcador
  5. Configurações de Ação

  6. Cadeia antes de um token inicial (um espaço)
  7. Tipo de token inicial (dígito)
  8. Delimitador (um sinal de igual (=))
  9. Definição de Cabeçalho

  10. Texto inicial para o cabeçalho (Opc)
  11. Definição de Dados

  12. Delimitador de coluna (um espaço)
  13. Definição do Marcador

  14. Texto do marcador (Mais...)

Para ativar Configurações de Subarquivo, siga estas etapas:

  1. Vá para a visualização Projetos HATS e clique nas Configurações do Projeto.
  2. Selecione a guia Processamento.
  3. Na guia Processamento, expanda a árvore Componentes e selecione o componente Subarquivo.
  4. Clique no botão Configurações à direita para exibir a janela Configurações de Subarquivo.

Figura 25. Exemplo de Configurações de Subarquivo
Diálogo Configurações de Subarquivo

As configurações do componente do Subarquivo consistem em quatro guias, Ação, Título, Dados e Marcador. Cada guia é usada para definir os critérios para reconhecimento de um elemento específico do subarquivo. Os ícones em cada guia indicam os seguintes estados:

Quando as quatro guias exibirem indicadores de reconhecimento, clique em OK. É possível ver o resultado de reconhecimento na visualização do widget.

Cada guia de reconhecimento é descrita abaixo.

Ação

Selecione a tela que deseja utilizar na lista drop-down. Você também pode especificar a região da área de Seleção na tela do host utilizando o mouse, ou digitando as coordenadas da região nas caixas a seguir:

Linha inicial
A primeira linha para procurar a ação de subarquivo. O padrão é 3.
Linha final
A última linha para procurar a ação de subarquivo. O padrão é 12.
Coluna Inicial
A primeira coluna para procurar a ação de subarquivo. O padrão é 1.
Coluna Final
A última coluna para procurar a ação de subarquivo. O padrão é 80.

Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Para visualizar o local em que os campos de entrada estão definidos na tela, selecione Entrada. Para visualizar os campos que estão protegidos, selecione Protegido. Para realçar campos ocultos, selecione Oculto. Para visualizar os padrões de correspondência, selecione Correspondência. Para modificar as cores de realce dos campos correspondentes a entradas, protegidos, ocultos ou de padrão, consulte Utilizando Preferências do HATS.

Reconhecimento de Ação
Os critérios adicionais de reconhecimento de ação podem ser configurados selecionando as seguintes configurações individuais.
Cadeia Antes do Token Inicial
Cadeia. Este valor especifica a cadeia antes do token inicial. O valor padrão é um espaço.
Tipo de Token da Letra Inicial
Cadeia. Esse valor é o tipo de token que esse aplicativo host utiliza para o comando host. No exemplo em que 1=Editar, o token 1 é o comando host e seu tipo é um dígito. No exemplo em que A=Editar, o token A é o comando host e seu tipo é uma letra. Os valores permitidos são Dígito, Letra, Mostrar ambos. O padrão é Mostrar ambos.
Comprimento Máximo de Token Inicial
O comprimento máximo do token inicial. O padrão é 4.
Delimitador
Cadeia. Esse valor é o token utilizado na ação do subarquivo para delimitar o comando host da descrição do comando host. No exemplo em que 1=Editar, 1 é o comando do host, o token = é o delimitador e Editar é a descrição do comando do host. O valor permitido é uma ou mais cadeias concatenadas pela barra vertical (|). O padrão é =. Exemplo: =| = |-| - |:.
Delimitador Final
Cadeia. É utilizado para reconhecer o final de uma descrição de item de ação de subarquivo. Separe vários caracteres com uma barra vertical (|).
Cor Deve Ser Especificada
Essa caixa é utilizada em conjunto com as configurações anteriores para designar que o comando do host da ação do subarquivo deve ser um tipo específico e a ação do subarquivo deve ser uma cor específica. Por exemplo, a ação do subarquivo deve ser um dígito, e deve ser azul.
Cor
Consulte a descrição para a configuração anterior.
Alta Intensidade
Cadeia. Este valor especifica se a ação de subarquivo utiliza o atributo de campo de alta intensidade. Os valores permitidos são Sim, Não, Não se preocupar. O padrão é Não se preocupar.
Ações Não Requeridas
Selecione esta caixa se desejar que o subarquivo seja reconhecido mesmo que não tenha nenhuma ação. O cabeçalho de subarquivo, dados e marcador ainda são reconhecidos e processados.
Consumir linhas não vazias imediatamente acima das ações
Selecione essa caixa se desejar linhas na tela que contenham texto imediatamente acima e adjacente às ações, que atendam aos critérios de reconhecimento (cor e/ou intensidade), consumidas, mas não exibidas pelo widget de subarquivo.

Especifique a região da área de Seleção na tela de host utilizando seu mouse ou digitando as coordenadas da região nas seguintes caixas:

Linha inicial
A primeira linha para procurar o cabeçalho de subarquivo. O padrão é 3.
Linha final
A última linha para procurar o cabeçalho de subarquivo. O padrão é 16.
Coluna Inicial
A primeira coluna para procurar o cabeçalho de subarquivo. O padrão é 1.
Coluna Final
A última coluna para procurar o cabeçalho de subarquivo. O padrão é 80.

Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Para visualizar o local em que os campos de entrada estão definidos na tela, selecione Entrada. Para visualizar os campos que estão protegidos, selecione Protegido. Para realçar campos ocultos, selecione Oculto. Para visualizar os padrões de correspondência, selecione Correspondência. Para modificar as cores de realce dos campos correspondentes a entradas, protegidos, ocultos ou de padrão, consulte Utilizando Preferências do HATS.

Reconhecimento de Cabeçalho
Os critérios adicionais de reconhecimento de cabeçalho podem ser configurados selecionando as seguintes definições individuais.
Reconhecer por Texto
Booleano. Este valor especifica se o cabeçalho do subarquivo deve ser reconhecido com base nas cadeias. Os valores permitidos são true ou false. O padrão é true.
Começa com
Cadeia. Cadeias que podem ser utilizadas para identificar os cabeçalhos do subarquivo; utilize \n para definir cabeçalhos de várias linhas. Os valores permitidos devem ser concatenados com a barra vertical (|). Cabeçalhos mais específicos devem ser listados primeiro. Por exemplo, se Opção, Opç e Opç forem cabeçalhos possíveis, eles deverão ser ordenados para assegurar que o cabeçalho mais específico seja listado primeiro, Opção|Opç |Opç. O padrão é true. Exemplo: Descrição\ndo Registro|Opção|Opç |?.
Cor Deve Ser Especificada
Booleano. Esse valor é utilizado em conjunto com a configuração Texto para designar se os cabeçalhos do subarquivo devem ter uma cadeia específica e devem ser de uma cor específica. Por exemplo, o cabeçalho do subarquivo deve conter a palavra Opç. e deve ser azul. Os valores permitidos são true ou false. O padrão é false.
Cor
Especifica a cor do cabeçalho do subarquivo.
Alta Intensidade
Selecione essa caixa para especificar se o Cabeçalho do Subarquivo pode ser reconhecido pelo texto na parte superior de uma tabela de dados, que utiliza o atributo do campo de alta intensidade.
Cor Especificada
Selecione esta caixa para especificar se o cabeçalho do subarquivo pode ser reconhecido pelo texto de uma cor específica na parte superior de uma tabela de dados.
Cor
Especifica a cor do cabeçalho do subarquivo.

Dados

Especifique a região da área de Seleção na tela de host utilizando seu mouse ou digitando as coordenadas da região nas seguintes caixas:

Linha inicial
A primeira linha para procurar dados de subarquivo. O padrão é 4.
Linha final
A última linha para procurar dados de subarquivo. O padrão é 22.
Coluna Inicial
A primeira coluna para procurar dados de subarquivo. O padrão é 1.
Coluna Final
A última coluna para procurar dados de subarquivo. O padrão é 80.

Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Para visualizar o local em que os campos de entrada estão definidos na tela, selecione Entrada. Para visualizar os campos que estão protegidos, selecione Protegido. Para realçar campos ocultos, selecione Oculto. Para visualizar os padrões de correspondência, selecione Correspondência. Para modificar as cores de realce dos campos correspondentes a entradas, protegidos, ocultos ou de padrão, consulte Utilizando Preferências do HATS.

Reconhecimento de Dados
Os critérios adicionais de reconhecimento de dados podem ser configurados selecionando as seguintes definições individuais.
Opção de Reconhecimento:
Esta configuração especifica como a região de dados do subarquivo é reconhecida.
Campo Apenas Web 
Reconhece dados do subarquivo linha por linha.
Nota:
Para aplicativos do rich client, se você desejar ver a linha renderizada do subarquivo, utilize as seguintes configurações de widget do subarquivo:
  • Selecione Mostrar Cores de Linha Alternativas
  • Limpe Mostrar Linhas de Grade
  • Para Origem do Cabeçalho de Coluna, selecione Do Componente
  • Selecione Utilizar Estilo de Cabeçalho Clássico
  • Selecione Substituir Fonte e selecione Monoespaçada
Tabela (campo)  Apenas Web 
Reconhece dados do subarquivo por informações de campo.
Tabela (visual)
Reconhece dados de subarquivo que aparecem como uma tabela com delimitadores de coluna vertical visíveis.
Tabela
Reconhece dados de subarquivo que aparecem como uma tabela utilizando quebras de coluna definidas pelo usuário.
Delimitador de Coluna:
Ativado apenas se a Opção de Reconhecimento: estiver configurada como Tabela (visual). A cadeia de caracteres que deve existir nas mesmas colunas de cada linha na região selecionada para que a coluna da tela do host seja marcada como uma coluna da tabela. Se cada coluna consecutiva for marcada como uma coluna de delimitação, apenas a última coluna será realmente processada como a coluna de delimitação da tabela gerada. O padrão é um caractere de espaço.
Quebras de Coluna:
Ativado apenas se a Opção de Reconhecimento: estiver configurada como Tabela. Uma lista de números de coluna separados por vírgulas onde são desejadas quebras de coluna. Por exemplo, especificar 1,7,22 indicará que novas colunas devem iniciar nas colunas 1, 7 e 22. Quando o botão Restaurar Padrões é clicado, o campo Quebras de Coluna é preenchido com os valores baseados nos valores de reconhecimento padrão Tabela (visual).
Notas:
  1. As quebras de coluna também podem ser incluídas ou removidas utilizando o mouse para selecionar uma coluna na visualização de tela do host, clicando com o botão direito do mouse e selecionando Incluir ou Remover. As quebras de coluna são indicadas por uma linha vertical pontilhada na visualização de tela do host.
  2. As quebras de coluna não podem dividir um campo de entrada.
  3. Para obter informações sobre o uso dessa configuração com o suporte DBCS, consulte Subarquivo.
Substituir Coluna Inicial do Campo de Entrada de Ação
Se selecionado, será possível substituir a coluna inicial do campo de entrada da ação para impedir que outros campos de entrada sejam renderizados incorretamente como listas drop-down.
Coluna Inicial
Coluna inicial do campo de entrada de ação. O valor padrão é 1.
Substituir Comprimento do Campo de Entrada de Ação
Se selecionado, será possível substituir o comprimento do campo de entrada da ação para impedir que outros campos de entrada sejam renderizados incorretamente como listas drop-down.
Comprimento do Campo
Comprimento do campo do campo de entrada de ação. O valor padrão é 1.
Dados Não Requeridos
Selecione esta caixa se desejar que o subarquivo seja reconhecido mesmo que não contenha dados. Se forem detectadas ações do subarquivo, elas ainda serão processadas como listas drop-down.
Incluir Linhas Vazias
Selecione esta caixa se desejar que as linhas vazias em uma tabela na tela do host sejam incluídas quando a tabela for transformada. Desmarque a caixa se desejar que as linhas vazias sejam descartadas.

Marcador

Especifique a região da área de Seleção na tela de host utilizando seu mouse ou digitando as coordenadas da região nas seguintes caixas:

Linha Inicial:
A primeira linha para procurar o marcador de subarquivo. O padrão é 4.
Linha Final:
A última linha para procurar o marcador de subarquivo. O padrão é 22.
Coluna Inicial
A primeira coluna para procurar o marcador de subarquivo. O padrão é 1.
Coluna Final
A última coluna para procurar o marcador de subarquivo. O padrão é 80.

Você pode destacar certos campos na tela de host selecionando as diferentes opções ao lado de Destacar campos. Para visualizar o local em que os campos de entrada estão definidos na tela, selecione Entrada. Para visualizar os campos que estão protegidos, selecione Protegido. Para realçar campos ocultos, selecione Oculto. Para visualizar os padrões de correspondência, selecione Correspondência. Para modificar as cores de realce dos campos correspondentes a entradas, protegidos, ocultos ou de padrão, consulte Utilizando Preferências do HATS.

Reconhecimento de Marcador
Os critérios adicionais de reconhecimento de marcador podem ser configurados selecionando as seguintes configurações individuais.
Reconhecer por Texto
Se selecionado, o marcador final do subarquivo poderá ser reconhecido pela cadeia de texto especificada.
Texto
Cadeia. Isto pode ser utilizado para identificar o subarquivo e marcador. São permitidos vários valores. Exemplo: Mais...|Parte Inferior|Final|+. O valor padrão é Mais...|Parte Inferior|+.
Alta Intensidade
Se selecionado, o marcador final do subarquivo poderá ser reconhecido por um campo de alta intensidade abaixo da tabela de dados.
Nenhum texto visual é necessário
Se essa opção for selecionada, o campo de alta intensidade poderá ser uma cadeia vazia.
Linha Vazia
Se selecionado, o marcador final do subarquivo poderá ser reconhecido por uma linha vazia dentro da região especificada abaixo da tabela de dados.

__________________________________________________________________________

Tabela

O componente Tabela é responsável por reconhecer tabelas. Ele pode ser utilizado em vez do componente Tabela (visual) se for necessário indicar números de coluna específicos para utilizar para quebras de coluna para atingir o resultado desejado.

Deve-se ter cuidado ao utilizar o componente Tabela em um conjunto de renderização padrão porque o componente Tabela reconhecerá quase todas as telas na região selecionada e nenhum item de renderização inferior na lista será reconhecido.

Uma tabela reconhecida pode ser processada pelos seguintes widgets:

A figura a seguir mostra como um componente tabela pode aparecer em sua tela do host:

Figura 26. Exemplo do Componente Tabela
Exemplo do Componente Tabela
  1. Linhas de título
  2. Quebras de coluna

As seguintes configurações podem ser configuradas para este componente:

Quebras de Coluna:
Uma lista de números de coluna separados por vírgulas onde são desejadas quebras de coluna. Por exemplo, especificar 1,7,22 indicará que novas colunas devem iniciar nas colunas 1, 7 e 22. Quando o botão Restaurar Padrões é clicado, o campo Quebras de Coluna é preenchido com os valores baseados nos valores de reconhecimento padrão da Tabela Visual.
Notas:
  1. As quebras de coluna também podem ser incluídas ou removidas utilizando o mouse para selecionar uma coluna na visualização de tela do host, clicando com o botão direito do mouse e selecionando Incluir coluna ou Remover coluna. Clicar com o botão esquerdo do mouse em uma coluna também pode incluir ou remover uma quebra de coluna. As quebras de coluna são indicadas por uma linha vertical pontilhada na visualização de tela do host.
  2. As quebras de coluna não podem dividir um campo de entrada.
  3. Para obter informações sobre o uso dessa configuração com o suporte DBCS, consulte Tabela.
Incluir Linhas Vazias
Se esta opção for selecionada, as linhas vazias (linhas sem nenhum texto visível ou campos de entrada) serão incluídas na tabela ou gráfico renderizado.
Linhas de tabela a serem excluídas
Um conjunto de linhas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. Essa configuração é útil para ocultar linhas de dados específica em uma tabela ou gráfico. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de exemplo: 1,2,3...., 1,2-4, 3-5.
Colunas de tabela a serem excluídas
Um conjunto de colunas lógicas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de exemplo: 1,2,3...., 1,2-4, 3-5.
Número de linhas de título
Especifica o número de linhas, iniciando na parte superior da região, que deve ser renderizada como o cabeçalho. Se o valor for maior que 1, para cada coluna, as linhas do cabeçalho serão renderizadas como uma cadeia em uma única linha.

__________________________________________________________________________

Tabela (Campo)

O componente Tabela (campo) é responsável por reconhecer as colunas lógicas dos campos verticalmente alinhados. Para que uma região seja reconhecida como uma tabela (campo), os limites esquerdo e direito de cada campo contido dentro da região selecionada (incluindo campos parciais) devem ser os mesmos dos limites de campo esquerdo e direito diretamente acima (se o campo em questão não estiver na primeira linha) e diretamente abaixo (a menos que o campo em questão não esteja na última linha).

Uma tabela (campo) reconhecida pode ser renderizada pelos seguintes widgets:

A figura a seguir mostra como um componente tabela (campo) poderá aparecer em sua tela do host:

Figura 27. Exemplo do Componente Tabela (Campo)
Exemplo do Componente Tabela (Campo)
  1. Linhas
  2. Colunas

As seguintes configurações podem ser configuradas para este componente:

Incluir Linhas Vazias
Se esta opção for selecionada, as linhas vazias (linhas sem nenhum texto visível ou campos de entrada) serão incluídas na tabela ou gráfico renderizado.
Linhas para Exclusão
Um conjunto de linhas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. Essa configuração é útil para ocultar linhas de dados específica em uma tabela ou gráfico. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de exemplo: 1,2,3..., 1,2-4, 3-5.
Colunas para Exclusão
Um conjunto de colunas lógicas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de exemplo: 1,2,3..., 1,2-4, 3-5.
Contagem Mínima de Linhas
O número mínimo de linhas que uma região especificada deve conter para que a região seja reconhecida como uma tabela.
Nota:
O número de linhas reconhecidas é avaliado antes que as linhas especificadas sejam excluídas (consulte Linhas a serem excluídas).
Contagem Mínima de Colunas
O número mínimo de colunas lógicas (não colunas da tela do host) que a região especificada deve conter para que a região seja reconhecida como uma tabela.
Nota:
O número de colunas reconhecidas é avaliado antes que as colunas especificadas sejam excluídas (consulte Colunas a serem excluídas).
Extrair Texto do Cabeçalho da Coluna da Linha Acima da Tabela
Selecione esta caixa se desejar que o texto da linha acima da tabela seja utilizado como os cabeçalhos de coluna da tabela. Os cabeçalhos de coluna devem estar em campos protegidos.
Nota:
A menos que você tenha acesso ao mapa da tela do host que criou a tabela, utilize o componente Tabela (visual) para reconhecer uma região tabular. Se isto não for possível, ative as opções Entrada, Protegido e Oculto na primeira página do assistente Inserir Componente do Host para ajudar a determinar onde há quebra de campo na região selecionada da tela do host.

__________________________________________________________________________

Tabela (visual)

O componente Tabela (visual) é responsável por reconhecer as tabelas. O componente Tabela (visual) é diferente do componente Tabela (campo) porque não requer que os campos da tela do host adjacentes sejam alinhados verticalmente. Ele procura as colunas na região selecionada que contém o delimitador de coluna para cada linha na seleção. Regra geral: Se uma região tiver a aparência de uma tabela, o componente Tabela (visual) deverá conseguir reconhecê-la.

Uma tabela reconhecida pode ser processada pelos seguintes widgets:

A figura a seguir mostra como um componente Tabela (visual) poderá aparecer na tela do host:

Figura 28. Exemplo do Componente Tabela (Visual)
Exemplo do Componente Tabela (Visual)
  1. Linhas (contagem mínima de linhas = 1)
  2. Colunas (contagem mínima de contagem = 1)
  3. Delimitador de coluna (um espaço)

As seguintes configurações podem ser configuradas para este componente:

Delimitador de Coluna
Requerido. A cadeia de caracteres que deve existir em cada linha da região selecionada para que a coluna da tela do host seja marcada como uma coluna da tabela. Se cada coluna consecutiva for marcada como uma coluna de delimitação, apenas a última coluna será realmente processada como a coluna de delimitação da tabela gerada.
Incluir Linhas Vazias
Se esta opção for selecionada, as linhas vazias (linhas sem nenhum texto visível ou campos de entrada) serão incluídas na tabela ou gráfico renderizado.
Linhas para Exclusão
Um conjunto de linhas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. Essa configuração é útil para ocultar linhas de dados específica em uma tabela ou gráfico. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de exemplo: 1,2,3...., 1,2-4, 3-5.
Colunas para Exclusão
Um conjunto de colunas lógicas agrupado ou separado por vírgulas a ser excluído da tabela reconhecida. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de exemplo: 1,2,3...., 1,2-4, 3-5.
Contagem Mínima de Linhas
O número mínimo de linhas que uma região especificada deve conter para que a região seja reconhecida como uma tabela.
Nota:
O número de linhas reconhecidas é avaliado antes que as linhas especificadas sejam excluídas (consulte Linhas a serem excluídas).
Contagem Mínima de Colunas
O número mínimo de colunas lógicas (não colunas da tela do host) que a região especificada deve conter para que a região seja reconhecida como uma tabela.
Nota:
O número de colunas reconhecidas é avaliado antes que as colunas especificadas sejam excluídas (consulte Colunas a serem excluídas).
Extrair Texto do Cabeçalho da Coluna da Linha Acima da Tabela
Selecione esta caixa se desejar que o texto da linha acima da tabela seja utilizado como os cabeçalhos de coluna da tabela. Os cabeçalhos de coluna devem estar em campos protegidos.

Alguns aplicativos HATS V4 que utilizam widgets gráficos para renderizar componentes de Tabela (visual) exigem uma alteração após serem migrados para o HATS V7.5.1. Isto ocorrerá se o aplicativo do HATS renderizar uma tela do host contendo dados tabulares com uma coluna vazia, como segue:

Col1 Col2 Col3
aaa bbb
ccc ddd
eee fff
ggg hhh

O componente Tabela (visual) do HATS V4 reconheceu essa região da tela do host como contendo três colunas. Para que ela seja exibida como um gráfico de barras com duas linhas, seria necessário especificar que os dados para a linha 2 fossem retirados da coluna 3 da região da tela do host. No HATS V5 e posterior, o componente Tabela (visual) reconhece esta região da tela do host como contendo duas colunas. Como não há terceira coluna, não há dados exibidos na segunda linha do widget do gráfico. Para corrigir esse problema, modifique as definições do gráfico de barras para que declare que os dados para a segunda linha sejam tomados da coluna 2 da região da tela do host.

__________________________________________________________________________

Texto

O componente Texto é responsável por reconhecer o texto visível, incluindo o texto dentro de um campo de entrada.

Este componente pode ser processado utilizando o widget Etiqueta.

A figura a seguir mostra como um componente texto pode aparecer em sua tela do host:

Figura 29. Exemplo de Componente de Texto
Exemplo de Componente de Texto
  1. Quebra de Linha (preservado)

As seguintes configurações podem ser configuradas para este componente:

Preservar quebras de linha
Se esta opção for selecionada, várias linhas selecionadas serão renderizadas como várias linhas na página da Web resultante. Se esta opção for limpa, o texto de cada linha será concatenado em uma única cadeia.

__________________________________________________________________________

URL

O componente do URL é responsável por reconhecer links. Ele procura apenas em campos protegidos não-ocultos. Este componente pode ser processado utilizando o widget Link.

A figura a seguir mostra como um componente URL pode aparecer em sua tela do host:

Figura 30. Exemplo de Componente URL
Exemplo de Componente URL
  1. Indicador de início (http://)

As seguintes configurações podem ser configuradas para este componente:

Indicadores Iniciais
Especifique uma ou mais cadeia de caractere para reconhecer o início de um URL ou tela do host

Configurações de Widget

Ao customizar um componente host, você especifica como ele será reconhecido. Ao personalizar um widget, você especificará como o widget aparecerá na página da Web.

Você pode customizar as configurações dos widgets descritos na seguintes seções.

Quando você configura ou modifica as definições do widget em qualquer diálogo de configurações do widget, a área de visualização do widget é automaticamente atualizada para mostrar o efeito das alterações feitas, antes de você clicar em OK para confirmar essas alterações.

__________________________________________________________________________

Botão

O widget Botão é responsável por processar os botões HTML. Clicar em um desses botões geralmente fará que uma ação específica do host ocorra (por exemplo, uma tecla de auxílio será enviada para o host ou um campo de entrada será atualizado).

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de botão aparece em uma transformação, utilizando os dados do exemplo do componente Tecla de Função como entrada:

Figura 31. Exemplo de Widget do Botão
Exemplo de Widget do Botão
  1. Linhas
  2. Colunas (3 por linha)
  3. Tipo de legenda (mostrar descrição)

As seguintes configurações podem ser configuradas para este widget:

Tipo da legenda
Especifica como a Legenda para Cada Botão é Determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparece na legenda do botão. Por exemplo, se a tela de host tivesse um item de menu 4. Correio, a legenda exibiria 4 ou Correio ou 4. Correio.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Layout
Especifica como os botões serão organizados na página HTML. Opções: Tabela, Separado.
Notas:
  1. Essa configuração não é aplicável na renderização padrão se o componente da tecla de função está sendo usado.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Número de Colunas por Linha
O número dos botões a ser exibido horizontalmente antes de quebrar para a próxima linha. Refinar essa definição pode fazer com que os botões apareçam verticalmente (se esse valor for 1) ou horizontalmente (se esse valor for igual a ou superior ao número de botões a ser processado).
Separador
Especifica qual separador você deseja utilizar para separar os botões processados na página HTML. Você pode selecionar a partir da lista drop-down ou digitar o seu no campo de entrada.
Ativar Cores em Primeiro Plano Apenas Web 
Se selecionado, o texto do botão é renderizado usando a cor extraída da tela do host pelo componente (aplicável apenas quando o componente da tecla de função é usado).

As informações de cores são extraídas para o primeiro campo de host que contenha qualquer parte da tecla de função. Se a tecla de função for dividida em dois campos, como F12= e Sair, as informações de cor para o campo que contém F12= são extraídas.

Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada a cada botão gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.

__________________________________________________________________________

Tabela Botão

O widget Tabela Botão é responsável por processar uma tabela dos botões HTML verticalmente organizados.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de tabela de botões aparece em uma transformação, utilizando os dados do exemplo do componente Tecla de Função como entrada:

Figura 32. Exemplo de Widget de Tabela do Botão
Exemplo de Widget de Tabela do Botão
  1. Linhas
  2. Número de Colunas por Linha (2)
  3. Legenda

As seguintes configurações podem ser configuradas para este widget:

Número de Colunas por Linha
O número dos botões a ser exibido horizontalmente antes de quebrar para a próxima linha.
Notas:
  1. Essa configuração não é aplicável na renderização padrão se o componente da tecla de função está sendo usado.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada a cada botão gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada a cada descrição do item (à direita do botão gerado). O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Calendário  Apenas Web 

O widget Calendário é responsável por processar um campo de entrada com um botão, link ou imagem do ativador associado. Este ativador abre um selecionador de data de calendário que seus usuários podem utilizar para selecionar uma data; esta data então será inserida no campo de entrada associado.

Notas:
  1. Se você estiver testando seu projeto utilizando o navegador da Web construído no Rational SDP, utilizando o WebSphere Test Environment, você poderá ver o widget de calendário aparecer em uma janela do navegador maior do que a esperada e com controles adicionais desnecessários. Isso não acontecerá quando o aplicativo for executado em um navegador externo ou quando você executar uma aplicativo implementado.
  2. Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como o widget de calendário e seu selecionador de data aparecem em uma transformação quando a configuração Utilizar Calendário Sequencial é selecionada:

Figura 33. Exemplo de widget de calendário com selecionador de data sequencial
Exemplo de widget de calendário com selecionador de data sequencial

A figura a seguir mostra como o widget de calendário e seu selecionador de data aparecem em uma transformação quando a configuração Utilizar Calendário Sequencial é desmarcada:

Figura 34. Exemplo de widget de calendário com selecionador de data com janelas
Exemplo de widget de calendário com selecionador de data com janelas

  1. Número de colunas por linha (1)
  2. Legenda (do componente)
  3. Tipo de ativador (imagem)
    Nota:
    Os exemplos não possuem legendas para os ativadores porque os ativadores são imagens. Se os ativadores forem botões ou links, as legendas do ativador são mostradas nos botões ou nos links.

As seguintes configurações podem ser configuradas para este widget:

Padrão

Requerido. Quando o usuário seleciona uma data no widget de calendário, a data selecionada deve ser formatada para mapear corretamente para o que é esperado na campo de entrada do aplicativo de host. Esta configuração especifica o padrão que o HATS utiliza para formatar corretamente os dados selecionados. Para obter informações sobre o significado dos símbolos no padrão, consulte http://java.sun.com/j2se/1.3/docs/api/java/text/SimpleDateFormat.html.

Ao inserir um padrão e salvá-lo, o HATS Toolkit executa as seguintes conversões para garantir que os símbolos corretos sejam utilizados:

Nota:
O HATS Toolkit sempre exibe o padrão em caracteres maiúsculos. Para ver o caso real dos símbolos padrão, consulte a configuração padrão da classe com.ibm.hats.transform.widgets.CalendarWidget na origem do arquivo application.hap.

É possível espalhar a data selecionada sobre vários campos de entrada de host consecutivos ao separar elementos padrão com um til (~). Por exemplo, supondo que você possua os seguintes campos de entrada em sua tela do host:

Mês: [ ] Dia: [ ] Ano: [ ]

Se você especificar um padrão de MM~DD~AAAA, um único ativador será criado. Depois que seu usuário tiver selecionado uma data, ela será estendida nos seus três campos de entrada: o mês de 2 dígitos será colocado no primeiro campo de entrada, o dia de 2 dígitos será colocado no segundo campo de entrada e o ano de 4 dígitos será colocado no terceiro campo de entrada.

Nota:
Clique no botão Construir para utilizar um auxílio para especificar um padrão que abranja vários campos de entrada do host.
Código do Idioma Padrão
Especifica o código do idioma do padrão. Esta configuração será útil se você tiver digitado um segmento padrão que deve resultar em um nome de dia (exemplo: Quarta-Feira). Opções: Utilizar Código do Idioma do Servidor, Utilizar Código do Idioma do Navegador ou Utilizar Código do Idioma Especificado.
Código do Idioma
Se você especificar Utilizar Código do Idioma Especificado, selecione o código do idioma para o qual será formatada a data especificada pelo usuário.
Restringir data Selecionável mais Recente
Se esta opção for selecionada, o valor especificado será a data mais recente que um usuário pode selecionar no calendário pop-up.
Notas:
  1. O padrão de data é MM/DD/AAAA para todos os códigos do idioma.
  2. Um usuário não é impedido de inserir manualmente uma data mais recente diretamente no campo de entrada associado devido a essa configuração.
Restringir Última Data Selecionável
Se esta opção for selecionada, o valor especificado será a última data que um usuário pode selecionar no calendário pop-up.
Notas:
  1. O padrão de data é MM/DD/AAAA para todos os códigos do idioma.
  2. Um usuário não é impedido de inserir manualmente uma data posterior diretamente no campo de entrada associado devido a essa configuração.
Valor Padrão
Opcional. Este campo representa a data inicial selecionada no calendário pop-up quando o aplicativo do host não preenche previamente o campo de entrada associado com uma data válida entre as datas restritas especificadas. Ele é utilizado também quando o usuário insere uma data incorreta (incluindo uma data fora do intervalo) antes de selecionar o controle do calendário pop-up. A interação entre este campo e os campos de entrada do host associados é manipulada como segue:
Nota:
O padrão de data é MM/DD/AAAA para todos os códigos do idioma.
Origem da Legenda
Especifica como a legenda do campo de entrada gerado é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda do campo de entrada.
Nota:
Deixe essa definição em branco para não gerar uma legenda para o campo de entrada.
Número de Colunas por Linha
Especifica quantas instâncias desse widget devem aparecer em cada linha na página da Web renderizada.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Tipo de Ativador
Especifica o estilo do ativador. O ativador é utilizado para abrir o selecionador de data do calendário. Opções Botão, Link ou Imagem.
Legenda
A legenda do botão ativador ou link.
Classe de Estilo do Botão
Opcional. A classe de estilo CSS associada ao botão ativador gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link
Opcional. A classe de estilo CSS associada ao link ativador gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Nota:
Dependendo do navegador da Web, pode haver limitações na utilização da tecla Tab para tabular para este ativador se o estilo Link ou Imagem for selecionado. 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.
Utilizar calendário sequencial
Se selecionado, quando o selecionador de data do calendário for ativado, ele será exibido na página da Web atual. Se desmarcado, o selecionador de data será exibido e uma nova janela do navegador. O padrão para os projetos recentemente criados será selecionado. O padrão para projetos migrados de releases anteriores ao HATS V7.5.1 é desmarcado.
Notas:
  1. Utilizar o selecionador de data do calendário sequencial é útil em casos nos quais bloqueadores de pop-up impedem a exibição do selecionador de data em uma nova janela do navegador.
  2. O uso do selecionador de data do calendário sequencial não é suportado para aplicativos HATS para dispositivos remotos.
Apenas para Leitura
Se esta opção for selecionada, os campos de entrada renderizados serão de leitura. Um campo de entrada de leitura aparece como um campo de entrada regular, mas não permite que o usuário modifique seu conteúdo. Isso é útil nos casos em que você deseja exibir o conteúdo de um campo desprotegido a um usuário, mas não deseja que o usuário modifique o conteúdo.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecionar essa opção apara os espaços inicial e final do campo de entrada.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

As cores são mapeadas para classes de folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar, vídeo reverso, sublinhado e separador de coluna) serão exibidos. Além disso, para aplicativos da Web 3270, as cores de campo estendido serão mapeadas (consulte a configuração Ativar Cores de Primeiro Plano para obter informações adicionais). Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Piscar
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Classe de Estilo do Campo de Entrada
Opcional. A classe de estilo CSS associada ao campo de entrada gerado. O valor do atributo de classe da tag da entrada HTML será configurado com este valor. O valor padrão é HATSINPUT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda
Opcional. A classe de estilo CSS associada à legenda do campo de entrada gerado. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um conjunto de campos de entrada for processado, uma tabela HTML será gerada para incluir esses campos de entrada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.

__________________________________________________________________________

Caixa de Opções

O widget Caixa de opções é responsável por processar as caixas de opções HTML.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de caixa de opções aparece em uma transformação, utilizando os dados do campo de entrada do exemplo do componente Campo de Entrada com Sugestões como entrada:

Figura 35. Exemplo de Widget de Caixa de Opções
Exemplo de Widget de Caixa de Opções
  1. Número de colunas por linha (1)
  2. Legenda (do componente)

As seguintes configurações podem ser configuradas para este widget:

Valor Selecionado
Necessário. A cadeia que é inserida no campo de entrada da tela host quando a caixa de opções é selecionada. Esse valor também é utilizado para definir o estado inicial da caixa de opções quando a página da Web for carregada.
Valor com Seleção Cancelada
Requerido. A cadeia que é inserida no campo de entrada da tela host quando é cancelada a seleção da caixa de opções. Esse valor também é utilizado para definir o estado inicial da caixa de opções quando a página da Web for carregada.
Origem da Legenda
Especifica como a legenda da caixa de opções gerada é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda para a caixa de opções.
Nota:
Deixe essa definição em branco para não gerar uma legenda para a caixa de opções.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Número de Colunas por Linha
O número das caixas de opção a ser exibido horizontalmente antes de quebrar para a próxima linha.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Classe de Estilo da Caixa de Opções Apenas Web 
Opcional. A classe de estilo CSS associada à caixa de opções gerada. O valor do atributo de classe da tag da entrada HTML será configurado com este valor. O valor padrão é HATSCHECKBOX. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda da caixa de opção gerada. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de uma caixa de opções for processada, uma tabela HTML será gerada para englobar essas caixas de opções. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.

__________________________________________________________________________

Combinação  Apenas RCP 

O widget Combinação é responsável por renderizar caixas de combinação drop-down editáveis.

Notas:
  1. Por razões de segurança, o widget Combinação não deve ser utilizado para renderizar campos de senha. Os caracteres digitados em um campo de senha renderizado com o widget Combinação estarão visíveis conforme o usuário digitar.
  2. Para obter considerações sobre DBCS ao utilizar este widget, consulte Mudança de AutoIME.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de combinação aparece em uma transformação, utilizando os dados do exemplo do componente Campo de Entrada com Sugestões como entrada:

Figura 36. Exemplo do Widget Combinação
Exemplo do Widget Combinação
  1. Legenda (do componente)
  2. Número de colunas por linha (definido por padrão como 1)
  3. Preencher (a partir das sugestões)

As seguintes configurações podem ser configuradas para este widget:

Preenchimento a partir de Variável Global
Se essa opção for selecionada, preencha o drop-down das variáveis globais especificadas.
Variável global Contendo Valores da Lista
Especifica o nome da variável global indexada que contém o conjunto de valores. Um item para cada índice na variável global será criado no drop-down.
Compartilhado
As variáveis globais locais e compartilhadas do HATS podem ter o mesmo nome. Selecione esta caixa se você desejar utilizar a variável global compartilhada para preencher os itens da lista. Quando esta caixa estiver limpa, a variável global local será utilizada.
Variável Global Contendo Legendas da Lista
Opcional. Especifica o nome da variável global indexada contendo o conjunto de legendas. O tamanho da variável global especificada por este valor deve ser maior ou igual ao tamanho especificado na definição precedente. Os índices nesta variável global indexada também devem corresponder aos índices na variável global de valores (para que o valor real e a legenda mostrados ao usuário estejam em sincronia). Se esse valor não for especificado, a legenda para cada item no drop-down será seu valor.
Preencher a partir da Cadeia
Se essa opção for selecionada, preencha o drop-down da cadeia especificada.
Itens da Lista
Opcional. Especifica a cadeia de itens a ser incluída no drop-down. Os itens devem ser separados por um ponto-e-vírgula (;). Para fazer com que a legenda do item da lista seja diferente do valor do item da lista, digite um sinal de igual (=) e especifique uma legenda. Por exemplo, um valor Maçã=M;Uva=U renderizaria um drop-down com dois itens: Maçã e Uva. Selecionar o primeiro item faria com que um M fosse inserido no campo de entrada da tela do host associado.

Se você desejar que o item no drop-down e o valor inserido na tela do host sejam os mesmos, é necessário apenas digitar o item. Por exemplo, Apple=A;G. Neste exemplo, um G aparece na lista suspensa no campo de entrada da tela do host.

Preencher a partir das Sugestões
Se esta opção for selecionada, preencha o drop-down das sugestões reconhecidas pelo componente (aplicável apenas quando o componente Campo de Entrada com Sugestões for utilizado).
Origem da Legenda
Especifica como a legenda para o drop-down gerado é determinado. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda para o drop-down.
Nota:
Deixe essa definição em branco para não gerar uma legenda para drop-down.
Número de Colunas por Linha
O número de drop-downs a serem exibidos horizontalmente antes de quebrar para a próxima linha. O padrão é 1.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Substituir Comprimento Máximo
Se essa opção for selecionada, o valor do comprimento máximo especificado será configurado em cada campo de entrada de geração. Essa configuração é útil para restringir manualmente o número de caracteres que podem ser digitados em um campo de entrada. Se essa opção for limpa, o número máximo de caracteres permitidos será determinado pelo componente de reconhecimento.
Comprimento máximo
O número máximo de caracteres que pode ser inserido em cada campo de entrada.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

As cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar, vídeo reverso, sublinhado e separador de coluna) serão exibidos.

Os atributos de campo estendidos são mapeados pelo modelo do rich client.

Substituir fonte
Selecione esta opção e utilize os controles de configuração de Fonte fornecidos para substituir o nome da fonte padrão, o estilo da fonte e o tamanho da fonte.
Substituir Cor
Selecione esta opção e utilize os controles de configuração Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e de segundo planos.

__________________________________________________________________________

Diálogo

O widget Diálogo é responsável por renderizar caixas de diálogo. Ele processa dados fornecidos pelo componente Diálogo.

A figura a seguir mostra como um widget Diálogo aparece em uma transformação, utilizando os dados do exemplo do componente Diálogo como entrada:

Figura 37. Exemplo do Widget Diálogo
Exemplo do Widget Diálogo
  1. Área desativada
  2. Moldura especializada
  3. Caracteres de moldura removidos

As seguintes configurações podem ser configuradas para este widget:

Ocultar área desativada fora do diálogo
Especifica se irá ocultar a área fora do diálogo.
Classe de Estilo de Área Desativada Apenas Web 
Especifica a classe de estilo CSS a ser utilizada para a área desativada.
Utilizar molduras especializadas  Apenas Web 
Especifica se será necessário utilizar molduras especializadas em vez do texto original.
Remover Caracteres da Moldura Apenas Web 
Especifica se irá mostrar os caracteres da moldura original.
Classe de Estilo da Moldura
Especifica a classe de estilo CSS a ser utilizada para a moldura.
Estilo de Moldura  Apenas Web 
Esquerda
Especifica a classe de estilo CSS a ser utilizada para a moldura esquerda.
Direita
Especifica a classe de estilo CSS a ser utilizada para a moldura direita.
Superior
Especifica a classe de estilo CSS a ser utilizada para a moldura superior.
Inferior
Especifica a classe de estilo CSS a ser utilizada para a moldura inferior.
Estilo de Canto  Apenas Web 
Superior Esquerdo
Especifica a classe de estilo CSS a ser utilizada para o canto superior esquerdo da moldura.
Superior Direito
Especifica a classe de estilo CSS a ser utilizada para o canto superior direito da moldura.
Inferior Esquerdo
Especifica a classe de estilo CSS a ser utilizada para o canto inferior esquerdo da moldura.
Inferior Direito
Especifica a classe de estilo CSS a ser utilizada para o canto inferior direito da moldura.

__________________________________________________________________________

Drop-down (Entrada de Dados)

O widget Drop-down (entrada de dados) é responsável por renderizar drop-downs.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de lista drop-down de entrada de dados aparece em uma transformação, utilizando os dados do exemplo do componente Campo de Entrada com Sugestões como entrada:

Figura 38. Exemplo de Widget da Lista Drop-down de Entrada de Dados
Exemplo de Widget da Lista Drop-down de Entrada de Dados
  1. Legenda (do componente)
  2. Número de colunas por linha (1)
  3. Preencher (a partir das sugestões)

As seguintes configurações podem ser configuradas para este widget:

Preenchimento a partir de Variável Global
Se essa opção for selecionada, preencha o drop-down das variáveis globais especificadas.
Variável global Contendo Valores da Lista
Especifica o nome da variável global indexada que contém o conjunto de valores. Um item para cada índice na variável global será criado no drop-down.
Compartilhado
As variáveis globais locais e compartilhadas do HATS podem ter o mesmo nome. Selecione esta caixa se você desejar utilizar a variável global compartilhada para preencher os itens da lista. Quando esta caixa estiver limpa, a variável global local será utilizada.
Variável Global Contendo Legendas da Lista
Opcional. Especifica o nome da variável global indexada contendo o conjunto de legendas. O tamanho da variável global especificada por este valor deve ser maior ou igual ao tamanho especificado na definição precedente. Os índices nesta variável global indexada também devem corresponder aos índices na variável global de valores (para que o valor real e a legenda mostrados ao usuário estejam em sincronia). Se esse valor não for especificado, a legenda para cada item no drop-down será seu valor.
Preencher a partir da Cadeia
Se essa opção for selecionada, preencha o drop-down da cadeia especificada.
Itens da Lista
Opcional. Especifica a cadeia de itens a ser incluída no drop-down. Os itens devem ser separados por um ponto-e-vírgula (;). Para fazer com que a legenda do item da lista seja diferente do valor do item da lista, digite um sinal de igual (=) e especifique uma legenda. Por exemplo, um valor Maçã=M;Uva=U renderizaria um drop-down com dois itens: Maçã e Uva. Selecionar o primeiro item faria com que um M fosse inserido no campo de entrada da tela do host associado.

Se você desejar que o item no drop-down e o valor inserido na tela do host sejam os mesmos, é necessário apenas digitar o item. Por exemplo, Apple=A;G. Neste exemplo, um G aparece na lista suspensa no campo de entrada da tela do host.

Preencher a partir das Sugestões
Se esta opção for selecionada, preencha o drop-down das sugestões reconhecidas pelo componente (aplicável apenas quando o componente Campo de Entrada com Sugestões for utilizado).
Origem da Legenda
Especifica como a legenda para o drop-down gerado é determinado. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda para o drop-down.
Nota:
Deixe essa definição em branco para não gerar uma legenda para drop-down.
Número de Colunas por Linha
O número de drop-downs a serem exibidos horizontalmente antes de quebrar para a próxima linha.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Enviar Automaticamente na Seleção
Se esta opção for selecionada, depois que uma seleção for feita no drop-down, ela será enviada.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão enviar será renderizado ao lado do drop-down.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo Drop-down Apenas Web 
Opcional. A classe de estilo CSS associada à lista drop-down gerada. O valor do atributo de classe da tag drop-down HTML será configurado com este valor. O valor padrão é HATSDROPDOWN. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Opção da Lista Apenas Web 
Opcional. A classe de estilo CSS associada a cada opção no drop-down. O valor padrão é HATSOPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda drop-down gerada. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um drop-down for processado, uma tabela HTML será gerada para incluir esses drop-downs. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Drop-down (Seleção)

O widget Drop down (seleção) é responsável por processar drop-downs HTML.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de lista drop-down da lista de seleção aparece em uma transformação, utilizando os dados do exemplo do componente Lista de Seleção como entrada:

Figura 39. Exemplo de Widget da Lista Drop-down da Lista de Seleção
Exemplo de Widget da lista Drop-down da Lista de Seleção
  1. Tipo de legenda (mostrar ambos)
  2. Token inicial (mostrar ambos)
  3. Descrição (mostrar ambos)
  4. Botão Enviar (mostrar botão enviar)
  5. Legenda do botão Enviar (enviar)

As seguintes configurações podem ser configuradas para este widget:

Tipo da legenda
Especifica como o token inicial do item da lista é exibido. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparecerá no drop-down. Por exemplo, se a tela de host tivesse um item de menu 4. Correio, a legenda exibiria 4 ou Correio ou 4. Correio.
Enviar Automaticamente na Seleção
Se esta opção for selecionada, depois que uma seleção for feita no drop-down, ela será enviada. Se o drop-down contiver teclas de função, a tecla do item da lista selecionada será enviada para o host. Se o drop-down contiver itens da lista de seleção, o valor do item selecionado será inserido no campo de destino e a tecla de ação especificada será enviada para o host.
Mostrar Botão Enviar
Se essa opção for selecionada, um botão enviar será renderizado ao lado do drop-down. Não se aplica ao utilizar esse widget com o componente da tecla de função.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão enviar gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo Drop-down Apenas Web 
Opcional. A classe de estilo CSS associada à lista drop-down gerada. O valor do atributo de classe da tag drop-down HTML será configurado com este valor. O valor padrão é HATSDROPDOWN. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Opção da Lista Apenas Web 
Opcional. A classe de estilo CSS associada a cada opção no drop-down. O valor padrão é HATSOPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda drop-down gerada. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um drop-down for processado, uma tabela HTML será gerada para incluir esses drop-downs. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Campo

O widget Campo é responsável por processar os campos de entrada e o texto reconhecido pelo componente Campo.

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget campo aparece em uma transformação, utilizando os dados do exemplo do componente Campo como entrada:

Figura 40. Exemplo de Widget de Campo
Exemplo de Widget de Campo
  1. Texto Protegido

A meta primária do layout de tabelas do widget Campo é preservar o layout da tela de host original quando ela é renderizada em uma GUI. Na renderização padrão, uma tabela é utilizada para preservar o layout da tela. Essa tabela normalmente tem 80 colunas e 24 linhas. Cada uma das configurações de alinhamento diferentes no widget Campo (Normal, Caractere por caractere  Apenas Web  e Palavra por palavra) altera como as células nessa tabela são criadas.

Com alinhamento normal, cada campo do host é representado por uma célula de tabela dentro da tabela. A célula poderá consumir uma ou mais colunas. Consulte o atributo de HTML "colspan" para obter mais detalhes. Se um campo iniciar na coluna 10 na tela do host, ele será posicionado na coluna 10 na tabela. O alinhamento normal garante que cada campo comece no local correto da coluna.

As regras globais podem impactar o alinhamento de uma página porque, normalmente, uma regra global consome mais espaço de página do que o campo que ela transformou. Por exemplo, imagine que você tem um campo de entrada com cinco caracteres de comprimento. A renderização padrão aloca cinco colunas na tabela para este campo. Se o campo for renderizado por uma regra global que utiliza mais de cinco caracteres de espaço, a célula da tabela em que ela reside será forçada a expandir, ou seja, a largura da célula será aumentada. Isso gera um impacto na tabela inteira porque a coluna inteira é afetada. Normalmente, as células à direita do campo, em qualquer linha, são deslocadas para a direita porque as colunas que contêm o campo transformado agora são mais amplas. Portanto, um campo que se inicia na coluna 60 da linha 5, sempre será alinhado com um campo que se inicia na coluna 60 da linha 20.

O alinhamento caractere por caractere é suportado apenas em projetos da Web do HATS. Esta opção de alinhamento faz com que cada caractere de um campo, exceto para campos de entrada, seja renderizado em sua própria célula de tabela. Embora o uso desta opção garanta que cada caractere na tela seja alocado no local de início correto, ele também faz com que o tamanho da página gerada seja muito grande.

O alinhamento palavra por palavra faz com que cada palavra na tela seja renderizada em sua própria célula da tabela. Isto significa que um único campo feito de várias palavras será renderizado em mais de uma célula da tabela. Isto garante que cada palavra na tela seja renderizada no local correto. Esta opção é normalmente utilizada quando uma tela do host tem uma mistura de campos de entrada espalhados em toda a tela. Os campos de entrada podem fazer com que uma página fique desalinhada porque eles consomem mais espaço de página do que o texto regular.

O seguinte exemplo mostra como as opções de alinhamento diferentes são mapeadas para campos e caracteres dentro de células de tabela na renderização padrão. As células da tabela são invisíveis na renderização padrão real.

Figura 41. Exemplos de Alinhamento do Widget Campo
Exemplos de Opções de Alinhamento do Widget Campo

As seguintes configurações podem ser configuradas para este widget:

Apenas para Leitura
Se esta opção for selecionada, os campos de entrada não serão renderizados. Se um campo de entrada contiver texto (e não estiver protegido por senha) esse texto será exibido. Essa configuração será útil se você desejar mostrar aos usuários uma página de informações, mas não desejar que eles a edite.
Layout

Use esta configuração para especificar o layout de saída renderizado pelo widget. Selecione Tabela para renderizar a saída em uma tabela, com a meta de preservar o layout da tela de host original. Este é o padrão para aplicativos da Web não otimizados para dispositivos remotos. Selecione Separado para renderizar a saída utilizando as tags de extensão seqüencial para diferenciar entre campos, com a meta de reduzir a quantidade de HTML e espaço em branco. Este é o padrão para aplicativos da Web otimizados para dispositivos remotos.

Alinhamento
O uso do layout de tabelas, indica como você deseja que o HATS mapeie os caracteres de texto em células de tabelas para melhorar seu alinhamento (Normal, Caractere por Caractere  Apenas Web  ou Palavra por Palavra)
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSFIELDTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
nowrap  Apenas Web 

Quando você especifica Palavra por palavra para a configuração Alinhamento, vários campos são alinhados palavra por palavra na transformação. No entanto, outro widget poderia criar uma saída que fizesse com que as células na tabela de renderização padrão fossem compactadas, causando, dessa forma, o agrupamento do texto. Para assegurar que o texto não seja agrupado, um sinalizador nowrap é automaticamente incluído na saída HTML quando o alinhamento palavra por palavra é utilizado. Utilize esta configuração nowrap para desativar a inclusão automática do sinalizador nowrap para a saída HTML.

A configuração de nowrap como false, com qualquer valor das configurações de alinhamento, evita a inclusão do sinalizador nowrap na saída HTML do widget campo, permitindo que o texto na célula seja agrupado. Você apenas deve configurar o nowrap como false quando estiver utilizando o alinhamento palavra por palavra e continuar tendo problemas de alinhamento.

Na renderização padrão, se uma célula da tabela for agrupada, os alinhamentos vertical e horizontal poderão ser afetados de forma adversa, causando uma saída indesejada.

Se você configurar nowrap como true com qualquer valor da configuração de alinhamento, o agrupamento do texto para a próxima linha em uma célula de tabela não ocorrerá.

Nota:
A configuração de nowrap não aparece na GUI como uma definição configurável. Ela deve ser configurada na origem do arquivo application.hap. Por exemplo, para configurar nowrap como false, na visualização Projetos HATS, dê um clique duplo no arquivo Configurações do Projeto na pasta do projeto para ativar o editor para o arquivo application.hap. Na guia Origem localize a classe, name="com.ibm.hats.transform.widgets.FieldWidget", na tag <classSettings> e inclua a seguinte configuração:
<setting name="nowrap" value="false"/>
Permite o posicionamento do cursor em campos protegidos
Se esta opção for selecionada, clicar em um desses campos protegidos fará com que o cursor do host seja configurado para aquela posição específica. Essa configuração será útil se seu aplicativo do host for sensível à posição do cursor e precisar que o usuário posicione o cursor em um campo protegido.

Para aplicativos da Web, a precisão com que a posição do cursor pode ser configurada é determinada pela configuração Alinhamento (Normal, Caracter por caractere  Apenas Web  ou Palavra por palavra).

Para aplicativos do rich client, a posição do cursor pode ser configurada em qualquer lugar dentro do campo. A configuração Alinhamento não afeta a precisão com que a posição do cursor pode ser configurada.

No tempo de execução no navegador, o HATS é notificado quando um desses campos é clicado. O HATS atualiza a posição do cursor internamente e, em seguida, indica visualmente a nova posição do cursor para o usuário. Por padrão, a indicação visual é para definir a cor do segundo plano do texto para amarelo. Para aplicativos da Web, essa indicação visual pode ser controlada pelo desenvolvedor através da utilização de um estilo CSS, HCURSORINDICATOR. Consulte Utilizando Folhas de Estilo para obter informações adicionais. Com essa configuração ativada, o recurso a seguir é fornecido:

Nota:
Essa configuração sozinha não funcionará corretamente quando a mesma área de uma tela for renderizada várias vezes utilizando o widget Campo. Por exemplo, no caso em que a mesma região da tela é renderizada em várias guias em uma pasta tabulada, você deve adicionalmente renderizar os campos protegidos como links (consulte Permitir Tabulação Utilizando Links abaixo) para fornecer aos usuários a capacidade de posicionar o cursor nessa região da tela.
Permite tabulação utilizando links  Apenas Web 
Se esta opção for selecionada, cada campo protegido será renderizado como um link HTML que permite tabulação entre campos protegidos. A posição do cursor será exibida como um caractere sublinhado.
Nota:
A seleção dessa opção faz com que uma tag de âncora <A> HTML seja gerada para cada campo protegido na página e, como resultado, aumenta o tamanho da página da Web.

Para evitar o aumento desnecessário do tamanho da página da Web resultante, essa opção não é selecionada por padrão.

Classe de Estilo do Link Apenas Web 
A classe de estilo CSS associada a cada link gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSPROTLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Tecla de Ação
Opcional. Especifica o mnemônico da tecla AID do host que deve ser enviado ao host quando um campo protegido for selecionado. Por exemplo: [enter] , que faz com que o cursor seja configurado para o local especificado e enter seja enviado ou [pf1] , que faz com que o cursor seja configurado para o local especificado e pf1 seja enviado.
Recortar Espaços em Links
Se esta opção for selecionada, o espaço em branco (espaço extra) será recortado nas duas extremidades dos links do campo protegido. Essa configuração é útil para reduzir a quantidade de texto que é renderizada como links.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Classe de estilo de campo  Apenas Web 
Opcional. A classe de estilo CSS associada ao campo gerado. O valor do atributo de classe da tag HTML será configurado com este valor. O valor padrão é HATSFIELD. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar  Apenas Web , vídeo reverso, sublinhado e separador de coluna) serão renderizados. Além disso, para aplicativos da Web 3270, as cores de campo estendido serão mapeadas (consulte a configuração Ativar Cores de Primeiro Plano para obter informações adicionais).

Para aplicativos do rich client, o vídeo reverso é renderizado utilizando a cor mapeada pelo modelo do rich client como a cor de segundo plano e preto como a cor de primeiro plano. Os separadores de coluna são renderizados com linhas pontilhadas sob o campo.

Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Renderizar utilizando fonte monoespaçada
Se selecionado, o campo será renderizado utilizando uma fonte monoespaçada. Caso contrário, ele será exibido utilizando a fonte padrão para o ambiente do código do idioma.
Ativar bloquei numérico do 3270
Se selecionado, o usuário poderá inserir apenas números de 0 a 9, sinal de mais, sinal de menos, ponto final, vírgula e numerais hindi nos campos numéricos do 3270. Se desmarcado, quaisquer caracteres podem ser inseridos. O padrão é desmarcado.
Nota:
Para aplicativos da Web, é possível customizar a lista de teclas aceitáveis no arquivo lxgwfunctions.js nas funções allowNumLockOnly() e allowNumLockOnlyForIEMobile(), conforme apropriado, utilizando valores de código de caracteres.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecionar essa opção apara os espaços inicial e final do campo de entrada.
Estilo Apenas Web 
Opcional. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Nota:
Devido ao grande número de tags geradas por esse widget, você pode aumentar consideravelmente o tempo de download para a sua página se especificar um valor para essa configuração. Especifique as substituições de estilo na transformação contida ou o arquivo de folha de estilo incluído.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Gráfico (Barra horizontal, Linha, Barra Vertical)

Os widgets Gráficos são responsáveis pela renderização de imagens de gráficos em JPEG.

Este widget processa dados fornecidos pelos seguintes componentes:

Nota:
Esse widget pode não ser adequado para a renderização de intervalos extremos de dados.

A seguir estão exemplos de como o gráfico de barras horizontais, o gráfico de linhas e os gráficos de barras verticais aparecem em uma transformação, utilizando os dados do exemplo de componente Tabela (visual) como entrada:

Figura 42. Exemplo de Widget do Gráfico de Barras Horizontais
Exemplo de Widget do Gráfico de Barras Horizontais
Figura 43. Exemplo de Widget do Gráfico de Linhas
Exemplo de Widget do Gráfico de Linhas
Figura 44. Exemplo de Widget do Gráfico de Barras Verticais
Exemplo de Widget do Gráfico de Barras Verticais
  1. Conjuntos de dados (6)
  2. Título do eixo X (Ano; Quantidade no gráfico de barras horizontais)
  3. Título do eixo Y (Quantidade; Ano no gráfico de barras horizontais)
  4. Etiqueta de ponto de dados (extrair)
  5. Etiqueta do conjunto de dados (extrair)

As seguintes configurações podem ser configuradas para este widget:

Número de conjuntos de dados
Especifica o número de conjuntos de dados a serem descritos no gráfico. Esta configuração será exibida apenas no assistente Inserir Componente do Host.
Origem do Conjunto de Dados
Especifica como obter valores para um ou mais conjuntos de dados. Opções: Linha (cada linha da tabela constitui um conjunto de dados a ser representado em gráfico) ou Coluna (cada coluna da tabela constitui um conjunto de dados a ser representado em gráfico).
Largura (pixels)
Largura, em pixels, do gráfico.
Altura (pixels)
Altura, em pixels, do gráfico.
Cor do Plano de Fundo
Especifica a cor a ser utilizada como plano de fundo do gráfico. Clique no botão seletor de cores para exibir uma paleta de cores.
Imagem de Plano de Fundo
Insira o nome da imagem a ser utilizada como o plano de fundo do gráfico (relativo à pasta Web Content\Common\Images do projeto da Web ou à pasta Rich Client Content\Images do projeto rich client). Clique no botão Procurar para importar uma imagem do seu sistema.
Fonte Padrão
Especifique a fonte, o tipo e o tamanho da fonte.
Título do Eixo X
Opcional. Cadeia que especifica a etiqueta do eixo X do gráfico.
Título do Eixo Y
Opcional. Cadeia que especifica a etiqueta do eixo Y do gráfico.
Cor do Eixo
Especifica a cor para desenhar os eixos dentro do gráfico. Clique no botão seletor de cores para exibir uma paleta de cores.
Cor da Etiqueta
Especifica a cor para o desenho nas etiquetas dentro do gráfico. Clique no botão seletor de cores para exibir uma paleta de cores.
Ausência de Alias de Texto
Se esta opção for selecionada, a ausência de alias de texto será utilizada para suavizar as bordas do texto desenhado.
Texto Alternativo
Opcional. Especifica o texto que aparecerá se a imagem gráfica renderizada não puder ser carregada pelo navegador cliente do usuário.

Assim como com as definições Número de conjunto de dados, as seguintes definições são exibidas apenas no Assistente para Inserir Componente Host.

Extrair Etiquetas de Ponto de Dados
Selecione esta caixa se desejar que as etiquetas para os pontos de dados do gráfico sejam extraídas de uma linha (ou coluna) da tabela.
Linha (ou Coluna)
Especifique o número da linha (ou coluna) a partir da qual as etiquetas de pontos de dados devem ser extraídas. A etiqueta para esse campo de entrada (Linha ou Coluna) depende do valor especificado para a definição Origem do conjunto de dados.
Extrair etiquetas do conjunto de dados (para legenda)
Selecione esta caixa se desejar que as etiquetas para os conjunto de dados do gráfico sejam extraídas de uma linha (ou coluna) da tabela.
Linha (ou Coluna)
Especifique o número da linha (ou coluna) a partir da qual as etiquetas de conjunto de dados devem ser extraídas. A etiqueta para esse campo de entrada (Linha ou Coluna) depende do valor especificado para a definição Origem do conjunto de dados.
Conjunto de Dados
Clique neste botão para exibir o diálogo Configurações da Origem de Dados, que permite especificar as seguintes definições adicionais para as origens de dados:
Conjunto de Dados set 'n', 'row' ou 'column'
O número ('n') desses campos corresponde ao valor especificado na definição Origem do conjunto de dados. Insira o número de qualquer linha ou coluna que você queira utilizar para o conjunto de dados. Isso permite ordenar novamente ou duplicar os conjuntos de dados no gráfico. A última parte da etiqueta para esse campo de entrada depende do valor especificado para a definição Origem do dataset. A etiqueta do campo de entrada corresponde ao valor especificado para a definição Origem do dataset.
cor
Existe um botão colorido para cada uma definições Conjunto de Dados 'n', 'row' ou 'column'. Os botões mostram a cor a ser utilizada para o conjunto de dados no gráfico. Clique no botão para exibir uma paleta de cores se você desejar alterar a cor do conjunto de dados.
etiqueta da legenda
Forneça a etiqueta para utilizar para a legenda. Ativada somente se Extrair etiquetas do conjunto de dados (para legenda) não estiver selecionada.

__________________________________________________________________________

Etiqueta

O widget Etiqueta é responsável por processar o texto.

Este widget renderiza dados fornecidos pelos seguintes componentes.

A figura a seguir mostra como um widget de etiqueta aparece em uma transformação, utilizando os dados do exemplo do componente Texto como entrada:

Figura 45. Exemplo de Widget de Etiqueta
Exemplo de Widget de Etiqueta
  1. Rótulo

As seguintes configurações podem ser configuradas para este widget:

Espaços de corte
Se esta opção for selecionada, o espaço em branco (espaços extras) será removido das duas extremidades do texto selecionado.
Classe de Estilo Apenas Web 
Opcional. A classe de estilo CSS associada ao texto gerado. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Link

O widget Link é responsável por processar os links HTML.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de link aparece em uma transformação, utilizando os dados do exemplo do componente Lista de Seleção como entrada:

Figura 46. Exemplo de Widget de Link
Exemplo de Widget de Link
  1. Linhas
  2. Número de colunas por linha (1)
  3. Token inicial (mostrar ambos)
  4. Descrição (mostrar ambos)

As seguintes configurações podem ser configuradas para este widget:

Tipo da Legenda
Especifica como a legenda para cada link é determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparecerá como o texto para o link. Por exemplo, se a tela do host tivesse um item de menu 4. Correio, você poderia ter a exibição de texto 4 ou Correio ou 4. Correio.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Layout
Especifica como os links serão organizados na página HTML. Opções: Tabela, Separado.
Notas:
  1. Essa configuração não é aplicável na renderização padrão se o componente da tecla de função está sendo usado.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Número de Colunas por Linha
O número dos links a ser exibido horizontalmente antes de quebrar para a próxima linha.
Separador
Especifica qual separador você deseja utilizar para separar os links processados na página HTML. Você pode selecionar a partir da lista drop-down ou digitar o seu no campo de entrada.
Destino Apenas Web 
Selecione da lista drop-down o destino no qual deseja exibir o conteúdo do URL do link; o mesmo, novo, pai ou janela superior.
Classe de Estilo do Link Apenas Web 
Opcional. A classe de estilo CSS associada a cada link gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Link (Seleção de Itens)

O widget link (seleção de itens) é responsável por renderizar o componente seleção de itens como links.

A figura a seguir mostra como um widget de link (seleção de itens) aparece em uma transformação, utilizando os dados do exemplo do componente Seleção de Itens como entrada:

Figura 47. Exemplo do Widget Link (Seleção de Itens)
Exemplo do Widget Link (Seleção de Itens)
  1. Mostrar campo de entrada (não)
  2. Número de colunas por linha (definido por padrão como 1)
  3. Layout (tabela)

A definição a seguir pode ser configurada para este widget:

Layout
Especifica como os links serão organizados na página HTML. Opções: Tabela, Separado.
Número de Colunas por Linha
Especifica quantas instâncias deste widget devem aparecer em cada linha da página HTML processada.
Separador
Especifica qual separador você deseja utilizar para separar os links processados na página HTML. Você pode selecionar a partir da lista drop-down ou digitar o seu no campo de entrada.
Mostrar campo de entrada
Especifica se será exibido um campo de entrada para cada link e o local do campo de entrada (à esquerda/direita dos links). Opções: Nenhum, Esquerda das Legendas, Direita das Legendas.
Valor de Seleção
Especifica caracteres a serem colocados à esquerda do campo de entrada.
Tecla para Enviar Automaticamente
Especifica qual tecla AID será enviada para o host, ou nenhuma.
Classe de Estilo do Link
Opcional. A classe de estilo CSS associada ao link ativador gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSPROTLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.

__________________________________________________________________________

Lista

O widget Lista é responsável por exibir caixas de listagem.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de lista aparece em uma transformação.

Figura 48. Exemplo do Widget Lista
Exemplo do Widget Lista
  1. Legenda (customizada)
  2. Preencher (a partir da cadeia)
  3. Número de linhas exibíveis (padronizado para 5)
  4. Número de colunas por linha (definido por padrão como 1)

As seguintes configurações podem ser configuradas para este widget:

Preenchimento a partir de Variável Global
Se esta opção for selecionada, preencha a lista das variáveis globais especificadas.
Variável global Contendo Valores da Lista
Especifica o nome da variável global indexada que contém o conjunto de valores. Um item para cada índice na variável global será criado na lista.
Compartilhado
As variáveis globais locais e compartilhadas do HATS podem ter o mesmo nome. Selecione esta caixa se você desejar utilizar a variável global compartilhada para preencher os itens da lista. Quando esta caixa estiver limpa, a variável global local será utilizada.
Variável Global Contendo Legendas da Lista
Opcional. Especifica o nome da variável global indexada contendo o conjunto de legendas. O tamanho da variável global especificada por este valor deve ser maior ou igual ao tamanho especificado na definição precedente. Os índices nesta variável global indexada também devem corresponder aos índices na variável global de valores (para que o valor real e a legenda mostrados ao usuário estejam em sincronia). Se esse valor não for especificado, a legenda para cada item na lista será seu valor.
Preencher a partir da Cadeia
Se esta opção for selecionada, preencha a lista a partir da cadeia especificada.
Itens da Lista
Opcional. Especifica a cadeia de itens a ser incluída na lista. Os itens devem ser separados por um ponto-e-vírgula (;). Para fazer com que a legenda do item da lista seja diferente do valor do item da lista, digite um sinal de igual (=) e especifique uma legenda. Por exemplo, um valor Maçã=M;Uva=U renderizaria uma lista com dois itens: Maçã e Uva. Selecionar o primeiro item faria com que um M fosse inserido no campo de entrada da tela do host associado.

Se você desejar que o item na lista e o valor inserido na tela do host sejam os mesmos, é necessário apenas digitar o item. Por exemplo, Maçã=M;U. Neste exemplo, um G aparece na lista e no campo de entrada da tela do host.

Preencher a partir das Sugestões
Se esta opção for selecionada, preencha a lista das sugestões reconhecidas pelo componente (apenas aplicáveis quando o componente Campo de Entrada com Sugestões for utilizado).
Origem da Legenda
Especifica como a legenda para a lista gerada é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda para a lista.
Nota:
Deixe essa configuração em branco para não gerar uma legenda para a lista.
Número de linhas exibíveis
O número de linhas no quadro de listagem que estão visíveis para o usuário. Se houver mais do que esse número de itens na lista, as barras de rolagem aparecerão para que o usuário possa rolar através da lista inteira. O padrão é 5.
Número de Colunas por Linha
O número de listas a serem exibidas horizontalmente antes do agrupamento para a próxima linha. O padrão é 1.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Enviar Automaticamente na Seleção
Se esta opção for selecionada, depois que uma seleção for feita na lista, ela será enviada.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão enviar será renderizado ao lado da lista.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo da Lista  Apenas Web 
Opcional. A classe de estilo CSS associada à lista gerada. O valor do atributo de classe da tag list HTML será configurado com este valor. O valor padrão é HATSDROPDOWN. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Opção da Lista Apenas Web 
Opcional. A classe de estilo CSS associada a cada opção na lista. O valor padrão é HATSOPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda da lista gerada. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de uma lista for renderizada, uma tabela HTML será gerada para incluir essas listas. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

O widget Pop-up é responsável por processar um campo de entrada com um botão, link ou imagem do ativador associado. Esse ativador abre um pop-up que seu usuário pode utilizar para selecionar um valor válido para o campo de entrada associado.

Este widget processa dados fornecidos pelos seguintes componentes:

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget pop-up aparece em uma transformação, utilizando os dados do exemplo do componente Campo de Entrada com Sugestões como entrada:

Figura 49. Exemplo de Widget Pop-up
Exemplo de Widget Pop-up
  1. Legenda (do componente)
  2. Número de colunas por linha (1)
  3. Preencher (a partir das sugestões)
  4. Tipo de ativador (botão)
  5. Legenda do ativador (Valores)

As seguintes configurações podem ser configuradas para este widget:

Preenchimento a partir de Variável Global
Se esta opção for selecionada, preencha a lista pop-up das variáveis globais especificadas.
Variável global Contendo Valores da Lista
Especifica o nome da variável global indexada que contém o conjunto de valores. Será criado um link para cada índice na variável global na janela popup.
Compartilhado
As variáveis globais locais e compartilhadas do HATS podem ter o mesmo nome. Selecione esta caixa se você desejar utilizar a variável global compartilhada para preencher os itens da lista. Quando esta caixa estiver limpa, a variável global local será utilizada.
Variável Global Contendo Legendas da Lista
Opcional. Especifica o nome da variável global indexada contendo o conjunto de legendas. O tamanho da variável global especificada por este valor deve ser maior ou igual ao tamanho especificado na definição precedente. Os índices nesta variável global indexada também devem corresponder aos índices na variável global de valores (para que o valor real e a legenda mostrados ao usuário estejam em sincronia). Se esse valor não for especificado, o texto para cada link será seu valor.
Preencher a partir da Cadeia
Se esta opção for selecionada, preencha a lista pop-up a partir da cadeia especificada.
Itens da Lista
Opcional. Especifica a cadeia de itens a ser incluída na janela pop-up. Os itens devem ser separados por um ponto-e-vírgula (;). Para fazer com que a legenda do item da lista seja diferente do valor do item da lista, digite um sinal de igual (=) e especifique uma legenda. Por exemplo, um valor Maçã=M;Uva=U renderizaria uma janela pop-up com dois itens: Maçã e Uva. Selecionar o primeiro item faria com que um M fosse inserido no campo de entrada da tela do host associado.

Se você desejar que o item na janela pop-up e o valor inserido na tela do host sejam os mesmos, é necessário apenas digitar o item. Por exemplo, Maçã=M;U. Neste exemplo, um G aparece na janela pop-up e no campo de entrada da tela do host.

Preencher a partir das Sugestões
Se esta opção for selecionada, preencha o pop-up das sugestões reconhecidas pelo componente (aplicável apenas quando o componente Campo de Entrada com Sugestões for utilizado).
Origem da Legenda
Especifica como a legenda do campo de entrada gerado é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda do campo de entrada. Nota: Deixe essa definição em branco para não gerar uma legenda para o campo de entrada associado.
Número de Colunas por Linha
O número de campos de entrada a serem exibidos horizontalmente antes de quebrar para a próxima linha.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Apenas para Leitura
Se esta opção for selecionada, os campos de entrada renderizados serão de leitura. Um campo de entrada de leitura aparece como um campo de entrada regular, mas não permite que o usuário modifique seu conteúdo. Isso é útil nos casos em que você deseja exibir o conteúdo de um campo desprotegido a um usuário, mas não deseja que o usuário modifique o conteúdo. No caso do widget Pop-up, ele permite que você controle a entrada fornecida no campo. Apenas os valores disponíveis no pop-up podem ser fornecidos ao campo.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar, vídeo reverso, sublinhado e separador de coluna) serão exibidos. Além disso, para aplicativos da Web 3270, as cores de campo estendido são mapeadas (consulte a configuração anterior para obter informações adicionais). Consulte Utilizando Folhas de Estilo para obter informações adicionais.

Para aplicativos do rich client, os atributos de campo estendido são mapeados pelo modelo do rich client.

Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Tipo de Ativador
Especifica o estilo do ativador. O ativador é utilizado para abrir o popup. Opções Botão, Link ou Imagem.
Nome do Arquivo de Imagem
O nome do arquivo de imagem. Apenas é ativado se o tipo de ativador for uma Imagem. Clique em Importar para importar uma imagem para seu projeto. Uma janela de visualização exibe a imagem selecionada atualmente.
Legenda
A legenda do botão ativador ou link. Será ativado apenas se o tipo de ativador for um Link ou Botão.
Classe de Estilo do Link Apenas Web 
Opcional. A classe de estilo CSS associada ao link ativador gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão ativador gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Fechar legenda de link  Apenas Web 
A legenda que aparece para a ação Fechar.
Classe de Estilo do Campo de Entrada Apenas Web 
Opcional. A classe de estilo CSS associada ao campo de entrada gerado. O valor do atributo de classe da tag da entrada HTML será configurado com este valor. O valor padrão é HATSINPUT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda do campo de entrada gerado. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um conjunto de campos de entrada for processado, uma tabela HTML será gerada para incluir esses campos de entrada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Janela Apenas Web 
Opcional. A classe de estilo CSS associada à janela popup gerada. O valor padrão é HATSPOPUP. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link Fechar Apenas Web 
Opcional. A classe de estilo CSS associada ao link utilizado para fechar a janela popup. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link Item Apenas Web 
Opcional. A classe de estilo CSS associada aos links utilizados para selecionar um item do popup. O valor padrão é HATSPOPUPITEMLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.
Nota:
Às vezes, o widget pop-up pode parecer muito translúcido. Se desejar tornar o widget mais opaco, será necessário modificar a CSS (Cascading Style Sheet) que seu modelo está utilizando, realizando as seguintes etapas:
  1. Abra a CSS que seu modelo está utilizando.
  2. Na classe DIV.HATSPOPUP, procure: filtro: alpha (opacity=40, style=0)
  3. A alteração do valor de opacidade ajustará a transparência do widget pop-up. Em que 0 é transparente e 100 é totalmente opaco.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Botão de Opções (Entrada de Dados)

O widget Botão de Opções (entrada de dados) é responsável por renderizar um conjunto de botões de rádio.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de botão de rádio de entrada de dados aparece em uma transformação, utilizando os dados do exemplo do componente Campo de Entrada com Sugestões como entrada:

Figura 50. Exemplo de Widget de Botão de Opções de Entrada de Dados
Exemplo de Widget de Botão de Opções de Entrada de Dados
  1. Legenda (do componente)
  2. Número de colunas por linha (1)
  3. Preencher (a partir das sugestões)

As seguintes configurações podem ser configuradas para este widget:

Preenchimento a partir de Variável Global
Se esta opção for selecionada, preencha o conjunto de botões de rádio para as variáveis globais especificadas.
Variável global Contendo Valores da Lista
Especifica o nome da variável global indexada que contém o conjunto de valores. Será criado um botão de opções para cada índice na variável global.
Compartilhado
As variáveis globais locais e compartilhadas do HATS podem ter o mesmo nome. Selecione esta caixa se você desejar utilizar a variável global compartilhada para preencher os itens da lista. Quando esta caixa estiver limpa, a variável global local será utilizada.
Variável Global Contendo Legendas da Lista
Opcional. Especifica o nome da variável global indexada contendo o conjunto de legendas. O tamanho da variável global especificada por este valor deve ser maior ou igual ao tamanho especificado na definição precedente. Os índices nesta variável global indexada também devem corresponder aos índices na variável global de valores (para que o valor real e a legenda mostrados ao usuário estejam em sincronia). Se esse valor não for especificado, a legenda para cada botão de opções será seu valor.
Preencher a partir da Cadeia
Se esta opção for selecionada, preencha o conjunto de botões de rádio a partir da cadeia especificada.
Itens da Lista
Opcional. Especifica a cadeia de itens para incluir no conjunto de botões de rádio. Os itens devem ser separados por um ponto-e-vírgula (;). Para fazer com que a legenda do item da lista seja diferente do valor do item da lista, digite um sinal de igual (=) e especifique uma legenda. Por exemplo, um valor Maçã=M;Uva=U renderizaria botões de rádio para dois itens: Maçã e Uva. Selecionar o primeiro item faria com que um M fosse inserido no campo de entrada da tela do host associado.

Se você desejar que o item no conjunto de botões de rádio e o valor inserido na tela do host sejam os mesmos, será necessário apenas digitar o item. Por exemplo, Maçã=M;U. Neste exemplo, um G aparece próximo ao botão de opções e no campo de entrada da tela do host.

Preencher a partir das Sugestões
Se esta opção for selecionada, preencha o conjunto de botões de rádio das sugestões reconhecidas pelo componente (aplicável apenas quando o componente Campo de Entrada com Sugestões for utilizado).
Origem da Legenda
Especifica como a legenda para o conjunto gerado de botões de opções é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda para o conjunto.
Nota:
Deixe essa configuração em branco para não gerar uma legenda para o conjunto.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Número de Colunas por Linha
O número dos botões de opções a ser exibido horizontalmente antes de quebrar para a próxima linha.
Classe de Estilo da Etiqueta Apenas Web 
Opcional. A classe de estilo CSS associada à legenda gerada para o conjunto de botões de opções. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada botão de opções. O valor padrão é HATSRADIOBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Descrição do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada descrição do botão de opções. O valor padrão é HATSTEXT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um botão de rádio for renderizado, uma tabela HTML será gerada para incluí-los. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.

__________________________________________________________________________

Botão de Opções (Seleção de Itens)

O widget Botão de Rádio (seleção de itens) é responsável por renderizar um conjunto de botões de de rádio.

Este widget processa dados fornecidos pelo seguinte componente:

A figura a seguir mostra como um widget de botão de rádio (seleção de itens) aparece em uma transformação, utilizando os dados do exemplo do componente Seleção de Itens como entrada:

Figura 51. Exemplo do Widget Botão de Rádio (Seleção de Itens)
Exemplo do Widget Botão de Rádio (Seleção de Itens)
  1. Legenda (do componente)
  2. Número de colunas por linha (definido por padrão como 1)

As seguintes configurações podem ser configuradas para este widget:

Legenda
Especifica como a legenda do campo de entrada gerado é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda do campo de entrada.
Nota:
Deixe essa definição em branco para não gerar uma legenda para a caixa de opções.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Número de Colunas por Linha
O número de campos de entrada a serem exibidos horizontalmente antes de quebrar para a próxima linha.
Valor de Seleção
O valor a ser digitado no campo de entrada da tela do host quando o valor é selecionado. Opções: /, S ou 1.
Enviar Automaticamente na Seleção
Se esta opção for selecionada, depois que o botão de rádio for selecionado, a seleção de itens será enviada. Se o botão de opções for gerado a partir de uma tecla de função, a tecla do item selecionado será enviada para o host.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão Enviar será renderizado abaixo do conjunto de botões de rádio. Não se aplica ao utilizar esse widget com o componente da tecla de função.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão enviar gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada botão de opções. O valor padrão é HATSRADIOBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Descrição do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada descrição do botão de opções. O valor padrão é HATSTEXT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Etiqueta Apenas Web 
Opcional. A classe de estilo CSS associada à legenda gerada para o conjunto de botões de opções. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um botão de rádio for renderizado, uma tabela HTML será gerada para incluí-los. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.

__________________________________________________________________________

Botão de Opções (Seleção)

O widget Botão de Rádio (seleção) é responsável por renderizar um conjunto de botões de rádio.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget de botão de rádio de lista de seleção aparece em uma transformação, utilizando os dados do exemplo do componente Lista de Seleção como entrada:

Figura 52. Exemplo de Widget de Botão de Opções de Lista de Seleção
Exemplo de Widget de Botão de Opções de Lista de Seleção
  1. Tipo de legenda (mostrar ambos)
  2. Número de colunas por linha (1)
  3. Token inicial (mostrar ambos)
  4. Descrição (mostrar ambos)
  5. Botão Enviar (mostrar botão enviar)
  6. Legenda do botão Enviar (enviar)

As seguintes configurações podem ser configuradas para este widget:

Tipo da legenda
Especifica como a Legenda para Cada Botão é Determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparece na legenda do botão. Por exemplo, se a tela de host tivesse um item de menu 4. Correio, a legenda exibiria 4 ou Correio ou 4. Correio.
Recortar Espaços na Legenda
Se selecionado, o espaço em branco (espaço extra) será aparado em ambas as extremidades da legenda.
Número de Colunas por Linha
O número dos botões de opções a ser exibido horizontalmente antes de quebrar para a próxima linha.
Enviar Automaticamente na Seleção
Se esta opção for selecionada, depois que um botão de rádio for selecionado, a seleção será enviada. Se o botão de opções for gerado a partir de uma tecla de função, a tecla do item selecionado será enviada para o host. Se o botão de opções for gerado a partir de uma lista de seleção, o valor do item selecionado será inserido no campo de destino e a tecla de ação especificada será enviada ao host.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão Enviar será renderizado abaixo do conjunto de botões de rádio. Não se aplica ao utilizar esse widget com o componente da tecla de função.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão enviar gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada botão de opções. O valor padrão é HATSRADIOBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Descrição do Botão de Opções Apenas Web 
Opcional. A classe de estilo CSS associada a cada descrição do botão de opções. O valor padrão é HATSTEXT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Etiqueta Apenas Web 
Opcional. A classe de estilo CSS associada à legenda gerada para o conjunto de botões de opções. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um botão de rádio for renderizado, uma tabela HTML será gerada para incluí-los. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte o Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.

__________________________________________________________________________

Barra de Rolagem (ENPTUI)

O widget de barra de rolagem (ENPTUI) processa dados fornecidos do componente Campo Barra de Rolagem (ENPTUI).

A figura a seguir mostra como um widget Barra de Rolagem (ENPTUI) aparece em uma transformação, utilizando os dados do exemplo do componente Campo Barra de Rolagem (ENPTUI) como entrada:

Figura 53. Exemplo do Widget Barra de rolagem (ENPTUI)
Exemplo do Widget Barra de Rolagem (ENPTUI)
  1. Barra de Rolagem

As seguintes configurações podem ser configuradas para este widget:

Classe de Estilo da Barra de Rolagem Apenas Web 
Opcional. A classe de estilo CSS associada à aparência da barra de rolagem. O valor padrão é HATSESCROLL. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão da Barra de Rolagem  Apenas Web 
Opcional. A classe de estilo CSS associada aos botões da barra de rolagem. O valor padrão é HATSESCROLLBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Cor da Seta do Botão  Apenas Web 
A cor da seta do botão. O valor padrão é Black.
Estilo Apenas Web 
Opcional. Quaisquer propriedades CSS que quiser substituir. Por exemplo, você pode especificar font-color: red; font-size: 18pt; neste campo para alterar a cor e o tamanho da fonte para este widget. As propriedades inseridas aplicam-se a cada elemento desse widget. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir Cor Apenas RCP 
Selecione esta opção e utilize os controles de configuração Cor de Plano de Fundo para substituir as cores do plano de fundo.

__________________________________________________________________________

Subarquivo (Caixa de Opções)

O widget Subarquivo (caixa de opções) é responsável por renderizar um subarquivo 5250.

Este widget renderiza os dados fornecidos pelo componente Subarquivo.

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget de subarquivo (caixa de opções) aparece em uma transformação, utilizando os dados do exemplo do componente Subarquivo como entrada:

Figura 54. Exemplo do Widget Subarquivo (Caixa de Opções)
Exemplo do Widget Subarquivo (Caixa de Opções)
  1. Tipo de legenda (mostrar ambos)
  2. Tipo de ações (link)
  3. Local das ações (subarquivo acima)
  4. Caixa de opções

As seguintes configurações podem ser configuradas para este widget:

Tipo de Legenda:
Especifica como a legenda de cada caixa de opções é determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparecerá como legenda. Por exemplo, se a tela do host tivesse uma ação 5. Exibir, você poderia ter a exibição de legenda 5 ou Exibir ou 5. Exibir.
Tipo de Ações
Especifica se irá utilizar um Botão ou um Link para acionar as ações.
Local das Ações
Especifica o local dos botões ou links que acionam as ações. As opções são Subarquivo Acima e Abaixo, Subarquivo Acima e Subarquivo Abaixo.
Linhas por Registro
Mostrar Cores de Linha Alternadas  Apenas RCP 
Selecione esta caixa para exibir as linhas em cores alternadas. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Número de Linhas
Especifique o número fixo de linhas por registro em seus subarquivos.
Posição da colunas do  Apenas Web 

Este widget pode ser configurado para exibir colunas primárias de dados, e opcionalmente possuir uma seção de detalhes para visualizar colunas de detalhes adicionais. Esta configuração é útil ao exibir dados de tabela em um dispositivo remoto. Para obter mais informações sobre essas configurações e sobre outras configurações para esta opção que não aparece na GUI do HATS Toolkit, consulte Considerações e Limitações de Dispositivos Remotos.

Colunas primárias
Utilize este campo para especificar quais colunas exibir, e em que ordem. O campo permite listagem numérica em qualquer ordem dos números de colunas com abreviação de expansão, e é possível exibir mais uma coluna, ou nenhuma, por exemplo, 1,3,2,5-7,2-3,9 .

Um hífen (-) entre dois números indica um intervalo de colunas. Você pode usar o caractere de asterisco (*) para indicar a última coluna disponível. Um asterisco sozinho significa colunas de 1 a n, em que n é a última coluna disponível. Voce também pode utilizar 5* como uma abreviação para 5-*. Significa a mesma coisa: 1-*, *.

Para projetos da Web, o padrão desta configuração é *, ou todas as colunas. Para projetos da Web otimizados para dispositivos remotos, o padrão da configuração é 1-2, ou colunas 1 e 2.

Nota:
Os números representam colunas fornecidas para o widget pelo componente. Eles não representam as colunas originalmente reconhecidas pelo componente, que podem ou não podem ser excluídas, antes de fornecer para o widget.
Colunas de detalhes
Utilize este campo adicional para especificar quais colunas de detalhes exibir quando solicitado, e em que ordem. Este campo permite listagem numérica em qualquer ordem com abreviação de expansão.

Para projetos da Web, o padrão desta configuração é vazio, ou nenhuma seção de detalhes de coluna. Para projetos da Web otimizados para dispositivos remotos, o padrão desta configuração é 3*, ou coluna 3 até a última.

Manter colunas de detalhes no servidor
Selecione esta opção para manter a seção de colunas de detalhes no servidor até ser solicitado pelo usuário. Isto reduz a quantidade de saída HTML como renderização inicial. O padrão é desmarcado.
Linhas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das linhas a serem realçadas quando exibidas. Esta configuração é útil para realçar linhas importantes na tabela gerada. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Colunas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das colunas a serem realçadas quando exibidas. Esta configuração é útil para realçar colunas importantes na tabela gerada. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Mostrar Linhas de Grade  Apenas RCP 
Selecione esta caixa para mostrar linhas de grade no subarquivo renderizado.
Origem do Cabeçalho da Coluna  Apenas RCP 
Selecione no drop-down se o texto dos cabeçalhos de coluna é fornecido pelo componente cabeçalho do subarquivo (Do Componente) ou por você (Customizado). Se for fornecido pelo componente cabeçalho do subarquivo, consulte a descrição do componente em Cabeçalho a fim de obter informações adicionais.
Cabeçalhos de Coluna (separados por vírgula)  Apenas RCP 
Se a Origem do Cabeçalho da Coluna estiver configurada como Customizada, forneça aqui os cabeçalhos das colunas separados por vírgula.
Utilizar estilo de cabeçalho clássico  Apenas RCP 

Selecione esta caixa para exibir um estilo de cabeçalho clássico. Ela também exibe cabeçalhos de várias linhas, se Origem do Cabeçalho de Coluna for configurado como Do Componente e cabeçalhos de várias linhas forem detectados pelo componente de cabeçalho do subarquivo. Limpe essa caixa para exibir apenas cabeçalhos de controle de tabela SWT padrão em uma única linha.

Recortar Espaços no Cabeçalho Apenas RCP 
Se selecionado, os texto dentro das células de uma linha do cabeçalho terá espaços em branco (espaços extra) aparados em ambas as extremidades.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Classe de estilo de campo  Apenas Web 
Opcional. A classe de estilo CSS associada ao campo gerado. O valor do atributo de classe da tag HTML será configurado com este valor. O valor padrão é HATSFIELD. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Ativar Atributos Estendidos
Se esta opção for selecionada, os atributos de campo estendido (piscar, vídeo reverso, sublinhado e separador de coluna) serão renderizados com o estilo especificado. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecione esta caixa para aparar espaços iniciais e finais do campo de entrada.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Classe de Estilo do Link Apenas Web 
Opcional. A classe de estilo CSS associada ao link de ação gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão de ação gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Caixa de Opções Apenas Web 
Opcional. A classe de estilo CSS associada à caixa de opções gerada. O valor do atributo de classe da tag da caixa de opções HTML será configurado com este valor. O valor padrão é HATSCHECKBOX. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Célula da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada a cada célula na tabela gerada. O valor do atributo de classe da tag (td) da célula de tabela HTML será configurado com este valor. O valor padrão é HATSTABLECELL. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Cabeçalho Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha ou coluna do cabeçalho na tabela gerada. O valor do atributo de classe da tag da linha ou da célula da tabela HTML está configurado com este valor. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Ímpar Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número ímpar na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha ímpar será configurado com este valor. O valor padrão é HATSTABLEODDROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Par Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número par na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha par será configurado com este valor. O valor padrão é HATSTABLEEVENROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.
Nota:
Para projetos do rich client, as diversas configurações de cores para este widget serão aplicadas na seguinte ordem (da mais alta prioridade para a mais baixa prioridade):
  1. Linhas / colunas realçadas
  2. Substituir cor
  3. Ativar atributos estendidos / Ativar cores de primeiro plano
  4. Mostrar cores de linha alternadas
fieldTextAlignment  Apenas Web 
Para projetos da Web, se você utilizar uma fonte não monoespaçada, tal como Sans Serif, os dados renderizados não serão alinhados apropriadamente com problemas de espaçamento entre as palavras. É possível utilizar a configuração de origem, fieldTextAlignment, para corrigir o alinhamento dos dados. Para ativar esta configuração em todo o projeto, abra a visualização de origem do arquivo application.hap, localize a classe para o widget SubfileCheckboxWidget e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
<class name="com.ibm.hats.transform.widgets.SubfileCheckboxWidget">
.
   <setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
Para ativar esta configuração no nível do componente em uma transformação, abra a visualização de origem para a transformação, localize a tag HATS:Component para o widget SubfileCheckboxWidget e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
...
widget="com.ibm.hats.transform.widgets.SubfileCheckboxWidget"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
Os valores para esta configuração são WORD_BY_WORD e NO_SEGMENTING. O valor-padrão é WORD_BY_WORD.
Nota:
Esta configuração não tem efeito quando você utiliza a opção Reconhecimento de Tabela (Visual) para o reconhecimento de dados no componente Subarquivo.

__________________________________________________________________________

Subarquivo (drop-down)

O widget Subarquivo (drop-down) é responsável por renderizar um subarquivo 5250.

Este widget renderiza os dados fornecidos pelo componente Subarquivo.

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget subarquivo (drop-down) aparece em uma transformação, utilizando os dados do exemplo do componente Subarquivo como entrada:

Figura 55. Exemplo do Widget Subarquivo (Drop-Down)
Exemplo do Widget Subarquivo (Drop-Down)
  1. Tipo de legenda (mostrar ambos)
  2. Token de liderança
  3. Descrição
  4. Botão Enviar (mostrar botão enviar)
  5. Legenda do botão Enviar (Enviar)

As seguintes configurações podem ser configuradas para este widget:

Tipo de Legenda:
Especifica como a legenda para cada item no drop-down é determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparecerá como legenda. Por exemplo, se a tela do host tivesse uma ação 5. Exibir, você poderia ter a exibição de legenda 5 ou Exibir ou 5. Exibir.
Mostrar Ações de Subarquivo
Selecione esta caixa se desejar exibir o texto descritivo de ações do subarquivo, como 2=Incluir, com o subarquivo renderizado, além da lista drop-down. A caixa de opções não será ativada quando você selecionar Mostrar Descrição.
Enviar Automaticamente na Seleção
Se essa opção for selecionada, depois que uma seleção for feita no drop-down, ela será enviada.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão Enviar será renderizado abaixo do subarquivo.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão enviar gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Botão Apenas Web 
Opcional. A classe de estilo CSS associada à linha da tabela gerada que contém o botão Enviar. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Linhas por Registro
Mostrar Cores de Linha Alternadas  Apenas RCP 
Selecione esta caixa para exibir as linhas em cores alternadas. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Número de Linhas
Especifique o número fixo de linhas por registro em seus subarquivos.
Posição da colunas do  Apenas Web 

Este widget pode ser configurado para exibir colunas primárias de dados, e opcionalmente possuir uma seção de detalhes para visualizar colunas de detalhes adicionais. Esta configuração é útil ao exibir dados de tabela em um dispositivo remoto. Para obter mais informações sobre essas configurações e sobre outras configurações para esta opção que não aparece na GUI do HATS Toolkit, consulte Considerações e Limitações de Dispositivos Remotos.

Colunas primárias
Utilize este campo para especificar quais colunas exibir, e em que ordem. O campo permite listagem numérica em qualquer ordem dos números de colunas com abreviação de expansão, e é possível exibir mais uma coluna, ou nenhuma, por exemplo, 1,3,2,5-7,2-3,9 .

Um hífen (-) entre dois números indica um intervalo de colunas. Você pode usar o caractere de asterisco (*) para indicar a última coluna disponível. Um asterisco sozinho significa colunas de 1 a n, em que n é a última coluna disponível. Voce também pode utilizar 5* como uma abreviação para 5-*. Significa a mesma coisa: 1-*, *.

Para projetos da Web, o padrão desta configuração é *, ou todas as colunas. Para projetos da Web otimizados para dispositivos remotos, o padrão da configuração é 1-2, ou colunas 1 e 2.

Nota:
Os números representam colunas fornecidas para o widget pelo componente. Eles não representam as colunas originalmente reconhecidas pelo componente, que podem ou não podem ser excluídas, antes de fornecer para o widget.
Colunas de detalhes
Utilize este campo adicional para especificar quais colunas de detalhes exibir quando solicitado, e em que ordem. Este campo permite listagem numérica em qualquer ordem com abreviação de expansão.

Para projetos da Web, o padrão desta configuração é vazio, ou nenhuma seção de detalhes de coluna. Para projetos da Web otimizados para dispositivos remotos, o padrão desta configuração é 3*, ou coluna 3 até a última.

Manter colunas de detalhes no servidor
Selecione esta opção para manter a seção de colunas de detalhes no servidor até ser solicitado pelo usuário. Isto reduz a quantidade de saída HTML como renderização inicial. O padrão é desmarcado.
Linhas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das linhas a serem realçadas quando exibidas. Esta configuração é útil para realçar linhas importantes na tabela gerada. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Colunas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das colunas a serem realçadas quando exibidas. Esta configuração é útil para realçar colunas importantes na tabela gerada. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Mostrar Linhas de Grade  Apenas RCP 
Selecione esta caixa para mostrar linhas de grade no subarquivo renderizado.
Origem do Cabeçalho da Coluna  Apenas RCP 
Selecione no drop-down se o texto dos cabeçalhos de coluna é fornecido pelo componente cabeçalho do subarquivo (Do Componente) ou por você (Customizado). Se for fornecido pelo componente cabeçalho do subarquivo, consulte a descrição do componente em Cabeçalho a fim de obter informações adicionais.
Cabeçalhos de Coluna (separados por vírgula)  Apenas RCP 
Se a Origem do Cabeçalho da Coluna estiver configurada como Customizada, forneça aqui os cabeçalhos das colunas separados por vírgula.
Utilizar estilo de cabeçalho clássico  Apenas RCP 

Selecione esta caixa para exibir um estilo de cabeçalho clássico. Ela também exibe cabeçalhos de várias linhas, se Origem do Cabeçalho de Coluna for configurado como Do Componente e cabeçalhos de várias linhas forem detectados pelo componente de cabeçalho do subarquivo. Limpe essa caixa para exibir apenas cabeçalhos de controle de tabela SWT padrão em uma única linha.

Recortar Espaços no Cabeçalho Apenas RCP 
Se selecionado, os texto dentro das células de uma linha do cabeçalho terá espaços em branco (espaços extra) aparados em ambas as extremidades.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Classe de estilo de campo  Apenas Web 
Opcional. A classe de estilo CSS associada ao campo gerado. O valor do atributo de classe da tag HTML será configurado com este valor. O valor padrão é HATSFIELD. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Ativar Atributos Estendidos
Se esta opção for selecionada, os atributos de campo estendido (piscar, vídeo reverso, sublinhado e separador de coluna) serão renderizados com o estilo especificado. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecione esta caixa para aparar espaços iniciais e finais do campo de entrada.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Classe de Estilo Drop-down Apenas Web 
Opcional. A classe de estilo CSS associada à lista drop-down gerada. O valor do atributo de classe da tag drop-down HTML será configurado com este valor. O valor padrão é HATSDROPDOWN. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Opção da Lista Apenas Web 
Opcional. A classe de estilo CSS associada a cada opção no drop-down. O valor padrão é HATSOPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Célula da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada a cada célula na tabela gerada. O valor do atributo de classe da tag (td) da célula de tabela HTML será configurado com este valor. O valor padrão é HATSTABLECELL. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Cabeçalho Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha ou coluna do cabeçalho na tabela gerada. O valor do atributo de classe da tag da linha ou da célula da tabela HTML está configurado com este valor. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Ímpar Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número ímpar na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha ímpar será configurado com este valor. O valor padrão é HATSTABLEODDROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Par Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número par na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha par será configurado com este valor. O valor padrão é HATSTABLEEVENROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional. Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.
Nota:
Para projetos do rich client, as diversas configurações de cores para este widget serão aplicadas na seguinte ordem (da mais alta prioridade para a mais baixa prioridade):
  1. Linhas / colunas realçadas
  2. Substituir cor
  3. Ativar atributos estendidos / Ativar cores de primeiro plano
  4. Mostrar cores de linha alternadas
fieldTextAlignment  Apenas Web 
Para projetos da Web, se você utilizar uma fonte não monoespaçada, tal como Sans Serif, os dados renderizados não serão alinhados apropriadamente com problemas de espaçamento entre as palavras. É possível utilizar a configuração de origem, fieldTextAlignment, para corrigir o alinhamento dos dados. Para ativar esta configuração em todo o projeto, abra a visualização de origem do arquivo application.hap, localize a classe para o widget SubfileWidgetV6 e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
<class name="com.ibm.hats.transform.widgets.SubfileWidgetV6">
.
   <setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
Para ativar esta configuração no nível do componente em uma transformação, abra a visualização de origem para a transformação, localize a tag HATS:Component para o widget SubfileWidgetV6 e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
...
widget="com.ibm.hats.transform.widgets.SubfileWidgetV6"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
Os valores para esta configuração são WORD_BY_WORD e NO_SEGMENTING. O valor-padrão é WORD_BY_WORD.
Nota:
Esta configuração não tem efeito quando você utiliza a opção Reconhecimento de Tabela (Visual) para o reconhecimento de dados no componente Subarquivo.

__________________________________________________________________________

Subarquivo (Pop-up)

O widget subarquivo (pop-up) é responsável por renderizar um subarquivo 5250.

Este widget renderiza os dados fornecidos pelo componente Subarquivo.

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget subarquivo aparece em uma transformação, utilizando os dados do exemplo do componente Subarquivo como entrada:

Figura 56. Exemplo do Widget Subarquivo (Pop-up)
Exemplo do Widget Subarquivo (Pop-up)
  1. Tipo de legenda (mostrar ambos)
  2. Tipo de ativador (imagem)

As seguintes configurações podem ser configuradas para este widget:

Tipo de Legenda:
Especifica como a legenda para cada item no diálogo pop-up é determinada. O valor do token inicial e a descrição são derivados do componente; você pode selecionar o que aparecerá como legenda. Por exemplo, se a tela do host tivesse uma ação 5. Exibir, você poderia ter a exibição de legenda 5 ou Exibir ou 5. Exibir.
Mostrar Ações de Subarquivo
Selecione esta caixa se desejar exibir o texto descritivo de ações do subarquivo, como 2=Incluir, com o subarquivo renderizado, além do diálogo pop-up. A caixa de opções não será ativada quando você selecionar Mostrar Descrição.
Enviar Automaticamente na Seleção
Se essa opção for selecionada, depois que uma seleção for feita no diálogo pop-up, ela será enviada.
Mostrar Botão Enviar
Se esta opção for selecionada, um botão Enviar será renderizado abaixo do subarquivo.
Legenda do Botão Enviar
Opcional. Especifica a legenda do botão Enviar.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão enviar gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Botão Apenas Web 
Opcional. A classe de estilo CSS associada à linha da tabela gerada que contém o botão Enviar. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Tipo de Ativador
Especifica se irá utilizar uma Imagem, um Botão ou um Link para abrir o diálogo pop-up.
Nome do Arquivo de Imagem
Opcional. O nome do arquivo de imagem para utilizar para o ativador.
Legenda
Opcional. A legenda a ser utilizada para o botão ativador ou link.
Classe de Estilo do Link Apenas Web 
Opcional. A classe de estilo CSS associada ao link de ação gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Botão Apenas Web 
Opcional. A classe de estilo CSS associada ao botão de ação gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Fechar legenda de link  Apenas Web 
A legenda que irá aparecer para a ação Fechar link.
Linhas por Registro
Mostrar Cores de Linha Alternadas  Apenas RCP 
Selecione esta caixa para exibir as linhas em cores alternadas. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Número de Linhas
Especifique o número fixo de linhas por registro em seus subarquivos.
Posição da colunas do  Apenas Web 

Este widget pode ser configurado para exibir colunas primárias de dados, e opcionalmente possuir uma seção de detalhes para visualizar colunas de detalhes adicionais. Esta configuração é útil ao exibir dados de tabela em um dispositivo remoto. Para obter mais informações sobre essas configurações e sobre outras configurações para esta opção que não aparece na GUI do HATS Toolkit, consulte Considerações e Limitações de Dispositivos Remotos.

Colunas primárias
Utilize este campo para especificar quais colunas exibir, e em que ordem. O campo permite listagem numérica em qualquer ordem dos números de colunas com abreviação de expansão, e é possível exibir mais uma coluna, ou nenhuma, por exemplo, 1,3,2,5-7,2-3,9 .

Um hífen (-) entre dois números indica um intervalo de colunas. Você pode usar o caractere de asterisco (*) para indicar a última coluna disponível. Um asterisco sozinho significa colunas de 1 a n, em que n é a última coluna disponível. Voce também pode utilizar 5* como uma abreviação para 5-*. Significa a mesma coisa: 1-*, *.

Para projetos da Web, o padrão desta configuração é *, ou todas as colunas. Para projetos da Web otimizados para dispositivos remotos, o padrão da configuração é 1-2, ou colunas 1 e 2.

Nota:
Os números representam colunas fornecidas para o widget pelo componente. Eles não representam as colunas originalmente reconhecidas pelo componente, que podem ou não podem ser excluídas, antes de fornecer para o widget.
Colunas de detalhes
Utilize este campo adicional para especificar quais colunas de detalhes exibir quando solicitado, e em que ordem. Este campo permite listagem numérica em qualquer ordem com abreviação de expansão.

Para projetos da Web, o padrão desta configuração é vazio, ou nenhuma seção de detalhes de coluna. Para projetos da Web otimizados para dispositivos remotos, o padrão desta configuração é 3*, ou coluna 3 até a última.

Manter colunas de detalhes no servidor
Selecione esta opção para manter a seção de colunas de detalhes no servidor até ser solicitado pelo usuário. Isto reduz a quantidade de saída HTML como renderização inicial. O padrão é desmarcado.
Linhas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das linhas a serem realçadas quando exibidas. Esta configuração é útil para realçar linhas importantes na tabela gerada. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Colunas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das colunas a serem realçadas quando exibidas. Esta configuração é útil para realçar colunas importantes na tabela gerada. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Mostrar Linhas de Grade  Apenas RCP 
Selecione esta caixa para mostrar linhas de grade no subarquivo renderizado.
Origem do Cabeçalho da Coluna  Apenas RCP 
Selecione no drop-down se o texto dos cabeçalhos de coluna é fornecido pelo componente cabeçalho do subarquivo (Do Componente) ou por você (Customizado). Se for fornecido pelo componente cabeçalho do subarquivo, consulte a descrição do componente em Cabeçalho a fim de obter informações adicionais.
Cabeçalhos de Coluna (separados por vírgula)  Apenas RCP 
Se a Origem do Cabeçalho da Coluna estiver configurada como Customizada, forneça aqui os cabeçalhos das colunas separados por vírgula.
Utilizar estilo de cabeçalho clássico  Apenas RCP 

Selecione esta caixa para exibir um estilo de cabeçalho clássico. Ela também exibe cabeçalhos de várias linhas, se Origem do Cabeçalho de Coluna for configurado como Do Componente e cabeçalhos de várias linhas forem detectados pelo componente de cabeçalho do subarquivo. Limpe essa caixa para exibir apenas cabeçalhos de controle de tabela SWT padrão em uma única linha.

Recortar Espaços no Cabeçalho Apenas RCP 
Se selecionado, os texto dentro das células de uma linha do cabeçalho terá espaços em branco (espaços extra) aparados em ambas as extremidades.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Classe de estilo de campo  Apenas Web 
Opcional. A classe de estilo CSS associada ao campo gerado. O valor do atributo de classe da tag HTML será configurado com este valor. O valor padrão é HATSFIELD. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Ativar Atributos Estendidos
Se esta opção for selecionada, os atributos de campo estendido (piscar, vídeo reverso, sublinhado e separador de coluna) serão renderizados com o estilo especificado. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecione esta caixa para aparar espaços iniciais e finais do campo de entrada.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Classe de Estilo do Campo de Entrada Apenas Web 
Opcional. A classe de estilo CSS associada ao campo de entrada gerado. O valor do atributo de classe da tag da entrada HTML será configurado com este valor. O valor padrão é HATSINPUT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Janela Apenas Web 
Opcional. A classe de estilo CSS associada à janela gerada. O valor padrão é HATSPOPUP. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link Fechar Apenas Web 
Opcional. A classe de estilo CSS associada ao link utilizado para fechar a janela. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link Item Apenas Web 
Opcional. A classe de estilo CSS associada aos links utilizados para selecionar um item do widget. O valor padrão é HATSPOPUPITEMLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Célula da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada a cada célula na tabela gerada. O valor do atributo de classe da tag (td) da célula de tabela HTML será configurado com este valor. O valor padrão é HATSTABLECELL. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Cabeçalho Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha ou coluna do cabeçalho na tabela gerada. O valor do atributo de classe da tag da linha ou da célula da tabela HTML está configurado com este valor. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Ímpar Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número ímpar na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha ímpar será configurado com este valor. O valor padrão é HATSTABLEODDROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Par Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número par na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha par será configurado com este valor. O valor padrão é HATSTABLEEVENROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.
Nota:
Para projetos do rich client, as diversas configurações de cores para este widget serão aplicadas na seguinte ordem (da mais alta prioridade para a mais baixa prioridade):
  1. Linhas / colunas realçadas
  2. Substituir cor
  3. Ativar atributos estendidos / Ativar cores de primeiro plano
  4. Mostrar cores de linha alternadas
fieldTextAlignment  Apenas Web 
Para projetos da Web, se você utilizar uma fonte não monoespaçada, tal como Sans Serif, os dados renderizados não serão alinhados apropriadamente com problemas de espaçamento entre as palavras. É possível utilizar a configuração de origem, fieldTextAlignment, para corrigir o alinhamento dos dados. Para ativar esta configuração em todo o projeto, abra a visualização de origem do arquivo application.hap, localize a classe para o widget SubfilePopupWidget e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
<class name="com.ibm.hats.transform.widgets.SubfilePopupWidget">
.
   <setting name="fieldTextAlignment" value="NO_SEGMENTING"/>
.
</class>
Para ativar esta configuração no nível do componente em uma transformação, abra a visualização de origem para a transformação, localize a tag HATS:Component para o widget SubfilePopupWidget e altere o valor da configuração para NO_SEGMENTING, conforme mostrado no exemplo a seguir:
...
widget="com.ibm.hats.transform.widgets.SubfilePopupWidget"
...
widgetSettings="...|fieldTextAlignment:NO_SEGMENTING|..."
...
Os valores para esta configuração são WORD_BY_WORD e NO_SEGMENTING. O valor-padrão é WORD_BY_WORD.
Nota:
Esta configuração não tem efeito quando você utiliza a opção Reconhecimento de Tabela (Visual) para o reconhecimento de dados no componente Subarquivo.

__________________________________________________________________________

Tabela

O widget Tabela é responsável por renderizar uma tabela da GUI.

Este widget processa dados fornecidos pelos seguintes componentes:

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget tabela aparece em uma transformação, utilizando os dados do exemplo do componente Tabela (Campo) como entrada:

Figura 57. Exemplo de Widget de Tabela
Exemplo de Widget de Tabela
  1. Linha do cabeçalho (1)
  2. Coluna do cabeçalho (não especificada)

As seguintes configurações podem ser configuradas para este widget:

Linha do Cabeçalho Apenas Web 
Um conjunto de linhas agrupado ou separado por vírgulas que deve ser processado como um cabeçalho da tabela. Esta configuração é útil para realçar linhas importantes na tabela gerada. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Consulte a descrição para a configuração Classe de estilo de linha do cabeçalho.
Linhas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das linhas a serem realçadas quando exibidas. Esta configuração é útil para realçar linhas importantes na tabela gerada. As linhas representadas por esse valor são baseadas na tabela reconhecida, não na tela de host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Colunas Realçadas  Apenas RCP 
O conjunto separado por vírgulas ou intervalos das colunas a serem realçadas quando exibidas. Esta configuração é útil para realçar colunas importantes na tabela gerada. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Mostrar Cores de Linha Alternadas  Apenas RCP 
Selecione esta caixa para exibir as linhas em cores alternadas. Os valores de cor RGB são determinados pelo objeto ITableColorProvider retornado por seu modelo. Consulte a seção Referência de API do RPC do HATS do 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 para obter informações adicionais sobre as classes RcpTemplate e ITableColorProvider.
Mostrar Linhas de Grade  Apenas RCP 
Selecione esta caixa para mostrar linhas de grade na tabela renderizada.
Origem do Cabeçalho da Coluna  Apenas RCP 
Selecione no drop-down se o texto dos cabeçalhos de coluna é fornecido pelo componente tabela (Do Componente) ou por você (Customizado). Se for fornecido pelo componente tabela, consulte a descrição do componente da configuração Número de Linhas do Título em Tabela a fim de obter informações adicionais.
Cabeçalhos de Coluna (separados por vírgula)  Apenas RCP 
Se a Origem do Cabeçalho da Coluna estiver configurada como Customizada, forneça aqui os cabeçalhos das colunas separados por vírgula.
Recortar Espaços no Cabeçalho
Se selecionado, os texto dentro das células de uma linha do cabeçalho terá espaços em branco (espaços extra) aparados em ambas as extremidades.
Coluna do Cabeçalho Apenas Web 
O conjunto de colunas da tabela agrupado ou separado por vírgulas que deve ser processado como um cabeçalho. Esta configuração é útil para realçar colunas importantes (geralmente a primeira coluna) na tabela gerada. As colunas representadas por esse valor são baseadas na tabela reconhecida, não na tela host real. Valores de Exemplo: 1,2,3...., 1,2-4, 3-5. Consulte a descrição para a configuração Classe de estilo de linha do cabeçalho.
Desativar Entrada
Se esta opção for selecionada, os campos de entrada renderizados serão de leitura. Um campo de entrada de leitura aparece como um campo de entrada regular, mas não permite que o usuário modifique seu conteúdo. Isso é útil nos casos em que você deseja exibir o conteúdo de um campo desprotegido a um usuário, mas não deseja que o usuário modifique o conteúdo.
Posição da colunas do  Apenas Web 

Este widget pode ser configurado para exibir colunas primárias de dados, e opcionalmente possuir uma seção de detalhes para visualizar colunas de detalhes adicionais. Esta configuração é útil ao exibir dados de tabela em um dispositivo remoto. Para obter mais informações sobre essas configurações e sobre outras configurações para esta opção que não aparece na GUI do HATS Toolkit, consulte Considerações e Limitações de Dispositivos Remotos.

Colunas primárias
Utilize este campo para especificar quais colunas exibir, e em que ordem. O campo permite listagem numérica em qualquer ordem dos números de colunas com abreviação de expansão, e é possível exibir mais uma coluna, ou nenhuma, por exemplo, 1,3,2,5-7,2-3,9 .

Um hífen (-) entre dois números indica um intervalo de colunas. Você pode usar o caractere de asterisco (*) para indicar a última coluna disponível. Um asterisco sozinho significa colunas de 1 a n, em que n é a última coluna disponível. Voce também pode utilizar 5* como uma abreviação para 5-*. Significa a mesma coisa: 1-*, *.

Para projetos da Web, o padrão desta configuração é *, ou todas as colunas. Para projetos da Web otimizados para dispositivos remotos, o padrão da configuração é 1-2, ou colunas 1 e 2.

Nota:
Os números representam colunas fornecidas para o widget pelo componente. Eles não representam as colunas originalmente reconhecidas pelo componente, que podem ou não podem ser excluídas, antes de fornecer para o widget.
Colunas de detalhes
Utilize este campo adicional para especificar quais colunas de detalhes exibir quando solicitado, e em que ordem. Este campo permite listagem numérica em qualquer ordem com abreviação de expansão.

Para projetos da Web, o padrão desta configuração é vazio, ou nenhuma seção de detalhes de coluna. Para projetos da Web otimizados para dispositivos remotos, o padrão desta configuração é 3*, ou coluna 3 até a última.

Manter colunas de detalhes no servidor
Selecione esta opção para manter a seção de colunas de detalhes no servidor até ser solicitado pelo usuário. Isto reduz a quantidade de saída HTML como renderização inicial. O padrão é desmarcado.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecione esta caixa para aparar espaços iniciais e finais do campo de entrada.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar, vídeo reverso, sublinhado e separador de coluna) serão exibidos. Além disso, para aplicativos da Web 3270, as cores de campo estendido são mapeadas (consulte a configuração anterior para obter informações adicionais). Consulte Utilizando Folhas de Estilo para obter informações adicionais.

Para aplicativos do rich client, os atributos de campo estendido são mapeados pelo modelo do rich client.

Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Fornecer arquivo de planilha
Se essa opção for selecionada, um ativador fornecido recuperará os dados da tabela em um formato de arquivo de planilha.
Nota:
Essa função não é suportada na renderização de uma combinação de telas.
Prefixo de Nome de Arquivo
Especifica um prefixo para o nome de arquivo da planilha. O padrão é spreadsheet. O nome do arquivo completo terá o formato FileNamePrefix_TimeStamp, em que o formato de registro de data e hora é MMDDYY_HHMMSS, por exemplo, spreadsheet_041506_113020.
Nome de Extensão
O nome de extensão para o tipo de formato de planilha. As opções são .csv e .xls. O arquivo .csv são arquivos de texto puros, com colunas de dados separadas por vírgulas. Os arquivos .xls são arquivos do Microsoft® Excel Biff3. O padrão é .csv.
Tipo de Ativador
O tipo de ativador a ser exibido para o usuário. As opções são Link, Imagem e Botão. O padrão é Link (projetos da Web) ou Botão (projetos do rich client).
Legenda do Ativador
A legenda do ativador a ser exibida para o usuário. O padrão é arquivo de planilha de download (projetos da Web) ou Exportar (projetos do rich client).
Classe de Estilo do Botão Apenas Web 
A classe de estilo CSS associada ao botão ativador gerado. O valor do atributo de classe da tag do botão HTML será configurado com este valor. O valor padrão é HATSBUTTON. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo do Link Apenas Web 
Opcional. A classe de estilo CSS associada ao link ativador gerado. O valor do atributo de classe da tag do link HTML será configurado com este valor. O valor padrão é HATSLINK. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo de Célula da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada a cada célula na tabela gerada. O valor do atributo de classe da tag (td) da célula de tabela HTML será configurado com este valor. O valor padrão é HATSTABLECELL. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha do Cabeçalho Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha ou coluna do cabeçalho na tabela gerada. O valor do atributo de classe da tag da linha ou da célula da tabela HTML está configurado com este valor. O valor padrão é HATSTABLEHEADER. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Ímpar Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número ímpar na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha ímpar será configurado com este valor. O valor padrão é HATSTABLEODDROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Linha Par Apenas Web 
Opcional. A classe de estilo CSS associada a cada linha com número par na tabela. O valor do atributo de classe de cada tag de linha da tabela HTML em um número de linha par será configurado com este valor. O valor padrão é HATSTABLEEVENROW. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.
Nota:
Para projetos do rich client, as diversas configurações de cores para este widget serão aplicadas na seguinte ordem (da mais alta prioridade para a mais baixa prioridade):
  1. Linhas / colunas realçadas
  2. Substituir cor
  3. Ativar atributos estendidos / Ativar cores de primeiro plano
  4. Mostrar cores de linha alternadas

__________________________________________________________________________

Entrada de Texto

O widget Entrada de texto é responsável por processar os campos de entrada HTML.

Este widget processa dados fornecidos pelos seguintes componentes:

Nota:
Para obter considerações sobre DBCS ao utilizar este widget, consulte Eliminar Comprimento Máximo em SBCS.

A figura a seguir mostra como um widget entrada de texto aparece em uma transformação, utilizando os dados do exemplo do componente Linha de Comandos como entrada:

Figura 58. Exemplo de Widget de Entrada de Texto
Exemplo de Widget de Entrada de Texto
  1. Legenda (do componente)

As seguintes configurações podem ser configuradas para este widget:

Substituir Tamanho
Se esta opção for selecionada, o valor do tamanho especificado será configurado em cada campo de entrada gerado. Essa configuração é útil para alterar visualmente o tamanho de um grande campo de entrada do host. Se esta opção for limpa, o tamanho do campo de entrada será determinado pelo componente de reconhecimento.
Tamanho
O tamanho de cada campo de entrada.
Nota:
Esse valor é interpretado pelo navegador - não há garantias de como o campo de entrada será processado nos diferentes navegadores.
Substituir Comprimento Máximo
Se essa opção for selecionada, o valor do comprimento máximo especificado será configurado em cada campo de entrada de geração. Essa configuração é útil para restringir manualmente o número de caracteres que podem ser digitados em um campo de entrada. Se essa opção for limpa, o número máximo de caracteres permitidos será determinado pelo componente de reconhecimento.
Comprimento máximo
O número máximo de caracteres que pode ser inserido em cada campo de entrada.
Origem da Legenda
Especifica como a legenda do campo de entrada gerado é determinada. Opções: Do componente (utilize a legenda extraída do componente) ou Customizada (utilize a legenda especificada).
Legenda Personalizada
Opcional. Especifica a legenda do campo de entrada.
Nota:
Deixe essa definição em branco para não gerar uma legenda para a caixa de opções.
Número de Colunas por Linha
O número de campos de entrada a serem exibidos horizontalmente antes de quebrar para a próxima linha.
Notas:
  1. Essa configuração não é aplicável na renderização padrão.
  2. A visualização do widget nem sempre corresponde à visualização de página inteira. Isso acontece porque a visualização do widget simplesmente renderiza a saída do componente. Ela não tenta preservar o alinhamento da tela quando faz a renderização, como é feito na visualização de página inteira.
Apenas para Leitura
Se essa opção for selecionada, o campo de entrada renderizado será de leitura. Um campo de entrada de leitura aparece como um campo de entrada regular, mas não permite que o usuário modifique seu conteúdo. Isso é útil nos casos em que você deseja exibir o conteúdo de um campo desprotegido a um usuário, mas não deseja que o usuário modifique o conteúdo.
Remover Sublinhados no Campo de Entrada
Selecione esta caixa se você desejar remover os sublinhados do texto quando ele for exibido.
Aparar Espaços no Campo de Entrada
Selecionar essa opção apara os espaços inicial e final do campo de entrada.
Ativar Opção de Posicionamento do Cursor em Arquivos de Saída Apenas Web 
Selecione esta caixa para permitir que o usuário comute do modo dos dados de entrada para o modo de posicionamento do cursor para campos de entrada. Quando no modo de entrada de dados, o usuário pode inserir dados no campo de entrada. Quando no modo e posicionamento do cursor, o usuário pode tabular ou posicionar de outro modo o cursor em qualquer caractere no campo de entrada. Essa configuração é útil para projetos da Web otimizados para dispositivos remotos que não possuem capacidades de posicionamento do cursor. Para obter mais informações sobre outras configurações para esta opção que não aparecem na HATS Toolkit GUI, consulte Considerações e Limitações de Dispositivos Remotos.
Ativar Cores em Primeiro Plano
Se selecionado, as cores de primeiro plano da tela do host serão exibidas.

Para aplicativos da Web, as cores são mapeadas para classes da folha de estilo CSS representando tal cor. Por exemplo, se um campo da tela do host estiver marcado como RED, o widget Campo incluirá o HTML gerado para tal campo em uma tag cujo atributo de nome de classe esteja configurado como HRED. Isso permite que você remapeie as cores da tela do host na sua página da Web gerada.

Nota:
O blacktheme.css mapeia diretamente as cores de primeiro plano do campo da tela do host (por exemplo, texto em vermelho na tela do host aparecerá como texto em vermelho na página da Web gerada). Entretanto, outros arquivos de folha de estilo, como monochrome.css, mapeiam as cores de campos de maneira diferente em uma tentativa de criar um estilo consistente e moderno.

Para aplicativos do rich client, as cores são mapeadas pelo modelo do rich client.

Nota:
Esta configuração é substituída pela configuração Substituir Cor > Cor de Primeiro Plano.
Ativar bloquei numérico do 3270
Se selecionado, o usuário poderá inserir apenas números de 0 a 9, sinal de mais, sinal de menos, ponto final, vírgula e numerais hindi nos campos numéricos do 3270. Se desmarcado, quaisquer caracteres podem ser inseridos. O padrão é desmarcado.
Nota:
Para aplicativos da Web, é possível customizar a lista de teclas aceitáveis no arquivo lxgwfunctions.js nas funções allowNumLockOnly() e allowNumLockOnlyForIEMobile(), conforme apropriado, utilizando valores de código de caracteres.
Ativar Atributos Estendidos
Se essa opção for selecionada, os atributos de campo estendidos (piscar, vídeo reverso, sublinhado e separador de coluna) serão exibidos. Além disso, para aplicativos da Web 3270, as cores de campo estendido são mapeadas (consulte a configuração anterior para obter informações adicionais). Consulte Utilizando Folhas de Estilo para obter informações adicionais.

Para aplicativos do rich client, os atributos de campo estendido são mapeados pelo modelo do rich client.

Estilo Piscar Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto piscante a partir da tela do host.
Estilo de Vídeo Reverso Apenas Web 
A configuração de estilo CSS que você deseja utilizar para processar o texto de vídeo reverso a partir da tela do host.
Estilo Sublinhado Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar o texto sublinhado a partir da tela do host.
Estilo do Separador de Colunas Apenas Web 
A definição de estilo CSS que você deseja utilizar para processar separadores de colunas a partir da tela do host.
Classe de Estilo do Campo de Entrada Apenas Web 
Opcional. A classe de estilo CSS associada ao campo de entrada gerado. O valor do atributo de classe da tag da entrada HTML será configurado com este valor. O valor padrão é HATSINPUT. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Legenda Apenas Web 
Opcional. A classe de estilo CSS associada à legenda do campo de entrada gerado. O valor padrão é HATSCAPTION. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Classe de Estilo da Tabela Apenas Web 
Opcional. A classe de estilo CSS associada à tabela gerada. Se mais de um campo de entrada for processado, uma tabela HTML será gerada para incluir esses campos. O valor do atributo de classe da tag da tabela HTML será configurado com este valor. O valor padrão é HATSTABLE. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Estilo Apenas Web 
Opcional.Utilize o botão do ativador próximo a este campo para abrir um diálogo de propriedades de estilo. Este diálogo o desobriga da necessidade de compreender a CSS para alterar a fonte, a cor ou outras configurações de estilo para o widget. Consulte Utilizando Folhas de Estilo para obter informações adicionais.
Substituir fonte  Apenas RCP 
Selecione esta opção e utilize os controles de configuração da Fonte fornecidos para substituir o nome da fonte, o estilo de fonte e o tamanho da fonte padrão.
Substituir cor  Apenas RCP 
Selecione esta opção e utilize os controles de configuração de Cor de Primeiro Plano e Cor de Segundo Plano fornecidos para substituir as cores de primeiro e segundo planos.

__________________________________________________________________________

Barra de Ferramentas Apenas RCP 

O widget Barra de ferramentas permite renderizar os itens tecla de função e lista de seleção como botões em uma barra de ferramentas. Os itens podem ser renderizados na principal barra de ferramentas da visualização Transformação ou em uma barra de ferramentas independente, o que é útil ao criar seções em um painel e fornecer uma barra de ferramentas para uma seção específica. Quando os itens são renderizados na barra de ferramentas da visualização Transformação, o estilo do botão (texto, imagem ou texto e imagem) é determinado pelas configurações da barra de ferramentas no nível do projeto. Para obter informações adicionais sobre as configurações da barra de ferramentas no nível do projeto, consulte Barra de Ferramentas Apenas RCP . Quando os itens são renderizados em uma barra de ferramentas independente, você controla o estilo da barra de ferramentas utilizando as configurações para esse widget.

Este widget processa dados fornecidos pelos seguintes componentes:

A figura a seguir mostra como um widget Barra de Ferramentas aparece em uma barra de ferramentas da visualização Transformação, utilizando os dados fornecidos por um componente da tecla de função como entrada:

Figura 59. Exemplo do Widget Barra de Ferramentas
Exemplo de Widget Barra de Ferramentas
  1. Contribuir com itens para a barra de ferramentas principal
  2. Exibir itens da barra de ferramentas como (texto e imagem)
    Nota:
    Essa configuração (Exibir itens da barra de ferramentas como) é configurado na definição principal Barra de Ferramentas na guia Renderização do editor de Configurações do Projeto. Seu valor é aplicado quando Contribuir com itens para a barra de ferramentas principal é selecionado para o widget Barra de Ferramentas.
  3. Tipo de legenda (mostrar descrição)

As seguintes configurações podem ser configuradas para este widget:

Contribuir com itens para a barra de ferramentas principal
Selecione esta caixa para renderizar os itens na principal barra de ferramentas da visualização Transformação. Se esta opção for selecionada, os itens da barra de ferramentas serão renderizados com base nas configurações da Barra de Ferramentas no nível do projeto na guia Renderização no editor de Configurações do Projeto. Por exemplo, se a configuração Renderizar itens sob um único item da barra de ferramentas for selecionada para esse widget, suas configurações de Legenda e Imagem serão aplicadas apenas se permitidas pela configuração Exibir itens da barra de ferramentas como no nível do projeto. Para obter informações adicionais, consulte Barra de Ferramentas Apenas RCP .

Selecione esta caixa para renderizar os itens na barra de ferramentas independente. Se estiver utilizando essa opção, você controlará como os itens são renderizados utilizando as configurações Exibir Item Como abaixo.

Exibir item como
Ao renderizar itens em uma barra de ferramentas independente, utilize essa configuração para controlar como irá exibir cada item. As opções são para exibir cada item como Texto, Imagem ou Texto e Imagem.
Renderizar itens sob um único item da barra de ferramentas
Selecione esta caixa para especificar se todos os itens renderizados por esse widget serão exibidos como itens de menu em um único item na barra de ferramentas.
Legenda
Especifica a legenda do texto para utilizar em um único item da barra de ferramentas. Dependendo da configuração Contribuir com itens para a barra de ferramentas principal, essa configuração não terá nenhum efeito se a configuração Exibir itens da barra de ferramentas como no nível do projeto ou as configurações Exibir Item Como no nível do widget estiverem configuradas para Imagem. Para obter informações adicionais, consulte a descrição da configuração Contribuir com itens para a barra de ferramenta principal acima. O padrão é Ações.
Imagem
Especifica a imagem para utilizar em um único item da barra de ferramentas. Selecione uma imagem no drop-down ou utilize o botão Importar para importar uma imagem. Dependendo da configuração Contribuir com itens para a barra de ferramentas principal, essa configuração não terá nenhum efeito se a configuração Exibir itens da barra de ferramentas como no nível do projeto ou as configurações Exibir Item Como no nível do widget estiverem configuradas para Texto. Para obter informações adicionais, consulte a descrição da configuração Contribuir com itens para a barra de ferramenta principal acima.
Tipo da legenda
Utilize esta configuração para controlar qual legenda de texto é exibida para cada item. Esta configuração não terá nenhum efeito se Exibir Item Como estiver configurado para Imagem. As opções são Mostrar Token Inicial, Mostrar Descrição ou Mostrar Ambos. Por exemplo, se o texto do host for F3=Sair, Mostrar Token Inicial exibirá F3, Mostrar Descrição exibirá Sair e Mostrar Ambos exibirá F3=Sair.
Passar mouse sobre origem de ajuda
Controla qual texto é exibido como uma dica de ferramenta quando você passa o mouse sobre um item da barra de ferramentas. As opções são Mostrar Token Inicial, Mostrar Descrição ou Mostrar Ambos. Por exemplo, se o texto do host for F3=Sair, Mostrar Token Inicial exibirá F3, Mostrar Descrição exibirá Sair e Mostrar Ambos exibirá F3=Sair.
Utilizar mapeamentos de imagem no nível do projeto
Selecione esta caixa para especificar que os mapeamentos de imagem no nível do projeto são procurados para que uma imagem seja exibida para um item da barra de ferramentas. Os mapeamentos no nível do projeto são procurados após a primeira procura de mapeamentos no nível do componente ou no nível da renderização padrão.
Mapeamentos de imagem no nível do projeto
Quando você renderiza imagens para itens da barra de ferramentas, é possível mapear o texto de origem da tecla de função ou da lista de seleção para uma imagem específica. Por exemplo, para o texto de origem da tecla de função, F3=Sair, você poderá mapear para uma imagem com base no token inicial (F3), na descrição (Sair) ou na legenda inteira (F3=Sair). Ao contrário de outras configurações de widget, com essa configuração você pode definir mapeamentos de imagem no nível do projeto no editor de Configurações do Projeto e estender (não apenas substituir) esses mapeamentos no nível do componente ou da renderização padrão. Isso permite que você configure mapeamentos genéricos no nível do projeto e faça pequenas alterações no nível do componente ou da renderização padrão.

Utilize o botão Incluir para incluir um novo mapeamento. O diálogo Incluir Condição aparece com as seguintes configurações:

Texto
Define em qual parte do texto de origem da tecla de função ou da lista de seleção procurar o valor especificado no campo Valor. As opções são Token Inicial, Descrição ou Ambos. Por exemplo, se o texto de origem for F3=Sair, especificar Token Inicial procurará F3, especificar Descrição procurará Sair e especificar Ambos procurará F3=Sair para localizar uma correspondência com o valor especificado no campo Valor.
Operador
Define o que é considerado uma correspondência ao procurar o texto definido pelo campo Texto para o valor especificado no campo Valor. As opções são Contém ou Equivale. Contém significa que haverá uma correspondência se o valor for localizado em qualquer lugar no texto. Nesse caso, a procura não faz distinção entre maiúsculas e minúsculas. Equivale significa que haverá uma correspondência apenas se o texto for igual ao valor. Nesse caso, a procura faz distinção entre maiúsculas e minúsculas.
Valor
Define o valor a ser procurado no texto definido pelo campo Texto. Vários valores podem ser especificados utilizando o símbolo de barra vertical (|), por exemplo, Sair|Desistir|Abandonar.
Imagem
Define a imagem a ser utilizada se uma correspondência for localizada. Selecione uma imagem na lista drop-down ou utilize o botão Importar para importar uma imagem.
Visualizar
Exibe uma visualização da imagem selecionada.

Utilize os botões Editar, Remover, Para Cima e Para Baixo para definir ainda mais seus mapeamentos de imagem.

Nota:
A substituição de texto é executada antes da determinação do widget Barra de Ferramentas sobre qual imagem será utilizada. Os mapeamentos definidos devem assumir que a substituição de texto pode ter alterado o token inicial, a descrição ou ambos para o item.
defaultImage
Use essa configuração para especificar uma imagem padrão para ser usada quando nenhuma imagem estiver mapeada para uma tecla de função específica ou item de lista de seleção.
Nota:
Essa configuração não aparece na GUI como uma definição configurável. Ela deve ser configurada na origem das configurações do widget Barra de Ferramentas. Por exemplo, se você deseja usar a imagem details.gif como o padrão na pasta Rich Client Content/Images em seu projeto, siga um dos seguinte procedimentos:

Para especificar o padrão no nível do projeto, na visualização Projetos do HATS, dê um clique duplo no arquivo Configurações do Projeto na pasta do projeto para ativar o editor para o arquivo application.hap. Na guia Origem, localize a classe, name="com.ibm.hats.rcp.transform.widgets.SwtToolbarWidget", na tag <classSettings> e altere a configuração de defaultImage para <setting name="defaultImage" value="images/details.gif"/> .

Para configurar a imagem padrão para um controle ComponentRendering em uma transformação, atualize a cadeia defaultImage transmitida para o método setWidgetSettings do objeto ComponentRendering. Por exemplo, altere defaultImage: para defaultImage:images/details.gif.

Para usar uma imagem contida em outro plug-in, especifique o caminho completo para a imagem dentro desse plug-in. Por exemplo, altere defaultImage: para defaultImage:org.eclipse.ui/icons/full/obj16/delete_obj.gif.

Mapeamento de Componente e Widget

Os widgets fornecidos no HATS Toolkit para uso na exibição de componentes host em uma GUI são mapeados para esses componentes. A tabela a seguir lista os HATS componentes do host existentes e seus widgets correspondentes.

Tabela 2. HATS componentes do host e seus widgets correspondentes
Componente do Host Widget
Linha de Comandos
Combo  Apenas RCP 
Drop-down (entrada de dados)
Lista
Pop-up
Botão de opções (entrada de dados)
Entrada de Texto
Campo
Campo
Tecla de Função
Botão
Tabela de botões
Drop-down (seleção)
Link
Botão de opções (seleção)
Barra de ferramentas   Apenas RCP 
Palavra-chave HTML DDS
Rótulo
Campo de entrada
Calendário  Apenas Web 
Caixa de opções
Combo  Apenas RCP 
Drop-down (entrada de dados)
Lista
Pop-up
Botão de opções (entrada de dados)
Entrada de Texto
Campo de Entrada com Sugestões
Combo  Apenas RCP 
Drop-down (entrada de dados)
Lista
Pop-up
Botão de Opções (Entrada de Dados)
Seleção de Item
Caixa de opções
Combo  Apenas RCP 
Drop-down (entrada de dados)
Link (seleção de item)
Lista
Pop-up
Botão de opções (seleção de item)
Entrada de Texto
Caneta de Luz (Atenção)
Botão
Link
Botão de Opções (Seleção)
Caneta de Luz (Seleção)
Caixa de opções
Campo da Barra de Rolagem (ENPTUI)
Barra de Rolagem (ENPTUI)
Campo de Seleção (ENPTUI)
Botão
Caixa de opções
Link
Botão de Opções (Seleção)
Lista de Seleção
Botão
Tabela de botões
Drop-down (seleção)
Link
Botão de opções (seleção)
Barra de Ferramentas Apenas RCP 
Subarquivo
Subarquivo (caixa de opções)
Subarquivo (drop-down)
Subarquivo (Pop-up)
Tabela
Gráfico (barra horizontal)
Gráfico (linha)
Gráfico (barra vertical)
Tabela
Tabela (Campo)
Gráfico (barra horizontal)
Gráfico (linha)
Gráfico (barra vertical)
Tabela
Tabela (Visual)
Gráfico (barra horizontal)
Gráfico (linha)
Gráfico (barra vertical)
Tabela
Texto
Rótulo
URL
Link