Suporte de Aplicativo Bidirecional

Este capítulo explica como utilizar as funções fornecidas pelo HATS para desenvolver aplicativos em idiomas bidirecionais. Geralmente seu conteúdo se aplica aos desenvolvedores de aplicativos do hebraico e árabe. As funções que são específicas aos usuários árabes estão descritas separadamente.

O HATS fornece essas funções para suportar idiomas bidirecionais:

Este capítulo explica todos esses recursos.

Nota:
Não há suporte bidirecional para Objetos de Integração do portlet padrão, substituições da variável global, comunicação de portlet, Serviços da Web para Portlets Remotos e componentes de host de Caneta de luz (atenção) e Caneta de luz (seleção).

Ambiente do Software

A seguir há requisitos para suporte a aplicativos bidirecionais:

Trabalhando com Terminal Host

O terminal host do HATS permite pressionamentos de teclas bidirecionais específicos do Host On Demand, portanto, você pode executar as seguintes funções bidirecionais. As seguintes teclas de funções host estão disponíveis para as sessões 3270, 5250 e VT:

Ctrl+L: Camada do Latim
Esta combinação de teclas altera a camada de idioma para Latim e a área de informações do operador (OIA) é atualizada para mostrar o Idioma inglês.
Ctrl+N: Camada Bidirecional
Esta combinação altera a camada do idioma para bidirecional e a OIA é atualizada para mostrar o idioma bidirecional.
Ctrl+S: Tela Reversa
Se a orientação da tela for da esquerda para a direita, esta combinação de teclas altera a imagem da tela para a orientação da direita para a esquerda e a camada do idioma é alterada para bidirecional. Se a orientação da tela for da direita para a esquerda, essa combinação de teclas inverte a imagem da tela para a orientação da esquerda para a direita e o idioma muda para Latim. Isso não fica disponível nas sessões visuais VT.
Ctrl+F: Campo Reverso
Se a orientação do campo for da esquerda para a direita, essa combinação de teclas alterará a orientação do campo para a orientação da direita para a esquerda, o cursor se moverá para o outro lado do campo e a camada do idioma se transformará em bidirecional. Se a orientação do campo for da direita para a esquerda, essa combinação de teclas alterará a orientação do campo para a orientação da esquerda para a direita, o cursor moverá para o outro lado do campo e a camada do idioma se transformará em Latim. Isso será apenas para sessões 5250.

As seguintes teclas de função host estão disponíveis apenas para sessões 3270:

Ctrl+P: Push
Você pode inserir e editar texto na direção oposta da existente no campo.
Ctrl+O: Encerrar Push
O modo Push é encerrado e o cursor se move para o final do segmento push.
Ctrl+A: Auto Push
É possível digitar texto misto da esquerda para a direita e da direita para a esquerda, alterando a camada do idioma.

A seguir a tecla de função host está disponível apenas para sessões 5250:

Ctrl+C: Fechar
Os dados inseridos em uma direção da combinação de teclas (seja da esquerda para a direita como da direita para a esquerda) são concatenados com os dados que foram inseridos anteriormente na direção oposta. A direção do cursor é definida para que seja a mesma da direção do campo e a camada de idioma é definida para o padrão para a direção do campo. Se a orientação da tela for atualmente da esquerda para a direita, o cursor será posicionado no primeiro nulo a direita do texto concatenado. Se a orientação da tela for atualmente da direita para esquerda, o cursor será posicionado no primeiro nulo a esquerda do texto concatenado.

As seguintes teclas de função host estão disponíveis apenas para sessões Arabic VT:

Ctrl+K: Título da Coluna
O modo de título da coluna faz com que brancos entre as colunas de texto quebrem inserções permitindo que títulos em inglês para colunas de dados mantenham sua posição correta.

As seguintes teclas de função host estão disponíveis apenas para sessões Hebrew VT:

Ctrl+D: Direção do Cursor
Se a direção atual do cursor é esquerda-para-direita, pressionar Ctrl+D altera a direção para da direita para a esquerda e depois volta. Esta função é permitida somente para tipo de texto visual. Quando a direção do cursor é definida da direita para a esquerda, isto não afeta o movimento e endereçamento do cursor, inserção ou exclusão de caracteres, remoção em linha ou em tela. As seguintes funções são afetadas pelas definições da direção do curso da direita para a esquerda:
Ctrl+D : Modos do Conjunto de Caracteres
Esta função alterna entre os conjuntos de caracteres de 7 bits e de 8 bits. Se o conjunto de caracteres atual é hebraico DEC (8-bit) ou hebraico ISO Adicional (8-bit), pressionando-se Ctrl+B, altera o conjunto de caracteres atual para hebraico NRCS (7-bit). Se o conjunto de caracteres é hebraico NRCS (7-bit), pressionando-se Ctrl+B carrega um dos dois conjuntos de caracteres de 8-bit, baseado na seguinte regra:

Limitações do Terminal Host

