Páginas filhas
  • ER_PCREQ-9574_Inclusão_do_tipo_de_resultado_Mapa_de_Calor_no_módulo_de_Indicadores

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Especificação

Produto

PIMSMULTICULTIVOS

Módulo

PIMSMC

Segmento Executor

Agroindústria

Projeto1

A_AGR_DES001 v2

IRM1

PCREQ-9573

Requisito1

PCREQ-9574

Subtarefa1

PDR_AGR_DES001-155

Chamado2

 

País

(X) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

 (Obrigatório)

Objetivo

Inclusão do Tipo de Resultado Mapas Quentes no módulo de Indicadores.

 (Obrigatório)

Definição da Regra de Negócio 

1- Alteração no cadastro de Legendas para identificar o Tipo da Legenda.

Objetivo: Cadastrar e configurar as Legendas que poderão ser utilizadas nos Indicadores quando o resultado é em Mapa, Mapas de Calor ou em Consulta. Para o resultado em Mapa será utilizada para pintar os Talhões de acordo com o valor e legenda utilizada. Para o resultado em Consulta será utilizado para pintar os campos segundo o seu valor e Legenda utilizada. Para o resultado em Mapas de Calor será utilizada para formar Gradiente de cores no mapa de acordo com o valor expresso. Para Mapa de Calor o tipo de Legenda deve ser Proporcional e para os demais deve ser Faixa de Valores.

Menu: Tabelas > Indicadores > Legenda

Entrada de menu: INDM0001

Esboço da tela:

Campos Obrigatórios:

-    Tipo: Tipo da Legenda. Por padrão o tipo é de Faixa de Valores.

  • Faixa de Valores: Identifica que o Tipo da Legenda é por Faixa de Valores. Esse tipo é utilizado para indicadores do tipo Mapa, Consultas e Gráfico com Faixa de Valores.
  • Proporcional: Identifica que o tipo de Legenda é para cores proporcionais aos valores. Esse tipo é utilizado somente para indicadores do tipo Mapa de Calor. Quando selecionado o tipo Proporcional, o campo “Cadastro” fica desabilitado e sem valor, o campo Tipo de Dado fica desabilitado e com o tipo “Numérico”, o campo “Valor Final” fica desabilitado e sem valor, e o campo “Valor Inicial” representa o índice da Cor, onde valor maior indica cor mais quente.

Valores

 Objetivo: Configurar os intervalos de valores, classificação e cores para a Legenda. Quando a Legenda estiver relacionada a Cadastro, não será possível Incluir ou Excluir valores para a Legenda. Os valores serão atualizados automaticamente de acordo com o Cadastro. Quando a Legenda for do tipo Proporcional não é possível informar o valor final, e o valor inicial representa o índice da cor.

Campos Obrigatórios:

   Valor Inicial: Valor Inicial para a Cor da Legenda. Se o tipo de Dado da Legenda for Numérico, será permitido informar até 10 inteiros com 4 decimais. Se o tipo de Dado da Legenda for Alfanumérico, será permitido informar até 20 caracteres. Se a Legenda for relacionada a Cadastro, o Valor Inicial será o Código do registro a que se refere e esse campo ficará desabilitado. O Valor Inicial deve ser menor ou igual ao Valor Final. Se a Legenda não for relacionada a Cadastro, não é possível intercalar valores entre os Valores Iniciais e Valores Finais. Se a Legenda for Proporcional indica o índice/ordem da cor, sendo que valor maior indica cor mais quente.

-    Valor Final: Valor Final para a Cor da Legenda. Se o tipo de Dado da Legenda for Numérico, será permitido informar até 10 inteiros com 4 decimais. Se o tipo de Dado da Legenda for Alfanumérico, será permitido informar até 20 caracteres. Se a Legenda for relacionada a Cadastro, o Valor Final será o Código do registro a que se refere e esse campo ficará desabilitado. O Valor Final deve ser maior ou igual ao Valor Inicial. Se a Legenda não for relacionada a Cadastro, não é possível intercalar valores entre os Valores Iniciais e Valores Finais. Campo desabilitado e com o mesmo valor de Valor Inicial se o tipo da Legenda for Proporcional.

 Filtros

Campos:

-    Tipo: Tipo da Legenda:

  • [Em branco]: Não aplica filtro por Tipo de Legenda.
  • Faixa de Valores: Filtra as legendas do tipo “Faixa de Valores”.
  • Proporcional: Filtra as legendas do tipo “Proporcional”.

Especificação Técnica

Tabelas:

Descrição

Nome

Situação

Cadastro de Legendas

LEGENDA

Alterada

 -    Campos tipados da tabela LEGENDA:

Tabela

Campo

Padrão

Visualização

Gravação

TP_LEGENDA

