Cadastro / Edição de Indicadores (Admin)
1. O que é
Tela Cadastro de Indicador ou Edição de Indicador. Define código de referência, título, tipo de análise, unidade, sequência, conceituação, coleta, queries (geral e por dimensão) e flags de exibição/carga.
Acessada por Adicionar Indicador ou lápis na listagem.
2. Pré-requisitos
- Acesso Admin a indicadores.
- Conhecimento das queries de carga (parâmetros
:dt_competenciae:CD_CEN_CIR). - Licença válida.
3. Variantes / ações
| Ação | Efeito |
|---|---|
| Salvar | Insere/atualiza e volta à listagem |
| Voltar | Listagem sem salvar |
Tipo Análise: Maior Melhor / Menor Melhor.
Unidade: Valor / Percentual / Quantidade.
4. Onde configurar
Caminho: Admin → Configurações → Indicadores → Adicionar/editar.
4.1 Identificação
| Campo | Obrigatório |
|---|---|
| Código Referência | Sim |
| Título | Sim |
| Tipo Análise | Maior Melhor / Menor Melhor |
| Unidade | Valor / Percentual / Quantidade |
| Sequência | ≥ 1 |
| Conceituação / Coleta de Dados | Textos |
4.2 Queries e desdobramentos
| Campo / flag | Uso |
|---|---|
| Query | Query principal |
| Query por Centro Cirúrgico + Desdobramento por Centro Cirúrgico | Dimensão CC |
| Query por Sala + Desdobramento por Sala | Dimensão sala cirúrgica |
| Query por Convênio + Desdobramento por Convênio | Convênio |
| Query por Procedimento + Desdobramento por Procedimento | Procedimento |
| Query por Prestador + Desdobramento por Prestador | Prestador |
| Query por Circulante + Desdobramento por Circulante | Circulante |
Texto de ajuda na tela: queries de desdobramento só valem se preenchidas; senão o sistema desdobra automaticamente. Parâmetros globais: :dt_competencia e :CD_CEN_CIR.
4.3 Flags
| Flag | Efeito |
|---|---|
| Executar carga do indicador em competências anteriores | Carga retroativa |
| Exibir no Dashboard | Home / dashboard |
| Exibir no e-mail | Inclusão em e-mail |
| Ativo | Indicador habilitado |
5. Procedimentos relacionados
| Necessidade | Doc |
|---|---|
| Listagem | kpainel-admin-Indicadores.md |
| Metas e Executar Carga | kpainel-admin-IndicadoresMeta.md |
6. Publicação / validação
- Salvar indicador ativo com Exibir no Dashboard se for para a Home.
- Cadastrar meta no CC e executar carga.
- Conferir valor na Home Admin.
7. Checklist de sustentação
| Sintoma | Verificar |
|---|---|
| Erro ao salvar | Código referência e título; sequência ≥ 1 |
| Carga falha | Query e parâmetros :dt_competencia / :CD_CEN_CIR |
| Sem desdobramento | Query da dimensão ou flag de desdobramento |
8. Fluxo resumido
- Preencher identificação e unidade/análise.
- Informar queries necessárias.
- Marcar flags → Salvar → configurar metas.
9. Pontos de atenção
- Não documentar SQL de produção neste guia; valide queries em homologação.
- Desdobramento por Sala refere-se à sala cirúrgica.


