Utilizando Web Settings com o CODE Designer

Recomendamos que você utilize as Configurações da Web com sua origem do DDS, para customizar seu aplicativo. Você pode utilizar a guia Configurações da Web do CODE Designer para customizar a aparência e o funcionamento dos programas, quando acessados por meio de um navegador da Web. Os programas que utilizam a origem DDS para descrever telas de vídeo 5250 podem ser acessados com um navegador da Web após a origem DDS ter sido convertida com a Webfacing Tool. Utilize as Configurações da Web quando desejar manipular a apresentação Web de telas individuais e campos individuais dentro das telas. Se você desejar alterar a apresentação Web de várias telas ou de um projeto WebFacing inteiro, utilize o assistente para Estilo. A instalação do CODE Designer é opcional com o WebSphere Development Studio Client para iSeries, V6.0.

Carregando a Origem DDS no CODE Designer

Você pode acessar o CODE Designer a partir do menu Iniciar do Windows ou do IDE do Development Studio Client para iSeries. Para carregar a origem DDS no CODE Designer a partir do IDE do Development Studio Client para iSeries:

  1. Abra a perspectiva WebFacing.
  2. Expanda WebFacing project > DDS.
  3. Clique com o botão direito no membro e selecione Abrir com > CODE Designer. Conecte-se, se solicitado. Se você não tiver uma conexão com um servidor do WebFacing configurada, precisará criar uma. Você receberá uma mensagem se o CODE Designer não estiver instalado
  4. Carregue membros adicionais a partir do CODE Designer selecionando Arquivo > Abrir e escolhendo a origem DDS a ser aberta a partir do diálogo Abrir para Editar. Os servidores disponíveis neste diálogo são os definidos utilizando o Communications Console. As bibliotecas exibidas são as da lista de bibliotecas para o ID do usuário com o qual você conectou-se.
Nota: Você também pode abrir a origem DDS no CODE Designer a partir do Remote System Explorer, expandindo uma conexão existente, clicando com o botão direito no membro e selecionando Abrir com > CODE Editor.

Acessando Web Settings no CODE Designer

Depois que um membro de origem DDS tiver sido carregado no CODE Designer, as Configurações da Web poderão ser acessadas clicando nos ícones na Árvore DDS do CODE Designer. A Árvore DDS está localizada no lado esquerdo da janela do CODE Designer. As Configurações da Web também podem ser acessadas selecionando os objetos DDS a partir das guias Detalhes a TELA do CODE Designer.Se as Configurações da Web estiverem disponíveis para o objeto selecionado, a guia Configurações da Web será exibida na área de janela inferior do CODE Designer.

Objetos e Configurações da Web do CODE Designer

O CODE Designer permite projetar telas DDS graficamente. No CODE Designer, cada objeto DDS é representado por um ícone ou botão de comando. Por exemplo, há botões de comando para que você possa criar facilmente campos ou constantes de texto nomeadas para a sua tela DDS. As Configurações da Web disponíveis para cada objeto DDS variam dependendo do objeto com o qual você está trabalhando. A tabela a seguir lista as Configurações da Web disponíveis para cada objeto DDS. Consulte a seção deste documento Descrições de Configurações da Web para obter mais detalhes sobre cada definição.Quando você utiliza Configurações da Web para um objeto, comentários especiais são incluídos na origem DDS que, posteriormente, são processados pela conversão de WebFacing. Os comentários de Configurações da Web começam com os caracteres *%%WB.

Tabela 1. Configurações da Web do CODE Designer
Objeto DDS Gráfico do CODE Designer Configurações da Web Disponíveis
Registro Padrão
Registro de Controle de Subarquivo
 
Campo de Data
Campo de Hora
Campo de Data e Hora
Constante de Mensagem
Constante de Data
Constante de Hora
Constante de Usuário
Constante de Sistema
 
Campo Nomeado (capacidade para Entrada)
Campo de Continuação (capacidade para Entrada)
Campo de Referência de Origem (capacidade para Entrada)
Campo de Referência de Banco de Dados (capacidade para Entrada)
Campo de Referência de Banco de Dados por Seleção (capacidade para Entrada)
 
