Ayuda › Ajustes y registro

Ajustes y registro — Adaptar el programa a su medida

La ventana de Ajustes reúne dos clases de ajuste: los que son solo suyos (tema, disposición de ventanas, atajos) y los que afectan al funcionamiento de la empresa (preferencias de HNR, usuarios, conexiones, datos de la empresa, formularios de impresión). Con el primer grupo experimente sin miedo; en el segundo, cambie solo lo que su trabajo exija. Las cuatro secciones exclusivas del administrador están claramente marcadas más abajo. La ventana de registro, por su parte, es la respuesta a la pregunta "¿qué acaba de pasar?".

0. Cómo se abre y mapa real de las secciones

Cómo se abre: Dock inferior › Ajustes. El usuario normal ve las secciones Apariencia, Ventanas, Cuenta, Preferencias de HNR, Conexiones, Atajos y Sistema. El administrador ve además Usuarios, Estado, Usuarios activos y Formularios de impresión. En la vista móvil se ocultan Ventanas y Atajos, propias del escritorio. No ver una sección de administrador no es una avería, es consecuencia de los permisos.

Secciones desplegables: al abrir Ajustes por primera vez, todos los encabezados principales y los grupos internos de ajustes están cerrados. Pulse el encabezado; también puede llegar a él con Tab y pulsar Enter o Espacio. Puede mantener abiertas varias secciones principales a la vez. Cerrar y volver a abrir una sección conserva el borrador sin guardar; no sustituye a Guardar. Si cierra del todo la ventana de Ajustes y la vuelve a abrir, los encabezados empiezan cerrados otra vez. Preferencias de HNR › Datos de la empresa › Preferencias de producción solo es visible para el administrador del sistema; al usuario sin permiso no se le muestra ni el encabezado de ajustes de empresa ni un resumen de solo lectura.

1. Apariencia y Ventanas

Esto es puramente cuestión de gusto; ninguna elección afecta a los datos. Las tres más útiles:

2. Cuenta — donde vive su contraseña

Aquí es donde cambia su contraseña. Tres reglas:

• No comparta su contraseña con nadie — ni con el administrador si se la pide; un administrador no necesita su contraseña.
• Cierre la sesión al dejar un ordenador compartido; si no, lo que allí se haga quedará registrado a su nombre.
• Si olvida la contraseña, el administrador le da una nueva y no puede leer la antigua — y ese diseño es el correcto.

3. Atajos

Los atajos de teclado se listan y se pueden cambiar. Para quien empieza, solo unos pocos merecen la pena:

4. Preferencias de HNR

No son ajustes de aspecto sino de hábito de trabajo: qué almacén viene por defecto, cómo se abren las listas y cosas así. Con el tiempo, eso que usted cambia "cada vez" configúrelo aquí una sola vez.

5. Las secciones del administrador

Las secciones siguientes solo son visibles para el usuario con permiso de administrador del sistema. Si no las ve, no hay ninguna avería — simplemente no tiene el permiso. Que la sección esté oculta es solo un adorno; la verdadera puerta está en el servidor: una petición sin permiso también se rechaza allí.

6. Registro — "¿qué acaba de pasar?"

La ventana de registro es el diario de operaciones que el programa lleva sobre sí mismo. Se mira aquí cuando una operación no ha salido como esperaba o cuando ha visto un mensaje de error. No es un asiento contable — es un registro técnico.

7. Preguntas frecuentes

He cambiado un ajuste, ¿le ha cambiado también a mi compañero?

Apariencia, ventanas, atajos y preferencias de HNR son solo suyos: no afectan a nadie. Usuarios, conexiones y datos de la empresa afectan a todos. Si duda, mire las dos columnas de la Figura 1.

No veo una sección en absoluto

No tiene el permiso. No es una avería; las secciones de administrador solo son visibles para el administrador. Si de verdad la necesita, pídasela a su administrador del sistema y dígale por qué la necesita — los permisos se conceden con un motivo.

El programa va lento, ¿debo mirar el registro?

Mire primero la sección Supervisión del servidor (o pida a su administrador que lo haga): ahí se ve si el problema está en su equipo o en el servidor. El registro, en cambio, es el sitio para "qué operación ha dado error". Los dos responden a preguntas distintas.

8. Glosario

9. Usuarios › "Plantilla de rol": crear un usuario sin clonar a nadie

La forma antigua de dar permisos a un empleado nuevo era "copie a alguien parecido y luego corrija una a una cien y pico casillas de permiso"; el resultado solía ser que todo el mundo andaba por ahí con permisos de almacenero — un comercial podía abrir órdenes de trabajo y alguien de calidad podía ver el banco. El grupo Plantilla de rol de la sección Usuarios acaba con eso: elija, aplique, guarde.