LEGENDA

Sim

Faixa de Valores

F

 

 

 

Proporcional

P

Criar o campo TP_LEGENDA com valor default “F”

2- Alteração no cadastro de Indicadores para incluir o tipo de resultado Mapa de Calor.

Objetivo: Cadastrar e configurar Indicador do Tipo de Resultado Mapa de Calor.

 Menu: Tabelas > Indicadores > Indicadores

Entrada de menu: INDM0002

Esboço da tela:

Campos Obrigatórios:

-    Tipo de Resultado: Forma de representação do resultado para o Indicador.

Resultados possíveis:

  • Mapa de Calor: Resultado expresso em Mapa de Calor. Desde que a aplicação esteja configurada para utilização de mapas e os Locais de Produção estejam com os polígonos definidos. Para Mapa de Calor é necessário também possuir Coordenada (X e Y) com seu respectivo valor a ser expresso.

Demais Campos:

  • Legenda: Legenda que será utilizada para representar o intervalo de valor em que enquadra um determinado valor de um campo dentro da consulta. A Legenda deve estar previamente cadastrada e para o Tipo de Resultado “Mapa de Calor” deve ser do tipo “Proporcional”, caso contrário deve ser do tipo “Faixa de Valores”. Será obrigatório informar a Legenda para representar os seguintes resultados: Mapa, Gráfico de Linhas (estilo: Com Faixa de Valores) e Gráfico Velocímetro (Gauge). Para o Tipo de Resultado “Mapa de Calor” é opcional informar a Legenda, se não informada será utilizada legenda padrão do sistema. Para os demais resultados e estilos, o campo Legenda fica desabilitado e sem valor.

 Utilização da Legenda segundo o Resultado:

  • Mapa: A legenda é utilizada para colorir cada polígono do Local de Produção, de acordo com o valor que está sendo representado no Mapa irá identificar qual o intervalo de valores em que se enquadra na legenda e colori-lo.

 Exemplo 1:

          Consulta em Mapa segundo a Cultura/Ocupação.

          Cores da Legenda:         

Nesse exemplo, os Locais de Produção de Soja terão a cor azul e os de Milho terão a cor vermelha.

Exemplo 2:

           Consulta em Mapa segundo Custo por hectare.

           Cores da Legenda:

Nesse exemplo, os Locais de Produção com custo por hectare até 100,00 terão a cor verde, os Locais de Produção com custo acima de 100,00 até 150,00 terão a cor amarela e os Locais de Produção com cores acima de 150,00 terão a cor vermelha.

  • Gráfico de Linhas (estilo com Faixa de Valores): A legenda é utilizada para colorir e descrever cada Faixa de Valores do eixo Y no gráfico.

Exemplo:

           Consulta de Custo por Hectare para as Fazendas.

           Eixo X: Fazenda

          Eixo Y: Custo por hectare

           Cores da Legenda:

Nesse exemplo, o intervalo do Eixo Y de 0 até 100,00 terão a cor verde e a descrição “Bom”, o intervalo do Eixo Y acima de 100,00 até 150,00 terão a cor amarela e a descrição “Regular” e os valores do Eixo Y acima de 150,00 terão a cor vermelha e a descrição “Ruim”.

  • Gráfico de Velocímetro (Gauge): A legenda é utilizada para definir e colorir os intervalos do gráfico de velocímetro.

Exemplo:

            Gráfico de Velocímetro para representar a quantidade de hectares plantados por Dia.

Nesse exemplo, o gráfico possuirá 3 cores, sendo que de 0 a 50 possuirá a cor Vermelha, acima de 50 até 70 possuirá a cor Amarela e acima de 70 possuirá a cor Verde.

  • Mapa de Calor: A legenda é utilizada para colorir as áreas quentes e frias do mapa, formando gradiente de acordo com as cores.

Exemplo:

           Consulta em Mapa de Calor representando a infestação de uma determinada fitossanidade. 

           Atenção: Valor Inicial e Valor Final não representam % de infestação e sim a ordem para formação do gradiente.

Exemplo de representação da legenda:



 

 

 


 

 

Botão Validar

Objetivo: Validar as configurações do Indicador.

Demais Validações:

 -    Propriedades – Mapa de Calor: Validações nas propriedades quando o resultado é do tipo Mapa de Calor.

  • Identificação do Valor: O nome do campo informado como Identificação do Valor deve constar no resultado do comando SQL e deve ser do tipo Numérico.
  • Identificação do [Local de Produção]: O nome do campo informado como Identificação do Local de Produção deve constar no resultado do comando SQL e deve ser do tipo Numérico.
  • Identificação de Etiqueta: Se informada Identificação de Etiqueta, o nome do campo informado deve constar no resultado do comando SQL.
  • Coordenada X: O nome do campo informado como identificação da Coordenada X deve constar no resultado do comando SQL e deve ser do tipo Numérico.
  • Coordenada Y: O nome do campo informado como identificação da Coordenada Y deve constar no resultado do comando SQL e deve ser do tipo Numérico.

