Ajuda › Configurações e Log

Configurações e Log — Deixar o programa do seu jeito

A janela Configurações mantém dois tipos de ajuste lado a lado: os que são só seus (tema, disposição das janelas, atalhos) e os que afetam o funcionamento da empresa (preferências HNR, usuários, conexões, dados da empresa, formulários de impressão). Brinque à vontade com o primeiro grupo; no segundo, mude apenas o campo de que o seu trabalho precisa. As quatro seções exclusivas do administrador estão claramente marcadas abaixo. Já a janela Log é a resposta para "o que acabou de acontecer".

0. Caminho de abertura e o mapa real das seções

Caminho de abertura: Dock inferior › Configurações. O usuário comum vê as seções Aparência, Janelas, Conta, Preferências HNR, Conexões, Atalhos e Sistema. O administrador vê, além dessas, as seções Usuários, Status, Usuários Ativos e Formulários de Impressão. Na visão móvel, Janelas e Atalhos, próprias do desktop, ficam ocultas. Não ver uma seção de administrador não é defeito, é consequência de permissão.

Seções recolhíveis: Quando Configurações abre pela primeira vez, todos os títulos principais e os grupos internos de ajustes estão fechados. Clique no título; pelo teclado, você pode chegar até ele com Tab e pressionar Enter ou Espaço. Dá para manter várias seções principais abertas ao mesmo tempo. Fechar e reabrir uma seção preserva o rascunho não salvo; isso não substitui a gravação. Se fechar a janela Configurações por completo e abri-la de novo, os títulos começam fechados outra vez. Preferências HNR › Dados da Empresa › Preferências de Produção só aparece para o administrador do sistema; ao usuário sem permissão não são mostrados nem o título de configurações da empresa nem um resumo somente leitura.

1. Aparência e Janelas

Aqui é pura questão de gosto; nenhuma escolha afeta os seus dados. As três mais úteis:

2. Conta — onde fica a sua senha

É aqui que você troca a sua senha. Três regras:

• Não compartilhe a sua senha com ninguém — nem com o administrador, se ele pedir; o administrador não precisa da sua senha.
• Encerre a sessão ao sair de um computador compartilhado; senão, o que for feito ali fica registrado em seu nome.
• Se você esquecer a senha, o administrador emite uma nova, não consegue ler a antiga — e esse é o projeto correto.

3. Atalhos

Os atalhos de teclado são listados e podem ser alterados. Para quem está começando, poucos valem a pena aprender:

4. Preferências HNR

Estes não são ajustes de aparência, mas de hábito de trabalho: qual depósito vem como padrão, como as listas abrem e assim por diante. Com o tempo, aquilo que você percebe estar mudando toda vez, configure aqui de uma vez por todas.

5. As seções do administrador

As seções abaixo só aparecem para o usuário com a permissão de administrador do sistema. Se você não as vê, não há defeito nenhum — você simplesmente não tem a permissão. Esconder a seção é apenas enfeite; a porta de verdade está no servidor: uma requisição sem permissão também é recusada lá.

6. Log — "o que acabou de acontecer?"

A janela Log é o diário de operações que o programa mantém sobre si mesmo. Você olha aqui quando uma operação não sai como esperava ou quando vê uma mensagem de erro. Não é um registro contábil — é um registro técnico.

7. Perguntas frequentes

Mudei um ajuste; mudou também para o meu colega?

Aparência, janelas, atalhos e preferências HNR são só seus: ninguém é afetado. Usuários, conexões e dados da empresa afetam todo mundo. Na dúvida, olhe as duas colunas da Figura 1.

Não consigo ver uma seção de jeito nenhum

Você não tem a permissão. Isto não é defeito; as seções de administrador só aparecem para o administrador. Se realmente precisar de uma, peça ao seu administrador de sistema e diga por que precisa — as permissões são concedidas com uma justificativa.

O programa ficou lento; devo olhar o log?

Olhe primeiro a seção Monitor do servidor (ou peça ao seu administrador que olhe): fica claro se o problema é do seu lado ou do servidor. Já o log é o lugar da pergunta "qual operação deu erro". Os dois respondem perguntas diferentes.

8. Glossário

9. Usuários › "Modelo de papel": criar um usuário sem clonar

O jeito antigo de dar permissões a um novo funcionário era "copie alguém parecido e depois corrija uma a uma as cem e tantas caixas de permissão"; o resultado, na maioria das vezes, era todo mundo circulando com permissão de almoxarife — o vendedor podia abrir ordem de produção, o pessoal da qualidade enxergava o banco. O grupo Modelo de papel na seção Usuários acaba com isso: escolha, aplique, grave.

1. Configurações › Usuários › selecione o usuário (ou crie um novo) › escolha o papel no seletor "Modelo de papel". Abaixo do seletor são listados a descrição do modelo e os módulos que ele libera.
2. Aplicar (adicionar): os bits do modelo são somados por cima das permissões existentes (para combinar dois modelos). Somente o modelo: os bits fora do modelo são desligados; o bit de administrador do sistema é preservado.
3. Se precisar, ajuste as caixas uma a uma (o modelo é só o começo); Gravar. Até você clicar em Gravar, nada é escrito no servidor.

Efeito imediato: no momento em que você clica em Gravar, as sessões abertas do usuário são atualizadas; ele não precisa sair e entrar de novo. Se você trocar a senha dele, as sessões abertas caem e ele entra com a nova senha. Na resposta aparecem os números "oturumYenileme: renovadas / derrubadas". Regra: guia de Segurança, seção 8.

Preferências de Produção: Level 1 e modelos setoriais — guia do administrador

10. Tela de login › ⚙ Assistente "Primeira instalação / Nova empresa"

O assistente abre pelo ícone de engrenagem na tela de login e instala uma nova empresa em sete passos: idioma e país, banco de dados, administrador principal, verificação e criação, usuários, nível de produção, resumo da instalação. Não é preciso chave de instalação; as empresas existentes não são tocadas e o processo não avança se já existir, sob o mesmo código, um banco de dados principal, um EK1 ou uma definição de empresa.

O passo 2 tem duas camadas: a visão Simples e "Configurações avançadas"

A visão simples (padrão) faz uma única pergunta: o código da nova empresa. O motor de banco de dados, o endereço do servidor e a senha do administrador não aparecem na tela; tudo isso vem da configuração do servidor de aplicação. A linha da conta de administrador é somente leitura e mostra hnr_kurulum · senha guardada no servidor ✓: essa senha nunca é enviada ao navegador, quem a coloca na requisição de instalação é o servidor. Para que essa linha apareça, o operador precisa ter definido kurulum.basitKimlik=<usuário>:<senha> no arquivo server.properties (a senha também pode vir de uma variável de ambiente com ${env:NAME}; para mudar o motor, kurulum.basitMotor=firebird5). Sem essa linha, o assistente abre direto na visão avançada. Esta conta não é um superusuário — ela só cria bancos de dados de empresa; troque a senha dela ao entrar em produção.

O botão "Configurações avançadas" pergunta onde o banco de dados vai ficar, com um cartão de três opções; ao marcar uma, apenas os campos dela se abrem: (1) Banco de dados neste computador — o software servidor está na mesma máquina em que a aplicação roda; aparecem o motor, a conta de administrador e a linha somente leitura do servidor. (2) Servidor SQL remoto na mesma rede — o banco está em outra máquina; abrem-se os campos de nome do servidor, endereço, porta, modo TLS, certificado CA, diretório de dados para o Firebird e papel de execução. (3) Cluster SQL / servidores de cluster — são listados os perfis definidos na configuração do servidor; a opção "Definir cluster em nuvem…" no final abre o mesmo formulário para Neon e CockroachDB Cloud já com verify-full preenchido. As novas definições de (2) e (3) só podem ser escolhidas com kurulum.uzakSunucuIzin=true; quando isso está desligado, os cartões aparecem mas não podem ser clicados e a justificativa vem escrita. Ao lado do nome técnico de cada campo há uma explicação em linguagem simples e um balão ? (passe o mouse, toque ou foque pelo teclado).

O botão "Importar banco de dados (trazer dados de uma empresa antiga)", no fim da visão avançada, agora abre um fluxo de verdade: ele leva os registros do seu antigo banco Firebird para uma empresa já instalada (veja a seção abaixo). O aviso "Início: Level 1…" não está mais no passo 1: ele fica logo abaixo do título do passo 6 (Nível de produção), onde a escolha é realmente feita.

Avançado › "Banco de dados neste computador": a senha do administrador já não é pedida

Se o servidor de banco de dados foi instalado pelo HNR (ou se o operador registrou uma vez as credenciais no arquivo de configuração), nenhum motor pede nome de usuário e senha de administrador. Ao selecionar o cartão "Banco de dados neste computador" na visão avançada, o campo de usuário mostra a conta registrada (por exemplo postgres, sa, SYSTEM, root, SYSDBA), o campo de senha mostra •••••••• e abaixo aparece a nota "Senha de administrador registrada pronta.". A senha nunca é enviada ao navegador: o cliente manda apenas a marca "usar a credencial registrada", e quem coloca a senha na requisição de instalação é o próprio servidor de aplicação. Se quiser mudar, basta digitar em um dos campos — o modo registrado cai e você segue com a sua própria conta; para voltar, clique no botão "Usar a credencial registrada".

