Suporte e-Ciga

Este livro contém instruções para os atendentes do e-Ciga
Lista de Administradores Locais: e-Ciga Gestores Locais.xlsx

Aggregate

Quantidade de Usuários Aivos
Arquivados
Apensamentos
Pesquisa de processo por data, setor e tipo determinado
Processos tramitados por um determinado usuário
Processos por tipos não numeráveis
Classificadores de documentos Ativos
Listar processos por
Listar processos por data e Setores Atuantes
Listar processos por setores
usuários ativos e documento ativos que não estão juntados a processo
Documentos excluidos
documentos por sufixo e classificação e data
Total de documentos/processos criados por usuário
Setores ativos sem usuários ativos vinculados
Setores sem ninguem
Setores sem ninguem 2
Processos com tramitados a um determinado setor
Precessos movimentados por usuários de detrminado setor
Listar processos em cargas em setores específicos
Processos em carga com usuários determinados com qtd de dias em carga
Processos por tipo não numerável
Apensamento 2
aggregate.eciga.consorciociga.gov.br/?
Arquivados com data
Processos Recebidos e Enviados de um determinado Setor + qtd dias neste setor
Grupos e seus adms
Processos recebidos por um usuário
Usuários integrante de um determinado setor
Arquivamento (filtro de documentos em processos)
Listar grupos e seus adms
Processos recebidos por setor determinado (quem enviou, de onde veio, para onde foi, quem retirou e quando
Documentos Assinados e Não Assinado por um usuário
Documentos por setores (Mostra o doc principal de anexos, dias em carga)
Listar Setores e seus usuários
Assinatura de documentos por um usuário especifico
Listar documentos e suas cargas atuais
Listar Processos e suas cargas atuais
Classificadores ativos
Listar proc mov por 1 usuário por data


Lista doc anexo e seu principal assinado tags
Proc receb por 1 usuário e seu encamin qtd dias com ele
Listar grupo (seus adms) e setores ativos
Processos tramitados de um user para outro
documentos avulsos carga atual status

⚠️ Erro de “Autorização Expirada” ao Assinar com Gov.br

❗ Situação

Ao tentar assinar um documento utilizando o Gov.br, o sistema exibe a mensagem de:

“Autorização expirada”

Mesmo que o tempo disponível para assinatura ainda apareça como válido na tela.

🔍 Causa do Problema

Esse erro ocorre, na maioria dos casos, quando a data e/ou hora do computador do usuário estão incorretas.

📌 Isso acontece principalmente quando:

Como a autenticação do Gov.br depende de validação de tempo (timestamp), qualquer diferença entre o horário do computador e o horário real pode invalidar a autorização.

🛠️ Como Resolver

1️⃣ Ajustar Data e Hora do Computador

  1. Acesse as configurações de data e hora do seu sistema operacional.
  2. Habilite a opção:
    • ✔️ Definir hora automaticamente
  3. Habilite também:
    • ✔️ Definir fuso horário automaticamente
  4. Clique em Sincronizar agora (se disponível).

2️⃣ Reiniciar o Navegador

  1. Feche completamente o navegador.
  2. Abra novamente.
  3. Acesse o e-Ciga e refaça o processo de assinatura.

3️⃣ Tentar Novamente a Assinatura

  1. Retorne ao documento.
  2. Inicie novamente o fluxo de assinatura via Gov.br.

✅ Resultado Esperado

📌 Observações Importantes

🧾 Mensagem Padrão para Atendimento

“Identificamos que a mensagem de ‘autorização expirada’ ocorre quando a data ou hora do computador está incorreta. Ajuste para modo automático e sincronize o horário, depois tente novamente a assinatura.”

❗ Erro: "Chave inválida para uso no estado especificado"

📄 Ao tentar assinar documentos no e-Ciga

💡 O que significa esse erro?

Esse erro ocorre quando o certificado digital instalado no computador ou dispositivo USB (token) não consegue ser utilizado corretamente pelo navegador ou pelo sistema de assinatura. Ele indica que a chave privada associada ao certificado não está acessível ou funcional no momento da operação.

🔍 Causas mais comuns

  1. Token mal encaixado na porta USB

    • O dispositivo pode não estar firmemente conectado ou pode estar intermitente.

    • Solução: Retire e conecte novamente o token em outra porta USB.

  2. Porta USB com mau funcionamento

    • Algumas portas USB podem não fornecer energia ou conexão adequada.

    • Solução: Troque de porta USB, preferencialmente uma porta traseira (em desktops).

  3. Drivers do token ou certificados corrompidos ou desatualizados

    • Pode haver problemas no software do fabricante do token ou na cadeia de certificação digital (ex: ICP-Brasil).

    • Solução:

      • Reinstale os drivers e o gerenciador do seu token (ex: SafeNet, GD Burti, e-Token).

      • Reinstale a cadeia de certificados raiz e intermediários da ICP-Brasil, se aplicável.

✅ Passos recomendados para correção

  1. Remova e reconecte o token

  2. Troque de porta USB

  3. Reinicie o navegador

  4. Teste a assinatura em outro navegador (preferencialmente Chrome)

  5. Reinstale os drivers do token e as cadeias de certificados

🆘 Se o problema persistir:

❗ Erro: "O documento não pode ser assinado"

📄 Durante o processo de assinatura de documentos no e-Ciga

🔍 O que esse erro significa?

Essa mensagem aparece quando o sistema não consegue concluir a operação de assinatura do documento. O motivo pode estar relacionado a problemas no cadastro do documento ou em inconsistências no status da assinatura.

📌 Causas mais comuns

  1. PDF ausente no cadastro do documento

    • O arquivo PDF que deveria estar associado ao documento não foi corretamente salvo no momento do cadastro ou foi corrompido.

    • Solução:

      • Vá até o menu do documento

      • Clique na opção “Reenviar arquivo”

      • Selecione novamente o arquivo PDF original e confirme o envio.

  2. Assinatura já realizada, mas ainda aparece como pendente

    • O sistema pode ter registrado a assinatura, mas por algum erro de atualização, ainda aparece na lista de pendentes.

    • Solução:

      • Atualize a tela (pressionando F5)

      • Verifique no histórico do documento se a assinatura já está registrada.

  3. Arquivo em formato inválido ou corrompido

    • O documento pode ter sido corrompido no upload ou estar com estrutura PDF inválida.

    • Solução:

      • Tente reprocessar o arquivo, por exemplo, utilizando a função “Imprimir em PDF” e substitua o arquivo no sistema.

      • Utilize a opção “Substituir arquivo” no menu do documento (se permitido).

  4. Outros motivos técnicos

    • Problemas com o navegador, sessão expirada, falha de comunicação com a extensão de assinatura, etc.

    • Solução:

      • Certifique-se de estar com a extensão WebPKI ativa.

      • Tente em outro navegador ou reinicie a sessão.

🧩 Quando investigar?

Se as soluções acima não resolverem, o erro pode estar ligado a:

Neste caso, entre em contato com o suporte do e-Ciga pelo chat, informando:

✅ Resumo das ações rápidas

Problema comum Ação recomendada
PDF ausente Menu do documento → Reenviar arquivo
Assinatura não atualiza Atualizar tela (F5) ou verificar histórico
Arquivo inválido Substituir por versão corrigida
Persistência do erro Investigar com maiores detalhes

❗ Erro: “Documento ou Processo Já Cadastrado” no e-Ciga

📄 Correção do Erro “Documento ou Processo Já Cadastrado” no e-Ciga

Quando, ao tentar cadastrar um documento ou processo, o sistema exibe a mensagem informando que o documento ou processo já foi cadastrado, mesmo não existindo visualmente no sistema, normalmente trata-se de uma inconsistência na numeração.
Esse cenário ocorre com mais frequência em situações de lentidão do sistema, quando a reserva de numeração é criada, mas o cadastro não é finalizado corretamente.

🔍 Causa Mais Comum

🛠️ Procedimento de Correção

1️⃣ Acessar o Cadastro de Documentos (ou Processos)

  1. Entre no e-Ciga com perfil administrativo ou de suporte.

  2. Acesse a opção de Cadastro de Documento (ou Processo, conforme o caso).

2️⃣ Selecionar a Classificação Correta

  1. No formulário de cadastro:

    • Selecione exatamente a mesma classificação documental ou processual
      que o usuário tentou utilizar originalmente.

  2. Atenção especial a:

    • Espécie

    • Tipo (se houver)

    • Configurações de numeração (ano, setor, sufixo, etc.)

⚠️ Isso é fundamental para que o sistema atue sobre a mesma sequência de numeração afetada.

3️⃣ Gerar a Reserva de Numeração

  1. Clique no botão Gerar Reserva.

  2. Aguarde o sistema apresentar o número reservado.

4️⃣ Cancelar a Reserva

  1. Assim que o número for exibido:

    • Cancele a reserva imediatamente.

  2. Essa ação:

    • Libera a numeração presa/inconsistente

    • Reorganiza a sequência de numeração da classificação

✅ 5️⃣ Orientar o Usuário

  1. Informe ao usuário que:

    • O problema de numeração foi corrigido.

  2. Solicite que ele:

    • Tente cadastrar novamente o documento ou processo

    • Utilizando a mesma classificação

Após esse procedimento, o cadastro deverá ocorrer normalmente, sem exibição da mensagem de erro.

📌 Observações Importantes

🧾 Mensagem Sugerida ao Usuário

“Identificamos uma inconsistência temporária na numeração do sistema, causada por lentidão no momento do cadastro. A numeração já foi corrigida e você pode realizar o cadastro novamente normalmente.”

📌 Informativo: Atendimentos Realizados pelo Suporte do Ente Niterói no e-Ciga

O suporte do ente Niterói é realizado pela SEPLAG (Secretaria de Planejamento), mediante solicitações efetuadas pelo portal oficial: https://e.niteroi.rj.gov.br/.

🛠️ Tipos de Atendimentos Realizados

  1. Gestão de Usuários

    • Ativações e desativações de contas.

    • Alterações de cargos e setores vinculados a usuários.

    • Ajustes de permissões relacionadas ao acesso no sistema.

  2. Movimentação de Processos e Documentos

    • Solicitações de movimentação quando os usuários não possuem mais acesso direto.

    • Apoio em casos de processos/documentos bloqueados ou sem responsáveis ativos.

  3. Classificações Documentais e Processuais

    • Cadastro de novas classificações.

    • Alterações e manutenção das classificações existentes.

  4. Desarquivamento de Documentos e Processos

    • Atendimentos para desarquivar documentos e processos cujos responsáveis originais não estão mais ativos no e-Ciga.

📌 Observação

As demandas devem ser formalizadas exclusivamente via portal e-Niterói, garantindo controle, rastreabilidade e atendimento oficial pela SEPLAG.

Alterar administrador de um grupo

A partir da ferramenta administrativa do e-Ciga, é possível redefinir o administrador de um grupo diretamente pela interface. Isso deve ser feito por usuários com permissão de acesso ao painel de administração.

🌐 1. Acessar o Painel de Administração de Grupos

  1. Acesse a URL: https://admin.eciga.consorciociga.gov.br/

  2. Clique no botão "Gerenciar Grupos".

  3. Selecione o ente desejado na lista apresentada.

👥 2. Localizar o Grupo

  1. Na tela de gerenciamento de grupos, utilize a busca para localizar o grupo que deseja alterar.

  2. Clique sobre o grupo para visualizar seus integrantes.

🔄 3. Redefinir o Administrador do Grupo

  1. Visualize a lista de membros atuais do grupo.

  2. Selecione o novo integrante que assumirá como administrador.

  3. Clique no botão "Redefinir Administrador".

✅ O novo administrador passará a ter permissão para editar o nome do grupo e os membros.

📌 Observações Importantes

Alterar dados do interessado externo (contribuinte, servidor, requerente)

Caso seja necessário alterar o nome ou e-mail de um interessado externo já cadastrado no sistema e-Ciga:

  1. Acesse o Mongo Express.

  2. Localize a base de dados da entidade solicitante.

  3. Acesse a coleção interessados_externos.

  4. Utilize a busca:

    • Campo key: cpfCnpj

    • Campo value: insira o CPF ou CNPJ do interessado (somente números).

    • Clique em Find.

  5. Clique no registro encontrado para editar.

  6. Altere os campos desejados, como nome ou e-mail.

  7. Após realizar as modificações, clique em Save para salvar.

⚠️ Se a alteração for no nome e o interessado já estiver vinculado a um processo, oriente o usuário a:

Alterar setor principal

O setor principal de um usuário define qual setor aparece por padrão em ações como assinatura de documentos, filtros e exibição em listas. A prioridade é determinada pela ordem do campo setores no cadastro do usuário.

🛠️ Etapas para Alterar

  1. Acesse o Mongo Express

  2. Selecione a base de dados da entidade solicitante

    • Exemplo: niteroi, itajai, etc.

  3. Abra a coleção usuarios

  4. Busque o usuário pelo CPF

    • Campo key: login

    • Campo value: digite o CPF somente com números (sem pontos ou traços)

    • Clique em Find

  5. Clique no registro retornado

  6. Altere o campo setores

    • O campo setores é uma lista de ObjectId dos setores vinculados ao usuário.

    • Para tornar um setor o principal, mova o ObjectId correspondente ao setor desejado para a primeira posição da lista.

  7. Verifique o ObjectId correto do setor

    • Vá até a coleção setores

    • Utilize o filtro de busca com o nome do setor desejado para descobrir seu ObjectId

  8. Salve a alteração

    • Clique em Save no canto superior direito da tela do registro do usuário

✅ Resultado

O novo setor principal será exibido como padrão:

Assinante externo assinou mas não mostra como assinado

Se o assinante externo realizou a assinatura, mas o status não é refletido no sistema e-Ciga:

  1. Acesse o Mongo Express.

  2. Localize a base de dados da entidade correspondente.

  3. Acesse a coleção convidados.

  4. Utilize a busca:

    • Campo key: email

    • Campo value: digite o endereço de e-mail do assinante externo.

    • Clique em Find.

  5. Clique no resultado exibido para editar o documento.

  6. Localize e exclua a linha onde consta o campo CPF.

  7. Clique em Save para salvar as alterações.

  8. Peça para o usuário atualizar a tela do sistema (pressionar F5) e verificar se a assinatura aparece corretamente.

Cadastrar um setor no mongo e keycloak

Cadastrar um setor novo para um usuário existente no e-Ciga exige ações tanto no Keycloak (SSO) quanto no Mongo Express (banco de dados). Abaixo está o passo a passo completo.

🔐 1. Acessar o Keycloak (SSO)

  1. Vá até https://sso.ciga.sc.gov.br/.

  2. Acesse a realm correspondente ao ente do usuário.

  3. No menu lateral, clique em Groups.

  4. Expanda a opção Setores.

  5. Clique no botão New.

  6. No campo exibido, digite o nome do novo setor exatamente como deseja que apareça no sistema.

  7. Clique em Save.

🧬 2. Inserir o Setor no MongoDB (Mongo Express)

  1. Acesse https://mongo.eciga.consorciociga.gov.br/.

  2. No menu lateral, selecione a base de dados com o nome da realm do usuário.

  3. Localize a coleção chamada setores.

  4. Clique em New Document.

  5. Insira o seguinte código no campo de texto:

{
    "_id": ObjectId(),
    ente: 'niteroi',
    nome: 'nome do setor'
}

🔸 Importante:

  1. Clique em Save para gravar o setor na base de dados.

👤 3. Vincular o Setor ao Usuário no Keycloak

  1. Volte ao Keycloak e vá até o menu Users.

  2. Localize e clique no nome do usuário desejado.

  3. Vá até a guia Groups.

  4. Localize o setor recém-criado.

  5. Selecione o setor e clique em Join para adicionar o usuário ao grupo.

✅ 4. Finalizar com Impersonação

  1. Ainda na tela do usuário no Keycloak, vá até a guia Impersonate.

  2. Clique no botão do aplicativo e-Ciga 2.0.

  3. Isso forçará a atualização do cache de permissões e garantirá que o novo setor seja persistido corretamente no MongoDB.

📌 Observações Finais

Desativar setor (Niterói)

Desativar um setor impede que ele receba novos documentos ou processos no sistema e-Ciga. Isso deve ser feito diretamente na base de dados do ente por meio do Mongo Express.

🛠️ Etapas para Desativar o Setor

  1. Acesse o Mongo Express

  2. Acesse a base de dados do ente Niterói

    • Certifique-se de estar na base eciga-niteroi.

  3. Entre na coleção setores

  4. Busque o setor pelo nome

    • Campo key: nome

    • Campo value: digite o nome completo do setor (exatamente como cadastrado).

    • Clique em Find.

  5. Clique sobre o registro retornado para editar

  6. Adicione o campo de desativação

    • Inclua o seguinte campo ao JSON do setor:

      json
      "desativado": true

    • Importante: certifique-se de que a linha anterior tenha uma vírgula (,) antes de adicionar este novo campo, para não causar erro de sintaxe.

  7. Clique em Save no canto superior direito da tela para salvar a alteração

✅ Resultado

Após salvar:

Desativar usuário (Niterói)

Desativar um usuário impede que ele acesse o sistema e-Ciga e o retira de visualizações e funcionalidades ativas. O procedimento deve ser feito diretamente pelo Mongo Express.

🛠️ Etapas para Desativar o Usuário

  1. Acesse o Mongo Express

  2. Acesse a base de dados do ente Niterói

    • Certifique-se de estar na base eciga-niteroi.

  3. Entre na coleção usuarios

  4. Busque o usuário pelo CPF

    • Campo key: login

    • Campo value: digite o CPF somente com números (sem pontos ou traços).

    • Clique em Find.

  5. Clique no registro retornado para editar

  6. Inclua o campo de desativação

    • Adicione no final do JSON do registro a seguinte linha:

      json
      "desativado": true

    • Certifique-se de que a linha anterior termine com vírgula (,) para evitar erro de sintaxe.

  7. Clique em Save no canto superior direito para salvar a alteração

✅ Resultado

Após salvar:

Gerar link de assinante externo

Quando um assinante externo não recebe o e-mail automático de solicitação de assinatura, o sistema e-Ciga permite que seja gerado manualmente um link para envio ao assinante. Veja abaixo como proceder:

🌐 1. Acessar o Painel de Geração de Link

  1. Acesse a URL: https://admin.eciga.consorciociga.gov.br/Gerar_link_de_assinante_externo

  2. Faça login com uma conta com permissões administrativas.

📄 2. Informar o email

  1. Digite o e-mail do assinante externo no campo indicado para localizar rapidamente o destinatário

  2. Defina a validade do link escolhendo um período entre 1 hora e 30 dias, de acordo com a urgência e o tempo necessário para o assinante externo realizar a assinatura.

  1. Copie o link gerado e envie ao solicitante pelo canal de comunicação mais adequado (como e-mail ou chat), garantindo que o destinatário tenha acesso rápido e seguro ao documento

📌 Observações Importantes

Relatório de documentos e processos arquivado por um usuário

É possivel que sejam solicitados que listemos documentos e processos arquivados por um determinado usuário.

Utilize o aggregate para gerar relatório destas informações:

Renomear um setor

A renomeação de setores no sistema e-Ciga deve ser feita exclusivamente através do painel administrativo. A seguir, veja como realizar esse procedimento de forma segura:

🌐 1. Acessar o Painel de Renomeação de Setores

  1. Acesse a URL: https://admin.eciga.consorciociga.gov.br/Renomear_setor

  2. Faça login com suas credenciais administrativas (perfil com permissão de gestão de entidades/setores).

🏢 2. Selecionar o Ente

  1. No topo da tela, selecione o ente (órgão público) ao qual o setor pertence.

  2. A lista de setores vinculados ao ente será carregada.

✏️ 3. Localizar e Selecionar o Setor a Ser Renomeado

  1. Na lista de setores, localize o nome atual do setor que deseja renomear.

  2. Clique sobre ele para selecioná-lo.

🆕 4. Informar o Novo Nome do Setor

  1. No campo correspondente, digite o novo nome do setor.

  2. Verifique se a grafia está correta e consistente com o padrão da entidade.

  3. Atenção: O nome do setor será alterado em todas as áreas do sistema onde ele for utilizado.

💾 5. Confirmar a Renomeação

  1. Após preencher o novo nome, clique no botão "Renomear".

  2. Aguarde a confirmação de que a alteração foi realizada com sucesso.

📌 Observações Importantes

Criar um Novo Ente no e-Ciga

Este procedimento deve ser seguido sempre que um novo ente for incorporado ao sistema de processo eletrônico do e-Ciga. Ele envolve duas partes principais:

  1. Configuração da realm no Keycloak (autenticação)

  2. Criação do registro do ente no MongoDB (backend)

🔐 1️⃣ Criar e Configurar a Realm no Keycloak

✔️ 1. Verificar se a Realm já Existe

  1. Acesse: https://sso.ciga.sc.gov.br/

  2. Faça login com um usuário com permissão administrativa.

  3. No menu lateral, clique na lista de Realms.

  4. Verifique se a realm já existe.

    • Se não existir, prossiga com Add realm.

✔️ 2. Criar a Realm

  1. Clique em Add Realm.

  2. No campo Name, informe o nome da realm:

    • Apenas letras minúsculas

    • Sem espaços

    • Sem caracteres especiais

  3. Clique em Create.

A realm está criada — agora vamos configurá-la.

⚙️ 2️⃣ Configurações da Realm

✔️ General

  1. Vá em General.

  2. No campo Display Name, informe o nome do ente como ele é apresentado oficialmente.

  3. Em HTML Display Name, copie o mesmo conteúdo.

  4. Clique em Save.

✔️ Login

  1. Vá para a guia Login.

  2. Habilite:

    • ✔️ Forgot Password

    • ✔️ Login with email

  3. Clique em Save.

✔️ Email

  1. Vá para a guia Email.

  2. Configure:

    • Host: lb2.consorciociga.gov.br

    • From: sso-no-reply@postal.consorciociga.gov.br

    • Enable Authentication: habilitar

    • Username: ciga

    • Password: pegar no Passbolt

      • Se não tiver acesso → solicitar ao Francis, Ricardo Taska ou Leandro

  3. Clique em Save.

✔️ Themes

  1. Vá para a guia Themes.

  2. Habilite:

    • ✔️ Internationalization Enabled

  3. Em Supported Locales, deixe apenas pt-BR.

  4. Em Default Locale, selecione pt-BR.

  5. Clique em Save.

As configurações gerais estão concluídas. Agora vamos criar e configurar os clients.

🧩 3️⃣ Configurar os Clients do Keycloak

Client: eciga2

✔️ Criar o Client

  1. Vá em Clients.

  2. Clique em Create.

  3. Preencha:

    • Client ID: eciga2

    • Client Protocol: openid-connect

  4. Clique em Save.

✔️ Configurar o Client eciga2

Guia: Settings

  1. Name: e-CIGA 2.0

  2. Desabilitar: Direct Access Grants Enabled

  3. Em Valid Redirect URIs, adicionar (substituindo nomedarealm):


https://nomedarealm.eciga.consorciociga.gov.br/* https://ntfy.eciga.consorciociga.gov.br/oauth/callback https://nomedarealm-treinamento-e2-186-250-92-134.beta.ciga.sc.gov.br/*

  1. Base URL:


https://nomedarealm.eciga.consorciociga.gov.br/

  1. Web Origens:


+

  1. Clique em Save.

✔️ Guia: Roles

Criar 3 Roles:

Procedimento:

  1. Clique em Add Role

  2. Informe o nome da role

  3. Clique em Save

  4. Repita para as 3 roles

✔️ Guia: Client Scopes

  1. Em Assigned Default Client Scopes

  2. Selecione web-origens

  3. Clique em Remove selected

✔️ Guia: Mappers

  1. Clique em Create

  2. Name: groups

  3. Mapper Type: Group Membership

  4. Token Claim Name: groups

  5. Clique em Save

✔️ Guia: Scope

  1. Desmarque a opção Full Scope Allowed

  2. Clique em Save

Client eciga2 finalizado.

Client: certificados

✔️ Criar / Importar

O client certificados é criado via importação:

  1. Baixe o arquivo certificados.json

  2. Vá em Clients → Create

  3. Clique em Select file no campo Import

  4. Selecione o arquivo

  5. Clique em Save

Client certificado criado.

🗂️ 4️⃣ Criar Grupos Padrão (Setores e Cargos)

  1. Vá em Groups.

  2. Clique em New.

  3. Crie o grupo:

    • Setores

  4. Clique em Save

  5. Repita o processo para criar:

    • Cargo

Configurações do Keycloak concluídas.

🗄️ 5️⃣ Criar o Ente no MongoDB

  1. Acesse o Mongo Express:
    https://mongo.eciga.consorciociga.gov.br/db/eciga/entes

  2. Clique em New Document

  3. Preencha seguindo este modelo:


{ "_id": "nomedarealm", "mongoUri": "/eciga-nomedarealm", "nome": "Prefeitura Municipal de *****", "issuer": "https://sso.ciga.sc.gov.br/auth/realms/nomedarealm", "origin": "https://nomedarealm.eciga.consorciociga.gov.br", "diarioCodigoEntidade": ** }

  1. Clique em Save

🔎 ⚠️ Informações Importantes

Restaurar um Documento Excluído no e-Ciga

♻️ Como Restaurar um Documento Excluído no e-Ciga

Este procedimento deve ser utilizado quando um documento foi excluído indevidamente e precisa ser restaurado manualmente no sistema.

🔍 1️⃣ Localizar o Documento Excluído

  1. Acesse o Mongo Express.

  2. Entre no banco de dados correspondente à entidade solicitante.

  3. Acesse a coleção:


    documentos_excluidos

  4. Utilize os filtros disponíveis (ex.: _id, número do documento, processo relacionado, etc.) para localizar o documento excluído.

  5. Ao localizar o registro, abra o documento para visualização completa.

📋 2️⃣ Copiar o Conteúdo do Registro

  1. Com o documento aberto na coleção documentos_excluidos, copie todo o conteúdo do registro.

  2. Garanta que o conteúdo seja copiado integralmente, mantendo a estrutura original (JSON).

📁 3️⃣ Recriar o Documento na Coleção Ativa

  1. Ainda no Mongo Express, acesse a coleção:


    documentos

  2. Clique em New Document (ou Adicionar novo documento).

  3. Cole exatamente o conteúdo copiado do registro do documento excluído.

  4. Verifique se o conteúdo foi colado corretamente.

  5. Clique em Save.

➡️ Neste momento, o documento é restaurado para a base ativa do e-Ciga.

🗑️ 4️⃣ Remover o Registro da Coleção documentos_excluidos

  1. Retorne à coleção:


    documentos_excluidos

  2. Localize novamente o registro do documento restaurado.

  3. Exclua o registro de exclusão (Delete).

  4. Confirme a exclusão.

✅ 5️⃣ Finalização

⚠️ Observações Importantes

Restaurar um Processo Excluído no e-Ciga

♻️ Como Restaurar um Processo Excluído no e-Ciga

Este procedimento deve ser utilizado quando um processo foi excluído indevidamente e precisa ser restaurado manualmente no sistema por meio do MongoDB.

🔍 1️⃣ Localizar o Processo Excluído

  1. Acesse o Mongo Express.

  2. Entre no banco de dados correspondente à entidade solicitante.

  3. Acesse a coleção:


    processos_excluidos

  4. Utilize os filtros disponíveis (ex.: _id, número do processo, interessado, setor autuante, etc.) para localizar o processo excluído.

  5. Ao encontrar o registro, abra o documento para visualização completa.

📋 2️⃣ Copiar o Conteúdo do Registro

  1. Com o processo aberto na coleção processos_excluidos, copie todo o conteúdo do registro.

  2. Certifique-se de copiar o JSON completo, mantendo a estrutura original do processo.

📁 3️⃣ Recriar o Processo na Coleção Ativa

  1. No Mongo Express, acesse a coleção:


    processos

  2. Clique em New Document (Adicionar novo documento).

  3. Cole integralmente o conteúdo copiado do registro do processo excluído.

  4. Verifique se todos os campos foram colados corretamente.

  5. Clique em Save.

➡️ Neste momento, o processo é restaurado para a base ativa do e-Ciga.

🗑️ 4️⃣ Remover o Registro da Coleção processos_excluidos

  1. Retorne à coleção:


    processos_excluidos

  2. Localize novamente o registro do processo que foi restaurado.

  3. Exclua o registro de exclusão (Delete).

  4. Confirme a exclusão.

✅ 5️⃣ Finalização e Validação

⚠️ Observações Importantes

Movimentar Documento ou Processo Personificando um Usuário no e-Ciga

🔁 Como Movimentar Documento ou Processo Personificando um Usuário no e-Ciga

Este procedimento deve ser utilizado exclusivamente pelo suporte do Ciga, quando é necessário movimentar um documento ou processo em nome de um usuário, geralmente por falta de acesso, afastamento ou indisponibilidade do responsável original.

🔐 1️⃣ Acessar o Keycloak

  1. Acesse o Keycloak pelo endereço:


    https://sso.ciga.sc.gov.br/

  2. Localize a realm (ente) à qual pertence o documento ou processo.

  3. Acesse a guia Users.

  4. Localize o usuário que possui a carga/posse do documento ou processo.

  5. Clique sobre o nome do usuário para abrir os detalhes.

🧑‍💻 2️⃣ Personificar o Usuário

  1. Na tela do usuário, acesse a guia Impersonate.

  2. Clique em Impersonate para acessar o sistema como se fosse o usuário selecionado.

  3. Uma nova sessão será aberta já autenticada com as permissões do usuário.

⚠️ Atenção: Todas as ações realizadas nesta sessão ficam registradas como se fossem executadas pelo próprio usuário.

📂 3️⃣ Acessar o e-Ciga

  1. Com a sessão de personificação ativa, acesse o e-Ciga normalmente.

  2. Localize o documento ou processo que precisa ser movimentado:

    • Caixa de entrada

    • Documentos não enviados

    • Processos em posse

    • Busca pelo número ou assunto

📤 4️⃣ Realizar a Movimentação

  1. No menu do documento ou processo, clique na opção Enviar.

  2. Informe o destinatário (setor, grupo ou usuário), conforme solicitado.

  3. No campo de observações/mensagem, registre obrigatoriamente o seguinte texto:


Documento/Processo movimentado pela equipe do Ciga, a pedido de [nome do solicitante], através do chat nº [número do chat].

  1. Finalize a movimentação clicando em Enviar.

🔚 5️⃣ Encerrar a Personificação

  1. Após concluir a movimentação:

    • Encerre a sessão do e-Ciga

    • Finalize a personificação no Keycloak

  2. Retorne à sua sessão administrativa normal.

📝 Observações Importantes

Correção de Miniatura de Documento ou Processo Indisponível no e-Ciga

Correção de Miniatura de Documento ou Processo Indisponível no e-Ciga

Quando a miniatura (pré-visualização) de um documento ou processo não é exibida corretamente no e-Ciga, normalmente trata-se de uma inconsistência no campo responsável pela miniatura armazenada no banco de dados. O sistema é capaz de regerar automaticamente essa miniatura após a correção.

🔎 1️⃣ Identificar o Documento ou Processo

  1. No e-Ciga, identifique:

    • Número do documento ou processo

    • Tipo (documento ou processo)

    • Entidade (ente) ao qual pertence

Essas informações serão necessárias para localizar o registro no banco de dados.

🗄️ 2️⃣ Acessar o Mongo Express

  1. Acesse o Mongo Express:


    https://mongo.eciga.consorciociga.gov.br/

  2. Selecione a base de dados correspondente à entidade solicitante.

📄 3️⃣ Localizar o Registro

Para Documento:

  1. Acesse a coleção documentos.

  2. Localize o registro do documento:

    • Pelo número

    • Pelo _id

    • Ou por outros campos identificadores disponíveis

Para Processo:

  1. Acesse a coleção processos.

  2. Localize o registro do processo correspondente.

✏️ 4️⃣ Remover o Campo de Miniatura

  1. Clique no registro para edição.

  2. Localize o campo:


    miniatura

  3. Apague completamente o campo miniatura, incluindo:

    • O nome do campo

    • Seu conteúdo

    • A vírgula correspondente, respeitando a estrutura do documento JSON

  4. Clique em Save para salvar a alteração.

⚠️ Importante:
Não substitua o valor do campo por null ou vazio. O campo deve ser removido do registro.

🔄 5️⃣ Regerar a Miniatura no e-Ciga

  1. Retorne ao e-Ciga.

  2. Acesse novamente o documento ou processo corrigido.

  3. O sistema irá:

    • Detectar a ausência do campo miniatura

    • Gerar automaticamente uma nova miniatura

    • Exibir corretamente a pré-visualização

✅ 6️⃣ Validação Final

  1. Atualize a tela (F5), se necessário.

  2. Verifique se a miniatura:

    • Está visível

    • Corresponde ao conteúdo correto

  3. Caso não seja gerada imediatamente, aguarde alguns instantes e acesse novamente o registro.

📝 Observações Importantes

Reinscrever um e-mail Desinscrito no e-Ciga

📧 Como Reinscrever um E-mail Desinscrito no e-Ciga

Quando um usuário deixa de receber e-mails automáticos do e-Ciga, pode ser que o endereço tenha sido desinscrito manualmente ou automaticamente do envio de notificações.
Nesses casos, é possível reinscrever o e-mail diretamente no Redis.

🛠️ Procedimento para Reinscrição do E-mail

1️⃣ Acessar o Redis

  1. Acesse a URL:
    👉 https://redis.eciga.consorciociga.gov.br/

  2. Faça login com um usuário que possua permissão administrativa.

2️⃣ Navegar até o Caminho Correto

No painel do Redis, navegue seguindo a estrutura:


e2 └── worker └── store └── unsubscribed

Esse local armazena todos os e-mails que foram desinscritos do envio automático de mensagens.

3️⃣ Localizar o E-mail Desinscrito

  1. Utilize a busca do navegador:

    • Pressione F3 (ou Ctrl + F, conforme o navegador).

  2. Digite o endereço de e-mail que deve ser reinscrito.

  3. Aguarde até localizar o e-mail na lista.

4️⃣ Remover o E-mail da Lista de Desinscritos

  1. Dê duplo clique sobre o e-mail encontrado.

  2. Clique na opção Remove Member.

  3. Confirme a ação, se solicitado.

Essa ação remove o e-mail da lista de bloqueio e permite que ele volte a receber comunicações do sistema.

✅ Resultado Esperado

📌 Observações Importantes

🧾 Mensagem Sugerida ao Usuário

“Seu e-mail foi reinscrito para receber notificações do e-Ciga. A partir de agora, novas mensagens do sistema voltarão a ser entregues normalmente.”

Desativar Notificações por E-mail de um Ente no e-Ciga

📭 Como Desativar Notificações por E-mail de um Ente no e-Ciga

Quando é necessário interromper todo o envio de e-mails do e-Ciga para um ente específico (ex.: manutenção, testes, problemas de entrega), a configuração deve ser feita diretamente no MongoDB.

🛠️ Procedimento para Desativação

1️⃣ Acessar o Mongo Express

  1. Acesse a URL:
    👉 https://mongo.eciga.consorciociga.gov.br/db/eciga/entes

  2. Faça login com um usuário que possua permissão administrativa.

2️⃣ Localizar o Ente

  1. Na lista de documentos da coleção entes, localize o ente desejado.

    • Normalmente o ente é identificado pelo campo _id (nome da realm).

  2. Clique sobre o registro correspondente para abrir o conteúdo.

3️⃣ Inserir o Campo de Desativação de Notificações

  1. Dentro do documento do ente, adicione o seguinte campo:


notificacoesDesativadas: true

🔎 Caso o campo já exista, apenas altere o valor para true.

  1. Certifique-se de manter a sintaxe correta, incluindo vírgula quando necessário entre os campos.

4️⃣ Salvar as Alterações

  1. Clique no botão Save para gravar a alteração.

✅ Resultado Esperado

⚠️ Observações Importantes


notificacoesDesativadas: false

🧾 Mensagem Sugerida ao Usuário / Ente

“As notificações por e-mail do e-Ciga foram temporariamente desativadas para este ente. O sistema continua funcionando normalmente, porém sem envio de mensagens automáticas.”

Reconsiderar Documento Desconsiderado no e-Ciga

♻️ Passo a Passo: Reconsiderar Documento Desconsiderado no e-Ciga

A reconsideração de uma peça desconsiderada por engano é uma ação excepcional, realizada diretamente no banco de dados, e somente pode ser solicitada pelo próprio usuário que realizou a desconsideração.

⚠️ Premissas Importantes

🛠️ Procedimento Técnico

1️⃣ Acessar o Mongo Express

  1. Acesse o Mongo Express da entidade solicitante.

  2. Entre na base de dados correspondente ao ente.

  3. Acesse a coleção documentos.

2️⃣ Localizar o Documento

  1. Localize o documento que foi desconsiderado:

    • Preferencialmente pelo _id do documento;

    • Ou por outros campos disponíveis no cadastro.

  2. Clique sobre o registro para abrir o conteúdo completo.

3️⃣ Identificar o Trâmite de Desconsideração

  1. Dentro do documento, localize o array chamado tramites.

  2. Percorra os registros do array até encontrar o trâmite com a seguinte informação:


"__t": "TramiteDesconsideracao"

🔎 Este registro representa exatamente o momento em que o documento foi desconsiderado no processo.

4️⃣ Remover o Trâmite de Desconsideração

  1. Apague completamente o objeto referente ao trâmite de desconsideração:

    • Desde a chave de abertura { até a chave de fechamento }.

  2. Tenha cuidado para:

    • Manter a estrutura correta do array;

    • Ajustar vírgulas entre os objetos restantes, evitando erro de sintaxe.

5️⃣ Salvar a Alteração

  1. Após remover o trâmite, clique em Save para gravar as alterações.

✅ Resultado Esperado

📌 Observações Importantes

🧾 Mensagem Sugerida para Registro do Atendimento

“Documento reconsiderado mediante solicitação do próprio usuário que realizou a desconsideração, com ajuste direto no histórico de trâmites do sistema e-Ciga.”

Dificuldade para Cadastrar um Marcador no e-Ciga

🏷️ Dificuldade para Cadastrar um Marcador no e-Ciga

Alguns usuários entram em contato informando que não conseguem cadastrar um novo marcador, pois, mesmo digitando o nome, o botão de cadastro não é habilitado.
Esse comportamento é esperado pelo sistema e ocorre, na maioria dos casos, por um detalhe no preenchimento do campo.

🔍 Motivo do Problema

O e-Ciga só reconhece o marcador como válido após a confirmação do texto, que é feita pressionando a tecla ENTER no campo de digitação.

Apenas digitar o nome não é suficiente para que o sistema entenda que o marcador foi criado.

✅ Forma Correta de Criar um Marcador

1️⃣ Acessar o Cadastro do Marcador

  1. Acesse o documento ou processo no e-Ciga.

  2. Localize o campo de Marcadores.

2️⃣ Digitar o Nome do Marcador

  1. No campo de marcadores, digite o nome desejado para o novo marcador.

📌 Exemplo:


Urgente

3️⃣ Confirmar o Marcador (Passo Essencial)

  1. Pressione a tecla ENTER no teclado após digitar o nome.

  2. O marcador será convertido automaticamente em um item visível no campo.

⚠️ Atenção:
Se a tecla ENTER não for pressionada, o sistema não habilita o botão de cadastro, pois entende que o marcador ainda não foi confirmado.

4️⃣ Finalizar o Cadastro

  1. Após confirmar o marcador com ENTER, o botão de cadastro/atualização será habilitado.

  2. Conclua a ação normalmente.

🧠 Dica Importante ao Usuário

“Sempre que criar um novo marcador no e-Ciga, digite o nome e pressione ENTER para confirmar. Somente após isso o sistema permitirá salvar.”

📌 Resumo Rápido

🧾 Mensagem Padrão para Atendimento do Suporte

“O cadastro do marcador exige a confirmação com a tecla ENTER após digitar o nome. Após essa ação, o sistema reconhece o marcador e habilita o botão de cadastro.”

Usuário cadastrado que não aparece ativo no sistema 👤⚙️

Situação típica:
Uma pessoa já foi cadastrada no sistema, mas você não consegue vê‑la como usuário ativo para vincular em processo, documento, carga etc.

No e‑CIGA (ou ambiente similar), isso costuma ter duas causas principais:

  1. O usuário não fez o primeiro login.
  2. O usuário está desativado.

Abaixo está o passo a passo para cada caso.

1. Confirmar o problema: usuário cadastrado, mas “invisível” 🔎

Antes de qualquer ação:

  1. Verifique no cadastro de usuários se a pessoa está registrada:
    • Confira nome, e‑mail, CPF/login, perfil etc.
  2. Se o registro existe, mas o usuário:
    • Não aparece nas listas de seleção (ex.: ao atribuir carga, assinante, responsável),
    • Ou aparece como inativo,

então você está diante de um dos dois cenários:

2. Causa 1 – Usuário não fez o 1º login 🚪

Aqui, o usuário foi cadastrado, mas nunca entrou no sistema com suas credenciais.

Como identificar

O que fazer

Você tem duas opções:

Opção A – Aguardar o primeiro login da pessoa

  1. Oriente o usuário:

    • Envie as instruções de acesso (link, usuário, senha ou autenticação GovBR, conforme o caso).
    • Peça para que ele faça o primeiro login no sistema.

  2. Após o primeiro login:

    • O sistema passa a reconhecer o usuário como efetivamente ativo.
    • Ele passa a aparecer nas listas de seleção, conforme as permissões de perfil.

Esta é a opção mais comum quando se quer que o próprio usuário faça tudo com sua credencial.

Opção B – Personificar o usuário (quando permitido)

Se a política do órgão/sistema permitir personificação, você pode:

  1. Acessar o recurso de personificação de usuário.
  2. Escolher o usuário cadastrado que ainda não fez login.
  3. Entrar no sistema “como se fosse ele” pela primeira vez.

Isso serve para:

Depois disso:

Importante:
Use personificação apenas se for política oficial e com registro de auditoria. Não é algo para uso informal.

3. Causa 2 – Usuário está desativado 📴

Aqui, o usuário já existia, provavelmente já acessou o sistema, mas:

Como identificar

Como reativar (via Mongo)

Quando for necessário reativar o usuário:

  1. Acesse o registro do usuário no MongoDB.

  2. Localize o campo que controla a desativação, por exemplo:

    • desativado

  3. Altere o valor desse campo para false (ou equivalente a “não desativado”, conforme a implementação):

    • Antes: desativado: true (usuário desativado)
    • Depois: desativado: false (usuário reativado)

  4. Salve a alteração no banco.

  5. Volte ao sistema e:

    • Atualize a tela de usuários.
    • Verifique se o usuário aparece como ativo.
    • Teste se já aparece nas listas de seleção (carga, assinante, responsável etc.).

4. Fluxo resumido de decisão 🧭

Quando um usuário cadastrado não aparece ativo:

  1. Verificar se é falta de primeiro login

    • Se nunca acessou:
      • ➜ Oriente para fazer o 1º login;
      • ➜ Ou utilize personificação (se permitido) para efetivar o primeiro acesso.

  2. Verificar se está desativado

    • Se o campo desativado estiver como true:
      • ➜ No MongoDB, altere desativado para false;
      • ➜ Confirme que o usuário volta a aparecer como ativo no sistema.

Não aparece a opção de publicar no DOM (Diário Oficial dos Municípios) 📰

Situação típica:
O usuário está com o documento pronto no e‑CIGA, abre o menu do documento (os três pontinhos) e não encontra a opção de publicar no DOM.

Nesses casos, o problema não é do usuário nem do documento:
a integração e‑CIGA × DOM ainda não está ativa para a entidade.

Abaixo, o passo a passo para orientar o usuário e o que o suporte deve fazer.

1. Confirmar que a opção realmente não existe

  1. Abra o documento que deveria ser publicado.
  2. Clique no menu de ações (os três pontinhos ao lado do documento).
  3. Verifique as opções disponíveis:
    • Se você vê itens como Exportar, Enviar, Arquivar, etc.,
    • Mas não aparece nada relacionado a Publicar no DOM / Diário Oficial,

então é quase certo que a integração DOM não está configurada para aquela entidade.

2. O que o usuário deve fazer 🧑‍💻

Quando o usuário relata que não aparece a opção de publicar no DOM:

  1. Explique a causa de forma simples

    • “A publicação no DOM só aparece quando a integração entre o e‑CIGA e o DOM está ativada para a entidade. No momento, essa integração ainda não está configurada.”

  2. Peça para abrir um chamado/contato com o suporte do DOM

    • Oriente o usuário a solicitar:

    “Ativação da integração e‑CIGA × DOM para a minha entidade.”

  3. Informe que será necessário o CNPJ da entidade

    • Deixe claro para o usuário que esse dado será solicitado:
      • “Para ativar a integração, será utilizado o CNPJ da entidade.”

3. O que o suporte do DOM deve fazer 🛠️

Quando o atendimento do DOM recebe essa solicitação, o fluxo é:

  1. Conferir os dados da entidade

    • Verificar o CNPJ informado.
    • Garantir que é a entidade correta (prefeitura, câmara, autarquia etc.).

  2. Incluir a integração no token API nº 5

    A integração com o e‑CIGA é controlada por token de API.
    Para permitir que a entidade publique no DOM:

    • Acessar a configuração de token API nº 5;
    • Incluir a entidade em questão nesse token (permitindo que ela utilize a integração e‑CIGA × DOM).

  3. Salvar as alterações

    • Garantir que a entidade ficou corretamente associada ao token API nº 5.
    • Conferir se não houve erro de digitação no CNPJ ou na identificação da entidade.

  4. Registrar o atendimento

    • Anotar no chamado ou registro de suporte:
      • Data da ativação;
      • Entidade;
      • CNPJ;
      • Técnico que realizou a inclusão no token API nº 5.

4. Após a ativação: orientando o usuário novamente ✔️

Depois que o suporte do DOM ativa a integração:

  1. Peça ao usuário para:

    • Acessar novamente o documento no e‑CIGA;
    • Abrir o menu (três pontinhos);
    • Verificar se agora aparece a opção de Publicar no Diário

  2. Caso o menu ainda não mostre a opção:

    • Solicitar ao usuário que:
      • Atualize a página (F5),
      • Saia e entre novamente no sistema, se necessário.
    • Confirmar, no suporte, se a entidade correta foi mesmo vinculada ao token API nº 5 e se não houve erro de CNPJ.

5. Roteiro rápido de atendimento (para uso em script)

Quando o usuário diz:

“Não aparece a opção de publicar no DOM no menu do documento.”

Responder e agir assim:

  1. Verificar se é um caso de integração não ativa.
  2. Orientar o usuário a solicitar ao suporte do DOM a ativação da integração e‑CIGA × DOM para a entidade.
  3. Informar que será necessário o CNPJ da entidade.
  4. No suporte do DOM:
    • Incluir a entidade no token API nº 5;
    • Confirmar e registrar a alteração.
  5. Avisar o usuário quando a integração estiver ativa, para que ele:
    • Atualize a página;
    • Volte ao documento;
    • Verifique a nova opção de publicação no DOM no menu.

Com esse fluxo, qualquer caso de “não aparece a opção de publicar no DOM” deixa de ser um mistério:
é apenas questão de ativar a integração e‑CIGA × DOM para a entidade correta, via token API nº 5, usando o CNPJ como referência.

Quando o e‑CIGA informa que o CPF “já está cadastrado” 👤🧩

Situação típica:
Um usuário com perfil habilitado para cadastrar outros usuários tenta criar um novo cadastro no e‑CIGA, digita o CPF e o sistema responde:

“Este CPF já está cadastrado.”

Nessa situação, o usuário não consegue seguir com o cadastro, porque esse CPF já existe na base.
Ajustes nesse usuário não são feitos pela área comum, e sim por quem administra usuários via Keycloak.

Aqui está o passo a passo de como tratar esse caso.

1. Entender o que está acontecendo

Quando o e‑CIGA diz que o CPF já está cadastrado:

Isso significa:

2. O que precisamos fazer 🛠️

Quando recebemos a informação de que um CPF “já está cadastrado” e o usuário não aparece corretamente no e‑CIGA, o procedimento é:

2.1. Localizar o usuário pelo CPF

  1. Acessar o Keycloak.
  2. Ir até a seção de usuários.
  3. Buscar pelo CPF informado.

Se o usuário aparecer:

2.2. Conferir se os dados cadastrais estão atualizados

No registro do usuário, verificar:

  1. Nome completo

    • Conferir se está correto.
    • Corrigir nome incompleto ou com erro de digitação.

  2. E‑mail

    • Verificar se é o e‑mail atual da pessoa.
    • Atualizar se estiver errado ou desatualizado.

  3. Role de acesso (perfil/role)

    • Checar se o usuário está com a role de acesso habilitada para o e‑CIGA.
    • Se não estiver:
      • Adicionar a role adequada de acesso ao sistema.

  4. Vínculo de setor e cargo

    • Ver se o usuário tem:
      • Setor vinculado (unidade de lotação);
      • Cargo/função vinculado.

    Se estiver faltando:

    • Vincular o setor correto (ex.: Contabilidade, RH, Protocolo).
    • Vincular o cargo/função (ex.: Analista, Técnico, Gestor).

Esses vínculos são fundamentais para:

3. Ajustes e validações finais

Após corrigir o cadastro:

  1. Salvar as alterações no Keycloak.

  2. Confirmar se o usuário está:

    • Com nome e e‑mail atualizados;
    • Com role de acesso habilitada;
    • Com setor e cargo devidamente vinculados.

  3. Em seguida, o usuário passa a:

    • Acessar normalmente o e‑CIGA com seu CPF/login;
    • Aparecer nas telas de seleção (responsável, carga, assinante etc.), conforme perfil.

4. Fluxo resumido 🧭

Quando o sistema informa “CPF já está cadastrado”:

  1. Entender que não é para criar um novo usuário com esse CPF.
  2. A equipe com acesso ao Keycloak deve:
    • Buscar o usuário pelo CPF;
    • Atualizar:
      • nome,
      • e‑mail,
      • role de acesso,
      • setor,
      • cargo;
    • Salvar e liberar o uso normal no e‑CIGA.

5. Boa prática

Assim, o CPF permanece como chave única confiável para o acesso ao e‑CIGA.

Orientar sobre as pesquisas de documentos e processos no e‑CIGA 🔍

Aqui o foco é só um: como usar corretamente as aspas na pesquisa de documentos e processos no e‑CIGA, de um jeito simples e prático.

1. Ideia central

Pense assim:

2. Pesquisando sem aspas (busca mais ampla)

Quando você digita várias palavras sem aspas:

O sistema faz algo do tipo:

“Vou mostrar tudo que tenha férias ou joão.”
“Vou mostrar tudo que tenha diária ou renato.”

Ele aceita qualquer uma das palavras.
Resultado:

Use sem aspas quando:

3. Pesquisando com aspas (busca mais precisa)

Quando você coloca as palavras entre aspas, uma a uma:

O sistema passa a pensar assim:

“Só vou mostrar o que tiver férias E joão.”
“Só vou mostrar o que tiver diária E renato.”

Ele exige que todas as palavras apareçam.

Resultado:

Use com aspas quando:

4. Exemplos bem práticos

Exemplo 1 – Assunto do documento

Exemplo 2 – Título do processo

5. Regra de bolso para orientar qualquer usuário

Resumindo em uma frase:

Sem aspas → “isso OU aquilo”.
Com aspas → “isso E aquilo junto”.

Esse é o comportamento que o usuário precisa ter em mente ao pesquisar títulos e assuntos no e‑CIGA.

Pesquisas Aggregate