Propriedades

Objetivo: Configurar as propriedades do Indicador. As propriedades disponíveis são de acordo com o tipo de Resultado configurado.

 Propriedades – Mapa de Calor

Campos Obrigatórios:

-    Identificação do Valor: Nome do campo na consulta que identifica o Valor que será representado no Mapa de Calor. Por exemplo, para consulta de número de plantas atacadas por uma determinada fitossanidade será o campo NR_PL_ANALISADAS. (tamanho do campo: 30 caracteres).

-    Identificação do [Local de Produção]: Nome do campo na consulta que identifica o [Local de Produção] que será representado no Mapa. O nome do campo deve ser representado pelo ID do Local de Produção, por exemplo, ID_UPNIVEL3. (tamanho do campo: 30 caracteres).

-    Identificação da Coordenada X: Nome do campo na consulta que identifica a coordenada X. Esse campo é utilizado georeferenciar cada valor. Exemplo para o nome do campo: COORD_X. (tamanho do campo: 30 caracteres).

-    Identificação da Coordenada Y: Nome do campo na consulta que identifica a coordenada Y. Esse campo é utilizado georeferenciar cada valor. Exemplo para o nome do campo: COORD_Y. (tamanho do campo: 30 caracteres).

-    Estilo: Definição de Estilo/Modo do Mapa de Calor. Ao clicar sobre a imagem de exemplo do estilo, é aberta uma nova janela com exemplo do Mapa.

  • Exponencial: Modo Exponencial para interpolação dos valores. Por padrão é o tipo Exponencial. A fórmula exponencial é dada pela equação:

  • Esférico: Modo Esférico para interpolação dos valores. A fórmula esférica é dada pela equação:

  • Gaussiano: Modo Gaussiano para interpolação dos valores. A fórmula gaussiana é dada pela equação:

Demais Campos:

-    Identificação de Etiqueta: Nome do campo na consulta que será utilizado como Etiqueta no polígono do Talhão, por exemplo, numa consulta de Cultura/Ocupação pode-se colocar a etiqueta com a Descrição da Ocupação no polígono do Talhão, nesse caso o campo que representa a etiqueta pode ser DE_OCUPACAO. (tamanho do campo: 30 caracteres).

-    Valor Mínimo: Valor mínimo para representar as cores e legenda no Mapa. Se não informado será considerado como valor mínimo o menor valor retornado na consulta. (tamanho do campo: Tamanho do campo: 10 inteiros e 6 decimais).

-    Valor Máximo: Valor máximo para representar as cores e legenda no Mapa. Se não informado será considerado como valor máximo o maior valor retornado na consulta. Se informado o valor mínimo e o máximo, o mínimo deve ser menor ao máximo. (tamanho do campo: Tamanho do campo: 10 inteiros e 6 decimais).

 Filtros

 Objetivo: Aplicar os filtros para o cadastro assim como aplicá-lo na emissão de relatório e exportação de dados em XML.

 Filtros:

-   Código: Código do Indicador.

-   Descrição Completa: Descrição Completa do Indicador.

-   Tipo de Resultado: Tipo de Resultado do Indicador.

  • Ambos: Todos os tipos de resultados.
  • Mapa: Resultado expresso em Mapa.
  • Mapa de Calor: Resultado expresso em Mapa de Calor.
  • Consulta: Resultado expresso em Consulta.
  • Gráfico - Linhas: Resultado em Gráfico de Linhas.
  • Gráfico -Área: Resultado em Gráfico de Área.
  • Gráfico -Colunas ou Barras: Resultado em Gráfico de Colunas ou Barras.
  • Gráfico - Pizza: Resultado em Gráfico de Pizza.
  • Gauge - Velocímetro: Resultado em Gráfico de Gauge.
  • Processamento: Indicador utilizado para processamento.

Especificação Técnica

Tabelas:

Descrição

Nome

Situação

Propriedades do Indicador ref. a Mapa

INDICADOR_MP

Alterada

-    Campos tipados da tabela INDICADOR (incluir novo tipo):

Tabela

Campo

Padrão

Visualização

Gravação

INDICADOR

TP_RESULTADO

 

Mapa de Calor

MC

-    Campos tipados da tabela INDICADOR_MP:

Tabela

Campo

Padrão

Visualização

Gravação

INDICADOR_MP

TP_ESTILO

Sim

Exponencial

EP

 

 

 

Esférico

EF

 

 

 

Gaussiano

GA

Atenção: O campo CD_AREA deixou de ser obrigatório.

