Los sistemas LVS incorporan un módulo de unidad de estado sólido en el que se almacenan todos los datos de usuario y los ajustes configurables por el usuario.
Se denomina unidad de «datos de usuario» y está separada de la unidad de «sistema» protegida contra escritura, que incluye el sistema operativo, la aplicación LVS y el software de apoyo, así como los ajustes de nivel de fabricación.
Este documento ofrece una visión general de los archivos y carpetas de la unidad de datos de usuario, su finalidad y los procesos internos y externos que actúan sobre ellos.
No incluye información detallada sobre la estructura o el uso de los archivos.
La información de este documento se refiere al diseño actual de LVS en el momento de redactar este documento:

• Software LVS versión v3.0-621
• Sistema operativo Windows 10 IoT Enterprise 2016 o 2021
• Plataforma de hardware Advantech PPC-3100-RE9A.

Archivos y carpetas de datos de usuario

La siguiente tabla enumera las carpetas y archivos presentes en el nivel raíz de la unidad de datos de usuario.
En las secciones siguientes se da información sobre cada una de ellas.
El acceso a archivos compartidos en red sólo se aplica si está activado el uso compartido de archivos en el LVS.

Archivos de registro diario (registros de medición en texto plano)

Esta carpeta contiene archivos de registro de mediciones en texto plano de los últimos 90 días.

• Archivos de texto ASCII delimitados por tabulaciones (archivos de registro).
• Un archivo por día, en el que el nombre del archivo incluye la fecha y el número de serie del LVS.
• Limitado a los últimos 90 días.
• Un registro de varias columnas por línea con una sola fila de encabezamiento por archivo.
• Los archivos de registro sólo se añaden (el recuento de bytes siempre aumenta).
• El nombre del archivo de registro actual (actualizado más recientemente) y el recuento de bytes de este archivo se registran en un archivo llamado «current.dat» en la subcarpeta «Actual».

Consulte el documento de soporte LVS Loadscan LVS – Formatos de archivo de registro para obtener información detallada sobre los formatos de archivo de registro LVS.

Interacciones

• La aplicación LVS escribe en el archivo de registro y actualiza el archivo actual.dat cada vez que se genera un nuevo registro de medida.
  Se genera automáticamente un nuevo archivo de registro si no existe ya un archivo de registro para el día actual.
• El software de informes OverView que se ejecuta en una máquina de la red de área local lee los archivos de registro a través de la API Filesync (HTTP) que se ejecuta en el LVS o a través de un archivo compartido de red.
  OverView supervisa el archivo ‘current.dat’ para detectar cuándo hay nuevos registros.
  Esto evita listados repetidos de archivos.
• Sólo sistemas LVS sin servicios MMQ instalados.
  La utilidad de sincronización de archivos TallySync que se ejecuta en el LVS supervisa los archivos de registro y carga nuevos registros de medición a MyScanner si el LVS está configurado con una cuenta MyScanner y configurado para cargar registros de medición.
  TallySync llama a los scripts PHP expuestos por el servidor web de MyScanner para añadir registros de medidas a las copias en línea de los archivos de registro de texto.
• Los archivos de registro pueden copiarse manualmente mediante el acceso a archivos compartidos en red (si está activado).
  Los usuarios pueden optar por acceder directamente a los archivos de registro y abrirlos en Excel o procesarlos con sus propios sistemas.
• Los archivos de registro se pueden descargar manualmente a una unidad flash USB desde la interfaz del operador LVS.
• La aplicación LVS borra automáticamente los archivos de registro de texto plano después de 90 días.

Dbase (base de datos de vehículos)

Esta carpeta contiene archivos de registro de escaneado de referencia.
Se trata esencialmente de modelos 3D de contenedores vacíos de camiones o remolques.
Esta colección de archivos se denomina «base de datos de vehículos».
Es una base de datos en la medida en que es un conjunto estructurado de objetos de datos informativos y desde la interfaz de usuario de LVS se gestiona como un conjunto de registros de base de datos, pero no tiene asociada ninguna estructura de base de datos relacional/tabular en la implementación actual.

• Subcarpetas para las distintas clases de papeleras (ver tabla más abajo).
• Un archivo de datos binarios comprimido por contenedor.
  Formato LVS propietario.
• El ID de contenedor, el tiempo de escaneado y otros metadatos están incrustados en los nombres de archivo.
  Consulta Formato de nombre de archivo de escaneado de referencia al final de este documento para obtener información más detallada sobre el formato del nombre del archivo de escaneado de referencia.
