Definições de Apresentação do Módulo
Deverão ser indicadas algumas definições prévias para que se possam apresentar os novos módulos no ecrã Touchwall, nomeadamente:
- id DIV (identificação única da área onde será apresentado o módulo);
- subid DIV (identificação da DIV da qual o módulo é dependente)
- largura (px);
- altura (px);
- posição X (px);
- posição Y (px);
- cor de fundo do módulo;
Devem ainda ser indicados os seguintes dados relativos ao objecto/método a ser chamado:
- objecto;
- método (a ser criado para apresentação dos dados);
- elementos a serem utilizados para chamar o método em questão (só estão disponíveis
elementos que sejam solicitados no ecrã de selecção);
No caso concreto de se querer que o método seja chamado recursivamente deve ser indicado também o intervalo de tempo em ms (milissegundos) que deverá decorrer entre cada chamada do respectivo método.
Há ainda que indicar se se deseja que o conteúdo do módulo seja actualizado, substituindo o existente (colocar pisco), ou se se pretende que o mesmo seja “adicionado” ao já existente (sem pisco).
Dicionário → Reports → Definições p/ Módulos Touchwall [SR036]
Método de apresentação dos dados
Para que os dados pretendidos sejam apresentados no ecrã será necessário criar um método cujo objectivo é o de invocar um objecto/método já existente na aplicação e preparar a informação disponibilizada por este para que esta seja “formatada” de acordo com o pretendido.
Este “método de apresentação” recebe os dados provenientes do Report, e tendo em conta os elementos nas definições, utiliza os indicados para efectuar a chamada ao objecto/método que se pretende invocar.
$parXXXXX [‘ENTI’] [0] [‘val1’] = $par [‘ENTI’] [0] [‘val1’];
Terá sempre de ter em conta o facto de que este último poderá necessitar de receber elementos adicionais, os quais devem ser também indicados por forma a garantir a correcta recepção das informações pretendidas.
$parXXXXX [‘APST’] [0] [‘val1′] = ’90’;
É de salientar que pode ainda ser necessário efectuar a correspondência entre elementos os disponibilizados pelo report e elementos do método a ser invocado.
$parXXXXX [‘BEXD’] [0] [‘val1’] = $par [‘DTVL’] [0] [‘val1’];
Com as informações recebidas após a chamada ao objecto/método, deve ser construída uma tabela com os dados se pretenda apresentar. Esta tabela deve ser guardada na variável $data [0] [“VALUE”].
$data [0] [‘VALUE’] =”<table> (…) </table>”;
No caso de o método de apresentação necessitar de efectuar posteriormente a chamada a uma função, esta deve ser indicada na variável $data[0][“FUNC”]. Ter em atenção, que se deve indicar apenas o nome da função. No caso desta “necessitar” de lhe serem “passados” parâmetros, estes devem ser indicados na variável $data[i][“PARAM”], separados por “,” (virgula) e onde o índice “i” deve começar em 1.
$data [1] [‘PARAM’] = “‘”.PARAM1.”‘,'”.PARAM2.”‘,'”.PARAM3.”‘”;
É possível indicar mais que uma “linha” de parâmetros, pois poderá existir a necessidade de chamar esta função de JavaScript mais que uma vez e com diferentes parâmetros (ex. apresentar as diferentes posições dos operadores)
$data [1] [‘PARAM’] = “‘”.PARAM1A.”‘,'”.PARAM2A.”‘,'”.PARAM3A.”‘”;
$data [2] [‘PARAM’] = “‘”.PARAM1B.”‘,'”.PARAM2B.”‘,'”.PARAM3B.”‘”;
$data [Z] [‘PARAM’] = “‘”.PARAM1Z.”‘,'”.PARAM2Z.”‘,'”.PARAM3Z.”‘”;
No final deve-se efectuar um echo da variável $data após esta ser codificada utilizando a função json_encode.
echo json_encode ($data);