Não existe suporte para campos Unicode no Terminal Host; portanto, não é possível comutar idiomas em campos Unicode.

Texto complexo, contendo texto bidirecional e números, não deve ser utilizado como critérios de reconhecimento de tela.

Capturando Telas

Nas sessões bidirecionais, as telas podem ser capturadas como telas da esquerda para a direita e como teclas da direita para a esquerda. As telas capturadas são exibidas exatamente como foram capturadas. Para capturar uma tela da direita para a esquerda, pressione Ctrl+S (Tela Reversa) em uma tela da esquerda para a direita e clique em Criar Captura de Tela.

Reconhecendo Componentes Host Bidirecionais

Geralmente, a orientação de um componente host é a mesma da orientação da tela. No entanto, em alguns casos, a orientação de um componente host é o oposto da orientação geral da tela. Quando um projeto do HATS utiliza uma página de código bidirecional, uma caixa de opções rotulada como Reconhecer componente orientado oposto à tela é incluída no assistente para Inserir Componente Host e no assistente para Criar uma Combinação de Tela. Ao incluir um componente host em uma transformação, selecione essa caixa se a orientação do componente host for a oposta à orientação da tela. Selecionar a caixa permite que o HATS reconheça prompts de comandos, teclas de função, listas de seleção, subarquivo e campos de entrada com sugestões, cuja orientação é oposta à orientação da tela.

O texto bidirecional misto pode ser utilizado nas configurações de teclas de função e lista de seleção. Isso significa que cadeias como: BIDI1 = BIDI2, em que BIDI1 e BIDI2 são segmentos do texto bidirecional, podem ser reconhecidas como teclas de função e listas de seleção.

Por padrão, apenas componentes da esquerda para a direita podem ser reconhecidos na renderização padrão de telas (como em uma sessão em inglês). Entretanto, a seleção da propriedade Reconhecer componente orientado oposto à tela no editor Configurações do Projeto, na guia Renderização, na seção Renderização Padrão ativará o reconhecimento dos componentes da esquerda para a direita e da direita para a esquerda na renderização padrão.

Além disso, por padrão, os componentes em uma transformação de tela são reconhecidos apenas de acordo com a orientação de tela. No nível do projeto, você pode especificar que se um componente não for reconhecido, o HATS deverá tentar reconhecê-lo utilizando a orientação de tela oposta. Para fazer essa especificação, no Editor de Projetos, na guia Renderização na seção Avançado em Renderização Padrão, selecione a caixa de opção Reconhecer componente orientado em oposição à tela. Se esta seleção foi feita e o componente ainda não é reconhecido, a renderização seguirá as especificações feitas com a configuração, Usar renderização padrão na falha de renderização do componente.

Também é possível especificar esta configuração no nível de componente. Para fazê-lo, ao incluir um componente para uma transformação usando o assistente para Inserir Componente de Host, no painel Opções de Renderização, clique no botão Configurações Avançadas para Renderização e selecione a caixa Reconhecer componente orientado em oposição à tela. O valor dessa configuração no nível de componente não é herdado da configuração do projeto. A tabela abaixo mostra as possíveis combinações dessa configuração nos níveis do projeto e de componente e qual configuração é usada. Para obter mais informações gerais, consulte Renderização Avançada.

Tabela 16. Combinações de Configuração de Projeto e Componente
Configuração do Projeto Configuração de Componente Configuração usada
removida removida componente
removida selecionada componente
selecionada removida projeto
selecionada selecionada componente

Controlando a Orientação dos Widgets

Existem duas caixas de opções especiais que fornecem controle sobre a apresentação do widget quando seu aplicativo é executado no WebSphere Application Server. Esse controle aplica-se a:

Essas duas caixas de opções são:

Em uma tela da esquerda para a direita, quando a caixa de opções Orientação Reversa do Widget for selecionada, a imagem da GUI será alterada para que seja da direita para a esquerda. Da mesma forma, quando a caixa de opções Texto Reverso no Widget for selecionada, o texto dentro da imagem da GUI será alterado da direita para a esquerda.

Por exemplo, suponha que você tenha a tela da esquerda para a direita que contém o seguinte texto (as letras maiúsculas são dados bidirecionais e as letras minúsculas continuam sendo dados em inglês):

BIDI TEXT

pf01=help

Quando você customiza essa tela como RTL, ela é exibida como:

TXET IDIB

pleh=10fp

Do ponto de vista do usuário, tudo está correto, exceto a tecla de função. A tecla de função é reconhecida, mas é exibida com atraso.

Para que a tela customizada apareça corretamente, você deve selecionar as caixas de opções Orientação Reversa do Widget e Texto Reverso no Widget ao inserir o componente host da tecla de função em uma tela customizada.

Quando você faz isso, a tela é exibida como:

TXET IDIB

pf01=help

Quando você substitui um campo de entrada de texto por uma lista suspensa em um projeto bidirecional, as legendas dos itens da lista suspensa não são afetadas pela orientação da tela. As legendas sempre aparecerão no formato LTR visual, a menos que você selecione a caixa de opções Texto Reverso no Widget para o widget. Nesse caso, as legendas aparecerão no formato RTL visual.

