Suporte a Idiomas

A interface com o usuário do HATS e a ajuda contextual são fornecidas nesses idiomas:

Todos os idiomas são instalados em uma única imagem de produto. O suporte ao idioma nacional é dependente do sistema operacional, portanto, o suporte ao teclado e fonte apropriada para o idioma que você deseja utilizar deve estar instalado no sistema operacional. Por exemplo, se você deseja utilizar francês como o idioma da sessão do host, mas não possui a fonte francesa e o suporte ao teclado instalados, pode ser que não consiga exibir os caracteres corretos.

Códigos de Idioma

Códigos de idioma são utilizados em diferentes partes do produto para determinar qual idioma apresentar ao usuário. Consulte Tabela 11 para obter o idioma e o código do idioma.

Tabela 11. códigos de idioma do HATS
Idioma Código do Idioma
Inglês pt-BR
Tcheco cs
Alemão de
Espanhol es
Francês fr
Húngaro hu
Italiano it
Japonês ja
Coreano ko
Polonês pl
Português (Brasil) pt_BR
Russo ru
Turco tr
Chinês (Simplificado) zh
Chinês (Tradicional) zh_TW

Páginas de Códigos

O HATS suporta as seguintes páginas de códigos. Você pode selecionar a página de códigos para cada projeto do HATS ao criar o projeto e modificá-la posteriormente no editor do projeto.

Tabela 12. Páginas de Códigos
Página de Códigos Local ou Uso
037
Bélgica
Brasil
Canadá
Holanda
Portugal
Estados Unidos
273
Áustria
Alemanha
274
Bélgica (Antiga)
275
Brasil (Antigo)
277
Dinamarca
Noruega
278
Finlândia
Suécia
280
Itália
284
Espanha
América Latina(Espanhol)
285
Reino Unido
297
França
420
Língua Árabe
424
Hebraico (Código novo)
500
Multilíngüe
803
Hebraico (Código antigo)
838
Tai
870
Bósnia/Herzegovina
Croácia
República Tcheca
Hungria
Polônia
Romênia
Eslováquia
Eslovênia
871
Islândia
875
Grécia
924
Euro ISO Multilíngüe
930
Japonês (Katakana)
Japão (Katakana Estendido)
933
Coréia
937
Taiwan (Chinês Tradicional)
Nota: Para suporte a caracteres acentuados, consulte
Utilizando caracteres acentuados para a página de códigos 937.

939
Japonês (Latim Estendido)
1025
Belarus
Bulgária
Macedônia FYR
Rússia
Sérvia/Montenegro (Cirílico)
1026
Turquia
1047
Edição Aberta
1112
Letônia
Lituânia
1122
Estônia
1123
Ucrânia
1137
Hindu
1140
Bélgica Euro
Brasil Euro
Canadá Euro
Holanda Euro
Portugal Euro
Estados Unidos Euro
1141
Áustria Euro
Alemanha Euro
1142
Dinamarca Euro
Noruega Euro
1143
Finlândia Euro
Suécia Euro
1144
Itália Euro
1145
América Latina Euro (Espanhol)
Espanha Euro
1146
Reino Unido Euro
1147
França Euro
1148
Euro Multilíngüe
1149
Islândia Euro
1153
Bósnia/Herzegovina Euro
Croácia Euro
República Tcheca Euro
Hungria Euro
Polônia Euro
Romênia Euro
Eslováquia Euro
Eslovênia Euro
1154
Belarus Euro
Bulgária Euro
Macedônia FYR Euro
Rússia Euro
Sérvia/Montenegro (Cirílico) Euro
1155
Turquia Euro
1156
Letônia Euro
Lituânia Euro
1157
Estônia Euro
1158
Ucrânia Euro
1160
Tailândia Euro
1166
Euro Casaquistão
1364
Coréia Euro
1371
Taiwan (Chinês Tradicional) Euro
1388
PRC (Chinês simplificado estendido; GB18030)
1390
Japonês (Katakana Unicode estendido)
1399
Japonês (Latin Unicode estendido)

Configurações de Codificação

O conjunto de caracteres utilizado nas JSPs HATS, tais como transformações e modelos HATS, devem corresponder à codificação configurada no navegador do usuário, assim como à codificação especificada no servidor de aplicativos. Aplicativos HATS criam JSPs em todos os códigos de idioma utilizando o conjunto de caracteres UTF-8.