1. Ajustes › Usuarios › elija el usuario (o cree uno nuevo) › elija el rol en el selector "Plantilla de rol". Debajo del selector se listan la descripción de la plantilla y los módulos que abre.
2. Aplicar (añadir): los bits de la plantilla se suman a los permisos existentes (para combinar dos plantillas). Solo la plantilla: se apagan los bits ajenos a la plantilla; el bit de administrador del sistema se conserva.
3. Corrija casilla a casilla si hace falta (la plantilla es solo un punto de partida); Guardar. Hasta que no pulse Guardar no se escribe nada en el servidor.

Efecto inmediato: en el momento en que pulsa Guardar se refrescan las sesiones abiertas del usuario; no hace falta que salga y vuelva a entrar. Si cambia su contraseña, sus sesiones abiertas caen y entra con la nueva. En la respuesta aparecen los números "refresco de sesión: refrescadas / caídas". La regla: guía de Seguridad, sección 8.

Preferencias de producción: Level 1 y plantillas sectoriales — guía del administrador

10. Pantalla de acceso › ⚙ asistente "Primera instalación / Nueva empresa"

El asistente se abre desde el icono de engranaje de la pantalla de acceso y crea una empresa nueva en siete pasos: idioma y país, base de datos, administrador principal, comprobación y creación, usuarios, nivel de producción y resumen de la instalación. No hace falta ninguna clave de instalación; no se toca ninguna empresa existente y no se sigue adelante si con ese mismo código ya hay una base de datos principal, un EK1 o una definición de empresa.

El paso 2 tiene dos capas: la vista simple y los "Ajustes avanzados"

La vista simple (la predeterminada) hace una sola pregunta: el código de la nueva empresa. El motor de base de datos, la dirección del servidor y la contraseña de administrador no aparecen en pantalla; todo eso viene de la configuración del servidor de aplicaciones. La línea de la cuenta de administrador es de solo lectura y muestra hnr_kurulum · contraseña guardada en el servidor ✓: esa contraseña no se envía nunca al navegador, la pone el servidor en la petición de instalación. Para que esa línea aparezca, el operador debe definir kurulum.basitKimlik=<usuario>:<contraseña> en el archivo server.properties (la contraseña también puede venir de una variable de entorno con ${env:NAME}; para cambiar el motor, kurulum.basitMotor=firebird5). Si no existe esa línea, el asistente se abre directamente en la vista avanzada. Esta cuenta no es un superusuario — solo crea bases de datos de empresa; cambie su contraseña antes de pasar a producción.

El botón "Ajustes avanzados" pregunta dónde va a residir la base de datos mediante una tarjeta con tres opciones; solo se despliegan los campos de la que marque: (1) Base de datos en este ordenador — el software servidor está en la misma máquina en la que corre la aplicación; se muestran el motor, la cuenta de administrador y la línea de servidor de solo lectura. (2) Servidor SQL remoto en la misma red — la base de datos está en otra máquina; se abren los campos de nombre del servidor, dirección, puerto, modo TLS, certificado CA, directorio de datos para Firebird y rol de ejecución. (3) Clúster SQL / servidores de clúster — se listan los perfiles definidos en la configuración del servidor; la opción "Definir un clúster en la nube…" del final abre ese mismo formulario para Neon y CockroachDB Cloud con verify-full ya preseleccionado. Las definiciones nuevas de (2) y (3) solo se pueden elegir con kurulum.uzakSunucuIzin=true; cuando está desactivado las tarjetas se ven pero no se pueden pulsar y se indica el motivo. Junto al nombre técnico de cada campo hay una explicación en lenguaje llano y un globo ? (pase el cursor, tóquelo o enfóquelo con el teclado).

El botón "Importar base de datos (traer los datos de la empresa antigua)" que hay bajo la vista avanzada abre ahora un flujo real: lleva los registros de su antigua base de datos Firebird a una empresa ya instalada (la sección siguiente). El aviso "Empieza en: Level 1…" ya no está en el paso 1, sino justo debajo del título del paso 6 (Nivel de producción), que es donde se hace la elección.

Avanzado › "Base de datos en este ordenador": ya no se pide la contraseña de administrador

Si fue HNR quien instaló el servidor de base de datos (o si el operador escribió una vez las credenciales en el archivo de configuración), no se pide usuario ni contraseña de administrador en ningún motor. Al elegir la tarjeta "Base de datos en este ordenador" en la vista avanzada, en el campo de usuario aparece la cuenta guardada (por ejemplo postgres, sa, SYSTEM, root, SYSDBA), en el de contraseña pone •••••••• y debajo sale la nota "La contraseña de administrador guardada está lista." La contraseña no se envía nunca al navegador: el cliente solo manda la marca "usar la credencial guardada" y es el servidor de aplicaciones quien pone la contraseña en la petición de instalación. Si quiere cambiarla, basta con escribir en uno de los campos — el modo guardado se desactiva y continúa con su propia cuenta; para volver atrás pulse "Usar la credencial guardada".

