Utilizando Web Settings com sua Origem DDS

As Configurações da Web permitem que você determine a aparência de suas páginas, antes delas serem criadas, utilizando o assistente para WebFacing. Se você desejar modificar as páginas após a conversão, utilize um editor de texto ou uma ferramenta de design da Web, como o WebSphere Studio. Uma vantagem de customizar suas páginas com as Configurações da Web é que as instruções para as customizações são incorporadas como comentários em sua origem DDS; como as Configurações da Web tornam-se parte de sua origem, as alterações feitas não serão perdidas se, posteriormente, você converter um projeto WebFacing. No entanto, as alterações feitas diretamente em um arquivo JSP gerado são perdidas quando você converte novamente seu projeto.

Se você incluir ou alterar as Configurações da Web para um projeto que já tenha sido convertido, converta novamente seu projeto para tornar as alterações parte do seu aplicativo WebFacing. Como alternativa, é possível converter novamente apenas os membros DDS alterados. Para reconverter membros específicos, no Development Studio Client para iSeries IDE, abra a perspectiva do WebFacing, clique na guia WebFacing Projects, expanda a pasta DDS, clique com botão direito do mouse no membro alterado e selecione Converter. Se a visualização Projetos WebFacing não estiver aberta, selecione Janela > Mostrar Visualização > Outra > WebFacing > Projetos WebFacing .

Se mais de uma configuração da Web do mesmo tipo for especificada em um único campo, registro ou arquivo, o comportamento não será definido. (Em outras palavras, não há garantia de qual daquelas configurações da Web duplicadas serão efetivadas.)

Tabela 1. Configurações da Web
Objeto DDS Ícone Configurações da Web Disponíveis
Nível de arquivo
Exibir Arquivo Físico de Origem
  • Etiquetas de Teclas
Registros
Registro Padrão
  • Rótulos de tecla e pedido de tecla
  • Teclas desativadas
  • Tamanho da exibição
  • Inserir script
Registro de Controle de Subarquivo
Constantes
Constante de Mensagem
  • Aparência
  • Substituições do HTML
  • Localização
Constante de Data
Constante de Hora
Constante de Usuário
Constante de Sistema
Campos aptos à entrada (inclusive campos com Both especificado para uso)
Campo Alfanumérico
  • Aparência
  • Substituições do HTML
  • Localização
  • Etiquetas de opções (apenas disponíveis se o campo de entrada for especificado com a palavra-chave VALUES)
Campo de Zona
Data
Tempo
Data/hora
Flutuante
Campo continuado
Apenas DBCS
Ou DBCS
DBCS Aberto
Gráfico DBCS
Campos Apenas de Saída
Campo Alfanumérico
  • Aparência
  • Rótulos de tecla dinâmica
  • Substituições do HTML
  • Hyperlink
  • Imagem
  • Localização
Campo de Zona
Data
Tempo
Data/hora
Flutuante
Apenas DBCS
Ou DBCS
DBCS Aberto
Gráfico DBCS
Constante de texto
Campos ocultos
Campo Alfanumérico
  • Enviar para o Navegador
Campo de Zona
Data
Tempo
Data/hora
Flutuante
Apenas DBCS
Ou DBCS
DBCS Aberto
Gráfico DBCS

Editando Web Settings para um Membro DDS

Quando abrir a perspectiva WebFacing pela primeira vez, a visualização Web Settings será exibida por padrão. A visualização permanecerá vazia até que você abra um membro de origem DDS do DSPF no LPEX Editor. Para editar Web Settings para um membro DDS:

  1. Na perspectiva WebFacing, expanda Projeto WebFacing > DDS.
  2. Clique com o botão direito no membro DDS com o qual deseja trabalhar e selecione Abrir com > Remote Systems LPEX Editor.
  3. Se solicitado, conecte-se ao servidor. O arquivo é aberto na janela do editor.
  4. Clique em um objeto DDS no editor. A lista de definições disponíveis para esse objeto é exibida na visualização Web Settings.
  5. Clique em uma definição na lista para editá-la. As opções para Configurações da Web são exibidas do lado direito da visualização Configurações da Web.
    web settings
  6. Se a visualização Configurações da Web não for aberta, abra-a selecionando Janela > Mostrar Visualização > Outra > WebFacing > Configurações da Web.
  7. Para navegar rapidamente para objetos específicos, selecione Janela > Mostrar Visualização > Esboço para abrir a visualização Esboço. Conforme você clica em objetos na visualização Esboço, o foco irá para esses objetos na janela do editor.

