Criar uma página de registro de atualização no Dreamweaver

Última atualização em 25/04/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 as páginas de atualização do registro

Seu aplicativo pode conter um conjunto de páginas que permite aos usuários atualizar registros existentes em uma tabela do banco de dados. As páginas normalmente consistem em uma página de pesquisa, uma página de resultados e uma página de atualização. A página de pesquisa e resultados permite aos usuários recuperar o registro e a página de atualização permite aos usuários modificar o registro.

Procurar o registro a ser atualizado

Quando os usuários querem atualizar um registro, devem primeiro encontrar esse registro no banco de dados. Consequentemente, você precisa de uma página de pesquisa e uma de resultados para trabalhar com a página de atualização. O usuário insere critérios de pesquisa na página de pesquisa e seleciona o registro na página de resultados. Quando o usuário clica no registro na página de resultados, a página de atualização abre e exibe o registro em um formulário HTML.

Após criar as páginas de pesquisa e resultados, você cria links na página de resultados para abrir a página de atualização. Você então modifica os links para passar os IDs dos registros que o usuário seleciona. A página de atualização usa esse ID para encontrar o registro solicitado no banco de dados e exibi-lo.

Você usa o mesmo processo para abrir a página de atualização e passar um ID de registro que usa para abrir uma página de detalhes e passar um ID de registro. Para mais informações, consulte Criar links para a página de detalhes.

Recuperar o registro a ser atualizado

Após a página de resultados passar um ID de registro para a página de atualização identificando o registro a ser atualizado, a página de atualização deve ler o parâmetro, recuperar o registro da tabela do banco de dados e armazená-lo temporariamente em um conjunto de registros.

Criar uma página no Dreamweaver e salvá-la.

A página se tornará a página de atualização.

No painel Vinculações (Janela > Vinculações), clique no botão Mais (+) e selecione Conjunto de registros.

Caso seja exibida a caixa de diálogo avançada, clique em Simples. A caixa de diálogo avançada tem uma área de texto para inserir instruções SQL; a simples não tem.

Nomeie o conjunto de registros e especifique onde os dados que você quer atualizar estão localizados usando os menus pop-up Conexão e Tabela.
Clique em Selecionadas e selecione uma coluna de chave (geralmente a coluna ID do registro) e as colunas que contêm os dados a serem atualizados.
Configure a área de filtro para que o valor da coluna de chave seja igual ao valor do parâmetro de URL correspondente passado pela página de resultados.

Esse tipo de filtro cria um conjunto de registros que contém apenas o registro especificado pela página de resultados. Por exemplo, se sua coluna de chave contém informações de ID do registro e é chamada PRID, e se a página de resultados passa as informações de ID do registro correspondentes no parâmetro de URL chamado id, a área Filtro deve parecer com o seguinte exemplo:

Área de filtro

Clique em OK.

Quando o usuário seleciona um registro na página de resultados, a página de atualização gera um conjunto de registros contendo apenas o registro selecionado.

Concluir a página de atualização bloco por bloco

Uma página de atualização tem três blocos de criação:

  • Um conjunto de registros filtrado para recuperar o registro de uma tabela do banco de dados
  • Um formulário em HTML para permitir aos usuários modificar os dados do registro
  • Um comportamento de servidor Atualizar registro para atualizar a tabela do banco de dados

    Você pode adicionar os dois blocos básicos finais de uma página de atualização separadamente usando as ferramentas de formulário e o painel Comportamentos do servidor.

Adicionar um formulário em HTML a uma página de atualização

Criar uma página (Arquivo > Novo > Página em branco).Essa se torna a página de atualização.
Projete sua página usando as ferramentas de design do Dreamweaver.
Adicione um formulário HTML colocando o ponto de inserção onde você deseja que o formulário apareça e selecionando Inserir > Formulário > Formulário.

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

Nomeie o formulário HTML clicando na <form> tag na parte inferior da janela Documento para selecionar o formulário, abrindo o Inspetor de propriedades (Janela > Propriedades) e inserindo um nome na caixa Nome do formulário.

Não é necessário especificar um atributo action ou method para o formulário informar onde e como enviar os dados do registro quando o usuário clicar no botão Enviar. O comportamento do servidor Atualizar registro define esses atributos para você.

Adicione um objeto de formulário como um campo de texto (Inserir > Formulário > Campo de texto) para cada coluna que você deseja atualizar na tabela do banco de dados.

Os objetos de formulário se destinam à entrada de dados. Os campos de texto são comuns para essa finalidade, mas você também pode usar menus, opções e botões de opção.

