Ogni gruppo di letture che A-REX riceve ha un rapporto di convalida: che arrivi da una piattaforma di dispositivi, da un tuo software o da un file del logger che carichi. Le letture valide vengono salvate anche quando altre dello stesso gruppo sono rifiutate, e niente viene scartato in silenzio.
Come si legge un rapporto
Il rapporto inizia con i conteggi: letture ricevute, salvate (o valide, per una verifica), rifiutate, già registrate e avvisi. Sotto c'è una riga per ogni tipo di problema: se la lettura è stata rifiutata o ha ricevuto un avviso o una nota, cosa è successo in parole semplici, le righe o le letture interessate, quante letture ha toccato e come correggerlo. Il codice alla fine della riga apre la sua sezione qui. Un gruppo senza alcuna lettura viene rifiutato e non se ne conserva nulla.
Per caricare e verificare un file del logger vedi Carica un file del logger; i codici qui sotto sono gli stessi ovunque.
READING_PROFILE_UNKNOWN
Rifiutata. Il rapporto dice: “Non conosciamo il profilo ….”
- Perché conta: Le letture non si possono verificare senza le loro regole.
- Come risolverlo: Usa uno dei profili elencati nella guida.
READING_PROFILE_VERSION_RETIRED
Rifiutata. Il rapporto dice: “La versione … del profilo … non è più accettata.”
- Perché conta: Le regole vecchie non sono più supportate.
- Come risolverlo: Invia la versione …; consulta l’elenco delle modifiche.
READING_PROFILE_NOT_PINNED
Nota. Il rapporto dice: “… non fa parte delle misure concordate per questa consegna; è stato tenuto come extra.”
- Perché conta: Il destinatario non ha concordato di verificarlo.
- Come risolverlo: Aggiungi il profilo alla consegna oppure ignora questo avviso.
READING_PROFILE_NOT_APPLICABLE
Avviso. Il rapporto dice: “… è misurato secondo …, che non si applica a …; è stato tenuto come extra.”
- Perché conta: Ogni profilo è pensato per certe merci; le letture di altre merci non vengono verificate con regole concordate.
- Come risolverlo: Scegli un profilo valido per questo prodotto, oppure ignora l’avviso se la lettura extra è utile.
READING_FIELD_MISSING
Rifiutata. Il rapporto dice: “Manca ….”
- Perché conta: Il profilo lo richiede, ed EPCIS e UNTP ne hanno bisogno per descrivere la lettura.
- Come risolverlo: Invia …; per esempio: ….
READING_FIELD_RECOMMENDED_MISSING
Nota. Il rapporto dice: “Non è indicato: ….”
- Perché conta: Rende la lettura più affidabile e più facile da abbinare.
- Come risolverlo: Aggiungi … quando il dispositivo lo conosce.
READING_FIELD_UNKNOWN
Nota. Il rapporto dice: “… non fa parte delle regole delle letture ed è stato ignorato.”
- Perché conta: I dati sconosciuti non vengono mai salvati.
- Come risolverlo: Rimuovilo oppure associalo a un campo noto nella mappatura dell’endpoint.
READING_VALUE_NOT_NUMBER
Rifiutata. Il rapporto dice: “… deve essere un numero; abbiamo ricevuto "…".”
- Perché conta: Un valore che non è un numero non si può confrontare con un intervallo.
- Come risolverlo: Invia cifre, con il punto per i decimali.
READING_UNIT_UNKNOWN
Rifiutata. Il rapporto dice: “Non riconosciamo l’unità "…" per ….”
- Perché conta: Senza un’unità nota il valore è ambiguo.
- Come risolverlo: Usa un codice UN/CEFACT Rec 20: ….
READING_UNIT_WRONG_KIND
Rifiutata. Il rapporto dice: “… non è un’unità di …, quindi non si può usare per ….”
- Perché conta: Il valore verrebbe convertito in qualcosa di insensato.
- Come risolverlo: Usa una di queste unità: ….
READING_OUT_OF_RANGE
Rifiutata. Il rapporto dice: “… … … è fuori da ciò che un dispositivo può misurare (da … a …).”
- Perché conta: È un guasto del sensore o della mappatura, non una misura.
- Come risolverlo: Controlla la sonda, l’unità e la mappatura.
READING_OUTSIDE_AGREED_RANGE
Nota. Il rapporto dice: “… … è fuori dall’intervallo concordato …–….”
- Perché conta: È un’escursione: compare nel grafico e viene raggruppata in episodi.
- Come risolverlo: Non c’è nulla da correggere nei dati.
READING_PRECISION_EXCESS
Avviso. Il rapporto dice: “… ha più decimali di quelli che conserviamo; è stato arrotondato a ….”
- Perché conta: Si conserva la precisione stabilita dal profilo.
- Come risolverlo: Niente da fare, oppure arrotonda all’origine.
READING_TIME_MISSING
Rifiutata. Il rapporto dice: “Manca l’ora della misura.”
- Perché conta: Una lettura senza ora non si può collocare.
- Come risolverlo: Invia l’ora in cui il dispositivo ha misurato, non l’ora di caricamento.
READING_TIME_NO_ZONE
Rifiutata. Il rapporto dice: “L’ora della misura … non ha un fuso orario.”
- Perché conta: La stessa ora può differire di ore tra un fuso e l’altro.
- Come risolverlo: Aggiungi uno scostamento (Z o -03:00), oppure imposta il fuso nel modello del file.
READING_TIME_IN_FUTURE
Rifiutata. Il rapporto dice: “L’ora della misura è … min nel futuro.”
- Perché conta: L’orologio del dispositivo o il fuso orario è sbagliato.
- Come risolverlo: Correggi l’orologio del dispositivo o il fuso orario.
READING_TIME_TOO_OLD
Rifiutata. Il rapporto dice: “L’ora della misura risale a più di 7 giorni fa.”
- Perché conta: I dati in ritardo non si possono aggiungere onestamente al registro entro il suo termine.
- Come risolverlo: Carica invece il file del logger nella consegna; accetta dati più vecchi ed è segnato come "Dichiarato dalla tua azienda".
READING_TIME_OUTSIDE_DELIVERY
Avviso. Il rapporto dice: “Questa lettura è precedente al ritiro o successiva alla chiusura della consegna ….”
- Perché conta: Potrebbe appartenere a un altro viaggio.
- Come risolverlo: Controlla l’assegnazione del dispositivo; le posizioni fuori da questo periodo non vengono salvate.
READING_DUPLICATE
Nota. Il rapporto dice: “Già registrata; non viene salvata due volte.”
- Perché conta: Tentativi ripetuti e reinvii sono normali.
- Come risolverlo: Non c’è nulla da correggere.
READING_CONFLICT
Rifiutata. Il rapporto dice: “Per questo dispositivo e quest’ora è già stato registrato un valore diverso.”
- Perché conta: Due valori per lo stesso momento indicano un guasto della mappatura o del dispositivo.
- Come risolverlo: Controlla l’ID del dispositivo e il numero di sequenza; resta il primo valore.
READING_OUT_OF_ORDER
Nota. Il rapporto dice: “Arrivata dopo letture successive; collocata in base alla sua ora.”
- Perché conta: I dati in memoria tampone spesso arrivano in ritardo.
- Come risolverlo: Non c’è nulla da correggere.
READING_DELIVERY_UNKNOWN
Rifiutata. Il rapporto dice: “Non siamo riusciti ad abbinare questa lettura a una consegna.”
- Perché conta: Ogni lettura appartiene a una consegna.
- Come risolverlo: Invia il riferimento della consegna, il documento di trasporto, il numero del container o un dispositivo assegnato.
READING_DELIVERY_CLOSED
Rifiutata. Il rapporto dice: “La consegna … è chiusa; non accetta più letture.”
- Perché conta: Il fascicolo è chiuso.
- Come risolverlo: Allega invece il file alla consegna come documento.
READING_DEVICE_UNKNOWN
Avviso. Il rapporto dice: “Il dispositivo … non è registrato; registrato come segnalato da ….”
- Perché conta: Un dispositivo sconosciuto riduce la fiducia nei dati.
- Come risolverlo: Registra il dispositivo in Impostazioni, Integrazioni, Letture, alla voce Fonti di letture.
READING_DEVICE_NOT_ASSIGNED
Rifiutata. Il rapporto dice: “Il dispositivo … è assegnato alla consegna …, non alla ….”
- Perché conta: Così non si mescolano due viaggi.
- Come risolverlo: Cambia l’assegnazione del dispositivo o il riferimento della consegna.
READING_POSITION_INVALID
Rifiutata. Il rapporto dice: “Questa posizione non è valida (…, …).”
- Perché conta: Una posizione 0, 0 o valori scambiati sono un errore comune.
- Come risolverlo: Invia prima la latitudine, in gradi (WGS-84).
READING_ACCURACY_LOW
Avviso. Il rapporto dice: “La precisione della posizione è di … m, troppo bassa per verificare gli arrivi.”
- Perché conta: La verifica degli arrivi per area richiede … m o meglio.
- Come risolverlo: Preferisci le posizioni satellitari (GNSS) a quelle delle celle telefoniche.
READING_PERSONAL_DATA_DROPPED
Avviso. Il rapporto dice: “… riguarda l’autista e non è stato salvato.”
- Perché conta: Velocità, nome dell’autista e ore di guida non vengono mai conservati.
- Come risolverlo: Smetti di inviarlo.
READING_BATTERY_LOW
Nota. Il rapporto dice: “Batteria al … %.”
- Perché conta: L’invio dei dati potrebbe fermarsi a metà viaggio.
- Come risolverlo: Ricarica o sostituisci la batteria prima del prossimo viaggio.
READING_GAP
Avviso. Il rapporto dice: “Nessuna lettura da … per … (attese ogni …).”
- Perché conta: Un’interruzione non spiegata indebolisce il registro della catena del freddo.
- Come risolverlo: Controlla la copertura; i dati in memoria possono arrivare ancora entro 7 giorni.
READING_CLOCK_SKEW
Avviso. Il rapporto dice: “L’orologio di … sembra sfasato di … min.”
- Perché conta: Gli orari potrebbero essere spostati.
- Come risolverlo: Sincronizza l’orologio del dispositivo (ora NTP o GNSS).
READING_LATE
Nota. Il rapporto dice: “Le letture arrivano in media … min dopo la misura.”
- Perché conta: Gli avvisi arrivano in ritardo.
- Come risolverlo: Riduci l’intervallo di invio se gli avvisi sono importanti.
READING_BATCH_TOO_LARGE
Rifiutata. Il rapporto dice: “Questa richiesta ha … letture; il limite è ….”
- Perché conta: Il limite garantisce un trattamento equo per tutti i mittenti.
- Come risolverlo: Dividi l'invio in richieste più piccole.
READING_FORMAT_INVALID
Rifiutata. Il rapporto dice: “Questo non è … valido: ….”
- Perché conta: Non è stato possibile leggere nulla.
- Come risolverlo: Confronta il file o il corpo con l’esempio della guida.
READING_EPCIS_UNSUPPORTED
Avviso. Il rapporto dice: “Le regole delle letture non leggono EPCIS …, che è stato ignorato.”
- Perché conta: Solo i dati dei sensori di un evento EPCIS contano come letture.
- Come risolverlo: Usa il percorso di acquisizione EPCIS per gli altri eventi.
READING_COLUMN_UNMAPPED
Rifiutata. Il rapporto dice: “La colonna "…" serve per … ma non è mappata.”
- Perché conta: Il campo obbligatorio mancherebbe in ogni riga.
- Come risolverlo: Mappa la colonna nel modello del file.
READING_ROW_MALFORMED
Rifiutata. Il rapporto dice: “Impossibile leggere la riga …: ….”
- Perché conta: Una riga errata non blocca le altre.
- Come risolverlo: Correggi o elimina la riga.
READING_RATE_LIMITED
Rifiutata. Il rapporto dice: “Troppe letture da …; riprova tra … s.”
- Perché conta: Il limite protegge il servizio di ricezione.
- Come risolverlo: Rallenta; da parte nostra non si è perso nulla.
READING_PDF_LAYOUT_UNKNOWN
Avviso. Il rapporto dice: “Non siamo riusciti a leggere questo rapporto, quindi non è stato salvato nulla.”
- Perché conta: Non conosciamo il layout di questo PDF e non indoviniamo mai valori da un rapporto.
- Come risolverlo: Invia invece l’esportazione CSV del logger, oppure chiedici di aggiungere questo layout di rapporto.