Campo Nomeado (Saída)
Campo de Continuação (Saída)
Campo de Referência de Origem (Saída)
Campo de Referência de Banco de Dados (Saída)
Campo de Referência de Banco de Dados por Seleção (Saída)
Constante de Texto
 
Campo da Data (Oculto)
Campo da Hora (Oculto)
Campo Denominado (Oculto)
Campo Continuado (Oculto)
Campo de Referência de Origem (Oculto)
Campo de Referência de Banco de Dados (Oculto)
Campo de Referência de Banco de Dados por Seleção (Oculto)

Descrições de Configurações da Web

Etiquetas de Teclas

Para teclas de função ou de comando na origem DDS, você pode especificar os rótulos do texto para serem utilizados em suas páginas da Web para representar as teclas. Para alterar uma etiqueta, selecione uma etiqueta na lista Etiquetas já definidas, digite o texto preferencial para a tecla no campo Nova Etiqueta e clique em Alterar. Para remover uma etiqueta definida, selecione-a na lista Substituir Etiquetas na Configuração de Web e clique em Remover.

Ordem das teclas

Para teclas de função ou comandos na origem DDS, você pode especificar se as teclas estarão visíveis nas páginas da Web, bem como a ordem em que elas serão exibidas. Para trabalhar com essa definição, marque a caixa de opções Pedido de mudanças e visibilidade das teclas de comando. Para tornar uma chave visível, selecione-a na lista Ocultar e clique no botão de seta para movê-la até a lista Exibir ordem. Para ocultar uma tecla, selecione-a na lista Exibir ordem e clique na seta para movê-la até a lista Ocultar. Se mais de uma tecla estiver disponível na lista Exibir Ordem, a ordem na qual ela será exibida poderá ser alterada selecionando essa tecla e clicando nos botões de Seta para Cima ou Seta para Baixo. Se a caixa de opções Pedido de mudanças e visibilidade das teclas de comando não estiver selecionada, as teclas definidas serão mostradas em ordem numérica.

Tamanho da exibição

A definição Tamanho da exibição estará disponível se um tamanho de exibição secundário tiver sido selecionado para seu arquivo de exibição. Tamanhos de exibição secundários podem ser configurados por meio do diálogo de propriedades do ícone de nó de arquivo na Árvore DDS. Utilize a configuração da Web Tamanho da exibição para alterar o tamanho da tabela HTML que será utilizada para exibir seu aplicativo em um navegador.

Visibilidade

As opções disponíveis para a definição de Disponibilidade são Ocultar Campo ou Mostrar Campo. Se a opção Mostrar Campo for escolhida, o campo será exibido nas páginas da Web.

Localização

As opções disponíveis para a Definição de local são Alterar extensão e Alterar posição. Depois que sua origem DDS tiver sido convertida com a Webfacing Tool, seu aplicativo será posicionado em uma página da Web utilizando a tabela HTML. Essa tabela tem o mesmo número de linhas e colunas que a sua tela DDS, ou seja, 24 por 80 ou 27 por 132. Com as definições de local, é possível alterar a maneira como os campos serão posicionados na tabela HTML após a conversão da origem.

  • Alterar extensão permite indicar o número de linhas e colunas na tabela HTML que será concedido para seu campo. Um uso possível para Alterar extensão seria utilizar um gráfico no lugar dos valores de texto que seu programa utilizou originalmente para ocupar o campo. Por exemplo, o programa original pode ter requerido 7 colunas para texto no campo, mas o gráfico que você deseja utilizar requer apenas 2 colunas.
  • Alterar posição permite indicar a linha e coluna na tabela HTML que será a posição inicial para o campo.

A visualização da tela do CODE Designer mostra o layout de linha e coluna para a origem DDS. Utilize essa visualização para ter uma idéia de como os campos serão posicionados entre si se você fizer alterações com Alterar extensão e Alterar posição.