Descrições da Configurações da Web

As Configurações da Web disponíveis para cada objeto DDS variam dependendo do objeto com o qual você está trabalhando. Esta seção fornece detalhes adicionais 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. A seguir está a convenção de sintaxe para Configurações da Web:
*%%WB <number> <level>
em que <number> é o número da Configuração da Web e <level> é seu nível ({FIL|REC|FLD}). É possível estender Configurações da Web por muitas linhas, colocando um + como o último caractere não vazio na linha e iniciando a próxima linha com *%%WB +.

As seções a seguir descrevem as definições da Web por arquivo, registro e nível de campo e incluem a sintaxe dos comentários incluídos em sua origem DDS para cada definição. Algumas configurações da Web utilizam uma sintaxe diferente antes do WebSphere Development Studio Client para iSeries 6.0. Embora a sintaxe para algumas definições da Web esteja obsoleta, ela será convertida na sintaxe atualizada durante a conversão de WebFacing. A sintaxe reprovada será mostrada se aplicável a cada configuração da Web.

Configurações de Web em nível de Arquivo

A única configuração da Web em nível de arquivo são Etiquetas de Teclas.

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 tecla de função ou de comando da lista Etiquetas de Teclas, dê um clique duplo no campo Nova Etiqueta e digite o novo texto para a tecla. Para remover uma etiqueta definida, dê um clique duplo no campo Nova Etiqueta e exclua o texto.

Você também pode selecionar a linha apropriada e utilizar Editar Etiqueta ou a tecla Excluir para desempenhar estas funções.
web settings
Nota: As etiquetas de teclas de função não podem ser substituídas.

Sintaxe:

A*%%WB 9 FIL <key_label>["|"<key_label2>["|"<key_label3>[...]]]

Exemplo:

A*%%WB 9 FIL 12=Cancel|03=Exit 

Configurações da Web em nível de Registro

A seguir estão as categorias de definições da Web disponíveis no nível de registro:
  • Tamanho da exibição
  • Inserir Script
  • Etiquetas de Teclas
  • Ordem da tecla
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. Os tamanhos de telas secundários podem ser especificados utilizando a palavra-chave DSPSIZ em nível de arquivo. 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. Esta configuração da Web se aplica apenas a registros que possuem uma palavra-chave DSPMOD condicionada. Estes registros podem ser exibidos no tamanho de tela primário ou secundário, dependendo do valor da condição no tempo de execução, no entanto, a conversão de WebFacing destina-se apenas a um tamanho de tela. Se desejar que o aplicativo mostre este registro no tamanho de tela secundário em vez de mostrar no tamanho de tela primário padrão, será necessário especificar esta configuração da Web.

web settings

Sintaxe:

A*%%WB 10 REC

Exemplo:

A*%%WB 10 REC
Inserir Script
Utilize a definição Inserir Script para customizar os arquivos JSP que foram 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 na área de texto da definição Inserir Script será incluído no arquivo LISTCTLJavaScript.jsp quando for gerado. Essa configuração permite digitar scriptlets JavaScript ou JSP arbitrários nos arquivos JSP 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.INITIALVALUE} == "")
{
	&{CID.REF}.value = "0001";
}
Neste exemplo, o código &{CID.INITIALVALUE} refere-se a um CID de campo que foi selecionado utilizando o botão Inserir Atributo do Campo. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos. Outros exemplos seriam o código JSP que determina o endereço IP de um usuário WebFacing ou o JavaScript que exibe a hora do dia do sistema do usuário. É possível utilizar Inserir Script juntamente 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 em seu DDS que você deseja utilizar como parte de seu script, inclua-o em seu script utilizando o botão Inserir Atributo 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.
web settings

Sintaxe:

A*%%WB 18 REC 1 <script>

reprovado:

A*%%WB 18 REC <script>

Para Insert script, existem dois formatos reprovados de variáveis de substituição:

&SFLREC{FIELD} que se torna &{SFLREC.FIELD.REF}

e

&{FIELD} que se torna &{FIELD.REF}

Por exemplo, o Inserir Script antigo (REC):

A*%%WB 18 REC &{FIELD1}.value=1;&RECORD3{FIELD1}.value=4

se torna o novo Inserir Script (REC 1):

A*%%WB 18 REC 1 &{FIELD1.REF}.value=1;&{RECORD3.FIELD1.REF}.value=4

Exemplo:

A*%%WB 18 REC 1 &{CUSTCTL.field1.CURRENTVALUE}
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 tecla da lista Etiquetas de Teclas e Ordem de Teclas, dê um clique duplo no campo Nova Etiqueta e digite o texto de sua preferência para a tecla. O valor de Nova Etiqueta fica na configuração da Web padrão etiquetas de teclas do nível do arquivo, se nenhuma outra for definida. Para remover uma etiqueta definida, dê um clique duplo no campo Nova Etiqueta e exclua o texto. Você também pode selecionar a linha apropriada e utilizar Editar Etiqueta ou a tecla Delete para executar estas funções. O botão Padrão remove todas as configurações da Web relacionadas (como Etiquetas de Teclas, Ordem de Teclas e Teclas Desativadas).

web settings
Nota: Existem várias maneiras de definir a etiqueta para uma tecla de função em seus aplicativos WebFacing. Se mais de uma etiqueta estiver definida para uma tecla, a conversão e o tempo de execução de WebFacing utilizarão uma certa prioridade para determinar qual etiqueta aparecerá no navegador. Consulte Rótulos dos Botões das Teclas para obter a prioridade utilizada para determinar etiquetas de teclas.

Sintaxe:

A*%%WB 9 REC <key_label>["|"<key_label2>["|"<key_label3>[...]]]

Exemplo:

A*%%WB 9 REC 2=enter|1=print
Ordem da tecla

Para teclas de comando ou de função em sua origem DDS, é possível especificar se uma etiqueta de tecla fica ou não oculta em suas páginas da Web e a ordem na qual as teclas são exibidas.

Para ocultar uma tecla, selecione a tecla na lista Etiquetas de Teclas e Ordem de Teclas e selecione Ocultar na lista drop down na coluna Estado. Isso remove a tecla da lista de botões da página da Web, mas não desativa a tecla correspondente no teclado.

Para desativar uma tecla, selecione a tecla na lista Etiquetas de Teclas e Ordem de Teclas e selecione Disativar na lista drop down na coluna Estado. Isto remove a tecla da lista de botões na página da Web e desativa a tecla correspondente no teclado.

Se mais de uma tecla estiver disponível na lista Etiquetas de Teclas e Ordem de Teclas, a ordem em que ela será exibida poderá ser alterada, selecionando a tecla e clicando nos botões Mover para cima ou Mover para baixo. O botão Padrão restaura as teclas à sua ordem original.

web settings
Nota: Se você utilizar o CODE Designer para editar esta configuração da Web específica, as teclas de comando ou de função serão separadas. Se desejar tirar vantagem de poder alterar a ordem de teclas de comando e de função, será necessário apenas utilizar a visualização Web Settings para editar esta configuração da Web.

Sintaxe:

 A*%%WB 11 REC <aid_key> [<aid_key2> [<aid_key3> [...]]]

em que <aid_key> = CAnn | CFnn | SFLFOLD[(CAnn|CFnn)] | SFLDROP[(CAnn|CFnn)].

Exemplo:

A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)

Se SFLFOLD ou SFLDROP for especificado sem nenhuma tecla de auxílio, por exemplo:

A*%%WB 11 REC CA02 CF14 SFLFOLD SFLDROP(CA09)

a configuração da Web será atualizada da seguinte forma:

A*%%WB 11 REC CA02 CF14 SFLFOLD(CF10) SFLDROP(CA09)

com a palavra-chave SFLFOLD especificada utilizando a tecla ou função de comando 10.

Teclas Desativadas

Esta configuração da Web funciona em conjunto com as etiquetas de teclas e ordem de teclas. Ela permite desativar uma tecla de auxílio ativa (tecla de comando ou de função) no teclado, em vez de apenas ocultar sua etiqueta na interface Web com o usuário.

Nas configurações da interface Web com o usuário, é possível configurar o estado de uma tecla para um de três valores:
  • Visível: A etiqueta da tecla está visível e a tecla do teclado relatada está ativa.
  • Oculta: A etiqueta da tecla está oculta, mas a tecla equivalente no teclado ainda está ativa.
  • Desativada: A etiqueta da tecla está oculta e a tecla do teclado relacionada foi desativada.
web settings

As teclas são seqüenciadas de acordo com a configuração da Web de ordem de tecla. Se uma configuração da Web de ordem de Teclas não for especificada, a seqüência é determinada de acordo com a ordem numérica das teclas de comando e a ordem alfabética para teclas de função, com teclas de comando sempre vindo antes das teclas de função. Se uma tecla for definida em ambas as configurações da Web de ordem de chave visível (A*%%WB 11) e de Tecla desativada (A*%%WB 41), a seqüência visual terá preferência.