O WebSphere Application Server possui configurações de codificação padrão diferentes para diferentes códigos de idioma. Alguns caracteres de byte duplo e entradas de dados de idiomas bidirecionais podem ser decodificados incorretamente se a configuração de codificação para tal código do idioma não for UTF-8. Você deve configurar o servidor de aplicativos nos quais os aplicativos HATS executam para utilizar a mesma codificação utilizada na JSP em seu aplicativo HATS. Para configurar UTF-8, siga estas etapas:

  1. Abra o console administrativo do WebSphere Application Server. Se estiver utilizando o ambiente de teste local no Rational SDP, na visualização Servidores, clique duas vezes no servidor e selecione Administração > Executar console administrativo.
  2. Efetue login no console administrativo, abra a árvore Servidores no painel de navegação esquerdo e selecione Servidores de Aplicativos.
  3. Selecione o nome de servidor a ser modificado.
  4. No painel direito, abra a árvore Gerenciamento de Java™ e Processos, selecione Definição de Processo e, no painel que é aberto em seguida, selecione Java Virtual Machine.
  5. Na seção Argumento de JVM Genéricos , digite -Dclient.encoding.override=UTF-8.
  6. Clique no botão OK.
  7. Selecione os links Salvar nos blocos de Mensagem.
  8. Efetue logoff e reinicie o WebSphere Application Server.

Suporte ao 5250 Unicode

O parâmetro Ativar Fluxo de Dados de Unicode permite configurar um parâmetro de conexão comum para hosts 5250. O parâmetro unicodeDataStreamEnabled é um parâmetro na guia Avançado do Editor de Conexão. Para incluir o parâmetro, vá para Configurar Configurações de Conexões Opcionais, Avançadas e clique no botão Incluir. Selecione o parâmetro unicodeDataStreamEnabled no menu suspenso Nome e digite o Valor. Clique em OK.

Utilizando caracteres acentuados para a página de códigos 937

Se você utiliza a página de códigos 937 para Chinês Tradicional para uma conexão 5250 e deseja suportar o uso de caracteres acentuados, você deve incluir o parâmetro avançado de configurações de conexão, useAccentedCharacters, e definir seu valor para true na guia Avançado do editor de conexão. Consulte Avançado para saber como incluir parâmetros de sessão Host On-Demand. Além disso, como o CCSID 937 não suporta caracteres acentuados, para utilizar esse suporte é necessário garantir que o CCSID seja 65535 no host. Esse recurso é suportado apenas para conexões 5250.

Mapeamento de código de host para páginas de códigos 1390 e 1399

Havia inconsistências de mapeamento de código host-para-PC entre os produtos IBM® Personal Communications e Host On-Demand em um número de pontos de código DBCS quando a página de códigos 1390 ou 1399 para japonês era utilizada. No Host On-Demand, o parâmetro UseHodCDRA1399 controla o remapeamento Unicode para corrigir as inconsistências. A tabela a seguir resume o mapeamento para as configurações true e false do parâmetro UseHodCDRA1399 :

Tabela 13. Resumo do mapeamento Unicode
EBCDIC
code
point
Ponto de código Unicode
(UseHodCDRA1399=true)
Ponto de código Unicode
(UseHodCDRA1399=false)
0x4260 U+FF0D (hífen-menos largo) U+2212 (Sinal de menos)
0xE9F3 U+2212 (Sinal de menos) U+FF0D (hífen-menos largo)
0x43A1 U+FF5E (Til Largo) U+301C (Traço Ondulado)
0xE9F4 U+301C (Traço Ondulado) U+FF5E (Til Largo)
0x447C U+2225 (Em Paralelo) U+2016 (Linha Vertical Dupla)
0xDFE5 U+2016 (Linha Vertical Dupla) U+2225 (Em Paralelo)
0x444A U+2015 (Barra Horizontal) U+2014 (Travessão)
0xDDB7 U+2014 (Travessão) U+2015 (Barra Horizontal)
0x426A U+FFE4 (Barra Irregular de Largura Completa) U+00A6 (Barra Irregular)
0xE9F5 U+00A6 (Barra Irregular) U+FFE4 (Barra Irregular de Largura Completa)

O HATS utiliza o parâmetro UseHodCDRA1399 Host On-Demand para a mesma finalidade. O padrão do HATS para o parâmetro UseHodCDRA1399 é false. Para configurar o parâmetro para true, edite a conexão em seu projeto HATS e desempenhe as seguintes etapas:

  1. Clique na guia Avançado.
  2. Clique em Adicionar.
  3. A partir da lista suspensa de nomes de parâmetros, selecione UseHodCDRA1399.
  4. Configure o valor do parâmetro para true.
  5. Clique em OK.

Suporte JIS2004