Além disso, ao criar aplicativos HATS bidirecionais e copiar e colar várias linhas do texto a partir de um campo protegido em um campo de entrada visual, o texto pode ser invertido. Se você copiar e colar uma linha de cada vez, a orientação será preservada.

Controlando o Alinhamento de Widgets

Para designar o alinhamento adequado de widgets contendo de elementos do componente do HATS, uma configuração do Alinhamento de Componente está disponível nos painéis de configuração do HATS a seguir:

Além disso, para designar o alinhamento adequado de widgets individuais, as configurações Alinhamento de Campo e Alinhamento de Tabela estão disponíveis no diálogo de configurações de widget do assistente Opções de Renderização para os widgets Campo e Tabela.

Os valores dessas configurações são esquerda e direita. A configuração Alinhamento de Componente nas configurações de projeto afeta o alinhamento de todos os widgets no projeto. O conjunto de valores nas configurações de projeto se torna o padrão para os assistentes Criar uma Transformação e Criar uma Customização de Tela. O alinhamento especificado para um widget individual sobrepõe o valor especificado para a renderização padrão.

Suporte Bidirecional a Componentes e Widgets Personalizados

As contrapartes bidirecionais devem ser utilizadas durante a customização de novos componentes e widgets, por exemplo em projetos da Web:

import com.ibm.hats.transform.widgets.BIDI.LabelWidgetBIDI

public class newBIDILabel extends LabelWidgetBIDI implements HTMLRenderer

Variáveis Globais

Quando as variáveis globais forem extraídas, os dados extraídos serão exatamente os dados que aparecem na tela, incluindo a orientação da tela atual. Todas as variáveis globais inseridas em uma tela como uma ação de um evento de tela são inseridas de acordo com a orientação da tela.

Em aplicativos da Web e rich client, os dados bidirecionais do texto estático e campos de entrada são armazenados em variáveis globais no formato visual, nos ambientes do Rational SDP e de ambiente de tempo de execução.

Ao usar o assistente para Inserir Variável Global para inserir um valor de variável global como texto estático em uma transformação para uma tela bidirecional, você tem a opção de Inserir Variável Global no Formato Visual. Selecione esta opção para inserir o valor da variável global como texto estático no formato visual. Limpe esta opção para inserir o valor como texto estático no formato lógico.

Quando as variáveis globais são extraídas das sessões de VT lógicas, os dados extraídos são convertidos para formatos visuais. Quaisquer variáveis globais inseridas sobre sessões lógicas de VT são convertidas para o formato lógico. A direção do texto é configurada de acordo com a orientação da tela.

Substituição de Texto

Ao utilizar a substituição de texto em sessões bidirecionais em um nível de projeto ou em um nível de tag de componente do HATS, existem três caixas de opções adicionais que podem ser utilizadas:

Corresponder à Tela LTR
Esta opção permite que a substituição do texto seja executada corretamente para o texto na tela de exibição da esquerda para a direita.
Corresponder à Tela RTL
Esta opção permite que a substituição do texto seja executada corretamente para o texto na tela de exibição da direita para a esquerda.
Corresponder à Tela Reversa
Se você selecionar essa caixa e a caixa de opções Corresponder à Tela LTR, a cadeia reversa corresponderia a uma tela da direita para a esquerda. Quando o botão Tela Reversa for clicado em uma tela da esquerda para a direita, os dados serão consistentes.

Se você selecionar essa caixa e a caixa de opções Corresponder às Telas RTL, a cadeia reversa corresponderia a uma tela da esquerda para a direita. Quando o botão Tela Reversa é clicado em uma tela da direita para a esquerda, os dados são consistentes.

Você deve selecionar Corresponder à Tela LTR ou Corresponder às Telas RTL.

Por exemplo, suponha que uma tela host da esquerda para a direita contenha o texto: NO on. Se você definir a substituição do texto para substituir no por yes e ignorar as maiúsculas e minúsculas, os resultados dependerão das caixas que você selecionou, da seguinte maneira:

Tabela 17. Opções e Resultados de Substituição de Texto Bidirecional
Opções Selecionadas Tela LTR Tela RTL
Corresponder apenas à tela LTR yes on no ON
Corresponder apenas à tela RTL NO on yes ON
Corresponder à tela LTR e à tela RTL yes on yes ON
Corresponder à tela LTR e à tela reversa yes on no sey
Corresponder à tela RTL e à tela reversa NO sey yes ON
Corresponder à tela LTR e RTL e à tela reversa yes sey yes sey

Regras Globais

Ao utilizar regras globais no nível do projeto ou no nível da tela em sessões bidirecionais, existem três caixas de opções adicionais que podem ser utilizadas (semelhante à substituição de texto):

