Na janela Documento, abra a página que vai
usar o conjunto de registros.
Ú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).
Definir um conjunto de registros sem escrever SQL
Você pode criar um conjunto de registros sem inserir manualmente instruções SQL.
Selecione Janela > Vínculos para exibir o
painel Vínculos.
No
painel Vínculos, clique no botão Mais (+) e selecione Conjunto de registros
(Consulta) no menu pop-up.
A caixa de diálogo simples Conjunto de registros é exibida. Se você está desenvolvendo um site ColdFusion, a caixa de diálogo Conjunto de registros é ligeiramente diferente.(Se a caixa de diálogo avançada Conjunto de registros aparecer, clique no botão Simples para alternar para a caixa de diálogo simples Conjunto de registros.)
Complete a caixa de diálogo Conjunto de registros referente ao tipo de documento.
Para obter instruções, consulte os tópicos abaixo.
Clique no botão Teste para executar a consulta e garantir
que ela recupere as informações desejadas.
Se você definiu um filtro que usa parâmetros inseridos pelos usuários, insira um valor na caixa Valor de teste e clique em OK.Se uma instância do conjunto de registros for criada com sucesso, uma tabela aparece exibindo dados extraídos do conjunto de registros.
Clique em OK para adicionar o conjunto de registros à lista de
fontes de conteúdo disponíveis no painel Vínculos.
Opções para a caixa de diálogo simples Conjunto de registros (PHP, ASP)
Na caixa Nome, insira um nome para o conjunto de registros.
Uma prática comum é adicionar o prefixo rs aos nomes de conjuntos de registros para distingui-los de outros nomes de objetos no código, por exemplo: rsPressReleases.
Nomes de conjuntos de registros podem conter apenas letras, números e o caractere sublinhado (_). Você não pode usar caracteres especiais ou espaços.
Selecione uma conexão no menu pop-up Conexão.
Se nenhuma conexão aparecer na lista, clique em Definir para criar uma.
No menu pop-up Tabela, selecione a tabela do banco de dados que fornecerá dados ao conjunto de registros.
O menu pop-up exibe todas as tabelas no banco de dados especificado.
Para incluir um subconjunto das colunas da tabela no conjunto de registros, clique em Selecionadas e escolha as colunas desejadas clicando nelas com Ctrl pressionado (Windows) ou Command pressionado (Macintosh) na lista.
Para limitar ainda mais os registros retornados da tabela, complete a seção Filtro:
No primeiro menu pop-up, selecione uma coluna na tabela do banco de dados para comparar com um valor de teste que você definir.
No segundo menu pop-up, selecione uma expressão condicional para comparar o valor selecionado em cada registro com o valor de teste.
No terceiro menu pop-up, selecione Valor digitado.
Na caixa, digite o valor de teste.
Se o valor especificado em um registro atender sua condição de filtragem, o registro é incluído no conjunto de registros.
(Opcional) Para classificar os registros, selecione uma coluna para classificar, e então especifique se os registros devem ser classificados em ordem crescente (1, 2, 3... ou A, B, C...) ou ordem decrescente.
Clique em Teste para se conectar ao banco de dados e criar uma instância da fonte de dados, e clique em OK para fechar a fonte de dados.
Uma tabela é exibida mostrando os dados retornados. Cada linha contém um registro e cada coluna representa um campo nesse registro.
Clique em OK. O conjunto de registros recém-definido aparece no painel Vinculações.
Opções da caixa de diálogo Conjunto de registros simples (ColdFusion)
Defina um conjunto de registros para tipos de documentos ColdFusion como uma fonte de conteúdo dinâmico sem precisar codificar manualmente instruções SQL.
Na caixa Nome, digite um nome para o conjunto de registros.
Uma prática comum é adicionar o prefixo rs aos nomes dos conjuntos de registros para distingui-los de outros nomes de objetos no código. Por exemplo: rsPressReleases
Os nomes dos conjuntos de registros podem conter apenas letras, números e o caractere de sublinhado (_). Você não pode usar caracteres especiais ou espaços.
Se você estiver definindo um conjunto de registros para um componente ColdFusion (ou seja, se um arquivo CFC estiver aberto no Dreamweaver), selecione uma função CFC existente no menu pop-up Função ou clique no botão Nova função para criar uma nova função.
Nota
O menu pop-up Função só está disponível se um arquivo CFC for o documento atual e você tiver acesso a um computador com ColdFusion MX 7 ou superior em execução.
O conjunto de registros é definido na função.
Selecione uma fonte de dados no menu pop-up Fonte de dados.
Se nenhuma fonte de dados aparecer no menu pop-up, você deve criar uma fonte de dados ColdFusion.
Nas caixas Nome do usuário e Senha, digite o nome do usuário e a senha do servidor de aplicativo ColdFusion, se necessário.
As fontes de dados em ColdFusion podem exigir um nome de usuário e senha para acessá-las. Se você não tiver o nome de usuário e a senha para acessar uma fonte de dados no ColdFusion, entre em contato com o administrador ColdFusion da organização.
No menu pop-up Tabela, selecione a tabela do banco de dados que fornece dados para o conjunto de registros.
O menu pop-up Tabela exibe todas as tabelas no banco de dados especificado.
Para incluir um subconjunto das colunas da tabela no conjunto de registros, clique em Selecionado e escolha as colunas desejadas mantendo pressionado Ctrl (Windows) ou Command (Macintosh) ao clicar nelas na lista.
Para limitar ainda mais os registros retornados da tabela, preencha a seção Filtro:
No primeiro menu pop-up, selecione uma coluna na tabela do banco de dados para comparar com um valor de teste que você define.
No segundo menu pop-up, selecione uma expressão condicional para comparar o valor selecionado em cada registro com o valor de teste.
No terceiro menu pop-up, selecione Valor digitado.
Na caixa, digite o valor de teste.
Se o valor especificado em um registro atender à condição de filtragem, o registro será incluído no conjunto de registros.
(Opcional) Para classificar os registros, selecione uma coluna para classificar e especifique se os registros devem ser classificados em ordem crescente (1, 2, 3... ou A, B, C...) ou ordem decrescente.
Clique em Testar para conectar ao banco de dados e criar uma instância da fonte de dados.
Uma tabela aparece exibindo os dados retornados. Cada linha contém um registro e cada coluna representa um campo nesse registro. Clique em OK para fechar o conjunto de registros de teste.
Clique em OK. O conjunto de registros ColdFusion recém-definido aparece no painel Vínculos.
Definir um conjunto de registros avançado escrevendo SQL
Escreva suas próprias instruções SQL usando a caixa de diálogo Conjunto de registros avançado ou crie uma instrução SQL usando a árvore gráfica Itens do banco de dados.
Na janela Documento, abra a página que
usará o conjunto de registros.
Selecione Janela > Vínculos para exibir o
painel Vínculos.
No painel Vínculos, clique no botão Mais (+) e
selecione Conjunto de registros (consulta) no menu pop-up.
A caixa de diálogo avançada Conjunto de registros é exibida. Se você está desenvolvendo um local ColdFusion, a caixa de diálogo Conjunto de registros é ligeiramente diferente. (Se a caixa de diálogo Conjunto de registros simples aparecer, mude para a caixa de diálogo Conjunto de registros avançada clicando no botão Avançado.)
Complete a caixa de diálogo avançada Conjunto de registros.
Para obter instruções, consulte os tópicos abaixo.
Clique no botão Teste para executar a consulta e garantir
que ela recupere as informações desejadas.
Se você definiu um filtro que usa parâmetros inseridos pelos usuários, o botão Teste exibe a caixa de diálogo Valor de teste. Digite um valor na caixa Valor de teste e clique em OK. Se uma instância do conjunto de registros for criada com sucesso, aparecerá uma tabela exibindo os dados do conjunto de registros.
Clique em OK para adicionar o conjunto de registros à lista de
fontes de conteúdo disponíveis no painel Vínculos.
Opções para a caixa de diálogo Conjunto de registros avançada (PHP, ASP)
Defina um conjunto de registros como origem de conteúdo dinâmico escrevendo uma instrução SQL personalizada ou criando uma instrução SQL usando a árvore gráfica Itens do banco de dados.
Na caixa Nome, digite um nome para o conjunto de registros.
Uma prática comum é adicionar o prefixo rs aos nomes dos conjuntos de registros para distingui-los de outros nomes de objetos no código. Por exemplo: rsPressRelease
Os nomes dos conjuntos de registros podem conter apenas letras, números e o caractere sublinhado (_). Não é possível usar caracteres especiais ou espaços.
Selecione uma conexão no menu pop-up Conexão.
Digite uma instrução SQL na área de texto SQL ou use a
árvore gráfica Itens do banco de dados na parte inferior da caixa de diálogo para
criar uma instrução SQL a partir do conjunto de registros escolhido.
Faça o seguinte para usar a árvore Itens do banco de dados para criar a instrução SQL:
Verifique se a área de texto SQL está em branco.
Expanda as ramificações da árvore até encontrar o objeto de banco de dados necessário — uma coluna em uma tabela, por exemplo, ou um procedimento armazenado no banco de dados.
Selecione o objeto de banco de dados e clique em um dos botões no lado direito da árvore.
Por exemplo, se você selecionar uma coluna de tabela, os botões disponíveis são SELECT, WHERE e ORDER BY. Clique em um dos botões para adicionar a cláusula associada à sua instrução SQL.
Você também pode usar uma instrução SQL predefinida em um procedimento armazenado selecionando o procedimento armazenado da árvore Itens de banco de dados e clicando no botão Procedimento. Dreamweaver preenche automaticamente as áreas SQL e Variável.
Se
a instrução SQL contiver variáveis, defina os valores na
área Variáveis clicando no botão Mais (+) e inserindo o
nome da variável, tipo (inteiro, texto, data ou número de precisão decimal),
valor padrão (o valor que a variável deve assumir se nenhum valor de tempo de execução
for retornado) e valor de tempo de execução.
Nota
Ao usar variáveis em uma instrução SQL no PHP, Dreamweaver automaticamente adiciona um cifrão antes do nome da variável, então você deve omitir o cifrão (por exemplo, colname, em vez de $colname).
Se a instrução SQL contiver variáveis, certifique-se de que a coluna Valor padrão da caixa Variáveis contenha valores de teste válidos.
O valor de tempo de execução geralmente é um parâmetro de URL ou formulário inserido por um usuário em um campo de formulário HTML.
Parâmetros de URL na coluna Valor de tempo de execução:
|
Modelo do servidor |
Expressão do valor de runtime para o parâmetro de URL |
|
ASP |
Request.QueryString(“formFieldName”) |
|
PHP |
$_GET['formFieldName'] |
Parâmetros de formulário na coluna Valor de runtime:
|
Modelo do servidor |
Expressão do valor de runtime para o parâmetro de formulário |
|
ASP |
Request.Form(“formFieldName”) |
|
PHP |
$_POST['formFieldName'] |
Clique em Testar para conectar ao banco de dados e criar uma instância do conjunto de registros.
Se a instrução SQL contiver variáveis, certifique-se de que a coluna Valor padrão da caixa Variáveis contenha valores de teste válidos antes de clicar em Teste.
Se bem-sucedido, aparece uma tabela exibindo os dados no seu conjunto de registros. Cada linha contém um registro e cada coluna representa um campo nesse registro. Clique em OK para limpar o conjunto de registros.
Caso esteja satisfeito com o trabalho, clique em OK.
Opções para a caixa de diálogo Conjunto de registros avançada (ColdFusion)
Use a caixa de diálogo Conjunto de registros avançada para escrever consultas SQL personalizadas ou use a árvore Itens de banco de dados para criar consultas SQL usando uma interface de apontar e clicar.
Na caixa Nome, digite um nome para o conjunto de registros.
Uma prática comum é adicionar o prefixo rs aos nomes de conjuntos de registros para distingui-los de outros nomes de objetos no seu código. Por exemplo: rsPressReleases
Os nomes de conjuntos de registros podem conter apenas letras, números e o caractere sublinhado (_). Você não pode usar caracteres especiais ou espaços.
Se você estiver definindo um conjunto de registros para um componente ColdFusion (ou seja, se um arquivo CFC estiver aberto no Dreamweaver), selecione uma função CFC existente no menu pop-up Função ou clique no botão Nova função para criar uma nova função.
Nota
O menu pop-up Função está disponível apenas se um arquivo CFC for o documento atual e você tiver acesso a um computador executando ColdFusion MX 7 ou superior.
O conjunto de registros é definido na função.
Selecione uma fonte de dados no menu pop-up Fonte de dados.
Se nenhuma fonte de dados aparecer na lista do menu pop-up, você precisará primeiro criar uma fonte de dados ColdFusion.
Nas caixas Nome de usuário e Senha, insira o nome de usuário
e a senha do servidor de aplicativo ColdFusion, se necessário.
As fontes de dados no ColdFusion podem exigir um nome de usuário e senha para acessá-las. Se não tiver o nome de usuário e a senha para acessar uma fonte de dados no ColdFusion, entre em contato com o administrador do ColdFusion da organização.
Insira uma instrução SQL na área de texto SQL ou use a
árvore gráfica Itens do banco de dados na parte inferior da caixa de diálogo para
criar uma instrução SQL a partir do recordset escolhido.
(Opcional) Faça o seguinte para usar a árvore Itens do banco
de dados para criar a instrução SQL:
Verifique se a área de texto SQL está em branco.
Expanda as ramificações da árvore até encontrar o objeto de banco de dados necessário — por exemplo, uma coluna em uma tabela.
Selecione o objeto do banco de dados e clique em um dos botões do lado direito da árvore.
Por exemplo, se selecionar uma coluna da tabela, os botões disponíveis são Select, Where e Order By.Clique em um dos botões para adicionar a cláusula associada à instrução SQL.
Se a instrução SQL contiver parâmetros, defina os valores na área Parâmetros clicando no botão Mais (+) e inserindo o nome do parâmetro e o valor padrão (o valor que o parâmetro deve ter se nenhum valor de tempo de execução for retornado).
Se a instrução SQL contiver parâmetros, verifique se a coluna Valor padrão da caixa Parâmetros contém valores de teste válidos.
Os Parâmetros de página permitem fornecer valores padrão para referências de valor de tempo de execução no SQL que você escreve. Por exemplo, a seguinte instrução SQL seleciona um registro de funcionário baseado no valor do ID do funcionário. É possível atribuir um valor padrão a este parâmetro, garantindo que um valor de tempo de execução seja sempre retornado. Neste exemplo, FormFieldName refere-se a um campo de formulário no qual o usuário insere um ID de funcionário:
SELECT * FROM Employees WHERE EmpID = + (Request.Form(#FormFieldName#))
A caixa de diálogo Adicionar parâmetros de página conteria um emparelhamento nome-valor similar a:
|
Nome |
Valores padrão |
|
FormFieldName |
0001 |
O valor de tempo de execução geralmente é uma URL ou parâmetro de formulário inserido por um usuário em um campo de formulário HTML.
Clique em Teste para conectar-se ao banco de dados e criar uma instância
do recordset.
Se a instrução SQL contiver referências de tempo de execução, verifique se a coluna Valor padrão do campo Parâmetros de página contém valores de teste válidos antes de clicar em Teste.
Se bem-sucedido, aparece uma tabela mostrando os dados no recordset. Cada linha contém um registro e cada coluna representa um campo nesse registro. Clique em OK para limpar o recordset.
Caso esteja satisfeito com o trabalho, clique em OK.
Definir parâmetros em uma instrução SQL (ColdFusion)
Defina parâmetros em uma instrução SQL; o valor padrão é o valor que o parâmetro deve usar se nenhum valor de tempo de execução for retornado.
Selecione um nome de parâmetro no menu pop-up Nome.
Digite um valor padrão para o parâmetro na caixa Parâmetro
padrão e clique em OK.
Definir parâmetros em uma instrução SQL (PHP)
Definir parâmetros em uma instrução SQL; o valor padrão é o valor que o parâmetro deve usar se nenhum valor de tempo de execução for retornado.
Digite o nome de um parâmetro na caixa Nome.
Digite um valor padrão para o parâmetro na caixa Parâmetro
padrão.
Insira um valor de tempo de execução para um parâmetro na caixa Valor de tempo de execução e clique em OK.
Criar consultas SQL usando a árvore Itens de banco de dados
Em vez de digitar manualmente instruções SQL na caixa SQL, você pode usar a interface de apontar e clicar do Item de banco de dados para criar consultas SQL complexas.A árvore de Itens do banco de dados permite selecionar objetos de banco de dados e vinculá-los usando as cláusulas SQL SELECT, WHERE e ORDER BY.Depois de criar uma consulta SQL, você pode definir qualquer variável usando a área Variáveis da caixa de diálogo.
Os dois exemplos a seguir descrevem duas instruções SQL e as etapas para criá-las usando a árvore Itens de banco de dados da caixa de diálogo Recordset avançado.
Exemplo: seleção de uma tabela
Este exemplo seleciona todo o conteúdo da tabela Funcionários. A instrução SQL que define a consulta aparece da seguinte forma:
SELECT * FROM Employees
Para criar esta consulta, siga estas etapas.
Expandir a ramificação Tabelas para exibir todas as
tabelas do banco de dados selecionado.
Selecione a tabela Funcionários.
Clique no botão Selecionar.
Clique em OK para adicionar o conjunto de registros ao painel Ligações.
Exemplo: Seleção de linhas específicas de uma tabela e ordenação dos resultados
O exemplo a seguir seleciona duas linhas da tabela Funcionários e seleciona o tipo de trabalho usando uma Variável que você deve definir. Em seguida, os resultados são ordenados pelo nome de funcionário.
SELECT emplNo, emplName
FROM Employees
WHERE emplJob = 'varJob'
ORDER BY emplName
Expandir a ramificação Tabelas para exibir todas as
tabelas do banco de dados selecionado; em seguida, mostrar a tabela Employees
para exibir as linhas de tabela individuais.
Crie a instrução SQL da seguinte forma:
Selecione emplNo e clique no botão Selecionar.
Selecione emplName e clique no botão Selecionar.
Selecionar emplJob, e clicar no botão Where.
Selecione emplName e clique no botão Classificar por.
Posicione o cursor após WHERE emplJob na
área de texto SQL e digite ='varJob' (inclua o
sinal de igual).
Defina a variável 'varJob' clicando no botão Mais (+) na área Variáveis e inserindo os seguintes valores nas colunas Nome, Valor Padrão e Valor de Tempo de Execução: varJob, CLERK, Request("job").
Clique em OK para adicionar o conjunto de registros ao painel Ligações.
Definir parâmetros de URL
Os parâmetros de URL armazenam informações recuperadas inseridas por usuários. Antes de começar, certifique-se de passar um formulário ou parâmetro de URL para o servidor. Após definir a variável de URL, você pode usar seu valor na página atualmente selecionada.
Na janela Documento, abra a página que usará a variável.
Selecione Windows > Bindings para exibir o
painel Bindings.
No painel Bindings, clique no botão Mais (+) e
selecione uma das seguintes opções no menu pop-up:
|
Tipos de documento |
Item de menu no painel Ligações da variável de URL |
|
ASP |
Variável de solicitação > Request.QueryString |
|
ColdFusion |
Variável de URL |
|
PHP |
Variável de URL |
Na caixa de diálogo Variável de URL, insira o nome da variável de URL na caixa e clique em OK.
O nome da variável de URL normalmente é o nome do campo de formulário HTML ou objeto usado para obter seu valor.
A variável de URL é exibida no painel Ligações.
Definir parâmetros de formulário
Os parâmetros de formulário armazenam informações recuperadas que são incluídas na solicitação HTTP para uma página da Web. Se você criar um formulário que usa o método POST, os dados enviados pelo formulário são passados para o servidor. Antes de começar, certifique-se de passar um parâmetro de formulário para o servidor. Após definir o parâmetro de formulário como uma origem de conteúdo, você pode usar seu valor na página.
Na janela Documento, abra a página que usará a variável.
Selecione Windows > Bindings para exibir o
painel Bindings.
No painel Bindings, clique no botão Mais (+) e
selecione uma das seguintes opções no menu pop-up:
|
Tipos de documento |
Item de menu no painel Ligações da variável de formulário |
|
ASP |
Variável de solicitação > Request.Form |
|
ColdFusion |
Variável de formulário |
|
PHP |
Variável de formulário |
Na caixa de diálogo Variável de formulário, insira o nome da variável de formulário e clique em OK.O nome do parâmetro de formulário normalmente é o nome do campo de formulário HTML ou objeto usado para obter seu valor.
O parâmetro de formulário é exibido no painel Ligações.
Definir variáveis de sessão
Você pode usar Variáveis de sessão para armazenar e exibir informações mantidas durante a duração da visita de um usuário (ou sessão). O servidor cria um objeto de sessão diferente para cada usuário e o mantém por um período definido ou até que o objeto seja explicitamente encerrado.
Antes de definir variáveis de sessão para uma página, você deve criá-las no código-fonte.Após criar uma variável de sessão no código-fonte do aplicativo web, você pode usar o Dreamweaver para recuperar seu valor e usá-lo em uma página da Web.
Crie uma variável de sessão no código-fonte e atribua um valor a ela.
Por exemplo, este exemplo de ColdFusion instancia uma sessão chamada username e atribui a ela o Valor Cornelius:
<CFSET session.username = Cornelius>
Selecione Janela > Vínculos para exibir o painel Vínculos.
Clique no botão Mais (+) e selecione Variável de sessão
no menu pop-up.
Insira o nome da variável que você definiu no código-fonte do aplicativo e clique em OK.
Definir variáveis de aplicativo em ASP e ColdFusion
No ASP e ColdFusion, você pode usar variáveis de aplicativo para armazenar e exibir informações mantidas durante o tempo de vida do aplicativo e que persistem de usuário para usuário. Após definir a variável de aplicativo, você pode usar seu valor em uma página.
Nota
Não há objetos de variável de aplicativo em PHP.
Abra um tipo de documento dinâmico na janela Documento.
Selecione Janela > Vínculos para exibir o painel
Vínculos.
Clique no botão Mais (+) e selecione Variável de aplicativo
no menu pop-up.
Insira o nome da variável conforme definido no código de origem do aplicativo e clique em OK.
A Variável de aplicativo aparece no painel Vínculos sob o ícone Aplicativo.
Usar uma Variável como fonte de dados para um conjunto de registros do ColdFusion
Quando você define um conjunto de registros para uma página no painel Vínculos, o Dreamweaver insere o nome da fonte de dados do ColdFusion na tag cfquery na página.Para maior flexibilidade, você pode armazenar o nome da fonte de dados em uma variável e usar a variável na tag cfquery.O Dreamweaver oferece um método visual para especificar essa Variável em seus conjuntos de registros.
Verifique se uma página do ColdFusion está principal na janela Documento.
No painel Vínculos, clique no botão Mais (+) e
selecione Variável de nome da fonte de dados no menu pop-up.
A caixa de diálogo Variável de nome da fonte de dados é exibida.
Defina uma variável e clique em OK.
Ao definir o conjunto de registros, selecione a Variável como
fonte de dados para o conjunto de registros.
Na caixa de diálogo Conjunto de registros, a variável aparece no menu pop-up Fonte de dados junto com as fontes de dados do ColdFusion no servidor.
Complete a caixa de diálogo Conjunto de registros e clique em OK.
Inicialize a variável.
O Dreamweaver não inicializa a Variável para você, permitindo que você a inicialize como e onde desejar. Você pode inicializar a variável no código de página (antes da tag cfquery), em um arquivo de inclusão ou em algum outro arquivo como variável de sessão ou de aplicativo.
Definir variáveis de servidor
Você define variáveis de servidor como origens de conteúdo dinâmico para uso em um aplicativo web. As variáveis de servidor variam de um tipo de documento para outro e incluem variáveis de formulário, variáveis de URL, variáveis de sessão e variáveis de aplicativo.
Variáveis do servidor podem ser acessadas por todos os clientes que acessam o servidor, e por qualquer aplicativo executado no servidor. As variáveis persistem até o servidor ser interrompido.
Definir variáveis de servidor do ColdFusion
Abra o painel Vinculações (Janela >
Vinculações). Na caixa de diálogo Variável de servidor, insira o nome da variável do servidor e clique em OK.
Clique no botão Mais (+) e selecione a variável do servidor no menu pop-up.
Digite o nome da variável e clique em OK. A variável do servidor ColdFusion
aparece no painel Vinculações.
A tabela a seguir lista as variáveis internas do servidor ColdFusion:
|
Variável |
Descrição |
|
Server.ColdFusion.ProductName |
Nome de produto do ColdFusion. |
|
Server.ColdFusion.ProductVersion |
Número da versão do ColdFusion. |
|
Server.ColdFusion.ProductLevel |
Edição do ColdFusion (Enterprise, Professional). |
|
Server.ColdFusion.SerialNumber |
Número de série da versão atualmente instalada do ColdFusion. |
|
Server.OS.Name |
Nome do sistema operacional em execução no servidor (Windows XP, Windows 2000, Linux). |
|
Server.OS.AdditionalInformation |
Informações adicionais sobre o sistema operacional instalado (service packs, atualizações). |
|
Server.OS.Version |
Versão do sistema operacional instalado. |
|
Server.OS.BuildNumber |
Versão da compilação do sistema operacional instalado. |
Definir uma variável local do ColdFusion
Variáveis locais são variáveis criadas com a tag CFSET ou CFPARAM dentro de uma página ColdFusion.A variável local definida aparece no painel Vinculações.
Na caixa de diálogo Variável Local, digite o nome
da variável local e clique em OK.
Definir variáveis de servidor do ASP
Você pode definir as seguintes variáveis do servidor ASP como fontes de conteúdo dinâmico: Request.Cookie, Request.QueryString, Request.Form, Request.ServerVariables, e Request.ClientCertificates.
Abra o painel Vinculações (Janela >
Vinculações).
Clique no botão Mais (+) e selecione Variável de Solicitação
no menu pop-up.
Na caixa de diálogo Variável de Solicitação, selecione uma das seguintes coleções de solicitação no menu pop-up Tipo:
O conjunto QueryString
Recupera informações anexadas à URL da página de envio, como quando a página tem um formulário HTML usando o método GET. A string de consulta consiste em um ou mais pares nome-valor (por exemplo, last=Smith, first=Winston) anexados à URL com um ponto de interrogação (?). Se a string de consulta tiver mais de um par nome-valor, eles são combinados com ampersands (&).
O conjunto Form
Recupera informações de formulário incluídas no corpo da solicitação HTTP por um formulário HTML usando o método POST.
O conjunto ServerVariables
Recupera os valores de variáveis de ambiente predefinidas. A coleção tem uma longa lista de variáveis, incluindo CONTENT_LENGTH (o comprimento do conteúdo enviado na solicitação HTTP, que pode ser usado para ver se um formulário está em branco), e HTTP_USER_AGENT (fornece informações sobre o navegador do usuário).
Por exemplo, Request.ServerVariables("HTTP_USER_AGENT") contém informações sobre o navegador que fez o envio, como Mozilla/4.07 [en] (WinNT; I), que indica um navegador Netscape Navigator 4.07.
Para uma lista completa das variáveis de ambiente do servidor ASP, consulte a documentação online instalada com o Microsoft Personal Web Server (PWS) ou Internet Information Server (IIS).
O conjunto Cookies
Recupera os valores dos cookies enviados em uma solicitação HTTP. Por exemplo, suponha que a página leia um cookie chamado "readMe" no sistema do usuário. No servidor, os valores do cookie são armazenados na variável Request.Cookies("readMe").
O conjunto ClientCertificate
Recupera os campos de certificação da solicitação HTTP enviada pelo navegador. Os campos de certificação são especificados no padrão X.509.
Especifique a variável na coleção que você deseja acessar e clique em OK.
Por exemplo, se você quiser acessar as informações na variável Request.ServerVariables("HTTP_USER_AGENT"), insira o argumento HTTP_USER_AGENT.Se você quiser acessar as informações na variável Request.Form("lastname"), insira o argumento lastname.
A variável de solicitação aparece no painel Vínculos.
Definir variáveis de servidor PHP
Definir variáveis de servidor como origem do conteúdo dinâmico para páginas PHP.As variáveis de servidor PHP aparecem no painel Vínculos.
Abra o painel Vínculos (Janela >
Vínculos).
Clique no botão Mais (+) e selecione a variável no menu pop-up.
Na caixa de diálogo Variável de Solicitação, insira o nome da variável (por exemplo, REQUEST_METHOD) e clique em OK.
Para obter mais informações, pesquise a palavra-chave $_SERVER na documentação do PHP.
Definir uma variável de cliente do ColdFusion
Defina uma Variável de cliente ColdFusion como origem de conteúdo dinâmico para a página. As variáveis de cliente ColdFusion recém-definidas aparecem no painel Vínculos.
Na caixa de diálogo Variável de cliente, insira o nome da variável e clique em OK.
Por exemplo, para acessar as informações na variável ColdFusion Client.LastVisit, insira LastVisit.
Variáveis de cliente são variáveis criadas no código para associar dados a um cliente específico. As variáveis de cliente mantêm o estado do aplicativo conforme o usuário se move de página em página dentro do aplicativo, bem como de sessão para sessão.
As variáveis de cliente podem ser definidas pelo usuário ou incorporadas. A seguinte tabela lista as variáveis de cliente do ColdFusion incorporadas:
|
Variável |
Descrição |
|
Client.CFID |
Um identificador incremental para cada cliente que se conecta ao servidor. |
|
Client.CFTOKEN |
Um número gerado aleatoriamente usado para identificar exclusivamente um cliente específico. |
|
Client.URLToken |
Uma combinação de CFID e CFTOKEN a ser passada entre modelos quando cookies não são usados. |
|
Client.LastVisit |
Registra o carimbo de data e hora da última visita feita por um cliente. |
|
Client.HitCount |
O número de solicitações de página vinculadas a um único cliente (rastreado usando CFID e CFTOKEN). |
|
Client.TimeCreated |
Registra o carimbo de data e hora quando CFID e CFTOKEN foram criados pela primeira vez para um cliente específico. |
Definir uma variável de cookie do ColdFusion
As variáveis de cookie são criadas no código, e acessam informações contidas nos cookies transmitidos ao servidor por um navegador. A variável de cookie definida aparece no painel Vinculações.
Na caixa de diálogo Variável de Cookie, insira o nome
da variável de cookie e clique em OK.
Definir uma variável CGI do ColdFusion
A variável CGI definida aparece no painel Vinculações.
Na caixa de diálogo Variável CGI, insira o nome
da variável e clique em OK.
Por exemplo, se quiser acessar as informações na variável CGI.HTTP_REFERER, insira HTTP_REFERER.
A tabela a seguir lista as variáveis CGI do ColdFusion mais comuns que são criadas no servidor:
Variável |
Descrição |
|---|---|
SERVER_SOFTWARE |
O nome e a versão do software do servidor de informações que responde à solicitação (e executa o gateway). Formato: nome/versão. |
SERVER_NAME |
O nome do host, alias DNS ou endereço IP do servidor como aparece nas URLs de autorreferência. |
GATEWAY_INTERFACE |
A revisão da especificação CGI com a qual este servidor está em conformidade. Formato: CGI/revisão. |
SERVER_PROTOCOL |
O nome e revisão do protocolo de informações com o qual esta solicitação chegou. Formato: protocolo/revisão. |
SERVER_PORT |
O número da porta para a qual a solicitação foi enviada. |
REQUEST_METHOD |
O método com o qual a solicitação foi feita. Para HTTP, os métodos são Get, Head, Post etc. |
PATH_INFO |
As informações de caminho extras, conforme fornecidas pelo cliente. Os scripts podem ser acessados pelo nome de caminho virtual, seguido por informações extras no final deste caminho. As informações extras são enviadas como PATH_INFO. |
PATH_TRANSLATED |
O servidor fornece uma versão traduzida de PATH_INFO, que pega o caminho e faz qualquer mapeamento virtual para físico nele. |
SCRIPT_NAME |
Um caminho virtual para o script sendo executado; usado para URLs autorreferenciais. |
QUERY_STRING |
As informações de consulta que seguem o ponto de interrogação (?) no URL que referencia o script. |
REMOTE_HOST |
O nome de host que realiza a solicitação. Se o servidor não tiver essas informações, ele define REMOTE_ADDR e não define REMOTE_HOST. |
REMOTE_ADDR |
O endereço IP do host remoto que faz a solicitação. |
AUTH_TYPE |
Se o servidor oferece suporte à autenticação de usuário e o script está protegido, este é o método de autenticação específico do protocolo usado para validar o usuário. |
REMOTE_USER AUTH_USER |
Se o servidor oferece suporte à autenticação de usuário e o script está protegido, este é o nome de usuário que foi autenticado.(Também disponível como AUTH_USER.) |
REMOTE_IDENT |
Se o servidor HTTP oferece suporte à identificação RFC 931, esta variável é definida com o nome do usuário remoto recuperado do servidor. Use a variável apenas no logon. |
CONTENT_TYPE |
Para consultas que têm informações anexadas, como HTTP POST e PUT, este é o tipo de conteúdo dos dados. |
CONTENT_LENGTH |
O comprimento do conteúdo conforme fornecido pelo cliente. |
A tabela a seguir lista as variáveis CGI mais comuns criadas pelo navegador e enviadas ao servidor:
|
Variável |
Descrição |
|
HTTP_REFERER |
O documento de referência. Este é o documento que vinculou ou enviou dados do formulário. |
|
HTTP_USER_AGENT |
O navegador que o cliente está usando atualmente para enviar a solicitação. Formato: software/biblioteca da versão/versão. |
|
HTTP_IF_MODIFIED_SINCE |
A hora em que a página foi modificada pela última vez. Esta variável é enviada a critério do navegador, geralmente em resposta ao servidor ter enviado o cabeçalho HTTP LAST_MODIFIED. Pode ser usada para aproveitar o armazenamento em cache do navegador. |
Colocar em cache fontes de conteúdo
Você pode armazenar em cache—ou armazenar—origens de conteúdo dinâmico em uma Nota de design. Isso permite trabalhar em um site mesmo se você não tiver acesso ao banco de dados ou servidor de aplicativos que armazena as fontes de conteúdo dinâmico.O armazenamento em cache também pode acelerar o desenvolvimento eliminando acesso repetido através de uma rede ao banco de dados e servidor de aplicativo.
Clique no botão de seta no canto superior direito
do painel Vínculos e alterne Cache no menu pop-up.
Se fizer alterações em uma das origens de conteúdo, você pode atualizar o cache clicando no botão Atualizar (o ícone com seta circular) no canto superior direito do painel Vínculos. (Expanda o painel se não conseguir ver o botão.)
Alterar ou excluir fontes de conteúdo
Você pode alterar ou excluir qualquer origem de conteúdo dinâmico existente—ou seja, qualquer origem de conteúdo listada no painel Vínculos.
Alterar ou excluir uma origem de conteúdo no painel Vínculos não altera ou exclui nenhuma instância desse conteúdo na página. Apenas altera ou exclui como uma possível origem de conteúdo para a página.
Alterar uma origem de conteúdo no painel Vínculos
No painel Vínculos (Janela >
Vínculos), clique duas vezes no nome da origem de conteúdo que deseja
editar.
Faça suas alterações na caixa de diálogo exibida.
Caso esteja satisfeito com o trabalho, clique em OK.
Excluir uma origem de conteúdo do painel Vínculos
No painel Vínculos (Janela >
Vínculos), selecione a origem de conteúdo da lista.
Clique no botão de subtração (-).
Copiar um conjunto de registros de uma página para outra página
Você pode copiar um conjunto de registros de uma página para outra dentro de um site definido.
Selecione o conjunto de registros no painel Vínculos
ou no painel Comportamentos do servidor.
Clique com o botão direito no conjunto de registros e selecione Copiar no menu
pop-up.
Abra a página para a qual você deseja copiar o conjunto de registros.
Clique com o botão direito no painel Vínculos ou na Barra de ferramentas
Comportamentos do servidor e selecione Colar no menu pop-up.
Veja também
- Conexões de banco de dados para desenvolvedores do ASP
- Conexões de banco de dados para desenvolvedores do PHP
- Adicionar um procedimento armazenado (ColdFusion)
- SQL primer
- Sobre os parâmetros de URL e de formulário
- Adição de conteúdo dinâmico a páginas
- Parâmetros de URL
- Variáveis de servidor do ColdFusion
- Sobre as fontes de conteúdo dinâmico
- Usar formulários para reunir informações de usuários
- Como funcionam as variáveis de sessão
- Coletar, armazenar e recuperar informações em variáveis de sessão
- Sobre a adição de conteúdo dinâmico
- Parâmetros de formulário em HTML
- Variáveis de servidor do ColdFusion
Criar belos sites no Dreamweaver
Crie, codifique e gerencie sites dinâmicos com uma ferramenta completa e eficiente.
