Abra a página de pesquisa ou uma nova página, e selecione
Inserir > Formulário > Formulário.
Última atualização em
25 de abr de 2024
Nota
A interface de usuário foi simplificada no Dreamweaver 2017. Logo, talvez você não consiga encontrar algumas das opções descritas neste artigo no Dreamweaver 2017 e em versões posteriores. Para obter mais informações, consulte este artigo (em inglês).
Sobre páginas de pesquisa e de resultados
Você pode usar o Dreamweaver para criar um conjunto de páginas que permitem aos usuários pesquisar seu banco de dados e visualizar os resultados da pesquisa.
Na maioria dos casos, você precisa de pelo menos duas páginas para adicionar esse recurso ao seu aplicativo web. A primeira página é uma página que contém um formulário HTML no qual os usuários inserem parâmetros de pesquisa. Embora esta página não faça nenhuma pesquisa real, ela é chamada de página de pesquisa.
A segunda página que você precisa é a página de resultados, que executa a maior parte do trabalho. A página de resultados realiza as seguintes tarefas:
Lê os parâmetros de pesquisa enviados pela página de pesquisa
Conecta-se ao banco de dados e procura os registros
Cria um conjunto usando os registros encontrados
Exibe o conteúdo do conjunto de registros
Opcionalmente, você pode adicionar uma página de detalhes. Uma página de detalhes fornece aos usuários mais informações sobre um registro específico na página de resultados.
Se você tiver apenas um parâmetro de pesquisa, o Dreamweaver permite adicionar recursos de pesquisa ao seu aplicativo web sem usar consultas SQL e variáveis. Basta criar suas páginas e preencher algumas caixas de diálogo.Se você tiver mais de um parâmetro de pesquisa, precisará escrever uma instrução SQL e definir várias variáveis para ela.
O Dreamweaver insere a consulta SQL na sua página. Quando a página é executada no servidor, cada registro na tabela do banco de dados é verificado. Se o campo especificado em um registro atende às condições da sua consulta SQL, o registro é incluído em um conjunto de registros. A consulta SQL efetivamente cria um conjunto de registros contendo apenas os resultados da pesquisa.
Por exemplo, a equipe de vendas externas pode ter informações sobre clientes em uma determinada área que têm rendas acima de um determinado nível. Em um formulário na página de pesquisa, o associado de vendas insere uma área geográfica e um nível mínimo de renda, e então clica no botão Enviar para enviar os dois valores para um servidor. No servidor, os valores são passados para a instrução SQL da página de resultados, que então cria um conjunto de registros contendo apenas clientes na área especificada com rendas acima do nível especificado.
Criar a página de pesquisa
Uma página de pesquisa na web normalmente contém campos de formulário nos quais o usuário insere parâmetros de pesquisa. No mínimo, sua página de pesquisa deve ter um formulário HTML com um botão Enviar.
Para adicionar um formulário HTML a uma página de pesquisa, complete o seguinte procedimento.
É criado um formulário vazio na página. Talvez seja necessário ativar Elementos invisíveis (Exibir > Auxílios visuais > Elementos invisíveis) para ver os limites do formulário, que são representados por linhas vermelhas finas.
Adicione objetos de formulário para que os usuários insiram seus parâmetros de pesquisa
selecionando Formulário no menu Inserir.
Os objetos de formulário incluem campos de texto, menus, opções e botões de opção. Você pode adicionar quantos objetos de formulário quiser para ajudar os usuários a refinar suas pesquisas. No entanto, lembre-se de que quanto maior o número de parâmetros de pesquisa na página de pesquisa, mais complexa sua instrução SQL será.
Adicione um botão Enviar ao formulário (Inserir >
Formulário > Botão).
(Opcional) Altere o rótulo do botão Enviar selecionando o botão, abrindo o inspetor de propriedades (Janela > Propriedades) e inserindo um novo valor na caixa Valor.
Em seguida, você informará ao formulário onde enviar os parâmetros de pesquisa quando o usuário clicar no botão Enviar.
Selecione o formulário selecionando a tag <form>
no seletor de tag na parte inferior da janela Documento, conforme
a imagem a seguir mostra:
Na caixa Ação no inspetor de propriedades do formulário, insira
o nome do arquivo da página de resultados que conduzirá a pesquisa
no banco de dados.
No menu pop-up Método, selecione um dos seguintes
métodos para determinar como o formulário envia dados para o servidor:
GET envia os dados do formulário anexando-os à URL como uma string de consulta. Como as URLs são limitadas a 8192 caracteres, não use o método GET com formulários longos.
POST envia os dados do formulário no corpo de uma mensagem.
Padrão usa o método padrão do navegador (geralmente GET).
A página de pesquisa está concluída.
Criar uma página de resultados básica
Quando o usuário clica no botão Pesquisar do formulário, os parâmetros de pesquisa são enviados para uma página de resultados no servidor. A página de resultados no servidor, não a página de pesquisa no navegador, é responsável por recuperar registros do banco de dados. Se a página de pesquisa enviar um único parâmetro de pesquisa para o servidor, você pode criar a página de resultados sem consultas SQL e variáveis. Você cria um conjunto de registros básico com um filtro que exclui registros que não atendem ao parâmetro de pesquisa enviado pela página de pesquisa.
Nota
Se você tiver mais de uma condição de pesquisa, deve usar a caixa de diálogo Conjunto de registros avançada para definir seu conjunto de registros (consulte Criar uma página de resultados avançada ).
Criar o conjunto de registros para armazenar os resultados da pesquisa
Abra sua página de resultados na janela
Documento.
Se você ainda não tiver uma página de resultados, crie uma página dinâmica em branco (Arquivo > Novo > Página em branco).
Crie um conjunto de registros abrindo o painel Vínculos (Janela >
Vínculos), clicando no botão Mais (+) e selecionando Conjunto de registros
no menu pop-up.
Verifique se a caixa de diálogo simples Conjunto de registros é exibida.
Nota
Se a caixa de diálogo avançada aparecer, mude para a caixa de diálogo simples clicando no botão Simples.
Digite um nome para o conjunto de registros e selecione uma conexão.
A conexão deve ser com um banco de dados contendo dados que você deseja que o usuário pesquise.
No menu pop-up Tabela, selecione a tabela a ser pesquisada
no banco de dados.
Nota
Em uma pesquisa de parâmetro único, você pode pesquisar registros em apenas uma única tabela. Para pesquisar mais de uma tabela por vez, você deve usar a caixa de diálogo Recordset avançada e definir uma consulta SQL.
Para incluir apenas algumas colunas da tabela no recordset, clique em Selecionado e selecione as colunas desejadas mantendo pressionada a tecla Ctrl e clicando (Windows) ou mantendo pressionada a tecla Command e clicando (Macintosh) nelas na lista.
Você deve incluir apenas as colunas que contêm informações que deseja exibir na página de resultados.
Deixe a caixa de diálogo Recordset aberta por enquanto.Você a usará em seguida para recuperar os parâmetros enviados pela página de pesquisa e criar um filtro de recordset para excluir registros que não atendem aos parâmetros.
Criar o filtro do conjunto de registros
No primeiro menu pop-up na área Filtro,
selecione uma coluna na tabela do banco de dados na qual pesquisar
uma combinação.
Por exemplo, se o valor enviado pela página de pesquisa for um nome de cidade, selecione a coluna na tabela que contém nomes de cidades.
No menu pop-up ao lado do primeiro menu, selecione o
sinal de igual (deve ser o padrão).
No terceiro menu pop-up, selecione Variável de formulário se o formulário na página de pesquisa usar o método POST, ou Parâmetro de URL se usar o método GET.
A página de pesquisa usa uma variável de formulário ou um parâmetro de URL para transmitir informações à página de resultados.
Na quarta caixa, digite o nome do objeto de formulário
que aceita o parâmetro de pesquisa na página de pesquisa.
O nome do objeto também serve como nome da variável de formulário ou parâmetro de URL.Você pode obter o nome alterando para a página de pesquisa, clicando no objeto de formulário no formulário para selecioná-lo e verificando o nome do objeto no Inspetor de propriedades.
Por exemplo, suponha que você queira criar um recordset que inclua apenas viagens de aventura para um país específico.Vamos supor que haja uma coluna na tabela chamada TRIPLOCATION. Suponha também que o formulário HTML na página de pesquisa use o método GET e contenha um objeto de menu chamado Location que exibe uma lista de países.O exemplo a seguir mostra como a seção Filtro deve ficar:
(Opcional) Clique em Teste, insira um valor de teste e clique em OK para conectar ao banco de dados e criar uma instância do recordset.
O valor de teste simula o valor que, de outra forma, teria sido retornado da página de pesquisa.Clique em OK para fechar o recordset de teste.
Caso você esteja satisfeito com o conjunto de registros, clique em OK.
Um script do lado do servidor é inserido na página que verifica cada registro na tabela do banco de dados quando é executado no servidor.Se o campo especificado em um registro atender à condição de filtragem, o registro será incluído em um recordset.O script cria um recordset que contém apenas os resultados da pesquisa.
A próxima etapa é exibir o recordset na página de resultados.Para obter mais informações, consulte Exibir os resultados da pesquisa.
Criar uma página de resultados avançada
Se a página de pesquisa enviar mais de um parâmetro de pesquisa para o servidor, você deve escrever uma consulta SQL para a página de resultados e usar os parâmetros de pesquisa em variáveis SQL.
Nota
Se você tiver apenas uma condição de pesquisa, poderá usar a caixa de diálogo Conjunto de registros simples para definir o conjunto de registros (consulte Criar uma página de resultados básica ).
Abra a página de resultados no Dreamweaver
e crie um conjunto de registros abrindo o painel Vínculos (Janela >
Vínculos), clicando no botão Mais (+) e selecionando Conjunto de registros
no menu pop-up.
Verifique se a caixa de diálogo avançada Conjunto de registros é exibida.
A caixa de diálogo avançada tem uma área de texto para inserir instruções SQL. Se a caixa de diálogo simples aparecer, mude para a caixa de diálogo avançada clicando no botão Avançado.
Digite um nome para o conjunto de registros e selecione uma conexão.
A conexão deve ser com um banco de dados contendo dados que você deseja que o usuário pesquise.
Insira uma instrução Select na área de texto SQL.
Verifique se a instrução inclui uma cláusula WHERE com variáveis para armazenar os parâmetros de pesquisa. No exemplo a seguir, as variáveis são chamadas varLastName e varDept:
SELECT EMPLOYEEID, FIRSTNAME, LASTNAME, DEPARTMENT, EXTENSION FROM EMPLOYEE ¬
WHERE LASTNAME LIKE 'varLastName' ¬
AND DEPARTMENT LIKE 'varDept'
Para reduzir a quantidade de digitação, você pode usar a árvore de itens do banco de dados na parte inferior da caixa de diálogo Conjunto de registros avançado. Para obter instruções, consulte Definir um conjunto de registros avançado gravando SQL.
Para obter ajuda sobre a sintaxe SQL, consulte o manual de SQL em www.adobe.com/go/learn_dw_sqlprimer.
Atribua às variáveis SQL os valores dos parâmetros de pesquisa
clicando no botão Mais (+) na área Variáveis e inserindo
o nome da variável, valor padrão (o valor que a variável deve
adotar se nenhum valor de tempo de execução for retornado) e valor de tempo de execução (geralmente
um objeto do servidor contendo um valor enviado por um navegador, como uma variável
de solicitação).
No exemplo ASP a seguir, o formulário HTML na página de pesquisa usa o método GET e contém um campo de texto chamado LastName e outro chamado Department:
No ColdFusion, os valores de tempo de execução seriam #LastName# e #Department#. No PHP, os valores de runtime seriam $_REQUEST["LastName"] e $_REQUEST["Department"].
(Opcional) Clique em Testar para criar uma instância do conjunto de registros usando os valores padrão das variáveis.
Os valores padrão simulam os valores que teriam sido retornados da página de pesquisa. Clique em OK para fechar o conjunto de registros de teste.
Caso você esteja satisfeito com o conjunto de registros, clique em OK.
A consulta SQL é inserida na página.
A próxima etapa é exibir o conjunto de registros na página de resultados.
Exibir os resultados da pesquisa
Depois de criar um conjunto de registros para armazenar os resultados da pesquisa, você deve exibir as informações na página de resultados. Exibir os registros pode ser uma questão simples de arrastar colunas individuais do painel Vínculos para a página de resultados. Você pode adicionar links de navegação para avançar e retroceder no conjunto de registros ou pode criar uma região repetitiva para exibir mais de um registro na página. Você também pode adicionar links para uma página detalhada.
Para obter mais informações sobre métodos de exibição de conteúdo dinâmico em uma página que não seja exibir resultados em uma tabela dinâmica, consulte Exibir registros do banco de dados.
Posicione o ponto de inserção onde deseja que a tabela dinâmica
apareça na página de resultados e selecione Inserir >
Objetos de dados > Dados dinâmicos > Tabela dinâmica.
Preencha a caixa de diálogo Tabela dinâmica, selecionando o
conjunto de registros definido para armazenar os resultados da pesquisa.
Clique em OK. Uma tabela dinâmica que exibe resultados da pesquisa
é inserida na página de resultados.
Criar uma página de detalhes para uma página de resultados
Seu conjunto de páginas de pesquisa e resultados pode incluir uma página de detalhes para exibir mais informações sobre registros específicos na página de resultados. Nessa situação, sua página de resultados também funciona como a página mestre em um conjunto de páginas mestre-detalhe.
Criar um link para abrir uma página relacionada (ASP)
Você pode criar um link que abre uma página relacionada e que passa parâmetros existentes para essa página. O comportamento do servidor está disponível somente ao usar o modelo de servidor ASP.
Antes de adicionar um comportamento de servidor "Go To Related Page" a uma página, certifique-se de que a página receba parâmetros de formulário ou de URL de outra página.O trabalho do comportamento do servidor é passar esses parâmetros para uma terceira página. Por exemplo, você pode passar parâmetros de pesquisa recebidos por uma página de resultados para outra página e evitar que o usuário tenha que inserir os parâmetros de pesquisa novamente.
Além disso, você pode selecionar texto ou uma imagem na página para servir como o link para a página relacionada, ou pode posicionar o ponteiro na página sem selecionar nada, e o texto do link é inserido.
Na caixa Ir para página relacionada, clique em Procurar e
localize o arquivo da página relacionada.
Se a página atual envia dados para si mesma, insira o nome do arquivo da página atual.
Se os parâmetros que você deseja passar foram recebidos diretamente
de um formulário HTML usando o método GET, ou estão
listados na URL da página, selecione a opção Parâmetros de URL.
Se os parâmetros que você deseja passar foram recebidos diretamente
de um formulário HTML usando o método POST, selecione
a opção Parâmetros de formulário.
Clique em OK.
Quando o novo link for clicado, a página passa os parâmetros para a página relacionada usando uma string de consulta.
Criar belos sites no Dreamweaver
Crie, codifique e gerencie sites dinâmicos com uma ferramenta completa e eficiente.