• Archivo de configuración de los umbrales de estado de carga para informar del estado de carga.
• Archivos temporales utilizados para la sincronización de la base de datos de vehículos entre varios sistemas LVS.

Las subcarpetas de la base de datos de vehículos son

Interacciones

• La aplicación LVS crea, modifica y elimina archivos de registro de escaneado de referencia.
• [Depreciated functionality] Si la Sincronización Multi-Escáner (MSS) está activada para dos o más sistemas LVS en la misma red de área local, los archivos de escaneado de referencia se sincronizan mediante archivos compartidos de red.
  La rutina MSS de un LVS puede crear, modificar y borrar archivos de registro de escaneado de referencia internamente y en otro sistema LVS.
• Si el LVS está configurado para sincronizar la base de datos del vehículo con MyScanner, la rutina MSS del LVS sincroniza los archivos de escaneado de referencia con un «maestro» online perteneciente a la cuenta de usuario de MyScanner.
  Esto se hace mediante llamadas al servicio web FileSync API expuesto por el servidor web de MyScanner.
  Para un único sistema LVS, esto sólo crea una copia de seguridad de la «base de datos de vehículos».
  Para múltiples sistemas LVS, esto consigue el mismo resultado que la Sincronización Multi-Escáner a través de una red de área local.
• Los archivos de registro de escaneado de referencia se pueden exportar a una unidad flash USB mediante la interfaz de operador LVS.
  Los ficheros de escaneado de referencia se exportan como una copia comprimida de toda la carpeta «Dbase».
• Se puede importar un conjunto de archivos de registro de escaneado de referencia previamente exportado desde una unidad flash USB a través de la interfaz de usuario LVS.

Datos (escanear archivos de datos)

Esta carpeta contiene archivos de datos de escaneado en el nivel raíz.
Estos archivos contienen los datos brutos de medición láser lidar capturados durante cada escaneado y otros metadatos asociados.
Estos archivos se utilizan para crear gráficos de perfiles de escaneado en 3D y con fines de diagnóstico.

• Un archivo de datos binarios comprimido por escaneado.
• Número de registro, ID de contenedor, tiempo de escaneado, códigos de error y otros metadatos incrustados en los nombres de archivo.

Dependiendo de la configuración del sistema, también pueden estar presentes las siguientes subcarpetas;

Interacciones

• La aplicación LVS crea archivos de datos de escaneado y archivos de imagen LPR.
• Las subcarpetas y los archivos son creados, procesados y eliminados por varios servicios, dependiendo de la configuración del sistema.
• El software de informes OverView lee los archivos de datos de escaneado a través de la API Filesync (HTTP) o de archivos compartidos en red para generar imágenes 3D para la herramienta incorporada Perfilador de Carga 3D.
• Los archivos de datos de escaneado y los archivos de imagen LPR se pueden exportar a una unidad flash USB mediante la interfaz de operador LVS.
• Los archivos de datos de escaneado se pueden copiar manualmente a través de la red de archivos compartidos (sólo lectura).
  Los archivos de las subcarpetas también se pueden leer a través del uso compartido de archivos, pero nunca debería ser necesario.
• La aplicación LVS borra automáticamente los archivos de datos de escaneado y los archivos de imagen LPR correspondientes después de un tiempo determinado, dependiendo del tipo de escaneado;
  • Las exploraciones de errores que no dan lugar a ninguna medición se borran al cabo de 7 días,
  • Los escaneos que dan lugar a una medición se borran a los 60 días,
  • Los escaneos de referencia vacíos se eliminan al cabo de 3 años.

Listas (archivos de listas de selección)

Esta carpeta contiene archivos de listas de selección de detalles de carga en texto plano.

• Archivos de texto ASCII en formato CSV.
• Un elemento de la lista por línea con campos adicionales (columnas) para funciones especiales según sea necesario.
• Los nombres de archivo de la lista coinciden con los detalles de carga correspondientes configurados en el LVS.

Interacciones

• La aplicación LVS crea, modifica y elimina archivos de lista.
• El software de informes OverView crea, modifica y elimina archivos de listas a través de la API Filesync (HTTP) o de archivos compartidos en red.
• Los archivos de la lista se pueden exportar a una memoria USB a través de la interfaz del operador LVS.
• Los archivos de lista se pueden importar desde una memoria USB a través de la interfaz del operador LVS.
• [Depreciated functionality] Si la Sincronización Multi-Escáner (MSS) está activada para dos o más sistemas LVS en la misma red de área local, los archivos de lista pueden sincronizarse mediante archivos compartidos de red.
  La rutina MSS de un LVS puede crear, modificar y borrar archivos de lista internamente y en otro sistema LVS.
