Este capítulo explica as funções e as considerações exclusivas ao desenvolvimento de aplicativos do HATS que fornecem suporte ao DBCS (Conjunto de Caracteres de Byte Duplo).
Além das informações gerais, o HATS fornece as seguintes funções específicas para suporte ao DBCS:
Este capítulo explica essas funções específicas e considerações especiais ao utilizar funções gerais do HATS para suportar o DBCS.
O HATS suporta os seguintes tipos de campos DBCS e SBCS.
| Tipo de Campo | Conteúdo de Campo Permitido | Plataforma |
|---|---|---|
| DBCS misto | Caracteres SBCS e DBCS com caracteres SO/SI (Shift Out/Shift In) | 3270 |
| Apenas no DBCS (G) | Caracteres DBCS sem SO/SI | 3270 |
| Apenas alfanumérico | Todos os caracteres SBCS mas não os caracteres DBCS | 3270 |
| Apenas numérico | Apenas dígitos de 0 a 9, vírgula (,), ponto (.), sinal de mais (+), sinal de menos (-) e espaço ( ) | 3270 |
| DBCS aberto (O) | Caracteres SBCS e DBCS sem SO/SI | 5250 |
| DBCS gráfico (G) | Caracteres DBCS gráficos sem SO/SI | 5250 |
| Apenas no DBCS (J) | Caracteres DBCS com SO/SI | 5250 |
| DBCS ou (E) | DBCS com SO/SI ou caracteres SBCS | 5250 |
| Apenas alfabético (X) | Apenas caracteres de A a Z, vírgula (,), ponto (.), hífen (-) e espaço ( ) | 5250 |
| Deslocamento alfanumérico (A) | Todos os caracteres SBCS mas não os caracteres DBCS | 5250 |
| Deslocamento numérico (N) | Todos os caracteres SBCS mas não os caracteres DBCS | 5250 |
| Numérico assinado (S) | Apenas dígitos de 0 a 9 | 5250 |
| Apenas numérico (Y) | Apenas dígitos de 0 a 9, vírgula (,), ponto (.), sinal de mais (+), sinal de menos (-) e espaço ( ) | 5250 |
| Campo Katakana (W) | Todos os caracteres SBCS mas não os caracteres DBCS | 5250 |
| Inibir entrada do teclado (I) | Nenhuma entrada do teclado, exceto de dispositivos especiais, por exemplo, uma caneta de luz | 5250 |
| Apenas dígitos (D) | Apenas dígitos de 0 a 9 | 5250 |
| Apenas caractere numérico (M) | Apenas dígitos de 0 a 9, vírgula (,), ponto (.), sinal de mais (+), sinal de menos (-) e espaço ( ) | 5250 |
Cada tipo de campo DBCS deve conter apenas o tipo permitido de dados. Por exemplo, o campo DBCS gráfico (G) deve conter apenas caracteres DBCS gráficos sem os caracteres SO/SI. O HATS executa a verificação de tipo de dados para assegurar que apenas tipos de dados permitidos possam ser digitados nos campos de DBCS.
Em um campo em uma tela do host, os caracteres DBCS têm comprimento dois. Em um campo em uma página da GUI, os caracteres DBCS têm comprimento um. Essa função do HATS verifica o comprimento de caracteres DBCS que estão sendo digitados em um campo da GUI e não permite mais caracteres do que serão ajustados no campo do host correspondente.
Essa função do HATS previne que um usuário copie e, então, cole dados com um tipo de dados incorreto em um campo. Se dados mistos forem colados, todos os caracteres depois do primeiro caractere inválido serão cortados. Por exemplo, se o usuário tentar colar abc&cde em um campo e & for um caractere inválido para o tipo de campo, apenas abc será colado.
O IME (Input Method Editor) é um FEP (Front-End-Processor) que manipula entrada do teclado e gera cadeias DBCS. Normalmente, o IME é um componente do sistema operacional, mas ele pode ser um produto único ou uma parte de outro aplicativo, como um processador de texto.
Os usuários do DBCS podem gerar milhares de caracteres diferentes utilizando um teclado de tamanho regular. Normalmente, o usuário digita uma seqüência de caracteres e, em seguida, utiliza o IME para converter a seqüência em caracteres de byte duplo. A conversão pode precisar ser tentada novamente porque poderá haver várias traduções possíveis, ou candidatos, para a mesma seqüência de caracteres. Enquanto esse processo de conversão está em andamento, o texto pertence logicamente ao IME. Depois do processo de conversão, o usuário então utiliza o IME para consolidar os caracteres de byte duplo convertidos para o aplicativo. O HATS suporta o uso do IME para consolidar caracteres de byte duplo em campos do HATS.
Se o usuário tentar digitar caracteres no IME que excedam o comprimento máximo do campo do HATS renderizado, então o comportamento difere dependendo das configurações Eliminar comprimento máximo em campos DBCS e Eliminar comprimento máximo em campos SBCS. Para obter informações adicionais sobre a configuração Eliminar comprimento máximo em campos DBCS, consulte Eliminar comprimento máximo em campos DBCS. Para obter informações adicionais sobre a configuração Eliminar comprimento máximo em campos SBCS, consulte Eliminar Comprimento Máximo em SBCS.
As telas do host podem freqüentemente conter campos DBCS e SBCS. O HATS ativará automaticamente o IME quando o cursor estiver localizado em um campo DBCS e desativará o IME quando o cursor estiver localizado em um campo SBCS.
Para os campos DBCS misto, DBCS aberto (O), apenas DBCS (J) e DBCS ou (E), se a configuração Mostrar caracteres Shift Out/Shift desprotegidos como espaços na seção DBCS da guia Renderização estiver selecionada, os caracteres SO/SI serão exibidos como espaços na GUI. Se não estiver selecionada, os caracteres SO/SI não serão exibidos na GUI.
Para configurar esta propriedade para conexões utilizadas para Objetos de Integração do HATS, utilize o parâmetro de sessão Host On-Demand omitSOSI. Este parâmetro pode ter um valor true ou false. Se for true, o Objeto de Integração do HATS omite os caracteres SO/SI para a conexão. Se false (o padrão), o Objeto de Integração do HATS substitui o caractere SO/SI por um espaço, como é o caso normalmente. Para obter informações sobre como incluir a propriedade omitSOSI para sua conexão do Objeto de Integração, consulte Configurar definições de conexão opcionais e avançadas.
Esta seção explica outras considerações para entender quando utilizar as funções gerais do HATS para desenvolver aplicativos que suportem o DBCS.
As seguintes configurações estão disponíveis no editor de configurações do projeto para projetos DBCS. Consulte Modificando um Projeto do HATS para obter outras configurações do projeto.
Na guia Renderização, você pode configurar as seguintes opções de DBCS para seu projeto se sua conexão padrão especificar uma página de códigos DBCS.
Se não for selecionada, então os caracteres que excederem o comprimento máximo do campo DBCS não poderão ser digitados no IME.
Se selecionada, então
Esta configuração é suportada para os seguintes tipos de campo:
Na seção Configurações do Cliente da guia Outro, considere as seguintes configurações para projetos DBCS.
Para aplicativos da Web do HATS, o recurso de avanço automático depende da contagem atual de caracteres e do comprimento do campo para decidir o tempo de avanço. Quando a configuração Mostrar caracteres Shift Out/Shift In desprotegidos como espaços na seção DBCS da guia Renderização não estiver selecionada, a contagem de caracteres nunca atingirá o limite de campo se um caractere DBCS estiver no campo. Portanto, para aplicativos da Web do HATS, se você precisar da função de avanço automático no ambiente DBCS, deverá selecionar a configuração Mostrar caracteres Shift Out/Shift In desprotegidos como espaços.
Ao utilizar o IME para inserir dados em um campo, duas tabelas no arquivo KBS.js são utilizados para definir teclas que acionam o avanço automático. Um conjunto de teclas de acionamento padrão é fornecido. Se necessário, é possível editar as tabelas no arquivo KBS.js para alterar os padrões. Para editar o arquivo KBS.js, na visualização Navegador clique duas vezes no arquivo, que está localizado na pasta project_name\Web Content\common. O exemplo a seguir mostra as teclas padrão definidas nas duas tabelas. Por exemplo, a combinação de teclas ALT + SBCS/DBCS (código de tecla 25) é uma tecla de acionamento padrão. Para incluir uma tecla, insira seu código de teclas (seja seu nome de variável definido no arquivo KBS.js ou seu valor numérico) e um modificador de teclas (ALT, CTRL ou Shift), conforme apropriado. Para determinar como o valor do código de tecla para uma determinada tecla no teclado, consulte Determinando Valores do Código-Chave.
var IMEkeysForKeyUp = [ //-Keycode----ALT-CTRL-Shift----// [ CODE_ENTER, 0, 0, 0 ], [ CODE_M, 0, 1, 0 ], [ CODE_ENTER, 0, 1, 0 ] ]; var IMEkeysForKeyDown = [ //-Keycode----ALT-CTRL-Shift----// [ 25, 1, 0, 0 ] //ALT + SBCS/DBCS key ];
O recurso do modo (inicial) Sobrescrever não é suportado para entrada de DBCS.
Se esta configuração for selecionada, quando um usuário projetar um campo J 5250, todo o texto no campo será selecionado quando o campo receber foco. Se o usuário em seguida inserir caracteres DBCS e utilizar a função de Saída do Campo para sair do campo, o último caractere da cadeia poderá ser excluído.
Para evitar este comportamento, limpe a caixa Selecionar todo texto no foco e selecione a caixa Mostrar caracteres Shift Out/Shift In desprotegidos como espaços. Neste caso, o cursor é posicionado corretamente na primeira posição de entrada do campo. O usuário pode começar a digitar nesta posição e, em seguida, utilizar a função de Saída do Campo para sair do campo.
Você não deve selecionar critérios de reconhecimento de tela que contêm metade de um caractere de byte duplo (DBCS). Qualquer caractere DBCS selecionado deve ser totalmente incluído na região da seleção. Consulte Critérios de Reconhecimento de Tela ou Tela de Início para saber mais.
A seguinte configuração está disponível para o componente da lista de seleção para projetos DBCS. Consulte Lista de Seleção para obter outras configurações de componente da lista de seleção.
A seguir há uma consideração ao utilizar a configuração Quebras de Coluna do componente Subarquivo. Consulte Subarquivo para obter outras configurações do componente Subarquivo.
A seguir há uma consideração ao utilizar a configuração Quebras de Coluna do componente Tabela. Consulte Tabela para obter outras configurações do componente Tabela.
Se não for selecionada, então os caracteres que excederem o comprimento máximo do campo SBCS não poderão ser digitados no IME.
Se selecionada, então
Esta configuração é suportada para os seguintes widgets:
Esta configuração é suportada para os seguintes tipos de campo:
A seguir há considerações ao utilizar o suporte à macro em projetos DBCS.
Ao gravar uma macro, você pode utilizar a Ação Incluir Extração para extrair informações da tela do host. Consulte informações adicionais sobre a Ação Incluir Extração Incluir Ação Extrair. Considere o seguinte caso ao extrair caracteres DBCS.
Ao extrair uma região da tela do host em uma tabela, você pode modificar o formato da tabela. Umas das modificações que podem ser feitas é dividir uma coluna da tabela em duas colunas. Ao clicar em Dividir, o HATS divide a coluna selecionada. Se a coluna contiver caracteres de byte duplo (DBCS), a divisão poderá dividir um caractere DBCS em duas colunas. Nesse caso, o caractere DBCS não aparecerá em nenhuma coluna. Se você vir isso acontecer ao editar uma ação de extração, utilize os botões Direita e Esquerda para acertar as colunas. O caractere DBCS dividido reaparecerá quando estiver contido em uma coluna única.
Se você exportar uma macro contendo caracteres DBCS para uma macro do Host Publisher/HOD e, em seguida, importá-la para o Host On Demand, os caracteres DBCS poderão ficar ilegíveis. Para evitar este problema, você pode abrir a macro exportada com um editor que suporte a codificação UTF-8, como o Bloco de Notas, salvar a macro utilizando a codificação nativa e, em seguida, importar a macro para o Host On-Demand.
A seguir há uma consideração ao criar um Objeto de Integração em um projeto DBCS. Para obter informações adicionais, consulte Criando um Objeto de Integração.
Ao nomear uma macro utilizada para criar um Objeto de Integração, os caracteres de byte duplo (largura completa) não são permitidos.
No Internet Explorer Mobile, as alterações nos campos de entrada para recursos suportados pelo DBCS são feitas quando o campo de entrada perde o foco, ou seja, quando um evento de desfoque ocorre. Isso é diferente do suporte nos navegadores de desktop em que as alterações são feitas em tempo real usando o evento-chave.
Para verificação do tipo de dados, todos os caracteres começando com o primeiro caractere ilegal são retirados do campo de entrada quando o campo de entrada perde o foco, ou seja, quando o evento de desfoque ocorre.
Para obter informações adicionais, consulte Desenvolvendo Aplicativos do HATS para Dispositivos Remotos.
Para renderizar corretamente caracteres DBCS nos aplicativos rich client do HATS em execução nas plataformas Windows 2000 em japonês, certifique-se de fazer download e instalar os pacotes de idioma do Eclipse 3.2.1 a partir da página de downloads do Eclipse em http://download.eclipse.org/eclipse/downloads/. Na seção Pacotes de Idioma, clique em 3.2.1_Language_Packs. Na seção Pacotes de Idioma SDK, clique, faça download e instale o NLPack1 para a plataforma que você está utilizando.
É possível utilizar o suporte do HATS para tabelas customizadas do Host On-Demand para remapear os caracteres do teclado e da tela do usuário ao customizar as tabelas de conversão de códigos. Para obter mais informações, consulte Remapeando os caracteres do teclado e da tela.
O idioma DBCS consiste em caracteres ideográficos ao invés de alfabetos fonéticos. Milhares de caracteres ideográficos são usados nesses idiomas e as páginas de códigos ou fontes atualmente definidas nem sempre atendem aos requisitos desses caracteres. UDCs (caracteres definidos pelo usuário) são usados para oferecer suporte aos caracteres necessários que não estão definidos nas páginas de códigos ou fontes. Usando o editor de mapeamento de UDC, é possível atribuir um ponto de código local a partir da UDA (User-Defined Area) para um ponto de código de host especificado reservado para esse caractere.
As funções de UDC do HATS suporta os tipos de conexão 3270, 3270E e 5250. Você utiliza o suporte de mapeamento de UDC do HATS para exibir UDCs para as conexões 3270, 3270E e 5250 e utiliza o suporte de imagem de fonte do HATS para imprimir UDCs no modo PDF ou PDT para conexões 3270E.
Para ativar o suporte de exibição de UDC para conexões 3270, 3270E e 5250, siga estas etapas:
| Página de Códigos | Local ou Uso |
|---|---|
| 930 | Japonês (Katakana) |
| 930 | Japão (Katakana estendido) |
| 933 | Coréia (Estendido) |
| 937 | Taiwan (Chinês Tradicional Estendido) |
| 939 | Japonês (Latim estendido) |
| 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) |
Ao clicar em Concluir no assistente de UDC, o HATS copia os arquivos de UDC relacionados para o projeto do HATS apropriado e atualiza as configurações de conexão avançada UDC_SETTING e UDC_TABLE_SELECTION em seu projeto.
Para ativar o suporte de impressão para conexões 3270E, siga estas etapas:
| Plataforma | Nome do Arquivo de Imagem da Fonte |
|---|---|
| Windows em japonês | jpn24.fnt |
| Windows em coreano | kor24.fnt |
| Windows em chinês simplificado | chs24.fnt |
| Windows em chinês tradicional | cht24.fnt |
Ao clicar em Concluir, o HATS copia os arquivos de UDC relacionados para o projeto do HATS apropriado.
Para imprimir UDCs no modo Adobe® PDF, defina estas configurações na guia Impressão do editor de configurações de conexão:
| Nome | Valor |
|---|---|
| printDestination | falso |
| printMimeType | aplicativo/pdf |
| printSaveAsExtension | |
| separateFiles | verdadeiro |
| useAdobePDF | verdadeiro |
| usePDT | falso |
| useWindowsPrinter | falso |
Para imprimir UDCs no modo PDT, configure estas definições na guia Impressão do editor de configurações de conexão:
| Nome | Valor |
|---|---|
| PDTFile | O caminho para o PDTfile, por exemplo, MyPDT/PDTFileName.hodpdt. Consulte abaixo a tabela de nomes de arquivos PDT a utilizar dependendo de sua página de códigos e impressoras PDT suportadas. |
| printDestination | falso |
| printMimeType | application/octet-stream |
| printSaveAsExtension | .out |
| separateFiles | verdadeiro |
| useAdobePDF | falso |
| usePDT | verdadeiro |
| useWindowsPrinter | falso |
| Página de Códigos | Impressoras PDT Suportadas | Nome do Arquivo PDT |
|---|---|---|
|
930 Japonês (Katakana) 930 Japão (Katakana estendido) 939 Japonês (Latim estendido) 1390 Japonês (Katakana Unicode estendido) 1399 Japonês (Latim Unicode estendido) |
Modo de Texto ASCII | /pdfpdt/basic_dbcs.hodpdt |
| Impressoras Baseadas em ESC/P 24-J84 | /pdfpdt/esc_p.hodpdt | |
| IBM® 5577-B02,F02,G02,H02 | /pdfpdt/ibm5577.hodpdt | |
| Impressora IBM 5585-H01 | /pdfpdt/ibm5585.hodpdt | |
| IBM 5587-G01,H01 (sem função avançada) | /pdfpdt/ibm5587.hodpdt | |
| Impressora Lips3a4 | /pdfpdt/lips3a4.hodpdt | |
| Impressora Lips3b4 | /pdfpdt/lips3b4.hodpdt | |
|
933 Coréia (Estendido) 1364 Coréia Euro |
Impressora IBM 5577 Coreia | /pdfpdt/ibm5577k.hodpdt |
| Impressora Ks_jo | /pdfpdt/ks_jo.hodpdt | |
| Impressora Ks_wan | /pdfpdt/ks_wan.hodpdt | |
| Impressora Kssm_jo | /pdfpdt/kssm_jo.hodpdt | |
| Impressora Kssm_wan | /pdfpdt/kssm_wan.hodpdt | |
|
937 Taiwan (Chinês Tradicional Estendido) 1371 Taiwan (Chinês Tradicional) Euro |
Impressora Chinês Tradicional ESC/P (5550) | /pdfpdt/esc_5550.hodpdt |
| Impressora Chinês Tradicional ESC/P (big-5) | /pdfpdt/esc_big5.hodpdt | |
| Impressora Chinês Tradicional ESC/P (cns) | /pdfpdt/esc_cns.hodpdt | |
| Impressora Chinês Tradicional ESC/P (tca) | /pdfpdt/esc_tca.hodpdt | |
| Impressora IBM 5577 chinês tradicional (sem função avançada) | /pdfpdt/ibm5577t.hodpdt | |
| Impressora IBM 5585 chinês tradicional | /pdfpdt/ibm5585t.hodpdt | |
| 1388 PRC (Chinês Simplificado Estendido; GB18030) | Impressora Chinês Simplificado ESC/P | /pdfpdt/esc_pp.hodpdt |
Para imprimir o conteúdo do arquivo no modo PDT com uma impressora PDT local, siga estas etapas: