↑ Return to Tutoriais

Print this Page

ColdFusion Tutorial – Módulo 2

Entendendo mais sobre CFOUTPUT

A tag CFOUTPUT é utilizada para mostrar resultados de pesquisas a banco de dados e o resultado de operações com variáveis.
No módulo 1 de nosso tutorial, colocamos uma pequena introdução do funcionamento da tag CFOUTPUT, que foi utilizada para exibir o resultado de uma pesquisa ao banco de dados no browser.
Nesta introdução, a tag CFOUTPUT foi seguida do atributo QUERY, que é opcional e indica o nome de qual pesquisa você pretende exibir os dados.
Mas a tag CFOUTPUT têm mais outros atributos. São eles:

GROUP Opcional. Este atributo não exibe registros duplicados de acordo com o campo ordenado na query. Este parâmetro é caso sensitivo.
GROUPCASESENSITIVE Opcional. Este campo indica se o campo da opção GROUP será ou não caso sensitivo. Seu padrão é YES.
STARTROW Opcional. Especifica a linha que você quer iniciar a exibir os dados.
MAXROWS Opcional. Especifica o número máximo de linhas que você quer exibir.

Tendo como base o datasource agenda, definido no módulo 1 de nosso tutorial, veremos agora como utilizar estes novos parâmetros da tag CFOUTPUT.

Uso do parâmetro GROUP

Insira mais dois registros em nosso banco de dados:

Nome Tel
André Soares 11-234-9980
josé da silva 13-561-7898

*Note que josé da silva está em letras minúsculas e que o telefone de André Gomes é o mesmo de José da Silva, usado no módulo anterior.
Agora iremos criar o acesso a base de dados com uma característica a mais, muito importante para a utilização do parâmetro GROUP:

[crayon]
SELECT * FROM Pessoal
ORDER BY tel
[/crayon]

Olhando acima, você irá notar a cláusula ORDER BY que faz com que seus registros sejam ordenados através do campo tel. Criado o acesso a sua base de dados, veremos agora como usar o parâmetro GROUP:

[crayon]
#nome# – #telefone#


[/crayon]

Notaremos que como resposta teremos apenas quatro registros, sendo que no banco de dados existem cinco. O registro não exibido foi o de José da Silva, que tem o mesmo número de telefone que André Soares, este que foi exibido por ser a última ocorrência encontrada no banco de dados.

Uso do parâmetro GROUPCASESENSITIVE

Continuando com a mesma base de dados, iremos ver agora o parâmetro GROUPCASESENSITIVE. Para isso precisaremos mudar na cláusula ORDER BY, o nome do campo para nome, ficando assim:
ORDER BY nome
* Note que estamos fazendo esta alteração, pois o parâmetro GROUPCASESENSITIVE só é empregado em campos string.
Agora coloque a tag CFOUTPUT da seguinte forma:

[crayon]
#nome# – #telefone#


[/crayon]

Veremos que como resposta teremos os cinco registros do banco de dados.
Mude agora o parâmetro GROUPCASESENSITIVE para NO. Você terá como resposta apenas quatro registros, sendo o registro de José da Silva não sendo mostrado.

Uso do parâmetro STARTROW

Este parâmetro é usado para indicar em qual registro de nossa query desejamos começar a exibir. Para ilustrar melhor, façamos da seguinte forma:

[crayon]
#nome# – #telefone#


[/crayon]

Veremos que temos como resposta quatro registros, já que iniciamos no registro de número 2 de nossa query.

Uso do parâmetro MAXROWS

Usado para limitar o número máximo de registros da query a serem exibidos.
Vamos acrescentar ao exemplo do parâmetro STARTROW o parâmetro MAXROWS, e ver como este novo parâmetro funciona:

[crayon]
#nome# – #telefone#


[/crayon]

Neste exemplo teremos como resposta três registros. Note que o parâmetro MAXROWS nos limita ao número máximo de 3 registros e não que a exibição dos registros deva parar no registro de número 3.

Criando Formulários HTML

Para que possamos continuar com nosso tutorial, é necessário que saibamos construir e entender como funciona um formulário HTML.
O formulário é representado pelas tags

, que indicam o início e o fim do formulário respectivamente. Estas tags tem seus atributos e suas sub-tags.Quando o usuário clica no botão de um formulário, os dados que ele preencheu são enviados para um arquivo (aplicação), onde estes dados são tratados e é apresentada uma resposta ao usuário.
Vamos ver agora alguns deles.

Atributos

Action – Indica para qual arquivo será enviado os dados do formulário.
Method – Indica o método usado pelo formulário. Vamos utilizar aqui o método POST.
Name – Opcional. Indica o nome do formulário.

Sub-Tags

As sub-tags Text, Password, Hidden, Radio Button e CheckBox são representadas pela tag , diferenciando-se apenas em seu tipo (TYPE) e em alguns atributos.

Text

Representa um campo texto, que tem como atributos NAME, SIZE, MAXLENGTH. Sintaxe:
[crayon][/crayon]

Password

Representa um campo senha, que tem os mesmos atributos da sub-tag TEXT. Sintaxe:
[crayon][/crayon]

Hidden

Representa um campo escondido, que não é mostrado ao usuário. Seus atributos são NAME e VALUE. Sintaxe:
[crayon][/crayon]

Radio Button

Representa um campo de única escolha. Seus atributos são NAME, VALUE e CHECKED, este último opcional, indicado que o campo está selecionado. Sintaxe:
[crayon][/crayon]

CheckBox

Representa um campo de múltiplas escolhas. Seus atributos são os mesmos da subtag RADIO BUTTON. Sintaxe:
[crayon][/crayon]

TextArea

Representada pelas tags

Permanent link to this article: http://ensina.me/coldfusion/tutoriais/coldfusion-tutorial-modulo-2/