Arquivamento de dados

O menu Administração/Arquivo pode ser acessado por usuários com permissão Administrador de Instância.

Para melhorar o desempenho da aplicação, dados históricos são automáticamente arquivados e posteriormente excluídos da base de dados principal.

A configuração padrão determina o arquivamento para dados com 3 meses sem alteração, e a exclusão definitiva da base principal ocorre num período mínimo de 6 meses. A configuração pode ser ajustada conforme a infraestrutura dos servidores.

As seguintes informações são consideradas dados históricos:

• Alertas de processamento
• Dados de painéis (dashboards)
• Comandos de equipamentos
• Geo posicionamento
• Componentes da telemetria
• Alocação de equipamentos
• Vínculos de equipamentos
• Alterações de situação dos equipamentos
• Faturas
• Incidentes
• Viagens
• Ações de usuários
• Telemetria dos pneus
• Telemetria dos sensores do veículo
• Acompanhamento de localidades dos veículos
• Alterações de situação de veículos

Os dados são arquivados em formato texto CSV, colunas delimitadas por aspas duplas e separadas por vírgula, codificação dos caracters em UTF-8. Campos nulos contém “\N”.

Todas as datas são no formato: DD/MM/AA HH:MM:SS fuso horário UTC/GMT+0.

Campos com valores pré-definidos são definidos em Tipos

É gerado um arquivo diário (.tbz2) contendo os dados compactados em formato tar bzip2 que pode ser aberto usando programas como 7-zip;

O arquivamento ocorre diáriamente às 4AM UTC (1AM Sao Paulo/BR). Desta forma pode ocorrer que dados do dia no horário local constem apenas no arquivo do dia seguinte.

Para todos os dados de histórico que são arquivados por data de edição/modificação, pode ser que o dado seja incluído em mais de um arquivo diário por causa do intervalo existente entre a data do arquivamento e a data da exclusão.

Alertas de processamento

Os alertas de processamento são salvos no arquivo plamoon_CLIENT_alerts_DATE.csv.

São arquivados pela data de dispensa do alerta.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da geração do alerta;
• “Description”: Descrição do alerta conforme regra;
• “Equipment”: Número de série do equipamento;
• “Vehicle”: Placa do veículo;
• “Trip No.”: Número da viagem;
• “Position Date/Time (UTC)”: Data/Hora da posição que gerou o alerta;
• “Latitude”: Latitude da posição;
• “Longitude”: Longitude da posição;
• “Address”: Endereço referente a coordenada da posição;
• “Dismissed Date/Time (UTC)”: Data/Hora que o alerta foi dispensado;
• “Dimisser Username”: Usuário que dispensou o alerta, nulo indica automático;
• “Dismissing Reason”: Razão fornecida por usuário;

Comandos de equipamentos

Os comandos de equipamentos são salvos no arquivo plamoon_CLIENT_commands_DATE.csv.

São arquivados pela data da criação do comando.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da criação do comando;
• “Type”: Tipo do comando enviado;
• “Status”: Situação do envio conforme command_status;
• “Equipment”: Número de série do equipamento destino do comando;
• “Vehicle”: Placa do veículo ao qual o equipamento estava vinculado no momento da criação do comando;
• “Issuer”: Usuário ou Regra que criou o comando;

Geo posicionamento

Os dados de Geo posicionamento são salvos no arquivo plamoon_CLIENT_positions_DATE.csv.

São arquivados pela data do posicionamento.

Dados de histórico que ficaram armazenados por muito tempo no equipamento e posteriormente transmitidos, ou dados que foram enviados com relógio incorreto (ex.: zerado) correm o risco de não serem incluídos no arquivo. Optou-se pela geração do arquivo pela relevância das posições. Normalmente dados que caem nessa condição são inválidos ou irrelevantes. Este comportamento poderá ser alterado futuramente.

O arquivo contem as seguintes colunas:

• “Position Date/Time (UTC)”: Data/Hora da posição conforme equipmento;
• “Comm Date/Time (UTC)”: Data/Hora do servidor na recepção da posição;
• “Equipment”: Número de série do equipamento que enviou a posição;
• “Vehicle”: Placa do veículo no período do vínculo;
• “Trip No.”: Número da viagem no período do vínculo;
• “Position”: Validade da posição;
• “Latitude”: Latitude da posição;
• “Longitude”: Longitude da posição;
• “Direction (deg)”: Direção em graus conforme equipamento;
• “Speed (Km/h)”: Velocidade em Km/h conforme equipamento;
• “Street”: Rua (endereço obtido por geocodoficação reversa para a Latitude/Longitude informada)
• “Zone”: Bairro
• “City”: Cidade
• “State”: Estado
• “Postal Code”: Código Postal
• “Country”: País

