Observação:

a interface de usuário foi simplificada no Dreamweaver CC e posterior. Como resultado, você talvez não consiga localizar algumas das opções descritas neste artigo no Dreamweaver CC e posterior. 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 e permitir que os usuários pesquisem o banco de dados e exibam os resultados da pesquisa.

Na maior parte dos casos, você precisa de pelo menos duas páginas para adicionar esse recurso ao aplicativo da Web. A primeira página contém um formulário em HTML no qual os usuários inserem os parâmetros de pesquisa. Embora não realize nenhuma pesquisa efetiva, essa página é conhecida como página de pesquisa.

A segunda página de que você precisa é a de resultados, que realiza grande 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

    Você também pode adicionar uma página detalhada. Uma página detalhada dá aos usuários mais informações sobre um determinado registro da página de resultados.

    Caso você tenha apenas um parâmetro de pesquisa, o Dreamweaver permite adicionar recursos de pesquisa ao aplicativo da Web sem usar consultas e variáveis SQL. Basta criar as páginas e completar algumas caixas de diálogo. Caso tenha mais de um parâmetro de pesquisa, você precisa escrever uma instrução SQL e definir muitas variáveis para ela.

    O Dreamweaver insere a consulta SQL na página. Quando a página é executada no servidor, todos os registros na tabela do banco de dados são verificados. Caso o campo especificado em um registro atenda às condições da consulta SQL, o registro é incluído em um conjunto de registros. A consulta SQL ativa cria um conjunto de registros contendo apenas os resultados da pesquisa.

    Por exemplo, a equipe de vendas em campo pode ter informações sobre clientes de uma determinada área cujas rendas são superiores a um determinado nível. Em um formulário de uma página de pesquisa, o associado de vendas insere uma área geográfica e um nível de receita mínimo e, em seguida, clica no botão Enviar para enviar os dois valores a um servidor. No servidor, os valores são passados para a instrução SQL da página de resultados, que cria um conjunto de registros contendo apenas os clientes da área especificada cujas receitas estejam 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 os parâmetros de pesquisa. A página de pesquisa deve ter, no mínimo, um formulário em HTML com um botão Enviar.