Sintaxe

A*%%WB 41 REC <aid_key> [<aid_key2> [<aid_key3> [...]]]

Exemplos

Teclas definidas: CF03 CA01 PRINT HELP
  1. Ordem de teclas visíveis: CA01 HELP

    Desativada: CA01 CF03

    Resultados: (teclas visíveis pedidas: CA01 HELP; teclas ocultas, mas ativas: PRINT; Teclas desativadas: CF03)

  2. Ordem de teclas visíveis: nenhuma

    Desativada: CA01 CF03

    Resultados: (teclas visíveis pedidas: HELP PRINT; teclas ocultas, mas ativas: nenhuma; Teclas desativadas: CA01 CF03)

  3. Ordem de teclas visíveis: CA01 HELP

    Desativada: nenhum

    Resultados: (teclas visíveis pedidas: CA01 HELP; teclas ocultas, mas ativas: CF03 PRINT; teclas desativadas: nenhuma)

  4. Ordem de teclas visíveis: nenhuma

    Desativada: nenhum

    Resultados: (teclas visíveis pedidas: CA01 CF03 HELP PRINT; teclas ocultas, mas ativas: nenhuma; teclas desativadas: nenhuma)

Configurações da Web de Nível de Campo

A seguir estão as categorias de definições da Web disponíveis no nível de campo:
  • Aparência
  • Etiqueta de Tecla Dinâmica
  • Substituições do HTML
  • Hyperlink
  • Imagem
  • Local
  • Etiquetas de Opções
  • Enviar para o Navegador
Aparência

As opções disponíveis para a categoria Aparência e Texto são Visibilidade, Substituir Classe de Estilo e Substituir Valor do Campo:

  • Visibilidade permite ocultar o campo utilizando a configuração da Web Oculto. Você também pode utilizar a configuração da Web Ocultar Caracteres para indicar um intervalo de caracteres em seu campo que deseja exibir. Por exemplo, se sua tela exibir um menu de opções para um usuário escolher e cada opção estiver listada numericamente (por exemplo: 1. Tarefas do Usuário - 2. Tarefas do Escritório), será recomendável ocultar os dois primeiros caracteres para que apenas o texto da opção seja exibido. Em um exemplo como este, é possível escolheria Ocultar Caracteres e especificaria um intervalo De 1 A 2. Observe que, se você utilizar a configuração da Web Oculto, nenhuma outra configuração da Web será permitida no mesmo campo.
  • Substituir 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 em seu programa como custno, poderia selecionar a caixa de opções Substituir Classe de Estilo e digitar o nome de sua classe de folha de estilo numérica.
  • Substituir Valor do Campo permite especificar o texto que você deseja exibir no lugar do valor retornado para o seu campo. Para um campo de constante, o título desta caixa de opções é alterado para Substituir Texto e o campo assume como padrão o valor de texto da constante.
web settings

Sintaxe (Oculto):

A*%%WB 4 FLD

Sintaxe (Ocultar Caracteres):

A*%%WB 5 FLD <from> <to>

Sintaxe (Substituir Classe de Estilo):

A*%%WB 1 FLD <style> <field>

Sintaxe (Substituir Valor do Campo):

A*%%WB 3 FLD <length>"|"<text>

Exemplo (Oculto):

A*%%WB 4 FLD

Exemplo (Ocultar Caracteres):

A*%%WB 5 FLD 1 12

Exemplo (Substituir Classe de Estilo):

A*%%WB 1 FLD wf_default wf_field

Exemplo (Substituir Valor do Campo):

A*%%WB 3 FLD 10|OOOOOOOOOO
Etiqueta de Tecla Dinâmica

A definição Etiquetas de Tecla Dinâmica pode ser utilizada para determinar a etiqueta de texto de uma tecla de comando no 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 esta definição, escolha a definição Etiquetas de Tecla Dinâmica e selecione Utilizar valor do campo como etiqueta para a tecla de função. Na lista, escolha a tecla que será associada ao texto do campo de saída. *AUTO também pode ser escolhido da lista. *AUTO significa que o valor do campo é analisado no tempo de execução para determinar a qual chave de comandos atribuir o rótulo. Isto permite que várias etiquetas sejam analisadas.
web settings
Nota: Existem várias maneiras de definir a etiqueta para uma tecla de função em seus aplicativos WebFacing. Se mais de uma etiqueta estiver definida para uma tecla, a conversão e o tempo de execução de WebFacing utilizarão uma certa prioridade para determinar qual etiqueta aparecerá no navegador. Consulte Rótulos dos Botões das Teclas para obter a prioridade utilizada para determinar etiquetas de teclas.
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=Exit for o valor de saída e *AUTO for o valor escolhido na lista, a cadeia Exit 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. Se você especificar *AUTO, poderá definir várias etiquetas no campo de saída.
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 não estiver utilizando *AUTO e 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.