Cuando elige una ubicación de datos (carpeta) distinta hace falta una cuenta con más privilegios: PostgreSQL crea un tablespace nuevo y eso solo lo puede hacer un superusuario; en Oracle el mismo trabajo exige el privilegio CREATE TABLESPACE. Si esa cuenta también está guardada en el archivo de configuración, el campo de usuario cambia solo a ella (hnr_kurulum → postgres) e indica "Para la carpeta seleccionada se usará la cuenta de administrador de base de datos guardada."; a usted no se le pregunta nada. Si no hay ninguna cuenta privilegiada guardada, aparece un cuadro ámbar con el botón "Introducir la cuenta de administrador de la base de datos", que abre los campos. Ese mismo cuadro se abre por sí solo si el servidor devuelve PG_DIRECTORY_PRIVILEGE_REQUIRED, ORACLE_TABLESPACE_PRIVILEGE_REQUIRED u ORACLE_PRIVILEGE_REQUIRED.

Para el operador: la línea tiene la forma kurulum.yerelKimlik.<motor>=<usuario>:<contraseña> y se escribe en el archivo server.properties; los códigos de motor son firebird5, postgresql, cockroach, mssql, oracle. La contraseña también puede venir de una variable de entorno con ${env:NAME}. La credencial se usa solo para la base de datos de este ordenador: si se elige un servidor remoto o un clúster, el servidor la rechaza con SAVED_CREDENTIAL_TARGET_INVALID, y cuando no hay ninguna guardada devuelve SAVED_CREDENTIAL_UNAVAILABLE (nunca prueba en silencio con una contraseña vacía). No se admiten contraseñas vacías; para un CockroachDB insecure que no pide contraseña, escriba root:root. En Firebird no hace falta ninguna línea extra: se usan los firebird.user/firebird.password existentes. Borrar la línea devuelve el comportamiento anterior — el usuario vuelve a escribir las credenciales a mano.

Avanzado › ⤓ "Importar base de datos": traer los datos de la empresa antigua

Qué hace: lee de su antigua base de datos Firebird las fichas de cuentas y de artículos, las facturas, los albaranes, los pedidos, las ofertas, los comprobantes, los cheques, los vales de almacén, los escandallos y las órdenes de trabajo, los registros de personal y las imágenes/documentos de la base de datos EK1; con cada uno construye un objeto y lo guarda por la propia vía de escritura de la empresa. Qué no hace: NO CREA UNA EMPRESA NUEVA. La empresa de destino debe haberse creado antes con este asistente. La base de datos de origen es de solo lectura: durante toda la importación no cambia ni una sola fila.

Paso 1 — empresa de destino e inicio de sesión del administrador. Escribe el código de la empresa e inicia sesión con el usuario administrador del sistema de esa empresa. La lista de empresas no se muestra a propósito: la propia sesión demuestra tanto que la empresa existe como que usted es administrador en ella. Un usuario que no sea administrador no puede hacer nada en esta pantalla (403). Si el servidor está en modo de solo lectura (HNR_WRITE desactivado), la importación se rechaza.

Paso 2 — base de datos de origen. Hoy el único tipo de origen es FirebirdSQL (los demás aparecen en la lista pero no se pueden elegir). Se piden la dirección del servidor, el puerto (3050 por defecto), la ruta o el alias de la base de datos, el usuario de la base de datos (normalmente SYSDBA) y su contraseña. Si se deja vacía la ruta de la base de datos EK1, se añade _ek1 al final de la ruta principal. El botón "Probar la conexión" conecta con el origen e informa de la versión, del número de tablas y de si se ha encontrado EK1; si no hay EK1, las imágenes y los documentos no se importan, y la pantalla lo dice claramente.

Paso 3 — inventario de tablas. Todas las tablas del origen se listan con una de cuatro decisiones; ninguna se descarta en silencio. Objeto: de la tabla se generan fichas o documentos que se guardan por la propia vía de escritura de la empresa (p. ej. MUSTERI → ficha de cuenta, FATURA + IRSALIYEITEM → factura y sus líneas). Copia: si en el destino existe una tabla con el mismo nombre, se copian fila a fila las columnas comunes. Derivado: no se copia — valores como el saldo de la cuenta (CARIDURUM) y las existencias (STOKDURUM) los vuelve a generar la vía de escritura, y al final de la importación quedan alineados exactamente con el origen. Omitir: tabla de sistema o de registro.