Demais Campos:

  • Legenda: Legenda que será utilizada para representar o intervalo de valor em que enquadra um determinado valor de um campo dentro da consulta. A Legenda deve estar previamente cadastrada e para o Tipo de Resultado “Mapa de Calor” deve ser do tipo “Proporcional”, caso contrário deve ser do tipo “Faixa de Valores”. Será obrigatório informar a Legenda para representar os seguintes resultados: Mapa, Gráfico de Linhas (estilo: Com Faixa de Valores) e Gráfico Velocímetro (Gauge). Para o Tipo de Resultado “Mapa de Calor” é opcional informar a Legenda, se não informada será utilizada legenda padrão do sistema. Para os demais resultados e estilos, o campo Legenda fica desabilitado e sem valor.

 Filtrar a legenda de acordo com o seu tipo, sendo:

Tabela

Campo

Padrão

Visualização

Gravação

TP_LEGENDA

LEGENDA

Sim

Faixa de Valores

F

 

 

 

Proporcional

P

 

3- Alteração na Consulta de Indicador para contemplar o tipo de resultado Mapa de Calor.

Objetivo: Retornar resultado de Indicador do tipo Mapa de Calor.

 Menu: Visões > Indicadores > Indicadores

Entrada de menu: INDV0003

Resultado em Mapa de Calor

 Objetivo: Executar a consulta do Indicador e representar o resultado em Mapa de Calor.

É necessário que os Locais que serão representados no mapa possuam shape importado ou que estejam com seu polígono definido.

Se não definida uma Legenda para o Indicador será utilizada Legenda padrão do sistema.

Em cada Local de Produção poderá ser impressa uma Etiqueta com informação de algum campo, de acordo com a configuração no Indicador.

Dados

Campos:

-    [Campo1 ..CampoN] : Campos com os seus respectivos valores. O campo pode possuir cores de Fontes e cores de Preenchimento da célula de acordo com o seu valor e Legenda configurada para o Campo no cadastro de Indicadores. A largura do campo é dimensionada de acordo com a largura definida para o Campo no cadastro de Indicadores, podendo ser o campo com Largura Automática, onde nesse caso será dimensionada de acordo o tamanho de valor máximo para o campo.

 Demais funcionalidades:

-    - Permite exportar os dados para Excel.

-    Ao posicionar o mouse sobre a Legenda é visualizado o valor no ponto posicionado e a descrição (se informada no cadastro de legenda).

Especificação Técnica

 “Encriptar” o Javascript para não ser visualizado pelo usuário.

 A identificação de Indicador de Mapa de Calor se dá pelo campo:

Tabela

Campo

Padrão

Visualização

Gravação

INDICADOR

TP_RESULTADO

 

Mapa de Calor

MP

A consulta SQL informada no cadastro de Indicador deverá retornar no mínimo os campos referentes à:

  • Valor: Valor que será representado no Mapa.
  • Talhão: Identificação do Talhão (ID_UPNIVEL3)
  • Coordenada X: Coordenada X
  • Coordenada Y: Coordenada Y
  • Opcionalmente:
  • Etiqueta: Etiqueta a ser expressa no Talhão

 O Modo de interpolação deverá ser de acordo com a configuração do Indicador: 

Tabela

Campo

Padrão

Visualização

Gravação

INDICADOR_MP

TP_ESTILO

Sim

Exponencial

EP

 

 

 

Esférico

EF

 

 

 

Gaussiano

GA

Se informada Legenda no Indicador (campo ID_LEGENDA da tabela INDICADOR) deverá carregar os valores por ordem crescente, exemplo:

 SELECT VL_NINI, VL_NFIM, CD_COR, DE_LEGENDA_VL

FROM LEGENDA_VL

WHERE ID_LEGENDA = [Legenda informada no cadastro de Legendas]

ORDER BY VL_NINI

 

4- Alteração no Painel de Indicadores para contemplar o tipo de resultado Mapa de Calor.

Objetivo: Retornar resultado de Indicador do tipo Mapa de Calor no Painel de Indicadores.

 Menu: Visões > Indicadores > Painel

Entrada de menu: INDV0006

Especificação Técnica

Validar e testar que o Indicador do Tipo Mapa de Calor esteja funcionando no Painel de Indicadores.

 

 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

Cadastro de Legendas

Alteração

Tabelas > Indicadores > Legenda

-

Cadastro de Indicadores

Alteração

Tabelas > Indicadores > Indicadores

-

Consulta de Indicadores

Alteração

Visões > Indicadores > Indicadores

-

Painel de IndicadoresAlteraçãoVisões > Indicadores > Painel-

 

 

Dicionário de Dados

 


Diagrama de Entidade e Relacionamento

 

 

 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.