File

I valori che un altro programma scrive in un file di una cartella locale o di rete (il CSV di una macchina di prova, il registro di un datalogger, un risultato in JSON o XML) letti come tag, e righe o file interi scritti per un altro programma: le schede Cartella e file, Testo del file e Scrittura, cosa legge un tag in ogni formato, la cartella di arrivo, la scansione che propone un tag per colonna o per campo, tre esempi completi e cosa il driver non fa.

Il driver File legge i valori che un altro programma scrive in un file: il CSV a cui una macchina di prova aggiunge una riga dopo ogni campione, il registro di un datalogger, un file di risultato in JSON o XML, un file di testo che contiene solo un codice di lotto. Ogni tag legge un valore del file, e i suoi valori arrivano dove arrivano quelli di ogni altro tag: in Logic, sulle dashboard, nelle prove di un banco di collaudo di Process. Dove il dispositivo lo consente, il driver scrive anche per un altro programma: una riga aggiunta a un file, oppure un file intero sostituito.

La lettura è l'uso principale, e chiede tre risposte: la cartella, il file e il suo formato. Il modo in cui si legge il testo del file (la codifica, il separatore di colonna, il separatore decimale) viene letto dal file stesso finché resta su rilevare, la scansione propone un tag per colonna o per campo, e ogni tag nasce in sola lettura. Ciò che riguarda la scrittura compare solo dopo che la scrittura è stata attivata per il dispositivo.

Un dispositivo di questo driver è una cartella e il file che vi legge: due file della stessa cartella sono due dispositivi. La cartella è un'unità e una cartella (C:\TestMachine\Logs) oppure una condivisione di rete e una cartella al suo interno (\\lab-pc\results), e la stazione la raggiunge con i permessi Windows dell'account con cui gira. I dispositivi stanno sotto il driver e possono essere archiviati in cartelle, Driver → Cartella → Dispositivo → Tag, come sotto ogni driver senza linea seriale né broker.

La pagina del driver

La riga sotto l'intestazione dice « Ogni dispositivo legge un file, oppure i file che arrivano in una cartella. Aggiungere un dispositivo, inserire la cartella, il file e il formato, poi scansionarlo per aggiungerne i valori come tag. » Per Configurare il connector, la pagina porta la scheda Ambito della scansione propria del driver, con il file che la scansione legge (vedi Rilevamento). Sotto si trova la tabella Dispositivi di ogni driver (vedi La tabella dei dispositivi), che cresce con Aggiungi dispositivo, a destra del suo titolo; vuota, dice « Nessun dispositivo. » La barra del driver porta Rileva, in grigio finché la scheda Ambito della scansione non è completa. Il driver sta sotto File e database, la categoria che si trova tra Web e API e Prove in ogni elenco di driver.

Dispositivo

Un dispositivo di questo driver non ha la scheda Connessione: al suo posto c'è la scheda Cartella e file, seguita dalla scheda Testo del file e, su un dispositivo che legge un solo file, dalla scheda Scrittura. L'Intervallo di interrogazione (ms) della scheda Dispositivo, 1000 per impostazione predefinita, dice ogni quanto i tag leggono il file, e ogni tag può sostituirlo come in ogni driver.

Un dispositivo nuovo non ha una cartella: dice « Cartella non ancora inserita », la sua pagina dice « La stazione non legge questo dispositivo finché non ha una cartella, quindi non ne viene ancora letto nulla e non c'è alcun errore da mostrare. Inserire la cartella nella scheda Cartella e file qui sotto e la stazione inizia a leggerlo. » e non viene letto nulla finché la cartella non è inserita. L'URI di base che mostra l'intestazione è l'indirizzo di esecuzione, con la cartella e il nome scritti in forma di URI, e dopo di loro ciò che non è su rilevare: file://single?folder=C%3A%5CTestMachine%5CLogs&name=Log_%7Byyyy-MM-dd%7D.csv&format=delimited, oppure file://inbox?... per una cartella di arrivo.

La scheda Cartella e file