• Si el LVS está configurado para sincronizar listas de detalles de carga con MyScanner, entonces la rutina MSS puede sincronizar archivos de listas con un «maestro» online perteneciente a la cuenta de usuario de MyScanner.
  Esto se hace a través de llamadas al servicio web FileSyncAPI expuesto por el servidor web MyScanner.
  Para un único sistema LVS, esto sólo crea una copia de seguridad de las listas detalladas de carga.
  Para múltiples sistemas LVS esto consigue el mismo resultado que la Sincronización Multi-Escáner a través de una red de área local.
• Los archivos de la lista pueden copiarse, modificarse o eliminarse manualmente mediante el acceso a archivos compartidos en red.
• Sólo sistemas con servicios MMQ instalados: El contenido del archivo de lista se copia en la base de datos PostgreSQL y se carga en MyScanner a través de los servicios MMQ para su uso en la interfaz de usuario de MyScanner.

Registros (registros de medición encriptados)

Esta carpeta contiene archivos de registro de mediciones encriptados.
Son los registros maestros de medición y los registros de auditoría del sistema LVS (exigidos por las autoridades de Pesos y Medidas en los sistemas certificados).

• Los archivos son versiones encriptadas de los archivos de registro en texto plano que se escriben en la carpeta Archivos de Registro Diarios.
  La encriptación es sólo una reordenación básica de bits para evitar la edición manual.
• Los archivos se mueven a la subcarpeta «Archivados» y se convierten en archivos comprimidos al cabo de 60 días.
• Los archivos nunca se borran a menos que se restablezcan los datos del usuario.
• No se puede acceder externamente a los archivos

Interacciones

• La aplicación LVS crea, modifica y archiva ficheros de registro.
• La aplicación LVS lee el historial de mediciones de estos archivos de registro para mostrarlo en la pantalla «Registros» de la interfaz del operador LVS.
  Estos archivos se utilizan en lugar de los archivos de registro de texto plano porque no están limitados a 90 días y es muy poco probable que hayan sido manipulados.
• Los archivos de registro se pueden exportar a una memoria USB a través de la interfaz del operador LVS.
  En este caso se exportan copias en texto plano de los archivos.

InfoTags (archivos de datos de respuesta automática)

Esta carpeta contiene archivos de datos de auto-respuesta para la entrada automatizada de detalles de carga.

• Ficheros de texto ASCII delimitados por tabulaciones.
• Cada línea contiene un nombre de detalle de carga y el texto de auto-respuesta correspondiente.
• El nombre del archivo identifica el vehículo, el operador del vehículo o el grupo de vehículos a los que se aplican los datos de respuesta automática.

Interacciones

• La aplicación LVS crea, modifica y borra archivos de datos de auto-respuesta.
• Si LoadTrak está activado, las consolas LoadTrak remotas crean y modifican archivos de datos de respuesta automática mediante llamadas a scripts PHP expuestos por el servidor web incorporado en el LVS.

Descargas (repositorio de archivos importados)

Esta carpeta se utiliza como repositorio temporal para los archivos copiados al LVS desde fuentes externas.

Interacciones

• La aplicación LVS supervisa esta carpeta en busca de nuevos archivos de tipos reconocidos, como archivos de actualización de software y archivos y procesos de listas, y los elimina si los encuentra.
• Los archivos pueden enviarse a esta carpeta mediante el acceso a archivos compartidos
• Los archivos pueden ser enviados a esta carpeta por el soporte técnico de Loadscan mediante MeshCentral (a través del servicio de agente MeshCentral que se ejecuta en el LVS).
• La aplicación LVS borra automáticamente los archivos de esta carpeta después de 90 días.

TallySync (archivos de registro de TallySync)

Esta carpeta contiene archivos de registro para la aplicación de utilidad de sincronización de archivos TallySync.
Se utiliza para cargar registros de medidas en MyScanner si no están instalados los servicios MMQ.
La aplicación en sí está instalada en la carpeta de aplicaciones LVS en la unidad del sistema.
Pero para evitar escrituras regulares en la unidad del sistema, los archivos de registro generados por Tallysync se almacenan en la unidad de datos del usuario.
Esta carpeta no es accesible externamente.

LoadSync (base de datos SQLite)

Esta carpeta contiene la base de datos de registros de medidas SQLite utilizada por las funcionalidades LoadSyncAPI y LoadSyncSQL integradas en el LVS.

• La base de datos SQLite contiene la misma información de los registros de medición que los archivos de registro de registros de medición, en un formato de base de datos de múltiples tablas.
• La base de datos es un único archivo llamado «records.db».
• Los registros nunca se borran a menos que se restablezcan los datos del usuario.
• Esta carpeta no es accesible externamente.

Interacciones

• La aplicación LVS escribe en la base de datos SQLite cada vez que se genera un nuevo registro de medida.
• Si la base de datos no existe o es ilegible, la aplicación LVS genera una nueva base de datos a partir de los archivos de registro de texto plano de 90 días.
• Los scripts PHP LoadSyncAPI y LoadSyncSQL leen (consultan) registros de la base de datos SQLite.

LoadTrak (archivos de la aplicación web LoadTrak)

Esta carpeta contiene archivos de configuración y temporales utilizados por la aplicación web LoadTrak integrada en el LVS.

• Los archivos se utilizan para el intercambio de datos entre la aplicación LVS y los scripts PHP LoadTrak.
• Esta carpeta no es accesible externamente.

Interacciones

• La aplicación LVS escribe en los archivos de esta carpeta.
• Los scripts PHP de LoadTrak leen los archivos de esta carpeta.

PostgreSQL

Esta carpeta es la carpeta de datos de la base de datos PostgreSQL incorporada, que almacena los registros de mediciones para cargarlos en MyScanner a través de los servicios de cola de mensajes MyScannerMQ (MMQ).

• La base de datos PostgreSQL almacena los registros de las mediciones en un formato de datos enriquecidos que contiene más información que la registrada en los archivos de registro o en la base de datos SQLite.
• Los registros se borran al cabo de 2 años.
• Esta carpeta no es accesible externamente.

Nota: En el momento de redactar este documento, los registros de medición se escriben tanto en bases de datos PostgreSQL como SQLite.
SQLite dejará de utilizarse una vez que la funcionalidad de LoadSync AP y LoadSync SQL se migre a PostgreSQL.

Interacciones

• La aplicación LVS escribe en la base de datos PostgreSQL cada vez que se genera un nuevo registro de medida, o se crea/modifica una lista de selección de detalles de carga.
• Los servicios MMQ (si están activos) leen de la base de datos PostgreSQL y cargan registros y listas de selección de detalles en el servicio web MyScanner.
• Si la base de datos no está presente, la aplicación LVS genera una nueva base de datos a partir de una carpeta de datos de plantilla y scripts SQL.

Registros_del_sistema

Esta carpeta es un repositorio de archivos de registro de depuración/eventos generados por varios componentes de software del sistema.
Cada componente de software que registra en esta carpeta crea una subcarpeta con el nombre correspondiente y gestiona la denominación, rotación y, eliminación de los archivos de registro que genera.
Los registros se utilizan únicamente con fines de desarrollo y soporte.
Nota: en el momento de escribir esto, sólo los servicios relacionados con la cámara instantánea registran en esta carpeta (cuando está activa).

User.ini (configuración del usuario)

Este archivo es el archivo de configuración para los ajustes LVS configurables por el usuario.

• Cifrado mediante una simple reordenación de bits para ofuscar la configuración.
• El archivo desencriptado tiene formato de archivo .INI de texto ASCII estándar.
• Este archivo sólo lo utiliza la aplicación LVS y no es accesible externamente.

Seqnum (contador de números de registro)

Este fichero se utiliza como contador incremental para la generación del número de registro de medida.
Este archivo sólo lo utiliza el software de aplicación LVS y no es accesible externamente.

Archivos de exploración de referencia y sincronización

Los archivos de escaneado de referencia (base de datos de vehículos) y algunos otros archivos de datos de usuario se pueden sincronizar entre varios sistemas LVS mediante las rutinas de Sincronización Multi-Escáner (MSS) basadas en MyScanner o en la red local.
Los archivos de escaneado de referencia no pueden sincronizarse mediante una simple comparación de marcas de tiempo de modificación de archivos y requieren una comparación de archivos más compleja.
Cada registro de escaneado de referencia es un único archivo que contiene los datos binarios del modelo 3D y los detalles del contenedor.
El ID del contenedor, la hora de escaneado y otros detalles están incluidos en los nombres de los archivos de escaneado de referencia para evitar tener que leer un archivo entero para recuperar detalles básicos.
La rutina de sincronización utiliza este formato de nombre de archivo.

Formato del nombre de archivo del escáner de referencia

El nombre de archivo de cada fichero de escaneado de referencia está estructurado para proporcionar todos los detalles principales del vehículo, de modo que se puedan compilar listas completas de detalles de escaneado de referencia a partir de simples listados de archivos sin necesidad de leer el contenido real del archivo, recuperar marcas de tiempo de última modificación o acceder a registros de bases de datos SQL.
La estructura del nombre del archivo es

