Desvio SQL
Este é o local onde o desenvolvedor define sob qual condição uma consulta SQL será executada e a depender do que ela retorne e do que esteja configurado será realizado um desvio para uma outra página do projeto.
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 Destino indica a página ou URL para a qual será feito o redirecionamento caso a condição seja avaliada como veradadeira. O desvio sempre é feito tomando como caminho base o diretório de documentos do projeto do WebIntegrator. Caso se deseje fazer um redirecionamento para uma outra página que não faça parte do projeto inicie com http:// e complete a URL que será chamada.
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 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 Se não retornar registro define se o desvio será executado quando o comando SQL não retornar nenhuma linha.