Sintaxe:

A*%%WB 20 FLD (<key_number> | *AUTO)

Exemplo:

A*%%WB 20 FLD F12
Substituições do HTML

Substituições do HTML permite substituir o HTML gerado, substituindo-o pelo HTML definido pelo usuário ou inserindo o HTML junto com o HTML gerado.

Clique no botão de rádio Definido pelo Programa para especificar que o valor do próprio campo deve ser utilizado como o HTML gerado. Utilize esta definição se desejar que o programa aplicativo calcule o HTML para este campo em vez de utilizar algo gerado pela conversão de WebFacing.

Clique no botão de rádio Definido pelo Usuário para especificar o texto ou as tags HTML que podem ser exibidos no lugar do valor do campo ou em substituição a esse valor. Na área de entrada, digite as marcações HTML que você gostaria de utilizar. O valor padrão para esta configuração da Web é o script que representa o valor do campo ou o valor de texto da constante. Se desejar utilizar o valor para seu campo como parte do HTML, clique no botão Inserir Atributo do Campo. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos. Um exemplo de como utilizar esta opção seria se você desejasse que o valor do campo fosse exibido com uma fonte em negrito. Para fazer isso, utilize o texto <B> tag com &{FIELD.INITIALVALUE}. Com esse exemplo, edite a área de entrada para que ela exiba <B>&{FIELD.INITIALVALUE}</B>. Se o código de &{FIELD.INITIALVALUE} não estiver lá por padrão, ele poderá ser incluído clicando no botão Inserir Atributo do Campo. Você também pode incluir valores especiais, como a data ou a hora do sistema, no HTML definido pelo usuário. Consulte Utilizando valores especiais para obter informações adicionais sobre como utilizar valores especiais em HTML.

configurações da web

Clique no botão de rádio Inserir para customizar seus campos incluindo 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:

Before (%%WB 6)

<strong>64- prefix mandatory</strong>

Inside (%%WB 7)

value="64-"

After (%%WB 8)

<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.

web settings

Sintaxe (Definida pelo Programa):

 A*%%WB 16 FLD

Sintaxe (Definida pelo Usuário):

 A*%%WB 17 FLD 1 <html>
 A*%%WB 17 FLD 1 &{FIELD.INITIALVALUE}

Se encontrado, o %FieldValue reprovado será mapeado para o formulário mais novo de &{FIELD.INITIALVALUE}:

 A*%%WB 17 FLD <html> 
 A*%%WB 17 FLD &FieldValue 

Sintaxe (Inserir Antes):

 A*%%WB 6 FLD <html>

Sintaxe (Inserir Dentro):

 A*%%WB 7 FLD <html>

Sintaxe (Inserir Depois):

 A*%%WB 8 FLD <html>

Exemplo (Definido pelo Programa):

 A*%%WB 16 FLD

Exemplo (Definido pelo Usuário):

 A*%%WB 17 FLD 1 <BOLD>&{PARTSFL.STQTY.CURRENTVALUE}</BOLD>

Exemplo (Inserir Antes):

 A*%%WB 6 FLD <strong>64- prefix mandatory</strong>

Exemplo (Inserir Dentro):

 A*%%WB 7 FLD value="64-"

Exemplo (Inserir Depois):

 A*%%WB 8 FLD <a href="help.htm">Click here for more information on this field.</a>
Hyperlink

Utilize a definição Hyperlink para exibir seu campo como um hyperlink. É possível formatar seu hyperlink de acordo com as definições de DDS ou as definições do navegador, e vincular-se a uma página estática ou executar ações. Se desejar substituir as definições do navegador para a aparência do hyperlink, selecione a caixa de opções Utilizar Configurações DDS. Se você utilizar a definição Hyperlink junto com a definição Imagem, seu campo poderá exibido como um gráfico que também age como um hyperlink. Algumas destas definições aceitam valores de campos como entrada. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos.

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.
Utilizar Configurações 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 desejar que o navegador exiba o hyperlink com a mesma aparência utilizada para o campo em seu DDS, selecione o botão de rádio Utilizar Configurações DDS.

