Os sistemas LVS têm um módulo de unidade de estado sólido onde ficam armazenados todos os dados do usuário e as configurações que você pode ajustar. Essa unidade é chamada de “unidade de dados do usuário” e é diferente da unidade “do sistema”, que é protegida contra gravação e inclui o sistema operacional, o aplicativo LVS, o software de suporte e as configurações de fábrica.

O documento traz uma visão geral dos arquivos e pastas na unidade de dados do usuário, sua finalidade e os processos internos e externos que atuam sobre eles. Isso não inclui informações detalhadas sobre a estrutura dos arquivos nem sobre seu uso.

As informações contidas neste documento referem-se ao projeto atual do LVS no momento da redação:

• Versão do software LVS v3.0-621
• Sistema operacional Windows 10 IoT Enterprise 2016 ou 2021
• Plataforma de hardware Advantech PPC-3100-RE9A.

Arquivos e pastas de dados do usuário

A tabela abaixo lista as pastas e os arquivos presentes na raiz da unidade de dados do usuário. As informações sobre cada um deles são fornecidas nas seções a seguir. O acesso ao compartilhamento de arquivos em rede só se aplica se o compartilhamento de arquivos estiver habilitado no LVS.

Arquivos de registro diário (registros de medição em texto simples)

Essa pasta contém arquivos de log de registros de medição em texto simples dos últimos 90 dias.

• Arquivos de texto ASCII delimitados por tabulação (arquivos de registro).
• Um arquivo por dia, em que o nome do arquivo inclua a data e o número de série do LVS.
• Limitado aos últimos 90 dias.
• Um registro de várias colunas por linha com uma única linha de cabeçalho por arquivo.
• Os arquivos de registro são apenas anexados (a contagem de bytes sempre aumenta).
• O nome do arquivo de log atual (atualizado mais recentemente) e a contagem de bytes desse arquivo são registrados em um arquivo chamado “current.dat” na subpasta “Current”.

Consulte o documento de suporte do LVS “Loadscan LVS – Formatos de arquivos de log” para obter informações detalhadas sobre os formatos de arquivo de log do LVS.

Interações

• O aplicativo LVS grava no arquivo de log e atualiza o arquivo current.dat sempre que um novo registro de medição é gerado. Um novo arquivo de log é gerado automaticamente se ainda não houver nenhum arquivo de log para o dia atual.
• O software de relatórios OverView, rodando em um computador conectado à rede local, lê os arquivos de log por meio da API Filesync (HTTP) em execução no LVS ou por meio de um compartilhamento de arquivos na rede. O OverView monitora o arquivo “current.dat” para detectar quando há novos registros. Isso evita listagens repetidas de arquivos.
• Apenas sistemas LVS sem os serviços MMQ instalados. O utilitário de sincronização de arquivos TallySync, que roda nos monitores LVS, monitora os arquivos de log e envia novos registros de medição para o MyScanner se o LVS estiver configurado com uma conta do MyScanner e configurado para enviar registros de medição. O TallySync chama scripts PHP disponibilizados pelo servidor web do MyScanner para acrescentar registros de medição às cópias online dos arquivos de log de texto.
• Os arquivos de log podem ser copiados manualmente por meio do acesso ao compartilhamento de arquivos em rede (se estiver habilitado). Os usuários podem optar por acessar os arquivos de log diretamente e abri-los no Excel ou processá-los com seus próprios sistemas.
• Os arquivos de log podem ser baixados manualmente para um pen drive a partir da interface do operador do LVS.
• O aplicativo LVS apaga automaticamente os arquivos de log em texto simples após 90 dias.

Dbase (banco de dados de veículos)

Essa pasta contém arquivos de registros de digitalização de referência. Esses arquivos são, basicamente, modelos 3D de compartimentos vazios de caminhões ou reboques. Essa coleção de arquivos é chamada de “banco de dados de veículos”. É um banco de dados no sentido de que é um conjunto estruturado de objetos de dados informativos e, na interface do usuário do LVS, é gerenciado como um conjunto de registros de banco de dados, mas não possui nenhuma estrutura de banco de dados relacional/tabular associada a ele na implementação atual.

• Subpastas para diferentes classes de compartimentos de caminhões (consulte a tabela abaixo).
• Um arquivo de dados binários compactado por bin. Formato LVS proprietário.
• O ID do compartimento, a hora da digitalização e outros metadados estão incorporados nos nomes dos arquivos. Veja Formato de nome de arquivo de digitalização de referência no final deste documento para informações mais detalhadas sobre o formato do nome do arquivo de digitalização de referência.
• Arquivo de configuração de limites de status de carga para relatórios de status de carga.
• Arquivos temporários usados para a sincronização do banco de dados de veículos entre vários sistemas LVS.