La decisión "omitir" ya solo se aplica a cachés que se pueden regenerar. En la versión anterior se consideraban "tablas de sistema" y no se importaban nunca 53.662 filas: el histórico de tipos de cambio (KUR), el estado de transferencia a Logo (FATURA_LOGO), las definiciones de impresoras (SISTEMDOSYA), los diccionarios de interfaz y de etiquetas de campo (METIN_SOZLUK, ALAN_SOZLUK), los registros de RR. HH. y de producción. Ahora se copian todas. Lo único que de verdad se omite es la caché de vista previa de archivos, y su motivo está escrito en la lista. Las tablas de la base de datos EK1 distintas del contenido de los archivos (p. ej. la pista de accesos) también se trasladan ahora y aparecen en la lista con el prefijo EK1..

Los números de documento se conservan. Los números de facturas, albaranes, pedidos, ofertas, comprobantes, remesas de cheques y vales de almacén del origen se mantienen tal cual en el destino — en un archivo de veinte años, la respuesta a "qué número de factura" no cambia. Al terminar la importación los contadores de numeración se adelantan más allá del valor mayor, de modo que el primer documento emitido después no puede chocar.

Fidelidad al origen — alineaciones automáticas. Una base de datos de veinte años no siempre es coherente consigo misma; la importación no corrige el origen, se parece al origen. Por eso al final se ejecutan cuatro alineaciones: (1) código de cuenta del libro — cuando se renombraba una ficha de cuenta, las versiones antiguas de HNR no actualizaban los encabezados de los comprobantes, así que la línea del libro y el encabezado del documento llevan códigos distintos; en el destino la línea del libro toma el código de la línea del libro del origen, (2) líneas de saldo sobrantes — se borran las líneas de saldo que no existen en el origen y que no tienen ni ficha ni cuenta de caja/banco, (3) líneas de existencias sin ficha — se borran las líneas de existencias nunca vistas en el origen y sin ficha, (4) líneas de consumo de producción — el reparto por lotes del consumo de producción se ajusta a la lista de líneas del origen. Cada alineación es fail-closed: si los totales de los dos lados no coinciden, no se toca nada; su recuento aparece en la línea "Correcciones automáticas" de la pantalla de resultados y en el registro de la importación.

La configuración propia de la empresa PISA los valores por defecto del destino. La instalación de una empresa nueva escribe sus propias filas semilla en tablas como preferencias de producción, reglas de aprobación, turnos, almacenes y cajas. Esas filas chocan con las filas del origen que tienen la misma clave y antes el origen se omitía EN SILENCIO — la empresa importada se abría con el perfil "Level 1" y con las reglas de APQP/subcontratación cerradas. Ahora, en las tablas pequeñas de configuración, gana el origen: la fila del destino se actualiza desde el origen. Hay dos excepciones, dejadas a propósito: las fichas de usuario (para que no pierda la contraseña del administrador creado durante la instalación) y la identidad de instalación de la empresa. Cada clave omitida aparece en la lista "Resultado tabla por tabla" del paso 5.

Protección frente a números de documento desplazados. Cuando se importa por segunda vez a la misma empresa (para completar una importación interrumpida o el resto de una importación selectiva), el número de un documento puede desplazarse. Antes, ese movimiento del libro de la cuenta se daba por "no está en el origen" y se BORRABA, con lo que desaparecía dinero del extracto; como CARIDURUM se escribe desde el origen, el saldo parecía correcto y contradecía al extracto. Ahora se hacen dos cosas: (1) en modo importación el libro de numeración definitiva no hace que un número cuente como "ocupado", de modo que el número se conserva; (2) si aun así se encuentra un grupo desplazado, no se borra — se anota en la conciliación como Desviación y se escribe en el registro. En las líneas de consumo de producción se traslada además el precio desde el origen; el nuevo criterio de valor de línea lo verifica por tipo de documento.

El balance de las facturas (KALAN) y la sección de mantenimiento

Se derivan los saldos de las facturas abiertas. El viejo programa de escritorio nunca llenó una factura quedando El número (FATURA.KALAN), mientras en HNR envejecimiento, los "receptivos excesivos" del cabinete, el flujo de efectivo y las facturas cerradas de Todos los recibos leer este campo. Así que en la fase de reconciliación derivada, los procesos de importación mueven cada cuenta en orden de fecha: pagos, retornos y cheques cercan el El más antiguo La primera cuenta (FIFO) y el balance abierto de la cuenta se escribe en las últimas facturas. Las facturas de ventas y compra siguen la misma regla; las facturas canceladas permanecen cerradas; cuentas cuyo saldo neto está por debajo 1 TL (antiguo residuo de rotación) no recibe una factura abierta. Una cuenta que ya tiene un importe restante en cualquier factura se deja desatado. El fatura.kalanTop La línea de la tabla de reconciliación compara el objetivo con el total la misma regla que se da en la base de datos de fuente. Parte de un balance abierto puede sentarse en un cheque/nota emitido, una nota de débito o un movimiento bancario/caso en lugar de en una factura; esa parte no se muestra en las facturas sino que es visible en la declaración de cuenta.