Componentes da telemetria

Os componentes da telemetria são salvos no arquivo plamoon_CLIENT_components_DATE.csv.

São arquivados pela data do posicionamento.

O arquivo contem as seguintes colunas:

• “Position Date/Time (UTC)”: Data/Hora da criação do comando;
• “Equipment”: Número de série do equipamento destino do comando;
• “Component”: Tipo do componenente;
• “Value”: Valor do componente;

Alocação de equipamentos

Os dados de alocação de equipamentos são salvos no arquivo plamoon_CLIENT_equipments_alloc_DATE.csv.

São arquivados pela data de retorno.

O arquivo contem as seguintes colunas:

• “Equipment”: Número de série do equipamento;
• “Origin Client”: Cliente origem (dono do equipamento);
• “Dest Client”: Cliente destino (recebeu o equipamento);
• “Username Alloc”: Usuário que efetuou a operação;
• “Alloc Date/Time (UTC)”: Data/Hora da ação;
• “Username Return”: Usuário que efetuou a operação de retorno;
• “Return Date/Time (UTC)”: Data/Hora da ação de retorno;
• “Comment”: Comentário;

Vínculos de equipamentos

Os dados de vínculos de equipamentos são salvos no arquivo plamoon_CLIENT_equipments_links_DATE.csv.

São arquivados pela data de finalização do vínculo.

O arquivo contem as seguintes colunas:

• “Equipment”: Número de série do equipamento;
• “Origin Client”: Cliente origem (dono do equipamento);
• “Dest Client”: Cliente destino (recebeu o equipamento);
• “Username Alloc”: Usuário que efetuou a operação;
• “Alloc Date/Time (UTC)”: Data/Hora da ação;
• “Username Return”: Usuário que efetuou a operação de retorno;
• “Return Date/Time (UTC)”: Data/Hora da ação de retorno;
• “Comment”: Comentário;

Alterações de situação dos equipamentos

Os dados de alteração da situação de equipamentos são salvos no arquivo plamoon_CLIENT_equipments_status_DATE.csv.

São arquivados pela data de alteração da situação.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da ação;
• “Equipment”: Número de série do equipamento;
• ”-> Status”: Situação para o qual foi alterado;
• “Username”: Usuário que efetuou a operação;
• “Groups”: Grupos no momento da operação;
• “Tags”: Tags no momento da operação;

Faturas

Os dados de faturas são salvos nos arquivos plamoon_CLIENT_invoices_DATE.csv e plamoon_CLIENT_invoices_details_DATE.csv.

São arquivados pela data de edição da fatura.

O arquivo invoices contem as seguintes colunas:

• “Invoice No.”: Número da fatura;
• “Status”: Situação da fatura;
• “Origin Client”: Cliente que emite a fatura;
• “Dest Client”: Cliente que recebe a fatura;
• “Start Date/Time (UTC)”: Data/Hora inicial do período;
• “End Date/Time (UTC)”: Data/Hora final do período;
• “Create Date/Time (UTC)”: Data/Hora de criação;
• “Create Username”: Usuário que criou;
• “Edit Date/Time (UTC)”: Data/Hora da última edição;
• “Edit Username”: Usuário que editou pela última vez;
• “Description”: Descrição;
• “Details”: Detalhes;
• “Total Charges”: Total da cobrança;
• “Total Discounts”: Total dos descontos;
• “Total Discounts %”: Desconto em %;
• “Total Invoice”: Total da cobrança menos descontos;

O arquivo details contem as seguintes colunas:

• “Invoice No.”: Número da fatura;
• “Item #”: Ordinal do Item;
• “Description”: Descrição do Item;
• “Type”: Tipo do Item;
• “Calculation Type”: Tipo de Cálculo;
• “Value”: Valor Unitário;
• “Qtty”: Quantidade;
• “Total”: Valor Total;

Viagens

