Histórico da Página
...
O objeto ChartServiceVO, disponível no pacote com.totvs.technology.wcm.common.chart, é composto dos seguintes elementos:
String id: código do serviço de gráfico
String description: descrição do serviço de gráfico
String ParametersRest: URL do serviço rest que retornará os parâmetros
String dataRest: URL do serviço rest que retornará os dados do gráfico
O Visualizador de Gráficos tem como objetivo principal permitir a outras aplicações, exibirem gráficos customizados de forma simples dentro do Fluig. Para isto, basta a aplicação registrar seu serviço de gráfico no Fluig e disponibilizar dois métodos rest. Um que informará os parâmetros de configuração do gráfico e outro que disponibilizará os dados.
O Visualizador de Gráficos permite exibição em formato, tabela, gráfico de coluna e gráfico de pizza.
1. Registrar o serviço de dados no Fluig.
Para isto, basta enviar uma mensagem assíncrona pro fluig, com o evento “REGISTER_CHART_SERVICE” , passando um ChartServiceVO com os dados do seu serviço.
O ChartServiceVO (pacote com.totvs.technology.wcm.common.chart) é composto dos seguintes elementos,
String id - > código do serviço de Gráfico
String description -> Descrição do serviço de Gráfico
String ParametersRest -> URL do serviço rest que retornará os parâmetros;
String dataRest -> URL do serviço rest que retornará os dados do gráfico;
Exemplo:
ChartServiceVO ecm1 = new ChartServiceVO("ECM1", "ECM - Volumes: Espaço Utilizado (Por Volume em %)");
ecm1.setDataRest(“http://localhost:8080/portal/ecm/api/rest/ecm/volume/chartDataByVolume");
ecm1.setParametersRest(“http://localhost:8080/portal/ecm/api/rest/ecm/volume/chartParametersByVolume");
IntegrationUtil.sendAsyncMessage(WCMAsyncEvents.REGISTER_CHART_SERVICE.getEvent(), ecm1);
Este registro precisa ser executado cada vez que aplicação é deployada, ou seja cada vez que o fluig subir. Para isto sugerimos que seja criado um servlet em sua aplicação com a opção loadOnStartup = 1, que se encarregará de realizar esta tarefa.
2.
...
Serviços de
...
Parâmetros
Este serviço rest deverá retornar uma lista de ChartParameterVO, que conterá os parâmetros que seu serviço de dados precisará para fornecer os dados do gráficos. Com base neste serviço o Fluig construirá a tela de configuração.
O ChartParameterVO (pacote com.totvs.technology.wcm.common.chart) é composto dos seguintes elementos,:
int code id - > Código : código numérico sequencial que será usado para busca dos dados posteriormente
String title - > Nome : nome do campo como aparecerá na tela
String type - > Tipo : tipo de campo (ChartParameterVO.TYPE_STRING, ChartParameterVO.TYPE_NUMBER, ChartParameterVO.TYPE_DATA ou ChartParameterVO.TYPE_BOOLEAN)
String AllowedList - > Se : se o campo for tipo string, pode ser informados opções para o usuário selecionar em uma lista. Esta opção são separadas por “;”.
boolean multipleSelection - > true/false, caso permita ou não seleção múltipla se o AllowedList esteja em uso.
String value - > Valor inicial se existir.
Exemplo:
List<ChartParameterVO> params = new ArrayList<>();
ChartParameterVO param1 = new ChartParameterVO();
param1.setCode(1);
param1.setTitle("Código do Item");
param1.setType(ChartParameterVO.TYPE_STRING);
param1.setAllowedList(“Item 1;Item 2;Item 3”);
param1.setMultipleSelection(ChartParameterVO.SELECTION_UNIQUE);
params.add(param1);
ChartParameterVO param2 = new ChartParameterVO();
param2.setCode(2);
param2.setTitle("Exibir somente itens ativos");
param2.setType(ChartParameterVO.TYPE_BOOLEAN);
params.add(param2);
return params;
3. Serviço de dados
...