Los sistemas LVS incorporan un módulo de unidad de estado sólido en el que se almacenan todos los datos del usuario y los ajustes configurables por él. A esta unidad se la conoce como la unidad de «datos del usuario» y está separada de la unidad de «sistema», protegida contra escritura, que incluye el sistema operativo, la aplicación LVS, el software de apoyo y los ajustes de fábrica.

El documento ofrece una visión general de los archivos y carpetas que hay en la unidad de datos del usuario, su finalidad y los procesos internos y externos que actúan sobre ellos. No incluye información detallada sobre la estructura de los archivos ni sobre su uso.

La información de este documento se refiere al diseño actual de LVS en el momento de redactar este documento:

• Versión del software LVS 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

En la tabla siguiente se enumeran las carpetas y los archivos que hay en el directorio raíz de la unidad de datos del usuario. En las secciones siguientes encontrarás información sobre cada uno de ellos. El acceso a los recursos compartidos de red solo es válido si el uso compartido de archivos está activado en el LVS.

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

Esta carpeta contiene archivos de registro de mediciones en texto sin formato correspondientes a los últimos 90 días.

• Archivos de texto ASCII delimitados por tabulaciones (archivos de registro).
• Un archivo al día, en el que el nombre del archivo incluya 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».

Consulta el documento de soporte de LVS «Loadscan LVS – Formatos de archivos de registro» para obtener información detallada sobre los formatos de los archivos de registro de LVS.

Interacciones

• La aplicación LVS escribe en el archivo de registro y actualiza el archivo current.dat cada vez que se genera un nuevo registro de medición. Si aún no hay ningún archivo de registro para el día actual, se genera uno nuevo automáticamente.
• El software de generación de informes OverView, que se ejecuta en un equipo de la red de área local, lee los archivos de registro a través de la API de Filesync (HTTP) que se ejecuta en el LVS o mediante un recurso compartido de archivos en red. OverView supervisa el archivo «current.dat» para detectar cuándo hay nuevos registros. Así se evita que se repitan los listados de archivos.
• Solo sistemas LVS en los que no estén instalados los servicios MMQ. La utilidad de sincronización de archivos TallySync, que se ejecuta en los monitores LVS, supervisa los archivos de registro y sube los nuevos registros de medición a MyScanner si el LVS está configurado con una cuenta de MyScanner y configurado para subir registros de medición. TallySync ejecuta scripts PHP expuestos por el servidor web de MyScanner para añadir registros de medición a las copias en línea de los archivos de registro de texto.
• Los archivos de registro se pueden copiar manualmente a través del acceso compartido a archivos en red (si está habilitado). 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 memoria USB desde la interfaz de usuario del LVS.
• La aplicación LVS borra automáticamente los archivos de registro en texto sin formato al cabo de 90 días.

Dbase (base de datos de vehículos)

Esta carpeta contiene archivos de referencia con registros escaneados. Básicamente, son modelos 3D de compartimentos vacíos de camiones o remolques. A este conjunto de archivos se le conoce como la «base de datos de vehículos». Es una base de datos en el sentido de que es un conjunto estructurado de objetos de información y, desde la interfaz de usuario de LVS, se gestiona como un conjunto de registros de base de datos, pero en la implementación actual no tiene asociada ninguna estructura de base de datos relacional o tabular.