web settings

Sintaxe (Utilizar Configurações DDS):

A*%%WB 12 FLD 3 <hyperlink_type> <hyperlink_details> 1

Sintaxe (Utilizar Configurações do Navegador):

A*%%WB 12 FLD 3 <hyperlink_type> <hyperlink_details>

Exemplo:

A*%%WB 12 FLD 3 http://www.ibm.com| 1
Ir para URL

Se houver uma URL específica que você deseja exibir para um campo, selecione Ir para URL. 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, V6.0, poderá especificar *PORTLET no campo Destino para abrir o link dentro do portlet.

Se houver um valor de campo em seu DDS que você deseja que faça parte da URL, clique no botão no campo URL e selecione o registro, campo e atributo que deseja utilizar. Por exemplo, se você quisesse inserir parâmetros na URL http://mysite.com/mywebapp/servlet/MyServlet e se o servlet estivesse esperando argumentos para as variáveis parm1 e parm2, seria possível utilizar a definição de Insert field value para ajudar a construir o URL. Neste exemplo, sua URL final pode ser semelhante a http://mysite.com/mywebapp/servlet/MyServlet?parm1=&{FIELD1.INITIALVALUE}&parm2=&{FIELD2.INITIALVALUE}, em que &{FIELD1.INITIALVALUE} e &{FIELD2.INITIALVALUE} são parâmetros incluídos e que representam valores que são alterados no 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 que estão em diferentes formatos de registros podem ser identificados no diálogo Inserir Atributo do Campo, porque eles incluem o nome do formato do registro, por exemplo, &{RECORD2.FIELD1.INITIALVALUE}. 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. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos.
web settings

Sintaxe:

A*%%WB 12 FLD 3 <url>"|"<target>

reprovado:

A*%%WB 12 FLD 1 <url>"|"<target>

Exemplo:

A*%%WB 12 FLD 3 http://server/somepath?p2=&{FIELD2.INITIALVALUE}&p1=&{FIELD1.INITIALVALUE+
A*%%WB +}&p3=&{FIELD1.INITIALVALUE}

reprovado:

A*%%WB 12 FLD 1 http://server/somepath?p2=&{FIELD2}&p1=&{FIELD1}&p3=&{FIELD1}
Desempenhar Ações
A definição Desempenhar Ações cria um link que, quando clicado, pode posicionar o cursor em um campo, desempenhar um envio ou uma combinação dos dois. As funções Posicionar Cursor no Campo e Ações Adicionais podem ter valores que podem ser especificados.
web settings
Posicionar 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 Cursor no Campo, o cursor será posicionado no campo que foi selecionado pela última vez 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 desejar designar um valor ao campo no qual o cursor está posicionado, escolha um campo ou selecione a caixa de opções Configurar Valor do Campo para e digite um valor na área de texto. Algumas destas definições aceitam valores de campos como entrada. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos.

Sintaxe:

A*%%WB 12 FLD 5 fld=<field>"|"value=<value>
Ações Adicionais

Se a caixa de opções Ações Adicionais for selecionada, será possível escolher uma ação de envio de chamada de função Function key ou JavaScript para o hyperlink. Por exemplo, da lista drop-down Enviar Tecla de Função, é possível escolher ENTER, LOGOFF ou uma tecla de função definida em seu 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 Chamar JavaScript, 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.

É possível combinar a opção Posicionar Cursor no Campo com a opção Enviar Tecla de Função. Faça isso se desejar definir o valor para um campo específico e enviar este valor de volta ao seu programa. Para isso, selecione a caixa de opções Posicionar Cursor no Campo, escolha um campo da lista drop-down (ou digite um campo), selecione a caixa de opções Ações Adicionais, selecione o botão de rádio Enviar Tecla de Função e escolha ENTER da lista drop-down. Para obter informações sobre o formato de entrada a ser utilizado para Posicionar Cursor no Campo e o campo Enviar Tecla de Função, consulte a seção deste documento Posicionar Cursor no Campo.

Sintaxe:

A*%%WB 12 FLD 4 fld=<field>"|"value=<value>"|"func=<function_key>

reprovado:

A*%%WB 12 FLD 2 fld=<field>"|"value=<value>

Exemplo:

A*%%WB 12 FLD 4 fld=&{FIELD3.REF}|value=1|func=ENTER

