Home

Formulários

1. 5 2 2 3 C digo Esta se o re ne as propriedades relacionadas ao c digo gerado E C digo Script C digo E cido Tad Default ki C di o thtml E Sem Copyright O 2001 2006 E Gen Developer se 4 Reference Documentation 5 Formul rios Version 2 7 Script Defina como o c digo Javascript ser escrito Existem dois templates padr o 1 Lov Gera script de retorno de valores para blocos de relat rios em LOV Maiores informa es sobre LOV ver item 10 2 LOV lista de Valores 2 Client Validation Gera script de valida o no cliente em JavaScript baseado na propriedade Obrigat rio Not Null dos campos do formul rio Valida o Obrigat rio M JavaScript A lista de templates est baseada no arquivo de configura o JavaScriptTemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o Ver Item 11 5 do Cap 11 C digo C digo de script gerado pelo template Para customizar o c digo deixe o campo script em branco Template Determina como ser escrito o c digo do formul rio na p gina Existem 6 templates padr o 1 Default Gera o de c digo JSP default com utiliza o de tags Struts 2 Position Gera o de c digo JSP baseado em position sem uso de lt table gt A partir da VIEW o autor poder arrastar os objetos campos bot es etc e posicion los onde desejar 3 Clean Gera o de c
2. 4 Reference Documentation 5 Formul rios Version 2 7 Verifica tamb m as propriedades Par metro ld Param Id e Propriedade Par metro Param Property que s o utilizadas em conjunto Propriedade Nome de um atributo do objeto tipo Java Bean definido em Nome Parametro par metro Param Name a partir do qual o valor do par metro que ser passado no link ser resgatado Verificar tamb m as propriedades Par metro Id Param Id e Nome Par metro Param Name que s o utilizadas em conjunto Escopo Escopo em que deve estar salvo o objeto definido em Nome Par metro a Par metro Param Name O valor pode ser session ou request que significam que o objeto est salvo na se o ou na requisi o respectivamente Caso n o informado o objeto ser procurado na se o Escopo Especifica o do escopo em que ser o guardados os objetos processado durante a execu o do link Alvo Define onde deve ser aberia a p gina com o resultado da execu o do link A lista padr o cont m os seguintes alvos self Abre o resultado na mesma p gina janela blank Abre o resultado em uma nova p gina janela top Abre o resultado na mesma p gina desconsiderando qualquer frame janela interno parent Abre o resultado no frame em que est a janela atual iframe Abre o resultado dentro do objeto iframe identificado com o nome iframe A lista de al
3. 9 Reference Documentation 5 Formul rios W cadastro FOManualo EE Propriedades 2 EE Blocos E 5 2 1 1 Principal Nesta paleta principal o desenvolvedor poder visualizar os seguintes campos para configura o Projeto Nome identificador de todo o projeto Sub parte do projeto indica o diret rio pasta em que a p gina se M dulo localiza Nome f sico do arquivo Este nome servir de base para o JSP Nome Action e ActionForm a Caracter stica da aplica o Podendo ser FORM REPORT LOV P2 PAGE ou MENU Principal Layout C digo Info dd Principal F Projeto s Equipamento i M dulo q cadastro Mome q FOManualha Tipo Formul rio 5 2 1 1 1 Escopo Aqui ser configurado o Escopo onde ser o armazenadas as informa es O default session que guarda as informa es enquanto a se o do usu rio estiver ativa A outra op o request requisi o que guarda as informa es somente at a p gina de retorno ser aberta navega o poder n o funcionar corretamente se o escopo for request D gt D O Escopo Eao sessIon 5 2 1 1 2 Prote o Existem duas op es de Prote o Pattern J2EE Synchronized Token Caso ativado evita que o M ltiplos Cliques usu rio repita click s em uma a o antes que a mesma tenha seu retorno efetivo pi Ativado desabilita via JavaScript o bot o direito do mouse Esconder Codigo o Zi para visualiza
4. Check All Grid Lines Gera m todo Java com c digo para marcar todos os campos de checagem em um grid Utilizado apenas em formul rios com grid Uncheck All Grid Lines Gera m todo Java com c digo para desmarcar todos os campos de checagem em um grid Success Message Gera m todo Java com c digo para criar mensagem de sucesso Normalmente utilizado em triggers do tipo pos para informar ao usu rio que uma determinada a o foi executada com xito Fill Related Grid Fields Gera m todo Java com c digo para preencher todos os campos que fazem parte do relacionamento em um formul rio detalhe de uma p gina com relacionamento mestre detalhe Utilizado apenas em formul rios com grid Default Deprecated Template existente apenas para compatibilidade com vers es anteriores A lista de templates est baseada no arquivo de configura o Trigger TemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o C digo C digo gerado a partir da classe selecionada na propriedade Template Para efetuar a customiza o deste c digo deixe a propriedade Template em branco Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Mensagem Texto que ser inserido na classe Java para montagem de documenta o do tipo Javadoc Clique no cone para abrir a lista de valores que mostra as principais tags Javadoc e a de
5. EGEN HOME codefiles default uma sequ ncia padr o para todo o projeto At este momento poss vel clicar no bot o Voltar Back para corrigir qualquer defini o do bloco Clique no bot o para prosseguir para finalizar o bloco Clicando em Feshar Volte p gina principal do e Gen e verifique o que foi criado clicando no bot o Salvar Pronto ap s essas etapas acima descritas voc j pode visualizar como que ficou o formul rio criado e at utilizar o mesmo Para isso siga as seguintes instru es y A p gina principal do e Gen ficara configurada da seguinte maneira o M dulo Onde foi criado o bloco o Arquivo Nome do Formul rio o Bloco de Formul rio e nome da Tabela a qual o formul rio se relaciona Copyright 2001 2006 E Gen Developer Version 2 7 ES ro SD DV DO Abrir Todos Fechar Todos 9 Reference Documentation 5 Formul rios 4 cadastro FoManual i Propriedades A G E Blocos 5 B E Formul rio 4p JC bl form Te fornecedor E Pe a Menu sh a A Gr fico af Fa Gerar Gera o Compactada Pr via Inicio Atualizar v Clique em era para gerar e compilar a p gina JSP e tamb m as classes Action e ActionForm v Clique em tit ou 3 menu principal para iniciar a sua aplica o E o formul rio n o inicie corretamente voc dever reiniciar a aplica o no contexto do Container Para isso clique no bot o G l 5 1 3 Criando Manualmen
6. Fields que quando aberto mostra n o s os campos mas todos os elementos relacionados a cada campo e um acesso para a p gina de edi o geral das propriedades que veremos adiante 7 gt cadastro FOManualDe H 2 Propriedades 2 B gt Blocos E 6 gt Formul rio 4 F B gt bl_form_Te_fornecedor D j j jm Relacionamentos jaf a Abbas E o Propriedades do Grid F ar Propriedades Navegador h H 0 TAG Html Form E S Campos s Editar Todos os Campos E 2 ed fornecedor E x As propriedades independentemente do tipo de campo s o mantidas atrav s da p gina acessada utilizando o cone 1 localizado no n com o nome do campo Os elementos s o mantidos atrav s dos links dispon veis nos n s de cada elemento os quais ficam a um n vel abaixo do n do campo B cd fornecedor A x ar Set Properties F temo Relacionamento do Campo Veremos a seguir os tipos de campos detalhadamente mostrando as propriedades e elementos pertinentes a cada tipo Como v rias propriedades e elementos est o presentes em v rios tipos iniciaremos com o tipo text que o mais comum e depois mostraremos o que os demais tipos apresentam como espec fico 5 3 2 1 Tipos de Campos Os campos podem ser classificados de acordo com seu tipo Para cada tipo de campo existem propriedades e elementos espec ficos que determinam formas de visualiza o e funcionalidade diferentes Os principais tipo
7. o para vers es futuras ou altera es de framework Desta forma importante verificar antes de customizar um elemento se n o poss vel atender os requisitos de outra forma utilizando as propriedades existentes e recursos do gerador Em rela o a subse o Grade esta tem apenas uma propriedade referente posi o do campo com rela o ao Grid Copyright O 2001 2006 E Gen Developer 132 Reference Documentation 5 Formul rios Version 2 7 Tamanho do Grid Determina se o campo deve estar dentro ou fora do grid Deve se informar o valor 1 para o campo ficar fora do grid Se o campo estiver antes o primeiro campo do grid este aparecer antes do grid Caso contr rio ficar ap s o grid Como a sa da do campo do grid tem efeitos sobre a estrutura geral do bloco necess rio refazer a configura o da p gina Refactor Struts Config antes de rodar a aplica o Esta propriedade v lida somente se o formul rio implementar um Grid A se o Banco de Dados Database reune as propriedades que definem como os templates utilizar o os campos no c digo de comunica o com o banco de dados Banco de Dados Selec o r Inser o M r Altera o Operador dr f Consulta Sele o Informa se o valor do campo ser utilizado na clausula where do select do Bloco Em outras palavras define se o campo dever ou n o participar do filtro quando for acionada um
8. utilizado pela API Logging para facilitar a configura o de logging para diferentes n veis e tipos Normalmente segue um padr o de namespace tal como com egen A API Logging utiliza o namespace para criar hierarquia na configura o do logger Copyright O 2001 2006 E Gen Developer 164 Version 2 7 9 Reference Documentation 5 Formul rios Nivel Informa o n vel e o logging da mensagem que utilizado para filtrar as mensagens a serem impressas Os principais tipos s o FINE FINER FINEST N veis utilizados para informa es sobre o funcionamento da aplica o CONFIG Este n vel utilizado para mensagens est ticas de configura o Deve reportar por exemplo irregularidades que ocorrem na leitura de arquivos de configura o prefer ncias de usu rio etc INFO Utilize para mensagens de informa o WARNING Indica problema potencial Impresso apenas se o n vel for igual ou superior a WARNING SEVERE Indica falha s ria impresso sempre que o logging estiver ativo Usu rio Se marcado inclui nome do usu rio logado na mensagem de logging A o Se marcado inclui nome da a o do bot o na mensagem de logging Habilitar Se desmarcado n o inclui o c digo de logging na a o 5 3 3 6 Customizando o C digo dos Bot es Em bot es existem pontos de customiza o para o ajuste do c digo que escrito na p gina camada de vi
9. valida no calend rio Grupo Deve ser utilizada em mais de um campo do formul rio A valida o testa se pelo menos um dos campos tem valor n o nulo Restri o de Caixa Determina se o valor do campo deve ser transformado em caixa alta ou baixa na comunica o com a a o Min Tamanho Quantidade m nima de caracteres aceitos na digita o Max Tamanho Quantidade m xima de caracteres aceito na digita o Somente v lido para campos do tipo text password file Menor Valor Valor m nimo aceito na digita o Pode fazer refer ncia a um campo anterior do formul rio colocando se o nome do campo no lugar do valor Esta propriedade s tem funcionalidade para campos do tipo num rico e data Maior Valor Valor m ximo aceito na digita o Pode fazer refer ncia a um campo anterior do formul rio colocando se o nome do campo no lugar do valor Esta propriedade s tem funcionalidade para campos do tipo num rico e data Copyright O 2001 2006 E Gen Developer 125 Version 2 7 9 Reference Documentation 5 Formul rios Regex Valida o por Express es Regulares Regex Esta propriedade aceita uma senten a do tipo regex para efetuar valida o na informa o digitada Clique no cone para abrir a lista de valores com express es cadastradas no reposit rio de Regex do ambiente A valida o por Regex muito importante pois atende praticam
10. Customizado Quando o valor dessa propriedade marcado verdadeiro o c digo do campo deixa de ser gerado e o valor considerado para escrever o campo na p gina definido pelo valor da propriedade C digo JSP definida abaixo V lido somente para p ginas geradas por templates que utilizem essa propriedade Dentre os templates padr es Tabular n o utilizar o valor de C digo JSP para escrever o campo na p gina H um algoritimo pr prio no template para gerar a forma como o campo ser escrito C digo JSP Cont m o c digo JSP referente ao campo Pode se fazer altera o diretamente no valor dessa propriedade quando a propriedade Customizado est marcada valor verdadeiro Prefixo O valor dessa propriedade adicionado antes do c digo do campo quando a p gina escrita Essa propriedade foi criada para evitar customiza es no c digo do campo Sufixo O valor dessa propriedade adicionado ap s o c digo do campo quando a p gina escrita Essa propriedade foi criada para evitar customiza es no c digo do campo Clique no cone ao lado das propriedades C digo Prefixo e Sufixo para abrir o editor de c digo o qual facilita a edi o de textos grandes e importante observar que a customiza o de qualquer elemento aumenta o custo de manuten o da aplica o diminui o grau de padroniza o do c digo e dificulta a atualiza o da aplica
11. o do c digo fonte Prote o M ltiplos Clques Iv Esconder C digo C Copyright 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios 5 2 1 1 3 Status Aqui o desenvolvedor poder indicar o status em que se encontra o projeto podendo configurar em Inicial Intermedi rio Final ou Refatoramento C digo Indica o status da programa o da p gina Teste Indica o status dos testes da p gina Instala o Indica o status do disponibiliza o da p gina para a produ o Status C digo lnti Teste Initial gt Instala sollnitial Esses status s o apresentados na parte superior da p gina principal do e Gen Conforme figura abaixo No entanto para cada status existe uma cor diferente 5 2 1 2 Layout Na p gina de Layout o desenvolvedor poder est configurando os seguintes elementos Principal Layout C digo Info Layout LaS EU La sura B40 Gradel cel Padr o Rod a Padr o Localiza o e nome do arquivo de Cascade a ser utilizado pela p gina JSP Caso n o seja informado o arquivo style css ser utilizado Clicando no cone ser aberto o Editor de Folha de Estilos Neste editor poder ser escolhido um CSS entre uma lista j inclusa na distribui o do e Gen podendo ent o editar estes arquivos no pr prio editor Copyright O 2001 2006 E Gen Developer Reference Documentation Version 2 7 O Ar
12. para abrir uma lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Copyright O 2001 2006 E Gen Developer 128 9 Reference Documentation 5 Formul rios Version 2 7 Id do Estilo Cria um identificador para o elemento Ex id MeuCampo Faz refer ncia tag id do HTML 4 0 Tabindex Ordem sequencial que ser obedecida para navega o entre os elementos com a tecla TAB Caso n o seja configurada a sequ ncia ser a da exibi o na tela Faz refer ncia propriedade tabindex do HTML 4 0 Titulo Tool Tip mensagem que ser exibida quando o mouse se posicionar sobre o elemento Faz refer ncia propriedade title do Struts Chave do T tulo Tool Tip mensagem que ser exibido quando mouse se posicionar sobre o elemento A diferen a da propriedade acima que nesta deve se informar uma chave de internacionaliza o Esta chave ser convertida na mensagem final utilizando os recursos definidos no arquivo ApplicationResources properties Faz refer ncia propriedade titlekey do Struts Ne se o se aplica a todos os tipos de campos Por m existem algumas propriedades espec ficas de cada tipo de campo Es
13. Dessa forma a cria o de listas baseadas em tabelas ou arquivos externos enumera es se torna muito simples Clique no cone de adicionar L Ops es 49 lado do elemento que s aparecer abaixo do n de campos do tipo select abrindo a p gina de edi o e inclus o de Op es Options Para listas baseadas em tabelas ou vis es do banco de dados necess rio escolher um objeto do banco de dados Objeto BD Escolha as colunas do objeto que servir o como base para o valor e para o r tulo label de cada op o Cada registro do objeto deve gerar uma op o na lista Para listas baseadas em arquivos externos enumera es necess rio apenas escolher um arquivo lista na propriedade Nome do Arquivo File Name Esse arquivo deve ter em cada linha um conjunto de valor e r tulo label separados pelo sinal de igual Copyright O 2001 2006 E Gen Developer 104 Reference Documentation Version 2 7 5 Formul rios Enumera o Nome E Arquivo Clique em Salvar para finalizar a cria o do elemento Essas e outras propriedades espec ficas est o dispon veis na p gina de edi o do elemento que podem ser definidas de acordo com a tabela abaixo Bloco Nome do bloco ao qual o elemento est associado Propriedade somente para leitura Campo Nome do campo ao qual o elemento est associado Propriedade somente para leitura Objeto BD Objeto do b
14. fi E 03 Mar o A o4 abril 2 DX 05 Maio Bloco Nome do bloco no qual o elemento est inserido Propriedade somente para leitura Campo Nome do campo ao qual o elemento est associado Propriedade somente para leitura Posi o Ordem de visualiza o do elemento Valor Valor do item da Op o Esta informa o n o visualizada R tulo L R tulo do item da Op o Esta informa o visualizada na p gina Deve ser uma chave se a propriedade 118N n o estiver vazia I18N Informa se o r tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Ao lado esquerdo da propriedade existe um link para a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Padr o Determina qual o item da lista estar ativo quando a p gina sofrer uma submiss o Desabilitar Desabilita o item da Op o Neste caso na gera o da p gina a op o n o ser inclu da Normalmente utilizada para efeito de manuten o Copyright O 2001 2006 E Gen Developer 103 Q Reference Documentation Version 2 7 5 Formul rios Estilo Estilos que ser o utilizados para definir a visualiza o do elemen
15. gera o de c digo para o campo free seja criado facilitando a manuten o da aplica o e a padroniza o dos c digos Todos esses tipos de campos est o baseados em tags HTML com exce o do tipo Free tipo para inclus o de c digo livre no bloco O c digo pode estar baseado em templates Um exemplo o navegador padr o do e Gen Developer Esse campo free apresenta caracter stica que permite a renderiza o das tags referentes para o usu rio final Text a FR Textarea select z Radiol C Aberto Fechado CheckboxlD Img T C digo Local Do Do Do mi Do Iframe Link Link para outra p gina 5 3 2 2 Adicionando campos manualmente O processo de inclus o de campos no formul rio segue instru es parecidas com as de cria o de um bloco de formul rio conforme item 5 1 3 Pode se incluir alterar e apagar campos mesmo ap s a cria o do bloco Copyright 2001 2006 E Gen Developer 118 Version 2 7 9 Reference Documentation 5 Formul rios O acesso p gina de inclus o feito atrav s do link presente no n da rvore de objetos da p gina que agrupa os campos conforme figura abaixo 4 cadastro FoManualDl H 0 Propriedades E a Blocos E B Formul rio H Gg bl_form_Te_fornecedor x 5 L Relacionamentos 4 e Abbas dh jm Propriedades do Grid a 9 Propriedades Navegador S E TAG Html Form A ar Campos sh Clique no cone E para inic
16. o da p gina Data gerada automaticamente toda vez que o autor salvar ou gerar a p gina Usu rio que efetuou a ltima grava o ou gera o da p gina ltima Altera o Ap s todas as altera es clique em Salvar 5 2 2 Blocos de Formul rios Essas propriedades s o as respons veis pela defini o das caracter sticas gerais do bloco as quais est o definidas fora dos elementos que comp em o mesmo O acesso para manuten o das propriedades feito atrav s do cone de edi o A que est localizado ao lado do nome do bloco na rvore de objetos da p gina Copyright 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios kg cadastro FOManualoz m Propriedades Blocos E B Formul rio Fa O blform Te fornecedor Ed Abrindo a tela de manuten o das propriedades do bloco pode se observar que as propriedades est o dispostas em se es e em abas de forma seletiva a fim de facilitar a visualiza o 5 2 2 1 Principal Main Esta se o cont m as propriedades fundamentais do formul rio que definem basicamente como esse bloco ser identificado na p gina Principal Layout C digo Info E Principal 1 Blocos Blform Te forn Posi ol W bltom Te Titulo Cadastro i 7 1184 Nome do bloco Obrigat rio Ordem em que o bloco ser visualizado na p gina Titulo T tulo do bloco que ser exibido no cabe alho Deve ser uma c
17. o dispon veis apenas para compatilibilidade com vers o antigas do e Gen Todos esses templates est o marcados com a express o Deprecated A lista de templates est baseada no arquivo de configura o Action T emplateResources xml Para adicionar novos templates utilize o gerenciador de configura o Propriedade v lida apenas para bot es do tipo submit C digo C digo gerado pelo template Nos templates padr es esse c digo normalmente gerado em Java sendo inserido na classe Action Para customizar o c digo deixe a op o do select do template em branco Propriedade v lida apenas para bot es do tipo submit Copyright 2001 2006 E Gen Developer 153 Version 2 7 9 Reference Documentation 5 Formul rios Customizado Quando o valor dessa propriedade marcado verdadeiro o c digo do bot o deixa de ser gerado e o valor considerado para escrever o bot o na p gina definido pelo valor da propriedade C digo JSP definida abaixo V lido somente para p ginas geradas por templates que utilizem essa propriedade C digo JSP Cont m o c digo JSP referente ao bot o que ser inclu do na p gina Pode se fazer altera o diretamente no valor dessa propriedade quando a propriedade Customizado est marcada verdadeiro Clique no cone ao lado direito das propriedades C digo e C digo JSP para abrir o editor de c
18. 2001 2006 E Gen Developer 69 Version 2 7 9 Reference Documentation 5 Formul rios v Informe qual o tipo de p gina que voc estar criando Form Relat rio Menu ou Lov No entanto existem dois caminhos para se criar um formul rio 1 Utilizando o Wizard N o h d vida que a utiliza o do Wizard mais f cil e acelera o desenvolvimento 2 Utilizando as p ginas para inclus o individual de formul rios campos e bot es Este segundo caminho pode ser necess rio para p ginas muito complexas onde o Wizard n o contempla todas as especificidades que devem ser definidas no momento da cria o do bloco Dessa forma mostraremos a seguir as duas formas para a cria o de formul rios 5 1 2 Criando com Wizard Ap s a cria o da p gina clique no bot o Preme e ser iniciado o Wizard v A primeira p gina do Wizard traz a defini o do tipo de bloco que ser criado Formul rio Relat rio Menu ou Gr fico Marque a op o formul rio O Construa formul rios din micos com campos e bot es para acessar registros no banco de dados b a Disponibilize relat rios simples ou complexos Integra o com outras API atrav s de customiza o F cil acesso s p ginas criadas a partir do menu T Incremente sua p gina com nove tipos de gr ficos v Clique no bot o para prosseguir v Na segunda p gina faz se a escolha do objeto do banco de dados no qual o bloco ser bas
19. 2006 E Gen Developer 149 Version 2 7 9 Reference Documentation 5 Formul rios NM o desenvolvedor deseje inserir os bot es padr o em uma p gina basta apenas seguir as seguintes instru es v Clique no cone para adi o v Ser aberta a paleta de propriedades para adi o Siga atentamente o preenchimento de cada campo Selecione um exemplo na Lista de bot es v Quando um exemplo selecionado as propriedades da p gina s o automaticamente preenchidas v Clique no bot o Padr o para Inserir as informa es dos objetos v Volte p gina principal do e Gen clique em Saltar e verifique se os objetos foram criados na rvore do bloco 5 3 3 3 Editando as propriedades dos bot es As propriedades independentemente do tipo de bot o s o mantidas atrav s da p gina acessada atrav s do icone de edi o localizado no n com o nome do bot o Os elementos s o mantidos atrav s dos links dispon veis nos n s de cada elemento os quais ficam a um n vel abaixo do n do bot o conforme imagem abaixo E update action x il set Properties sh i Trigger gt Registro Essas propriedades tamb m podem ser acessadas e preenchidas manualmente zi Aten o para a propriedade Template Essa propriedade define a forma como o c digo da a o ser escrito Existem v rios templates na distribui o do e Gen capazes de gerar a es para selecionar inserir alterar del
20. 5 3 3 7 Acesso Direto as A es de Bot es poss vel executar chamadas diretas s a es definidas em um bot o para processamento de informa es antes de carregar uma p gina Um caso t pico a sele o de um registro antes de carregar a p gina para que a mesma j abra com todos os dados preenchidos Os templates padr es do e Gen geram a es baseadas na classe AbstractAction disponibilizada no pacote de utilit rios do e Gen Essa classe trata as requisi es identificando qual a o a ser executada atrav s do nome do bot o o qual tamb m passado na requisi o Para chamar uma a o diretamente preciso ent o informar o nome do bot o que identifica a a o na requisi o Por exemplo para chamar uma a o definida em um bot o cujo nome select action informamos na URL esse par metro da seguinte forma asp meuscryidor minha aplicacao modulo minha pagina dorsclect action Desta forma antes de minha_pagina jsp ser aberta o m todo perform select action ser executado 5 3 4 TAG lt form gt O elemento Tag lt form gt guarda as informa es necess rias para a gera o da tag lt form gt na p gina esta tag que define a a o a ser executada ao se submeter o formul rio Esse elemento faz refer ncia direta ao conceito em HTML e gerado pelos templates padr es utilizando a tag form definida em struts html tld Existem algumas propr
21. Ap s a altera o teremos meto 7 localhost 2080 meunodulo Minhakaginakrormn do select iet on cElcekrzab 20 Essa vari vel tamb m pode ser definida atrav s de campos ocultos quando o controle de visualiza o das abas for feito com mais intensidade Copyright 2001 2006 E Gen Developer 1 2 9 Reference Documentation 5 Formul rios Version 2 7 5 3 6 Grid de formul rios Para passar par metros para um formul rio em grid preciso informar a vari vel lines a que o campo pertence e a posi o do campo no grid Utilizamos colchetes para indicar a posi o sendo que na URL os mesmos devem estar codificados de acordo com a tabela ASC O colchete deve ser substitu do por B e o colchete por D Um exemplo de caso que preciso passar par metros na URL para um formul rio em grid quando chamamos uma p gina com um grid fazendo uma consulta com filtro baseado em campos do grid Nesse caso considerando que o bot o de sele o chama se select action e o par metro de filtro usuario ter amos a seguinte URL ameu modulo Minha Paginae de donrselccrlaciiorn Sollhiormmlcolos names ao ario BOOS D Esta URL indica que chamaremos o m todo select_action da a o mapeada como meu_modulo Minha_paginaGrid passando como par metro o campo usu rio da posi o 0 do grid contido no bloco bl form tb usuario 5 3 6 1 Editando as Propri
22. Conex o Sem Lones o Objeto Bpl Selecione y y Na parte final define se inicialmente o template Este indica como ser escrito o c digo JSP Um template customizado pode ser usado no lugar do padr o A lista de templates depende de que tipo de bloco se est trabalhando A lista est baseada nos seguintes arquivos FormTemplateResources ReportTemplateResources Menu TemplateResources e ChariBlock TemplateResources localizados na pasta config Em seguida define se se haver Navegador no formul rio Se a op o for verdadeiro marcado uma estrutura de navega o de registros ser adicionada ao Bloco esta estrutura pode ser adicionada posteriormente bem como customizada No campo Tamanho Padr o do Grid informa se haver grid Este campo determina quantas linhas ter o Database Grid No campo Campo Checagem da Grade se a op o for verdadeiro marcado inclui campo checkbox gridCheckField Clique no bot o para prosseguir 5 2 Propriedades 0 2 1 Gerais Esta propriedade tem como objeto facilitar a de manuten o das propriedades gerais do objeto Generator Este o objeto que guarda todas as propriedades que o desenvolvedor define para uma p gina No processo de gera o o objeto Generator aplicado aos templates que escrevem o c digo a ser compilado Clique no cone para acessar a paleta de propriedades Copyright O 2001 2006 E Gen Developer Version 2 7
23. Estilo Id do Estilo TabIindex Titulo Chave Titulo Src Caminho relativo para a imagem que deve ser exibida no lugar do bot o padr o Clique no cone para abrir a lista com todas as imagens dispon veis no diret rio img da aplica o Tecla de atalho Atalho de teclado que pode ser definido para o campo Deve se informar apenas o caractere Ex a ou 1 Acessa se o atalho teclando ALT caractere Somente v lido para campos do tipo text password textarea checkbox select radio e img Faz refer ncia propriedade accesskey do HTML 4 0 Clique no cone para abrir o teclado para auxiliar a defini o da Copyright O 2001 2006 E Gen Developer 156 4 Reference Documentation 5 Formul rios Version 2 7 tecla Doo ae a E Do pl E E DT U I F i Fi 5 DD F 6G H J K aaen Z SIE Y B No M i f Desabilitar Se marcada torna o bot o desabilitado Faz refer ncia propriedade disable do HTML 4 0 Estilo Estilos que ser o utilizados para definir a visualiza o do elemento Faz refer ncia propriedade style do HTML 4 0 Clique no cone para abrir a lista com todas as propriedades de estilo no HTML 4 0 mostrando os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir a lista com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores
24. O insert action x H 0 update action x Para alterar uma propriedade em todos os bot es necess rio apenas preencher a propriedade com o novo valor e clicar no cone E Editar Todos os Bot es localizado esquerda de cada campo de propriedade N o h como fazer uma altera o seletiva apenas para determinados bot es Assim como na paleta de propriedades para inclus o dos bot es existem as quatro principais se es Principal Layout Evento e Info n o diferente na paleta de propriedades para Editar todos os Bot es de uma s vez Neste sentido as mesmas propriedades e configura es que podem ser feitas na paleta de inclus o tamb m podem ser feitas na de edi o de todos os campos No entanto para facilitar o acesso a cada propriedade clique nos links abaixo e veja os detalhes de edi o Principal Principal Dire o Valida o Posi o Estilo Layout Evento Evento Info Ajuda Notas do Desenvolvedor Controle de Acesso 5 3 3 5 Elementos dos Bot es Existem caracter sticas dos bot es que s o mais complexas do que uma simples propriedade Essas caracter sticas s o tratadas no e Gen como elementos permitindo a associa o de estruturas complexas Objetos com grande facilidade de extens o Veremos a seguir detalhadamente os elementos associados aos bot es sendo que Triggers e Registro Logging somente se aplicam ao tipo submit Para identificar esses el
25. apresentadas as seguintes informa es Principal JavaScript E Principal Blocos blform Te equip Campos Cd equipamento Ga Om Bloco x Nome do bloco ao qual o objeto est associado Esta propriedade apenas para leitura Campo Nome do campo ao qual o objeto est associado Esta propriedade tamb m apenas para leitura A o a Link propriedade href que ser inclu do no evento onClick do bot o de chamada da p gina LOV O link costuma ser relativo a presente p gina lov Clique no bot o para abrir a lista das p ginas LOV criadas anteriormente na aplica o no m dulo lov Nessa lista poss vel selecionar a p gina LOV desejada Pode se tamb m escolher que m todo deve ser executado dessa p gina quando for executada Copyright 2001 2006 E Gen Developer 90 Version 2 7 4 Reference Documentation 5 Formul rios Normalmente executa se ou o m todo select quando se quer entrar com a lista preenchida ou o m todo resetfull quando se deseja entrar com a lista vazia low iDemo D9 D6Lov sp select resetfull cslovsListaFornecedorLov sp select resetfull Estilo R tulo gt Estilo Classe do Estilo lovButton Barra de ng Rolagem E Altura 210 Largura 30 Topo 0 Esquerda R tulo Texto que ser exibido no bot o que escrito para dar acesso ao link para a p gina da LOV Estilo Estilos que ser o utilizados para definir a visualiza o do element
26. atalho Ex a ou 1 Acessa se o atalho teclando ALT caractere Somente v lido para campos do tipo text password textarea checkbox select radio img a Identifica o do arquivo que ser visualizado Somente para campos do tipo img Altura determinada para o arquivo de imagem Altura Somente para campos do tipo img iframe e applet Largura determinada para o arquivo de imagem Largura Somente para campos do tipo img iframe e applet Ativa a propriedade DISABLE do HTML para o campo Campos Desabilitar com a propriedade DISABLE NAO s o repassados para o servlet Determina como ser a sele o em um elemento tipo select Se for M ltiplo configurada para true o usu rio poder marcar v rias op es Somente para campo do tipo select Propriedade padr o HTML do R tulo do campo Ativa a propriedade READONLY do HTML para o campo Campos Somente Leitura com a propriedade READONLY s o repassados para o servlet Somente v lido para campos do tipo text password textarea E Determina se o campo password sofrer redisplay Somente para AA campos password Em um campo marcado como Obrigat rio ser exibido por default Sre um do lado direito do r tulo Esta propriedade troca o pela imagem que estiver definida Elemento de formata o na pr pria linha da Tag Utiliza o padr o de Estilo escrita CSS ERES Ceras Classe do elemento Esta classe deve estar definida dentro do HTM
27. baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone s para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties NE se o se aplica a todos os tipos de bot es 5 3 3 3 4 2 Notas do Desenvolvedor A se o Notas do Desenvolvedor re ne as propriedades que definem informa es para a documenta o de desenvolvimento Notas Desenv 7 Mensagem Es REA Mensagem Texto que ser inserido na classe Java para montagem de documenta o do tipo Javadoc z Cd i i i Clique no cone para abrir a lista de valores que mostra as principais tags Javadoc e a descri o de cada uma Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Copyright O 2001 2006 E Gen Developer 159 Version 2 7 9 Reference Documentation 5 Formul rios IE se o se aplica a todos os tipos de bot es 5 3 3 3 4 3 Controle de Acesso A se o Controle de Acesso Access Control reune as propriedades que definem restri es de acesso ao elemento Controle de Acesso Pap is Eu Pap is Determina qual is role s ser o utilizada s para seguran a do Roles elemento Caso o usu rio n o possua a role espec fica o elemento n
28. com base no arquivo config ButtonExampleResources xml Propriedades Nome da Action ao qual o bot o est associado Determina que tipo de bot o ser escrito no HTML Submit Button ou Tipo HTML Reset O tipo Button n o possui a o Normalmente associado a ele um evento Javascript Copyright O 2001 2006 E Gen Developer 147 Version 2 7 7 R tulo do bot o na p gina que corresponde propriedade value do alors HTML Informe se o T tulo ser internacionalizado a partir de um arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta 118N Clique no cone para acessar a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo 4 Reference Documentation 5 Formul rios ApplicationResources properties Dire o Identifica para qual dire o forward ser efetuado o retorno da a o Normalmente o retorno da a o para same mesma p gina Dire o O desenvolvedor pode alterar esta informa o direcionando o retorno da a o para outra p gina Pode tamb m optar por colocar um retorno padr o mapeado na configura o do Struts ou um caminho relativo tal como seumodulo SuaPaginaForm jsp codigo Identifica para qual dire o forward ser efetuado o retorno do erro Normalmente o retorno do er
29. das propriedades clique no bot o stemar para que as propriedades sejam copiadas para este campo Clique aqui para maiores detalhes destas propriedades Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no cone para abrir a lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Id do Estilo Cria um identificador para o elemento Ex id MeuCampo Faz refer ncia tag id do HTML 4 0 Tabindex Ordem sequencial que ser obedecida para navega o entre os elementos com a tecla TAB Caso n o seja configurada a sequ ncia ser a da exibi o na tela Faz refer ncia propriedade tabindex do HTML 4 0 Titulo Tool Tip mensagem que ser exibido quando mouse se posicionar sobre o elemento Faz refer ncia propriedade title do Struts Chave do T tulo Tool Tip mensagem que ser exibido quando mouse se posicionar sobre o elemento A diferen a da propriedade acima que nesta deve se informar uma chave de internacionaliza o Esta chave ser convertida na mesnagem final utilizando os recursos definidos no arquivo ApplicationRe
30. digo o qual facilita a edi o de textos grandes e importante observar que a customiza o de qualquer elemento aumenta o custo de manuten o da aplica o diminui o grau de padroniza o do c digo e dificulta a atualiza o da aplica o para vers es futuras ou altera es de framework Desta forma muito importante verificar antes de customizar um elemento se n o poss vel atender os requisitos de outra forma utilizando as propriedades existentes e recursos do gerador ver item 5 3 2 6 5 3 3 3 1 2 Dire o A se o Dire o re ne as propriedades que definem para qual p gina deve seguir o usu rio ap s a execu o da a o O conceito de dire o est relacionado com o conceito no framework Struts Dire o Dire o Same Dire o do Erro sannme Dire o Identifica para qual dire o ser efetuado o retorno da a o Inicialmente o retorno da a o para a mesma p gina identificada por uma dire o chamada same Pode se alterar esta propriedade direcionando o retorno da a o para outra dire o mapeada a princ pio na configura o do Struts tamb m poss vel utilizar um caminho relativo tal como seumodulo SuaPaginaForm jsp codigo Dire o do Erro Idem da propriedade acima Dire o sendo que ser utilizada somente se ocorrer algum erro durante a execu o da a o e se o se aplica apenas aos bot es do tipo submit Copyrigh
31. digo JSP para um formul rio sem formata o Ideal para uso em conjunto com Templates de HTML Externos 4 Abas Gera o de c digo JSP de um formul rio para trabalhar com Abas Deve se anteriormente customizar a posi o dos campos nas Abas 5 Columns Gera o de c digo JSP de um formul rio que possuir v rias lt TD gt 6 Tabular Gera o de c digo JSP de formul rio para trabalhar com Grid organizando todos os campos em uma linha A lista de templates est baseada no arquivo de configura o FormTemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o Ver Item 11 5 do Cap 11 C digo C digo JSP gerado pelo template escolhido no campo Template Para customizar o c digo gerado deixe o campo Template em branco e lado das propriedades de c digo existe existe o bot o que abre o editor de c digo o qual facilita a edi o de textos grandes importante observar que a customiza o do bloco aumenta consideravelmente o custo de manuten o da aplica o diminui o grau de padroniza o do c digo e dificulta a atualiza o da aplica o para vers es futuras ou altera es de framework Copyright O 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios L Desta forma muito importante verificar antes de customizar um elemento se n o poss vel atender os requisitos de outra forma utiliz
32. edi o e inclus o de Grupo Group 5 SS cd equipamentol E 2 zr Set Properties p o Informe as propriedades Valor Quando este for configurado para true R tulo do bot o de r dio Deve ser uma chave caso a propriedade 118N n o estiver vazia o Clique no bot o fnserir ap s a inser o de todos os sub elementos do grupo preciso salvar a p gina para visualizar os mesmos abaixo do n do elemento na rvore de objetos da p gina Fi o Os links para edi o e dele o desses sub elementos estar o ao lado de cada um dos mesmos o Na p gina de inclus o e edi o de elementos do Grupo Group existem algumas propriedades para definir aspectos espec ficos de cada sub elemento Copyright O 2001 2006 E Gen Developer 108 9 Reference Documentation 5 Formul rios Version 2 7 Principal dd Principal t Blocos blform Te equip Campos Cd equipamentol W Posi o 1 valors 10 E tulos 10 1184 Padr o O Bloco Nome do bloco no qual o elemento est inserido Propriedade somente para leitura Campo Nome do campo ao qual o elemento est associado Propriedade somente para leitura Posi o Ordem de visualiza o do elemento Valor Determina o valor do bot o de radio quando este for configurado para true verdadeiro R tulo Determina o r tulo do bot o de r dio Deve ser uma chave se a propriedade 118N n o estiver vazia 118N
33. iframe localizadas na p gina de edi o de propriedades de campos Na se o Layout encontramos as seguintes propriedades Principal Layout C digo Evente abas tabi l Quebra Linha Iv E Estilo SPC Altura Largura Altura Altura determinada para o iframe Largura Largura determinada para o iframe Copyright O 2001 2006 E Gen Developer 111 Q Reference Documentation 5 Formul rios Tamb m na se o Espa o Frame existem propriedades espec ficas para esse tipo que servem basicamente para preencher propriedades definidas na tag lt IFRAME gt do HTML Espa o Nome do Espa o Descr Longa Borda do eaol Padr o l Largura da Margem Altura da Margem Relagemj to F Nome do Espa o Indica o nome do iframe Descr Longa Valor da propriedade longdesc da tag iframe Borda do Frame Determina o tamanho da borda do iframe Largura da Margem argura da margem da p gina dentro do iframe Altura da Margem Altura da margem da p gina dentro do iframe Rolagem Determina se o iframe ter barra de rolagem A utiliza o de iframe interessante para mostrar mensagens imagens ou p ginas din micas sem a necessidade de reler a p gina constantemente tipo associado a iframe em HTML Link O tipo link representa uma liga o na p gina A defini o est diretamente relacionada com o conceito de
34. link em HTML implementado atrav s da tag lt A gt e gerado pelos templates padr es utilizando a tag link definida em struts html tld Existem algumas propriedades espec ficas para o tipo link localizadas na se o Link da p gina de edi o de propriedades de campos Liga o R tulo 1184 I Sr P a O ncora Dire o Href Indexado P gina Id do Par metro Nome do Par metro Propriedade do Faram Escopo do Par m Escopo alvo Sel Transacional Copyright 2001 2006 E Gen Developer 112 Reference Documentation Version 2 7 R tulo 5 Formul rios Texto inserido na p gina sobre o qual deve se clicar para acionar o link Deve ser uma chave se a propriedade 118N n o estiver vazia I18N Informa se o r tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Src Imagem que pode ser apresentada no lugar do r tulo label para ativar o link Clique no cone para abrir uma lista com todas as imagens dispon veis no diret rio img da aplica o A o Caminho relativo aplica o pa
35. o entre palavras Ajusta o n mero m nimo de linhas para um par grafo que priania deve estar esquerda e abaixo de uma p gina Ajusta o tipo de ordena o de marcas deve ser renderizada mang fora da caixa da p gina Ajusta o tipo da p gina a ser usada quando visualizar um elemento U Page Break Aiter Ajusta a quebra de p gina ap s de um elemento Page Break Before Ajusta a quebra de p gina antes de um elemento Page Break Inside Ajusta a quebra de p gina dentro de um elemento Size Ajusta a orienta o e tamanho de uma p gina Ajusta o n mero m nimo de linhas para um par grafo que Widows R e deve ser esquerda no topo da p gina O Q D Azimuth Ajusta onde os sons vozes deve vir horizontalmente um propriedade resumo para ajustar as propriedades cue before e cue after em uma declara o Cue After Especifica um som a ser tocado ap s a fala o D Ol Copyright 2001 2006 E Gen Developer 4 Reference Documentation 5 Formul rios Version 2 7 Especifica um som a ser tocado antes do som Elevation Ajusta de onde sons vozes devem vir verticalmente pause after properties in one declaration k m speak Especifica como n meros s o tocados Numeral Speak Especifica como s o tocados caracteres de pontua o Punctuation Speech Rate Especifica a velocidade de reprodu o Stress Especifica o stress no som tocado Um lista pr
36. propriedade 118N n o estiver vazia I18N Informa se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Coluna Coluna do objeto do banco de dados que o campo faz refer ncia Quando existe essa refer ncia os templates padr es criam todo o c digo de integra o Tipo HIML Tipo HTML do elemento na p gina O tipo define as caracter sticas b sicas do elemento As op es de tipo s o text select radio checkbox textarea password hidden img iframe free applet link e file Copyright O 2001 2006 E Gen Developer 123 9 Reference Documentation 5 Formul rios Version 2 7 Tipo JDBC Tipo Java JDBC para convers o de tipos SQL Os tipos Java dispon veis s o java lang String int double java sgl Date java sql Timestamp java sgl Time java util Date long bytell boolean java lang Integer java lang Double java lang Long java math BigDecimal java sqgl Array java sgl Blob java sql Clob java sqgl Struct java sgl Ref e java lang Object A chave de identifica o de todos os campos bloco e nome
37. tag Options do Struts o valor ser utilizado na propriedade labelProperty Estilo Estilos que ser o utilizados para definir a visualiza o do elemento Faz refer ncia propriedade style do HTML 4 0 Clique no cone para abrir a lista com todas as propriedades de estilo no HTML 4 0 mostrando tamb m os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir a lista com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades e clicando no bot o Fetarmar as propriedades ser o copiadas para o campo Clique aqui para detalhes sobres essas propriedades Classe de Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no cone para abrir a lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Copyright O 2001 2006 E Gen Developer 106 Reference Documentation Version 2 7 Template 5 Formul rios Determina como o c digo do elemento ser gerado Templates padr es Default Gera c digo Java para ser inclu do na classe ActionForm padr o Struts No c digo
38. todos os campos de um bloco principal master como tipo hidden E utilizado para manter valores dos campos do bloco principal quando s o efetuadas a es a partir do bloco detalhe detail A lista de templates est baseada no arquivo de configura o FreeField TemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o C digo C digo gerado pelo template Nos templates padr es esse c digo normalmente gerado em JSP Java em scriptlet para inser o em JSP ou HTML com JavaScript Para customizar o c digo deixe a op o do select do template em branco Script C digo livre para escrita de JavaScript Todo o c digo escrito nesse campo ser inclu do dentro de tags lt SCRIPT gt de acordo com a defini o dos templates padr es Clique no cone o editor de c digo o qual facilita a edi o de textos grandes Copyright O 2001 2006 E Gen Developer 117 9 Reference Documentation 5 Formul rios Version 2 7 Para observar como um campo do tipo configurado verifique o campo com nome ge navigator criado automaticamente em formul rio que t m navegador O campo free segue um dos princ pios do e Gen que n o restringir o desenvolvedor a padr es pr formatados Com este campo poss vel incluir qualquer c digo na p gina No entanto se existir um padr o para o c digo inclu do interessante que um novo template para
39. A 4N h Copyright O 2001 2006 E Gen Developer Version 2 7 roup By clausula GROUP BY da consulta pode ser modificada inserindo uma express o nesta propriedade com seguinte sintaxe COLUNA_1 COLUNA_2 COLUNA Nasa 9 Reference Documentation 5 Formul rios Having A clausula HAVING da consulta pode ser modificada inserindo uma express o nesta propriedade com a seguinte sintaxe COLUNA GROUP 1 COLUNA GROUP gt 10 3 COLUNA GROUP OPERADOR VALOR e lado das propriedades select where order by group by e having existe o link para abertura da tela de ajuda para sintaxe Nesta tela mostrada a sintaxe correta para cada um dos campos IE outro lado dessas propriedades select where order by group by e having existe o bot o que abre o editor de c digo o qual facilita a edi o de textos grandes Maiores detalhes sobre a sintaxe para cria o das cl usulas de sele o podem ser verificados no Cap tulo 4 sobre a camada de comunica o com o banco de dados JdbcUtil 5 2 2 2 Layout Esta se o cont m propriedades de layout do formul rio que definem basicamente como se apresentar esse bloco na p gina 5 2 2 2 1 Mensagem A se o Mensagem Message reune as propriedades que configuram as mensagens do cabe alho e banner dd Mensagem Tipol Fadr o Texto Tipo do Cartazl Logo Tipo da mensagem inserida abaixo do t tulo
40. HTML diret rio conf da ferramenta Informa se a mensagem ser internacionalizada a partir do arquivo selecionado I18N A z n W 5 A lista est baseada no arquivo PropertiesResources xml localizado no Ap s o preenchimento das propriedades sendo o campo baseado ou n o no banco de dados clique no bot o Inserir para adicionar o campo ao bloco Copyright 2001 2006 E Gen Developer 121 9 Reference Documentation 5 Formul rios Version 2 7 Existe tamb m a possibilidade de inserir automaticamente todos os campos listados em Campos BD DB Fields Para essa a o clique no bot o Inserir Todos Os campos ser o inclu dos utilizando os valores definidos no mapeamento do objeto 5 3 2 2 2 Mostrar A p gina de inclus o possui uma aba que mostra todos os campos inseridos Clique em Mostrar Show para acessar essas informa es Principal Mostrar Lista nr fornecedor cd fornecedor nu Cep nu ddd nu fone nu fax AU COC dt cadastro dt transf nm endereco nm complemento nr balrro nm cidade co uf nr fantasia nr contato e a inclus o de todos os campos clique em Saltar para que salve todas as informa es no bloco que est sendo desenvolvido Ap s essa a o todos os campos aparecer o na rvore de desenvolvimento conforme figura abaixo W cadastro FoManualol H 0 Propriedades E B E Blocos B Formul rio 4 5 bl_form_Te_fornecedor Ed ar Relaciona
41. Increment um seletor Counter Reset Limpa o valor do contador em cada ocorr ncia de um seletor Quotes Ajusta o tipo de marcas List Market Propriedade abreviada para configurar em uma declara o eSti are list style todas as propriedades relacionadas lista List Style ade Ajusta uma imagem como o marcado da lista List Style Ajusta onde o marcado da lista colocado na lista Position 6d 4 Reference Documentation 5 Formul rios Version 2 7 aid 0 Ajusta o tipo de o marcado da lista ype Mapia Propriedade abreviada para configurar em uma declara o JIN todas as propriedades relacionadas margem om todas as propriedades relacionadas ao contorno Padding Propriedade abreviada para configurar em uma declara o Padding todas as propriedades relacionadas ao padding Padding 4 a 3 Ajusta o padding inferior de um elemento Padding Left Ajusta o padding esquerdo de um elemento Padding Right Ajusta o padding direito de um elemento Padding Top Ajusta o padding superior de um elemento Ajusta qu o longe o limite inferior de um elemento est Bottom i re acima abaixo o limite inferior do elemento pai ci Ajusta o formato de um elemento O elemento ajustado no P seu formato e mostrado en Ajusta qu o longe o limite esquerda de um elemento est direita esquerda de o limite esquerda do elemento pai OVEN Ajusta o que acontece se o conte do de
42. Informa se o r tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Padr o Esta propriedade determina qual bot o estar marcado quando a p gina for carregada Entre todos os bot es de r dio apenas um deve estar marcado como padr o v Checkbox O tipo checkbox representa um elemento visualizado como um campo de checagem A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag checkbox definida em struis html tld o Existe apenas uma propriedade espec fica para o tipo checkbox localizada na se o Layout da p gina de edi o de propriedades de campos Copyright O 2001 2006 E Gen Developer 109 9 Reference Documentation 5 Formul rios Version 2 7 Principal Layout C digo Evento Estilo abas tab u Quebra Linha Iv gt arredondam rE E TT Inicio y valor E a valor Falso Valor Falso Valor do campo quando o mesmo estiver desmarcado Quando n o especificada o valor do campo quando desmarcado false booleano Em HTML esse va
43. L ou em arquivo separado que utiliza o padr o de escrita CSS Cria um identificador HTML para o elemento Ex id MeuCampo Ordem sequencial que ser obedecida para navega o entre os Tabindex elementos com a tecla TAB Caso n o seja configurada a sequ ncia ser a da exibi o do HTML OO Tool Tip que ser exibido quando mouse se posicionar sobre o elemento Tool Tip que ser exibido quando mouse se posicionar sobre o Chave do T tulo elemento Esta propriedade possui internacionaliza o a chave ser convertida a partir do arquivo ApplicationResources properties Copyright O 2001 2006 E Gen Developer 139 9 Reference Documentation 5 Formul rios Version 2 7 5 3 2 4 2 2 R tulo Posi o em que o r tulo ser visualizado no HTML em rela o ao R tulo pos campo Por default o r tulo posicionado ao lado esquerdo do campo A op o nenhum retira o r tulo da visualiza o Bg Color Cor de Background que ser exibida para o r tulo Fg Color Cor de frente que ser exibida para o r tulo ER A Tipo de fonte que ser aplicada ao R tulo Por default o fonte definido no arquivo style css Tamanho do fonte Obedece a padr es HTML Alinhamento do r tulo em rela o a Tag lt TD gt O tamanho da Tag lt TD gt definido no arquivo style css na classe formLabel esta Alinhamento j que propriedade desloca o r tulo para e centro direita ou start O que e
44. L ou uma caixa de di logo Copyright O 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios confiada Default sim Tollbar Indica se a janela ter barra de ferramentas Default sim A LOV tamb m apresenta os elementos retornos par metros e set properties E Campos fe L Editar Todos os Campos A H 0 cd_fornecedor E x Os retornos returns definem para qual campo s da tela a p gina LOV retornar os valores Na cria o da LOV inclu do automaticamente o campo a qual pertence a LOV como o retorno O return0 No entanto poss vel mudar essa defini o padr o ou incluir novos retornos Por exemplo quando queremos retornar o c digo do elemento e a descri o inclu mos um retorno que faz a liga o com o campo de c digo e outro para o campo de descri o A defini o da sequ ncia de retorno deve respeitar a forma como a p gina LOV foi feita j que a sequ ncia definida nesta de acordo com a posi o da coluna no relat rio ver mais sobre esta quest o no cap tulo sobre P ginas Complexas se o LOV Os par metros s o informa es passadas da p gina corrente para a p gina LOV para efetuar algum filtro Por exemplo podemos passar para um LOV para encontrar o CPF de uma pessoa a cidade em que a pessoa foi cadastrada de forma a filtrar previamente a lista de pessoas Para associar valores definidos nos campos em uma p gina HTML utiliza se a segu
45. Layout da p gina de edi o de propriedades de campos Ademais a propriedade Tamanho Size determina neste tipo o n mero de linhas da lista que ser visualizado Quando a propriedade Multiplo Multiple est marcada verdadeiro o tamanho deve ser maior que um para permitir que mais de um elemento seja visualizado H tamb m para esse tipo dois elementos que definem como a lista de op es formada Descrevemos abaixo como e quando trabalhar com cada um deles Multiplo Determina como ser a sele o em um elemento tipo select Se for configurada para verdadeiro true o usu rio poder marcar v rias op es Somente para campo do tipo select Copyright O 2001 2006 E Gen Developer 101 Version 2 7 9 Reference Documentation 5 Formul rios Principal Layout C digo Evento Estilo Tamanho 40 abas tabi l Quebra Linha M rredondam amhare Inicio y Tecla de atalho Desabilitar E M ltiplo verdadeiro o Op o Option um elemento utilizado para definir individualmente cada elemento da lista Normalmente utilizado para listas pequenas e fixas Os templates padr es geram a partir desse elemento um c digo utilizando a tag option do Struts que inserida dentro da tag select ambas definidas em struts himl tld Para incluir esse elemento clique no cone de adicionar L Op o 4 ao lado do elemento s aparecer abaix
46. Pode ser Padr o Nenhuma Mensagem Erro ou Customizada Aqui pode ser escrito o texto a ser mostrado na mensagem abaixo do t tulo O texto somente ser mostrado se o tipo for customizado Ex Na figura abaixo veja onde se encontra o texto Teste do Campo Copyright O 2001 2006 E Gen Developer Reference Documentation 5 Formul rios Version 2 7 Texto Manual Primeiro Formul rio Teste do Campo Texto Manual cd marca nmmarcasbo Koa o gt Total 0 Tipo do Cartaz Tipo do cartaz banner mostrado na parte superior do bloco Existem 4 Tipos 1 Logo e Gen Developer 09 02 2006 17 50 30 9 Cadastroll Teste do Campo Texto Manual Menu Sair Imprimir 2 Portlet e Gen Developer Daf0z 2006 17 52 09 Cadastro01 EE Teste do Campo Texto Manual Menu Sair Imprimir 3 Vazio e gen Developer Daf02 2006 17 52 49 Cadastro0l1 Teste do Campo Texto Manual Menu Sair Imprimir 4 Sem Cartaz e Gen Developer 09 02 2006 17 53 21 Teste do Campo Texto Manual Menu Sair Imprimir 5 2 2 2 2 Configura o de Layout A se o Layout re ne as propriedades que configuram como o formul rio ser mostrado na p gina Layout N mero der A Colunas Abas tabl Largura bi Posic ol Padr o z Mostrar Errol Form Hg Copyright O 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios N mero de Informa o n
47. Quantidade m nima de caracteres aceitos na digita o Quantidade m xima de caracteres aceito na digita o Somente Max Tamanho v lido para campos do tipo text password file Copyright O 2001 2006 E Gen Developer 137 4 Reference Documentation 5 Formul rios Version 2 7 ENE Valor m nimo aceito na digita o Esta propriedade s tem funcionalidade para campos do tipo num rico e data ER E Valor m ximo aceito na digita o Esta propriedade s tem funcionalidade para campos do tipo num rico e data Valida o por Express es Regulares Esta propriedade aceita uma Regex senten a do tipo regex para efetuar valida o na informa o digitada O autor pode cadastrar suas pr prias express es em tela espec fica 5 3 2 4 2 Layout 5 3 2 4 2 1 Estilo Tamanho do campo no HTML Segue padr o HTML Ex 10 10pt Tamanho 10px Aplicado para campos do tipo text password select e file e Quantidade m xima de caracteres permitido no campo Aplicado Tamanho Maximo para campos do tipo text password e file Se esta propriedade for configurada para true o campo ser simplesmente exibido no HTML Escrita Esta propriedade se difere de readonly visto que a caixa de entrada para o campo n o montada apenas seu conte do exibido Ene Informa em que TAB o campo ser visualizado Por default todos os campos ser o visualizados na TAB O ME E Define a organiza o dos elementos na p gina
48. Se marcado o pr ximo elemento ser mostrado na linha seguinte Formato a ser aplicado na informa o do elemento Baseado na API Java de Arredondamento pode se configurar o tipo Arredondamento de convers o que o valor sofrer Existe Ajuda espec fico para esta propriedade referente aos tipos de arredondamento poss veis Eee Determina a quantidade de colunas para o campo Somente v lido para campos do tipo textarea Es Determina a quantidade de linhas para o campo Somente v lido para campos do tipo textarea Valor inicial do campo Se preenchida seu valor ser utilizado no VE e lugar do valor retornado pela a o ap s uma submiss o Est propriedade padr o HTML Aplicado para campos do tipo text password textarea checkbox radio hidden free e file No tipo de campo Checkbox esta propriedade ser utilizada quando Valor Falso o campo estiver desmarcado Quando o campo estiver marcado a propriedade Valor ser utilizada Somente para campos Checkbox Alinhamento do valor em rela o ao tamanho do campo O tamanho l do campo e definido na propriedade Tamanho esta propriedade Alinhamento a 5 o desloca o valor para esquerda centro direita ou start Est definido no arquivo style css Copyright O 2001 2006 E Gen Developer 138 4 Reference Documentation 5 Formul rios Version 2 7 Atalho de teclado que pode ser definido para o campo Deve se informar apenas o caractere Tecla de
49. Version 2 7 9 Reference Documentation 5 Formul rios Formul rios Este cap tulo descreve todo o processo de cria o e manuten o de formul rios no e Gen No entanto antes de explanar sobre todo o processo se faz necess rio primeiramente conhecer o conceito de Formul rios e algumas particularidades desse elemento no e Gen Formul rios s o blocos com estrutura para entrada de dados Estes apresentam uma estrutura para capturar validar processar e devolver informa es para o usu rio podendo ter a funcionalidade de cadastrar manter registros no sistema bem como de funcionar como filtros para relat rios e gr ficos Cada p gina aplica o desenvolvida no e Gen s o organizadas em blocos podendo contem um ou mais blocos funcionando independentes ou relacionados com outros blocos No e Gen os blocos de formul rio s o estruturados a partir de dois conjuntos de elementos fundamentais campos e bot es Para todos os objetos internos do formul rio h um elemento chamado set properties Este um elemento para extens o do ambiente presente em todos os elementos do e Gen Utiliza se esse elemento para definir propriedades n o previstas na vers o e que devem ser utilizadas por Templates espec ficos Discutiremos o uso de set properties no cap tulo sobre Templates e Extens es do Ambiente e portanto n o citaremos o mesmo em cada objeto do formul rio Neste cap tulo mostraremos como criar formul ri
50. a a o de sele o Inser o Informa se o campo ser utilizado na inser o Interessante para campos auto incrementais Altera o Informa se o campo ser utilizado na atualiza o Interessante para campos que n o podem ser atualizados ap s a inser o tais como data de cadastro Operador Determina qual operador dever ser utilizado na consulta do bloco Se n o da Consulta for configurado para campos CHAR ser colocado o operador like e para os outros tipos de campos ser utilizado o operador Esta subse o a respeito de banco de Dados se aplica a todos apenas aos seguintes tipos de campos text select radio checkbox textarea password e hidden ME para campos do tipo checkbox Na maioria das vezes esses campos s o booleanos Quando os mesmos participam do filtro Sele o verdadeiro nunca o usu rio conseguir selecionar todos os registros pois os valores retornados sempre ser o ou verdadeiro ou falso e na requisi o apenas passado o par metro se o campo estiver marcado verdadeiro Quando n o se quer ter esse efeito deve se tirar o campo do filtro desmarcando a propriedade Sele o S a se o C digo se aplica a todos os tipos de campos Copyright 2001 2006 E Gen Developer 133 Reference Documentation Version 2 7 5 Formul rios Q 5 3 2 3 4 Evento A se o Evento re ne as propriedades que definem eventos acionados a partir dos camp
51. ados gt Select gt Where 7 Order by Sroup by w Maving um Max Linhas Informa o n mero m ximo de registros que devem retornar na consulta A utiliza o dessa propriedade importante quando o bloco est acessando grandes tabelas e vis es evitando que o usu rio receba milh es de registros em sua consulta Nome Nome do conjunto de resultados que ser guardado na Se o ou Resultados E na a Requisi o Se nulo o nome default res nome do objeto do BD Select Por default a camada de comunica o retornar todas as colunas do Banco de Dados independente da quantidade de campos inseridos na tela O desenvolvedor pode customizar este procedimento para retornar apenas determinados campos inserindo nesta propriedade uma express o com a seguinte sintaxe COLUNA NO BANCO null OU COLUNA NA TABELA FUN O DE GRUPO SUM AVG COUNT HOSs campos de retorno devem ser separados por virgula Where A clausula WHERE de uma consulta no Banco de Dados determinado pelos campos da p gina Pode se efetuar customiza es nesta clausula inserindo uma express o nesta propriedade com a seguinte sintaxe COLUNA NA TABELA OPERADOR vaLOR OPERADOR pode ser gt gt lt lt LIKE etc Order By A clausula ORDER BY da consulta pode ser modificada inserindo uma express o nesta propriedade com a seguinte sintaxe rcoLuna 1 coLuNa 2 desc COLUNAS asc COLUN
52. ag file definida em struts html tld Este campo renderizado no HTML com um bot o ao lado que abre uma janela para defini o do arquivo a ser processado carregado Existem algumas propriedades espec ficas para o tipo file localizadas na se o Arquivo File da p gina de edi o de propriedades de campos Arquivo Aceitar Dir para Upload Aceitar Lista separada por v rgula que cont m os content types para processamento correto do formul rio Dir para Upload Diret rio destino de grava o do arquivo Normalmente o campo file utilizado em conjunto com uma a o que processa o carregamento upload Existe um template de a o que escreve o c digo necess rio para o upload importante ressaltar que para processar um arquivo preciso alterar o EncType da p gina quando em HTML ou JSP para multipart form data Essa altera o pode ser feita atrav s do elemento lt Form gt Tag do formul rio que ser discutido em detalhes posteriormente nesse cap tulo tipo associado a file em HTML Free O tipo free representa um campo aberto para inclus o de qualquer c digo na p gina N o tem nenhuma refer ncia para tipos HTML ou Struts Esse tipo normalmente utilizado para incluir componentes prontos na p gina ou um c digo customizado na p gina Para dar suporie a essa funcionalidade esse tipo apresenta duas propriedades espec
53. al Layout C digo Evento Estilo abas tabl l Quebra Linha E Tecla de atalho SrO Altura Largura Copyright O 2001 2006 E Gen Developer 110 Reference Documentation Version 2 7 5 Formul rios Src Caminho relativo para o arquivo de imagem que ser visualizado Clique no cone para abrir uma lista com todas as imagens dispon veis no diret rio img da aplica o Altura Altura da imagem na p gina Largura Largura imagem na p gina Toda a se o Imagem Img tamb m se refere aos campos img Imagem Borda Nome da Imagem Lsermap Mapear Coord au Borda Determina o tamanho da borda da imagem Nome da Imagem Define o nome da imagem Usemap Esta propriedade utilizada quando a imagem possui mapeamento Mapeamento de imagem utilizado quando se deseja clicar em um determinado ponto da imagem e acionar uma a o determinada Mapear Coords Coordenadas para mapeamento da imagem Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes v Iframe O tipo iframe representa uma janela frame dentro da p gina para visualiza o de outras p ginas A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag iframe definida no HTML Existem algumas propriedades espec ficas para o tipo
54. amento absoluto Dentro os templates padr es somente Position utiliza posicionamento absoluto Principal Layout Evento Info a Posi o Posi o Bot o Esquerda 320 Topo LO z index Copyright 2001 2006 E Gen Developer 155 Version 2 7 9 Reference Documentation 5 Formul rios Posi o Bot o Define a posi o do bot o no bloco de acordo com o template utilizado A lista de posi es est baseada no arquivo de configura o ButtonPositionResources xml Para adicionar novas posi es ou alterar a ordem que aparecem utilize o gerenciador de configura o Esquerda Posi o horizontal relativa ao canto esquerdo da tela Topo Posi o vertical relativa ao topo da tela Z index Profundidade relativa do elemento com rela o aos demais elementos da tela Essa propriedade possibilita o uso de uma terceira dimens o na defini o da posi o de cada elemento Em HTML a utiliza o de posicionamento absoluto feita quando se requer uma defini o precisa de onde os elementos do formul rio devem aparecer Nesse caso n o se utiliza o tradicional esquema baseado em na tag lt table gt Ne se o se aplica a todos os tipos de bot es 5 3 3 3 2 2 Estilo A se o Estilo re ne as propriedades referentes forma como o bot o ser renderizado ou simplesmente mostrado na tela Estilo Sr Tecla de atalho Desabilitar L z Estilo Classe do
55. anco de dados tabela vis o ou vis o Java que o elemento far referencia Estes objetos devem ser mapeados previamente no projeto Valor do Campo Coluna do objeto que ser utilizada como valor Esta informa o n o visualizada na p gina R tulo do Campo Coluna do objeto que ser utilizada como r tulo Esta informa o visualizada na p gina Se o Banco de Dados Se o que re ne as propriedade de customiza o da consulta que ser montada para gera o da lista Clique no cone ao lado esquerdo das propriedades Select Where Order by Group by e Having para abrir a tela de ajuda para sintaxe correta de cada um dos campos Clique no bot o de cada se o Select Where Order by Group by e Having para abrir o editor de c digo o qual facilita a edi o de textos grandes Select Por default a camada de comunica o retornar todas as colunas do Banco de Dados independente da quantidade de campos inseridos na tela O desenvolvedor pode customizar este procedimento para retornar apenas determinados campos inserindo nesta propriedade uma express o com a seguinte sintaxe COLUNA NO BANCO null Ou COLUNA NA TABELA FUN O DE GRUPO SUM AVG COUNT Os campos de retorno devem ser separados por v rgula Where A clausula WHERE de uma consula no Banco de Dados determinada pelos campos da p gina Pode se efetuar customiza es nesta cl
56. ando as propriedades e elementos existentes e recursos do gerador Para grandes projetos aconselhamos a cria o de uma comiss o para aprovar customiza es a n vel de bloco ou superiores 5 2 2 4 Info Esta se o cont m propriedades de informa es do formul rio 5 2 2 4 1 Ajuda Esta se o re ne as propriedades para cria o de ajuda para o usu rio dd Ajuda Mensagem da 7 1184 Mensagem Mensagem de ajuda para o bloco Esta mensagem ser utilizada na gera o autom tica da documenta o do usu rio Deve ser uma chave se a propriedade 118N n o estiver vazia Clique no bot o para abrir o editor de c digo Informa se a mensagem de ajuda ser internacionalizada a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xm l localizado no diret rio conf da ferramenta Clique no cone para acessar a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties 5 2 2 4 2 Controle de Acesso Esta se o re ne as propriedades relacionadas com o controle de acesso ao bloco Controle de Acesso Pap is Excluir O Copyright 2001 2006 E Gen Developer 9 Reference Documentation 5 Formul rios Version 2 7 Papeis Pap is s o estruturas b sicas para a restri o de acesso para um elemento Neste campo pode se
57. as n o estejam no formul rio N o limpa o formul rio ap s a inser o v Update Gera c digo para altera o de registros em uma tabela Na cl usula de altera o set s o inseridas apenas as colunas que t m campos relacionados no formul rio A chave prim ria da tabela utilizada na cl usula where para identificar o registro a ser alterado Caso a tabela n o possua chave prim ria necess rio alterar o c digo gerado para utilizar outro m todo para altera o v Update Check Sum Idem Update Entretanto antes de executar a altera o verificado se o registro n o foi alterado por outro usu rio Caso o registro tenha sido alterado uma mensagem de erro mostrada para o usu rio v Delete Gera c digo para dele o de registros em uma tabela A chave prim ria da tabela utilizada na cl usula where para identificar o registro a ser alterado Caso a tabela n o possua chave prim ria necess rio alterar o c digo gerado para utilizar outro m todo para altera o v Pos Gera c digo para visualiza o de um registro a partir do Copyright O 2001 2006 E Gen Developer 152 Version 2 7 9 Reference Documentation 5 Formul rios conjunto de registros selecionado e guardado na se o E utilizado no componente navegador para facilitar a visualiza o de registros v Select Lov Gera c digo para sele o de registros com caracter sticas espec ficas requ
58. ation 5 Formul rios Default Navigator Default Navigator Detail m TE Er ES EE ml Zomm pel mal Ez Ex Grid Navigator aa ESEIDRRES BLH a E e E ei PT TENS Alisa Eal old Copyright O 2001 2006 E Gen Developer Reference Documentation Version 2 7 S S E 5 Formul rios Tabular Escreva o t tulo que deve aparecer no bloco Clique para marcar se haver Navegador no formul rio Clique no bot o para prosseguir A p gina seguinte permite a inclus o de campos no formul rio Todos os campos listados s o baseados no objeto do banco de dados e s o inclu dos com as propriedades definidas no mapeamento do objeto do banco de dados Pode se incluir um a um ou incluir todos de uma s vez gt O mesmo funciona para exclus o de campos Clique no bot o para prosseguir A pr xima p gina o desenvolvedor poder incluir os bot es de navega o na p gina A lista dos bot es dispon veis est baseada no arquivo de configura o ButtonExampleResources xml localizado em EGEN HOME config poss vel ajustar esta lista de acordo com as necessidades do projeto Pode se incluir um bot o de cada vez todos de uma s vez gt gt o que na pr tica n o faz sentido ou um conjunto pr definido de bot es A ltima op o a mais interessante para grandes projetos pois poss vel pr definir no arquivo defaultbuttons ixt em
59. ausula inserindo uma express o nesta propriedade com a seguinte sintaxe COLUNA_NA_TABELA OPERADOR VALOR OPERADOR pode ser gt gt lt lt LIKE etc Copyright 2001 2006 E Gen Developer 105 Reference Documentation Version 2 7 Order By 5 Formul rios A clausula ORDER BY da consulta pode ser modificada inserindo uma express o nesta propriedade com a seguinte sintaxe COLUNA 1 COLUNA 2 desc COLUNAS asc COLUNA Nas Group By A clausula GROUP BY da consulta pode ser modificada inserindo uma express o nesta propriedade com a seguinte sintaxe COLUNA 1 COLUNA 2 COLUNA N Having A clausula HAVING da consulta pode ser modificada inserindo uma express o nesta propriedade com a seguinte sintaxe AT COLUNA GROVE I y COLUNA CROUES gt CIO od PC OLUNA GROUP OPERADOR VALOR Nome Arquivo Nome do arquivo de enumera es no qual a lista estar baseada O processo de leitura ocorre em tempo de execu o O caminho onde todos os arquivos devem est disponivel definido na Propriedade Caminho Enumera es do projeto Ver Item 14 1 Propriedade M todo que far refer ncia tabela para captura do valor do objeto Options Na tag Options do Struts o valor ser utilizado na propriedade property Propriedade do R tulo M todo que far refer ncia tabela para captura do r tulo do objeto Options Na
60. com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades clique no bot o Fetotmar para que as propriedades Copyright O 2001 2006 E Gen Developer 130 Version 2 7 9 Reference Documentation 5 Formul rios sejam copiadas para este campo Clique aqui para maiores detalhes destas propriedades Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do r tulo Faz refer ncia propriedade class do HTML 4 0 Clique no cone para abrir a lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Titulo Tool Tip mensagem que ser exibido quando mouse se posicionar sobre o r tulo Faz refer ncia propriedade title do Struis Chave do T tulo Tool Tip mensagem que ser exibido quando mouse se posicionar sobre o r tulo A diferen a da propriedade acima que nesta deve se informar uma chave de internacionaliza o Esta chave ser convertida na mesnagem final utilizando os recursos definidos no arquivo ApplicationResources properties Faz refer ncia a propriedade titlekey do Struts e se o se aplica a todos os tipos de campos com exce o do tipo Fre
61. de propriedade value do Struis e do HTML 118N Informa se a mensagem de ajuda ser internacionalizada a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para acessar a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Tipo HTML Tipo HTML do elemento na p gina O tipo define as caracter sticas b sicas do bot o As op es de tipo s o submit button e reset A chave de identifica o de todos os bot es bloco e nome sendo que n o permitida a repeti o de nomes mesmo quando os bot es est o em blocos diferentes Na inclus o os nomes dos bot es ganham o sufixo action em virtude do tratamento feito pelo controlador para identificar a a o que o usu rio est executando 5 3 3 3 1 1 C digo A se o C digo re ne as propriedades referentes ao c digo do bot o que ser escrito na p gina e da a o que ser executada C digo Empate Update l C digo Public 5 customizado C C digo spithtml sS E Copyright O 2001 2006 E Gen Developer 151 Version 2 7 4 Reference Documentation 5 Formul rios Template Determina como o c digo do elemento ser gerado Templates padr es Todos os templates padr e
62. determinar qual is role s ser o utilizada s para seguran a do bloco Caso o usu rio n o possua a role espec fica o bloco n o ser exibido Essa propriedade tamb m poder ser preenchida com uma fun o caso o desenvolvedor deseje integrar com um sistema de controle de acesso externo Maiores Informa es no Cap 13 Clique no bot o para abrir a lista dos pap is roles e ou de chamada de fun es previamente cadastrados no projeto E e Gen Developer Micro Io X Excluir Inverte o padr o default da role A role tem como default restringir acesso a determinados objetos blocos p ginas campos bot es etc Esta op o inverte a restri o s deixando ter acesso ao objeto o usu rio que n o possui a role espec fica Ne e Gen poss vel restringir o acesso a v rios elementos da p gina otimizando o desenvolvimento de p ginas acessadas por grupos com diferentes poderes dentro da organiza o Maiores informa es no Cap 11 5 3 Elementos componentes do formul rio 5 3 1 LOV Lista de Valores A LOV Lista de Valores List of Values um elemento presente em todos os tipos de campos que guarda informa es para a cria o de um link para p ginas especiais dentro do sistemas tamb m conhecidas como LOV Essas p ginas s o dedicadas a listar elementos facilitando a busca de c digo de campos relacionados O uso mais comum de LOV s ocorre quando em um formul rio baseado em u
63. do quando a aba selecionada Caso essa propriedade n o seja preenchida o clique sobre o t tulo apenas mostrar a aba 5 3 5 2 Ajustando o Template do Formul rio Para ajuste do template do formul rio necess rio abrir a p gina de edi o do bloco ver item 5 2 2 3 Na aba C digo a propriedade Template deve ser alterada para Tabs conforme imagem abaixo Principal Layout C digo Info T C digo Script C digo ES iiy Template Tabs C di a lt html fH ae Ap s a altera o clique no bot o Salvar para gravar as altera es O template Tabs o nico dos templates padr es que gera c digo utilizando os elementos Abas Tabs para defini o do layout No entanto poss vel criar novos templates de formul rio para gera o de c digo que utilize esse elemento Sugerimos que o template Tabs seja utilizado como modelo 5 3 5 3 Definindo abas nos Campos O ltimo passo a ser realizado o ajuste de cada campo definindo em qual aba o mesmo ser visualizado necess rio abrir a p gina de edi o de campos item 5 3 2 3 e alterar a propriedade Abas Tabs localizada na aba Layout conforme imagem abaixo Essa propriedade uma lista cujas op es s o as abas inclu das no formul rio Copyright O 2001 2006 E Gen Developer 171 9 Reference Documentation 5 Formul rios Version 2 7 Principal Layout C digo Evento Esti
64. do tipo select O elemento LOV tamb m tem uma propriedade C digo por m esta propriedade guarda o c digo a ser inclu do na p gina ao lado do campo A gera o desse c digo est baseada no template do elemento Para customizar deve se deixar essa propriedade com valor nulo branco Ao longo do tempo foram inclu das novas propriedades com o objetivo de reduzir cada vez mais o n mero de campos customizados o caso das propriedades Prefixo Prefix e Sufixo Suffix Dessa forma sempre bom verificar todas as possibilidades antes de customizar um campo Prefixo Es e Sufixo Es ns 5 3 3 Bot es Os bot es s o os elementos do formul rio utilizados para executar a es relativas ao formul rio Essas a es s o definidas a partir das caracter sticas dos bot es e podem ser escritas tanto em Java quanto em JavaScript Os bot es podem ser vis veis ou n o para o usu rio Em ambos os casos sempre haver uma a o a ser executada quando o bot o for clicado ou referenciado A defini o de cada a o depende do tipo de bot o utilizado de como as propriedades e elementos do mesmo est o definidas e do template que escreve a a o Existem tamb m v rias propriedades que s tem efeito dependendo de como os campos e o pr prio formul rio s o definidos Um exemplo a valida o Um bot o pode ou n o ativar a valida o dos campos mas o c digo a ser escrito depende dos campos e do form
65. e Para o tipo hidden n o h nenhum efeito na visualiza o Nesse caso existe apenas para guardar informa es na possibilidade de mudan a no tipo do campo Posi o Esquerda Topo z index A subse o Posi o re ne as propriedades referentes ao posicionamento absoluto do elemento Essas propriedades somente t m efeito quando o template utilizado gera c digo com posicionamento absoluto Dentro os templates padr es somente Position utiliza posicionamento absoluto Esquerda Posi o horizontal relativa ao canto esquerdo da tela Topo Posi o vertical relativa ao topo da tela Z_index Profundidade relativa do elemento com rela o aos demais elementos da tela Essa propriedade possibilita o uso de uma terceira dimens o na defini o da posi o de cada elemento Em HTML a utiliza o de posicionamento absoluto feita quando se requer uma defini o precisa de onde os elementos do formul rio devem aparecer Nesse caso n o se utiliza o tradicional esquema baseado em na tag lt table gt Copyright 2001 2006 E Gen Developer 131 9 Reference Documentation 5 Formul rios Version 2 7 5 3 2 3 3 C digo A se o C digo re ne as propriedades referentes ao c digo do campo que ser escrito na p gina Principal Layout C digo Evento ir E C digo customizado C C digo tE gt lt tA Dut Prefixo ps Sufixo pis Grade Tamanho Padr o do Grid
66. e configura o TargetResources xml Para adicionar outras op es utilize o gerenciador de configura o Copyright O 2001 2006 E Gen Developer 168 Version 2 7 9 Reference Documentation 5 Formul rios Metodo Define o m todo para submiss o do formul rio Faz refer ncia direta ao conceito em HTML As principais op es s o POST Transmite os dados do formul rio atrav s do cabe alho do HTTP GET Transmite os dados do formul rio atrav s da URL concatenando os par metros ap s um sinal de interroga o separados por um sinal amp POST o m todo padr o Este mais seguro por n o explicitar na URL os par metros da requisi o Al m do problema de seguran a o m todo GET tamb m tem limita es com rela o quantidade de informa es passadas pelo formul rio OnReset C digo executado a partir do evento reset ou seja quando o formul rio resetado atrav s de um bot o do tipo reset Clique no cone ao lado das propriedades OnkReset e OnSubmit para abrir a lista de scripts pr cadastrados no Reposit rio de Script OnSubmit C digo executado a partir do evento submit ou seja quando o formul rio submetido Normalmente a Tag lt form gt n o necessita de ajustes Todas as propriedades necess rias s o definidas automaticamente na cria o do formul rio Existem apenas dois casos comuns
67. e cursor a ser mostrado Q Copyright 2001 2006 E Gen Developer Reference Documentation 5 Formul rios Display Ajusta como se um elemento mostrado Ajusta onde uma imagem ou um texto aparecer em outro Float elemento Posiciona um elemento em um posi o est tica relativa Position i absoluta ou fixa Visibility Ajusta se um elemento deve ser vis vel ou invis vel Height Ajusta a altura de um elemento Line Height Ajusta a dist ncia entre linhas Max Height Ajusta a altura m xima de um elemento Max Width Ajusta a largura m xima de um elemento Min Height Ajusta a altura m nima de um elemento Min Width Ajusta a largura m nima de um elemento Width Ajusta a largura de um elemento Uma lista priorizada de nomes de fam lia de fontes e ou nome Font Famil a am Y de fam lia gen rica para um elemento Font Size Ajusta o tamanho de uma fonte Font Size Adjust Especifica um valor para um elemento que ir preservar a altura x da primeira fonte escolhida Font Stretch Condensa ou expande a corrente fam lia de fontes Font Style Ajusta o estilo da fonte Mostra texto em uma fonte caixa baixa ou em uma fonte Font Variant normal Font Weight Ajusta o peso de uma fonte Generated Content Gera conte do em um documento usado como os pseudo Content elementos before e after Counter Ajusta quanto o contador incrementa em cada ocorr ncia de
68. e edi o de propriedades de campos Colunas Determina a quantidade de colunas para o campo Somente v lido para campos do tipo textarea Linhas Determina a quantidade de linhas para o campo Somente v lido para campos do tipo textarea Principal Layout C digo Evento dd Estilo Abasl tabi y Quebra Linha Iv Formato H gt Arredondam ementa Inicio y valor ES al Tecla de atalho Desabilitar C Somente Leitura E Colunas Linhas A defini o do tipo textarea est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag textarea definida em struts htmi tid V Hidden O tipo hidden utilizado para guardar informa es na p gina sem permitir a visualiza o A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag hidden definida em struts html tld Esse tipo bastante utilizado para passar informa es entre p ginas no ambiente Web quando n o se deseja utilizar a sess o para este fim Na cria o de um formul rio padr o como foi feito no in cio do cap tulo utilizado um campo do tipo hidden chamado pos para guardar informa es sobre a Copyright O 2001 2006 E Gen Developer 100 Version 2 7 9 Reference Documentation 5 Formul rios posi o do navegador no conjunto de registros retornados As propriedades u
69. eado Os objetos j devem ter sido mapeados anteriormente para serem relacionados Escolha um dos objetos Copyright O 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios Selecione Insert local Te role TE usuario TE usuano role Te equipamento Ta formecedor Te local Te marca TE movimentacao Ta situacao Te tipo Yw movimenta o fornecedor Yw movimenta o fornecedor mes dy resumo local equip v Clique no bot o para prosseguir v Existe outra alternativa que clicar no bot o Lletalhes Escolha esta op o se desejar mudar o tipo de conex o Pool Conex o Individual Sess o a e o E v Clique no bot o para prosseguir v Na terceira p gina define se o template no qual o bloco estar baseado Os templates s o blocos pr definidos e gravados no formato XML no diret rio EGEN HOME wizard form Existem alguns templates que s o disponibilizados na vers o original do e Gen e que j implementam grande parte das necessidades encontradas na cria o de formul rios Os templates originais permitem cria o de formul rios com e sem navegador e com e sem Grid Os principais templates s o Clean ed teca ET Columns sizes rie Elm Pa dj msn Default vt m beei E Map a a O hamm p T T T 3 Bia j b Lii f airin f Pre Copyright 2001 2006 E Gen Developer Version 2 7 9 Reference Document
70. edades do Grid O elemento Propriedades do Grid define caracter sticas espec ficas de um formul rio em grid Normalmente esse elemento inclu do automaticamente quando um formul rio criado com grid sendo utilizado apenas quando necess rio mudar alguma defini o do grid O acesso p gina de manuten o do elemento feito atrav s do link de inclus o El ou de edi o E quando o elemento j foi criado Este elemento est presente no n da rvore de objetos da p gina dentro do formul rio conforme imagem abaixo 5 5 bl form Te fornecedor 3 Relacionamentos Abbas a fem Propriedades do Grid O Grid possui quatro propriedades de acordo com a descri o abaixo Bloco Nome do bloco ao qual o elemento est associado Propriedade somente para leitura Tamanho N mero de repeti es do registro no formul rio Padr o do Grid Esse n mero deve ser maior que 0 para cria o do grid Copyright O 2001 2006 E Gen Developer 178 9 Reference Documentation 5 Formul rios Version 2 7 M todo M todo para defini o de qual registro ser processado Checagem Registro Eg E z a j Como o formul rio deve apresentar v rios registros preciso definir como ser a escolha dos registros a serem processados sobretudo em opera es de inclus o altera o e dele o O template padr o que escrevem c digo para essas a es
71. edades espec ficas para esse tipo na se o Applet que servem basicamente para preencher propriedades definidas na tag lt APPLET gt do HTML C digo Base Corresponde ao atributo codebase do elemento lt applet gt do HTML C digo Nome da classe Java que tem o c digo a ser executado Arquivo Nome do arquivo que cont m a classe que o applet deve executar Podemos fornecer os nomes de v rios arquivos separando os com v rgulas Hspace Espa amento horizontal Vspace Espa amento vertical Alinhamento Esta propriedade corresponde ao atributo align do elemento lt applet gt do HTML e funciona do mesmo modo que o atributo align do elemento lt img gt Ela alinha o objeto tanto na vertical como na horizontal relativamente ao texto que o rodeia Tipo Plug in Tipo do plug in do navegador Diret rio Plug in Diret rio de localiza o do plug in Applet Par metros que podem ser fornecidos para o correto Par metros fyncionamento do applet Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Copyright O 2001 2006 E Gen Developer 115 Reference Documentation 5 Formul rios Version 2 7 v File O tipo file representa um campo para defini o de arquivos para carregamento upload A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a t
72. edondamento poss veis Alinhamento Alinhamento do valor em rela o ao tamanho do campo O tamanho do campo e definido na propriedade Tamanho esta propriedade desloca o valor para esquerda centro direita ou start o que est definido no arquivo style css Valor Valor inicial do campo Se preenchida seu valor ser utilizado no lugar do valor retornado pela a o ap s uma submiss o Est propriedade padr o HTML Aplicado para campos do tipo text password textarea checkbox radio hidden free e file Faz refer ncia propriedade value do HTML 4 0 Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Copyright O 2001 2006 E Gen Developer 127 4 Reference Documentation 5 Formul rios Version 2 7 Tecla de atalho Atalho de teclado que pode ser definido para o campo Deve se informar apenas o caractere Ex a ou 1 Acessa se o atalho teclando ALT caractere Somente v lido para campos do tipo text password textarea checkbox select radio e img Faz refer ncia propriedade accesskey do HTML 4 0 Clique no cone para abrir o teclado para auxiliar a defini o da tecla pplEapE aa g J E Q WwW E RIPT I O FP i A 5 E F J K L m a a E aa E a N f Desabilitar Se marcada torna o campo desabilitado Faz refer ncia propriedade disable do HTML 4 0 Diferen
73. ementos basta abrir o n do elemento bot o conforme imagem abaixo Copyright O 2001 2006 E Gen Developer 161 9 Reference Documentation 5 Formul rios Version 2 7 B select action x Set Properties a ar Trigger f Registro a 5 3 3 5 1 Triggers Triggers s o elementos utilizados para definir a gera o de c digos a serem executados antes ou depois da a o do bot o S o muito utilizadas para evitar customiza es em bot es Para incluir esse elemento siga as seguintes instru es v Clique no cone ao lado do elemento abrindo a p gina de edi o e inclus o de triggers Informe as propriedades sobretudo nome e tipo S Clicar no bot o Inserir S v Volte p gina principal do e Gen clique em Saltar e verifique se a trigger foi listada abaixo do elemento na rvore de objetos da p gina S E select action x Set Properties h S E Trigger h RC Nome tg select action x Na p gina de inclus o e edi o de triggers existem algumas propriedades para definir aspectos espec ficos de cada elemento Bloco a Nome do bloco ao qual o elemento est associado Propriedade somente para leitura Bot o a Nome do bot o ao qual o elemento est associado Propriedade somente para leitura Posi o Ordem de execu o da trigger Nome Nome para identifica o da trigger Esse nome utilizado pelos templates padr es para n
74. en clique em Saltar e verifique se o elemento foi listado abaixo do objeto da p gina conforme imagem B 46 bl form Te fornecedor E ar Relacionamentos P ABAbas H 0 Propriedades do Grid E Propriedades Navegador x Para excluir o navegador do formul rio inclusive os elementos que comp em o navegador necess rio apenas clicar no cone localizado ao lado do elemento 5 3 7 1 Editando Propriedades Navegador Navigator Properties O elemento Propriedades do Navegador define caracter sticas espec ficas do componente navegador Esse componente utilizado para facilitar a navega o do usu rio entre os registros retornados por uma consulta Normalmente esse componente inclu do na pr pria cria o do formul rio quando a propriedade Navegador Navigator marcada durante o processo de cria o do bloco Copyright O 2001 2006 E Gen Developer 175 9 Reference Documentation 5 Formul rios Version 2 7 Template Templates Defaut Navegador Iv O componente navegador navigator composto por dois campos e um bot o O primeiro campo do tipo free e define a estrutura que ser visualizado atrav s da propriedade c digo do campo Existem templates padr es para o campo free que geram c digo especificamente para esse componente Navigator Bar Gif Navigator Bar e Mini Navigator Bar Gif Principal Layout C digo Evento Ir E C digo ead o Na
75. ente todas as necessidades em termos de valida o podendo substituir as demais valida es Para grandes projetos interessante que um especialista em Regex cadastre as express es utilizadas para valida o no projeto a fim de otimizar o uso desse tipo de valida o Et se o se aplica apenas aos seguintes tipos de campos text select radio checkbox textarea password hidden e file 5 3 2 3 2 Layout A subsec o Estilo reune as propriedades referentes forma como o campo ser renderizado ou simplesmente mostrado na tela Principal Layout C digo Evente E Estilo Tamanho 40 Tamanho M x 40 Escrever abas tab y Quebra Linha M Formata U SFC rredondam a Estilo alinhamento In cio Classe do Estilo valor E E Id do Estilo Tecla de atalho E TabIndex Desabilitar C Titulo Somente Leitura E Chave Titulo Tamanho Tamanho do campo No HTML segue padr o da linguagem Ex 10 10pt 10px Aplicado para campos do tipo text password select e file Faz refer ncia propriedade size do HTML 4 0 Tamanho M ximo Quantidade m xima de caracteres permitidos no campo Aplicado para campos do tipo text password e file Faz refer ncia propriedade maxlength do HTML 4 0 Copyright 2001 2006 E Gen Developer 126 4 Reference Documentation 5 Formul rios Version 2 7 Escrita Se esta propriedade for configurada para verdadeiro true o valor do campo s
76. er exibido sem caixa para edi o Est propriedade se difere de readonly visto que a caixa de entrada para o campo n o montada apenas seu conte do exibido MK o valor desta propriedade for verdadeiro o valor do campo mostrado na tela n o ser enviado nas requisi es Somente quando essa propriedade verdadeira que os templates padr es geram o c digo do campo do tipo text utilizando a tag Struts write no lugar da tag text Abas Informa em que TAB o campo ser visualizado Por default todos os campos ser o visualizados na TAB O item 5 3 6 Para deixar o campo fora das abas deixe esta propriedade em branco Este um procedimento comum para se utilizar no campo do navegador Para deix lo vis vel independentemente da aba que estiver sendo mostrada Se o campo em edi o estiver antes do primeiro campo dentro da aba o mesmo ficar antes da aba Caso contr rio ficar ap s a aba Quebra Linha Define a organiza o dos elementos na p gina Se marcado o pr ximo elemento ser mostrado na linha seguinte Formato Formato a ser aplicado na informa o do elemento A lista de formatos pode ser customizada a partir do arquivo de configura o FormatResources xm l Arredondamento Baseado na API Java de Arredondamento pode se configurar o tipo de convers o que o valor sofrer Clique no cone abrir a lista de valores que mostra todos os tipos de arr
77. er preenchida com uma fun o caso o desenvolvedor desejar integrar com um sistema de controle de acesso externo Verificar mais detalhes no cap tulo referente a Seguran a Clique no cone para abrir a lista dos pap is roles e ou de chamada de fun es previamente cadastrados no projeto e Gen Developer Micro P m E4 Excluir Inverte o padr o default da role A role tem como default restringir acesso a determinados objetos blocos p ginas campos bot es etc Esta op o inverte a restri o s deixando o objeto ser acessado por quem n o possui a role espec fica 5 3 2 4 Editando todos os campos simultaneamente Em alguns casos se torna necess rio alterar uma determinada propriedade em todos os campos ou ent o na maioria deles Neste sentido com o objetivo de evitar que o desenvolvedor entre em cada campo e fa a a altera o disponibilizada uma p gina para edi o geral das propriedades Para acessar esta p gina clique no cone Es ao lado do elemento L Editar Todos os Campos localizado logo abaixo do n Campos na rvore de objetos da p gina conforme figura abaixo Copyright O 2001 2006 E Gen Developer 136 Reference Documentation 5 Formul rios Version 2 7 E Campos a C Editar Todos os Campos f EE cd tipo E x E E returni 2 Para alterar uma propriedade em todos os campos necess rio apenas preencher a propriedade com o novo
78. eridas em Listas de Valores Select Simple Gera c digo para sele o sem retorno do primeiro registro no formul rio E normalmente utilizado em filtros de relat rios Em muitos casos tamb m utilizado em formul rios com escopo request ver mais sobre escopo do formul rio no elemento tag lt form gt item 5 3 4 v Pop Gera c digo para popular formul rio a partir de informa es passadas atrav s da requisi o request v Reset Full Gera c digo para limpar o formul rio e todos os objetos associados que est o na se o v Execute Procedure Gera c digo para execu o de procedimentos de banco procedures Os campos do formul rio s o utilizados como par metros de entrada e sa da do procedimento O objeto do banco de dados no bloco ou no bot o deve ser do tipo procedure v Refresh Gera c digo para atualizar as informa es do formul rio v Upload File Gera c digo para carregar arquivo no servidor utilizado em formul rios com campo do tipo file Nesses formul rio necess rio tamb m ajustar a propriedade EncType para multipartfform data ver mais sobre a propriedade EncType no elemento tag lt form gt item 5 3 4 v Select Flex Grid Gera c digo para sele o de registros com ajuste do n mero de linhas no grid de acordo com o n mero de registros retornados E utilizado em formul rio com grid ME demais templates listados est
79. etar limpar carregar arquivos executar procedures reler informa es etc No entanto o desenvolvedor pode ainda incluir novos templates para atender necessidades mais espec ficas Assim como nos demais objetos do e Gen as propriedades dos bot es est o organizadas em se es e distribu das em 04 abas Principal Layout Evento e Info para facilitar a visualiza o Veremos a seguir detalhadamente cada propriedade 5 3 3 3 1 Principal A se o Principal re ne as propriedades fundamentais do bot o que definem basicamente como o mesmo ser identificado na p gina e o tipo que implementa Copyright O 2001 2006 E Gen Developer 150 Version 2 7 Principal Layout Evento Info SS E Principal Blocos Bl form Te forr 9 Reference Documentation 5 Formul rios Mormes Update action Propriedades update action posic ol 2 update achor R tulo sp update 118m applicationReso Tipo HTMLa submit IE Bloco Nome do bloco a que pertence o elemento Nome Nome do campo que est sendo editado Propriedade somente para leitura Propriedade Nome da a o a qual o bot o est associado Faz refer ncia propriedade property do Struts L Posi o Ordem em que o bot o visualizado na p gina dentro da posi o definida para o mesmo para templates regulares R tulo R tulo visualizado no HTML Deve ser uma chave se a propriedade 118N n o estiver vazia Correspon
80. ficas Copyright O 2001 2006 E Gen Developer 116 4 Reference Documentation 5 Formul rios Version 2 7 Template Determina como o c digo do elemento ser gerado Templates padr es Navigator Bar Gif Gera c digo JSP com componente para Navega o em registros com layout baseado em cones Navigator Bar Gera c digo JSP com componente para Navega o em registros com layout baseado em bot es HTML Mini Navigator Bar Gif Gera c digo JSP com componente para Navega o em registros com layout baseado em cones Explorer Gera c digo JSP com componente para visualiza o do sistema de arquivos do servidor em que est instalada o container da aplica o Bar Gera c digo JSP com componente para cria o de barra de separa o dos campos na p gina Separator Table Gera c digo JSP com componente para abertura de tabela para separa o dos campos na p gina End Separator Table Gera c digo JSP com componente para fechamento de tabela para separa o dos campos na p gina Tr Separator Gera c digo JSP com componente para separa o de campos na tela baseado na tag HIML lt TR gt Start Fieldset Gera c digo JSP com componente para abertura da tag HTML fieldset para separa o dos campos na p gina End Fieldset Gera c digo JSP com componente para fechamento da tag HTML fieldset para separa o dos campos na p gina Hidden Master Fields Gera c digo JSP com
81. guintes itens 5 2 1 3 1 Action Form Principal Layout C digo Info E ActionF orm empate Default ai Adicionar Import asi Adicionar C digo E ia C digo Package 5 M Classe de template que define como o c digo do ActionForm ser Copyright O 2001 2006 E Gen Developer Q Reference Documentation 5 Formul rios Version 2 7 escrito Existe uma classe padr o no entanto o desenvolvedor pode adicionar classes customizadas para preencher qualquer necessidade espec fica Valor que ser utilizado na clausula import da ActionForm Adicionar Import Clique no cone para acessar o editor de c digo Ex import java util import java match Pode se escrever um ou mais m todos completos na ActionForm a partir Adicionar C digo desta propriedade Clique no cone para acessar o editor de c digo Se um template for escolhido o c digo da ActionForm ser escrito dentro desta propriedade Clique no cone para acessar o editor de c digo 5 2 1 3 2 A o Ac o Adicionar Import au C digo Package i Classe de template que define como o c digo da Action ser escrito Existe uma classe padr o No entanto o desenvolvedor pode adicionar classes customizadas para preencher qualquer necessidade espec fica Valor que ser utilizado na cl usula import da Action Ex import java util import java match Clique no cone para acessar o editor de c digo Se o
82. h um teste para evitar nova consulta quando a mesma j tiver sido feita na mesma se o Blank Gera c digo Java para ser inclu do na classe ActionForm padr o Struts sem nenhuma consulta Utilizado quando a montagem da lista ser customizada pelo desenvolvedor ou a lista ser montada em tempo de produ o No Cache Gera c digo Java para ser inclu do na classe ActionForm padr o Struts A consulta a base sempre ser feita independentemente dessa j tiver ocorrido na mesma se o A lista de templates est baseada no arquivo de configura o Options TemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o C digo C digo gerado a partir da classe selecionada na propriedade Template Para efetuar a customiza o deste c digo deixe a propriedade Template em branco Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Principal Valor E Yalor Valor Inicial 16H J Excluir valor Inicial Valor Inicial Determina o r tulo para valor nulo inserido no in cio da lista Caso n o seja informado um valor default ser colocado Nos templates padr es esse valor est definido na chave jsp pleaseselect do arquivo de recursos da aplica o Deve ser uma chave se a propriedade 118N n o estiver vazia I18N Informa se o valor inicial ser internacionalizado a partir do arqui
83. have se a propriedade 118N n o estiver vazia 118N Informa se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para acessar a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties 5 2 2 1 1 Banco de Dados Esta se o cont m as propriedades relacionadas liga o do bloco com o banco de dados Um bloco pode n o ter refer ncia ao banco de dados e portanto essas propriedades n o s o obrigat rias Banco de Dados Tipo de Conex o Pool a Objeto BD COM Egenr equips Tipo de Conex o Determina como ser feita a conex o com o Banco de Dados O bloco pode ou n o ter uma conex o com Banco de Dados Copyright O 2001 2006 E Gen Developer Version 2 7 a Ver tipos de conex o no item 4 2 3 Tipos de Conex o Cap 4 9 Reference Documentation 5 Formul rios Objeto BD Objeto do banco de dados tabela vis o procedimento fun o ou vis o Java que o elemento far referencia Estes objetos devem ser mapeados previamente no projeto 5 2 2 1 2 Consulta Esta se o re ne as propriedades relacionadas consulta ao banco de dados que pode existir em determinados templates Consulta Max Linhas Home Result
84. iar o processo de inclus o de um campo Para manuten o o acesso feito atrav s dos cones de edi o fe dele o localizados no n com o nome do campo No item 5 3 2 3 editando as Propriedades dos Campos pode se verificar detalhadamente o significado das propriedades gerais e comuns a todos os campos assim como a forma como devem ser utilizadas As propriedades espec ficas de cada campo podem ser consultados no item 5 3 2 1 Tipos de Campos Tr s dicas importantes para o processo de inclus o de campos JA caso o mapeamento dos objetos do banco de dados for realizado de forma customizada o trabalho de desenvolvedor no momento de inserir os campos ser muito facilitado Item 4 2 2 Segundo caso algum campo seja inclu do erroneamente ou em duplicidade o mesmo poder ser exclu do sem preju zo algum para o bloco ap s o t rmino do processo de cria o JA n o utilize nos nomes dos campos o termo action pois pode resultar em conflito no tratamento da sele o da a o na aplica o Para inclus o de campos siga as seguintes instru es v Clique no cone para iniciar o processo de inclus o de um campo 5 3 2 2 1 Principal Copyright O 2001 2006 E Gen Developer 119 Version 2 7 4 Reference Documentation 5 Formul rios Principal Mostrar Principal Bloco Dl form Te forr Campos BD l R tulo T 118m Coluna Mome no HTML Tipo HTML test l Tip
85. iedades para definir n o somente a a o que ser executada mas tamb m a forma como o formul rio ser submetido Para visualizar essas propriedades siga as seguintes instru es v Abra a rvore de objetos da p gina at o n vel do formul rio conforme figura Copyright O 2001 2006 E Gen Developer 166 9 Reference Documentation 5 Formul rios Version 2 7 W cadastro FoManualol H 0 Propriedades 5 6 gt Blocos E B gt Formul rio e Fa E bl form Te fornecedor x C Relacionamentos h E Abbas F un 5 Propriedades do Grid 1 Propriedades Navegador H H E TAG Html Form v Identifique o n chamado TAG HTML Form v Clique no cone E para abrir a tela de manuten o com todas as propriedades v Dentro desse n tamb m existe um elemento set properties para adi o de propriedades coringas As propriedades do elemento s o Principal Bloco Nome do bloco ao qual o elemento est associado Propriedade somente para leitura A o URL da a o que ser executada com a submiss o do formul rio Escopo Escopo que ser armazenado as informa es referentes ao formul rio O padr o session que guarda as informa es enquanto a se o do usu rio estiver ativa A outra op o request requisi o que guarda as informa es somente at a p gina de retorno ser aberta A navega o poder n o funcionar corretamente se
86. ilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Id do Estilo Cria um identificador para o elemento Ex id MeuFormulario Faz refer ncia tag id do HTML 4 0 Tipo Especifica o do form bean ver item 9 1 que ser criado usado para processar as informa es do formul rio Se n o for especificado ser associado ao form bean especificado na a o atrav s da propriedade name Tag form do HTML Foco Define o campo que deve estar o cursor quando a p gina for aberia As op es existentes nessa propriedade s o os campos do formul rio que podem receber foco Alvo Definie onde ser aberto o resultado do processamento do formul rio quando esse for submetido As principais op es s o Self Faz com que o resultado seja carregado na mesma janela onde est o link blank Faz com que uma nova janela seja aberta para carregar o resultado parente Faz com que o resultado seja carregado no frameset de n vel superior ao atual top Faz com que o resultado seja carregado em uma tela inteira do navegador Iframe Faz com que o resultado seja carregado em um elemento identificado como iframe Normalmente este um campo do tipo frame As op es est o baseadas no arquivo d
87. inte express o JavaScript no valor do par metro nome campo value O nome do par metro tem que estar de acordo com as defini es do filtro na p gina LOV 5 3 2 Campos Os campos s o elementos do formul rio utilizados para a entrada ou visualiza o de informa es Assim como os bot es s o os principais elementos para a constru o de um bloco de formul rio Os campos podem ou n o estar relacionados com objetos do banco de dados como tamb m pode ou n o ser vis veis Essas defini es dependem fundamentalmente do tipo de campo utilizado de como s o definidas as propriedades e elementos dos campos e da forma como os templates que escrevem o formul rio e as a es tratar o os mesmos Por padr o todos os campos dos formul rios desenvolvidos no e Gen funcionam como filtro em uma a o de sele o Neste sentido o usu rio pode definir o melhor filtro combinando valores em diversos campos Tamb m padr o o uso de valida o nos campos Estas valida es Copyright O 2001 2006 E Gen Developer 98 Version 2 7 9 Reference Documentation 5 Formul rios por sua vez funcionam em combina o com os bot es que ser o vistos na se o seguinte podendo ser acionadas ou n o dependendo da configura o do bot o A visualiza o dos campos de um formul rio no e Gen feita a partir da rvore de objetos da p gina at o n vel do formul rio Os campos encontram se no n Campos
88. iorit ria de fam lia de sons que cont m sons Voice Family E espec ficos Volume Especifica o volume do som Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no bot o para abrir a lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Barra de Quando marcada verdadeiro habilita a barra de rolagem na janela Rolagem aberta com a p gina da LOV Altura Altura da janela que ser aberta com a p gina da LOV Largura Largura da janela que ser aberta com a p gina da LOV Topo Posi o vertical a partir do topo da janela que ser aberta com a p gina da LOV Esquerda Posi o horizontal a partir da esquerda da janela que ser aberta com a p gina da LOV Copyright O 2001 2006 E Gen Developer 96 Version 2 7 9 Reference Documentation 5 Formul rios Template Tem ma Default Button Template Determina como o c digo JSP ser escrito Pode ser customizado pelo autor por valores default ou o autor poder desenvolver seus pr prios templates e plug los fazendo com que a gera o seja efetuada de acordo com suas necessidades C digo Templates pad
89. lecionado 18N A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Configurando se esta propriedade para true um cone ser exibido no Mostrar HTML do lado direito do campo Clicando se com o Mouse neste cone ser exibido uma janela popup com o texto da propriedade Mensagem Configurando se esta propriedade para true O r tulo ser escrito como Mostrar no Rotulo F die um link Clicando se com o Mouse no r tulo ser exibido uma janela Copyright O 2001 2006 E Gen Developer 141 Version 2 7 EA popup com o texto da propriedade Mensagem 5 3 2 4 5 2 Notas do Desenvolvedor Texto que ser inserido na classe java para montagem do Ajuda tipo Javadoc Javadoc 5 3 2 4 5 3 Controle de Acesso Determina qual is roles ser o utilizadas para seguran a do campo Caso Pap is o usu rio n o possua a role espec fica toda a linha do campo R tulo e campo em quest o n o ser exibida 9 Reference Documentation 5 Formul rios Inverte o padr o default da role A role tem como default restringir acesso a Si determinados objetos p ginas campos bot es etc Esta op o inverte a restri o s deixando o objeto ser acessado por quem n o possui a role espec fica 5 3 2 5 Relacionamento de Campo Field Relation O Relacionamento de Campo um elemento aplicado apenas a tipos de campos text e textarea Este aplicativo facilita a cria
90. licada ao R tulo Por default a fonte definida no arquivo de estilo da p gina Clique no cone para abrir a lista com fontes previamente cadastradas A lista de fontes est baseada no arquivo de configura o FontResources xml Para adicionar novos registros utilize o gerenciador de configura o Tamanho Tamanho da fonte O padr o definido de acordo com a linguagem que a p gina est sendo renderizada por default HTML e pelo template utilizado para gera o do formul rio A lista de tamanhos est baseada no arquivo de configura o SizeResources xml Para adicionar novos registros utilize o gerenciador de configura o Alinhamento Alinhamento do r tulo Para p ginas em HTML o tamanho da Tag lt TD gt que est o r tulo definido no arquivo de estilo da p gina classe formLabel Esta propriedade posiciona o r tulo no in cio start esquerda left centro center ou direita right Negrito Determina se o r tulo ser visualizado em negrito It lico Determina se o r tulo ser visualizado em it lico Estilo Estilos que ser o utilizados para definir a visualiza o do r tulo Faz refer ncia propriedade style do HTML 4 0 Clique no cone abrir a lista com todas as propriedades de estilo no HTML 4 0 mostrando os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir a lista
91. lizando o c digo de refer ncia Na subse o C digo existem as propriedades de Templates e C digos Essas propriedades conforme j explicado nas propriedades dos campos definem como o c digo ser gerado Para customizar o c digo necess rio escolher o valor em branco na lista dos templates e alterar o c digo contido na propriedade C digo O template que escreve o formul rio e a p gina utiliza a informa o contida em c digo para escrever o c digo do relacionamento Conforme figura abaixo C digo Template C digoll es Na distribui o do e Gen fornecido apenas um template que escreve c digo para busca de valores em banco de dados e arquivos de enumera es No entanto o desenvolvedor pode criar seus pr prios templates para extender as funcionalidades Por exemplo pode se criar um template para buscar informa es em uma base XML ou em um web service O template fornecido tamb m gera c digo para ser inclu do na classe ActionForm em aplica es baseadas no framework Struts Para diferentes frameworks necess rio revisar o template v Ap s a defini o dessas propriedades iniciais clique em v aberta automaticamente a p gina de defini o dos elementos do relacionamento conforme figura abaixo dd Principal r Bloca x Dl form Te forne Base x nm fornecedor Elementos Mome se nro formecedor Principal Nome do onne po cd equipamento v Inclua um ou v rios eleme
92. lo abas tab a Quebra Linha M SrO 5 3 5 4 Campos fora das Abas Para deixar um campo fora da aba necess rio apenas deixar o valor da propriedade Abas Tabs do campo em branco A defini o se o campo ficar antes ou depois das abas segue a seguinte regra v Se o campo estiver antes do primeiro campo na aba com a propriedade Abas igual a uma das abas a inclus o ser feita antes das abas v Caso esteja ap s a inclus o ser feita ap s as abas Principal Layout C digo Evento Estilo Abasi Quebra Linha Iv SFE 5 3 5 5 Controle de Visualiza o das Abas A p gina gerada pelo template Tabs utiliza uma vari vel de controle para definir qual aba ser visualizada A vari vel Blocktab passada atrav s da requisi o verificada sempre que a p gina aberta Quando n o existe a primeira aba identificada pelo ndice 0 visualizada e as demais s o escondidas Caso a vari vel existe a aba visualizada definida pelo valor da vari vel o qual deve ser igual ao ndice posi o de cada aba o qual inicia com 0 Por exemplo para abrir uma p gina visualizando a terceira aba de acordo com a defini o de abas no bloco necess rio passar na requisi o uma vari vel adicional com o valor 2 Nesse caso na URL ser inclu da o c digo Blocktab 2 Se a URL for ace NMocalnost 5050 me unodulo MinhaPaginaForm dozsclecrlaciion 0
93. lor n o passado na requisi o sendo utilizado apenas nos c digos que tratam a informa o a fim de comunica o com o banco de dados ou outros tratamentos definidos pelos template de a o O valor de campo quando marcado originalmente true booleano Para mudar L esse valor necess rio especificar o mesmo na propriedade Valor Value do campo A customiza o do valor verdadeiro e falso comum quando s o utiizados banco de dados que n o tem suporte para o tipo booleano Como o checkbox sempre ter dois valores espec ficos e nunca ser nulo recomendamos cuidado ao se utilizar esse campo como filtro em pesquisas Em qualquer situa o mesmo quando utilizados valores espec ficos quando estiver marcado e desmarcado nunca ser retornado o conjunto total dos registros pois sempre um dos valores verdadeiro ou falso ser utilizado no filtro uma condi o diferente dos demais campos que permitem a utiliza o de valores nulos tipo associado a checkbox em HTML v Img O tipo img representa uma imagem na p gina A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag img definida em struts html tld Existem algumas propriedades espec ficas para o tipo img localizadas na p gina de edi o de propriedades de campos Na se o Layout encontramos as seguintes propriedades Princip
94. ma entidade do sistema h apenas o c digo de uma outra entidade relacionada Por exemplo em um formul rio de venda de produtos h apenas campos para o c digo do produto A LOV funciona neste caso para facilitar a busca do produto desejado permitindo a aplica o de filtros e ordena o As informa es guardadas no elemento LOV permitem a gera o de c digo para chamar essas p ginas especiais agregando funcionalidades como a passagem de campos de retorno e de par metros Copyright 2001 2006 E Gen Developer 8 9 Reference Documentation 5 Formul rios Version 2 7 nn A inclus o de uma LOV s poder ser feita ap s a cria o da p gina LOV Siga as instru es abaixo para criar uma LOV Clique no cone ao lado do elemento Ser aberta a p gina de edi o das propriedades V rias propriedades s o preenchidas com valores padr es AL AAS Ajuste as propriedades se necess rio e em seguida clicar no bot o para incluir o elemento no campo 4 cadastro F LOManualD 3 6 Propriedades E S E Blocos N B Formul rio Fa B 55 bl form Te equipamento A Ed C Relacionamentos F 7 Abbas Propriedades do Grid 4 EE Propriedades Navegador E Ed S TAG Html Form E Campos l m Editar Todos os Campos As propriedades s o acessadas a partir da rvore de objeto da p gina como descrito acima na instru o para cria o do elemento No menu Principal Main ser o
95. mentos sp a Ah Abas 2 Propriedades do Grid se Propriedades Navegador H 0 TAG Html Form L Campos Editar Todos os Campos E H O nm fornecedor x H 0 cd_fornecedor Li x 5 3 2 3 Editando as propriedades dos Campos Assim como nos demais objetos do e Gen as propriedades dos campos est o organizadas em se es e distribu das em abas para facilitar a visualiza o Copyright O 2001 2006 E Gen Developer 122 Version 2 7 9 Reference Documentation 5 Formul rios Para acessar a p gina de manuten o clique no cone A localizado ao lado do nome do campo conforme figura abaixo H 0 nm fornecedor x A seguir seguem detalhes de cada propriedade dos campos 5 3 2 3 1 Principal A se o Principal re ne as propriedades fundamentais do campo que definem basicamente como esse campo ser identificado na p gina o tipo do campo e o tipo de convers o para dados Principal Layout C digo Evente E Principal Blocos Blform Te forr Mome nm fornecedor Posi ol O mm formecede E tulo nro fornecedor uen L Colunas Am fornecedor Tipo HTMLa text L Tipo IJDBC java lang String 1 Bloco Nome do bloco a que pertence o elemento Nome Nome do campo que est sendo editado Propriedade somente para leitura Posi o Ordem em que o campo visualizado na p gina para templates regulares R tulo R tulo visualizado no HTML Deve ser uma chave se a
96. mero de colunas a ser mostrado na mesma linha do formul rio O template escolhido deve suportar esta funcionalidade Dentre os templates padr es somente Column suporta essa propriedade criando formul rios de acordo com o n mero de colunas Colunas Seleciona a Aba em que o bloco ser visualizado Para deixar o bloco fora das abas deixe essa propriedade em branco O default tabO Se o bloco que a ser configurado estiver antes do primeiro bloco dentro da aba o mesmo ficar antes da aba Caso contr rio ficar ap s a aba NM maiores detalhes no Item 5 3 6 Abas Largura Informa a largura da tabela HTML que envolver o bloco Sobrescrever a largura definida nas propriedades gerais Se definida deve ser menor que a largura nas propriedades gerais Posicionamento Posi o do bloco na p gina Por default os blocos s o posicionados um abaixo do outro Mostrar Erro Define como os erros ser o mostrados Por default os erros ocasionados por valida es ou Exce o s o inseridos na parte superior do bloco Este padr o pode ser alterado para Nenhum Desativa qualquer mensagem de erro Formul rio Valor default os erros s o exibidos na mesma p gina Popup Os erros s o exibidos em uma p gina separada estilo popup Alerta Os erros s o exibidos em um alert JavaScript neste caso necess rio customiza o do arquivo ApplicationResources properties para retiras tag s HTML da mensagem de erro
97. nto para o c digo ligando o c digo na p gina com a chave do objeto Isso v lido quando um objeto do banco de dados v Inclua outro elemento ligando os campos de retorno Se o nome do campo na p gina tiver o mesmo nome da coluna no objeto este segundo elemento desnecess rio v Clique em Inserir v Aparecer abaixo uma lista de relacionamentos criados conforme imagem abaixo Copyright 2001 2006 E Gen Developer 143 9 Reference Documentation 5 Formul rios Version 2 7 Lista XInm fornecedor cd equipamento NE enumera es precisa se apenas incluir um relacionamento com o campo em que est o c digo o qual ser associado com a chave no arquivo A defini o de Relacionamento de Campos e a sua forma de uso s o muito semelhantes a defini o de Relacionamento de Colunas 5 3 2 6 Customizando o C digo dos Campos Um dos princ pios do e Gen permitir que o desenvolvedor ajuste o c digo gerado em qualquer ponto que necessitar No entanto como a customiza o tem impacto sobre o custo de manuten o do sistema foram criados pontos de customiza o para reduzir a quantidade de c digo customizado Quando a altera o feita a partir de um ponto de customiza o apenas uma pequena parte do c digo deixa de ser gerada automaticamente Para os campos existem alguns pontos de customiza o para ajuste do c digo que escrito na p gina camada de visualiza o e tamb m na clas
98. o Faz refer ncia propriedade style do HTML 4 0 Clique no bot o para abrir a lista contendo todas as propriedades de estilo no HTML 4 0 assim como os valores permitidos para cada propriedade e a compatibilidade nos browsers No bot o clique para abrir a lista de todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades e clicando no bot o Retornar Return as propriedades s o copiadas para este campo As principais propriedades de estilos s o Background Background Ajusta se a imagem de fundo fixa fixed ou rola scroll com Attachment o restante da p gina Ajusta a cor de fundo de um elemento Clique no bot o Background para abrir a lista de cores dispon veis no ambiente As Color cores podem ser cadastradas no arquivo config ColorResources T Ajusta uma imagem como background mage so Ajusta a posi o inicial da imagem de fundo osition Ajusta se como a imagem de fundo ser repetida Background Repeat Copyright O 2001 2006 E Gen Developer G Copyright O 2001 2006 E Gen Developer Reference Documentation Formul ri Version 2 7 9 AAS Border Propriedade abreviada para configurar em uma declara o Border Bottom i i todas as propriedades relacionadas borda inferior Ajusta a cor da borda inferior Clique no bot o para abrir Border a lista de cores dispon veis no ambiente As cores Bottom C
99. o JDBC java lang String IE Quebra Linha g Formata Nome do bloco a que pertence o elemento Lista das colunas do objeto do BD Campos BD r Escolha uma coluna para carregar as informa es a partir dos meta dados do objeto do BD Informe o nome do r tulo que ser visualizado no HTML R tulo l e l Caso a propriedade 118N n o esteja vazia de ser informada uma chave Informa se o T tulo ser internacionalizado a partir do arquivo selecionado 118N P s A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Coluna no BD que o campo faz refer ncia Nome no HTML Nome do elemento na p gina HTML N o pode repetir em um Bloco Selecione o tipo do Campo Tipo HTML x Esse tipo define as caracter sticas b sicas do elemento As op es de tipo s o text select radio checkbox textarea password hidden img iframe free applet link e file Tipo JDBC Tipo Java JDBC para convers o de tipos SQL Define a organiza o dos elementos na p gina Quebra Linha a A Se marcado o pr ximo elemento ser mostrado na linha seguinte Formato a ser aplicado na informa o do elemento Estilo Tamanhol Tamanho M x valor Tamanho do campo no HTML Segue padr o HTML Tamanho Ex 10 10pt 10px Aplicado para campos do tipo text password select e file Copyright O 2001 2006 E Gen Developer 120 Version 2 7 4 Reference Doc
100. o abas que agrupa todas as abas do formul rio A manuten o dessas abas feita atrav s dos cones de edi o e dele o localizados no n do elemento identificado com o nome da aba O T tulo Title o nico campo requerido que necessita ser preenchido As demais propriedades s o opcionais sendo utilizadas de acordo com as defini es abaixo Principal dd Principal r Blocos blform Te forne Em tab Titulos uen al SFE ge a Liga o Bloco Nome do bloco ao qual o elemento est associado Propriedade somente para leitura ID Identifica o da aba tab Propriedade somente para leitura T tulo T tulo da aba visualizado no HTML Deve ser uma chave se a propriedade 118N n o estiver vazia Copyright O 2001 2006 E Gen Developer 170 Version 2 7 9 Reference Documentation 5 Formul rios 118N Informa se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Src Caminho para uma imagem a ser inserida ao lado do t tulo Hspace Espa o entre as abas Liga o URL ou JavaScript a ser executa
101. o campo de checagem s o feitas automaticamente v Ap s essa altera o clique em Saltar v Refa a a configura o do Struts Item 9 1 para que as configura es da p gina sejam ajustadas de acordo com as defini es do grid Para excluir as defini es do grid inclusive o campo de checagem quando existente fazendo o formul rio trabalhar novamente com um registro por vez necess rio apenas clicar no cone localizado ao lado do elemento Copyright O 2001 2006 E Gen Developer 1 4 Version 2 7 9 Reference Documentation 5 Formul rios Ne tamb m necess rio refazer a configura o do Struts para que as configura es da p gina sejam ajustadas de acordo com as defini es do formul rio 5 3 7 Propriedades Navegador Navigator Properties O elemento Propriedades do Navegador Navigator Properties tamb m utilizado para incluir um componente navegador no formul rio quando a inclus o n o feita na cria o do bloco Para realizar essa a o siga as seguintes instru es v Identifique o elememento no n do bloco 5 bl form Te fornecedor x 0 C Relacionamentos sp 7 m Atabas E EI Propriedades do Grid E x z Propriedades Navegador ak v Clique no cone v Clique no bot o inserir v Esta a o cria os dois campos e o bot o que comp em o navegador ajustando as propriedades do elemento de acordo com os novos elementos v Volte p gina principal do e G
102. o de um relacionamento entre campos para facilitar a busca de informa es automaticamente em uma base externa Um caso muito comum a busca de descri o a partir de um c digo definido em outro campo Por exemplo buscar a descri o de um produto a partir do c digo do mesmo As informa es definidas nesse elemento possibilitam a gera o autom tica de c digo para buscar a descri o a partir do s c digo s existente s na p gina Normalmente o Relacionamento de Campo inclu do em um campo n o baseado no objeto do banco de dados A cria o de um Relacionamento segue os seguintes passos v Defina qual ser o campo v Clique no cone adicionar ao lado do elemento conforme imagem abaixo id Set Properties F Ser aberta a p gina de edi o das propriedades v Defina o objeto do banco de dados que possui a informa o a ser buscada pelo elemento v Seguindo nosso exemplo o objeto seria uma tabela que tem uma coluna com o c digo do produto e outra com a descri o Copyright O 2001 2006 E Gen Developer 142 Version 2 7 9 Reference Documentation 5 Formul rios Outro caminho poss vel utilizar arquivos de enumera es Ver Item 12 4 Esses arquivos seguem o padr o de arquivos de propriedades que t m em cada linha uma chave e uma descri o ambos separados pelo sinal de igual Nesse caso o c digo gerado pelo relacionamento de campo buscar a descri o a partir da chave uti
103. o do elemento Faz refer ncia propriedade style do HTML 4 0 Estilo Clique no cone para abrir a lista com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades clique no bot o Fetermar sara que as propriedades sejam copiadas para este campo Clique aqui para maiores detalhes destas propriedades Classe do elemento Esta classe deve estar definida dentro do HTML ou em arquivo separado que utiliza o padr o de escrita CSS Clique no bot o para abrir a lista com todas as classes e suas Classe do Estilo propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Evento JavaScript Ocorre quando o objeto recebe um Clique do Onclick Mouse V lido para os objetos Button Checkbox Radio Link Reset e Submit Ap s todas as configura es clique no bot o para Inserir as informa es no objeto Volte p gina principal do e Gen clique em Saltar 6 verifique se o objeto foi criado na arvore do bloco e visualizar a lista de todos os elementos j inclu dos selecione a aba Mostrar na paleta de adi o de bot es conforme imagem abaixo Principal Mostrar Lista select action Insert action update action delete action resetfull action Copyright O 2001
104. o do n de campos do tipo select abrindo a p gina de edi o e inclus o de op o option Deve se informar as propriedades sobretudo valor e r tulo e em seguida clique em Inserir Ap s a inser o a op o ser listada na parte inferior da p gina com links para edi o e dele o X da mesma Lista 2 F valor Manual O1 Os mesmos links tamb m existir o ao lado do elemento na rvore de objetos da p gina Na p gina de inclus o e edi o de op o option existem algumas propriedades para definir aspectos espec ficos de cada op o G Op o R tulo Yalor ivwalor Manual 01 2 Ed Set Properties Mesmo com a op o de cria o da lista da op o a partir de um arquivo ver propriedade Arquivo acima sempre bom lembrar que a lista ser est tica Assim quando forem necess rias listas din micas ser preciso utilizar o elemento Op es Options Pode se efetuar a carga dos itens da Option a partir de um arquivo O arquivo deve ter linhas que identifiquem o valor e o r tulo Ex Janeiro 01 pr xima linha Fevereiro 02 pr xima linha etc N o Copyright O 2001 2006 E Gen Developer 102 Reference Documentation Version 2 7 5 Formul rios podem existir 02 valores na mesma linha por m pode se carregar v rios arquivos na mesma Option Arquivo CProjetoimeses txt Procurar Salvar Inserir Lista E L 01 Janeiro i L 02 Fevereiro
105. o escopo for request Estilo Enclype String de codifica o que ser utilizada para uma submiss o do formul rio E sempre alterado quando o formul rio tem campos do tipo file para multipart form data Clique no cone para abrir a lista com v rios tipos de codifica o A lista est baseada no arquivo de configura o Mime TypeResources xml Para adicionar outras op es utilize o gerenciador de configura o Item 11 5 Estilo Estilos que ser o utilizados para definir a visualiza o do elemento Faz refer ncia propriedade style do HTML 4 0 Clique no cone para abrir a lista com todas as propriedades de estilo no HTML 4 0 mostrando os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir a lista com todas as propriedades de Copyright O 2001 2006 E Gen Developer 167 Reference Documentation Version 2 7 5 Formul rios estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades clique no bot o stemar para que as propriedades sejam copiadas para este campo Clique aqui para maiores detalhes destas propriedades Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no cone para abrir a lista com todas as classes e suas propriedades definidas no arquivo de est
106. o ser exibido Essa propriedade tamb m poder ser preenchida com uma fun o caso o desenvolvedor desejar integrar com um sistema de controle de acesso externo Verificar mais detalhes no cap tulo referente Seguran a Clique no cone para abrir a lista dos pap is roles e ou de chamada de fun es previamente cadastrados no projeto E e Gen Developer Micro O x Excluir Inverte o padr o default da role A role tem como default restringir acesso a determinados objetos blocos p ginas campos bot es etc Esta op o inverte a restri o s deixando o objeto ser acessado por quem n o possui a role espec fica Ne se o se aplica a todos os tipos de bot es 5 3 3 4 Editando todos os bot es simultaneamente Em alguns casos se torna necess rio alterar uma determinada propriedade em todos os bot es ou ent o na maioria deles Neste sentido com o objetivo de evitar que o desenvolvedor entre em cada bot o e fa a a altera o disponibilizada uma p gina para edi o geral das propriedades Para acessar esta p gina clique no cone E ao lado do elemento S Editar Todos os Bot es localizado logo abaixo do n Bot es na rvore de objetos da p gina conforme figura abaixo Copyright O 2001 2006 E Gen Developer 160 9 Reference Documentation 5 Formul rios Version 2 7 B Bot es ld Editar Todos os Bot es E S E select action x H
107. olor podem ser cadastradas no arquivo config ColorResources Border A no Bottom Style Ajusta o estilo da borda inferior Border A l Bottom Width Ajusta a largura da borda inferior Border Color Ajusta a cor das quatro bordas podendo ter at quatro cores Propriedade abreviada para configurar em uma declara o Border Left i gt todas as propriedades relacionadas borda lateral esquerda A Ajusta a cor da borda lateral esquerda A Ajusta o estilo da borda lateral esquerda PEIEE Ajusta a largura da borda lateral esquerda sarde i Propriedade abreviada para configurar em uma declara o JH todas as propriedades relacionadas borda lateral direita Border Right ajusta a cor da borda lateral direita Color pd Ajusta o estilo da borda lateral direita ada Ajusta a largura da borda lateral direita a o estilo das quatro bordas que pode ter at quatro Propriedade abreviada para configurar em uma declara o todas as propriedades relacionadas borda superior Border Top Border Top Ajusta a cor da borda superior Color Border Top Style Ajusta o estilo da borda superior Border Top Width Ajusta a largura da borda superior Ajusta a largura das quatro bordas em uma declara o que Border Width pode ter at quatro valores diferentes Classification Ajusta os lados de um elemento onde outros elementos n o Clear gt ne s o permitidos NO Cursor Especifica o tipo d
108. omear o m todo onde estar o c digo da trigger Tipo Tipo da trigger Pode ser pre ou pos quando o c digo executado antes ou depois do c digo do bot o Tipo de Informa para o template se o c digo deve ter ou n o incluir cl usulas Conex o nara cria o de conex o com o banco de dados Os principais tipos s o Sem Conex o N o gera c digo para cria o de conex o Pool Gera c digo para cria o de conex o a partir de um pool de conex es Copyright O 2001 2006 E Gen Developer 162 4 Reference Documentation 5 Formul rios Version 2 7 Individual Connection Gera c digo para cria o de conex o utilizando informa es do login usu rio e senha para cada acesso e a o na p gina Session N o gera c digo para cria o de conex o Processo de Nome qualificado com pacote da classe de neg cio que ser Negocio Classe acionada a partir do c digo da trigger A classe de neg cio est definida em biblioteca espec fica que ser discutida detalhadamente no cap tulo sobre Processo de Neg cio Business Process Clique no cone para abrir a lista com todos os Processos de Neg cio Business Processes registrados no projeto Template Determina como o c digo do elemento ser gerado Os Templates padr es s o Default Gera m todo Java com c digo padr o para trigger Esse c digo deve ser customizado para inclus o de c digo adicional
109. on 2 7 9 Reference Documentation 5 Formul rios Principal T oaoa r Blocos Bl form Te forne Propriedades com JH Navegador Pos vedado Campos Pos Bot o Pos E Blocor Nome do bloco ao qual o elemento est associado Propriedade somente para leitura Campo Define qual o campo do tipo free do formul rio que ser utilizado Navegado para escrever a estrutura do navegador visualizada na p gina As op es s o definidas a partir dos campos do tipo free existentes no formul rio Pos Navegador Define a posi o que o campo navegador navigator field ser colocado no formul rio A lista baseada nas posi es existentes de acordo com o n mero de campos do formul rio Campo Pos Define qual o campo que ser utilizado para guarda a posi o do registro que est sendo visualizado na p gina As op es s o definidas a partir dos campos existentes no formul rio Bot o Pos Pos Define qual o bot o que ser utilizado para gerar a a o para Button posicionamento a partir dos comandos existentes no navegador As op es est o baseadas nos bot es existentes no formul rio Copyright O 2001 2006 E Gen Developer 177
110. opriedades para abrir a lista de scripts pr cadastrados e se o se aplica apenas aos seguintes tipos de campos text select radio checkbox textarea password e file 0 3 2 3 5 Info A paleta de propriedades Info subdividida em 3 se es a saber Ajuda Notas de desenvolvimento e Controle de Acesso Copyright O 2001 2006 E Gen Developer 134 Version 2 7 9 Reference Documentation 5 Formul rios A se o Ajuda re ne as propriedades que definem caracter sticas da mensagem de ajuda para o campo Ap s escrita a mensagem pode ser visualizada na tela e tamb m impressa no manual do usu rio gerado automaticamente pelo Gerador de Ajuda Principal Layout C digo Evento In dd Ajuda Mensagem Roe 7 gen Mostrar C os R tulo Mensagem Texto de ajuda que ser utilizado para a montagem do Manual do Usu rio e ou visualiza o na p gina Deve ser uma chave se a propriedade 118N n o estiver vazia Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes 118N Informa se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para acessar a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationRes
111. os Os eventos definidos seguem o padr o do HTML 4 0 e no caso de aplica es Web s o acionados a partir do navegador Em todas as propriedades o valor deve ser uma fun o ou c digo que ser executado na ocorr ncia do evento Onblur C digo executado quando o objeto perde o foco Onchange C digo executado quando qualquer altera o efetuada no valor do objeto Onclick C digo executado quando o objeto clicado pelo mouse V lido para os campos do tipo checkbox radio e link Ondbiclick C digo executado quando o objeto recebe um duplo clique do mouse V lido para os campos do tipo checkbox radio e link Onfocus C digo executado quando o objeto ganha o foco Onkeydown C digo executado quando uma tecla tem seu movimento para baixo pressionada Onkeypress C digo executado quando uma tecla pressionada Onkeyup C digo executado quando uma tecla tem seu movimento para cima solta Onmousedown C digo executado quando se movimenta o mouse para baixo pelo objeto Onmousemove C digo executado quando o mouse movimentado Onmouseout C digo executado quando o ponteiro do mouse sai do objeto Onmouseover C digo executado quando o ponteiro do mouse passa sobre o objeto Onmouseup C digo executado quando se movimenta o mouse para cima pelo objeto Clique no cone no Reposit rio de Script ao lado das pr
112. os bem como ajustar suas propriedades e elementos para implementar p ginas complexas para entrada de dados Detalharemos cada elemento do bloco e suas propriedades passando todas as possibilidades de implementa o dispon veis no e Gen 5 1 Criando um Formul rio os formul rios depois de criados s o organizados em blocos conforme breve explica o anterior NE de criar esses formul rios importante que voc j tenha criado os m dulos de seu sistema pois o formul rio ficar salvo em um m dulo Ver item 3 1 8 M dulos Para facilitar a compreens o a respeito do processo de cria o de formul rios o e Gen segue o seguinte fluxo para cria o de suas aplica es Copyright O 2001 2006 E Gen Developer ce Version 2 7 G Reference Documentation 5 Formul rios B sicas do Bloco 5 1 1 Criando uma p gina Para criar uma p gina existem dois caminhos simples 1 Atalho na raiz do projeto clicando no Link Novo conforme figura abaixo e Explorando Projeto Abrir Todos Fechar Todos 4 Projeto Equipamento ee Novo b Criar P gina Criar Menu Criar Manual Gerador R pido Ferramenta El v Na p gina inicial de cria o da p gina selecione o m dulo onde ser criada a p gina v Indique um nome para a p gina no campo Arquivo JE O nome da p gina n o poder conter as seguintes express es form report menu e lov Copyright O
113. ot es semelhante de campos Por m a lista de bot es em Exemplo Example est baseada no arquivo de configura o ButtonExampleResources xml localizado em EGEN HOME config Essa lista pode ser ajustada de acordo com cada projeto Ao escolher qualquer item da lista as propriedades dos bot es s o populadas automaticamente Essas propriedades assim como nos campos foram selecionadas ao longo do tempo como as mais importantes ou com maior necessidade de ajuste H tamb m nessa p gina a partir da vers o 2 7 4 o bot o Inserir Default Insert Default para inclus o dos bot es pr definidos no arquivo defaultbuttons txt em EGEN HOME codefiles default O acesso p gina de inclus o feito atrav s do link presente no n da rvore de objetos da p gina que agrupa os bot es conforme imagem abaixo 3 5 bl form Te fornecedor L Relacionamentos h ia Abbas Ed B Propriedades do Grid P C Propriedades Navegador sp S E TAG Html Form ar Bot es wP Para inclus o de bot es siga os seguintes passos v Clique no cone para adi o v Ser aberta a paleta de propriedades para adi o Siga atentamente o preenchimento de cada campo Bloco Nome do bloco a que pertence o elemento Seleciona um exemplo na Lista de bot es Exemplo JA um exemplo selecionado as propriedades da p gina s o automaticamente preenchidas A lista de exemplos configur vel
114. ources properties Mostrar Quando marcada um cone ser exibido na p gina do lado direito do campo Clicando se neste cone ser exibida uma janela com o texto da propriedade Mensagem ou descri o referente chave de internacionaliza o Mostrar no Quando marcada o r tulo label ser exibido como um link Clicando Rotulo se neste link ser exibida uma janela com o texto da propriedade Mensagem ou descri o referente chave de internacionaliza o Notas Desenv 7 Mensagem a E A subse o Notas do Desenvolvedor re ne as propriedades que definem informa es para a documenta o de desenvolvimento Copyright 2001 2006 E Gen Developer 135 Version 2 7 9 Reference Documentation 5 Formul rios Mensagem Texto que ser inserido na classe Java para montagem de documenta o do tipo Javadoc Clique no cone 4 para abrir a lista de valores com as principais tags Javadoc e a descri o de cada uma Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes Controle de Acesso Pap is Excluir E A subse o Controle de Acesso re ne as propriedades que definem restri es de acesso ao elemento Pap is Determina qual is role s ser o utilizada s para seguran a do elemento Caso o usu rio n o possua a role espec fica o elemento n o ser exibido Essa propriedade tamb m poder s
115. p C digo executado quando uma tecla tem seu movimento para cima solta Onmousedown C digo executado quando se movimenta o mouse para baixo pelo objeto Onmousemove C digo executado quando o mouse movimentado Onmouseout C digo executado quando o ponteiro do mouse sai do objeto Onmouseover C digo executado quando o ponteiro do mouse passa sobre o objeto Onmouseup C digo executado quando se movimenta o mouse para cima pelo objeto Clique no cone Copyright O 2001 2006 E Gen Developer para abrir a lista de scripts pr cadastrados no Reposit rio de Script 158 9 Reference Documentation 5 Formul rios Version 2 7 MR se o se aplica a todos os tipos de bot es 5 3 3 3 4 Info 5 3 3 3 4 1 Ajuda A se o Ajuda re ne as propriedades que definem caracter sticas da mensagem de ajuda para o bot o Preenchida a mensagem pode ser visualizada na tela e tamb m impressa no manual do usu rio gerado automaticamente pelo Gerador de Ajuda Principal Lavout Evento Info o ajuda Mensagem eis 7 1184 Mensagem Texto de ajuda que ser utilizado para a montagem do Manual do Usu rio e ou visualiza o na p gina Deve ser uma chave se a propriedade 118N n o estiver vazia Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes 118N Informa se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est
116. que necessitam de ajustes 1 Quando o foco do formul rio deve ser um campo diferente do primeiro apresentado na tela 2 Quando o formul rio tem campos do tipo file que necessita de um tipo de codifica o diferente para ser submetido 5 3 5 Abas Abas Tabs s o elementos que definem uma forma de visualiza o do formul rio em camadas para facilitar a visualiza o de muitos campos em um mesmo formul rio Esses elementos funcionam em conjunto com o template de formul rio e com a propriedade Aba Tab dos campos L Para criar um formul rio com abas necess rio primeiramente criar novos elementos abas no formul rio Esses elementos ficam localizados no n do bloco de formu rio conforme figura abaixo Copyright O 2001 2006 E Gen Developer 169 9 Reference Documentation 5 Formul rios Version 2 7 W cadastro FoManual0ol H 0 Propriedades E a gt Blocos F gt Formul rio 4 bliform Te fornecedor E ar Relacionamentos pl o Abbas Cj Em seguida precisamos alterar o bloco de formul rio definindo um template que contemple abas Dentre os templates padr es apenas o template Tabs possui essa caracter stica 5 3 5 1 Adicionando e Editando as Abas A inclus o de abas no formul rio feita na pr pria p gina de manuten o de abas O acesso p gina feito atrav s do cone presente no n da rvore de objetos da p gina ao lado do element
117. quivo CAT omcatboiwebapps egentcss ligth css M body e Gen Developer Fe O caaastzon margin top Opx _ ww margin left 0Opx margin right 0Opx margin bottom Opx background url YimgY logo db Logo acima existe o campo Arquivo Nele podem ser escolhidos os estilos No lado esquerdo do editor voc poder fazer as altera es no c digo do arquivo CSS Na parte principal desse editor aparece um demo de como que ficar sua p gina aplicando o estilo escolhido 5 Formul rios Informe neste campo o valor o tamanho da tabela da tag TABLE no Largura HTML Pode se tamb m incluir valores editando o arquivo TableSizeResources xm Tamanho em pontos do grid para movimenta o dos objetos caso se Grade ii gi utilize o template Position Escolha o tipo do cabe alho a ser exibido O desenvolvedor poder escolher que tipo de cabe alho deseja em sua p gina todos os Cabe alho elementos podem ser customizados a partir do arquivo ApplicationResources properties Na vers o 2 5 ou superior pode se ter um cabe alho baseado em objetos Escolha o tipo de rodap a ser exibido O autor poder escolher que tipo de rodap deseja em sua p gina todos os elementos podem ser Rodape e customizados a partir do arquivo ApplicationResources properties Na vers o 2 5 ou superior pode se ter um rodap baseado em objetos 5 2 1 3 C digo Neste sub menu o desenvolvedor poder est configurando os se
118. r o Default Button Gera o de c digo JSP default com utiliza o de tags HTML e JavaScript A lista de templates est baseada no arquivo de configura o LovTemplateResources xml Para adicionar novos templates utilize o gerenciador de configura o Template kd Default Button C digo C digo C digo gerado pelo template Para customizar o c digo gerado deixe a op o do select do template em branco No menu Java Script ser o apresentadas as seguintes informa es Principal JavaScript E JavaScript Channelmode E Directories z Fullscreen z Location E Menubar E Resizable E status Titlebarl z Tollbarl ChannelMode Indica se a janela ser aberta em modo de teatro Default n o Directories Indica se ser o adicionados os bot es do diret rio Default sim Fullscreen Indica se a janela ser aberta em modo cheio Default n o Uma janela na modalidade full screen deve tamb m estar na modalidade de teatro Location Indica se ser exibida a barra de endere o Default sim Menubar Indica se ser exibida a barra de menu Default sim Resizable Indica se a janela poder ser redimensionada Default sim Srollbars Indica se a janela ter barra de rolagem Default sim Status Indica se a janela ter barra de Status Default sim Titlebar Indica se a janela ter barra de t tulo Ignorado a menos que a aplica o de chamada for uma aplica o do HTM
119. ra a a o que ser executada Pode se utilizar caminho relativo com N o deve ser preenchida se Retorno forward Href ou P gina Page j estiverem preenchidos Ancora Ancora HTML que ser adicionada ao final da gera o do link Retorno Retorno global Global Forward que ser recuperado para defini o do link Deve ser informado um nome v lido de acordo com os mapeamentos da aplica o N o deve ser preenchida se A o Action Href ou P gina Page j estiverem preenchidos Href URL relativa do link a ser executado Pode se utilizar caminho relativo com N o deve ser preenchida se A o Action Retorno forward ou P gina Page j estiverem preenchidos Indexado Nome do par metro para o ndice P gina Link relativo para p gina URL quando o link for renderizado N o utilize caminho relativo com N o deve ser preenchida se A o Action Retorno forward ou Href j estiverem preenchidos Par metro Id Define nome do par metro que ser passado no link Verificar tamb m as propriedades Nome Par metro Param Name e Propriedade Par metro Param Property que s o utilizadas em conjunto Nome Par metro Nome de um objeto tipo Java Bean a partir do qual o valor do par metro que ser passado no link ser resgatado Copyright O 2001 2006 E Gen Developer 113
120. rador Operador da Consulta 5 3 2 4 4 Evento Evento JavaScript Ocorre quando o objeto perde o foco Evento JavaScript Ocorre quando qualquer altera o efetuada no Onchange valor do objeto RR Evento JavaScript Ocorre quando o objeto recebe um Clique do Mouse V lido para os objetos Button Checkbox Radio Link Reset e Submit Evento JavaScript Ocorre quando o objeto recebe um Duplo Clique do Ondblclick Mouse V lido para os objetos Button Checkbox Radio Link Reset e Submit O Evento JavaScript Ocorre quando o objeto ganha o foco Evento JavaScript Ocorre quando se movimenta o mouse para baixo Onkeydown pelo objeto Onkeypress Evento JavaScript Ocorre quando uma tecla pressionada OnkE UE Evento JavaScript Ocorre quando uma tecla tem seu movimento para PE cima solta Evento JavaScript Ocorre quando se movimenta o mouse para baixo Onmousedown pelo objeto Evento JavaScript Ocorre quando o mouse movimentado Evento JavaScript Ocorre quando o ponteiro do mouse sai do objeto Evento JavaScript Ocorre quando o ponteiro do mouse passa sobre o Onmouseover objeto Evento JavaScript Ocorre quando se movimenta o mouse para cima Onmouseup pelo objeto 0 3 2 4 5 Info 5 3 2 4 5 1 Ajuda Texto de ajuda que ser utilizado para a montagem do Manual do Mensagem E gui Usu rio e ou visualiza o no HTML Informa se o T tulo ser internacionalizado a partir do arquivo se
121. rais da p gina em desenvolvimento 5 2 1 4 1 Ajuda Principal Lavout C digo Info E Ajuda Mensagem 1 118m Mostrar Neste campo pode ser inclusa uma mensagem para o usu rio final Mensagem explicando o contexto da p gina Esta mensagem poder ser utilizada em runtime ou quando da gera o do Manual do Usu rio Informe se o T tulo ser internacionalizado a partir do arquivo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Se esta op o for configurada para verdadeiro ser apresentado um cone na p gina para acesso da informa o descrita na propriedade Ajuda Mostrar Copyright O 2001 2006 E Gen Developer 8 Version 2 7 9 Reference Documentation 5 Formul rios 5 2 1 4 2 Notas do Desenvolvedor Motas Desenv Desabilitad O Mensagem Autor Vers o da 213 21 212 Desde Data Cria o 07 02 2006 11 36 ltima Altera o 07 02 2006 16 47 Usu rio Sysdba Nesta op o s o geradas automaticamente todas as entradas para o Desabilitar Javadoc Javadoc se esta op o for configurada para verdadeiro as entradas para o Javadoc ser o suprimidas Informa o para o desenvolvedor que ser inclu da no ActionForm com Mensagem formato Javadoc Autor do elemento N mero da vers o atual Data desde quando a p gina existe Data Cria o Data gerada automaticamente quando da cria
122. ro para same mesma p gina O desenvolvedor pode alterar esta informa o direcionando o retorno da a o para outra p gina O desenvolvedor pode optar por colocar um retorno padr o mapeado na configura o do Struts ou um caminho relativo tal como seumodulo SuaPaginaForm jsp codigo Dire o do Erro W Template Classe de template que define como o c digo do m todo da A o ser Temple escrito Existem v rias classe padr o No entanto o desenvolvedor pode adicionar classes customizadas para preencher qualquer necessidade espec fica Valida o Dna Marque se o bot o efetuar valida o dos campos Posi o do bot o na p gina Por default os bot es s o mostrados na parte inferior da p gina Posi o Bot o Atalho de teclado que pode ser definido para o campo Deve se informar apenas o caractere Ex a ou 1 Acessa se o atalho teclando ALT caractere Somente v lido para Tecla de atalho campos do tipo text password textarea checkbox select radio e img Faz refer ncia propriedade accesskey do HTML 4 0 Clique no cone para abrir o teclado para auxiliar a defini o da tecla Copyright O 2001 2006 E Gen Developer 148 Version 2 7 4 Reference Documentation 5 Formul rios Propriedade de formata o para o elemento na pr pria linha da Tag Utiliza o padr o de escrita CSS Estilos que ser o utilizados para definir a visualiza
123. s de campos s o v Text O tipo text representa uma caixa simples para entrada de dados que permite o usu rio enviar e receber informa es em forma de texto Para definir como esse tipo de campo ser escrito existe um conjunto de propriedades e tr s elementos LOV Set properties e Relacionamento de Campo Field Relation Copyright 2001 2006 E Gen Developer 99 Q Reference Documentation Version 2 7 5 Formul rios Vamos detalhar em seguida as propriedades e os elementos lembrando que a maioria das defini es tamb m ser o v lidas para os demais tipos de campos A defini o do tipo text est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag text definida em struts himl tld ou write em struts bean tld Textarea O tipo textarea representa uma caixa de texto com possibilidade para visualiza o do texto de v rias linhas e colunas Para definir como esse tipo de campo ser escrito existe um conjunto de propriedades e tr s elementos LOV Eltov fem 5 3 1 Set propertes H t Properties item 9 2 9 e Relacionamento de Campo H felacianamento do Campo Item 5 3 2 5 Tanto as propriedades quanto os elementos s o abordados no tipo Text e s o utilizados da mesma forma para esse tipo de campo Existem apenas duas propriedades espec ficas de Textarea presentes na se o Estilo Layout da p gina d
124. s geram c digo Java com implementa o do m todo perform a ser inclu do na classe Action padr o Struts Alguns templates geram m todos auxiliares chamados a partir do m todo perform v Blank Gera c digo apenas com abertura e fechamento padr o do m todo perform v Select Gera c digo para sele o de registros utilizando os campos do formul rio como filtro e como retorno para visualiza o do primeiro registro selecionado Normalmente utilizado em p gina que tem navegador para possibilitar a visualiza o dos demais registros v Select PK Gera c digo para sele o de registros utilizando como filtro os campos do formul rio que fazem parte da chave prim ria da tabela Todos os campos s o usados como retorno para visualiza o do registro selecionado o qual deve ser nico v Insert Gera c digo para inser o de registros em uma tabela Na cl usula de inser o s o inseridas todas as colunas existentes na tabela mesmo que estas n o estejam no formul rio Limpa o formul rio ap s a inser o v Insert Customized Gera c digo para inser o de registros em uma tabela Na cl usula de inser o s o inseridas apenas as colunas que t m campos relacionados no formul rio Limpa o formul rio ap s a inser o v Insert No Clear Gera c digo para inser o de registros em uma tabela Na cl usula de inser o s o inseridas todas as colunas existentes na tabela mesmo que est
125. scri o de cada uma Copyright O 2001 2006 E Gen Developer 163 Reference Documentation 5 Formul rios Version 2 7 Clique no cone para abrir o editor de c digo o qual facilita a edi o de textos grandes 5 3 3 5 2 Registro Logging Registro Logging um elemento utilizado para definir a gera o de linha de c digo para logging dentro da a o do bot o Nos templates padr es o c digo gerado est baseado nas classes utilit rias do e Gen para integra o com a API Logging Java Para incluir esse elemento siga as seguintes instru es v Clique no cone ao lado do elemento abrindo a p gina de edi o e inclus o de triggers v Informe as altera es S Clicar no bot o Salvar v Volte p gina principal do e Gen clique em Saltar e verifique se o Registro Logging foi listado abaixo do elemento na rvore de objetos da p gina S select action x 7 S Set Properties ah EO Trigger ab SS Registro Registro de Eventos E x As propriedades dispon veis na p gina de edi o do elemento podem ser definidas de acordo com a tabela abaixo Bloco Nome do bloco ao qual o elemento est associado Propriedade somente para leitura Bot o Nome do bot o ao qual o elemento est associado Propriedade somente para leitura Mensagem Mesagem que ser inclu da no log da a o Nome Nome para identifica o do Logger Esse nome
126. se que representa o modelo ActionForm no caso do Struts Al m desses pontos poss vel ajustar o c digo de cada campo nos pontos de customiza o do formul rio e da p gina mas esse recurso s deve ser utilizada caso n o existe possibilidade de se fazer a customiza o no campo Para todos os campos exce o do tipo free h uma propriedade C digo que guarda o c digo gerado do campo que ser inclu do na p gina Esse c digo pode ser customizado atrav s da propriedade Customizado Quando marcada verdadeira conforme figura abaixo o c digo do campo deixa de ser gerado automaticamente Principal Layout C digo Evento ir T C digo customizado M C digo ctr gt lt td o O campo do tipo free tem seu c digo determinado pela propriedade template Para customizar deve se deixar essa propriedade com valor nulo branco conforme imagem abaixo Principal Layout C digo Evento E C digo Taa C digo lt t gt ta fi O elemento Relacionamento de Campo tamb m tem uma propriedade C digo que guarda o c digo a ser inclu do na classe do modelo ActionForm A gera o desse c digo est baseada no template do elemento Para customizar deve se deixar essa propriedade com valor Copyright 2001 2006 E Gen Developer 144 Version 2 7 9 Reference Documentation 5 Formul rios nulo branco O mesmo se aplica para o elemento Op es Options para campos
127. sendo que n o permitido a repeti o de nomes mesmo quando os campos est o em blocos diferentes Pode ocorrer problemas com campos cujo nome termine em action em virtude do tratamento feito pelo controlador para identificar a a o que o usu rio est executando Mes se o se aplica a todos os tipos de campos Esta subse o re ne as propriedades referentes valida o das informa es passadas pelo usu rio no campo Essas propriedades suportam praticamente todos os requisitos relacionados valida o individual ou em grupo dos campos No entanto caso essas n o seja suficientes existe ainda a possibilidade de se criar uma valida o plug vel Item 5 4 2 As valida es implementadas no e Gen s o quase totalmente feitas no lado do servidor poss vel entender as valida es atrav s de templates de script que fa a as valida o no lado do cliente utilizando as mesmas informa es Algumas propriedades n o est o diretamente relacionadas valida o Propriedades como Mensagem e Restri o de Caixa funcionam de forma acess ria s regras de valida o Valida o Obrigat rio M JavaScript Mensagem Henhuma Mersa Mensagem Espec Se n o Nulo C Obrigat rio C Tipo m Grupa E Restri o Cad l Tamanho Min Tamanho M x Menor Valor Maior valor Regex le Obrigat rio Determina se o campo tem seu preenchimento obrigat rio Esta propriedade trabalha com JavaScript Q
128. sources properties Faz refer ncia propriedade titlekey do Struts e se o se aplica a todos os tipos de bot es Copyright O 2001 2006 E Gen Developer 157 Reference Documentation Version 2 7 5 3 3 3 3 5 Formul rios Q Evento A se o Evento re ne as propriedades que definem eventos acionados a partir dos bot es Os eventos definidos seguem o padr o do HTML 4 0 e no caso de aplica es Web s o acionados a partir do navegador Em todas as propriedades o valor deve ser uma fun o ou c digo que ser executado na ocorr ncia do evento Frincipal Layout E Evento OnBlur Onchange Ono Ondblclok OnFocus Onkey Press Dntevlilp QnMouse Don OnMouseMove OnMousedut OnMouseDy er Evento Info nMouselp iui Onblur C digo executado quando o objeto perde o foco Onchange C digo executado quando qualquer altera o efetuada no valor do objeto Onclick C digo executado quando o objeto clicado pelo mouse V lido para os campos do tipo checkbox radio e link Ondblelick C digo executado quando o objeto recebe um duplo clique do mouse V lido para os campos do tipo checkbox radio e link Onfocus C digo executado quando o objeto ganha o foco Onkeydown C digo executado quando uma tecla tem seu movimento para baixo pressionada Onkeypress C digo executado quando uma tecla pressionada Onkeyu
129. st definido na classe formlabel Determina se o r tulo ser visualizado em negrito Determina se o r tulo ser visualizado em it lico Es Propriedade de formata o para o elemento na pr pria linha da Tag Utiliza o padr o de escrita CSS Classe do elemento Esta classe deve estar definida dentro do HTML Classe do Estilo a E ou em arquivo separado que utiliza o padr o de escrita CSS Tool Tip que ser exibido quando mouse se posicionar sobre o r tulo Tool Tip que ser exibido quando mouse se posicionar sobre o r tulo Chave do T tulo Esta propriedade possui internacionaliza o a chave ser convertida a partir do arquivo ApplicationResources properties 5 3 2 4 3 C digo 5 3 2 4 3 1 C digo Adiciona um c digo de prefixo no campo Adiciona um c digo de sufixo no campo 5 3 2 4 3 2 Grade Tamanho do Grid Determina quantas linhas do Database Grid ser o exibidas no HTML 5 3 2 4 3 3 Banco de Dados Informa se o valor do campo ser utilizado na clausula where do seleci do Bloco Informa se o campo ser utilizado na inser o Altera o Informa se o campo ser utilizado na atualiza o Copyright O 2001 2006 E Gen Developer 140 Reference Documentation 5 Formul rios Version 2 7 Determina qual operador dever ser utilizado na consulta do bloco Se n o for configurado para campos CHAR ser colocado o operador like para os outros tipos de campos ser colocado o ope
130. sualiza o e tamb m na classe que re ne as a es a serem executadas Action no caso do Struts Al m desses pontos poss vel ajustar o c digo de cada campo nos pontos de customiza o do formul rio e da p gina Esse recurso s deve ser utilizado caso n o existe possibilidade de se fazer a customiza o no bot o Para todos os bot es h uma propriedade C digo JSP que guarda o c digo gerado do bot o que ser inclu do na p gina Esse c digo pode ser customizado atrav s da propriedade Customizado Quando marcada verdadeira o c digo do bot o deixa de ser gerado automaticamente C digo Tem pil tel select i C digo Public 55 E customizado Iv C digo ISP btml s E Para o tipo de bot o submit h tamb m a propriedade C digo A gera o desse c digo est baseada no template da a o Para customizar deve se deixar essa propriedade com valor nulo branco C digo Template l C digo Public 5 Copyright O 2001 2006 E Gen Developer 165 9 Reference Documentation 5 Formul rios Version 2 7 O elemento Trigger tamb m tem uma propriedade C digo que guarda o c digo gerado e que ser inclu do na classe Action A gera o desse c digo est baseada no template do elemento Para customizar deve se deixar essa propriedade com valor nulo branco C digo o mmpla tel C digo private EB NE verifique todas as possibilidades antes de customizar um bot o
131. t O 2001 2006 E Gen Developer 154 9 Reference Documentation 5 Formul rios Version 2 7 5 3 3 3 1 3 Banco de Dados A se o Banco de Dados apresenta a propriedade que define o objeto do banco de dados que servir de base para a cria o do c digo da a o Caso essa propriedade n o seja informada nenhum objeto os templates devem utilizar o objeto do banco de dados definido no bloco Banco de Dados Objeto BD Selecione l Objeto DB Objeto do banco de dados tabela vis o procedimento fun o ou vis o Java que o template tomar como refer ncia para gera o do c digo da a o Estes objetos devem ser mapeados previamente no projeto Ver Item 4 2 2 Ne se o se aplica apenas aos bot es do tipo submit 5 3 3 3 1 4 Valida o A se o Valida o apresenta a propriedade que define se o bot o deve ou n o executar o c digo de valida o antes de executar a a o Valida o valida o no Servidor Valida o no Se marcada determina que o bot o executar o c digo de valida o servidor antes de executar a a o Ne se o se aplica apenas aos bot es do tipo submit 5 3 3 3 2 Layout 5 3 3 3 2 1 Posi o A se o Posi o re ne as propriedades referentes ao posicionamento absoluto do elemento Com exce o de Posi o do Bot o essas propriedades somente t m efeito quando o template utilizado gera c digo com posicion
132. tas propriedades s o apresentadas no ltem 5 3 2 1 Tipos de Campos R tulo R tulo Pos Esquerda y BO Cor Cor de FG Fonte is Tarnanhol y Alinhamentol Inicio y Negrito C It lico D gt Estilo Classe do Estilo Titulo Chave Titulo A subse o R tulo re ne as propriedades referentes forma como o r tulo do campo ser renderizado ou simplesmente mostrado na tela R tulo Pos Posi o em que o r tulo ser visualizado em rela o ao campo Por default o r tulo posicionado ao lado esquerdo do campo As op es dispon veis s o Esquerda Left Direita Right Nenhum None e Topo Top A op o Nenhum None retira o r tulo da visualiza o Copyright O 2001 2006 E Gen Developer 129 4 Reference Documentation 5 Formul rios Version 2 7 BG Cor Cor de fundo background que ser exibida para o r tulo Clique no cone para abrir a lista com cores previamente cadastradas A lista de cores est baseada no arquivo de configura o ColorResources xml Para adicionar novos registros utilize o gerenciador de configura o Cor de FG Cor de frente foreground que ser exibida para o r tulo Clique no cone para abrir a lista com cores previamente cadastradas A lista de cores est baseada no arquivo de configura o ColorResources xml Para adicionar novos registros utilize o gerenciador de configura o Fonte Tipo de fonte que ser ap
133. te Desde as vers es iniciais do e Gen a inclus o de formul rios sem Wizard est dispon vel E um processo simples contendo tr s etapas que descreveremos nas sub se es seguintes Para entrar no processo de cria o necess rio clicar no icone Adicionar que fica no n do menu que agrupa os blocos de formul rio na p gina H cadastro F ManualD 3 Propriedades E B Blocos Eh E Formul rio Fa e me Relat rio b F 5 Menu a ST Gr fico s Fa A primeira etapa na cria o do formul rio a inclus o das informa es b sicas uma p gina mais completa do que a existente no Wizard pois permite a defini o de mais propriedades Copyright O 2001 2006 E Gen Developer Reference Documentation Version 2 7 y y 5 Formul rios Na primeira se o da p gina encontramos o campo T tulo Neste campo insira o nome do seu formul rio O segundo campo o 118N Este campo define um arquivo de recursos que deve ser utilizado quando no t tulo conter uma chave ao inv s do nome completo maiores informa es no cap tulo 12 Internacionaliza o Principal Principal y y Titulos 1186 a Defina o tipo de conex o entre as seguintes op es Pool Individual ou Sess o Selecione o objeto do banco de dados no qual o bloco ser baseado o N o obrigat rio que um formul rio tenha um objeto base ou mesmo conex o com banco de dados Banco de Dados Tipo de
134. temente de Read Only campos desabilitados n o tem o seu valor passado para nas requisi es Somente Leitura Se marcada s ser permitida a leitura do valor do campo Faz refer ncia propriedade readonly do HTML 4 0 Apesar de n o poderem ser alterados os valores dos campos marcados somente para leitura s o passados nas requisi es Somente v lido para campos do tipo text password textarea Src Em um campo marcado como Obrigat rio ser exibido por default um do lado direito do r tulo Esta propriedade troca o pela imagem que estiver definida Clique no cone para abrir o teclado para abrir a lista com todas as imagens dispon veis no diret rio img da aplica o Estilo Estilos que ser o utilizados para definir a visualiza o do elemento Faz refer ncia propriedade style do HTML 4 0 Clique no cone abrir a lista com todas as propriedades de estilo no HTML 4 0 mostrando os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir uma lista com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades e clicando no bot o Retornar Return as propriedades s o copiadas para este campo Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no cone
135. template for escolhido o c digo fonte da Action ser escrito dentro desta propriedade Clique no cone para acessar o editor de c digo 0 2 1 3 3 JSP JSP Tem ole Default T c digo SS SE Template Classe de template que define como o c digo JSP ser escrito Existem tr s classes padr es para p ginas convencionais Default External Layout e Position Todas s o baseadas em posicionamento din mico e Copyright O 2001 2006 E Gen Developer Version 2 7 9 Reference Documentation 5 Formul rios para templates de HTML externo No entanto o desenvolvedor pode adicionar classes customizadas para preencher qualquer necessidade espec fica De acordo com o template escolhido todo o c digo do JSP ser escrito C digo do Jsp dentro desta propriedade Clique no cone para acessar o editor de c digo 5 2 1 3 4 Html Externo Esta propriedade obrigat ria quando o template JSP External Layout ou para qualquer template JSP que usa template HTML externo O template HTML externo permite a pr defini o da p gina HTML pelo web design do projeto Ele necessita apenas informar onde os elementos do gerador devem entrar usando marca es espec ficas Veja na documenta o espec fica para Template HTML Externo a lista completa das marca es espec ficas HTML Externo radio a Salvar eGen ebensieparate 5 2 1 4 Info Sub menu respons vel pela configura o de informa es ge
136. tilizadas pelo tipo hidden s o comuns ao tipo text n o havendo nenhuma propriedade espec fica v Password O tipo password representa uma caixa de texto mas que n o permite a visualiza o do que digitado mostrando apenas asteriscos A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag passwrod definida em struts html tld As propriedades utilizadas pelo tipo password s o comuns ao tipo text Existe apenas uma propriedade espec fica na se o Estilo Layout da p gina de edi o de propriedades de campos Redisplay Determina se o campo password manter o valor quando a p gina relida Somente para campos password Principal Layout C digo Evente E Estilo Tamanho 10 Tamanho M x 10 abas tabi Il Quebra Linha M z Arredondam E E Inicio y valor ES i Tecla de atalho Desabilitar C Somente Leitura E Redispla v e Select O tipo select representa uma caixa com uma lista de op es tamb m conhecida como combo box A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag select em conjunto com option e options definidas em struts himl tld As propriedades utilizadas pelo tipo select s o comuns ao tipo text Existe apenas uma propriedade espec fica na se o Estilo
137. to Faz refer ncia propriedade style do HTML 4 0 Clique no cone para abrir a lista com todas as propriedades de estilo no HTML 4 0 e os valores permitidos para cada propriedade e a compatibilidade nos browsers Clique no cone para abrir a lista com todas as propriedades de estilo dispon veis no HTML 4 0 Preenchendo os valores das propriedades clique no bot o Pstemar para que as propriedades sejam copiadas para este campo Clique aqui para maiores detalhes destas propriedades Classe do Estilo Classe de estilo que ser utilizada para definir a visualiza o do elemento Faz refer ncia propriedade class do HTML 4 0 Clique no cone para abrir a lista com todas as classes e suas propriedades definidas no arquivo de estilo padr o da p gina Esse arquivo pode ser definido nas propriedades da p gina O valor default style css que faz refer ncia ao arquivo que est localizado no diret rio raiz da aplica o Arquivo Pode se efetuar a carga dos itens da Op o a partir de um arquivo local o Op es Options uma estrutura que guarda informa es para a gera o de listas de valores para campos de sele o no HTML muito utilizado para listas din micas que est o baseadas em tabelas ou em arquivos de enumera o Existem facilidades no e Gen atrav s dos templates de Op es Options para gerar o c digo de cria o das listas automaticamente
138. uando selecionada no campo aparecer o cone ao lado do campo Copyright O 2001 2006 E Gen Developer 124 Q Reference Documentation 5 Formul rios Version 2 7 Ae agen Tipo de mensagem que ser exibida do lado direito do campo Todas as mensagens podem ser customizadas nos arquivos de propriedades da aplica o N mero Escreve mensagem basead na chave field number Data Escreve mensagem basead na chave field date Valor Escreve mensagem basead na chave field value Customizado Escreve mensagem definida na propriedade Mesagem Espec fica descrita abaixo Calend rio Escreve mensagem basead na chave page scriptcalendar Calculadora Escreve mensagem basead na chave Dage scriptcalculator REA Se a op o anterior for configurada para Customizado o autor specifica deve informar qual o texto que ser visualizado no HTML Esta propriedade aceita tag s HTML Se n o for nulo Caso esta propriedade for verdadeira TRUE marcada as valida es s ser o efetuadas se o campo n o for nulo Obrigat rio Determina se o campo tem seu preenchimento obrigat rio Verifica tanto se o campo diferente de nulo como se o tamanho do texto enviado maior que O zero Tipo Efetua a valida o do tipo de dado Esta propriedade s tem funcionalidade para campos do tipo num rico e data Para datas verifica tamb m se a data
139. ul rio Para visualizar os bot es de um formul rio no e Gen necess rio abrir a rvore de objetos da p gina at o n vel do formul rio Os campos referente aos bot es est o dentro do n Bot es Este n quando aberto mostra n o s os bot es mas todos os elementos relacionados a cada bot o e um acesso para a p gina de edi o geral das propriedades que veremos adiante Veja imagem abaixo Copyright O 2001 2006 E Gen Developer 145 Q Reference Documentation Version 2 7 5 Formul rios E cadastro FoManualDd B E Propriedades E S E gt Blocos E S E gt Formul rio dh Fa E bl form Te fornecedor Ed ar Relacionamentos f E Abas i Propriedades do Grid pl 3 Propriedades Navegador P S E TAG Html Form A H 0 gt Campos b B Bot es wf Editar Todos os Bot es f EE select action A x 3 3 next action x selectl action 5 2 insert action 5 update action Em delete action E pe 5 resetfull_action Eq Para facilitar o desenvolvimento das aplica es no e Gen tanto as propriedades quanto os elementos possuem a medida do poss vel nomes criados a partir de propriedade de tecnologias estabelecidas tais como HTML JavaScript CSS Cascade Style Sheet Struts e Java 5 3 3 1 Tipos de Bot es Os bot es podem ser classificados de acordo com seu tipo Esses tipos est o baseados em tags HTML e apresentam caracter sticas que permitem a renderi
140. um elemento quando ultrapassa sua rea Riaht Ajusta qu o longe limite direita de um elemento est esquerda direita do limite direita do elemento pai Ajusta qu o longe limite superior de um elemento is acima abaixo do limite superior do elemento pai Vertical Align Ajusta o alinhamento vertical de um elemento Ajusta a ordem de empilhamento de um elemento me Top Copyright 2001 2006 E Gen Developer 4 Reference Documentation 5 Formul rios Version 2 7 Border Ajusta o modelo da borda de uma tabela Collapse Border Ajusta a dist ncia entre as bordas de c lulas adjacentes Spacing somente para o modelo de bordas separadas Caption Side Ajusta a posi o da capta o de acordo com a tabela Ajusta se c lulas com conte do n o vis vel devem ter bordas Empty Cels ou n o somente para o modelo de bordas separadas Table Layout Ajusta o algoritmo usado para formatar a tabela Text Color Ajusta a cor do texto Direction Ajusta a dire o do texto Letter Spacing Aumenta ou diminui o espa o entre caracteres Text Align Alinhe o texto em um elemento Text Adiciona enfeites no texto Decoration Text Indent identa a primeira linha de texto em um elemento Controla as letras em um elemento Transform White Space Ajusta como espa os em branco em um elemento tratado D gt lt er Word Spacing Aumenta ou diminui o espa
141. umentation 5 Formul rios Quando os campos s o mapeados corretamente ap s a sele o do Campo BD esse valor preenchido automaticamente Tamanho Quantidade m xima de caracteres permitidos no campo M ximo Aplicado para campos do tipo text password e file Valor inicial do campo Se preenchida seu valor ser utilizado no lugar do valor retornado pela a o ap s uma submiss o Est propriedade padr o HTML Aplicado para campos do tipo text password textarea checkbox radio hidden free e file Validar Obrigat rio E JavaScript Mensagem valid Nenhuma Mensa Obrigat rio C Tipo C Restri o Taal i Determina se o campo tem seu preenchimento obrigat rio Obrigatorio i Esta propriedade trabalha com JavaScript Tipo de mensagem que ser exibida do lado direito do campo Mensagem Todas as mensagens podem ser customizadas nos arquivos de propriedades Ob ias t rio Determina se o campo tem seu preenchimento obrigat rio Quando selecionada no campo aparecer o cone ao lado do campo Efetua a valida o do tipo do dado Tipo Esta propriedade s tem funcionalidade para campos do tipo num rico e data Restri o de Determina se o valor do campo deve ser transformado em caixa alta ou Caixa baixa na comunica o com a a o Ajuda Mensagem s u IE Texto de ajuda que ser utilizado para a montagem do Manual do Mensagem Usu rio e ou visualiza o no
142. valor e clicar no cone E Editar Todos os Campos localizado esquerda de cada campo de propriedade N o h como fazer uma altera o seletiva apenas para determinados campos 5 3 2 4 1 Principal A se o Principal re ne as propriedades para edi o de todos os campos alterando o valor de uma propriedade em todos os campos de uma vez 5 3 2 4 1 1 Principal Principal Layout C digo Evento Principal Blocos Dl form Te eg Nome do bloco a que pertence o elemento 5 3 2 4 1 2 Valida o Determina se o campo tem seu preenchimento obrigat rio Esta Obrigatorio propriedade trabalha com JavaScript Tipo de mensagem que ser exibida do lado direito do campo Todas Mensagem as mensagens podem ser customizados nos arquivos de propriedades Se a op o anterior for configurada para Customizado o autor deve informar qual o texto que ser visualizado no HTML Esta propriedade aceita tag s HTML a a A Com esta propriedade configurada para TRUE todas as valida es apenas ser o efetuadas se o campo n o for nulo Mensagem Espec fica Determina se o campo tem seu preenchimento obrigat rio a Efetua a valida o do tipo do dado Esta propriedade s tem PA funcionalidade para campos do tipo num rico e data Normalmente utilizada em telas que efetuam consulta Restri o de Determina se o valor do campo deve ser transformado em caixa alta Caixa ou baixa na comunica o com a a o
143. verificam essa propriedade para escrever a declara o if de sele o dos registros a serem processados As op es existentes para essa propriedade s o Primeiro First processa somente o primeiro registro do grid Ultimo Last processa somente o ltimo registro do grid Todos All processa todos os registros do grid gridCheckField o nome do campo inclu do na cria o do formul rio quando selecionada a op o Campo de Checagem Grid Check Field Esse campo sempre do tipo checkbox o que permite ao usu rio marcar ou desmarcar quando quiser ou n o processar o registro Be SN Posi o Campo Posi o do campo de checagem quando existente no formul rio O Checagem campo de checagem um campo do tipo checkbox usado para identificar os registros que ser o processados e definido na propriedade anterior M todo Checagem Registro como m todo de checagem O elemento Propriedades do Grid Grid Properties tamb m utilizado para fazer com que o formul rio comece a funcionar como grid quando essa defini o n o feita na inclus o do bloco Para realizar essa a o siga as seguintes instru es v Clique em J para abrir a p gina de manuten o do elemento v Informar o tamanho do grid na propriedade Deve sem informado sempre entre v Clique no bot o Inserir v Todas as defini es necess rias no bloco inclusive a cria o d
144. vigator Bar Gif a C digo Mavigator Bar Mini Navigator Ba Explorer Prefixo Bar Separator Table Sufixa End Separator Ta Grade Tr Separator Tamanho Padr ol Start Fieldset do Grid End Fieldzet Hidden Master Fie O segundo bot o normalmente do tipo hidden e inclu do no formul rio para guardar a posi o do registro que est sendo visualizado pelo usu rio Essa posi o utilizada pelas a es para preencher os campos de formul rio a partir das informa es do registro Script O bot o do tipo submit Normalmente esse bot o tem um template para gerar c digo para uma a o que pegar o valor da posi o buscar um registro no conjunto de resultados obtidos atrav s de uma consulta anterior e preencher os campos do formul rio com os valores desse registro O acesso p gina de manuten o do elemento feito atrav s do link de inclus o ou de edi o A quando o elemento j foi criado Essas op es est o presentes no n da rvore de objetos da p gina dentro do formul rio ao lado do n identificado com o nome do elemento Propriedades Navegador conforme imagem abaixo S E gt Formul rio 4 B bl form Te fornecedor x 9 C Relacionamentos H E Abbas B E Fropriedades do Grid E 9 Propriedades Navegador Este elemento possui cinco propriedades definidas no quadro seguinte Copyright O 2001 2006 E Gen Developer 176 Versi
145. vo selecionado A lista est baseada no arquivo PropertiesResources xml localizado no diret rio conf da ferramenta Clique no cone para abrir a lista de valores que mostra todas as chaves e descri es para o arquivo de recursos escolhido Caso nenhum seja escolhido a lista ser baseada no arquivo ApplicationResources properties Excluir Valor Inicial Determina qual o texto para o valor inicial Caso n o seja informado um valor default ser colocado Copyright 2001 2006 E Gen Developer 107 Version 2 7 9 Reference Documentation 5 Formul rios v Radio O tipo radio representa um conjunto de op es dispostas como campos de checagem com valor exclusivo A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag radio definida em struts html tld Existe apenas uma propriedade espec fica para o tipo radio localizada na se o Radio da p gina de edi o de propriedades de campos Radio vertical E Vertical Determina o direcionamento do Radio Group Se o valor do c digo for true verdadeiro os bot es de radio ser o exibidos na vertical Existe tamb m um elemento espec fico deste tipo chamado de Grupo Group o Para incluir esse elemento Clique no cone ao lado do elemento s aparecer abaixo do n de campos do tipo radio abrindo a p gina de
146. vos pode ser customizada a partir do arquivo de configura o TargetResources xm Transacional Inclui um identificador token transacional no link o qual permite o controle de submiss o Clique no cone ao lado das propriedades A o Action Href e P gina Page para abrir uma lista com todas as p ginas desenvolvidas na aplica o javascript setLow Somente para LOY fcadastro FOLOManualD3Low sp fcadastro FoManualh2Form sp lan lan m I IE IS a a Nesta p gina conforme figura acima selecione a a o desejada para a URL S Select Insert U Update D Delete R Refresh Copyright 2001 2006 E Gen Developer 114 Reference Documentation 5 Formul rios Version 2 7 v Applet O tipo applet representa um plug in dentro da p gina para execu o de c digo Java A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag applet definida no HTML Existem algumas propriedades espec ficas para o tipo applet localizadas na p gina de edi o de propriedades de campos Na se o Layout encontramos as seguintes propriedades Principal Layout C digo Evente Estilo abas tabi U Quebra Linha M SFE Altura Largura Altura Altura determinada para o applet Largura Largura determinada para o applet H tamb m propri
147. za o das tags referentes para o usu rio final Os tr s principais tipos de bot es s o 1 Submit Esse tipo representa um bot o que submete o formul rio ao ser pressionado A defini o est diretamente relacionada com o conceito em HTML e gerado pelos templates padr es utilizando a tag submit definida em struts html tld Al m do bot o em si que normalmente inclu do na p gina esse elemento tamb m re ne as informa es referentes a o a ser executada Desta forma em alguns casos o bot o pode n o estar vis vel na p gina mas a a o escrita a partir das informa es do mesmo implementa uma funcionalidade fundamental Clique aqui para ver as a es que podem at ser executadas sem a visualiza o da p gina pelo usu rio Button Tipo associado a button em HTML Normalmente tem uma a o definida em JavaScript a ser executada Reset Tipo associado a reset em HTML Funciona basicamente para voltar o formul rio condi o inicial Se na condi o inicial os campos n o est o limpos necess rio usar um bot o submit com um template reset para executar a a o No tipo submit mais utilizado e contempla todas as propriedade e elementos existentes nos demais Copyright O 2001 2006 E Gen Developer 146 9 Reference Documentation 5 Formul rios Version 2 7 5 3 3 2 Adicionando bot es manualmente A p gina para inclus o de b

Formulários

Contents

Download Pdf Manuals

Related Search

Related Contents

Formul&aacute;rios

Contents

Download Pdf Manuals

Related Search

Related Contents

Formulários