Home

 

Procedimento: String de conexão do K|Painel

1. O que é

O K|Painel lê a conexão Oracle (ou banco configurado) na chave ConnectionStrings:Default do arquivo de configuração da aplicação (appsettings.json / variáveis de ambiente / transformações do ambiente). Se a conexão falha, telas como Links de Acesso podem exibir mensagem de erro no topo e o Admin/operacional não carrega dados.

Este guia descreve o que verificar e como mascarar — não documenta senhas, hosts de produção nem strings completas reais.

2. Pré-requisitos

  1. Acesso ao servidor/host onde a aplicação roda (ou ao repositório de configuração do ambiente).
  2. Contato com o DBA para validar serviço Oracle (SERVICE_NAME), host e usuário.
  3. Janela de manutenção se for reiniciar o app após alteração.
  4. Modelo de referência (sem segredos): arquivo appsettingsModelo.json no projeto.

3. Variantes / cenários

Cenário Sintoma típico
String ausente/vazia Falha imediata ao iniciar ou erro genérico de dados
Senha/usuário inválidos Erro de autenticação no banco
Host/porta/SERVICE_NAME errados Timeout / TNS
Ambiente apontando para base errada Dados “estranhos” ou cliente inexistente
Apenas um nó do cluster desatualizado Intermitência conforme o balanceador

4. Onde configurar (sem segredos)

Caminho operacional: arquivo/variáveis de configuração do ambiente (homologação ou produção), chave ConnectionStrings → Default.
Não use a UI Admin para editar a string de conexão.

4.1 Reconhecer falha na UI

Print 01 — Erro de conexão

Se Links de Acesso ou o Admin falham ao listar dados, suspeite primeiro de conectividade/banco. Ver também kpainel-intro-Acesso.md.

4.2 Estrutura esperada (mascarada)

Print 02 — Modelo mascarado

Estrutura ilustrativa (nunca preencher com produção neste documento):

"ConnectionStrings": {
  "Default": "User Id=(mascarado);Password=(mascarado);Data Source=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=(mascarado))(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=(mascarado))))"
}

Outros campos úteis do modelo (não são a string, mas afetam o ambiente): DbType, FiltroClienteIdLinksDoAmbiente, políticas de senha/e-mail — ajuste só com orientação da implantação.

5. Procedimentos relacionados

Necessidade Doc
Validar Links de Acesso após corrigir kpainel-intro-Acesso.md
Licença vs erro de conexão kpainel-admin-Licenca.md

6. Publicação / validação

  1. Alterar a string apenas no ambiente alvo (preferir homologação).
  2. Reiniciar/reciclar a aplicação conforme o padrão do cliente.
  3. Abrir Links de Acesso e um login Admin de teste.
  4. Confirmar consulta simples (listagem de centros cirúrgicos).

7. Checklist de sustentação

Sintoma Verificar
Erro no topo de Links de Acesso ConnectionStrings:Default; rede até o Oracle; listener
App sobe mas sem dados SERVICE_NAME / schema do usuário
Funciona em um servidor e não em outro Arquivo/variável diferente por nó
Após troca, ainda falha Cache/processo antigo não reiniciado

8. Fluxo resumido

  1. Confirmar sintoma na UI.
  2. Validar com DBA usuário, senha, host, porta, SERVICE_NAME.
  3. Atualizar configuração mascarando segredos em tickets/docs.
  4. Reiniciar app → validar Links de Acesso e Admin.

9. Pontos de atenção

  • Nunca colar senha, string completa de produção ou IP interno sensível neste repositório de documentação.
  • Em prints e tickets, use sempre (mascarado).
  • Não confundir falha de licença com falha de conexão.

 

Telas complementares

Demais prints desta funcionalidade, na ordem das capturas.

01 referencia config