As subpastas do banco de dados de veículos são:

Interações

• O aplicativo LVS cria, modifica e exclui arquivos de registros de digitalização de referência.
• [Funcionalidade obsoleta] Se a Sincronização de Vários Scanners (MSS) estiver ativada para dois ou mais sistemas LVS na mesma rede local, os arquivos de referência de digitalização são sincronizados por meio de compartilhamentos de arquivos na rede. A rotina MSS em um LVS pode criar, modificar e excluir arquivos de registros de digitalização de referência, tanto internamente quanto em outro sistema LVS.
• Se o LVS estiver configurado para sincronizar o banco de dados de veículos com o MyScanner, a rotina MSS no LVS sincroniza os arquivos de digitalização de referência com um “mestre” online pertencente à conta de usuário do MyScanner. Isso é feito por meio de chamadas ao serviço web da API FileSync disponibilizado pelo servidor web do MyScanner. Para um único sistema LVS, isso simplesmente cria um backup do “banco de dados de veículos”. Para vários sistemas LVS, isso alcança o mesmo resultado que a Sincronização Multi-Scanner em uma rede local.
• Os arquivos de registro de digitalização de referência podem ser exportados para um pen drive via a interface do operador do LVS. Os arquivos de digitalização de referência são exportados como uma cópia compactada de toda a pasta “Dbase”.
• Um conjunto de arquivos de registros de digitalização de referência exportado anteriormente pode ser importado de uma pen drive via a interface do usuário do LVS.

Dados (arquivos de dados de digitalização)

Essa pasta contém arquivos de dados de digitalização na raiz. Esses arquivos contêm os dados brutos de medição a laser do lidar capturados durante cada digitalização e outros metadados associados. Esses arquivos são usados para criar gráficos de perfil de digitalização 3D e para fins de diagnóstico.

• Um arquivo de dados binários compactado por varredura.
• Número de registro, IDs de compartimento, tempo de digitalização, códigos de erro e outros metadados incorporados nos nomes de arquivos.

Dependendo da configuração do sistema, as seguintes subpastas também podem estar presentes;

Interações

• O aplicativo LVS cria arquivos de dados de digitalização e arquivos de imagem LPR.
• As subpastas e os arquivos são criados, processados e excluídos por vários serviços, dependendo da configuração do sistema.
• O software de geração de relatórios OverView lê arquivos de dados de digitalização via API Filesync (HTTP) ou compartilhamento de arquivos em rede para gerar imagens 3D para a ferramenta integrada 3D Load Profiler.
• Os arquivos de dados digitalizados e os arquivos de imagem LPR podem ser exportados para um pen drive via a interface do operador do LVS.
• Os arquivos de dados digitalizados podem ser copiados manualmente por meio do compartilhamento de arquivos em rede (somente leitura). Os arquivos nas subpastas também podem ser acessados por meio do compartilhamento de arquivos, mas isso nunca deveria ser necessário.
• O aplicativo LVS apaga automaticamente os arquivos de dados de digitalização e quaisquer arquivos de imagem LPR correspondentes após um período definido, dependendo do tipo de digitalização;
  • As varreduras de erros que não resultam em nenhuma medição são excluídas após 7 dias,
  • As varreduras que resultam em uma medição são excluídas após 60 dias,
  • As varreduras de referência vazias são excluídas após 3 anos.

Listas (arquivos de lista de seleção)

Essa pasta contém arquivos de texto simples com listas de seleção de detalhes de carregamento.

• Arquivos de texto ASCII no formato CSV.
• Um item de lista por linha com campos adicionais (colunas) para funções especiais, conforme necessário.
• Os nomes dos arquivos da lista correspondem aos detalhes de carga configurados no LVS.

Interações