Para adicionar um formulário em HTML a uma página de pesquisa, conclua o seguinte procedimento.

  1. Abra a página de pesquisa ou uma nova página e selecione Inserir > Formulário > Formulário.

    É criado um formulário vazio na página. Você talvez precise ativar os Elementos invisíveis (Exibir > Auxílios visuais > Elementos invisíveis) para ver os limites do formulário, representados por linhas finas em vermelho.

  2. Adicione objetos de formulário para que os usuários insiram os parâmetros de pesquisa selecionando Formulário no menu Inserir.

    Entre os objetos de formulário estão 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 for o número de parâmetros na página de pesquisa, mais complexa será a instrução SQL.

  3. Adicione um botão Enviar ao formulário (Inserir > Formulário > Botão).
  4. (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 para onde enviar os parâmetros de pesquisa quando o usuário clica no botão Enviar.

  5. Escolha o formulário selecionando a tag <form> no seletor de tags na parte inferior da janela Documento, como mostra a seguinte imagem:
    Tag form
  6. Na caixa Ação do Inspetor de propriedades do formulário, digite o nome de arquivo da página de resultados que realizará a pesquisa no banco de dados.
  7. No menu pop-up Método, selecione um dos seguintes métodos para determinar como o formulário envia os dados para o servidor:
    • GET envia os dados do formulário anexando-os ao URL como uma sequência de caracteres de consulta. Como os URLs estão limitados a 8.192 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 (normalmente, GET).

      A página de pesquisa está pronta.

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, e não a página de pesquisa no navegador, é a responsável por recuperar os registros do banco de dados. Caso a página de pesquisa envie um parâmetro de pesquisa único para o servidor, você pode criar a página de resultados sem consultas e variáveis SQL. Você cria um conjunto de registros básico com um filtro que exclui os registros que não atendam ao parâmetro de pesquisa enviado pela página de pesquisa.

Observação:

Caso tenha mais de uma condição de pesquisa, você deve usar a caixa de diálogo avançada Conjunto de registros para definir o conjunto de registros (consulte Criar uma página de resultados avançada ).

Criar o conjunto de registros para manter os resultados de pesquisa

  1. Abra a página de resultados na janela Documento.

    Caso você ainda não tenha uma página de resultados, crie uma página dinâmica em branco (Arquivo > Novo > Página em branco).

  2. Crie um conjunto de registros abrindo o painel Ligações (Janela > Ligações), clicando no botão de adição (+) e selecionando Conjunto de registros no menu pop-up.
  3. Verifique se a caixa de diálogo simples Conjunto de registros é exibida.
    Caixa de diálogo Conjunto de registros

    Observação:

    Mas caso seja exibida a caixa de diálogo avançada, alterne para a caixa de diálogo simples clicando no botão Simples.

  4. Digite um nome para o conjunto de registros e selecione uma conexão.

    A conexão deve ser com um banco de dados que contenha os dados a serem pesquisados pelo usuário.

  5. No menu pop-up Tabela, selecione a tabela a ser procurada no banco de dados.

    Observação:

    Em uma pesquisa com parâmetro único, você pode procurar registros em apenas uma tabela. Para pesquisar mais de uma tabela simultaneamente, você deve usar a caixa de diálogo avançada Conjunto de registros e definir uma consulta SQL.

  6. Para incluir apenas algumas das colunas da tabela no conjunto de registros, clique em Selecionado e escolha as colunas desejadas clicando nelas com a tecla Control pressionada (Windows) ou Command (Macintosh) na lista.

    Você deve incluir apenas as colunas que contenham as informações a serem exibidas na página de resultados.

    Saia da caixa de diálogo Conjunto de registros por enquanto. Você a usará para recuperar os parâmetros enviados pela página de pesquisa e criar um filtro do conjunto de registros a fim de excluir os registros que não atendam aos parâmetros.

Criar o filtro do conjunto de registros

  1. No primeiro menu pop-up na área Filtro, selecione uma coluna da tabela do banco de dados na qual procurar uma correspondência.

    Por exemplo, caso o valor enviado pela página de pesquisa seja o nome de uma cidade, selecione a coluna da tabela que contém nomes de cidades.

  2. No menu pop-up ao lado do primeiro menu, selecione o sinal de igual (ele deve ser o padrão).
  3. No terceiro menu pop-up, selecione Variável de formulário caso o formulário na página de pesquisa use o método POST ou Parâmetro de URL caso ele use o método GET.

    A página de pesquisa usa uma variável de formulário ou um parâmetro de URL a fim de passar informações para a página de resultados.

  4. 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 é duplicado como o nome da variável de formulário ou do parâmetro de URL. Você pode obter o nome alternando 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, suponhamos que você queira criar um conjunto de registros que inclua apenas viagens de aventura para um país específico. Vamos pressupor que haja uma coluna na tabela chamada TRIPLOCATION. Além disso, suponhamos que o formulário em HTML na página de pesquisa use o método GET e contenha um objeto de menu chamado Location que exibe uma lista dos países. O seguinte exemplo mostra como a seção Filtro deve ficar:

    Parâmetros de objeto de formulário
  5. (Opcional) Clique em Testar, digite um valor de teste e clique em OK para se conectar ao banco de dados e criar uma ocorrência do conjunto de registros.

    O valor de teste simula o valor que retornaria da página de pesquisa. Clique em OK para fechar o conjunto de registros de teste.

  6. Caso você esteja satisfeito com o conjunto de registros, clique em OK.

    Um script do servidor é inserido na página que verifica todos os registros na tabela do banco de dados quando executada no servidor. Caso o campo especificado em um registro atenda à condição de filtragem, o registro é incluído em um conjunto de registros. O script cria um conjunto de registros contendo apenas os resultados da pesquisa.

    A próxima etapa é exibir o conjunto de registros na página de resultados. Para obter mais informações, consulte Exibição dos resultados da pesquisa.

Criar uma página de resultados avançada

Caso a página de pesquisa envie mais de um parâmetro de pesquisa ao servidor, você deve escrever uma consulta SQL para a página de resultados e usar os parâmetros de pesquisa em variáveis SQL.

Observação:

Caso tenha apenas uma condição de pesquisa, você pode usar a caixa de diálogo simples Conjunto de registros para definir o conjunto de registros (consulte Criar uma página de resultados básica ).

  1. Abra a página de resultados no Dreamweaver e, em seguida, crie um conjunto de registros abrindo o painel Ligações (Janela > Ligações), clicando no botão de adição (+) e selecionando Conjunto de registros no menu pop-up.
  2. 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. Mas caso seja exibida a caixa de diálogo simples, alterne para a caixa de diálogo avançada clicando no botão Avançado.

  3. Digite um nome para o conjunto de registros e selecione uma conexão.

    A conexão deve ser com um banco de dados que contenha os dados a serem pesquisados pelo usuário.

  4. Insira uma instrução Select na área de texto SQL.

    Verifique se a instrução inclui uma cláusula WHERE com variáveis que mantêm os parâmetros de pesquisa. No seguinte exemplo, 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 o trabalho de digitação, você pode usar os três itens de banco de dados na parte inferior da caixa de diálogo avançada Conjunto de registros. Para obter instruções, consulte Definir um conjunto de registros avançado escrevendo em SQL.

    Para obter ajuda sobre a sintaxe SQL, consulte o SQL primer em www.adobe.com/go/learn_dw_sqlprimer_br.

  5. Atribua às variáveis SQL os valores dos parâmetros de pesquisa clicando no botão de adição (+) na área Variáveis e digitando o nome da variável, o valor padrão (o valor que a variável deve assumir caso não retorne nenhum valor de runtime) e o valor de runtime (normalmente um objeto de servidor que mantém um valor enviado por um navegador como, por exemplo, uma variável de solicitação).

    No seguinte exemplo em ASP, o formulário em HTML na página de pesquisa usa o método GET e contém um campo de texto chamado LastName e outro chamado Department:

    Exemplo em ASP

    No ColdFusion, os valores de runtime seriam #LastName# e #Department#. No PHP, os valores de runtime devem ser $_REQUEST["LastName"] e $_REQUEST["Department"].

  6. (Opcional) Clique em Testar para criar uma ocorrência do conjunto de registros usando os valores de variável padrão.

    Os valores padrão simulam os valores que retornariam da página de pesquisa. Clique em OK para fechar o conjunto de registros de teste.

  7. 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 manter os resultados da pesquisa, você deve exibir as informações na página de resultados. Exibir os registros pode ser uma simples questão de arrastar colunas individuais do painel Ligações para a página de resultados. Você pode adicionar links de navegação para avançar e retornar o conjunto de registros, ou criar uma região repetitiva para exibir mais de um registro na página. Você também pode adicionar links a uma página detalhada.

Para obter mais informações sobre métodos de exibição do conteúdo dinâmico em uma página que não seja o de exibição dos resultados em uma tabela dinâmica, consulte Exibição dos registros do banco de dados.

  1. Coloque o ponto de inserção onde você deseja que a tabela dinâmica seja exibida na página de resultados e selecione Inserir > Objetos de dados > Dados dinâmicos > Tabela dinâmica.
  2. Complete a caixa de diálogo Tabela dinâmica, selecionando o conjunto de registros definido por você para manter os resultados de pesquisa.
  3. Clique em OK. Uma tabela dinâmica que exibe resultados de pesquisa é inserida na página de resultados.

Criar uma página detalhada para uma página de resultados

O conjunto de páginas de pesquisa e de resultados pode incluir uma página detalhada para exibir mais informações sobre registros específicos da página de resultados. Nessa situação, a página de resultados também é duplicada como página mestre em um conjunto de páginas mestre/detalhadas.

Você pode criar um link que abre uma página relacionada e passa parâmetros existentes para essa página. O comportamento do servidor só está disponível quando se usa o modelo de servidor ASP.

Antes de adicionar um comportamento de servidor Ir para página relacionada a uma página, verifique se ela recebe parâmetros de formulário ou URL de outra página. A função do comportamento de servidor é passar esses parâmetros para uma terceira página. Por exemplo, você pode passar os parâmetros de pesquisa recebidos por uma página de resultados para outra página e evitar que o usuário digite novamente esses parâmetros.

Além disso, você pode selecionar um texto ou uma imagem da página para servir como o link para a página relacionada ou posicionar o ponteiro na página sem selecionar nada, e o texto do link é inserido.

  1. Na caixa Ir para página relacionada, clique em Procurar e localize o arquivo da página relacionada.

    Caso a página atual envie dados para ela própria, digite o nome do arquivo da página atual.

  2. Caso os parâmetros que você deseja passar tenham sido recebidos diretamente de um formulário em HTML usando o método GET ou estejam listados no URL da página, selecione a opção Parâmetros de URL.
  3. Caso os parâmetros que você deseja passar tenham sido recebidos diretamente de um formulário em HTML usando o método POST, selecione a opção Parâmetros de formulário.
  4. Clique em OK.

    Quando o novo link é clicado, a página passa os parâmetros para a página relacionada usando uma sequência de caracteres de consulta.

Esta obra está licenciada sob uma licença não adaptada da Creative Commons Attribution-Noncommercial-Share Alike 3.0  As publicações do Twitter™ e do Facebook não são cobertas pelos termos do Creative Commons.

Avisos legais   |   Política de privacidade online