O Histórico
A Ferramenta
O Novo Clarion 6
Soluções Web
CD de Avaliação
Acessórios
Tutorial Clarion


2.- O Assistente Rápido para Arquivos (Quick Load)

Você pode adicionar um arquivo ao Dicionário de Dados muito rapidamente usando a opção Quick Load
no Editor de Dicionários. Quick Load funciona de uma maneira
similar ao Quick Start Wizard - define os campos (nome, pictures e keys), e uma definição de
arquivo é criada no dicionário. Esta opção está disponível para você cada vez que você
adiciona um arquivo ao dicionário.

Adicionando um Arquivo

Nesta seção, nós adicionaremos um arquivo para armazenar os números de telefones para
os clientes. Isto permitirá a nós que tenhamos muitos números de telefone para
cada cliente (criando um relacionamento um para
muitos). Use Quick Load no Editor de Dicionários

1. Escolha File -> Open (ou pressione o botão [OPEN] na barra de ferramentas).

2. Selecione o dicionário (*.Dct) a partir da lista suspensa Arquivos do tipo, selecione
o arquivo QWKTUTOR.DCT e então pressione o botão [Abrir]. O diálogo Dictionary aparece.

3. Pressione o botão [Add File] Primeiro Botão da barra de icones. Um diálogo aparece
perguntando, "Você quer usar o Quick Load?"

4. Pressione o botão [Yes]. O diálogo Quick Load aparece. Note que ela é muito
similar ao diálogo Quick Start Wizard.

5. Selecione o campo Data Table Name, digite Telefones e tecle tab.

6. Pressione [Tab] para aceitar TEL como prefixo (campo Prefix).
Agora você deve selecionar o tipo de arquivo de dados (Table Driver).

7. Pressione [Tab] para aceitar TOPSPEED como Table Driver. Isto leva você a uma lista
onde você define os campos.

8. Digite NumeroCliente na primeira linha da coluna Column Name e pressione [Tab].
Isto cria um campo de nome NumeroCliente. Este campo será relacionado ao
campo NumeroCliente no arquivo Clientes. Usar o mesmo nome facilita a ligação
de dois campos em um relacionamento. No código Clarion gerado, adicionar o prefixo
do arquivo aos identificadores de campos (separados por dois pontos) cria nomes únicos para os campos com o
mesmo nome em arquivos separados. Portanto, este campo atualmente será chamado TEL:NumeroCliente,
enquanto o campo noarquivo clientes será chamado CLI:NumeroCliente.

9. Digite N4 na coluna Type e pressione [Tab].

10. Na coluna Key, pressione (seta para baixo) e selecione Duplicate, e tecle tab. Isto
especifica uma chave que pode conter valores em duplicidade, permitindo que você tenha mais de
um telefone para cada cliente. Isto permite que você crie um relacionamento Um para Muitos entre
estes dois arquivos (Um cliente pode ter muitos telefones).

O cursor está posicionado na próxima linha, permitindo que você defina o próximo campo.

11. Na coluna Column Name da próxima linha, digite DDD e pressione [TAB].