Quando você escolhe um local de dados (pasta) diferente, é preciso uma conta mais privilegiada: o PostgreSQL cria um novo tablespace e só um superusuário pode fazer isso; no Oracle o mesmo trabalho exige o privilégio CREATE TABLESPACE. Se essa conta também estiver registrada no arquivo de configuração, o campo de usuário muda sozinho para ela (hnr_kurulum → postgres) e aparece "Para a pasta selecionada será usada a conta de administrador de banco de dados registrada."; nada continua sendo perguntado a você. Se não houver conta privilegiada registrada, surge uma caixa âmbar com o botão "Informar a conta de administrador do banco de dados", que abre os campos. A mesma caixa também abre sozinha se o servidor devolver PG_DIRECTORY_PRIVILEGE_REQUIRED, ORACLE_TABLESPACE_PRIVILEGE_REQUIRED ou ORACLE_PRIVILEGE_REQUIRED.

Para o operador: a linha tem o formato kurulum.yerelKimlik.<motor>=<usuário>:<senha> e é escrita no arquivo server.properties; os códigos de motor são firebird5, postgresql, cockroach, mssql, oracle. A senha também pode vir de uma variável de ambiente com ${env:NAME}. A credencial é usada apenas para o banco de dados deste computador: se for escolhido um servidor remoto ou um cluster, o servidor recusa com SAVED_CREDENTIAL_TARGET_INVALID, e quando não há credencial registrada devolve SAVED_CREDENTIAL_UNAVAILABLE (nunca tenta em silêncio com senha vazia). Senha vazia não é aceita; para um CockroachDB insecure, que não pede senha, escreva root:root. No Firebird não é preciso linha extra: usam-se os já existentes firebird.user/firebird.password. Apagar a linha volta ao comportamento antigo — o usuário digita as credenciais de novo.

Avançado › ⤓ "Importar banco de dados": trazer dados de uma empresa antiga

O que ele faz: lê, do seu antigo banco Firebird, as fichas de conta e de estoque, notas fiscais, notas de remessa, pedidos, orçamentos, recibos, cheques, fichas de armazém, listas de materiais e ordens de produção, registros de pessoal e as imagens/documentos do banco EK1; gera um objeto de cada um deles e grava pelo próprio caminho de gravação da empresa. O que ele não faz: NÃO CRIA UMA EMPRESA NOVA. A empresa de destino precisa ter sido instalada antes com este assistente. O banco de origem é somente leitura: nem uma linha dele muda durante a importação.

Passo 1 — empresa de destino e entrada do administrador. Você digita o código da empresa e entra com o usuário administrador do sistema daquela empresa. A lista de empresas não é mostrada de propósito: a própria sessão prova tanto que a empresa existe quanto que você é administrador nela. Um usuário que não seja administrador não faz nada nesta tela (403). Se o servidor estiver em modo somente leitura (HNR_WRITE desligado), a importação é recusada.

Passo 2 — banco de dados de origem. Hoje o tipo de origem é apenas FirebirdSQL (os outros aparecem na lista mas não podem ser escolhidos). São pedidos o endereço do servidor, a porta (3050 por padrão), o caminho ou apelido do banco, o usuário do banco (em geral SYSDBA) e a sua senha. Se o caminho do banco EK1 ficar vazio, acrescenta-se _ek1 ao fim do caminho principal. O botão "Testar a conexão" conecta à origem e informa a versão, o número de tabelas e se o EK1 foi encontrado; se não houver EK1, imagens e documentos não são importados, e isso é dito claramente nesta tela.

Passo 3 — inventário de tabelas. Todas as tabelas da origem são listadas com uma de quatro decisões; nenhuma cai em silêncio. Objeto: da tabela são geradas fichas/documentos, gravados pelo próprio caminho de gravação da empresa (ex.: MUSTERI → ficha de conta, FATURA + IRSALIYEITEM → nota fiscal e seus itens). Cópia: se o destino tem uma tabela de mesmo nome, as colunas comuns são copiadas linha a linha. Derivada: não é copiada — valores como o saldo da conta (CARIDURUM) e o disponível em estoque (STOKDURUM) são refeitos pelo caminho de gravação; no fim da importação eles ficam alinhados exatamente com a origem. Pular: tabela de sistema ou de log.