JIS2004, que é um conjunto de caracteres codificado padrão nacional japonês, inclui três tipos de novos caracteres:

  1. Novos caracteres normais que não estavam disponíveis antes do suporte JIS2004.
  2. Caracteres substitutos, que são dois pontos de código Unicode vinculados que representam um caractere único. Os dois pontos de código Unicode não têm sentido se estiverem separados.
  3. Caracteres de combinação que são dois pontos de código Unicode combinados como um caractere. Os dois pontos de código Unicode individuais que se combinam para formar um caractere de combinação também podem ser exibidos separadamente.

Considerações e Limitações do Suporte JIS2004

Ao utilizar o JIS2004 em seus aplicativos, considere os itens a seguir:

  1. O JIS2004 é o suporte de fontes japonesas padrão com Windows® Vista SP1. Se desejar continuar a utilizar o JIS90 no sistema operacional Vista, é possível instalar o Microsoft® service pack KB927490, que pode ser transferido por download e aplicado através do Windows Update como software adicional.
  2. Para exibir caracteres JIS2004 no Windows XP, é necessário instalar a correção KB927489 da Microsoft. Mesmo quando a correção estiver instalada, você não conseguirá inserir alguns caracteres JIS2004, tais como os caracteres substitutos, já que o IME não é suportado.
  3. A configuração da fonte padrão no HATS não exibe caracteres JIS2004 corretamente sem algumas alterações nas configurações da fonte.

    Para aplicativos da Web do HATS, ative a configuração de estilo em cada widget do HATS, tais como o Widget de Campo, para incluir as fontes a seguir:

    Para aplicativos rich client do HATS, defina a configuração da fonte em cada widget do HATS com a fonte MS Mincho.

  4. Ao utilizar o Internet Explorer V7 e posterior, novos caracteres JIS2004 podem ser suportados corretamente ao configurar as fontes, conforme descrito no item anterior.
  5. Ao utilizar o Internet Explorer V6 ou ao utilizar a função de visualização no HATS Toolkit em execução no Windows XP, alguns novos caracteres JIS2004 não são exibidos corretamente.
  6. Suporte ao caractere substituto:
    1. O WebSphere Portal Server 6.1.0.1 é necessário para suportar caracteres substitutos JIS2004 nos portlets do HATS.
    2. No terminal do HATS, ao inserir caracteres JIS2004 utilizando o IME, a janela do candidato exibe caracteres substitutos como quadrados pretos. Entretanto, quando os caracteres são enviados para o HATS, o terminal do HATS exibe os caracteres substitutos corretamente.
    3. Os caracteres substitutos JIS2004 não são suportados para tabelas customizadas Host On-Demand.
  7. Suporte ao caractere de combinação:
    1. Aplicativos Windows, tais como Notepad e Firefox Versão 3 manipulam corretamente os caracteres de combinação JIS2004 como um caractere. Entretanto, ao executar aplicativos rich client do HATS tempo de execução ou executar aplicativos da Web do HATS no Internet Explorer, o caractere de combinação é manipulado como dois caracteres separados ao invés de um caractere nos campos de entrada. O cursor pode ser posicionado entre os dois caracteres de combinação.
    2. Ao executar aplicativos da Web do HATS no tempo de execução no Internet Explorer, se você inserir caracteres de combinação no campo de entrada e a configuração Mostrar Caracteres Shift Out/Shift In não Protegidos como Espaços na seção DBCS da guia Renderização estiver ativada, os caracteres de combinação se tornarão quadrados brancos. É possível corrigir os quadrados brancos desativando a configuração ou utilizando o navegador Firefox.
    3. A função de impressão de PDF do HATS não pode exibir caracteres combinados corretamente.

Suporte JIS2004 para Impressão PDT e Imprimir em Arquivo para Sessões 3270E

Para imprimir caracteres JIS2004:

A tabela a seguir mostra os resultados da especificação de valores diferentes para o parâmetro de sessão KANJI_CODE com arquivos pdfpdt diferentes ao imprimir dados com caracteres JIS2004 em um arquivo de saída (Imprimir em Arquivo):

Tabela 14. Resumo do parâmetro de sessão KANJI_CODE
Parâmetro de sessão no arquivo pdfpdt Modo de texto ASCII (basic_dbcs.pdf) Outras impressoras suportadas (esc_*.pdf, ibm*.pdf, lips*.pdf, etc.)
KANJI_CODE=SHIFT_JIS Não aplicável já que os pares substitutos não podem ser armazenados em um arquivo de PC nativo. A saída é salva em um arquivo de PC nativo e as imagens de fonte (dados binários) para caracteres JIS2004 e caracteres UDA são armazenadas neste arquivo.
KANJI_CODE=UNICODE A saída é salva em um arquivo Unicode; pares substitutos e caracteres UDA são armazenados no UCS-2. Não aplicável já que uma impressora de PC não aceita dados Unicode.