Cada objeto de formulário deve ter uma coluna correspondente no conjunto de registros definido anteriormente. A única exceção é a coluna de chave exclusiva, que não deve ter um objeto de formulário correspondente.

Adicione um botão Enviar ao formulário (Inserir > Formulário > Botão).

Você pode alterar 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 Rótulo.

Exibir o registro no formulário

Certifique-se de ter definido um conjunto de registros para manter o registro que o usuário deseja atualizar.

Adicionar um comportamento do servidor para atualizar a tabela do banco de dados

No painel Comportamentos do servidor (Janela > Comportamentos do servidor), clique no botão Mais (+) e selecione Atualizar registro no menu pop-up.

A caixa de diálogo Atualizar registro é exibida.

Selecione um formulário no menu pop-up Enviar valores de.
No menu pop-up Fonte de dados ou Conexão, selecione uma conexão com o banco de dados.
Digite o nome do usuário e a senha, se aplicável.
No menu pop-up Atualizar tabela, selecione a tabela do banco de dados que contém o registro que você está atualizando.
(ColdFusion, PHP) Especifique uma coluna do banco de dados para atualizar, selecione o objeto de formulário que atualizará a coluna no menu pop-up Valor, selecione um tipo de dados para o objeto de formulário no menu pop-up Enviar como e selecione Chave principal se quiser identificar esta coluna como a chave principal.

O tipo de dados é o tipo de dados que a coluna na tabela do banco de dados está esperando (texto, numérico, valores de opção booleana).

Repita o procedimento para cada objeto de formulário no seu formulário.

(ASP) No menu pop-up Selecionar registro de, especifique o conjunto de registros que contém o registro exibido no formulário HTML. No menu pop-up Coluna de chave exclusiva, selecione uma coluna de chave (geralmente a coluna de ID do registro) para identificar o registro na tabela do banco de dados. Selecione a opção Numérico, caso o valor seja um número. Uma coluna de chave geralmente aceita apenas valores numéricos, mas às vezes aceita valores de texto.
Na caixa Após atualização ou Em caso de êxito, ir para, insira a página para abrir depois que o registro for atualizado na tabela ou clique no botão Procurar para navegar até o arquivo.
(ASP) Especifique uma coluna do banco de dados para atualizar, selecione o objeto de formulário que atualizará a coluna no menu pop-up Valor e então selecione um tipo de dados para o objeto de formulário no menu pop-up Enviar como. O tipo de dados é o tipo de dados que a coluna na tabela do banco de dados está esperando (texto, numérico, valores de opção booleana). Repita o procedimento para todos os formulários.
Clique em OK.

Dreamweaver adiciona um comportamento do servidor à página que permite aos usuários atualizar registros em uma tabela do banco de dados modificando as informações exibidas no formulário HTML e clicando no botão Enviar.

Para editar o comportamento do servidor, abra o painel Comportamentos do servidor (Janela > Comportamentos do servidor) e clique duas vezes no comportamento Atualizar registro.

Concluir a página de atualização em uma operação

Uma página de atualização tem três componentes:

  • Um conjunto de registros filtrado para recuperar o registro de uma tabela do banco de dados

  • Um formulário em HTML para permitir aos usuários modificar os dados do registro

  • Um comportamento de servidor Atualizar registro para atualizar a tabela do banco de dados

Você pode adicionar os dois blocos de construção finais de uma página de atualização em uma única operação usando o objeto de dados Formulário de atualização de registro. O objeto de dados adiciona tanto um formulário HTML quanto um comportamento do servidor Atualizar Registro à página.

Antes de usar o objeto de dados, seu aplicativo web deve ser capaz de identificar o registro a ser atualizado, e sua página de atualização deve ser capaz de recuperá-lo.

Depois que o objeto de dados coloca os blocos de construção na página, você pode usar as Ferramentas de design do Dreamweaver para personalizar o formulário como desejar, ou o painel Comportamentos do servidor para editar o comportamento do servidor Atualizar registro.

Nota

A página de atualização pode conter apenas um comportamento do servidor de edição de registro por vez. Por exemplo, você não pode adicionar um comportamento do servidor Inserir registro ou Excluir registro à página de atualização.

Abra a página na visualização Design e selecione Inserir > Objetos de dados > Atualizar registro > Assistente de formulário de atualização de registro.

A caixa de diálogo Registrar formulário de atualização é exibida.

No menu pop-up Conexão, selecione uma conexão com o banco de dados.

Clique no botão Definir caso você precise definir uma conexão.