• O aplicativo LVS cria, modifica e exclui arquivos de lista.
• O software de relatório OverView cria, modifica e exclui arquivos de lista por meio da API do Filesync (HTTP) ou do compartilhamento de arquivos em rede.
• Os arquivos da lista podem ser exportados para um pen drive via a interface do operador do LVS.
• Os arquivos da lista podem ser importados de um pen drive por meio da interface do operador do LVS.
• [Funcionalidade obsoleta] Se a Sincronização de Vários Scanners (MSS) estiver ativada para dois ou mais sistemas LVS na mesma rede local, os arquivos de lista podem ser sincronizados por meio de compartilhamentos de arquivos na rede. A rotina MSS em um LVS pode criar, modificar e excluir arquivos de lista internamente e em outro sistema LVS.
• Se o LVS estiver configurado para sincronizar listas detalhadas de carga com o MyScanner, a rotina MSS pode sincronizar arquivos de lista com um “mestre” online pertencente à conta de usuário do MyScanner. Isso é feito por meio de chamadas ao serviço web FileSyncAPI disponibilizado pelo servidor web do MyScanner. Para um único sistema LVS, isso simplesmente cria um backup das listas de detalhes de carga. Para vários sistemas LVS, isso alcança o mesmo resultado que a sincronização Multi-Scanner em uma rede local.
• Os arquivos da lista podem ser copiados, modificados ou excluídos manualmente por meio do acesso ao compartilhamento de arquivos em rede.
• Somente sistemas com serviços MMQ instalados: O conteúdo do arquivo de lista é copiado para o banco de dados PostgreSQL e carregado no MyScanner por meio dos serviços MMQ para uso na interface de usuário do MyScanner.

Logs (registros de medição criptografados)

Essa pasta contém arquivos de log de registros de medição criptografados. São os registros-mestre de medição e os logs de auditoria do sistema LVS (exigidos pelas autoridades de Pesos e Medidas em sistemas certificados).

• Os arquivos são versões criptografadas dos arquivos de log em texto simples gravados na pasta “Daily Log Files”. A criptografia consiste apenas em uma reordenação básica de bits para impedir a edição manual.
• Os arquivos são movidos para a subpasta “Arquivados” e convertidos em arquivos compactados após 60 dias.
• Os arquivos nunca são excluídos, a menos que os dados do usuário sejam redefinidos.
• Os arquivos não são acessíveis externamente

Interações

• O aplicativo LVS cria, modifica e arquiva arquivos de log.
• O aplicativo LVS lê o histórico de medições desses arquivos de log para exibi-lo na tela “Registros” da interface do operador do LVS. Esses arquivos são usados em vez dos arquivos de log em texto simples porque não têm o limite de 90 dias e é muito improvável que tenham sido manipulados.
• Os arquivos de log podem ser exportados para um pen drive via a interface de operação do LVS. Nesse caso, são exportadas cópias dos arquivos em texto simples.

InfoTags (arquivos de dados de resposta automática)

Essa pasta contém arquivos de dados de resposta automática para a inserção automatizada de detalhes de carga.

• Arquivos de texto ASCII delimitados por tabulação.
• Cada linha contém um nome de detalhe de carga e o texto de resposta automática correspondente.
• O nome do arquivo identifica o veículo, o operador do veículo ou o grupo de veículos aos quais os dados de resposta automática se aplicam.

Interações

• O aplicativo LVS cria, modifica e exclui arquivos de dados de resposta automática.
• Se o LoadTrak estiver ativado, os consoles remotos do LoadTrak criam e modificam arquivos de dados de resposta automática por meio de chamadas a scripts PHP disponibilizados pelo servidor web integrado no LVS.

Downloads (repositório de arquivos importados)

Essa pasta serve como repositório temporário para arquivos copiados para o LVS a partir de fontes externas.

Interações

• O aplicativo LVS monitora essa pasta em busca de novos arquivos de tipos reconhecidos, como arquivos de atualização de software e arquivos de lista, e os processa e exclui caso os encontre.
• Os arquivos podem ser enviados para essa pasta por meio do acesso ao compartilhamento de arquivos
• Os arquivos podem ser enviados para essa pasta pelo suporte técnico do Loadscan usando o MeshCentral (por meio do serviço do agente do MeshCentral em execução no LVS).
• O aplicativo LVS exclui automaticamente os arquivos desta pasta após 90 dias.

TallySync (arquivos de registro do TallySync)

Essa pasta contém os arquivos de log do aplicativo TallySync, que serve para sincronizar arquivos. Ele é usado para enviar registros de medição para o MyScanner caso os serviços MMQ não estejam instalados. O aplicativo em si fica na pasta de aplicativos do LVS, na unidade do sistema. Mas, para evitar gravações frequentes na unidade do sistema, os arquivos de log gerados pelo TallySync são armazenados na unidade de dados do usuário. Essa pasta não é acessível externamente.

LoadSync (banco de dados SQLite)

Essa pasta contém o banco de dados de registros de medição do SQLite usado pelas funcionalidades LoadSyncAPI e LoadSyncSQL integradas ao LVS.