Corresponder às Telas LTR
Esta opção permite que a regra global configurada seja executada corretamente para texto em uma tela com exibição da esquerda para a direita.
Corresponder às Telas RTL
Esta opção permite que a regra global configurada seja executada corretamente para texto em uma tela com exibição da direita para a esquerda.
Corresponder à Tela Reversa
Se você selecionar essa caixa e a caixa de opções Corresponder à Tela LTR, a cadeia reversa corresponderia em uma tela da direita para a esquerda. Quando o botão Tela Reversa é clicado em uma tela da esquerda para a direita, os dados são consistentes.

Se você selecionar essa caixa e a caixa de opções Corresponder às Telas RTL, a cadeia reversa corresponderia em uma tela da esquerda para a direita. Quando o botão Tela Reversa é clicado em uma tela da direita para a esquerda, os dados são consistentes.

Para obter informações adicionais, consulte Tabela 17.

Ativando o Usuário para Reverter a Direção da Tela

Nas configurações do teclado numérico do aplicativo, você pode fornecer um botão Tela Reversa nas transformações bidirecionais para a conveniência de seus usuários. O botão aparece no teclado numérico dos aplicativos (para aplicativos da Web) e na barra de ferramentas da visualização Transformação (para aplicativos rich client). Clicar no botão comuta a orientação da tela -- a operação executada em sistemas host, pressionando as teclas Alt+Enter.

No nível do projeto, você pode incluir o botão Tela Reversa na seção do teclado numérico do Aplicativo da guia Renderização no editor do Projeto. No nível da transformação, você pode incluir o botão Tela Reversa utilizando as funções Inserir Teclado Numérico do Aplicativo no editor de transformação.

Ao criar um novo projeto do HATS e selecionar uma página de códigos bidirecional, aparecem duas caixas de opções adicionais no painel Configuração da Conexão: Ativar tela reversa para telas não-customizadas e Ativar tela reversa para telas customizadas. Essas caixas de opções determinam se o botão Tela Reversa que você fornece aparece nessas telas. Por padrão, ambas as caixas estão selecionadas. Se você selecionar a primeira caixa, a segunda será ativada. Não há outra forma de selecionar apenas a segunda caixa.

Uma tela não-customizada é a que não foi correspondida por nenhuma customização de tela. Uma tela não-customizada, quando visualizada pelo usuário, possui a mesma orientação de tela da anterior. Se a primeira tela for não-customizada, sua orientação de tela será da esquerda para a direita. Se a orientação da tela tiver sido alterada em uma tela anterior, ela será herdada pela próxima tela não-customizada e reconfigurada pela próxima tela customizada.

O orientação inicial de telas personalizadas é a mesma da existente quando as telas foram personalizadas. Para telas customizadas e não-customizadas, clicar no botão Tela Reversa altera a orientação da tela. Durante o reconhecimento da tela, uma tela reversa é considerada diferente da mesma tela antes de ser revertida. Portanto, o botão Tela Reversa poderia fazer com que uma tela não fosse reconhecida. Se o desenvolvedor estiver confiante de que todos os componentes de host que aparecem em uma tela customizada possuem a orientação correta, não há necessidade de ativar o botão Tela Reversa para essa tela. É aconselhável desativar o botão Tela Reversa para as telas customizadas.

Ativar o botão Tela Reversa para o usuário de um aplicativo árabe ativará outra caixa de opções para controlar a orientação da forma. Para obter informações adicionais, consulte: Funções para Páginas de Código Árabes

Opções de Exibição Bidirecional de VT

Para sessões bidirecionais VT, algumas propriedades bidirecionais específicas precisam ser definidas para que o terminal funcione corretamente para os usuários bidirecionais. Um botão VT Opções de Exibição BIDI que aparece no painel Configurações de Conexão é incluído para acessar essas opções:

Tipo de Texto (Hebraico)
Determina o formato dos caracteres do texto armazenado. Selecione Visual ou Lógico. O padrão é Visual.
Direção do Cursor (Visual Hebraico)
Define a direção do cursor LTR (Esquerda para a Direita) ou RTL (Direita para a Esquerda). Quando a direção do cursor é definida como RTL (Direita para a Esquerda), todos os caracteres são exibidos na direção RTL (Direita para a Esquerda), pois por padrão, o cursor se move para a esquerda depois da exibição de cada caractere. Geralmente, apenas os aplicativos projetados para receber entrada na direção RTL (Direita para a Esquerda) funcionam corretamente, quando a Direção do Cursor é definida como RTL (Direita para a Esquerda). O padrão é LTR.
Ordenação Inteligente (Lógica Árabe/Hebraica)
Determina se os segmentos de caracteres com diferentes atributos de texto são ordenados separadamente. O padrão é Off.
Mostrar Atributos de Texto (Lógica Árabe/Hebraica)
Ativado apenas quando a opção Ordenação Inteligente está Ativada. O padrão é Yes.

Orientação de Ação de Prompt

