SQL	Início  Anterior  Próximo

---

TreeView SQL

---

Com o componete TreeView o desenvolvedor poderá criar menus hierárquicos semelhantes à hierarquia de diretórios que é exibida pelo Windows Explorer. Eles são fáceis de usar e mais fáceis ainda de criar (isso se estiver usando o WebIntegrator). Visualmente, a saída do componente TreeView será algo semelhante com o que segue abaixo:



O exemplo de TreeView gerado acima possui apenas dois níveis hierárquicos sendo que o último nível é sempre considerado como nível de detalhe ou nó-folha pois a partir dele não há mais ramificações. Além das definições que são feitas diretamente pelo WI Builder, o componente TreeView oferece outras propriedades que podem ser alteradas pelo desenvolvedor. No momento em que as definições são gravadas, o WebIntegrator inseri no código-fonte da página WSP tags HTML que farão com que o TreeView seja montado e em uma dessas tags estão essas propriedades adicionais que o TreeView possui, a saber:

Propriedade	Descrição
UniqueID	Propriedade que contém o identificador único para esse TreeView. Recomenda-se não alterar o valor dessa propriedade.
DocRoot	Propriedade que informa o diretório-base a ser levado em consideração nos links do TreeView.
ImgRoot	Propriedade que informa o diretório onde está instalada a "pele" que está sendo usada pelo TreeView. O componente TreeView possui atualmente 4 tipos de "peles": ·   ·   ·   ·
FrameSet	Propriedade que indica o nome da página que contém o FRAMESET, caso algum esteja sendo usado. Se o TreeView não fizer parte de um FRAMESET defina essa propriedade com uma string vazia ("").
ImgWidth	Propriedade que define a largura padrão das imagens exibidas pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
ImgHeight	Propriedade que define a altura padrão das imagens exibidas pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
EntryHeight	Recomenda-se não alterar o valor dessa propriedade.
InitialKey	Propriedade que define o valor inicial da chave usada internamente pelo TreeView. Recomenda-se não alterar o valor dessa propriedade.
CurrPageBG	Propriedade que define o valor da cor de background da página onde será exibido o TreeView.
CurrPageFG	Propriedade que define o valor da cor de foreground da página onde será exibido o TreeView.
LinkCurrPage	Propriedade que indica se os links serão para a própria página onde está sendo exibido o TreeView.
TreeRootHint	Propriedade que define o texto a ser apresentado como dica do nó raiz do TreeView.
NormalPageHint	Propriedade que define o texto a ser apresentado como dica de um link para uma página.
LinkedPageHint	Propriedade que define o texto a ser apresentado como dica de um link.
OpenBookHint	Propriedade que define o texto a ser apresentado como dica da figura que fecha um ramo da árvore do TreeView.
ClosedBookHint	Propriedade que define o texto a ser apresentado como dica da figura que abre um ramo da árvore do TreeView.
OpenBookStatus	Propriedade que define o texto a ser apresentado na barra de status do browser em relação à figura que fecha um ramo da árvore do TreeView.
ClosedBookStatus	Propriedade que define o texto a ser apresentado na barra de status do browser em relação à figura que abre um ramo da árvore do TreeView.
window.defaultStatus	Propriedade que define a mensagem que aparece na barra de status do browser.
navExplain	Propriedade que define a mensagem a ser exibida quando o TreeView não fizer parte de um FRAMESET e a propriedade checkFrames estiver setada para true.

FontFace	Propriedade que define a listagem das fontes a serem usadas pelo TreeView. Os nomes das fontes devem estar separados por vírgula.
compactTree	Propriedade que indica se a árvore que simboliza o TreeView será exibida numa forma compacta.
viewMatchCnt
singleBranch	Propriedade que indica se apenas será visualizado um ramo extendido da árvore, ou seja, caso o usuário tente abrir um outro ramo da árvore e um já esteja aberto, esse último será fechado antes que o outro se ja expandido caso esta propriedade esteja definida como true.
checkFrames	Propriedade que indica se será feita a verificação se o TreeView faz parte de um FRAMESET.
baseHref	Propriedade que indica o nome do target dos links do TreeView, ou seja, o local onde será exibido o recurso para o qual o link aponta.

O campo Banco de Dados indica o identificador de um dos servidores de bancos de dados definidos para o projeto que será usado para executar o comando.

O campo Condição contém a expressão condicional a ser testada para saber se o componente deverá ser processado. Para saber maiores detalhes sobre as possíveis construções de condições clique aqui.

O campo Descrição serve para que o desenvolvedor da aplicação escreva um breve comentário sobre a ação a ser executada pelo componente em questão.

O campo Filtrar define quais os caracteres que deverão ser filtrados do conteúdo das variáveis de sessão do WebIntegrator que estão sendo referenciadas no campo SQL antes da execução do comando. O objetivo é impedir que certos caracteres sejam passados para o comando a ser executada pelo banco de dados evitando que assim que o resultado do comando não seja intencionalmente alterado.

Como exemplo suponha que haja a instrução SELECT * FROM tabCadastros WHERE nome LIKE |tmp.nome|% AND publico = 1 e o usuário da aplicação ao preencher o formulário coloque no campo correspondente à variável tmp.nome um valor como % OR nome = . Se o campo Filtrar não estiver definido com os caracteres % e o WebIntegrator irá processar a seguinte instrução SELECT * FROM cadastros WHERE nome LIKE % OR nome = % AND publico = 1 retornando como resultado todos as linhas da tabela.

O campo Inserir Definição JS indica se o arquivo de definição JavaScript deverá ser colocado na página. Recomenda-se que na primeira vez que se esteja definindo um treeview esta opção esteja marcada.

O campo Link(||¹) define qual será a ação do link podendo ser uma chamada a uma função JavaScript, um endereço de uma página a ser chamada, etc. O link apenas será aplicado ao último nível da hierarquia.

O campo Níveis serve para indicar até qual coluna serão pegos os valores para a montagem do TreeView. Esse valor não pode passar da quantidade máxima de colunas que é retornada pela consulta definida no campo SQL. De acordo com o valor aqui digitado serão criados tantos níveis de hierarquia, sendo o último nível considerado como detalhe.

O campo Objeto define o nome do objeto que será inserido na sessão do usuário após a execução do componente, a depender do componente o objeto poderá possuir uma série de atributos e métodos. Por exemplo, o objeto definido em componentes do tipo Objeto possuem os métodos size() e columnNames() além de uma série de atributos representados pelos nomes das colunas vindas do resultado da consulta ao banco de dados.

No caso de um objeto declarado na definição de um web service esse objeto irá conter os parâmetros de resposta que serão retornados após a execução da chamada ao web service. Para saber quais os possíveis atributos e métodos de um objeto leia a documentação específica do componente.

O campo SQL contém o comando que será enviado para ser processado pelo banco de dados. Caso o comando seja composto por mais de uma instrução SQL separe-as por ponto-e-vírgula.

No componente Upload de Banco de Dados o valor da coluna relativo ao conteúdo deverá ser referenciado por um sinal de interrogação, exemplo: INSERT INTO MinhaTabela (arquivo, conteudo) VALUES (|tmp.arquivo|, ?).

A estrutura do comando a ser executado é dependente do banco de dados, podendo ser feitas chamadas a stored procedures, rotinas M (através do MJava), métodos de objetos do CachéFactory, execução de instruções SQL, etc. Para saber maiores detalhes como fazer essas chamadas clique aqui.

O campo Texto(||¹) define o texto a ser exibido no nível da hierarquia que se encontra atualmente selecionado.

O campo Título(||¹) serve para definir qual será o texto que será exibido como título do TreeView.