[ID] . [Scan Timestamp] M [Modification Timestamp] S [Status] . [Tag ID] .
7z

Cada archivo de escaneo de referencia es un archivo comprimido con la extensión .7z.
Algunos ejemplos de nombres de archivo son TRK123 . 3552959772M3552959772S3 .12345678.7z [escaneado inicial, con etiqueta RFID presente] TRK123.3552959772M3552959961S3.12345678.7z [tras modificación de detalles, con etiqueta RFID presente] TRK123.3552959772M3552959961S3.7z [tras la modificación, sin etiqueta RFID] Se considera más apropiada una base de datos relacional para almacenar los detalles informativos de cada perfil de contenedor vacío, junto con blobs de datos binarios o referencias a archivos de datos binarios, y el LVS se migrará a una solución de base de datos como parte del proyecto troncal de API de LVS previsto.
Pero en el momento en que se desarrolló esta estructura de registros, el software del escáner no tenía capacidad para comunicarse con una base de datos relacional.
Además, cualquier cambio en la estructura de archivos existente crearía problemas de retrocompatibilidad.
La estructura de registros tiene la ventaja de que cada archivo contiene toda la información del vehículo/contenedor correspondiente y se pueden hacer copias de seguridad de los registros de escaneado de referencia o trasladarlos de un sistema a otro mediante simples transferencias de archivos, sin los correspondientes requisitos de sincronización de bases de datos relacionales.
Sin embargo, la compleja estructura de nombres de archivo implica que la sincronización entre bases de datos de varios sistemas no es un simple caso de comparación de nombres de archivo y marcas de tiempo de modificación.

Sincronización de la exploración de referencia

El objetivo de la sincronización de escaneados de referencia es garantizar que todos los escáneres de un grupo tengan copias de los archivos de escaneado de referencia más actualizados para todas las ubicaciones.
Cuando existan varios archivos de escaneado de referencia para el mismo ID de vehículo (en el mismo escáner o en escáneres diferentes), el «más actualizado» no significa necesariamente el archivo con la marca de tiempo de modificación más reciente.
Un archivo con una marca de tiempo de escaneado más reciente siempre debe tener prioridad sobre un archivo con una marca de tiempo de escaneado más antigua, aunque el archivo con la marca de tiempo de escaneado más antigua tenga una marca de tiempo de modificación más reciente.
Por tanto, cuando a continuación se haga referencia a archivos de escaneado de referencia «actuales» o «duplicados», se definirán como: Archivo de escaneado de referencia actual: El nombre de archivo con la marca de tiempo de escaneado más reciente o, si las marcas de tiempo de escaneado coinciden, el nombre de archivo con la marca de tiempo de modificación más reciente. Archivo de escaneado de referencia duplicado:
Cualquier archivo de escaneado de referencia para un ID de vehículo concreto, que no sea el archivo de escaneado de referencia actual. La sincronización también debe permitir la eliminación de archivos de escaneado de referencia. Cuando se borra (elimina) manualmente un archivo de escaneado de referencia en un escáner, debe borrarse en todos los demás escáneres sincronizados. Para conseguirlo, la eliminación del escáner de referencia se realiza actualmente cambiando la extensión del archivo de escáner de referencia actual de .7z a .DEL y sincronizando el archivo .DEL del mismo modo que los demás archivos de escáner de referencia. El software del escáner ignora los archivos .DEL y éstos se eliminan al cabo de 6 meses mediante procesos en segundo plano (se supone que la sincronización se ha producido en un plazo de 6 meses). Hay casos en los que pueden existir archivos de escaneado de referencia «duplicados» en la misma carpeta. Estos archivos deben eliminarse regularmente. Los archivos de escaneado de referencia temporales que se encuentran en la subcarpeta Temp se utilizan para las mediciones de 2 Escaneados y, opcionalmente, deben sincronizarse del mismo modo que los archivos de escaneado de referencia estándar. Estos archivos sólo tienen una duración de 6 horas, tras las cuales se eliminan automáticamente. La subcarpeta Temp también puede contener otros archivos temporales que almacenan detalles de carga recogidos en el primer escaneado de dos y que deben registrarse en el segundo escaneado. Estos archivos tienen una extensión .rec y también se borran al cabo de 6 horas. Estos archivos .rec no tienen el mismo formato de datos que los archivos de escaneado de referencia, pero la estructura del nombre del archivo es la misma, de modo que la rutina de sincronización funciona con ellos.