• O banco de dados SQLite contém as mesmas informações de registros de medição que os arquivos de registro de registro de medição, em um formato de banco de dados com várias tabelas.
• O banco de dados é um único arquivo chamado “records.db”.
• Os registros nunca são excluídos, a menos que os dados do usuário sejam redefinidos.
• Essa pasta não pode ser acessada externamente.

Interações

• O aplicativo LVS grava no banco de dados SQLite toda vez que um novo registro de medição é gerado.
• Se o banco de dados não existir ou estiver ilegível, o aplicativo LVS gera um novo banco de dados a partir dos arquivos de log em texto simples dos últimos 90 dias.
• Os scripts PHP LoadSyncAPI e LoadSyncSQL leem (consultam) registros do banco de dados SQLite.

LoadTrak (arquivos do aplicativo da Web LoadTrak)

Essa pasta contém arquivos de configuração e arquivos temporários usados pelo aplicativo web LoadTrak integrado ao LVS.

• Os arquivos são usados para a troca de dados entre o aplicativo LVS e os scripts PHP do LoadTrak.
• Essa pasta não pode ser acessada externamente.

Interações

• O aplicativo LVS grava em arquivos nessa pasta.
• Os scripts PHP do LoadTrak leem os arquivos dessa pasta.

PostgreSQL

Essa pasta é a pasta de dados do banco de dados PostgreSQL integrado, que armazena registros de medição para envio ao MyScanner por meio dos serviços de fila de mensagens do MyScannerMQ (MMQ).

• O banco de dados PostgreSQL armazena registros de medição em um formato de dados avançados que contém mais informações do que as registradas em arquivos de log ou no banco de dados SQLite.
• Os registros são excluídos após 2 anos.
• Essa pasta não pode ser acessada externamente.

Observação: No momento da redação deste texto, os registros de medição são gravados tanto no PostgreSQL quanto no SQLite. O SQLite não será mais usado assim que as funcionalidades do LoadSync AP e do LoadSync SQL forem migradas para o PostgreSQL.

Interações

• O aplicativo LVS grava no banco de dados PostgreSQL toda vez que um novo registro de medição é gerado ou quando uma lista de seleção de detalhes de carga é criada ou modificada.
• Os serviços MMQ (se estiverem ativos) leem do banco de dados PostgreSQL e carregam registros e listas de seleção de detalhes para o serviço da Web MyScanner.
• Se o banco de dados não estiver presente, o aplicativo LVS gera um novo banco de dados a partir de uma pasta de dados modelo e de scripts SQL.

Registros do sistema

Essa pasta serve como repositório para arquivos de depuração e de log de eventos gerados por vários componentes de software do sistema. Cada componente de software que registra dados nessa pasta cria uma subpasta com o mesmo nome e cuida da nomenclatura, rotação e exclusão dos arquivos de log que gera. Os logs são usados apenas para fins de desenvolvimento e suporte.

Observação: no momento em que este texto foi escrito, só os serviços relacionados à câmera de instantâneos registram seus logs nessa pasta (quando estão ativos).

User.ini (configurações do usuário)

Esse arquivo é o arquivo de configuração para as opções do LVS que podem ser definidas pelo usuário.

• Criptografado por uma simples reordenação de bits para ofuscar as configurações.
• O arquivo descriptografado tem o formato de arquivo .INI de texto ASCII padrão.
• Esse arquivo é usado apenas pelo aplicativo LVS e não está acessível externamente.

Seqnum (contador de número de registro)

Esse arquivo é usado como um contador incremental para a geração de números de registros de medição. Ele é usado apenas pelo software LVS e não está acessível externamente.

Arquivos de varredura de referência e sincronização

Os arquivos de digitalização de referência (banco de dados de veículos) e alguns outros arquivos de dados do usuário podem ser sincronizados entre vários sistemas LVS por meio do MyScanner ou de rotinas de Sincronização Multi-Scanner (MSS) baseadas na rede local. Os arquivos de digitalização de referência não podem ser sincronizados apenas comparando a data e hora de modificação dos arquivos e exigem uma comparação mais complexa. Cada registro de digitalização de referência é um único arquivo que contém os dados binários do modelo 3D e os detalhes do compartimento. O ID do compartimento, a hora da digitalização e outros detalhes estão embutidos nos nomes dos arquivos de digitalização de referência para evitar a necessidade de ler um arquivo inteiro para recuperar detalhes básicos. A rotina de sincronização usa esse formato de nome de arquivo.

Formato de nome de arquivo de varredura de referência

