Lista | Início Anterior Próximo

Lista

Este é o local onde o desenvolvedor define sob qual condição será gerada uma lista de valores baseada no resultado de uma consulta SQL. A lista gerada seguirá sempre o padrão descrito abaixo:
<antes-de-cada-elemento><valor1><depois-de-cada-elemento>[<separador-de-elementos><antes-de-cada-elemento><valor2><depois-de-cada-elemento>...]
Caso se queira gerar uma lista onde os valores venham um abaixo do outro, o desenvolvedor poderá fazer uso dos marcadores \r (retorno do carro) ou \n (nova linha). Se um elemento Lista for criado usando como separador de elementos a vírgula (,) e esta lista devendo retornar 5 linhas, alguns resultados possíveis são:

| ·

Se todas as linhas forem diferentes de vazio, o WI retorna: A,B,C,D,E,F

| ·

Se apenas as linhas 1 e 5 forem diferentes de vazio, o WI retorna: A,,,,,F

| ·

Se apenas a linha 5 for diferente de vazio, o WI retorna: ,,,,,F

O campo Antes de Cada Elemento define o conteúdo que será colocado no início de cada elemento da lista.
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 Depois de cada Elemento define o conteúdo que será colocado no final de cada elemento da lista.
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 executado pelo banco de dados, evitando 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 indica o nome do objeto que servirá para fazer referência à lista a ser criada. O nome aqui digitado serve como um prefixo a ser colocado junto com o nome da coluna do banco de dados da qual queremos montar a lista.
Para exemplificar suponha que tenha sido criada a lista com o campo Objeto definido como tmp.minhaLista e que a consulta retorne um conjunto de valores nas colunas colNome e colFone, então para criar uma lista com os valores da coluna colNome faria |tmp.minhaLista.colNome| e para uma lista com os valores da coluna colFone faria |tmp.minhaLista.colFone|.
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 Separador de Elementos define qual será o separador de elementos utilizado na contrução da lista.