Para sessões lógicas bidirecionais VT, existem dois botões de opções (Direção LTR ou Direção RTL) que fornecem ao desenvolvedor de aplicativos controle sobre a orientação de controle de entrada (LTR implícita ou RTL implícita) para ação de prompt durante a gravação de uma macro.

A orientação do controle de entrada padrão é a direção LTR que implica que o valor do prompt está no formato LTR implícito.

Opções Bidirecionais de Consulta SQL de Macro

No assistente SQL para idiomas bidirecionais (árabe e hebraico), é necessário definir propriedades bidirecionais específicas. É possível acessar estas definições clicando no botão Avançado no painel do editor Macro Avançada. Este painel ficará visível apenas se sua estação de trabalho estiver configurada para um idioma bidirecional. Estão disponíveis as seguintes definições:

Tipo de Arquivo do Host
Essa opção especifica se o arquivo do Host deve ser salvo em formato lógico ou visual. O padrão é Visual. (Esta opção não está ativada para o driver JDBC a partir do AS/400 Toolbox para Java™).
Tipo de Arquivo Local
Esta opção especifica se os arquivos locais estão em formato Lógico ou Visual. O padrão é Lógico.
Orientação de Arquivo do Host
Especifica se o Arquivo do host deve ser salvo em formato da esquerda para a direita ou da direita para a esquerda. O padrão é da Esquerda para a Direita. (Esta opção não está ativada para o driver JDBC a partir do AS/400 Toolbox para Java.)
Orientação de Arquivo Local
Especifica se os arquivos locais estão em formato da esquerda para a direita ou da direita para a esquerda. O padrão é da Esquerda para a Direita.
Expansão Lam-Alef
Especifica o comportamento dos caracteres Lam-Alef. Ao receber dados árabes do host por meio da instrução do Assistente SQL, o caractere Lam-Alef é expandido em dois caracteres, Lam seguido por Alef se houver espaço após o caractere Lam-Alef.
Compactação de Lam-Alef
Especifica o comportamento dos caracteres Lam-Alef. Ao enviar dados árabes para o host por meio da instrução do assistente SQL, os caracteres Lam seguidos por Alef são compactados em um caractere e é incluído um espaço após o caractere Lam-Alef. Esta opção está ativada apenas para sistemas árabes. O padrão é ativado. (Esta opção não está ativada para o driver JDBC a partir do AS/400 Toolbox para Java.).
Troca Simétrica
Especifica o comportamento de caracteres simétricos como colchetes; a inversão da tela causa a substituição de caracteres direcionais por suas contrapartes. O padrão é ativado. (Esta opção não está ativada para o driver JDBC a partir do AS/400 Toolbox para Java).
Permuta
Controla como o texto bidirecional combinado com numerais é processado.
Formato de Numerais
Especifica o formato do numeral no Arquivo host na instrução do assistente SQL; o formato do numeral pode ser (NOMINAL, NACIONAL e CONTEXTUAL). Esta opção está ativada apenas para sistemas árabes. O padrão é NOMINAL. (Esta opção não está ativada para o driver JDBC a partir do AS/400 Toolbox para Java).

Suporte de Impressão da Direita para a Esquerda

Os arquivos bidirecionais podem ser arquivos RTL ou LTR e para imprimir os dados de RTL corretos, você deve selecionar a caixa de opção Ativar Impressão de RTL que aparece na guia Impressão do Editor de Conexão para a conexão bidirecional 3270E padrão. Os arquivos PDF e não-PDF são suportados.

Essa caixa de opções será ativada se a impressão estiver ativada.

No caso de aplicativos em árabe, ativar a impressão RTL ativará as duas caixas de opções a seguir.

Suporte a Mapas do BMS

O suporte bidirecional para mapas do BMS incluem:

  1. Páginas de códigos bidirecionais: Ao importar conjuntos de mapas do BMS para projetos bidirecionais, as seguintes páginas de códigos devem ser utilizadas:
  2. Atributos bidirecionais: Ao importar um conjunto de mapas do BMS em um projeto bidirecional, um botão Opções de BIDI é fornecido. Clique neste botão para configurar os seguintes atributos BIDI:

Suporte ao Objeto de Integração

O suporte ao Objeto de Integração inclui a extensão do bean do Objeto de Integração com propriedades bidirecionais específicas que permitem coisas como a reordenação do texto extraído. Para obter informações adicionais, consulte o capítulo Using the HATS bidirectional API em HATS Web Application Programmer's Guide.

O suporte para páginas da Web do Objeto de Integração (Modelo 1 e JSF) inclui a reordenação correta de dados extraídos/inseridos no tempo de execução e controle total pelo desenvolvedor de aplicativos sobre a orientação dos controles de tela e extração/inserção utilizando uma GUI de alto nível.

O suporte inclui os seguintes recursos:

A extração a partir da tela do host pode causar quatro situações comuns:

Área Alinhada à Esquerda na Tela LTR Que Está Sendo Extraída
Obtida quando a extração é feita em uma tela LTR, o botão de opções de orientação de tela e os botões de opções de orientação de controle são LTR (padrão)
Área Alinhada à Direita na Tela LTR Que Está Sendo Extraída
Obtida quando a extração é feita em uma tela RTL, o botão de opções de orientação de tela e os botões de opções de orientação de controle são RTL
Área Alinhada à Direita na Tela RTL Que Está Sendo Extraída
Obtida quando a extração é feita em uma tela LTR, o botão de opções de orientação de tela é LTR e o botão de opções de orientação de controle é RTL
Tela RTL da Área Alinhada à Esquerda Que Está Sendo Extraída
Obtida quando a extração é feita em uma tela RTL, o botão de opções de orientação de tela é RTL e o botão de opções de orientação de controle é LTR
Nota:
O alinhamento de texto bidirecional em tabelas poderá não ser renderizado corretamente ao trabalhar com páginas da Web JSF. Esta é uma limitação do design de JSF.

Suporte de Serviços da Web Bottom-up

Além de suportar páginas da Web do Modelo 1 e JSF geradas a partir de Objetos de Integração, o HATS fornece suporte bidirecional para serviços da Web bottom-up gerados a partir de Objetos de Integração. Neste caso, o serviço da Web herda toda a funcionalidade bidirecional do Objeto de Integração. O serviço da Web é estendido por propriedades que permitem coisas como a reordenação do texto extraído. Para obter informações adicionais, consulte o capítulo Using the HATS bidirectional API em HATS Web Application Programmer's Guide. Estas propriedades podem ser testadas utilizando ferramentas como páginas JSP de amostra e o explorador de serviços da Web.

Como as páginas JSP de amostra geradas pelo HATS Toolkit são aplicativos LTR Lógicos, elas exibem os resultados do serviço da Web adequadamente somente se você configurar para chamar a reordenação de prompt e extração e configurar a reordenação de RTL em ambos os casos para False. Caso contrário, o resultado será exibido incorretamente. Entretanto, você pode desejar ver o resultado "incorreto" para verificar como as alterações dos valores das propriedades afetam o serviço da Web.

Se você precisar ver os resultados corretos para a reordenação de extração diferente de LTR lógico com páginas JSP de amostra, poderá precisar editar manualmente o arquivo Result.jsp gerado pelo HATS Toolkit. Após a linha com a tag <body>, insira a linha, <div dir=rtl> para RTL Lógico, <bdo dir=ltr> para LTR Visual ou <bdo dir=rtl> para RTL Visual.

A utilização do explorador de serviços da Web para casos de reordenação diferentes de LTR Lógico não é recomendada.

Você pode desejar predefinir valores de propriedades bidirecionais específicas e controlar a possibilidade de substituir estes valores pelo usuário. Para configurar estes valores, clique em Opções de BIDI quando os arquivos de suporte de serviço forem gerados a partir dos Objetos de Integração. Se Permitir que o usuário substitua os valores for selecionado, os valores predefinidos serão notificados se cadeias vazias ou nulas forem configuradas como parâmetros para as propriedades correspondidas.

Informações para Usuários

Os aplicativos HATS que utilizam páginas de código bidirecionais oferecem um campo de entrada especial denominado campo de entrada visual. Ao contrário de campos comuns, que implementam a entrada de dados lógicos e a apresentação, o campo visual implementa entrada de dados visuais e a apresentação. Ao inserir os dados em um campo visual, você pode utilizar estas funções:

Alt+Shift: Seleção de Idioma
Essa combinação de teclas comuta a camada de idioma entre o idioma Latim e o idioma bidirecional.
Alt+Enter: Tela Reversa
Essa combinação de teclas inverte a direção da tela.
Shift+NumLock: Push
Você pode inserir e editar o texto cuja direção seja oposta à direção do campo.
Shift+caractere NumPad "/": Encerrar Push
O modo Push é encerrado e o cursor se move para o final do segmento push.
Alt+caractere NumPad "/": Auto Push
É possível digitar texto misto da esquerda para a direita e da direita para a esquerda, alterando a camada do idioma. O Autopush é especialmente útil para inserir dígitos da direita para a esquerda. As funções push e encerrar push são automaticamente ativadas de acordo com o idioma do texto que está sendo digitado. Em campos da direita para a esquerda, a inserção de um dígito ou uma letra em latim provoca a iniciação automática de push, sem uma alteração de idioma. Letras ou dígitos adicionais em Latim darão continuidade ao modo push; qualquer outro caractere encerrará automaticamente o modo push. Esse recurso permite que você digite texto bidirecional com números incorporados ou palavras latinas sem utilizar push e finalizar push.

Em campos da esquerda para a direita, digitar um caractere bidirecional causa a iniciação automática de push. Inserir qualquer dígito ou caractere latino acarretará o encerramento automático do modo. Isso permite que o usuário digite o texto latino com palavras bidirecionais incorporadas, utilizando a seleção da camada do idioma em vez de push e finalizar push.