A decisão "pular" agora vale apenas para caches que podem ser regerados. Na versão anterior, 53.662 linhas — histórico de câmbio (KUR), situação de transferência Logo (FATURA_LOGO), definições de impressora (SISTEMDOSYA), dicionários de interface e de rótulos de campo (METIN_SOZLUK, ALAN_SOZLUK), logs de RH e de produção — eram consideradas "tabelas de sistema" e não eram importadas; agora todas são copiadas. A única coisa realmente pulada é o cache de pré-visualização de arquivos, e o motivo está escrito na lista. As tabelas do banco EK1 que não são conteúdo de arquivo (por exemplo, a trilha de acesso) também passam a ser levadas e aparecem na lista com o prefixo EK1..

Os números dos documentos são preservados. Os números de nota fiscal, nota de remessa, pedido, orçamento, recibo, borderô de cheques e ficha de armazém da origem ficam exatamente iguais no destino — num arquivo de 20 anos, a resposta para "qual nota fiscal de número tal" não muda. No fim da importação, os contadores de numeração avançam além do maior valor, para que o primeiro documento emitido depois não colida.

Fidelidade à origem — alinhamentos automáticos. Um banco de dados de vinte anos nem sempre é coerente consigo mesmo; a importação não corrige a origem, ela se parece com a origem. Por isso, no fim da importação, rodam quatro alinhamentos: (1) código do livro da conta — quando uma ficha de conta era renomeada, as versões antigas do HNR não atualizavam os cabeçalhos dos recibos, e a linha do livro e o cabeçalho do documento ficavam com códigos diferentes; no destino, a linha do livro toma o código da linha de livro da origem, (2) linha de saldo residual — as linhas de saldo que não existem na origem e não têm nem ficha nem conta de caixa/banco são apagadas, (3) linha de estoque sem ficha — as linhas de situação de estoque nunca vistas na origem e sem ficha são apagadas, (4) linha de consumo de produção — a divisão por lote do consumo de produção é trazida à lista de linhas da origem. Todo alinhamento é fail-closed: se os totais dos dois lados não forem iguais, nada é tocado; a quantidade aparece na linha "Correções automáticas" da tela de resultado e no log da importação.

A configuração da própria empresa SOBRESCREVE os padrões do destino. A instalação de uma empresa nova grava suas próprias linhas-semente em tabelas como preferências de produção, regras de aprovação, turnos, depósito e caixa. Essas linhas colidem com as linhas de mesma chave da origem, e antes a origem era pulada EM SILÊNCIO — a empresa importada abria com o perfil "Level 1" e com as regras de APQP/terceirização desligadas. Agora, nas pequenas tabelas de configuração, a origem vence: a linha do destino é atualizada a partir da origem. Há duas exceções, deixadas de propósito: as fichas de usuário (para você não perder a senha do administrador criada na instalação) e a identidade de instalação da empresa. Toda chave pulada aparece na lista "Resultado tabela a tabela" do passo 5.

Proteção do número de documento deslocado. Quando se importa uma segunda vez para a mesma empresa (concluir uma execução interrompida, o restante de uma importação seletiva), o número de um documento pode deslocar. Antes, aquele lançamento no livro da conta era tido como "não existe na origem" e APAGADO, tirando dinheiro do extrato; como CARIDURUM é gravado a partir da origem, o saldo parecia certo e contradizia o extrato. Agora duas coisas acontecem: (1) no modo de importação, o livro de numeração definitiva não faz o número contar como "ocupado", ou seja, o número é preservado; (2) mesmo assim, se um grupo deslocado for encontrado, ele não é apagado — é registrado na conciliação como Desvio e escrito no log. Nas linhas de consumo de produção, o preço também passa a ser trazido da origem; o novo critério de valor do item verifica isso por tipo de documento.

Avaliação de contas (KALAN) e a seção de manutenção

Os balanços de fatura aberta são derivados. O antigo programa de desktop nunca preenchia uma fatura permanecer quantidade (FATURA.KALAN), Enquanto em HNR envelhecimento, os “recipitáveis excessivos” do coquete, o fluxo de caixa e as contas fechadas Todos os registros leram este campo. Assim, na fase de reconciliação derivada, os processos de importação movem cada conta em ordem data: pagamentos, retornos e cheques fecham o mais velho A primeira conta (FIFO) e o balanço aberto da conta é escrito para as últimas contas. As faturas de vendas e compra seguem a mesma regra; as faturas canceladas permanecem fechadas; contas cujo saldo líquido está abaixo 1 TL (antigo resíduo de rodas) não receberá uma fatura aberta. Uma conta que já tem um montante restante em qualquer fatura é deixada intacta. O que fatura.kalanTop A linha da tabela de reconciliação compara o objetivo com o total a mesma regra que se dá na base de dados fonte. Parte de um balanço aberto pode estar em um cheque/nota emitido, uma nota de débito ou um movimento bancário/cash em vez de numa fatura; essa parte não é mostrada nas contas mas é visível no relatório da conta.