Informações sobre a Advanced Edition do produto Uma opção adicional para a configuração Location é Posição do CSS. A definição de Cascading Style Sheet - Positioning permite colocar campos em qualquer local de uma página da Web, sem restrições.
  • Linha permite especificar o valor de linha do campo. Esse valor deve ser um inteiro positivo maior que ou igual a 1.
  • Coluna permite especificar o valor de coluna para o campo. Esse valor deve ser um inteiro positivo maior que ou igual a 1.
  • Deslocamento permite especificar o número de pixels para o qual o campo é ajustado, com relação ao valor de linha ou de coluna. Esse número pode ser 0 ou um inteiro positivo ou negativo.
  • Desativar Tabulação permite indicar se o campo pode ou não ser tabulado depois de ser movido. Se você selecionar Desativar Tabulação, o usuário não poderá tabular até esse campo. Caso contrário, o campo permanecerá na mesma ordem de tabulação na qual estava antes de ser movido.
HTML definido pelo programa

Com a definição HTML definido pelo programa, marque a opção Utilizar Valor do Campo como HTML se o valor retornado pelo campo for uma marcação HTML que você deseja utilizar na sua página.

HTML definido pelo usuário

A definição de HTML definida pelo usuário permite especificar texto ou tags HTML que podem ser exibidas com o valor do campo ou em substituição a esse valor. Para trabalhar com essa definição, marque a caixa de opções Especificar HTML. Na área de entrada, digite as marcações HTML que você gostaria de utilizar. Se você quiser utilizar o valor do campo como parte do HTML, clique no botão Inserir Valor do Campo. Um exemplo de como utilizar essa definição seria se você quisesse que o valor do campo fosse exibido com uma fonte em negrito. Para fazer isso, utilize a tag <BOLD> com o texto &{FIELD.value}. Com esse exemplo, edite a área de entrada para que ela exiba <BOLD>&{FIELD.value}</BOLD>. Se o código de &{FIELD.value} não estiver lá por padrão, ele poderá ser adicionado clicando-se no botão Inserir Valor do Campo.

Aparência e Texto

As opções disponíveis para a definição de Aparência e Texto são Alterar Classe de Estilo, Substituir Valor de Campo, Substituir Texto da Constante e Ocultar Caracteres:

  • Alterar Classe de Estilo permite especificar uma classe de folha de estilo a ser utilizada com o campo. Por exemplo, é possível querer exibir todos os dados numéricos com uma fonte ou cor específica e definiu uma classe de folha de estilo numérica para essa finalidade. Se você tivesse um campo de número de cliente no programa, como N° do cliente, poderia marcar a caixa de opções Alterar Classe de Estilo e digitar o nome da classe da folha de estilo numérica.
  • Substituir Valor de Campo permite especificar o texto que você deseja exibir no lugar do valor retornado para o seu campo.
  • Substituir Texto da Constante permite especificar o texto que você deseja exibir no lugar do valor configurado para uma constante de texto.
  • Ocultar Caracteres permite indicar um intervalo de caracteres no campo que você não deseja exibir. Por exemplo, se a tela exibir um menu de opções a serem escolhidas por um usuário, e cada opção estiver listada numericamente (como: 1. Tarefas do Usuário - 2. Tarefas do Escritório), convém ocultar os dois primeiros caracteres para que apenas o texto da opção seja exibido. Em um exemplo como esse, você escolheria Ocultar Caracteres e especificaria um intervalo de 1 a 2.

Inserir HTML

A definição de Inserir HTML fornece um meio de customizar campos com a inclusão de um HTML adicional. O HTML pode, opcionalmente, ser incluído Antes, Dentro e Depois da marcação HTML que é gerada automaticamente para o campo. Como exemplo, é possível ter um campo de entrada para números de funcionários e em sua empresa todos os números de funcionários têm o prefixo 64-. É possível ria tornar o campo mais fácil de ser utilizado incluindo algum HTML, como:

Antes
<strong>64- prefix mandatory</strong>
Dentro
value="64-"
Depois
<a href="help.htm">Click here for more information on this field</a>

Nesse exemplo, o HTML Antes do campo fornece informações sobre o campo e utiliza a tag <strong>, para que as informações sejam enfatizadas com uma fonte em negrito. Como o HTML gerado por conversão utiliza a tag <input> para campos de entrada, Dentro da tag <input> podemos incluir o atributo HTML value="64-" para que o campo já tenha o prefixo do número do funcionário preenchido e os usuários não precisem inseri-lo. Depois do campo é o HTML para um link que os usuários podem clicar para obter mais informações sobre o campo.

