Entidade INDICADORES_PERIODOS

INDQUA.INDICADORES_PERIODOS

Descrição

Registro que mantém os valores previstos (metas) e realizados dos indicadores ao longo de seus períodos de avaliação e controle.

Atenção

Apesar do nome da entidade, nem sempre um indicador será referente a um período. Existem indicadores, por exemplo, vinculados simplesmente a uma campanha comercial e neste caso o período seria irrelevante.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK	Id: Chave de identificação interna
INDICADOR_ID	ID(18)	Rqd UK FK	Indicador: Informa qual o indicador para o qual estes valores estão relacionados. Referência para INDICADORES_QUALIDADE
PERIODO_ID	ID(18)	UK FK	Período: Indica de qual o período que está relacionado a este indicador. Obrigatório no caso de indicadores que possuem o tempo como uma das chaves de escopo. Referência para PERIODOS_TEMPO
ESTABELECIMENTO_ID	ID(18)	FK	Estabelecimento: Estabelecimento para o qual o indicador está relacionado. Obrigatório para indicadores que incluem estabelecimento como uma das chaves de escopo. Referência para ESTABELECIMENTOS
VENDEDOR_ID	ID(18)	FK	Vendedor: Quando informado, indica para qual vendedor esse indicador está relacionado. Obrigatório quando o indicador define vendedor como uma das chaves de escopo. Referência para PESSOAS
CAMPANHA_ID	ID(18)	FK	Campanha: Indica a campanha comercial para a qual o indicador foi registrado. Obrigatório para indicadores que incluem a campanha comercial como uma das chaves do escopo. Referência para CAMPANHAS_COMERCIAIS
ESCOPO	UPPER(80)	Rqd UK	Escopo: Chave única para este indicador, calculada automaticamente de acordo com as chaves de escopo do indicador. Tecnicamente composta pelos seguintes IDs separados por vírgulas: indicador_id periodo_id estabelecimento_id vendedor_id campanha_id Valores nulos são representados por um vazio.
META	DOUBLE(18)		Meta: Valor de meta para o indicador neste período.
REALIZADO	DOUBLE(18)		Realizado: Valor realizado para este indicador neste período.
PUBLICADO	FLAG(1)	Rqd	Publicado: Indica se o indicador já foi tornado "público", ou seja, que os demais usuários podem consultar. Os indicadores permanecem com acesso restrito até que os seus responsáveis tenham analisado e aprovado o seu valor. Valor padrão = N
RESPONSAVEL	UPPER		Responsável: Usuário que publicou o indicador (aprovando-o).
DATA_PUBLICACAO	DATE		Data da publicação: Data em que o indicador foi publicado.
OBSERVACOES	TEXT_LONG(4000)		Observações: Texto livre para que o responsável inclua quaisquer observações pertinentes ao indicador e que poderão contribuir para a sua análise. Estas observações aparecerão nas telas de consulta deste indicador.
MINIMO	DOUBLE(18)		Mínimo: Valor mínimo aceitável.
MAXIMO	DOUBLE(18)		Máximo: Valor máximo aceitável
DATA_HORA_ATUALIZACAO	DATE_TIME		Atualizado em: Data e hora em que o registro foi atualizado a ultima vez. Valor padrão = [SYSDATE]

Regras

Calcular escopo

(Antes de inserir)

Calcula o atributo de escopo para garantir unicidade de informações.

Inferir valores

(Antes de inserir)

Caso não informados, os valores para meta, mínimo e máximo deverão ser iguais ao do último período informado.

Atualizar data e hora

(Antes de inserir, Antes de alterar)

Registra a data/horo em que o registro foi atualizado.

Validar valores

(Antes de inserir, Antes de alterar)

A meta tem que estar entre os valor máximo e mínimo.
O valor mínimo não pode ser superior ao valor máximo.

Atualizar o indicador

(Depois de alterar)

Atualiza o indicador sempre que for alterada a situação de publicação do registro.

Calcular

Calcular o valor realizado para o indicador considerando que os parâmetros do período já estão calculados.

Faixa de tolerância

Retorna um texto representando a faixa da tolerância relacionado com os valores mínimo e máximo relacionados.
Se ambos os valores forem informados, retorna um texto tipo:

valorMinimo a valorMaximo

Caso contrário retorna apenas o valor informado (mínimo ou máximo)

Gerar registros(indicador, periodo, sql)

Gera os registros que para um determinado indicador/período.

Retornar escopo

Calcula uma string que representa o escopo do registro.