12. Na coluna Type, digite P(###)P e pressione tab duas vezes (não defina uma chave) para mover o
cursor para o próximo campo. Este formato define um campo com um número de três dígitos, entre
parênteses, deixando zeros à esquerda do número (a notação padrão para DDD).

13. Complete o arquivo criando os campos restantes, conforme a tabela abaixo:

Column Name

Type

Key

Numero

S10

(no key)

Descricao

S20

(no key)

14. Quando você tiver definido todos os campos, pressione o botão [OK]. O Quick Load
pergunta se você terminou de inserir os campos.

15. Pressione o botão [OK]. O Quick Load agora cria sua definição de arquivos e adiciona ela ao dicionário.

Estabeleça que o novo arquivo usará a metáfora Edit in Place Como há
somente quatro campos, este arquivo é um bom exemplo do tipo de arquivo para
o qual editar os dados direto na lista é mais apropriado.

1. Destaque Telefones no list box Files e então pressione o botão [Properties..].

2. Selecione a ficha Options.

3. Sobre o List Box pressione a tecla [Insert], aparecerá uma nova janela.
Nesta janela digite em Label EDITINPLACE e selecione String.
Pressione o botão [OK]. Isto alertará os Wizards do Clarion para gerar o código que permite que você
edite diretamente os dados do arquivo como eles aparecem no list box.

4. Pressione o botão [OK].

Adicionando um Relacionamento

Obviamente, nós queremos que os telefones contenham números dos telefones do clientes.
Isto significa que deve haver um relacionamento entre os dois arquivos.
Neste caso, um Cliente pode ter muitos telefones, fazendo deste um
relacionamento "Um para Muitos". Para definir este relacionamento, nós devemos ligar os arquivos
um ao outro no Dicionário de Dados para fornecer ao
Gerador de Aplicações a informação necessária para acessar os registros
relacionados. Estabeleça o relacionamento para os dois arquivos

1. Destaque Clientes no list box Files e então pressione o botão [Add Relation].
O diálogo New Relationship Properties aparece. É nele que você define os relacionamentos.

2. Confirme que no campo Type está selecionado 1:MANY.

3. No campo Primary Key, pressione a tecla seta para baixo para mostrar as escolhas,
destaque PorNumeroCliente e então pressione [Tab]. Esta é uma chave no arquivo Clientes
(o lado Um do relacionamento) que será usada para ligar os dois arquivos.

4. No campo Related Table, pressione a tecla seta para baixo para mostrar
as escolhas, destaque Telefones e então pressione [Tab].

5. No campo Foreign Key, pressione a tecla seta para baixo para mostrar as escolhas,
destaque KeyNumeroCliente e então pressione [Tab]. Esta é uma chave no arquivo Telefones
(o lado Muitos do relacionamento) que será usada para ligar os dois arquivos.
Depois, os campos de ligação nas chaves devem ser mapeadas de modo que o
Gerador de Aplicações possa saber exatamente quais campos nos dois arquivos são
relacionados. Como nós usamos nomes de campos idênticos, isto é fácil.

6. Pressione o botão [Map by Name]. Os campos de ligação entre os dois arquivos aparecem
nos dois list boxes Columns Mapping.

Estabeleça as Restrições de Integridade Referencial

1. Escolha Cascade na lista suspensa On Update na caixa de
grupo Referential Integrity Constraints.

2. Escolha Cascade na lista suspensa On Delete na caixa de grupo Referential
Integrity Constraints. O código fonte gerado fará a manutenção de Integridade
Referencial entre arquivos automaticamente. O tutorial no Learning Clarion explica isto melhor.
Veja Usando o Editor de Dicionários no User’s Guide
(Manual do Usuário) para uma breve discussão da teoria de banco de dados.

3. Pressione o botão [OK] para fechar o diálogo New Relationship
Properties. O dicionário agora parece com isto:

4. Escolha File -> Save ou pressione o botão [Save] na barra de ferramentas
para salvar o Dicionário de Dados. Depois, os campos de ligação nas chaves devem
ser mapeadas de modo que o Gerador de Aplicações possa saber
exatamente quais campos nos dois arquivos são relacionados.
Como nós usamos nomes de campos idênticos, isto é fácil.

5. Pressione o botão [Map by Name]. Os campos de ligação entre os dois arquivos aparecem
nos dois list boxes Columns Mapping.

Estabeleça as Restrições de Integridade Referencial. Depois, os campos de ligação nas
chaves devem ser mapeadas de modo que o Gerador de Aplicações possa saber
exatamente quais campos nos dois arquivos são relacionados.
Como nós usamos nomes de campos idênticos, isto é fácil.

6. Pressione o botão [Map by Name]. Os campos de ligação entre os dois
arquivos aparecem nos dois list boxes Columns Mapping.

Estabeleça as Restrições de Integridade Referencial.

1. Escolha Cascade na lista suspensa On Update na
caixa de grupo Referential Integrity Constraints.

2. Escolha Cascade na lista suspensa On Delete na caixa de grupo Referential
Integrity Constraints. O código fonte gerado fará a manutenção de Integridade Referencial
entre arquivos automaticamente. O tutorial no Learning Clarion explica
isto melhor. Veja Usando o Editor de Dicionários no User’s Guide (Manual
do Usuário) para uma breve discussão da teoria de banco de dados.

3. Pressione o botão [OK] para fechar o diálogo New Relationship Properties.

O dicionário agora parece com isto:

4. Escolha File -> Save ou pressione o botão [Save] na barra de
ferramentas para salvar o Dicionário de Dados.

5. Escolha File -> Close ou pressione o botão [Close] no diálogo Dictionary
para fechar o Dicionário de Dados.

1. Escolha Cascade na lista suspensa On Update na caixa de
grupo Referential Integrity Constraints.

2. Escolha Cascade na lista suspensa On Delete na caixa de
grupo Referential Integrity Constraints.

O código fonte gerado fará a manutenção de Integridade Referencial entre arquivos automaticamente.
O tutorial no Learning Clarion explica isto melhor. Veja Usando o Editor
de Dicionários
no User’s Guide (Manual do Usuário) para uma breve discussão
da teoria de banco de dados.

3. Pressione o botão [OK] para fechar o diálogo New Relationship Properties.

O dicionário agora parece com isto:

Escolha File -> Save ou pressione o botão [Save] na barra de ferramentas para salvar o Dicionário de Dados.

4. Escolha File -> Close ou pressione o botão [Close] no diálogo Dictionary para
fechar o Dicionário de Dados.


 
Ótimo! Siga para o passo seguinte!
 
          * Passo 3 - O Assistente de Procedimentos.
* Passo 4 - O Assistente de Aplicações.

Voltar para o Passo 1