• Subcarpetas para las distintas clases de papeleras (ver tabla más abajo).
• Un archivo de datos binarios comprimido por cada contenedor. Formato LVS propio.
• El ID del contenedor, la hora del escaneo y otros metadatos se incluyen en los nombres de los archivos. Consulta Formato de nombre de archivo de escaneo de referencia al final de este documento para obtener información más detallada sobre el formato de los nombres de los archivos de escaneo de referencia.
• Archivo de configuración de los umbrales de estado de carga para informar del estado de carga.
• Archivos temporales que se usan para sincronizar 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 registros de escaneo de referencia.
• [Funcionalidad obsoleta] Si la sincronización entre varios escáneres (MSS) está activada para dos o más sistemas LVS en la misma red de área local, los archivos de referencia de los escaneos se sincronizan a través de recursos compartidos de red. La rutina MSS de un sistema LVS puede crear, modificar y eliminar archivos de registros de referencia de escaneos, tanto internamente como en otro sistema LVS.
• Si el LVS está configurado para sincronizar la base de datos de vehículos con MyScanner, la rutina MSS del LVS sincroniza los archivos de escaneo de referencia con un «maestro» en línea que pertenece a la cuenta de usuario de MyScanner. Esto se hace mediante llamadas al servicio web de la API FileSync que ofrece el servidor web de MyScanner. En el caso de un único sistema LVS, esto simplemente crea una copia de seguridad de la «base de datos de vehículos». En el caso de varios sistemas LVS, se consigue el mismo resultado que con la sincronización de varios escáneres a través de una red de área local.
• Los archivos de registro de escaneos de referencia se pueden exportar a una memoria USB a través de la interfaz de usuario de LVS. Los archivos de escaneos de referencia se exportan como una copia comprimida de toda la carpeta «Dbase».
• Se puede importar un conjunto de archivos de registros de escaneo de referencia que se haya exportado previamente desde una memoria USB a través de la interfaz de usuario de LVS.

Datos (escanear archivos de datos)

Esta carpeta contiene archivos de datos de escaneo en el directorio raíz. Estos archivos contienen los datos brutos de las mediciones láser del lidar capturados durante cada escaneo, así como otros metadatos relacionados. Estos archivos se utilizan para crear gráficos de perfiles de escaneo 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 aparecer las siguientes subcarpetas:

Interacciones

• La aplicación LVS crea archivos de datos de escaneo 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 escaneados y los archivos de imágenes LPR se pueden exportar a una memoria USB a través de la interfaz de usuario de LVS.
• Los archivos de datos escaneados se pueden copiar manualmente a través de un recurso compartido de red (solo lectura). Los archivos de las subcarpetas también se pueden leer a través del recurso compartido, pero en principio no debería ser necesario.
• La aplicación LVS borra automáticamente los archivos de datos escaneados y los archivos de imagen LPR correspondientes tras un tiempo determinado, que depende del tipo de escaneo;
  • 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 texto sin formato con listas de selección de detalles de carga.

• 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 los archivos 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 de usuario de LVS.
• Los archivos de lista se pueden importar desde una memoria USB a través de la interfaz de usuario de LVS.
• [Funcionalidad obsoleta] Si la sincronización entre varios escáneres (MSS) está activada para dos o más sistemas LVS en la misma red de área local, los archivos de lista se pueden sincronizar a través de recursos compartidos de red. La rutina MSS de un sistema LVS puede crear, modificar y eliminar archivos de lista tanto internamente como en otro sistema LVS.
• Si el LVS está configurado para sincronizar las listas detalladas de carga con MyScanner, la rutina MSS puede sincronizar los archivos de listas con un «maestro» en línea que pertenezca a la cuenta de usuario de MyScanner. Esto se hace mediante llamadas al servicio web FileSyncAPI que ofrece el servidor web de MyScanner. En el caso de un único sistema LVS, esto simplemente crea una copia de seguridad de las listas detalladas de carga. En el caso de varios sistemas LVS, se consigue el mismo resultado que con la sincronización Multi-Scanner 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 cifrados. Se trata de los registros maestros de mediciones 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 cifradas de los archivos de registro de texto sin formato que se guardan en la carpeta «Daily Log Files». El cifrado consiste simplemente en una reordenación básica de los bits para evitar que se puedan editar manualmente.
• 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 archivos 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 de usuario de LVS. Se utilizan estos archivos en lugar de los archivos de registro de texto sin formato porque no tienen un límite de 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 de usuario de LVS. En este caso, se exportan copias de los archivos en texto sin formato.

InfoTags (archivos de datos de respuesta automática)

Esta carpeta contiene archivos de datos de respuesta automática para la introducción automática de los datos 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 elimina archivos de datos de respuesta automática.
• Si LoadTrak está activado, las consolas remotas de LoadTrak crean y modifican archivos de datos de respuesta automática mediante llamadas a scripts PHP a los que da acceso el servidor web integrado en el LVS.