Un nome con una parte di data si scrive tra parentesi graffe con un formato .NET di data e ora, sull'orologio della stazione: Log_{yyyy-MM-dd}.csv è Log_2026-10-03.csv oggi e il file del giorno dopo passata la mezzanotte, e Data_{yyyy-MM}.txt cambia ogni mese. Sotto la casella, la scheda mostra quale file è adesso: « Oggi: Log_2026-10-03.csv ». Le parentesi graffe raddoppiate {{ e }} sono parentesi del nome. Una parte di data non scrive mai i due punti, che nessun nome di file ammette: {HH-mm}, non {HH:mm}.

Quando il dispositivo è in funzione, la scheda dice quale file legge:

Un'impostazione che la scheda non può accettare viene indicata sotto le schede, e il dispositivo non viene salvato finché non è corretta:

Il salvataggio rispetta le stesse regole, e il registro delle azioni lo dice quando ne rifiuta una: « Il dispositivo 'Tensile tester' ha un'impostazione di file che il suo driver non può usare. Aprirlo e correggere il campo che il pannello segnala. »

La scheda Testo del file

Come si leggono i caratteri, le colonne e i numeri del file. Ogni impostazione parte da Rilevare dal file, e il driver la legge dal file in uso. Sotto un'impostazione lasciata così, dopo che il dispositivo ha letto il file, una riga dice cosa ha trovato, come « Trovato nel file: UTF-8 ». Ogni impostazione si può fissare scegliendola, per un file le cui prime righe non lo dicono.

La scheda Scrittura

Un dispositivo che legge un solo file porta la scheda Scrittura; una cartella di arrivo viene solo letta e non ce l'ha.

La scrittura si disattiva solo quando nessun tag del dispositivo scrive più. Finché qualche tag scrive, l'interruttore resta disegnato e in grigio, e dice perché: « 2 tag di questo dispositivo scrivono nel file. Impostarli in sola lettura prima di disattivare la scrittura. » (« Un tag di questo dispositivo scrive nel file. Impostarlo in sola lettura prima di disattivare la scrittura. » per uno solo).

Online, in attesa e offline

Indirizzamento del tag

Cosa legge un tag

Un tag di questo driver non ha una casella di indirizzo propria: la sua scheda Sorgente chiede cosa legge e, per un valore, dove si trova il valore nel formato del dispositivo.

Un tipo con cui la sorgente non si legge viene rifiutato con quelli con cui si legge: « Scegliere uno dei tipi di dato con cui questo si legge: Int64. » Scegliere un'altra sorgente porta il suo tipo. Il testo preso da un file si legge nel tipo del tag come il driver Generic serial and TCP legge un messaggio, con il separatore decimale del file: un Boolean legge 1, true, on o yes e 0, false, off o no, un intero legge un numero intero, e uno String prende i caratteri come sono, così un codice come 0412 mantiene lo zero iniziale solo come String.

Ogni tag nasce in Sola lettura, e su un dispositivo che non consente la scrittura il campo Accesso non offre altro. Quando il dispositivo consente la scrittura, un tag che legge Valore o File intero può essere in Lettura e scrittura o in Sola scrittura, e un tag che legge Nome del file in Lettura e scrittura; i dati del file (esistenza, dimensione, ultima modifica, numero di righe) non si scrivono mai: « Un dato del file non si può scrivere. Lasciare il tag in sola lettura. »

CSV e testo a colonne

Un campo tra virgolette doppie può contenere il separatore; un campo che contiene un a capo non viene letto. Un tag i cui campi non possono funzionare non viene salvato, e la sua pagina dice cosa manca:

La riga in sola lettura Indirizzo di origine (bus) mostra cosa riceve il driver: column?name=Force per il Force dell'ultima riga, column?number=3&row=number&rowNumber=5 per la terza colonna della quinta riga, column?name=Force&row=match&key=Sample&equals=0412 per la riga del campione 0412.

Testo libero

Posizioni e campi si contano da 1, un pattern è un'espressione regolare .NET con esattamente un gruppo di cattura attorno al valore, e una riga che richiede più di 250 ms per essere letta non viene letta. I rifiuti sono quelli del driver generico stesso, come « Indicare il primo carattere del valore, contando da 1. » o « Il pattern deve avere esattamente un gruppo di cattura, attorno al valore. » L'indirizzo di bus si scrive line seguito da ciò che si applica, per esempio line?row=match&contains=Result&extract=regex&pattern=....

JSON e XML