Os dados de incidentes são salvos nos arquivos plamoon_CLIENT_trips_DATE.csv e plamoon_CLIENT_trips_composition_DATE.csv e plamoon_CLIENT_trips_details_DATE.csv.

São arquivados pela data de edição da viagem.

O arquivo trips contem as seguintes colunas:

• “Trip No.”: Número da viagem;
• “Status”: Situação da viagem;
• “Client”: Cliente dono da viagem;
• “Create Date/Time (UTC)”: Data/Hora de criação;
• “Create Username”: Usuário que criou;
• “Edit Date/Time (UTC)”: Data/Hora da última edição;
• “Edit Username”: Usuário que editou pela última vez;
• “Planned Start Date/Time (UTC)”: Data/Hora início planejado;
• “Planned End Date/Time (UTC)”: Data/Hora finalização planejado;
• “Start Date/Time (UTC)”: Data/Hora início;
• “End Date/Time (UTC)”: Data/Hora finalização;
• “Driver Name”: Nome do motorista;
• “Driver Phone”: Telefone motorista;
• “Siscomex DTA”: Siscomex DTA (Brasil);
• “Siscomex DTI”: Siscomex DTI (Brasil);
• “Description”: Descrição;
• “Details”: Detalhes;

O arquivo composition contem as seguintes colunas:

• “Trip No.”: Número da viagem;
• “Item #”: Ordinal do Item;
• “Vehicle”: Placa do veículo;
• “Equipment”: Número de série do equipamento;

O arquivo details contem as seguintes colunas:

• “Trip No.”: Número da viagem;
• “Item #”: Ordinal do Item;
• “Route”: Descrição da Rota;
• “Origin”: Descrição da Localidade Origem;
• “Destination”: Descrição da Localidade Destino;
• “Start Date/Time (UTC)”: Data/Hora do início do trecho na rota;
• “End Date/Time (UTC)”: Data/Hora do fim do trecho na rota;

Ações de Usuários

Os dados de ações de usuários são salvos nos arquivos plamoon_CLIENT_users_actions_DATE.csv.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da ação;
• “Client”: Cliente dono do usuário;
• “Username”: Usuário que realizou a ação;
• “Action”: Tipo da ação;
• “Object”: Tipo do objeto que sofreu a ação;
• “Description”: Descrição do objeto;

Telemetria dos sensores do veículo

Os dados de telemetria dos sensores dos veículos são salvos no arquivo plamoon_CLIENT_sensors_data_DATE.csv.

São arquivados pela data da informação.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da informação;
• “Vehicle”: Placa do veículo;
• “Description”: Descrição do sensor;
• “Type”: Tipo do sensor;
• “Value”: Valor do sensor;
• “Status”: Situação do sensor (conforme reportado);
• “Event”: Evento do sensor;
• “Position Date/Time”: Data/Hora da posição no momento;

Telemetria dos pneus

Os dados de telemetria dos pneus são salvos no arquivo plamoon_CLIENT_tires_data_DATE.csv.

São arquivados pela data da informação.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da informação;
• “Vehicle”: Placa do veículo;
• “Mounting”: Posição de montagem no veículo;
• “Marking”: Marcação externa no pneu;
• “Pressure (kPa)”: Pressão em kPa;
• “Temperature (oC)”: Temperatura em oC;
• “Position Date/Time”: Data/Hora da posição no momento;

Acompanhamento de localidades dos veículos

Os dados do acompanhamento de localidades dos veículos são salvos no arquivo plamoon_CLIENT_vehicles_locations_DATE.csv.

São arquivados pela data de saída da localização.

O arquivo contem as seguintes colunas:

• “Vehicle”: Placa do veículo;
• “Location”: Descrição da localização;
• “Enter Date/Time (UTC)”: Data/Hora entrada na localização;
• “Exit Date/Time (UTC)”: Data/Hora saída da localização;

Alterações de situação de veículos

Os dados de alteração da situação de veículos são salvos no arquivo plamoon_CLIENT_vehicles_status_DATE.csv.

São arquivados pela data de alteração da situação.

O arquivo contem as seguintes colunas:

• “Date/Time (UTC)”: Data/Hora da ação;
• “Vehicle”: Número de série do equipamento;
• ”-> Status”: Situação para o qual foi alterado;
• “Username”: Usuário que efetuou a operação;
• “Groups”: Grupos no momento da operação;
• “Tags”: Tags no momento da operação;