Antes de começar, veja a página "
Introdução" para os pré-requisitos gerais do sistema e o passo a passo de login. Em caso de dúvidas, consulte também o
FAQ.
Um Indicador é a medida que dá nome a uma Meta de convênio (por exemplo, "Estimativa de Número de empregos gerados"). É neste cadastro, na Administração, que a lista de indicadores disponíveis para as Metas é mantida. O item "Indicadores" só aparece no menu para os perfis que têm permissão para consultá-lo; as ações de inserir, editar e ativar/inativar também dependem de permissões próprias do perfil.
- Acesse Administração no menu lateral e clique em "Indicadores".

-
A listagem mostra todos os indicadores, dos alterados mais recentemente para os mais antigos, com o Nome e o Status (ATIVO ou INATIVO) de cada um. Na coluna Ações ficam o ícone de lápis (editar) e o interruptor de ativar/inativar.
-
Para localizar um indicador, digite parte do nome no campo "Pesquisar...".

- Para ver só os indicadores ativos ou só os inativos, use o filtro "Filtrar por Status" e escolha Ativo ou Inativo. Para voltar a ver todos, clique no "X" do filtro.

Obs: quando nenhum indicador atende ao filtro, a tabela exibe a mensagem "Não existem registros para exibição."

- A tabela mostra 5 indicadores por página; use a paginação, no rodapé, para navegar entre as páginas ou para alterar a quantidade de linhas exibidas. O ícone de atualizar, no canto superior direito do painel, recarrega a listagem. Depois de inserir, editar ou ativar/inativar um indicador, a tabela volta para a primeira página, onde o indicador alterado aparece no topo.
- Na listagem, clique em "Inserir Indicador".

- Preencha o campo Nome (Campo Obrigatório, até 200 caracteres) com o nome do indicador.

Obs: enquanto o Nome estiver vazio, o botão "Salvar" fica desabilitado e o campo exibe a mensagem "Nome é obrigatório".

-
Clique em "Salvar". O sistema pede confirmação — "Tem certeza que deseja salvar as informações fornecidas?" — e, ao clicar em "Sim", exibe a mensagem "Indicador inserido com sucesso." e volta para a listagem, onde o novo indicador já aparece com o status ATIVO.
-
Para desistir do cadastro, clique em "Cancelar". O sistema pede confirmação — "Você tem alterações não salvas, tem certeza de que deseja sair?" — e, ao clicar em "Sim", volta para a listagem sem salvar.

Obs: todo indicador novo nasce Ativo. O Nome precisa ser único: se já existir um indicador com o mesmo nome, o sistema recusa o cadastro e exibe a mensagem "Já existe um indicador com este nome." A comparação não diferencia maiúsculas de minúsculas e ignora espaços no início e no fim do nome. Nesse caso, nenhum indicador é criado e o formulário continua aberto para você ajustar o nome. Se tiver dúvida, use o campo "Pesquisar..." da listagem para conferir se o indicador já existe.

- Na listagem, clique no ícone de lápis da linha do indicador que deseja editar.

- Altere o Nome (Campo Obrigatório, único entre os indicadores) e clique em "Salvar". O sistema pede confirmação ("Tem certeza que deseja salvar as informações fornecidas?") e, ao clicar em "Sim", exibe a mensagem "Indicador editado com sucesso." e volta para a listagem. Para sair sem alterar, clique em "Cancelar" e confirme.
Obs: o Nome é a única informação editável do indicador — a situação (Ativo/Inativo) é alterada pelo interruptor da listagem, como descrito no cenário 1.4. As Metas não guardam uma cópia do nome — elas se vinculam ao indicador —, então o nome atualizado passa a aparecer também nas Metas que já usam esse indicador. Se o novo nome for igual ao de outro indicador, o sistema recusa a alteração com a mensagem "Já existe um indicador com este nome." Se você salvar sem mudar o nome, a edição é aceita normalmente.
- Na listagem, clique no interruptor da linha do indicador. O sistema pede confirmação: "Você tem certeza que deseja alterar a situação deste indicador?".

-
Clique em "Sim" para confirmar. O sistema exibe a mensagem "Status atualizado com sucesso." e a listagem é recarregada com o novo status. Clique em "Não" para manter a situação atual.
-
Um indicador inativo pode ser reativado a qualquer momento, da mesma forma.
Obs: um indicador que já está em uso por uma ou mais Metas não pode ser inativado. Nesse caso, o sistema exibe a mensagem "O indicador está em uso por uma ou mais Metas e não pode ser inativado" e o indicador continua Ativo.