O nome de cada arquivo de digitalização de referência é estruturado de forma a fornecer todas as informações principais do veículo, para que listas completas desses detalhes possam ser compiladas a partir de simples listagens de arquivos, sem precisar ler o conteúdo real do arquivo, recuperar carimbos de data/hora da última modificação ou acessar registros do banco de dados SQL. A estrutura do nome do arquivo é:

[ID] . [Data e hora da digitalização] M [Data e hora da modificação] S [Status] . [ID da tag] . 7z

Cada arquivo de digitalização de referência é um arquivo compactado com a extensão .7z. Exemplos de nomes de arquivos são:

TRK123.3552959772M3552959772S3.12345678.7z [leitura inicial, com etiqueta RFID presente]

TRK123.3552959772M3552959961S3.12345678.7z [ após modificação nos detalhes, com etiqueta RFID presente]

TRK123.3552959772M3552959961S3.7z [ após modificação, sem etiqueta RFID]

Considera-se mais adequado usar um banco de dados relacional para armazenar os detalhes informativos de cada perfil de compartimento vazio, juntamente com blobs de dados binários ou referências a arquivos de dados binários, e o LVS será migrado para uma solução de banco de dados como parte do projeto planejado da estrutura da API do LVS. Mas, na época em que essa estrutura de registro foi desenvolvida, o software do scanner não tinha como se comunicar com um banco de dados relacional. Além disso, qualquer alteração na estrutura de arquivos existente vai causar problemas de compatibilidade com versões anteriores.

A estrutura de registros tem a vantagem de que cada arquivo contém todas as informações do veículo/compartimento correspondente, e os registros de digitalização de referência podem ser copiados ou transferidos de um sistema para outro por meio de simples transferências de arquivos, sem a necessidade de sincronização com bancos de dados relacionais. No entanto, a complexa estrutura dos nomes de arquivo faz com que a sincronização entre bancos de dados de vários sistemas não seja apenas uma questão de comparar nomes de arquivo e carimbos de data/hora de modificação.

Sincronização de varredura de referência

O objetivo da sincronização das digitalizações de referência é garantir que todos os scanners de um grupo tenham cópias dos arquivos de digitalização de referência mais atualizados para todos os compartimentos. Quando existem vários arquivos de digitalização de referência para o mesmo ID de veículo (no mesmo scanner ou em scanners diferentes), o “mais atualizado” não significa necessariamente o arquivo com a data e hora de modificação mais recente. Um arquivo com uma data de digitalização mais recente sempre deve ter prioridade sobre um arquivo com uma data de digitalização mais antiga, mesmo que o arquivo com a data de digitalização mais antiga tenha uma data de modificação mais recente. Portanto, quando se falar em arquivos de digitalização de referência “atuais” ou “duplicados” a seguir, eles são definidos como:

Arquivo de varredura de referência atual: o nome do arquivo com a data e hora de varredura mais recente ou, caso as datas e horas de varredura sejam iguais, o nome do arquivo com a data e hora de modificação mais recente.

Arquivo de digitalização de referência duplicado: Qualquer arquivo de digitalização de referência para um ID de veículo específico que não seja o arquivo de digitalização de referência atual.

A sincronização também precisa permitir a exclusão de arquivos de digitalização de referência. Quando um arquivo de digitalização de referência é excluído manualmente (removido) em um scanner, ele precisa ser excluído em todos os outros scanners sincronizados. Para isso, a exclusão da digitalização de referência é feita, no momento, alterando a extensão do arquivo de digitalização de referência de .7z para .DEL e sincronizando o arquivo .DEL da mesma forma que os outros arquivos de digitalização de referência. O software do scanner ignora os arquivos .DEL, e eles são removidos após 6 meses por processos em segundo plano (presume-se que a sincronização tenha ocorrido dentro desse prazo).

Às vezes, podem existir arquivos de digitalização de referência “duplicados” na mesma pasta. Esses arquivos precisam ser removidos regularmente.

Os arquivos temporários de varredura de referência encontrados na subpasta “Temp” são usados para medições 2-Scan e, opcionalmente, precisam ser sincronizados da mesma forma que os arquivos padrão de varredura de referência. Esses arquivos têm validade de apenas 6 horas; depois disso, são excluídos automaticamente. A subpasta “Temp” também pode conter outros arquivos temporários que armazenam detalhes de carga coletados na primeira varredura de duas e que precisam ser registrados na segunda varredura. Esses arquivos têm a extensão .rec e também são excluídos após 6 horas. Esses arquivos .rec não têm o mesmo formato de dados que os arquivos de varredura de referência, mas a estrutura do nome do arquivo é a mesma, de modo que a rotina de sincronização funciona com eles.