Suporte e-Ciga

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

⚠️ 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.”