No menu pop-up Tabela a atualizar, selecione a tabela do banco de dados que contém o registro a ser atualizado.
No menu pop-up Selecionar registro de, especifique o conjunto de registros que contém o registro exibido no formulário HTML.
No menu pop-up Coluna de chave única, selecione uma coluna de chave (geralmente a coluna ID do registro) para identificar o registro na tabela do banco de dados.

Caso o valor seja um número, selecione a opção Numérico. Uma coluna de chave geralmente aceita apenas valores numéricos, mas às vezes aceita valores de texto.

Na caixa Depois da atualização, ir para, insira a página a ser aberta após a atualização do registro na tabela.
Na área Campos do formulário, especifique quais colunas da tabela do banco de dados cada objeto de formulário deve atualizar.

Por padrão, Dreamweaver cria um objeto de formulário para cada coluna na tabela do banco de dados. Se o banco de dados gerar automaticamente IDs de chave únicos para cada novo registro criado, remova o objeto de formulário correspondente à coluna de chave selecionando-o na lista e clicando no botão Menos (-). Isso elimina o risco de que o usuário do formulário insira um valor de ID que já existe.

Também é possível alterar a ordem dos objetos de formulário no formulário HTML selecionando um objeto de formulário na lista e clicando na seta para cima ou para baixo no lado direito da caixa de diálogo.

Especifique como cada campo de entrada de dados deve aparecer no formulário HTML clicando em uma linha na tabela Campos do formulário e inserindo as seguintes informações nas caixas abaixo da tabela:
  • Na caixa Rótulo, digite um rótulo descritivo a ser exibido ao lado do campo de entrada de dados. Por padrão, Dreamweaver exibe o nome da coluna da tabela no rótulo.

  • No menu pop-up Exibir como, selecione um objeto de formulário para servir como campo de entrada de dados. Você pode selecionar Campo de texto, Área de texto, Menu, Caixa de seleção, Grupo de botões de opção e Texto. Para entradas somente leitura, selecione Texto. Você também pode selecionar Campo de senha, Campo de arquivo e Campo oculto.

Nota

Os campos ocultos são inseridos ao final do formulário.

  • No menu pop-up Enviar como, selecione o formato de dados esperado pela tabela do banco de dados. Por exemplo, caso a coluna da tabela aceite apenas dados numéricos, selecione Numérico.
  • Defina as propriedades do objeto de formulário. Você conta com opções diferentes dependendo do objeto de formulário selecionado por você como o campo de entrada de dados. Para campos de texto, áreas de texto e texto, você pode inserir um valor inicial. Para menus e grupos de botões de opção, você abre outra caixa de diálogo a fim de definir as propriedades. Para opções, selecione a opção Marcado ou Desmarcado.  
Configure as propriedades de outros objetos de formulário selecionando outra linha de Campos do formulário e inserindo um rótulo, Valor de exibição como e Valor de envio como.

Para menus e grupos de botões de opção, abra outra caixa de diálogo para definir as propriedades. Para opções, defina uma comparação entre o valor do registro atual para a opção e um valor específico para determinar se a opção está marcada quando o registro é exibido.

Clique em OK.

Dreamweaver adiciona um formulário HTML e um comportamento de servidor Atualizar registro à página.

O objeto de dados adiciona um formulário HTML e um comportamento de servidor de atualização de registro à sua página.Os objetos de formulário são organizados em uma tabela básica, que você pode personalizar usando as ferramentas de design de página do Dreamweaver. (Certifique-se de que todos os objetos de formulário permaneçam dentro dos limites do formulário.)

Para editar o comportamento do servidor, abra o painel Comportamentos do servidor (Janela > Comportamentos do servidor) e clique duas vezes no comportamento Atualizar registro.

Opções de Propriedades do elemento de formulário

O objetivo da caixa de diálogo Propriedades do elemento de formulário é definir as opções para elementos de formulário em páginas que permitem aos usuários atualizar registros em um banco de dados.

Selecione Manualmente ou Do banco de dados, dependendo de como planeja criar o elemento de formulário.
Clique no botão de adição (+) para adicionar um elemento.
Digite um rótulo e um valor para o elemento.
Na caixa Selecionar Valor Igual A, se desejar que um elemento específico seja selecionado quando a página abrir em um navegador ou quando um registro for exibido no formulário, insira um valor igual ao valor do elemento.

Você pode inserir um valor estático ou especificar um valor dinâmico clicando no ícone de raio e selecionando um valor dinâmico na lista de fontes de dados.Em ambos os casos, o valor especificado deve corresponder a um dos valores do elemento.