Un numero JSON, true o false si prende così com'è, e una stringa si legge nel tipo del tag; un oggetto o una lista si leggono solo come String, il loro JSON. Un documento JSON o XML si legge intero quando è cambiato, al massimo 4 MiB, e non viene letta alcuna DTD. L'indirizzo di bus è json?path=result.force o xml?path=Result%2FForce.

Lettura

A ogni lettura il driver chiede a Windows la dimensione e le date del file, il che funziona anche su una condivisione di rete, dove gli avvisi di modifica di Windows non funzionano, e apre il file solo quando una di esse è cambiata. Lo apre sempre condividendo lettura, scrittura ed eliminazione, così il programma che scrive il file non viene mai bloccato.

Ogni lettura è datata con l'ultima modifica del file, non con il momento in cui è stata fatta, così il registro della prova colloca un campione quando l'altro programma lo ha scritto.

La cartella di arrivo

Leggere da Cartella di arrivo serve per la macchina che scrive un file per campione (Test_0412.json, Test_0413.json...): ogni nuovo file che corrisponde al pattern viene letto una volta, in ordine di arrivo.

Non viene mai eliminato nulla: la sottocartella Processed cresce finché qualcuno non la svuota. In una cartella di arrivo non si scrive mai.

Scrittura

Su un dispositivo che legge un solo file e consente la scrittura, un tag che legge Valore o File intero e il cui accesso scrive dice cosa fa una scrittura:

{value:FORMAT} accetta un formato numerico .NET, {datetime:FORMAT} un formato .NET di data e ora, sull'orologio della stazione, yyyy-MM-dd HH:mm:ss quando non ne viene dato nessuno. Un numero si scrive con il separatore decimale del file, così lo stesso modello scrive 12,50 in un file che usa la virgola. Il modello di un tag Boolean può omettere {value}: scritto a vero, aggiunge la riga, come un comando. Un modello che il driver non riesce a riempire viene rifiutato sulla pagina del tag:

La cartella e le sottocartelle a cui punta un nome vengono create quando una scrittura ne ha bisogno, sempre all'interno della cartella del dispositivo.

Rilevamento

La scheda Ambito della scansione

Per Configurare il connector, la pagina del driver porta la sua scheda Ambito della scansione, sotto la riga « Legge un file e propone un tag per ogni colonna o campo che trova, e per i dati del file. Scegliere un dispositivo per leggerne il file, oppure scrivere una cartella, un file e un formato. »

Ciò che manca ancora all'ambito viene detto in rosso sotto la scheda, e Rileva resta in grigio finché non è completo:

Quando il dispositivo da scansionare ha una modifica che non si può salvare, la scansione non parte: « Il rilevamento non è partito perché non è stato possibile salvare la modifica del dispositivo da scansionare. »

Cosa offre la scansione

La scansione legge il file che un dispositivo di un solo file legge adesso, oppure il file più recente di una cartella di arrivo, che non sposta; un file che non c'è, una cartella che non si raggiunge e un documento che non si legge chiudono la scansione con il motivo. Propone un candidato, con i valori trovati come tag candidati, tutti in Sola lettura:

Una scansione offre al massimo 500 valori, colonne di un file CSV comprese. Una scansione interrotta lì lo dice nella riga che la chiude e sopra i suoi risultati: « La scansione di result.json si è fermata prima. Una scansione offre al massimo 500 valori: aggiungere gli altri come tag tramite la colonna, il percorso JSON o il percorso XML. »

Il candidato di un file scritto prende il nome del file (run per run.csv), oppure quello della cartella per un nome con una parte di data o una cartella di arrivo. Un candidato la cui cartella, il cui nome e il cui Leggere da un dispositivo del driver legge già (il dispositivo scansionato, o un altro uguale) è segnato Già configurato: la sua scheda elenca solo i valori che nessun tag di quel dispositivo legge ancora, spuntati, e Aggiungi i tag, prima di Apri, aggiunge quelli spuntati a quel dispositivo, in sola lettura. Il resto del comportamento della scansione è in Rilevamento.

La pagina stessa di un dispositivo fa lo stesso senza la pagina del suo driver: Rileva tag, nell'intestazione della sua scheda Tag, legge il file di quel dispositivo così com'è salvato e offre solo i valori per cui non ha ancora un tag (vedere Rilevare i tag di un dispositivo).

Esempio: il CSV giornaliero di una macchina di prova