reprovado:

A*%%WB 12 FLD 2 fld=FIELD3|value=1
Chamar 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 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 seqüencial curta, também poderá digitar toda a função no campo Chamar JavaScript.

Sintaxe (Enviar Tecla de Função):
A*%%WB 12 FLD 6 <function_key>
Sintaxe (Chamar JavaScript):
A*%%WB 12 FLD 7 <javascript>
Sintaxe (Posicione o cursor em um campo específico com dados e envie o JavaScript):
A*%%WB 12 FLD 8 fld=<field>"|"value=<value>"|"func=<javascript>
Sintaxe (Hyperlink JavaScript):
A*%%WB 12 FLD 9 <javascript>
Nota: O hyperlink JavaScript foi reprovado e se tornou Chamar JavaScript.

Imagem

Utilize a definição Imagem se desejar exibir uma imagem no lugar de seu 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 completo 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 ..\WebContent\images\generated\ do projeto do WebFacing durante a conversão do WebFacing. As imagens neste diretório são publicadas posteriormente no servidor WebSphere, quando você implementa seu projeto com o assistente para Exportar.

Largura e Altura podem ser utilizados se você souber 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 em seu 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, estes valores poderão ser incluídos no campo Nome do Arquivo clicando em Inserir Atributo do Campo e selecionando um campo a partir de Campo. Por exemplo, se você tivesse &{FIELD.INITIALVALUE} que retornasse o valor bicycle1, poderia facilmente referir-se a um gráfico bicycle1.gif com o qual é possível trabalhar em sua estação de trabalho. Neste exemplo, primeiro selecione o botão de rádio Dinâmico e, em seguida, ocupe o campo Nome do Arquivo utilizando Inserir Atributo do Campo e, em seguida, inclua a extensão .gif. Os arquivos identificados com o uso de um atributo de campo devem ser manualmente copiados para o diretório ..\WebContent\images\generated\. Para obter informações adicionais sobre como utilizar variáveis de substituição de campos, consulte Especificando Variáveis de Substituição de Campos.

web settings

Sintaxe:

A*%%WB 13 FLD 1 <width>"|"<height>"|"<graphic>

reprovado:

A*%%WB 13 FLD <width>"|"<height>"|"<graphic>

Exemplo:

A*%%WB 13 FLD 1 15|34|graphic.gif
A*%%WB 13 FLD 1 3|2|&{FIELD1.INITIALVALUE}.gif 

reprovado:

A*%%WB 13 FLD 15|34|graphic.gif
A*%%WB 13 FLD 3|2|&{FIELD1}.gif
Local

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 posição permite indicar a linha e coluna na tabela HTML que será a posição inicial para o campo.
  • 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.

A janela do editor mostra o layout de linha e coluna para sua origem DDS. Utilize esta visualização para ter uma idéia de como seus campos serão posicionados em relação um ao outro, se você fizer alterações com Alterar Posição e Alterar Extensão.

web settings
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.
web settings

Sintaxe (Alterar Posição):

A*%%WB 2 FLD <row_number> <column_number>

Sintaxe (Alterar Extensão):

A*%%WB 15 FLD <row_number> <column_number>

Sintaxe (Posição do CSS):

A*%%WB 21 FLD <row_number> +/-<pixel_offset> | <column_number> +/-<pixel_offset> | <disable_tabbing>
Nota: O deslocamento de pixels deve ser precedido por + ou -. O valor de disable_tabbing deve ser true ou false.

Exemplo (Alterar Posição):

A*%%WB 2 FLD 14 3

Exemplo (Alterar Extensão):

A*%%WB 15 FLD 1 1

Exemplo (Posição do CSS)

Para mover um campo de entrada até a linha 30, coluna 20 (sem nenhum deslocamento) e permitir a tabulação:

A*%%WB 21 FLD 30 +0 | 20 +0 | false

Para desativar a tabulação e mover um campo de entrada até a linha 40 e a coluna 10, com um deslocamento de 20 pixels para baixo e 5 pixels à esquerda, respectivamente:

A*%%WB 21 FLD 40 +20 | 10 -5 | true
Etiquetas de Opções

A definição Etiquetas de Opções está disponível para campos de entrada especificados com a palavra-chave VALUES. Os campos especificados com a palavra-chave VALUES são exibidos em páginas da Web como uma série de botões de rádio. 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.

Esta configuração da Web permite alterar a etiqueta ou texto exibido para o 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 esta configuração da Web, dê um clique duplo no campo Etiqueta de Opção e digite o texto desejado.