Você pode inicialmente ativar ou desativar o modo push automático utilizando a configuração Ativar modo Push Automático inicialmente. Essa configuração está disponível em dois locais dentro do editor do projeto. Na guia Visão Geral, clique no link para o tema atual e utilize a configuração Ativar modo Push Automático inicialmente. Na guia Outro selecione a seção Configurações do Cliente e utilize a configuração Ativar modo Push Automático inicialmente.

Nota:
Ao usar o push automático em uma página da Web JSF que faz interface com um objeto de integração, você pode precisar alterar o tamanho do campo manualmente se necessário para inserir mais caracteres do que o tamanho do campo de entrada do navegador padrão permite.

Campo Reverso Automático

Alt+NumPad 5
Quando o Campo Reverso Automático estiver ativado todos os campos, com exceção dos campos de senha, terão o mesmo comportamento (descrito acima). Nas telas da direita para a esquerda das sessões 3270, o campo reverso automático é o modo padrão da operação.

Campo Reverso

Alt+Numlock
Quando campo reverso estiver ativado, a orientação da digitação no campo atual (em foco) será alterada. Se o campo estiver vazio, o cursor será ajustado para o lado oposto do campo. Quando o campo não estiver vazio, a posição do cursor não será alterada. O campo reverso fica ativo apenas no campo atual. Quando o foco for perdido, a orientação da digitação retornará ao seu valor anterior.

Funções da Área de Transferência

As operações da área de transferência (tais como copiar, colar e recortar) com dados bidirecionais a partir dos editores lógicos da plataforma no campo visual do HATS e de campos visuais do HATS (incluindo o texto estático) nos editores lógicos da plataforma são ativadas nas plataformas Windows®. Os usuários que trabalham no Windows podem utilizar a área de transferência para trocar dados entre o HATS e outros aplicativos que utilizam dados lógicos.

As operações da área de transferência do Internet Explorer são suportadas a partir da opção Editar na barra de menus ou com a ajuda de atalhos (Ctrl+C, Ctrl+X, Ctrl+V).

O suporte a dados bidirecionais da área de transferência em navegadores Mozilla em plataformas Windows será ativado apenas se estas funções forem chamadas utilizando os atalhos.

OIA (Operator Information Area)

Além das informações relacionadas à sessão que estão sendo exibidas na OIA (Operation Information Area), as sessões bidirecionais incluem informações sobre direção de tela e de digitação, camada ativa, status do modo de campo reverso automático e status de formato (em sessões árabes).

As informações relacionadas à sessão bidirecional (teclado) são apresentadas em um formato semelhante ao utilizado no sistema host. Para exibir essas informações na OIA de uma transformação do HATS, no editor de Configurações do Projeto na guia Renderização, selecione Operator Information Area e, em seguida, selecione a caixa de opções Mostrar OIA. Quando a caixa de opções Mostrar OIA no editor de Configurações do Projeto é limpa, a área de status bidirecional do HATS é exibida na barra de status para aplicativos da Web, mas não é exibida em nenhum outro lugar para aplicativos rich client.

Comutação de Camada de Teclado Automático

Para projetos da Web do HATS, com essa função, é possível simular a comutação da camada do teclado entre os idiomas bidirecional e latim automaticamente quando a tela é revertida. A simulação é realizada através do uso do remapeamento de teclado. Isso força a inserção de caracteres Árabes/Hebraicos ou Latinos em conformidade com a direção de digitação do campo. Por exemplo, em uma tela revertida, quando a digitação do texto ocorre da direta para a esquerda, os caracteres Árabes/Hebraicos são inseridos independente do estado da camada do teclado atual. Para ativar essa função, no editor Configurações do Projeto, em Visão Geral, clique no tema atual e selecione Ativar Comutação Automática de Camada do Teclado. Essa configuração também pode ser selecionada no editor Configurações do Projeto na guia Outro na seção Configurações do Cliente.

Os projetos rich client do HATS sempre se comportam como se essa função estivesse ativada.

Nota:
Os campos de senha e outros campos especiais que não são baseados no campo de entrada visual, funcionam de acordo com a configuração do teclado do sistema, ou seja, o remapeamento do teclado não é realizado para esses tipos de campos.

Suporte Unicode para IBM i 5250

O texto bidirecional que aparecer em campos Unicode que usam sistemas 5250 é exibido e editado usando o esquema de classificação contextual (de acordo com o primeiro caractere restrito) ao invés de usar o campo de entrada visual.

Funções para Páginas de Código Árabes

Essas funções são específicas para projetos que utilizam as páginas de código árabes.

Direção de Formato

Se você ativar o botão Tela Reversa nas configurações do teclado numérico do aplicativo, o botão Formato RTL também será exibido para projetos da página de códigos em árabe. Clicar no botão Formato RTL ativa ou desativa o estado do formato RTL. Desativar o formato RTL informa o HATS que o usuário está editando um arquivo LTR independente da orientação de tela. Ativar o formato RTL informa ao HATS que o usuário está atualmente editando um arquivo RTL independente da orientação de tela, portanto, os mesmos dados em formato árabe podem ser enviados corretamente nas duas orientações de tela. Você deve se assegurar antes de editar e enviar um arquivo LTR que o formato RTL esteja desativado e deve se assegurar que o formato RTL esteja ativado antes de editar e enviar um arquivo RTL.

