Lista
Início  Anterior  Próximo

minilogowi

seta 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.