Descargas (repositorio de archivos importados)

Esta carpeta se usa como repositorio temporal para los archivos que se copian 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 de lista, y, si los encuentra, los procesa y los elimina.
• Los archivos pueden enviarse a esta carpeta mediante el acceso a archivos compartidos
• El servicio técnico de Loadscan puede enviar archivos a esta carpeta mediante MeshCentral (a través del servicio del agente de MeshCentral que se ejecuta en el LVS).
• La aplicación LVS borra automáticamente los archivos de esta carpeta al cabo de 90 días.

TallySync (archivos de registro de TallySync)

Esta carpeta contiene los archivos de registro de la aplicación TallySync, que sirve para sincronizar archivos. Se usa para subir registros de mediciones a MyScanner si no tienes instalados los servicios MMQ. La aplicación en sí está instalada en la carpeta de aplicaciones de LVS, en la unidad del sistema. Pero para evitar escrituras frecuentes en la unidad del sistema, los archivos de registro que genera TallySync se guardan en la unidad de datos del usuario. No se puede acceder a esta carpeta desde fuera.

LoadSync (base de datos SQLite)

Esta carpeta contiene la base de datos de registros de medición de SQLite que utilizan las funciones 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 guarda datos en la base de datos SQLite cada vez que se genera un nuevo registro de medición.
• Si la base de datos no existe o no se puede leer, la aplicación LVS genera una nueva base de datos a partir de los archivos de registro en texto sin formato de los últimos 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 los archivos de configuración y los archivos temporales que utiliza la aplicación web LoadTrak integrada en el LVS.

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

Interacciones

• La aplicación LVS guarda archivos en 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 integrada, donde se almacenan los registros de mediciones para subirlos a MyScanner a través de los servicios de colas 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 mediciones se guardan tanto en la base de datos PostgreSQL como en la de SQLite. SQLite dejará de utilizarse una vez que las funcionalidades de LoadSync AP y LoadSync SQL se hayan migrado a PostgreSQL.

Interacciones

• La aplicación LVS escribe en la base de datos PostgreSQL cada vez que se genera un nuevo registro de medición o se crea o 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 existe, la aplicación LVS genera una nueva a partir de una carpeta de datos de plantilla y de scripts SQL.

Registros_del_sistema

Esta carpeta sirve para almacenar los archivos de depuración y de registro de eventos que generan distintos componentes de software del sistema. Cada componente de software que guarda sus registros en esta carpeta crea una subcarpeta con el mismo nombre y se encarga de nombrar, rotar y eliminar los archivos de registro que genera. Los registros se usan únicamente con fines de desarrollo y asistencia técnica.

Nota: en el momento de escribir esto, solo los servicios relacionados con la cámara de instantáneas guardan sus registros en esta carpeta (cuando están activos).

User.ini (configuración del usuario)

Este archivo es el archivo de configuración de los ajustes de LVS que puedes configurar tú mismo.

• 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 solo lo usa la aplicación LVS y no se puede acceder a él desde fuera.

Seqnum (contador de números de registro)

Este archivo se utiliza como contador incremental para generar los números de registro de las mediciones. Solo lo utiliza el software de la aplicación LVS y no es accesible desde fuera.

Archivos de exploración de referencia y sincronización

Los archivos de escaneo de referencia (base de datos de vehículos) y algunos otros archivos de datos de usuario se pueden sincronizar entre varios sistemas LVS a través de MyScanner o mediante rutinas de sincronización Multi-Scanner (MSS) basadas en la red local. Los archivos de escaneo de referencia no se pueden sincronizar simplemente comparando la fecha y hora de modificación de los archivos, sino que requieren una comparación más compleja. Cada registro de escaneo 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 del escaneo y otros detalles están integrados en los nombres de los archivos de escaneo de referencia para evitar tener que leer todo el archivo para recuperar los datos 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 cada archivo de escaneo de referencia está estructurado para proporcionar todos los datos principales del vehículo, de modo que se puedan elaborar listas completas de los datos de los escaneos de referencia a partir de simples listados de archivos, sin necesidad de leer el contenido real del archivo, recuperar las marcas de tiempo de la última modificación ni acceder a los registros de una base de datos SQL. La estructura del nombre del archivo es la siguiente:

