Módulos para Touchwall

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);