Secção de Manutenção (em passo) 2, Depois de assinar). Reparação de balanças abertas A mesma regra é aplicável a uma empresa que foi importada anteriormente. A Previsão A primeira (faturas para mudar, total anterior e seguinte, contas perdidas, balanço aberto fora das contas) é mostrada e nada é escrito; Aplique reparação escreve apenas o campo restante-alvo, re-check o valor antigo em cada linha (uma fatura alterada por um recebimento enquanto não é sobreescrito) e é registado em A trajetória da atividade. A reabertura não produz mudanças. Revisando o dicionário Apresentação de linhas de interface e traduções de campo (24 linguagens); traduções editadas manualmente não são tocadas e leva alguns minutos. Quando uma nova empresa é configurada, esta sementeira corre automaticamente no fundo uma vez que a empresa é aberta; se falhar a configuração não falha, ela é escrita no log de configuração e pode ser concluída com este botão. Se a página for re-carregada ou o servidor retomar, um Importes ainda estão em curso Abertura em passo 4 por si mesmo quando você se inscrever; o resultado da última importação acabada está disponível através Mostrar o resultado da última importação. O inventário em passo 3 Também inclui as tabelas do EK1 Base de dados com a sua linha de contas.

Opções de importação. Execução seca: tudo é lido e contado, mas nada é gravado — rode primeiro assim para ver o inventário e a duração estimada. Importar também o arquivo de documentos excluídos e Importar também os movimentos históricos: as tabelas de arquivo da empresa antiga (importadas na última fase; se forem interrompidas, a importação não é considerada falha). Importar imagens e documentos (EK1): os arquivos do banco EK1. Continuar mesmo que o destino já tenha dados: por padrão a importação para quando a empresa de destino já tem registros; esta caixa é o seu consentimento. Tamanho do lote: quantos registros são gravados por transação (200 por padrão).

Passo 4 — importação e progresso. Aparecem a fase (preparação → fichas → documentos → produção → imagens e documentos → cópia geral de tabelas → arquivo → conciliação de derivados → medição da conciliação), o percentual, os contadores de gravados/pulados/com erro e as últimas linhas do log da importação. O log é mascarado: senhas, tokens e credenciais dentro de strings de conexão nunca são escritos. O botão Parar encerra o trabalho no próximo ponto seguro; o lote pela metade é revertido. O trabalho roda no servidor: mesmo que você feche a janela ele não para, e ao voltar você vê a situação do mesmo trabalho.

Passo 5 — como ler a tabela de conciliação. Cada linha é um item medido: Origem é o valor lido do banco antigo, Destino o valor lido da nova empresa, Diferença a diferença entre os dois. Se a situação for Confere, o item veio exatamente igual. Desvio é escrito em vermelho e precisa ser examinado à mão. Desvio conhecido é uma diferença esperada, vinda da própria origem (por exemplo, uma conta duplicada na origem, cheques sem borderô). Os itens medidos são: saldos de contas, disponíveis em estoque (geral e por depósito), quantidade/valor/situação dos cheques, quantidade e valor de recibos e notas fiscais, número de listas de materiais e de ordens de produção, número de arquivos do EK1 e cobertura de tabelas.

Se a conciliação apresentar desvio, o trabalho não diz "concluído". Quando um critério desvia, o título do resultado diz "Importação terminada — MAS há desvio na conciliação" e os nomes dos critérios que desviaram são listados numa faixa amarela acima da tabela. A lista suspensa "Resultado tabela a tabela" mostra, para cada tabela da origem, a decisão, o número de linhas da origem, quantas foram gravadas, puladas, com erro e o motivo; as tabelas com linhas com erro ficam no topo e em vermelho. Olhe estas duas listas antes de começar a usar a empresa importada.

Você pode importar a mesma origem uma segunda vez. A importação é baseada em identidade: uma ficha, documento, cheque ou arquivo que já existe no destino não é gravado de novo, entra no contador de pulados. Recomeçar do zero uma importação interrompida é seguro; não se formam registros duplicados.

Numa importação seletiva (com filtro de tabelas) o alinhamento de derivados não roda. Quando você importa apenas certas tabelas, gravar da origem as tabelas derivadas, como saldo de conta e disponível em estoque, é pulado — porque parte dos documentos ainda não foi importada e um alinhamento parcial enganaria. Isso é registrado na conciliação como Desvio conhecido. Quando você importar também as tabelas restantes (execução sem filtro), o alinhamento roda normalmente.