[ID] . [Fecha y hora de escaneo] L [Fecha y hora de modificación] M [Estado] . [ID de etiqueta] . 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 [escaneo inicial, con etiqueta RFID presente]

TRK123.3552959772M3552959961S3.12345678.7z [ tras modificar los detalles, con etiqueta RFID incluida]

TRK123.3552959772M3552959961S3.7z [ tras la modificación, sin etiqueta RFID]

Se considera más adecuado utilizar una base de datos relacional para almacenar los detalles de cada perfil de contenedor vacío, junto con bloques 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 previsto de la infraestructura de la API del LVS. Pero cuando se desarrolló esta estructura de registros, el software del escáner no tenía la capacidad de comunicarse con una base de datos relacional. Además, cualquier cambio en la estructura de archivos existente provocaría problemas de compatibilidad con versiones anteriores.

La estructura de registros tiene la ventaja de que cada archivo contiene toda la información del vehículo o contenedor correspondiente, y los registros de escaneo de referencia se pueden copiar o trasladar de un sistema a otro mediante simples transferencias de archivos, sin necesidad de sincronizar bases de datos relacionales. Sin embargo, la compleja estructura de los nombres de archivo hace que la sincronización entre las bases de datos de varios sistemas no sea tan sencilla como comparar 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 los escaneos de referencia es garantizar que todos los escáneres de un grupo tengan copias de los archivos de escaneo de referencia más actualizados para todos los compartimentos. Cuando hay varios archivos de escaneo de referencia para el mismo ID de vehículo (en el mismo escáner o en otros distintos), «el más actualizado» no significa necesariamente el archivo con la fecha y hora de modificación más recientes. Un archivo con una fecha de escaneo más reciente siempre tiene prioridad sobre uno con una fecha de escaneo más antigua, incluso si el archivo con la fecha de escaneo más antigua tiene una fecha de modificación más reciente. Así que, cuando más adelante se hable de archivos de escaneo de referencia «actuales» o «duplicados», se refieren a:

Archivo de escaneo de referencia actual: el nombre del archivo con la fecha y hora de escaneo más recientes o, si las fechas y horas de escaneo coinciden, el nombre del archivo con la fecha y hora de modificación más recientes.

Archivo de escaneo de referencia duplicado: cualquier archivo de escaneo de referencia correspondiente a un ID de vehículo concreto que no sea el archivo de escaneo de referencia actual.

La sincronización también tiene que permitir borrar los archivos de escaneo de referencia. Cuando se borra (elimina) manualmente un archivo de escaneo de referencia en un escáner, debe borrarse en todos los demás escáneres sincronizados. Para conseguirlo, actualmente la eliminación de los archivos de escaneo de referencia se gestiona cambiando la extensión del archivo de escaneo de referencia de .7z a .DEL y sincronizando el archivo .DEL de la misma forma que los demás archivos de escaneo de referencia. El software del escáner ignora los archivos .DEL y estos se eliminan al cabo de 6 meses mediante procesos en segundo plano (se da por hecho que la sincronización se ha producido en un plazo de 6 meses).

Hay casos en los que pueden existir archivos de escaneo de referencia «duplicados» en la misma carpeta. Es necesario eliminar esos archivos con regularidad.

Los archivos de escaneo de referencia temporales que se encuentran en la subcarpeta «Temp» se utilizan para las mediciones de 2-Scan y, opcionalmente, deben sincronizarse de la misma forma que los archivos de escaneo de referencia estándar. Estos archivos solo tienen una vida útil de 6 horas, tras las cuales se eliminan automáticamente. La subcarpeta «Temp» también puede contener otros archivos temporales que almacenan datos de carga recopilados en el primer escaneo de los dos y que deben registrarse en el segundo escaneo. Estos archivos tienen la 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 escaneo de referencia, pero la estructura del nombre de archivo es la misma, por lo que la rutina de sincronización funciona con ellos.