Forma Seletiva Arábica

Em alguns casos você pode precisar enviar os seus dados para o host em formato isolado. Para atender a tais requisitos uma propriedade de formato de desativação de campo foi incluída para as sessões árabes através de duas caixas de opções:

Troca Simétrica e Numérica

Estas opções são efetivas apenas nas sessões 3270 árabes. Se a troca simétrica estiver ativada, os caracteres de troca serão trocados nas telas da direita para a esquerda. Se a troca numérica estiver ativada, os numerais em inglês serão substituídos pelos numerais em árabe nas telas da direta para a esquerda e os numerais em árabe serão substituídos pelos numerais em inglês em telas da direita para a esquerda. Estes parâmetros são configurados na guia Avançado do editor de conexão na seção Definir configurações de conexão opcionais avançadas. Os parâmetros são identificados como symmetricSwapEnabled e numericSwapEnabled e os valores dos parâmetros são true ou false.

O terminal host do HATS também é afetado pelos parâmetros de troca simétricos e numéricos.

Desativar Entrada de Dígitos Árabe-Ocidental

Ao criar um novo projeto do HATS, ou quando você cria ou edita uma conexão do HATS e seleciona a página de códigos 420 Árabe Falado, a configuração, Desativar Entrada de Dígitos Árabe-Ocidental em Telas RTL, é exibida. Selecione esta opção para desativar a entrada de números Árabe-Ocidental, ou seja, permita a entrada apenas de números Árabe-Índico em telas RTL. Faça isso de forma que, ao enviar, todos os números sejam enviados como números Árabe-Ocidental.

Comutação de Camada de Teclado Automático

O teclado em árabe possui dois layouts, layout de teclado 101 e layout de teclado 102, ligeiramente diferente em algumas teclas. Ao usar a função de comutação automática da camada do teclado, os seguintes mapeamentos são desempenhados:

Limitações do Terminal Host

As seguintes limitações aparecem com ambos os layouts de teclado do sistema, teclado 101 em inglês e árabe:

Essas limitações desaparecem com o teclado em árabe 102.

Quando utilizar um teclado árabe 102, aparecerão as seguintes limitações do teclado:

Para exibir corretamente qualquer um destes caracteres, será necessário comutar a camada do teclado para inglês.

Capturas de Tela

Para uma sessão árabe com telas capturadas da direita para a esquerda, os colchetes e numerais são afetados pelas opções de troca simétrica e numérica do aplicativo.

Nota:
Em sessões árabes, o sinal do euro é exibido como um bloco em uma tela capturada.

Configurando Sessões de Impressão em Árabe no System i Access for Web

A seguir há um resumo das configurações para apresentar dados em árabe corretamente no System i Access para Web.

Para configurações Globais:

Relatórios SCS:

Relatórios AFP:

Outras Considerações

Adições nos Arquivos HATS

Quando um projeto utiliza uma página de código árabe, os arquivos do evento (.evnt) de tela possuem uma tag adicional <orientation>true</orientation> dentro da tag de descrição. Um valor true indica que a tela foi personalizada como uma tela da direita para a esquerda; caso contrário é personalizada da esquerda para a direita.

Quando um projeto utiliza qualquer página de códigos bidirecional, o arquivo de conexão (.hco) possui um atributo enableScrRev adicional para a tag <hodconnection> que pode ter os seguintes valores:

(em branco)
O botão Tela Reversa não é colocado em nenhuma tela.
NotCustomized
O botão Tela Reversa é colocado apenas em telas que não correspondem a uma customização de tela.
Customized
O botão Tela Reversa é colocado em todas as telas.

Quando um projeto utiliza qualquer página de códigos árabe, o arquivo de conexão (.hco) possui um atributo disableFldShp adicional da tag <hodconnection> que pode ter valores true ou false

Se a impressão estiver selecionada na sessão 3270, uma configuração printRTLSupport adicional aparecerá na tag <classSetttings>. Para sessões 3270 árabes, aparecerão outras duas definições para troca simétrica e numérica que serão printSymSwapSuppot e printNumSwapSupport. Todas essas definições de impressão possuem valores true ou false equivalentes a ativar ou desativar o recurso.

Quando um projeto utilizar qualquer página de códigos bidirecional, o arquivo do aplicativo (.hap) possuirá atributos adicionais para a tag <replace> dentro da tag <textReplacement>:

matchLTR
Texto a ser substituído quando a orientação da tela for da esquerda para a direita.
matchRTL
Texto a ser substituído quando a orientação da tela for da direita para a esquerda.
matchReverse
Texto a ser substituído quando a orientação da tela for reversa.