Sección de mantenimiento (en paso) 2, después de la firma). Reparación de Balances Abiertas aplicable la misma regla en vigor a una empresa que se importó antes. A Previsiones se muestra primero (facciones para cambiar, anterior y siguiente total, cuentas descuidadas, balance abierto fuera de las facturas) y nada se escribe; Aplique reparación escribe sólo el campo de la suma restante, re-checa el valor antiguo en cada línea (una factura modificada por un recibo en el momento no se sobreescribe) y se registra en El trayecto de actividad. La vuelta a la línea no produce cambios. Revisa el diccionario Se añade las líneas faltantes de la interfaz y las traducciones de campos (24 las traducciones manualmente editadas no se tocan y se llevan unos minutos. Cuando se crea una nueva empresa, esta semilla se lleva automáticamente en el fondo una vez que la compañía se abre; si falla la configuración no fallan, se escribe en el log de configuración y puede ser completado con este botón. Si la página se recarga o el servidor se vuelve a iniciar, una La importación sigue en marcha Abierto en paso 4 por sí mismo cuando se inscribe; el resultado de la última importación terminada está disponible a través de Mostrar el resultado de la última importación. El inventario en paso 3 También se incluyen las tablas de EK1 La base de datos con su línea de cuentas.

Opciones de importación. Ejecución en seco: se lee y se cuenta todo pero no se escribe nada — ejecútela primero para ver el inventario y el tiempo estimado. Importar también el archivo de documentos borrados e Importar también los movimientos históricos: las tablas de archivo de la empresa antigua (se importan en la última fase; que se interrumpan no hace que la importación se considere fallida). Importar imágenes y documentos (EK1): los archivos de la base de datos EK1. Continuar aunque el destino tenga datos: por defecto la importación se detiene si la empresa de destino ya tiene registros; esta casilla es su consentimiento. Tamaño de lote: cuántos registros se escriben por transacción (200 por defecto).

Paso 4 — importación y progreso. Se ven la fase (preparación → fichas → documentos → producción → imágenes y documentos → copia general de tablas → archivo → conciliación de derivados → medición de la conciliación), el porcentaje, los contadores de escritos/omitidos/con error y las últimas líneas del registro de la importación. El registro está enmascarado: las contraseñas, los tokens y las credenciales de las cadenas de conexión no se escriben nunca. El botón Detener corta el trabajo en el siguiente punto seguro; el lote a medias se deshace. El trabajo se ejecuta en el servidor: aunque cierre la ventana no se para, y al volver verá el estado de ese mismo trabajo.

Paso 5 — cómo se lee la tabla de conciliación. Cada fila es un elemento medido: Origen es el valor leído en la base de datos antigua, Destino el leído en la empresa nueva y Diferencia la distancia entre ambos. Si el estado es Cuadra, el elemento se ha importado exactamente. Desviación se escribe en rojo y hay que revisarla a mano. Desviación conocida es una diferencia esperada que viene del propio origen (por ejemplo, una cuenta duplicada en el origen, o cheques sin remesa). Los elementos medidos son: saldos de cuentas, existencias (en general y por almacén), número/importe/estado de los cheques, número e importe de comprobantes y facturas, número de escandallos y de órdenes de trabajo, número de archivos de EK1 y cobertura de tablas.

Si la conciliación tiene desviaciones, el trabajo no dice "completado". Cuando un criterio se desvía, el título del resultado dice "Importación terminada — PERO la conciliación muestra una desviación" y los nombres de los criterios desviados se listan en una banda amarilla encima de la tabla. La lista desplegable "Resultado tabla por tabla" muestra, para cada tabla del origen, la decisión, el número de filas de origen, las escritas, las omitidas, las erróneas y el motivo; las tablas con filas erróneas van arriba y en rojo. Mire estas dos listas antes de empezar a usar la empresa importada.

Puede importar el mismo origen una segunda vez. La importación se basa en la identidad: una ficha, un documento, un cheque o un archivo que ya exista en el destino no se vuelve a escribir, se suma al contador de omitidos. Volver a lanzar desde el principio una importación interrumpida es seguro; no se crean duplicados.

En una importación selectiva (con filtro de tablas) no se ejecuta la alineación de derivados. Cuando importa solo determinadas tablas, escribir desde el origen las tablas derivadas como los saldos de cuentas y las existencias se omite — porque una parte de los documentos todavía no se ha importado y una alineación parcial sería engañosa. Esto se anota en la conciliación como Desviación conocida. En cuanto importe también las tablas restantes (una ejecución sin filtro), la alineación funciona con normalidad.

Códigos de error. AKTARIM_OTURUM_GEREKLI no hay sesión o ha caducado · AKTARIM_YONETICI_GEREKLI / AKTARIM_YETKI_YOK el usuario no es administrador del sistema · AKTARIM_YAZMA_KAPALI el servidor está en modo de solo lectura · AKTARIM_HEDEF_UYUSMAZ la empresa elegida no es la de la sesión · KAYNAK_GECERSIZ el formulario de origen está mal formado · KAYNAK_ERISILEMEDI no se pudo conectar con el origen · KAYNAK_KIMLIK se rechazó el usuario/contraseña del origen · KAYNAK_UZAK_YASAK la lista de permitidos de la configuración del servidor bloquea esa dirección · KAYNAK_EK1_YOK no se pudo abrir EK1 (la importación sigue, los archivos se omiten) · HEDEF_DOLU el destino tiene registros, hace falta la casilla de consentimiento · HEDEF_SEMA_EKSIK el destino no tiene la tabla equivalente (se omite) · AKTARIM_SURUYOR ya hay un trabajo en marcha para esta empresa · AKTARIM_IS_BULUNAMADI no existe el registro del trabajo o ha caducado · AKTARIM_IPTAL_EDILDI lo detuvo el usuario · AKTARIM_FAZ_HATASI una fase se detuvo (mire el registro).

Haga una copia de seguridad de la empresa de destino antes de importar. La importación escribe en el destino y nunca toca el origen. Si en el destino sale un resultado que no quería, el camino de vuelta es la copia de seguridad — por eso conviene hacer la primera ejecución en seco, revisar el inventario, después hacer la copia y entonces lanzar la importación real.

Motor de base de datos: Firebird SQL 5 y PostgreSQL 17 — los dos con soporte completo

El motor se elige en el paso 2. Firebird SQL 5: la cuenta SYSDBA y la contraseña que fijó al instalar Firebird; el servidor tiene que ser local. PostgreSQL 17: los datos de la empresa se guardan en hnr_<código de empresa> y los archivos adjuntos en hnr_<código de empresa>_ek1; la cuenta que indique debe ser un superusuario con permiso CREATEDB, y las bases de datos creadas se ceden al rol de ejecución del servidor (postgresql.user). La entrada de documentos, los informes, las fichas de artículos y de cuentas y los adjuntos (subir / listar / descargar / vista previa / anular) se comportan igual en los dos motores.

La línea "Servidor": host:puerto · TLS — de solo lectura

Una vez elegido el motor, debajo de la contraseña de administrador aparece la línea Servidor · <motor>: por ejemplo localhost:5432 · TLS: disable. Esos valores se leen de la configuración del servidor de aplicaciones (server.properties) y no se pueden cambiar desde el asistente: ninguna dirección, puerto o ruta que venga del navegador se transmite al servidor, de modo que no se puede apuntar la identidad de administrador a un destino cualquiera. En la línea de Firebird pone además "se requiere un servidor local". Si va a usar otro servidor de base de datos, diríjase al operador del servidor.

La línea "Idioma de ordenación/mayúsculas": el idioma de la base de datos de la empresa viene del país

Debajo de la línea de Servidor aparece Idioma de ordenación/mayúsculas: el idioma oficial del país normativo que eligió en el paso 1 (p. ej. Türkiye → turco (tr), Suecia → sueco (sv), Indonesia → indonesio (id)); esa misma línea figura también en el resumen de la instalación. Ese idioma fija las reglas de letras de la base de datos de la empresa: las búsquedas por igualdad son independientes del idioma (comparación de raíz sin distinguir mayúsculas ni acentos — "ali" coincide con "ALİ" y "sema" con "ŞEMA" en todos los países), mientras que la ordenación y la conversión entre mayúsculas y minúsculas siguen el idioma oficial del país (en turco el orden de ç/ş/ı y ı↔I, i↔İ; en sueco ä/ö al final del alfabeto). El valor se lee de la tabla país→idioma del servidor, no se puede cambiar en pantalla y queda fijo tras la instalación. En el motor CockroachDB la ordenación por idioma solo se aplica al ORDER BY de consultas simples de una sola tabla; en las consultas complejas puede verse el orden por punto de código.

Base de datos en otro servidor: la selección de "Servidor"

La base de datos de la empresa también puede crearse en un servidor de base de datos que esté en otra máquina, en lugar de en la que ejecuta el servidor de aplicaciones. El servidor de base de datos (Firebird 5, PostgreSQL o CockroachDB) lo instala usted mismo en esa máquina, lo hace accesible por la red y fija su contraseña de administrador; el asistente no instala nada, solo se conecta y crea allí la base de datos de la empresa. Para ello, el archivo server.properties del operador del servidor debe contener la línea kurulum.uzakSunucuIzin=true; si la dirección está fuera de los rangos de red privada (10.x, 172.16-31.x, 192.168.x, 127.x), además tiene que figurar en la línea kurulum.sunucuIzinListesi=host1,host2. Mientras el permiso está desactivado, la línea de Servidor del paso 2 sigue siendo de solo lectura, como antes.

Con el permiso activado, la línea Servidor del paso 2 se convierte en un selector: se listan los servidores definidos en la configuración del servidor (kume.<nombre>.*) y la opción "Este servidor (configurado)", y al final está "Definir otro servidor…". En una definición nueva se piden: el nombre del servidor (como máximo 30 letras/cifras/guiones bajos/guiones y empezando por minúscula; los nombres firebird, postgresql y cockroach están reservados), la dirección y el puerto, para PostgreSQL/CockroachDB el modo TLS y, opcionalmente, un certificado CA (archivo PEM, máximo 16 KB), para Firebird el directorio de datos (el directorio raíz de la máquina remota donde se crea el archivo de la empresa) y, opcionalmente, un usuario y contraseña del rol de ejecución. Si el rol de ejecución ya existe en ese servidor se verifica su contraseña; si no, el rol de instalación lo crea él mismo y genera su contraseña. Al terminar la instalación, la definición del servidor y la línea de la empresa (firma.<empresa>=kume:<nombre>) se escriben en el archivo server.properties, donde se guardan también la contraseña y el certificado; no hace falta reiniciar la aplicación.

Códigos de error que puede devolver la comprobación previa

Varias instalaciones de empresa a la vez, y el registro de instalación

Distintos códigos de empresa se pueden instalar a la vez; las empresas que van a servidores de base de datos distintos ya no se esperan entre sí. El bloqueo depende del código de empresa: una segunda instalación con el mismo código se rechaza con SETUP_IN_PROGRESS (el código de empresa es único en todo el servidor). Por defecto pueden ejecutarse 3 instalaciones a la vez. Cuando la ventana de instalación falla, debajo de la línea del error aparece el desplegable "Registro de instalación (últimas líneas)": esas líneas son la salida de diagnóstico del propio servidor de base de datos y del procedimiento de instalación (duración de las fases, avisos del motor, mensajes de error de la base de datos). Las contraseñas y los datos de conexión no se muestran ahí; puede enviar el contenido tal cual al operador del servidor.

Si PostgreSQL no está en este ordenador: HNR lo instala

Si en el paso de la base de datos no se encuentra PostgreSQL, el asistente muestra el botón "Instalar PostgreSQL". Con un solo clic se ejecuta el instalador integrado: tarda alrededor de un minuto, ocupa unos 200 MB y el servidor instalado acepta conexiones solo desde este ordenador (listen_addresses=localhost, verificación de contraseña scram-sha-256). El progreso se ve en pantalla fase a fase: directorio de datos, archivos de configuración, arranque del servidor, roles de usuario, base de datos plantilla, ajustes del servidor, verificación. Al terminar continúa donde lo dejó; no se le pide ningún nombre de usuario ni contraseña de base de datos.

¿Qué escribe el instalador? El clúster se instala bajo data/pg (directorio de datos data/pg/veri, registro data/pg/pg.log). El modelo de roles es el mismo que el de data/pg-calisma-rolu.sql: rol de ejecución hnr_uygulama (no es superusuario y no puede crear bases de datos), rol de instalación sin superusuario hnr_kurulum (CREATEDB) y una base de datos plantilla hnr_sablon según el idioma de la empresa (con la capa de conversión implícita dentro). Al archivo server.properties solo se le añaden las líneas postgresql.host/port/user/password/sslmode y kurulum.basitKimlik; no se cambia ninguna línea existente y antes de escribir se hace una copia server.properties.bak-…. La contraseña del superusuario (postgres) no se escribe en el archivo de configuración: solo está en el archivo data/pg/HNR-PG-SIRLAR.txt — haga copia de ese archivo y protéjalo de accesos no autorizados.

Límites y resolución de problemas. El instalador solo puede lanzarse desde el ordenador en el que se ejecuta la aplicación (un navegador remoto recibe 403) y, por ahora, funciona solo en Windows. Si los archivos de programa de PostgreSQL no están en el servidor, en lugar del botón aparece el aviso de que el operador debe descomprimir el zip de binarios Windows x64 en la carpeta tools/postgresql — el instalador no descarga nada de internet. Si PostgreSQL ya está configurado, el instalador no hace nada. La instalación define además una tarea que arranca PostgreSQL al encender el ordenador; si esa tarea no se puede definir (por restricciones de permisos) PostgreSQL funciona igualmente, pero en pantalla sale el aviso de que habrá que arrancarlo a mano tras cada reinicio. Solo se puede desinstalar el clúster que instaló el propio HNR; la desinstalación limpia a la vez la tarea, el directorio de datos y las líneas de server.properties, y se borran todos los datos de empresa de ese clúster.

Si se elige Oracle: privilegios de la cuenta de instalación

Privilegios imprescindibles para la instalación. En Oracle la empresa se crea como dos propietarios de esquema (principal + EK1). La cuenta de base de datos que introduzca en el asistente tiene que poseer estos privilegios de sistema: CREATE USER, ALTER USER, GRANT ANY PRIVILEGE. Si en los ajustes avanzados eligió una ubicación de datos propia (su propio tablespace o ruta DBF), hace falta además CREATE TABLESPACE. Si falta alguno, el asistente se detiene sin iniciar la instalación y dice el nombre de los privilegios que faltan (ORACLE_PRIVILEGE_REQUIRED) — nunca deja una empresa a medias.

Privilegios adicionales recomendados. DROP USER (y además DROP TABLESPACE con una ubicación propia) no es imprescindible para instalar, pero si ocurre un error a mitad de la instalación HNR usa ese privilegio para retirar él mismo los propietarios de esquema que quedaron a medias. Sin él la instalación se intenta igualmente; el mensaje de error, con ORACLE_YARIM_KURULUM_KALDIRILAMADI, dice entonces qué propietario de esquema debe borrar usted a mano. Por eso es buena práctica conceder DROP USER solo mientras dura la instalación y retirarlo después.

La cuenta de ejecución es aparte. El asistente crea dos propietarios de esquema por empresa y les concede únicamente CREATE SESSION, CREATE TABLE, CREATE VIEW, CREATE SEQUENCE, CREATE PROCEDURE, CREATE TRIGGER; la cuota se define como QUOTA UNLIMITED sobre el tablespace elegido. Es decir, la cuenta que se usa en el trabajo diario no puede ver otra empresa ni crear usuarios o esquemas.

11. Ajustes › HNR › "Copia de seguridad de la base de datos de la empresa" y restauración desde una copia

Para qué sirve. La tarjeta Copia de seguridad de la base de datos de la empresa de Configuración › HNR guarda las bases principal y EK1 de la empresa actual en una única carpeta de paquete cifrado. El paquete aparece como una carpeta nueva dentro del directorio que elija en el equipo donde se ejecuta el servidor HNR: main.enc, ek1.enc y el indicador de finalización hnr-yedek.json, que se escribe al final. Debe ser administrador del sistema y volver a introducir su contraseña actual de administrador de HNR; esa misma contraseña abre el paquete. No se guardan en él credenciales del servidor ni de la base de datos.

Restauración. La pantalla «Crear una empresa nueva a partir de una copia de HNR», accesible desde el menú ⋮ de la pantalla de inicio de sesión, siempre restaura con un código de empresa NUEVO; nunca sobrescribe una empresa existente. Solicita la contraseña de administrador de HNR utilizada al crear la copia y un administrador de la base de datos de destino: Firebird, SYSDBA; PostgreSQL, un superusuario; CockroachDB, root/admin; SQL Server, sysadmin; Oracle, un administrador con CREATE USER. La empresa solo se publica cuando ambos contenidos se abren y verifican. Si la contraseña es incorrecta o la segunda parte está dañada, no se crea nada en el destino.

Motores compatibles. Firebird, PostgreSQL, un nodo local de CockroachDB instalado por el propio HNR, Microsoft SQL Server y Oracle. Para Firebird/PostgreSQL/CockroachDB se utiliza la herramienta de copia propia del motor. Para SQL Server y Oracle, el paquete es lógico: se leen la definición del esquema y las filas de todas las tablas mediante la conexión de base de datos. Así puede hacerse una copia aunque el servidor esté remoto o dentro de un contenedor, sin acceder a su sistema de archivos. La restauración crea una base de datos/esquema nuevos y un nuevo usuario de ejecución para la empresa nueva. Para un paquete de Oracle debe indicar el nombre del clúster de destino y, si es necesario, el nombre del servicio; por defecto, FREEPDB1.

Lo que debe saber. Las bases principal y EK1 se copian por separado; no existe un único instante atómico común. Elija un intervalo breve sin actividad en la empresa. Solo puede ejecutarse una copia o restauración a la vez. La carpeta de copia está en el sistema de archivos del servidor, no en el del navegador; se rechazan las carpetas enlazadas mediante symlink/junction. Copie el paquete a un lugar seguro: sin él no hay recuperación, y sin la contraseña no puede abrirse.