Assegure-se de testar completamente as páginas que você alterando com a definição Inserir HTML.As alterações que você faz podem conflitar com o HTML que é gerado pela conversão de WebFacing. Uma maneira de solucionar isso seria converter o programa sem utilizar as Configurações da Web, consultar a origem do .html ou .jsp que é gerada para saber quais alterações podem ser feitas seguramente com as definições da Web, aplicar as definições da Web e, em seguida, convertê-las novamente.

Opções para VALUES

A configuração de Opções para VALUES está disponível para campos de entrada que são especificados com a palavra-chave VALUES. Os campos que são especificados com a palavra-chave VALUES são exibidos em páginas da Web como uma única caixa de seleção de opções. As opções exibidas na caixa de seleção são os valores fornecidos como parâmetros para a palavra-chave VALUES em sua origem DDS.

A configuração da Web de Opções para VALUES permite alterar a etiqueta ou o texto que aparece ao usuário. Por exemplo, se um dos parâmetros VALUES que o programa está esperando for "item8", é possível alterar o texto exibido em um navegador para algo mais descritivo, como por exemplo "fio de calibre 8". Enquanto o texto exibido para o usuário seria "fio de calibre 8", o valor retornado para seu programa seria o mesmo "item8" que o programa esperava.

Para utilizar essa configuração da Web, marque a caixa de opções Opção de textos para a palavra-chave VALUES. Para configurar uma nova etiqueta para um parâmetro VALUES, selecione esse valor e digite o texto desejado para a etiqueta no campo Nova Etiqueta.

Criar gráfico

Utilize a definição de Criar gráfico se quiser exibir uma imagem no lugar do campo. Um exemplo de uso desta definição seria um banco de dados do produto que inclui imagens de itens inventariados.

