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

Configuração TMS

Objetivos e Âmbito

Esta nova funcionalidade, o TMS, que passa a fazer parte integrante do WPMS, recorre a uma aplicação externa, sendo por isso necessária uma configuração inicial dos sistemas que irão comunicar entre si, bem como de parameterizações especificas que irão ser utilizadas por este “módulo”.

Pretentede-se com esta documento indicar os passos necessários para a configuração inicial do sistema TMS no WPMS.

Ativação do TMS

Foi criado um novo parâmetro de sistema que permite activar/desactivar as funcionalidades directamente ligadas à utilização do TMS. Este parâmetro pode tomar apenas dois valores 1 ou 0, sendo que activa o TMS no caso do seu valor estar a 1.

Nos ecrans seguintes é apresentada a forma de como proceder a esta activação.

Instalação -> Base -> Instalações [IG001]

Selecione a instalação onde pretende ativar o TMS.

Ao clicar no botão (Parâmetros) irá para o écran dos Parâmetros de Sistema:

Clique em (Modificar) e no parâmetro de sistema “usesTMS” colocar o valor “1”.

Guardar a nova configuração usando o botão .

Deverá ser efectuado um restart aos serviços e todos os utilizadores com sessão aberta devem terminar as mesmas e voltar a efectuar login no WPMS.

Criação de um numerador para Extração de contentores

Para que a identificação de cada conjunto de contentores possa ser idêntificada univocamente é necessário criar um numerador que será posteriormente utilizado aquando da solicitação da extração de contentores a enviar para o sistema remoto.

Para tal há que proceder da seguinte forma:

Aplicação -> Elementos Base -> Outros Dados -> Numeradores -> Numeradores [IG015]

Seleccione o botão adicionar

Preencha os campos Numerador, Tipo de Numerador, Número de Caracteres e Estrutura. Ex:

Seleccione o botão para guardar os dados introduzidos. Após a criação do novo numerador deve-se proceder à definição do intervalo do numerador. Seleccione o numerador criado anteriormente e o botão

Após esta seleccção seleccione o botão para adicionar o novo intervalo.

Deve preencher os campos Intervalo, Primeiro Valor, Último Valor. Ex:

Seleccione o botão para guardar os dados introduzidos.

Criação de Sistema Externo

Para que seja possivel a comunicação com o sistema que nos irá devolver dados relativos ao TMS, é necessário que seja criado/configurado um novo sistema externo que autorize o WPMS a comunicar com o “exterior”.

Assm há que proceder da seguinte forma:

Instalação -> Interfaces -> Sistemas Externos [IG004]

Seleccione o botão adicionar

Preencha os campos Sistema Externo e Password. Seleccione o botão para guardar os dados introduzidos.

Cria Objecto/Método com protocolo de dados

Após a criação do sistema externo é necessário indicar o método que irá estar disponivel para o TMS comunicar com o WPMS informando que tem dados optimizados para serem recolhidos.

Assim há que proceder da seguinte forma:

Instalação -> Adaptações Locais -> Objecto/Método com protocolo de dados [IG026]

Seleccione o botão adicionar

Preencha todos os campos com os dados indicados:

  • Objecto: FAPLOG920
  • Método: optimizationReadyCall
  • Sistema Externo: (o sistema externo criado no ponto anterior)Protocolo de Dados: SOAP
  • Endereço do Sistema Externo: (IP indicado pelo fornecedor do serviço)

Seleccione o botão para guardar os dados introduzidos.

Após esta acção deve seleccionar o Objecto/Método FAPLOG920 – optimizationReadyCall e clicar no botão para que seja gerado o WSDL relativo ao método em questão.

Será então apresenta a seguinte mensagem:

Cria Definições Objectos/Métodos remotos

Por outro lado é necessário indicar no WPMS todos os métodos remotos que irão utilizados bem como as definições dos mesmos para que os mesmos possam ser utilizados nos métodos “internos” do WPMS.

Proceda da seguinte forma:

Instalação -> Adaptações Locais -> Definições Objectos/Métodos remotos [IG027]

Seleccione o botão adicionar

Preencha os dados relativos ao objecto e método do WPMS que irá utilizar o método remoto. Indique ainda os dados relativos ao sistema e método remoto a ser utilizado.

Ex:

Seleccione o botão para guardar os dados introduzidos.

Deve repetir esta acção para todos os métodos remotos que deseja usar.

Dúvidas e Outras Questões

Esclarecimento de dúvidas ou outra qualquer questão relacionada com a parametrização e/ ou utilização desta funcionalidade podem ser colocadas ao serviço técnico da Isretail via tel: 211509901 ou pelo e-mail: tech@isretail.eu