Creare ricette e progetti di importazione
Configura un importatore CSV, verifica parsing e mappatura su file reali e salva la ricetta o il progetto per riusarlo.
Creare una ricetta CSV
- Apri Importer tools → Importer Builder… e scegli File → New recipe. In General scegli nome e Stable ID ripetibile. Documenta versione e descrizione e usa Filename matching regex per limitare i nomi. In Representative file scegli un file che rappresenti il layout effettivo. Leggi Contract per capire se il contratto può essere prodotto da una ricetta CSV.
- Nella scheda del parser indica delimitatore, posizione dell’intestazione, righe di preambolo e coda, prefisso dei commenti, encoding e segno decimale. Il count del preambolo riguarda le righe fisiche. Controlla cosa si ottiene se la sorgente usa un separatore differente dalla virgola decimale.
- In Mapping table usa Edit → Add mapping… per ogni colonna. I cinque campi sono Column, Variable, Unit, Scale, Offset. Il valore canonico è sorgente × Scale + Offset. Modifica, rimuovi o riordina la mappatura dal menu Edit. In Advanced text la forma equivalente è
column | Variable | unit | scale | offset. - Se l’acquisizione deve conservare una proprietà estratta da nome o intestazione, definisci Metadata key e una regex con primo gruppo di cattura. Usa un file campione con un valore distinguibile e controllalo dopo la pubblicazione.
Provare, salvare e riusare
Run → Preview source (bounded) elabora un campione. Test complete parser prova il parser sul file completo. Un errore tardivo può apparire solo nel secondo passaggio. Cancel request interrompe la richiesta corrente quando disponibile. Esamina lo stato della bozza e conferma che il risultato appartenga alle impostazioni attuali prima di salvare. Preview e Test non creano un Dataset.
File → Save salva la ricetta nel profilo. Duplicate chiede un nuovo ID, salva la copia con quell’identità e la apre per ulteriori modifiche. Usa Export definition… per produrre l’INI portabile. Import definition… registra la definizione nel profilo e la carica nell’editor. Se esiste già lo stesso ID, il Builder può rifiutare la sovrascrittura e mantenere la definizione corrente. Remove elimina una definizione salvata. Reload definition inventory ricarica l’elenco. Close chiude l’editor. Usa Recipe workflow and limits per l’aiuto dal menu.
Torna ad Acquisition, aggiorna l’elenco e seleziona la ricetta sotto Custom importers. Accoda il campione o usa Folder… con i nomi ammessi dalla regex. Importa, apri la tabella canonica e leggi il riferimento e l’hash della ricetta effettiva in Provenance. Se la ricetta è stata aggiornata dopo l’accodamento, ricontrolla la sorgente e aggiungila di nuovo dalla ricetta corrente prima di riprovare.
Aprire Acquisition Plugin Builder
File → New Acquisition plugin project… o Open Acquisition plugin project… apre un editor distinto per un progetto nativo. In Module metadata descrivi il modulo, in Format profiles i profili e in Registered sources le sorgenti del progetto. Conserva il progetto in una cartella di lavoro scrivibile. Validate verifica le dichiarazioni, Build richiede una toolchain compatibile, Test richiede un campione e un profilo, Export candidate è il percorso di esportazione di un candidato. Cancel è disponibile durante una richiesta compatibile. Un progetto candidato segue un percorso distinto dalla ricetta CSV salvata nel profilo.
Millivolt, virgola decimale e lotto nel nome
- Usa
serie-L17-misura.dat. La regex d’ammissione è^serie-L([0-9]+)-misura\.dat$. Imposta Metadata key sulottoe riusa la stessa regex in Filename capture regex per conservare17. - In Parsing imposta
semicolon, Header rows 1, Physical rows before header 1, Footer data rows 1, Comment prefix#, Python input encodingutf-8, Decimal conventioncomma. - In Advanced text usa
1 | time_s | s | 1 | 0e2 | voltage_V | V | 0.001 | 0.05su due righe separate. Tornando alla tabella rileggi i cinque campi. Il primo valore canonico è 125,0 × 0,001 + 0,05 = 0,175 V. La colonna 3 resta fuori dalla selezione. - Premi Preview source (bounded) e Test complete parser. Il file breve passa con quattro righe. Il file
serie-L18-misura.datha una cella invalida verso il fondo che impedisce il Test. La Preview mostra le prime dodici righe. Ripristina il file L17 e salva, poi seleziona la ricetta Misura didattica in millivolt in Acquisition. Importa con IDcalibrazione_csve controlla quattro righe, nomi, unità, lotto e configurazione effettiva.
Contract: KNOWN_COMPATIBLE indica un contratto tabellare riconosciuto. INCOMPATIBLE_TABLE indica un contratto noto ma estraneo a una tabella CSV. UNKNOWN_UNAVAILABLE indica un ID o un provider non disponibile. Correggi il campo prima di provare il parser. Il risultato CURRENT_CAPTURE identifica la bozza e la sorgente correnti alla cattura. Rilancia la richiesta se hai modificato le impostazioni dopo la cattura.
Nel progetto nativo minimo salvato senza profili, Validate si avvia e segnala che serve almeno un profilo reale. Build ed Export candidate restano indisponibili. Test segnala direttamente che va prima salvato un profilo. Registra i sorgenti nell’area Registered sources e controlla binding e presenza dei callback prima di riprovare.
Validate, Build, Test ed Export su un progetto reale
Usa Open Acquisition plugin project… su una copia scrivibile della directory source del modulo Scientific measurement presente nell’installazione. Apri Module metadata e controlla ID, versione e dipendenze. Format profiles presenta i cinque profili. Registered sources mostra file dichiarati, ruolo, dimensioni e binding. Per i callback è necessaria una relazione valida fra file C++ registrato e simboli di recognize, inspect e import. Una modifica invalida richiede revisione e salvataggio prima del Run.
- Usa Validate e attendi PASS. Dopo Build controlla BUILT.
- Apri Test, scegli
spettro-ir.csv, selezionaspectral_csve compila la semantica del capitolo Scientific measurement. Premi Run Test. Il test restituisce PASS e scarta gli output di prova. Il progetto conserva le proprie configurazioni salvate. - Export candidate restituisce CANDIDATE_EXPORTED e indica lo ZIP nel progetto. Il candidato non si aggiunge all’albero finché non segue il normale flusso di installazione.
Nel pannello ricette, modifica un campo descrittivo durante Test senza cambiare la sorgente. STALE_DRAFT · captured result only identifica l’esito per le impostazioni catturate all’avvio. Rilancia la prova per aggiornare il risultato. Durante una richiesta lunga Cancel request ferma il parser. La Sessione non riceve Dataset dalla prova o dal suo annullamento.
Per catturare dall’intestazione invece che dal nome, lascia vuota Filename capture regex, imposta Metadata key su header_token e Header capture regex su Time;(Millivolt);Reference. Il Test mostra importer_meta_header_token Millivolt nelle proprietà catturate.
Dati di esercizio
- serie-L17-misura.dat (ZIP da estrarre)
- serie-L18-misura.dat (ZIP da estrarre)
- ricetta-millivolt.ini (ZIP da estrarre)
Schermate del percorso
Apri una schermata per leggerla a grandezza originale.














Comandi e impostazioni
Area a riquadri
Scorrimento
Saved CSV recipes
Area a riquadri
Schede del Builder
Scorrimento
Stable ID
Display name
Version
Description
Filename matching regex
Dataset contract
(catalogo dinamico)· Le voci provengono dai contratti visibili nell’installazione. Controlla nome, condizioni e origine in Contracts… e l’eventuale opzione Other… nella vista di lavoro.