web settings

Sintaxe:

 A*%%WB 14 FLD <value>=<label>["|"<value2>=<label2>["|"<value3>=<label3>[...]]]

Exemplo:

Utilizando valores numéricos:

 A*%%WB 14 FLD 0=value 0|1=value 1

Utilizando valores de texto:

 A*%%WB 14 FLD 'value0'=value 0|'value1'=value 1
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" . O uso de Enviar para o Navegador permite que um campo H se torne parte do ambiente do navegador e que valores sejam designados a ele com base nesse ambiente. Por exemplo, o endereço IP de um usuário que é determinado por um script incluído com a definição Inserir no Script poderia ser utilizado para preencher o campo oculto.

web settings

Sintaxe:

 A*%%WB 19 FLD

Exemplo:

 A*%%WB 19 FLD

Especificando Variáveis de Substituição de Campos

As variáveis de substituição de campo são permitidas nas configurações da Web Inserir HTML, HTML Definido pelo Usuário, Imagem, Inserir Script, Ir para URL, Posicionar Cursor no Campo e Chamar JavaScript. Aqui estão as possíveis variáveis de substituição, incluindo as variáveis reprovadas (mas suportadas) para cada um:

&{FIELD.CURRENTVALUE}
Este é o valor atual de um objeto de campo HTML para um campo apto à entrada no registro atual, que pode ser modificado pela entrada do usuário no navegador ou está oculto, mas utiliza a configuração da Web Enviar para o Navegador.

A variável reprovada é &{FIELD.value}.

&{FIELD.INITIALVALUE}
Esse é o valor inicial a partir do tempo de execução do WebFacing para campos de entrada ou saída no registro atual.

A variável reprovada é &{FIELD.value}.

&{RECORD.FIELD.CURRENTVALUE}
Este é o valor atual de um objeto de campo HTML para um campo apto à entrada no registro especificado, que pode ser modificado pela entrada do usuário no navegador.

A variável reprovada é &{RECORD.FIELD.value}.

&{RECORD.FIELD.INITIALVALUE}
Esse é o valor inicial a partir do tempo de execução do WebFacing para campos de entrada ou saída no registro especificado.

A variável reprovada é &{RECORD.FIELD.value}.

&{FIELD.REF}
Esta é uma referência do objeto de campo HTML, por exemplo, document.SCREEN.l1_REC1$FIELD1. Destina-se apenas a campos de entrada ou a campos que estão ocultos mas utilizam a configuração da Web Enviar para o Navegador. Para campos apenas de entrada, utilize &{FIELD.ID}.

A variável reprovada é &{FIELD}.

&{FIELD.ID}
Este é um ID de campo HTML, por exemplo, l1_REC1$FIELD1. Destina-se a campos de entrada e de saída.

A variável reprovada é &{FIELD}.

&{RECORD.FIELD.REF}
Esta é uma referência do objeto de campo HTML no registro especificado. Destina-se apenas a campos de entrada. Para campos apenas de saída, utilize &{RECORD.FIELD.ID}.

A variável reprovada é &{RECORD.FIELD}.

&{RECORD.FIELD.ID}
Este é um ID de campo HTML no registro especificado. Destina-se a campos de entrada e de saída.

A variável reprovada é &{RECORD.FIELD}.

&{WEBFACINGFORMID}
Este é o valor do atributo de ID do formulário HTML no qual todos os campos residem. Pode ser utilizado para JavaScript customizado.

Utilizando valores especiais

Você pode utilizar valores especiais ao inserir um HTML definido pelo usuário com a definição Definido pelo Usuário em Substituições do HTML. Os valores a seguir podem ser utilizados no contexto da configuração da Web Definido pelo Usuário, nos campos correspondentes do DDS:

&{*SYSNAME}
Esse valor insere o nome do sistema no qual o aplicativo está em execução. Ele apenas pode ser utilizado no campo SYSNAME .

O valor reprovado é &SystemName.

&{*USER}
Esse valor insere o ID de usuário do usuário atual. Ele apenas pode ser utilizado no campo USER.

O valor reprovado é &UserID.

&{*DATE}
Esse valor insere a data do sistema atual. Ele apenas pode ser utilizado no campo DATE .

O valor reprovado é &Date.

&{*TIME}
Esse valor insere o horário do sistema atual. Ele apenas pode ser utilizado no campo TIME.

O valor reprovado é &Time.


Feedback