Códigos de erro. AKTARIM_OTURUM_GEREKLI não há sessão ou ela caiu · AKTARIM_YONETICI_GEREKLI / AKTARIM_YETKI_YOK o usuário não é administrador do sistema · AKTARIM_YAZMA_KAPALI o servidor está em modo somente leitura · AKTARIM_HEDEF_UYUSMAZ a empresa escolhida não é a empresa da sessão · KAYNAK_GECERSIZ o formato do formulário de origem está errado · KAYNAK_ERISILEMEDI não foi possível conectar à origem · KAYNAK_KIMLIK o usuário/senha da origem foi recusado · KAYNAK_UZAK_YASAK a lista de permissões na configuração do servidor bloqueia esse endereço · KAYNAK_EK1_YOK não foi possível abrir o EK1 (a importação continua, os arquivos são pulados) · HEDEF_DOLU o destino tem registros, a caixa de consentimento é necessária · HEDEF_SEMA_EKSIK o destino não tem a tabela correspondente (ela é pulada) · AKTARIM_SURUYOR já há um trabalho nesta empresa · AKTARIM_IS_BULUNAMADI não há registro do trabalho ou ele expirou · AKTARIM_IPTAL_EDILDI o usuário parou · AKTARIM_FAZ_HATASI uma fase parou (veja o log).

Faça backup da empresa de destino antes de importar. A importação grava no destino; não toca na origem. Se o resultado no destino não for o que você queria, o caminho de volta é o backup — por isso recomenda-se fazer a primeira execução como execução seca, revisar o inventário, depois tirar o backup e iniciar a importação de verdade.

Motor de banco de dados: Firebird SQL 5 e PostgreSQL 17 — os dois com suporte total

Você escolhe o motor no passo 2. Firebird SQL 5: a conta SYSDBA e a senha definida na instalação do Firebird; o servidor precisa ser local. PostgreSQL 17: os dados da empresa ficam no banco hnr_<código da empresa> e os anexos de arquivo em hnr_<código da empresa>_ek1; a conta informada precisa ser um superusuário com privilégio CREATEDB, e os bancos criados são transferidos ao papel de execução do servidor (postgresql.user). Lançamento de documentos, relatórios, fichas de estoque/conta e anexos de arquivo (enviar / listar / baixar / pré-visualizar / cancelar) se comportam igual nos dois motores.

A linha "Servidor": host:port · TLS — somente leitura

Depois de escolhido o motor, aparece abaixo da senha do administrador a linha Servidor · <motor>: algo como localhost:5432 · TLS: disable. Esses valores são lidos da configuração do servidor de aplicação (server.properties) e não podem ser alterados pelo assistente: nenhum endereço, porta ou caminho vindo do navegador é repassado ao servidor; assim, a identidade de administrador não pode ser apontada para um destino arbitrário. Na linha do Firebird consta ainda "servidor local obrigatório". Se for usar outro servidor de banco de dados, procure o operador do servidor.

A linha "Idioma de ordenação/maiúsculas": o idioma do banco da empresa vem do país

Abaixo da linha do Servidor aparece Idioma de ordenação/maiúsculas: o idioma oficial do país de legislação escolhido no passo 1 (ex.: Turquia → turco (tr), Suécia → sueco (sv), Indonésia → indonésio (id)); a mesma linha também consta no resumo da instalação. Esse idioma define as regras de letras do banco da empresa: as buscas por igualdade são independentes do idioma (comparação de raiz sem distinção de maiúsculas e de acentos — "ali" combina com "ALİ", "sema" com "ŞEMA" em todos os países), enquanto a ordenação e a conversão entre maiúsculas e minúsculas seguem o idioma oficial do país (em turco, a ordem de ç/ş/ı e ı↔I, i↔İ; em sueco, ä/ö no fim do alfabeto). O valor é lido da tabela país→idioma do servidor, não pode ser alterado na tela e fica fixo depois da instalação. No motor CockroachDB, a ordenação por idioma só é aplicada ao ORDER BY de consultas simples de uma única tabela; em consultas complexas pode aparecer a ordem por ponto de código.

Banco de dados em outro servidor: a escolha do "Servidor"

