Histórico da Página
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 Indicadores | Alteração | Visõ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. |
---|