Criando uma Página
Início  Anterior  Próximo

Após a definição de alguns componentes de escopo do projeto como as duas combos (ramosatividade e uf) e o grid SQL (empresas) vamos criar uma página para que esses componentes sejam inseridos. A página a ser criada deverá ter um formulário com os campos correspondentes aos dados de uma empresa sendo que esse formulário poderá ser usado tanto para o cadastro de uma nova empresa quanto para a alteração dos dados de uma empresa já cadastrada, essa página também irá listar quais as empresas que se encontram atualmente cadastradas.

Para criar uma nova página no WI Builder, em seu projeto, clique no link Páginas da barra de menu (treeview) e, posteriormente, clique na barrinha do submenu rz_menupg que surge abaixo e tem a finalidade de abrir a tela de definições da nova página. Na tela de definição de páginas entre no campo Título o texto "Cadastro de Empresas" e no campo Identificador digite empresas. Para o nosso caso também desmarque a opção Segurança ativa, com essa opção marcada o WI Engine sempre checa se a requisição para essa página está vindo de uma outra página WSP, em caso afirmativo o acesso à página é liberado, em caso contrário um erro 403 (acesso proibido) é retornado ao cliente. Por fim, clique no botão "gravar".

Perceba que ao gravar a definição da página o campo Tipo (MIME) foi preenchido automaticamente com o valor html indicando que o conteúdo dessa página será enviada ao cliente como sendo do tipo text/html. A depender da necessidade o desenvolvedor poderá definir outros tipos MIME para as páginas como png (caso a página retorne como conteúdo uma imagem do tipo image/png), doc (caso o conteúdo retornado seja do tipo application/msword), etc.

Após termos criado a página vamos adicionar um componente do tipo Objeto ao pré-página. Os componentes de página do tipo Objeto têm como principal utilidade armazenar o resultado de uma consulta feita a um banco de dados, além disso esses componentes em conjunto com o WIzard de páginas ajudam na construção de formulários.

Todo componente Objeto possui um identificador que é usado como prefixo dos nomes das colunas que são retornadas pela consulta antes de serem colocadas na sessão do usuário. O WIzard de páginas toda vez que encontra um componente Objeto definido no pré-página inserirá automaticamente um formulário HTML correspondente ao objeto com as colunas retornadas da consulta indicando os campos desse formulário

Para nos ajudar na construção do formulário de cadastro de empresas e também na recuperação dos dados de uma empresa vamos adicionar um Objeto que recuperará as informações sobre uma empresa. Para construir um Objeto siga os passos descritos abaixo:

·Escolha a opção Pré-Página identificada pelo ícone pre.  

·Nas opções da coluna Novos Elementos clique no link Objeto.  

·No campo Descrição digite Empresa.  

·No campo Objeto digite tmp.empresa. Neste campo nós definimos qual será o identificador desse componente, como esse identificador está começando com o prefixo tmp. nós estamos informando ao WebIntegrator que o tempo de vida dessa variável na sessão será até o momento em que essa página for enviada ao usuário depois disso ela será apagada da sessão.  

·No campo SQL vamos mais uma vez pedir ao WIzard SQL para que ele gere a instrução SQL que irá recuperar as informações de uma empresa a partir de seu código. Pelo WIzard SQL (wisql) escolha a tabela empresas e selecione todos os campos dessa tabela.  

·Ainda no WIzard SQL, na opção Filtros escolha a opção empresas.codigo, marque a opção Ocultar para indicar que utilizaremos essa coluna mas não queremos que seu valor seja retornado pela pesquisa, no campo Condição escolha a opção "Igual a" e preencha a caixa de texto com "|tmp.cod|" sem as aspas. Essa definição faz com que os valores da coluna empresas.codigo não sejam retornados pela consulta mas ela seja usada na expressão de condição da consulta onde seus valores serão comparados com a variável de sessão tmp.cod. Clique no botão "gravar".  

·Ainda na opção Filtros configure o campo Título das opções empresas.nomefantasia, empresas.razaosocial, empresas.endereco e empresas.ramoatividade com os valores "Nome de Fantasia", "Razão Social", "Endereço" e "Ramo de Atividade" respectivamente. Lembrando que para cada opção o botão "gravar" deve ser clicado para que a definição seja salva para cada uma das opções.  

·Clique na opção SQL do WIzard SQL. O SGBD provavelmente irá retornar uma mensagem informando que há um erro no comando SQL. O que ocorreu aqui foi que o WebIntegrator antes de enviar o comando SQL ao SGBD ele fez um pré-processamento do comando para substituir referências à variáveis de sessão pelo seu respectivo valor, no nosso caso o nosso comando SQL está fazendo referência à variável de sessão tmp.cod mas a mesma não se encontra na sessão. Para que a mensagem de erro não apareça digite no campo tmp.cod o valor 0 (zero) e clique no botão "executar" para que o comando SQL seja executado novamente.  

·Clique no botão "copiar". A janela do WIzard SQL será fechada, retornando para a tela de definição do objeto.  

·Na tela de definição do objeto clique no botão "gravar" para que a definição seja salva.  

Perceba que ao gravar a definição do objeto o campo Condição foi preenchido automaticamente com o valor true indicando que esse componente sempre será executado, caso queira o desenvolvedor poderá definir condições mais elaboradas com o uso de operadores condicionais como && ("e lógico") ou || ("ou lógico"), parêntesis e também fazendo referência às variáveis de sessão.

Com o objeto definido no pré-página clique no ícone wiz para que o WIzard de Página gere uma página com um formulário baseado nas informações desse objeto. Lembrando que essa é apenas uma funcionalidade de interação entre o componente objeto e o Wizard de Páginas, pois ambos podem ser usados separadamente, o componente objeto para armazenar os dados vindos de uma consulta a um banco de dados e o WIzard de Páginas ser utilizado para a criação das páginas.