Download (Banco de Dados)
O componente Download Banco de Dados oferece ao desenvolvedor a possibilidade da realização do download do conteúdo de um arquivo armazenado em banco de dados. Caso o conteúdo do arquivo seja textual e nele sejam feitas referências a variáveis de sessão do WebIntegrator há a possibilidade de processá-las.
Algo a ser levado em consideração em relação aos compoenentes de downloads é que sempre que um download for executado com sucesso os restantes dos eventos que se encontram registrados num pré-página não serão processados.
O campo Arquivo indica o nome do arquivo que será enviado ao usuário.
O campo Arquivo Substituto indica o nome do arquivo que será enviado ao cliente caso o arquivo especificado no campo Arquivo não seja encontrado.
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 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 Identificador serve para que o desenvolvedor entre com um identificador único para o componente de página ou de projeto que está sendo definido. Será através desse identificador que o componente e/ou seus valores serão referenciados nas páginas do projeto.
A depender do componente que se estiver definindo para que o mesmo seja referenciado numa página será necessário o acréscimo de um prefixo como é o caso dos componentes Grid e Combo, nesses dois casos é obrigatório o uso dos prefixos grid. e combo. antes dos respectivos identificadores para que o conteúdo correto seja exibido.
O campo Nome ao Salvar indica o nome que será enviado ao cliente relativo ao conteúdo que está sendo feito o download.
A opção Processa Variáveis indica se será realizado o processamento de variáveis que possam existir no conteúdo do arquivo. Esta opção apenas será válida para arquivos com conteúdo textual, ou seja, que tipo MIME seja text/*.
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 Tipo define qual o tipo MIME que estará associado ao componente que estiver sendo definido. A especificação do tipo MIME é baseada numa extensão, para saber quais os tipos MIME suportados pelo WebIntegrator clique aqui. O valor "attachment" força a janela de salvamento no browser.
