sooksook-E-learning
L'integrazione non si limita ai dati testuali.
In un ambiente industriale o operativo, i dati da soli non sono sufficienti.
Ciò che costituisce il vero valore di un flusso è la sua capacità di esseregiustificato, provato e contestualizzato.
Per questo motivo il modulo deve consentire di associare al flusso XML un insieme diallegati, che rappresentano le prove sul campo.
Queste parti possono includere:
PDF (rapporti, autorizzazioni, verbali),
immagini (foto sul campo, anomalie, prima/dopo),
scansioni (documenti firmati, assegni),
moduli esportati,
report generati automaticamente,
documenti tecnici o normativi.
L’obiettivo è trasmettere non solole informazioni, ma ancheprove documentali associate.
Il modulo deve consentirecentralizzare tutti i documenti collegati ad un'azione sul campo o ad un oggetto aziendale.
Ogni intervento, relazione o scheda deve poter raggruppare:
le sue foto,
i suoi documenti,
le sue prove,
le sue esportazioni.
Questa centralizzazione consente:
per evitare la dispersione (email, file locali, WhatsApp, ecc.),
per garantire che tutto sia collegato all'oggetto corretto,
per semplificare la trasmissione ai sistemi target,
per creare una tracciabilità completa.
Pertanto, ogni flusso diventa afascicolo completo, e non una semplice riga di dati.
Gli allegati devono poter essereassociato direttamente al flusso XML generato.
Questa associazione può essere effettuata in diversi modi:
inserimento in un archivio (ZIP con file XML),
collegamento ai documenti archiviati,
codifica base64 (secondo i vincoli ERP),
trasmissione parallela tramite API o SFTP.
Il modulo deve gestire:
la corrispondenza tra l'XML e le sue parti,
identificazione univoca dei file,
coerenza tra il contenuto dell'XML e i documenti inviati.
Esempio :
un rapporto di intervento in formato XML dovrà essere accompagnato dal corrispondente PDF,
un'anomalia deve includere foto associate,
un permesso deve includere la sua versione firmata.
Ciò garantisce che il sistema di destinazione riceva un fileflusso arricchito e utilizzabile.
Il modulo deve supportare diversi formati di file, a seconda dell'utilizzo sul campo.
I formati principali includono:
PDF (documento standard),
JPEG / PNG (foto sul campo),
file scansionati,
esportazioni generate (moduli, report),
possibilmente documenti d'ufficio (Word, Excel).
È importante che il sistema:
riconosce i formati,
ne verifica la validità,
ne garantisce la leggibilità,
evita formati incompatibili con la destinazione.
Questa gestione garantisce che i documenti rimangano utilizzabili nel tempo.
Ogni allegato deve esseredenominati e strutturati in modo coerente e standardizzato.
Una buona denominazione consente:
per identificare rapidamente il contenuto,
per evitare duplicati,
facilitare la ricerca,
per garantire la compatibilità con sistemi esterni.
Il nome può includere:
identificatore dell'oggetto (ad esempio avviso, attrezzatura),
tipo di documento,
data,
versione,
autore o fonte.
Esempio :
SK_AVIS_1209961516_RAPPORT_2026-03-20.pdf
Il modulo deve gestire automaticamente queste convenzioni per evitare errori umani.
Come con XML, gli allegati devono esseretracciabile.
Il sistema deve sapere:
chi ha aggiunto il documento,
quando è stato aggiunto,
a quale oggetto è collegato,
se è stato modificato o sostituito,
se è stato trasmesso o meno.
Questa tracciabilità è essenziale per:
audit,
conformità normativa,
gestione delle controversie,
prova dell'intervento.
Ogni file diventa così unprova cronodatata e contestualizzata.
Il modulo deve essere in grado di farlocontrollare gli allegati prima che vengano inclusi o inviati.
I controlli possono includere:
presenza obbligatoria di determinati documenti,
dimensione massima,
formato autorizzato,
leggibilità del file,
coerenza con la tipologia di intervento.
Per esempio :
è necessario allegare un permesso,
una segnalazione senza foto può essere bloccata in base alle regole aziendali,
un documento corrotto dovrebbe essere rifiutato.
Questi controlli aiutano a prevenire l'invio di flussi incompleti o inutilizzabili.