O banco de dados da empresa também pode ser criado em um servidor de banco de dados que esteja em outra máquina, e não naquela em que roda o servidor de aplicação. Você instala por conta própria o servidor de banco (Firebird 5, PostgreSQL ou CockroachDB) naquela máquina, torna-o acessível pela rede e define a senha do administrador; o assistente não instala nada, apenas conecta e cria ali o banco da empresa. Para isso, o arquivo server.properties do operador do servidor precisa ter a linha kurulum.uzakSunucuIzin=true; se o endereço estiver fora das faixas de rede privada (10.x, 172.16-31.x, 192.168.x, 127.x), ele precisa constar ainda na linha kurulum.sunucuIzinListesi=host1,host2. Com a permissão desligada, a linha Servidor do passo 2 continua somente leitura como antes.

Com a permissão ligada, a linha Servidor do passo 2 vira um seletor: são listados os servidores definidos na configuração do servidor (kume.<ad>.*) e a opção "Este servidor (configurado)", e no final fica "Definir outro servidor…". Na nova definição são pedidos: nome do servidor (no máximo 30 letras/números/sublinhados/hífens, começando por letra minúscula; os nomes firebird, postgresql e cockroach são reservados), endereço e porta, para PostgreSQL/CockroachDB um modo TLS e, opcionalmente, um certificado CA (arquivo PEM, no máximo 16 KB), para o Firebird o diretório de dados (o diretório raiz na máquina remota; o arquivo da empresa é criado ali) e, opcionalmente, usuário/senha do papel de execução. Se o papel de execução já existir naquele servidor, a senha dele é verificada; se não existir, o papel de instalação o cria e gera a sua senha. Ao terminar a instalação, a definição do servidor e a linha da empresa (firma.<firma>=kume:<ad>) são escritas no arquivo server.properties; a senha e o certificado também ficam guardados ali, e não é preciso reiniciar a aplicação.

Códigos de erro que a verificação prévia pode devolver

Várias instalações de empresa ao mesmo tempo, e o log da instalação

Códigos de empresa diferentes podem ser instalados ao mesmo tempo; empresas que vão para servidores de banco diferentes já não esperam umas pelas outras. O bloqueio é por código de empresa: uma segunda instalação para o mesmo código é recusada com SETUP_IN_PROGRESS (o código da empresa é único em todo o servidor). Por padrão, no máximo 3 instalações rodam ao mesmo tempo. Quando a janela de instalação informa uma falha, aparece abaixo da linha de erro a caixa expansível "Log da instalação (últimas linhas)": essas linhas são a saída de diagnóstico do próprio servidor de banco e do procedimento de instalação (tempos das fases, avisos do motor, mensagens de erro do banco). Senhas e dados de conexão não são mostrados nesse log; você pode encaminhar o conteúdo como está ao operador do servidor.

Se não há PostgreSQL neste computador: o HNR o instala

Se o PostgreSQL não for encontrado no passo do banco de dados, o assistente mostra o botão "Instalar o PostgreSQL". Um clique roda o instalador embutido: leva cerca de um minuto, ocupa cerca de 200 MB e o servidor instalado aceita conexões somente deste computador (listen_addresses=localhost, verificação de senha scram-sha-256). O progresso aparece na tela fase a fase: diretório de dados, arquivos de configuração, início do servidor, papéis de usuário, banco de modelo, ajustes do servidor, verificação. Ao terminar, você continua de onde parou; nenhum nome de usuário ou senha de banco de dados é pedido.

O que o instalador grava? O cluster é instalado sob data/pg (diretório de dados data/pg/veri, log data/pg/pg.log). O modelo de papéis é o mesmo de data/pg-calisma-rolu.sql: papel de execução hnr_uygulama (não é superusuário, não cria bancos), papel de instalação sem superusuário hnr_kurulum (CREATEDB) e o banco de modelo hnr_sablon conforme o idioma da empresa (com a camada de conversão implícita dentro). No arquivo server.properties são acrescentadas apenas as linhas postgresql.host/port/user/password/sslmode e kurulum.basitKimlik; nenhuma linha existente é alterada e, antes de gravar, é feito o backup server.properties.bak-…. A senha do superusuário (postgres) não é escrita no arquivo de configuração: ela fica apenas no arquivo data/pg/HNR-PG-SIRLAR.txt — faça backup desse arquivo e mantenha-o fora do alcance de acessos não autorizados.

Limites e solução de problemas. O instalador só pode ser iniciado a partir do computador em que a aplicação roda (um navegador remoto recebe 403) e, por enquanto, funciona somente no Windows. Se os arquivos de programa do PostgreSQL não estiverem no servidor, em vez do botão aparece o aviso de que "o operador precisa extrair o zip de binários Windows x64 na pasta tools/postgresql" — o instalador não baixa nada da internet. Se o PostgreSQL já estiver configurado, o instalador não faz nada. A instalação também registra uma tarefa que inicia o PostgreSQL sozinho quando o computador liga; se a tarefa não puder ser registrada (restrição de permissão), o PostgreSQL ainda funciona, mas aparece na tela o aviso de que "precisa ser iniciado à mão após reiniciar". Só pode ser removido o cluster que o próprio HNR instalou; a remoção limpa junto a tarefa, o diretório de dados e as linhas do server.properties, e todos os dados de empresa daquele cluster são apagados.