Una macchina di trazione scrive un CSV al giorno in C:\TestMachine\Logs, chiamato Log_2026-10-03.csv, con una riga di intestazione Sample;Force;Elongation e una riga come 0412;12,5;3,1 dopo ogni campione. Leggerlo con il percorso semplice:

1. Nella pagina del driver, Aggiungi dispositivo; chiamarlo Tensile tester.
2. Nella scheda Cartella e file inserire Percorso della cartella C:\TestMachine\Logs e Nome del file Log_{yyyy-MM-dd}.csv; mantenere Un solo file e CSV e testo a colonne. La scheda mostra « Oggi: Log_2026-10-03.csv », e quando il dispositivo lo legge, « In lettura ora: Log_2026-10-03.csv ». Lasciare la scheda Testo del file su Rilevare dal file: trova il punto e virgola e la virgola decimale.
3. Nella pagina del driver, scegliere Tensile tester in File da scansionare e Rileva. Il candidato è Già configurato ed elenca Sample (String, che mantiene lo zero di 0412), Force ed Elongation (Double), e i dati del file. Aggiungi i tag.

Ogni tag legge l'ultima riga; Ultima modifica cambia a ogni nuovo campione, ed è così che un'azione di Logic sa che ne è arrivato uno. A mezzanotte il dispositivo passa al file del giorno dopo, e finché la macchina non lo scrive, i valori non hanno lettura e Il file esiste legge falso. Un agente fa lo stesso con gli strumenti:

device_upsert name="Tensile tester" driver=File fileFolder="C:\TestMachine\Logs" fileName="Log_{yyyy-MM-dd}.csv" fileFormat=Delimited
device_discover driver=File fileDevice="Tensile tester"
tag_upsert device="Tensile tester" name=Force address=Force opcUaType=Double
tag_upsert device="Tensile tester" name=Sample address=Sample opcUaType=String
tag_upsert device="Tensile tester" name="Last change" fileSource=Modified

Esempio: una cartella di arrivo di file di risultato JSON

Una cella di prova deposita un file di risultato per campione in C:\Results\Inbox, come Test_0413.json che contiene {"sample":"0413","result":{"force":12.5,"ok":true}}:

1. Aggiungi dispositivo; chiamarlo Results, Percorso della cartella C:\Results\Inbox, Leggere da Cartella di arrivo, File da leggere Test_*.json, Formato del file JSON.
2. Aggiungi tag Force, Percorso JSON result.force, Double; Aggiungi tag Pass, Percorso JSON result.ok, Boolean; Aggiungi tag Sample, Percorso JSON sample, String.
3. Aggiungi tag Source file, Legge Nome del file: mostra da quale file vengono i valori.

Ogni file viene letto una volta, dopo essere rimasto fermo 1 s senza che alcun programma lo tenga aperto per scriverlo, nell'ordine in cui i file sono arrivati; ognuno è una lettura a sé, datata con la data del file; quando ogni tag lo ha letto, passa in C:\Results\Inbox\Processed. Non viene eliminato nulla. Con gli strumenti:

device_upsert name=Results driver=File fileFolder="C:\Results\Inbox" fileName="Test_*.json" fileMode=Inbox fileFormat=Json
tag_upsert device=Results name=Force address=result.force opcUaType=Double
tag_upsert device=Results name=Pass address=result.ok opcUaType=Boolean
tag_upsert device=Results name=Sample address=sample opcUaType=String
tag_upsert device=Results name="Source file" fileSource=Name

Esempio: aggiungere una riga per un altro programma

Un altro programma legge D:\Records\run.csv, una riga al secondo con l'ora e la pressione:

1. Aggiungi dispositivo; chiamarlo Run log, Percorso della cartella D:\Records, Nome del file run.csv.
2. Nella scheda Scrittura attivare Consentire la scrittura e inserire Testo di intestazione Time;Pressure.
3. Aggiungi tag Line, Double, Accesso Sola scrittura, Una scrittura Aggiungere una riga, Modello di riga {datetime};{value:0.00}.

Scrivere 12.5 su Line aggiunge 2026-10-03 14:05:12;12.50, con la virgola dove il file ne usa già una o dove Separatore decimale dice Virgola decimale (12,5); un file che la scrittura crea riceve per primo Time;Pressure. Le scritture che si susseguono rapidamente vengono tutte mantenute, in ordine. Per scrivere un file per prova, aggiungere un tag File, Legge Nome del file, in Lettura e scrittura: Logic scrive il numero di serie seguito da .csv quando inizia una prova, e le righe vanno in quel file. Con gli strumenti:

device_upsert name="Run log" driver=File fileFolder="D:\Records" fileName=run.csv fileFormat=Delimited fileWrites=true fileHeaderText="Time;Pressure"
tag_upsert device="Run log" name=Line opcUaType=Double accessType=WriteOnly fileWriteMode=AppendLine fileLineTemplate="{datetime};{value:0.00}"
tag_upsert device="Run log" name=File fileSource=Name accessType=ReadAndWrite

Strumenti dell'agente

driver_capabilities descrive questo driver sotto file: il percorso semplice, ogni campo del dispositivo, la regola della cartella e il confinamento in essa, le forme del nome del file, i due modi di leggere, i formati con la grammatica di indirizzo di ciascuno, le sorgenti e i loro tipi, le impostazioni di testo, il comportamento di letture e scritture, il rilevamento e tre esempi completi. device_upsert driver=File accetta fileFolder, fileName, fileMode (SingleFile, il predefinito, o Inbox), fileFormat (Delimited, il predefinito, Text, Json o Xml), fileEncoding (Automatic, Utf8 o Windows1252), fileSeparator (Automatic, Semicolon, Comma o Tab), fileDecimal (Automatic, Point o Comma), fileHeaderRow (da 0 a 1000), fileWrites e, con la scrittura attiva, fileHeaderText e fileLineEnd (Automatic, CrLf o Lf); un dispositivo che restituisce porta file, con fileStatus, ciò che il driver in funzione ha trovato: il file in uso, se esiste, la codifica, i separatori e il fine riga che ha letto, e i file in attesa in una cartella di arrivo. tag_upsert accetta fileSource (Value, WholeFile, Exists, Size, Modified, Name o Lines), fileRow (Last, Number o Matching), fileRowNumber, fileKeyColumn, fileMatchText, fileWriteMode (AppendLine o ReplaceFile) e fileLineTemplate; la colonna o il percorso è l'address, un valore di testo libero prende valueExtraction, valueStart, valueLength, valueSeparator, valueField e valuePattern del driver generico, e un tag nuovo è in sola lettura e prende il tipo proprio della sorgente, salvo che opcUaType dica altro. device_discover driver=File legge fileDevice, il nome di un dispositivo del driver, oppure fileFolder, fileName, fileMode e fileFormat scritti per la scansione; i tag che mancano a un dispositivo configurato si aggiungono con tag_upsert. connector_browse restituisce fileFolder, fileName, fileMode e fileFormat di ogni dispositivo. Gli altri strumenti sono in Strumenti dell'agente.

Limiti da conoscere

• Le cartelle di lavoro di Excel non vengono lette: una cartella di lavoro si legge dopo che il suo programma l'ha salvata come CSV.
• Il driver non elimina mai un file. Una cartella di arrivo sposta ciò che ha letto in Processed, e solo il file temporaneo di una sostituzione fallita viene mai rimosso.
• « Il file più recente della cartella » non è un modo di leggere: perde i file che arrivano insieme e può mostrare i valori del campione precedente. Una macchina che scrive un file per campione si legge con una cartella di arrivo.
• Un valore non viene cambiato sul posto all'interno di un file (una cella di un CSV, un membro del JSON di un altro programma): una scrittura aggiunge una riga o sostituisce l'intero file, perché due programmi che scrivono lo stesso file possono perdere l'uno la modifica dell'altro.
• Una condivisione di rete si raggiunge con i permessi Windows dell'account con cui gira la stazione: il dispositivo non conserva né utente né password, quindi la condivisione deve far entrare quell'account (per leggere, e per scrivere e spostare su un dispositivo che scrive o una cartella di arrivo).
• Il driver non tocca mai nulla fuori dalla sua cartella: un nome che punta altrove viene rifiutato dove viene inserito e dove viene scritto.
• Il file viene guardato a ogni lettura: una modifica si vede alla lettura successiva, mai nell'istante in cui l'altro programma la scrive.
• Un campo CSV che contiene un a capo non viene letto, e un tag JSON, XML o di file intero legge al massimo 4 MiB.