Obs: na tela de Metas do convênio, só são oferecidos os indicadores ativos. Ao editar uma Meta cujo indicador esteja inativo, ele continua aparecendo na lista, com a marca "(inativo)", para que a Meta não perca o vínculo.
| Regra | Descrição |
| RN69.1 | O cadastro de Indicadores tem cinco permissões independentes: listar, inserir, detalhar, atualizar e ativar/inativar. O item de menu depende só da permissão de listar; os botões "Inserir Indicador", "Editar" e o interruptor de situação só aparecem para quem tem a respectiva permissão. |
| RN69.2 | O Nome do indicador é obrigatório e tem no máximo 200 caracteres. |
| RN69.3 | Todo indicador novo é criado como Ativo e com o tipo Decimal — o formulário não permite escolher a situação nem o tipo. |
| RN69.4 | O Nome do indicador deve ser único: ao inserir ou editar, o sistema recusa um nome já usado por outro indicador (ativo ou inativo), sem diferenciar maiúsculas de minúsculas e ignorando espaços no início e no fim, e exibe a mensagem "Já existe um indicador com este nome." |
| RN69.5 | Editar um indicador altera somente o Nome (inclusive de um indicador inativo). Como as Metas guardam apenas o vínculo com o indicador, o novo nome passa a valer em todas as Metas que já o usam. |
| RN69.6 | Um indicador não pode ser inativado se houver qualquer Meta vinculada a ele — inclusive Metas canceladas ou concluídas. Reativar um indicador não tem restrição. |
| RN69.7 | A listagem traz todos os indicadores (ativos e inativos), dos alterados mais recentemente para os mais antigos; a pesquisa por nome e o filtro de Status são aplicados na própria tela, sobre a lista já carregada. Depois de inserir, editar ou ativar/inativar, a tabela volta para a primeira página. |
| RN69.8 | Alterar a situação de um indicador pede confirmação antes de ser efetivada. |
| RN69.9 | A lista de Indicadores oferecida ao cadastrar ou editar uma Meta traz somente os indicadores ativos; ao editar uma Meta, o indicador já vinculado continua na lista mesmo que esteja inativo, identificado com "(inativo)". |
| RN69.10 | Ao editar um indicador sem alterar o Nome, o sistema aceita o salvamento normalmente, mesmo que já exista outro indicador com o mesmo nome cadastrado antes da regra de nome único. A recusa só vale quando o nome é alterado para um já existente. |
| Campo | Descrição |
| Sistema | Harpia (Gestão 360) |
| Versão | 1.7 |
| Data de Atualização | 2026-10-20 |
| Responsável | Amanda Galvão |
| Público-alvo | usuários administradores responsáveis pelo cadastro dos indicadores usados nas Metas dos convênios |
| Objetivo | consultar, cadastrar, editar e ativar/inativar um Indicador |
| Tipo | Documento de referência / treinamento |
| Versão | Data | Descrição da Alteração | Responsável pela Aprovação |
| 1.7 | 2026-10-20 | Screenshots de listagem e inserção recapturados no hml, refletindo o novo breadcrumb do hml (sem "CONVÊNIOS" no caminho, apex-fsw-2026-0475). | Amanda Galvão |
| 1.6 | 2026-10-15 | Adicionado o bloco "Veja Também" com links para os guias relacionados e o card correspondente no Sumário | Amanda Galvão |
| 1.5 | 2026-10-13 | O Nome do indicador passa a ser único: ao inserir ou editar, o sistema recusa um nome já existente com a mensagem "Já existe um indicador com este nome."; acrescentada a captura de tela da mensagem, reescrita a RN69.4 e adicionada a RN69.10. | Amanda Galvão |
| 1.4 | 2026-10-09 | Atualizada a captura de tela da listagem de Indicadores, agora na ordem do indicador alterado mais recentemente para o mais antigo. | Amanda Galvão |
| 1.3 | 2026-10-09 | A listagem passa a ser ordenada do indicador alterado mais recentemente para o mais antigo e a tabela volta à primeira página após inserir, editar ou ativar/inativar; documentado que a tela de Metas oferece só indicadores ativos; atualizada a RN69.7 e adicionada a RN69.9. | Amanda Galvão |
| 1.2 | 2026-10-07 | Corrigidas as confirmações de Salvar e Cancelar nos cenários de inserção e edição. | Amanda Galvão |
| 1.1 | 2026-10-07 | Adicionada a seção "Regras de Negócio Relacionadas" (RN69.1 a RN69.8). | Amanda Galvão |
| 1.0 | 2026-10-07 | Versão inicial da documentação | Amanda Galvão |