Se o Oracle for escolhido: os privilégios da conta de instalação

Privilégios indispensáveis para a instalação. No Oracle, a empresa é criada como dois donos de esquema (principal + EK1). A conta de banco de dados que você digita no assistente precisa obrigatoriamente ter estes privilégios de sistema: CREATE USER, ALTER USER, GRANT ANY PRIVILEGE. Se, nas configurações avançadas, você escolheu um local de dados personalizado (seu próprio caminho de tablespace/DBF), é preciso ainda CREATE TABLESPACE. Se faltar algum, o assistente para antes de iniciar a instalação e diz o nome dos privilégios que faltam (ORACLE_PRIVILEGE_REQUIRED) — ele não deixa uma empresa pela metade.

Privilégios extras recomendados. DROP USER (e, em local personalizado, também DROP TABLESPACE) não é indispensável para a instalação, mas, se algo falhar no meio dela, o HNR usa esse privilégio para remover sozinho os donos de esquema que ficaram pela metade. Sem ele a instalação é tentada assim mesmo; a mensagem de erro então informa, com ORACLE_YARIM_KURULUM_KALDIRILAMADI, qual dono de esquema você precisa apagar à mão. Por isso é boa prática conceder DROP USER só durante a instalação e revogá-lo depois.

A conta de execução é separada. O assistente cria dois donos de esquema por empresa e concede a eles apenas CREATE SESSION, CREATE TABLE, CREATE VIEW, CREATE SEQUENCE, CREATE PROCEDURE, CREATE TRIGGER; a cota é definida como QUOTA UNLIMITED sobre o tablespace escolhido. Ou seja, a conta usada no trabalho diário não consegue ver outra empresa nem criar usuários/esquemas.

11. Configurações › HNR › "Backup do banco de dados da empresa" e restauração a partir do backup

Finalidade. O cartão Backup do banco de dados da empresa em Configurações › HNR grava os bancos principal e EK1 da empresa atual em uma única pasta de pacote criptografado. O pacote aparece como uma nova pasta dentro do diretório escolhido no computador que executa o servidor HNR: main.enc, ek1.enc e o marcador de conclusão hnr-yedek.json, gravado por último. Você deve ser administrador do sistema e informar novamente sua senha atual de administrador do HNR; a mesma senha abre o pacote. Nenhuma credencial do servidor ou do banco é armazenada nele.

Restauração. A tela “Criar uma nova empresa a partir de um backup do HNR”, aberta pelo menu ⋮ da tela de login, sempre restaura com um NOVO código de empresa; uma empresa existente nunca é sobrescrita. São solicitados a senha de administrador do HNR usada ao criar o backup e um administrador do banco de destino: Firebird, SYSDBA; PostgreSQL, um superusuário; CockroachDB, root/admin; SQL Server, sysadmin; Oracle, um administrador com CREATE USER. A empresa só é disponibilizada depois que ambos os conteúdos são abertos e verificados. Com senha incorreta ou segunda parte corrompida, nada é criado no destino.

Motores compatíveis. Firebird, PostgreSQL, um nó local de CockroachDB instalado pelo próprio HNR, Microsoft SQL Server e Oracle. Para Firebird/PostgreSQL/CockroachDB, usa-se a ferramenta de backup do próprio motor. Para SQL Server e Oracle, o pacote é lógico: a definição do esquema e as linhas de todas as tabelas são lidas pela conexão com o banco. Assim, o backup pode ser feito mesmo com o servidor remoto ou em um contêiner, sem acesso ao sistema de arquivos do servidor. A restauração cria um novo banco/esquema e um novo usuário de execução para a nova empresa. Em um pacote Oracle, informe o nome do cluster de destino e, se necessário, o nome do serviço; o padrão é FREEPDB1.

O que você precisa saber. Os bancos principal e EK1 são copiados separadamente; não há um instante atômico único para ambos. Escolha um intervalo curto sem atividade na empresa. Apenas um backup ou restauração pode executar por vez. A pasta fica no sistema de arquivos do servidor, não no navegador; pastas ligadas por symlink/junction são rejeitadas. Copie o pacote para um lugar seguro: sem ele não há recuperação, e sem a senha ele não pode ser aberto.