Ocupe o campo Nome do arquivo com o caminho completo para um arquivo de imagem em sua estação de trabalho ou com a URL completa para um arquivo de imagem (por exemplo, http://www.ibm.com/image.gif). O campo Nome do arquivo pode ser ocupado digitando um valor diretamente ou utilizando o botão Procurar para localizar um arquivo local.As imagens locais especificadas serão copiadas para o diretório ..\Web Content\images\generated\ de seu projeto WebFacing durante a conversão de WebFacing. As imagens neste diretório são publicadas posteriormente no servidor WebSphere, quando você implementa seu projeto com o assistente para Exportar.

As definições Largura em Pixels e Altura em Pixels poderão ser utilizadas se você conhecer as dimensões de uma imagem. A inclusão de informações de largura e altura pode, às vezes, diminuir o tempo necessário para processar páginas da Web que contêm imagens.

Se houver campos no programa que retornam valores que podem ser utilizados como parte do nome do arquivo de imagem, ou a URL completa para um arquivo de imagem, esses valores poderão ser incluídos no campo Nome do Arquivo selecionando o campo na lista Escolher um Campo e clicando em Inserir Valor do Campo. Por exemplo, se você tivesse &{FIELD1.value} que retornasse o valor bicycle1, poderia facilmente fazer referência a um gráfico bicycle1.gif que estivesse sendo utilizado na estação de trabalho. Nesse exemplo, preencha o campo Nome do Arquivo a partir da lista Escolher um Campo e, em seguida, inclua a extensão .gif. Os arquivos identificados com o uso da lista Escolher um Campo devem ser manualmente copiados para o diretório ..\Web Content\images\generated\.

Criar hyperlink

Utilize a definição de Criar hyperlink para que o campo seja exibido como um hyperlink. Existem três abordagens diferentes disponíveis para a criação de hyperlinks. Elas são: Especificar URL Estática, Hyperlink JavaScript e Hyperlink de Ação. Se você quiser substituir as definições do navegador para a aparência de hyperlinks, marque a caixa de opções Substituir aparência do hyperlink do navegador pela aparência DDS. Se você utilizar a definição de Criar hyperlink junto com a definição de Criar gráfico, o campo poderá ser exibido como um gráfico que também serve como um hyperlink.

Nota: Existem algumas condições em que os hyperlinks Ações criados com definições da Web não aparecerão em um navegador. Isso é feito para evitar condições de erro quando o hyperlink não se aplica para aquele que está ativo ou disponível no navegador. Exemplo:
  • O hyperlink está em um registro que não é atualmente a janela superior ou não está na camada superior.
  • Uma tecla de função que foi associada ao link não está ativa no momento.
  • Um campo mencionado que faz parte do link não está em um registro ativo ou não é legível. Por exemplo, o registro é protegido por outros registros que utilizam a palavra-chave PROTECT.
Substituir aparência do hyperlink do navegador pela aparência DDS

A maioria dos navegadores segue uma convenção para a cor e aparência dos hyperlinks em páginas da Web ou tem definições para aparência de hyperlink que os usuários podem alterar. Por exemplo, links não visitados podem ser exibidos em texto azul e links visitados podem ser exibidos em texto púrpura. Se você quiser que o navegador exiba o hyperlink com a mesma aparência que a utilizada para o campo no DDS, marque a caixa de opções Substituir aparência do hyperlink do navegador pela aparência DDS.

Especificar URL estático

Se houver uma URL específica que você deseja exibir para um campo, selecione a configuração de Especificar URL estática. O valor de saída do seu campo será o texto exibido como um hyperlink. O local carregada pelo navegador quando um usuário clica no link é o valor digitado no campo URL. Se desejar que o link lance uma janela de navegador separada quando for clicado, digite o nome da janela no campo Destino. Se você deixar o campo Destino vazio ou digitar *SAME, o link será aberto na janela do navegador atual.

Informações para a Edição Advanced do produto Se você estiver trabalhando com um projeto de portlet do WebFacing utilizando o WebSphere Development Studio Client Advanced Edition para iSeries, V5.1.2, poderá especificar *PORTLET no campo Destino para abrir o link dentro do portlet.

Se houver um valor de campo no DDS que você deseja incluir como parte da URL, selecione um campo na lista Escolher um Campo e utilize o botão Inserir Valor do Campo para incluí-lo no campo URL. Um exemplo do uso de Inserir Valor do Campo seria se houvesse uma URL no qual você quisesse inserir parâmetros adicionais. Por exemplo, se você tivesse um servlet em um local como http://mysite.com/mywebapp/servlet/MyServlet e o servlet esperasse argumentos para as variáveis parm1 e parm2, seria possível utilizar a configuração Inserir Valor do Campo para ajudar a construir a URL. Nesse exemplo, a URL final teria a seguinte aparência: http://mysite.com/mywebapp/servlet/MyServlet?parm1=&{FIELD1.value}&parm2=&{FIELD2.value}, em que &{FIELD1.value} e &{FIELD2.value} são parâmetros incluídos com o uso de Inserir Valor do Campo e que representam valores alterados em tempo de execução.
Nota: Se gostaria de utilizar um valor de campo a partir de um formato de registro diferente como parte da URL para o seu campo de hyperlink, é necessário assegurar que o campo vá estar disponível na página da Web quando o hyperlink for exibido. Os campos em formatos de registro diferentes podem ser identificados na lista Escolher um Campo, pois incluem o nome do formato de registro, por exemplo, &{RECORD2.FIELD1.value}. Se ambos os formatos de registro não estiverem disponíveis na página da Web em que o hyperlink está sendo exibido, ocorrerá uma exceção quando o hyperlink for selecionado.

Hyperlink JavaScript

Digite o nome de uma função JavaScript que deseja que seja chamada quando o link for clicado. Por exemplo, digite myFunction(). A função pode ser uma função que você inseriu utilizando a configuração da Web Inserir no script, uma função definida em um arquivo JavaScript externo ou uma função incluída no WebFacing no arquivo webface.js. Se criar seus próprios arquivos JavaScript externos, coloque-os no diretório usr de seu projeto WebFacing. Esse diretório está localizado no caminho <project name>\WebContent\ClientScript\usr. Todos os scripts que você colocar nesse diretório estarão disponíveis para seu aplicativo do WebFacing no tempo de execução. Se você tiver uma função JavaScript pequena em linha, é possível digitar a função inteira no campo Hyperlink JavaScript.

Hyperlink de Ação
Hyperlink de Ação cria um link que, quando clicado, pode posicionar o cursor em um campo, desempenhar um envio ou uma combinação de ambos. As funções Posicionar o Cursor no Campo e Enviar possuem valores que podem ser especificados.
Posicionar o Cursor no Campo
Quando o link é clicado, o valor de tempo de execução para o local do cursor retornado ao seu aplicativo será o local do campo especificado aqui. É possível selecionar um campo na lista drop down ou digitar manualmente o nome de um campo. Se você não selecionar Posicionar o Cursor no Campo, o cursor será posicionado no campo que foi selecionado por último pelo usuário da Web. Esse valor de cursor não se refere ao cursor como é exibido pelo navegador, refere-se ao valor de tempo de execução do WebFacing para o local atual do cursor dos campos no registro DDS. Se você quiser designar um valor para o campo no qual o cursor está posicionado, escolha um campo ou digite um valor no campo Digitar Dados.

As entradas em Posicionar o Cursor no Campo podem ter o seguinte formato:

&{FIELD}
Campo no registro atual.
&{RECORD.FIELD}
Campo no registro especificado.

As entradas no campo Digitar Dados podem ter o seguinte formato:

&{FIELD.value}
O valor do campo no registro atual.
&{RECORD.FIELD.value}
O valor do campo no registro especificado.

Você também pode digitar valores manualmente no campo Digitar Dados.

Enviar

Se a caixa de opções Enviar estiver selecionada, você poderá escolher uma ação de envio Tecla de Função ou Chamada de Função JavaScript para o hyperlink. Por exemplo, na lista drop-down Tecla de Função, é possível escolher ENTER, LOGOFF ou uma tecla de função definida no DDS. Se houver uma tecla de função de outro registro DDS que você gostaria de utilizar, digite manualmente o valor para a tecla de função. Quando o usuário clicar em um link que você criou para uma tecla de função, o programa executará essa função. No campo Chamada de função JavaScript, você pode digitar o nome de uma função JavaScript que deseja que seja executada quando o link for clicado. A função pode ser uma função que você inseriu utilizando a configuração da Web Inserir no script, uma função definida em um arquivo JavaScript externo ou uma função incluída no WebFacing no arquivo webface.js. Se criar seus próprios arquivos JavaScript externos, coloque-os no diretório usr de seu projeto WebFacing. Esse diretório está localizado no caminho <project name>\WebContent\ClientScript\usr. Todos os scripts que você colocar nesse diretório estarão disponíveis para seu aplicativo do WebFacing no tempo de execução.

Você pode combinar a opção Posicionar o Cursor no Campo com a opção Enviar. Faça isso se desejar definir o valor para um campo específico e enviar este valor de volta ao seu programa. Para fazer isso, marque a caixa de opções Posicionar o Cursor no Campo, escolha um campo na lista drop-down (ou digite um campo); no campo Digitar Dados, escolha {FIELD.value} (ou digite um valor específico), marque a caixa de opções Enviar, selecione o botão de rádio Tecla de Função e escolha ENTER no menu drop-down Tecla de Função. Para obter informações sobre o formato de entrada a ser utilizado para os campos Posicionar o Cursor no Campo e Digitar Dados, consulte a seção deste documento Posicionar o Cursor no Campo.

Inserir no Script
Utilize a definição Inserir no Script para customizar os arquivos JSP que são criados para registros regulares ou registros de controle de subarquivos. Por exemplo, se você tiver um registro de controle de subarquivos LISTCTL, a conversão do WebFacing criará um arquivo JSP correspondente LISTCTLJavaScript.jsp. O código incluído no campo Fazer Script da definição Inserir no Script será incluído no arquivo LISTCTLJavaScript.jsp quando for gerado. Essa definição permite digitar scriptlets javascript ou JSP arbitrários nos programas convertidos. Isso pode ser utilizado para inicializar campos ou desempenhar qualquer trabalho necessário para o formato de registro específico. Por exemplo, é possível incluir um código que define um valor de campo se o valor inicial for nulo:
if(&{CID}.value="")
{
	&{CID}.value="0001";
}
Neste exemplo, o código &{CID} faz referência a um CID de campo que foi selecionado com o botão Inserir Nome do Campo. Os campos no botão Inserir Nome do Campo são delimitados por um e comercial e dois parênteses, por exemplo: &{FIELDNAME}. Outros exemplos seriam um código JSP que determina o endereço IP de um usuário do WebFacing ou um javascript que exibe a hora do dia do sistema do usuário. Você pode utilizar Inserir no Script junto com a definição Enviar para Navegador. Por exemplo, é possível utilizar valores determinados por seus scripts para ocupar campos ocultos para os quais você utilizou a definição Enviar para navegador. Se houver um campo existente no DDS que você deseja utilizar como parte do seu script, inclua-o nesse script com o botão Inserir Nome do Campo. Por exemplo, é possível selecionar um campo oculto ou H e utilizá-lo no script para que um valor possa ser atribuído a ele.

Enviar para o Navegador

A definição Enviar para o Navegador pode ser utilizada para campos DDs ocultos ou H. Essa definição modifica os arquivos JSP gerados para seu registro. Por exemplo, se você tiver um campo H em um registro denominado LISTCTL, quando essa definição for utilizada, um elemento de forma de entrada oculto HTML será gerado no arquivo JSP LISTCTL.jsp. Os elementos de forma de entrada ocultos começam com o código HTML <INPUT TYPE="hidden" . Utilizando Enviar para navegador permite que um campo H se torne parte do ambiente do navegador e que valores sejam atribuídos a ele com base nesse ambiente. Por exemplo, o endereço IP de um usuário determinado por um script que você incluiu utilizando a definição Inserir no script.

Etiqueta de Tecla Dinâmica

A definição Etiqueta de Tecla Dinâmica pode ser utilizada para determinar a etiqueta de texto de uma tecla de comando em tempo de execução. Essa definição só está disponível para campos de saída. Com essa definição, uma chave de comandos é associada ao campo de saída e o texto para a chave de comandos é determinado pelo valor do tempo de execução do campo. Um exemplo de utilização é se o seu aplicativo deve suportar mais de um idioma e você deseja que o texto da chave de comandos apareça no idioma nativo do usuário. Uma maneira de fazer isso é ter um MSGF por idioma que contenha as cadeias de texto utilizada pelo aplicativo e colocar cada MSGF em uma biblioteca específica do idioma. Se o valor do campo de saída for lido a partir do MSGF, é possível alterar o idioma do texto exibido no campo digitando a biblioteca que contém o MSFG para o idioma do seu usuário em um ponto mais alto da lista da biblioteca no perfil do usuário. Subseqüentemente, o rótulo da chave de comandos será exibido n idioma do usuário.

Para utilizar essa definição, escolha a definição Etiqueta de Tecla Dinâmica e selecione Utilizar Valor de Campo como Etiqueta de Tecla de Comando. Na lista Tecla de Comando, escolha a tecla que será associada ao texto no campo de saída. A opção *AUTO também pode ser escolhida na lista Tecla de Comando. *AUTO significa que o valor do campo é analisado no tempo de execução para determinar a qual chave de comandos atribuir o rótulo.
Nota: Apenas um conjunto limitado de padrões de cadeia são atualmente suportados pelo *AUTO. Avalie se *AUTO funcionará com o aplicativo baseado nos padrões listados no prefixo e na tabela do separador abaixo e seu conhecimento de cadeias para rótulos de chaves de comandos são utilizados em seu aplicativo. A tabela identifica padrões através de um prefixo e de um separador. Por exemplo, se a cadeia F3=Sair for o valor de saída e *AUTO for o valor escolhido na lista Enviar Tecla de Função, a cadeia Sair será utilizada para a etiqueta da tecla de comando. Ou seja, F é tratado como o prefixo, = é tratado como o separador e o texto após o separador é utilizado para o rótulo.
Prefixo Separador
F =
FP =
CF =
CA =
PF =
Avisos
  • *AUTO pode afetar o desempenho de tempo de execução. A utilização de *AUTO pode ser evitada assegurando que há um mapeamento de um-para-um dos campos de saída para as chaves de comando.
  • Se você estiver utilizando MSGFs para o texto de campos de saída, o texto de MSGF não deverá incluir a tecla. Por exemplo, para Sair, o texto em um MSGF deve ser Sair, não F3=Sair.

Feedback