Além disso, também é possível configurar os parâmetros de sessão printerMimeType e printSaveAsExtension apropriadamente ao imprimir em um arquivo:

Tabela 15. Resumo do Parâmetro de Sessão Imprimir em Arquivo
Definição Parâmetro de sessão no arquivo pdfpdt Parâmetro de sessão printerMimeType no HATS Parâmetro de sessão printSaveAsExtension no HATS Resultados
Configuração para impressão adicional KANJI_CODE=SHIFT_JIS application/octet-stream .bin Um arquivo de PC nativo com dados binários.
Configuração para o modo de texto ASCII KANJI_CODE=UNICODE texto/plano .txt Um arquivo UCS-2.

Para obter mais informações, consulte Definindo o Suporte para Impressão para Seu Projeto e Imprimindo.

Remapeando os caracteres do teclado e da tela

O suporte do HATS para as tabelas customizadas do Host On-Demand permite a você remapear os caracteres do teclado e da tela do usuário, customizando as tabelas de conversão de página de códigos host para PC. Um arquivo de tabela customizada pode conter qualquer número de tabelas em qualquer combinação de tabelas de teclado e tela. Tabelas de teclado remapeiam os caracteres de teclado do usuário como entrada customizada para aplicativo do host. Tabelas de tela remapeiam os caracteres de exibição do host para saída customizada da tela para o usuário.

Nota:
Este remapeamento não tem relação com o mapeamento de teclado do HATS. Este remapeamento lida com remapeamento de caracteres, por exemplo, a, b e c. Ao passo que o mapeamento de teclado do HATS lida com mapeamento de teclas de controle, por exemplo, Clear, Enter e F1. Para obter mais informações sobre o mapeamento de teclado do HATS, consulte Ativando o Suporte do Teclado.

Um arquivo de tabela customizada de amostra, CustomTableExample.txt, é localizado no diretório <RationalSDP_install_directory>\hats\customtables. O formato de arquivo é parecido com os arquivos de propriedades Java. Linhas que iniciam com # são comentários e as variáveis mostradas como n e N são valores hexadecimais. O exemplo a seguir mostra o formato do arquivo de tabela customizada de amostra.

##### Start of file
# Map SBCS Local nn to SBCS EBCDIC NN in keyboard table
sbcs.keyboard.0xnn=0xNN
# Map DBCS Unicode nnnn to DBCS EBCDIC NNNN in keyboard table
dbcs.keyboard.0xnnnn=0xNNNN
...
# Map SBCS EBCDIC NN to SBCS local nn in display table
sbcs.display.0xNN=0xnn
# Map DBCS EBCDIC NNNN to DBCS Unicode nnnn in display table
dbcs.display.0xNNNN=0xnnnn
...
##### End of file

Para ativar o uso de tabelas customizadas em seu projeto:

  1. Crie uma tabela customizada utilizando a amostra como um exemplo e copie-a para uma pasta denominada, customtables, na raiz do projeto .ear de aplicativo da Web HATS ou na raiz do projeto HATS rich client Runtime Extension de seu projeto HATS rich client. Se a pasta customtables não existir, crie uma.
  2. Abra seu projeto HATS.
  3. Edite a conexão clicando duas vezes no nome no diretório de Conexões.
  4. Clique na guia Avançado.
  5. Clique em Adicionar.
  6. No diálogo Incluir Parâmetro, selecione CustomTable a partir da lista suspensa Nome e insira o nome de seu arquivo de tabela customizada no campo Valor.
  7. Clique em OK para sair do diálogo Incluir Parâmetro.
  8. Salve suas alterações nas configurações de conexão.

Prioridade de Substituição de Caracteres

Há diversas maneiras de substituir caracteres no HATS. A substituição de caracteres por estas funções ocorre na seguinte ordem:

  1. Suporte de tabela customizada
  2. Parâmetro UseHodCDRA1399 apenas para DBCS
  3. User Defined Characters (UDCs) apenas para DBCS
  4. Substituição de Texto

Por exemplo, se você utilizar o suporte de tabela customizada para alterar um caractere de exibição e a substituição de texto estiver definida para alterar o mesmo caractere, tal caractere não existirá quando a substituição de texto ocorrer.