WI Object | Início Anterior Próximo

Grid WI Object

O objetivo de um grid Objeto WI é recuperar os dados que estão armazendaos em um objeto de sessão que siga a padrão do WebIntegrator e exibí-los na forma de um grid usando um modelo definido pelo usuário, ou seja, quando o desenvolvedor quiser mostrar sob a forma de grid um objeto do ambiente WebIntegrator que contenha um array de registros.
Para um objeto de sessão estar no padrão do WebIntegrator os seguintes pontos devem ser atendidos:

| 1. o objeto deve possuir a propriedade

size() que informará quantas instâncias desse objeto encontra-se na sessão.

| 2. o objeto deve oferecer suporte à sintaxe de referenciação de suas propriedades semelhante à notação de arrays. A sintaxe a ser suportada é:

<nome-do-objeto>[<indice>].<nome-da-propriedade>

| 3. a numeração do índice para referenciar uma determinada instância de um objeto deverá começar de

1 e ir até o valor da propriedade size() do objeto.

Os elementos Objeto e WebService são exemplos que seguem esse padrão de objetos do WebIntegrator. O desenvolvedor também poderá desenvolver seus próprios objetos que sigam esse padrão através de conectores Java.
Há também a possibilidade do desenvolvedor referenciar um grid Objeto WI diretamente na página WSP sem a necessidade de definí-lo no pré-página, para isso basta colocar na página WSP a referência ao grid e passar o parâmetro id com o nome do objeto que irá popular esse grid. A sintaxe é a seguinte:
|grid.<identificador-do-grid>?id=<identificador-do-objeto>|
O campo Complemento do Identificador indica qual o complemento a ser acrescentado ao identificador de um componente grid ou combo. A utilidade maior desse campo é percebida quando o desenvolvedor quer que o mesmo componente (combo ou grid) seja executado e exibido mais de uma vez na mesma página.
Como exemplo, suponha que numa página se queira exibir três vezes o mesmo compoenete combo, mas cada um deles vindo com valores selecionados diferentes. Para isso, basta que o desenvolvedor defina três combos e cada uma delas com um complemento do identificador e o valor a vir selecionado diferentes, e na página referenciar |combo.<identificador-da-combo>.<complemento-do-identificador>|.
Ao se utilizar um complemento de identificador, a atribuição de variáveis via |? não poderá ser feita através da própria página no momento em que o grid ou a combo estiver sendo referenciada. Ao invés disso, o desenvolvedor poderá usar a seguinte sintaxe no campo Condição:
<condicao> || |?<variavel>=<valor>|
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 Grid, Combo, Download ou Upload lista quais componentes de projetos estão disponíveis para esse componente de acordo com o seu tipo, ou seja, na definição de um componente de listagem de e-mails serão listados os grids HTML do tipo POP3, num componente Grid SQL seriam listados os grids SQL, num componente Upload seriam exibidos os uploads definidos para o projeto, etc.
Se o campo possuir o link Editar o desenvolvedor poderá usá-lo para ser redirecionado para a tela de definição específica do componente que se encontra selecionado.
O campo Objeto WI define o nome de um objeto que siga o padrão esperado pelo WI Engine.