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

  1. 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.
  2. 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.
  3. 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.
  4. 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

  1. Usa serie-L17-misura.dat. La regex d’ammissione è ^serie-L([0-9]+)-misura\.dat$. Imposta Metadata key su lotto e riusa la stessa regex in Filename capture regex per conservare 17.
  2. In Parsing imposta semicolon, Header rows 1, Physical rows before header 1, Footer data rows 1, Comment prefix #, Python input encoding utf-8, Decimal convention comma.
  3. In Advanced text usa 1 | time_s | s | 1 | 0 e 2 | voltage_V | V | 0.001 | 0.05 su 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.
  4. Premi Preview source (bounded) e Test complete parser. Il file breve passa con quattro righe. Il file serie-L18-misura.dat ha 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 ID calibrazione_csv e 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.

  1. Usa Validate e attendi PASS. Dopo Build controlla BUILT.
  2. Apri Test, scegli spettro-ir.csv, seleziona spectral_csv e 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.
  3. 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

Fonti, licenze e SHA-256

Schermate del percorso

Apri una schermata per leggerla a grandezza originale.

Scheda General della ricetta con ID, regex, contratto e file di esempio.
Scheda General della ricetta con ID, regex, contratto e file di esempio.
Scheda Parsing con separatore, righe fisiche da escludere e convenzione decimale comma.
Scheda Parsing con separatore, righe fisiche da escludere e convenzione decimale comma.
Mapping table in Variables / Metadata, con nomi canonici e unità delle due colonne scelte.
Mapping table in Variables / Metadata, con nomi canonici e unità delle due colonne scelte.
Advanced text in Variables / Metadata, con fattori, offset e cattura del lotto dal nome del file.
Advanced text in Variables / Metadata, con fattori, offset e cattura del lotto dal nome del file.
Test complete parser sul file L17 valido. Il riepilogo riporta quattro righe.
Test complete parser sul file L17 valido. Il riepilogo riporta quattro righe.
Il Test completo sul file L18 segnala l’errore nel footer. Sopra resta visibile l’anteprima limitata alle prime righe.
Il Test completo sul file L18 segnala l’errore nel footer. Sopra resta visibile l’anteprima limitata alle prime righe.
Inventario delle definizioni con la ricetta didattica registrata.
Inventario delle definizioni con la ricetta didattica registrata.
Canonical table di calibrazione_csv dopo l’import con la ricetta. Le colonne espongono le unità e i valori trasformati.
Canonical table di calibrazione_csv dopo l’import con la ricetta. Le colonne espongono le unità e i valori trasformati.
Editor del progetto plugin nativo, scheda Module metadata e campi per le dichiarazioni.
Editor del progetto plugin nativo, scheda Module metadata e campi per le dichiarazioni.
Scheda dei profili per il progetto di misura scientifica.
Scheda dei profili per il progetto di misura scientifica.
Scheda dei sorgenti C++ associati al progetto di esempio.
Scheda dei sorgenti C++ associati al progetto di esempio.
Finestra Run Test con sorgente e configurazione scientifica temporanea.
Finestra Run Test con sorgente e configurazione scientifica temporanea.
Il Run Test del progetto scientifico riporta PASS. Questo test temporaneo non aggiunge un Dataset alla Sessione.
Il Run Test del progetto scientifico riporta PASS. Questo test temporaneo non aggiunge un Dataset alla Sessione.
La schermata distingue la cattura del parser dalla bozza modificata dopo la cattura.
La schermata distingue la cattura del parser dalla bozza modificata dopo la cattura.

Comandi e impostazioni

Barra dei menu

Apri i menu o usa le scorciatoie disposte dalla finestra per raggiungere il comando.

Area a riquadri

Trascina il divisore per dare più spazio all’elenco, ai campi o al risultato.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

Saved CSV recipes

Seleziona una ricetta salvata per riaprirne le impostazioni.

Area a riquadri

Trascina il divisore per dare più spazio all’elenco, ai campi o al risultato.

Schede del Builder

Usa General per identità, Parsing per lettura, Variables / Metadata per mappa e catture.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

Stable ID

Scegli un ID stabile per ritrovare la ricetta dopo il salvataggio. Evita di usare un ID di un’altra ricetta.

Display name

Scrivi il nome che vuoi vedere nell’albero Acquisition.

Version

Indica la versione della definizione per distinguere le revisioni condivise.

Description

Descrivi l’origine e la struttura attesa dei file.

Filename matching regex

Definisci il filtro dei nomi. Il comando Folder… usa questa regex.

Dataset contract

Controlla che il contratto sia compatibile con una tabella e leggi lo stato sotto il campo.
  • (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.

Representative file

Imposta il percorso del file concreto usato da Preview e Test.

Browse…

Apri il chooser per selezionare il file rappresentativo.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

Risultati della richiesta

Leggi campione, digest e diagnostica. Il piè di finestra mostra se il risultato appartiene alla bozza corrente.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

Scorrimento

Sposta la vista con la barra orizzontale o verticale disponibile per raggiungere campi, voci o testo fuori bordo.

New recipe

Apre una bozza nuova. Se il Builder chiede conferma valuta prima se salvare la precedente.

Save

Convalida e salva la definizione con il relativo ID. Dopo il salvataggio controlla la lista e la famiglia Custom importers.

Duplicate

Crea una bozza derivata. Assegna un nuovo ID prima di salvare.

Import definition…

Importa un INI portabile come bozza e verifica campi e contratto prima di salvare.

Export definition…

Scrive la definizione della ricetta come INI portabile.

Remove

Elimina una ricetta salvata dal profilo dopo l’eventuale richiesta di conferma.

Close

Chiude l’editor. Controlla la presenza di modifiche in bozza prima di chiudere.

Add mapping…

Aggiungi l’associazione da una colonna sorgente a una variabile e imposta unità, scala e offset.

Edit mapping…

Modifica l’associazione selezionata e controlla l’anteprima dei valori.

Remove mapping

Elimina la mappatura selezionata.

Move mapping up / Move mapping down

Cambia l’ordine delle variabili pubblicate.

Preview source (bounded)

Esegue una lettura limitata della sorgente campione e mostra righe e digest pertinenti al campione.

Test complete parser

Verifica l’intera sorgente rappresentativa e gli errori oltre il campione iniziale.

Cancel request

Interrompe l’elaborazione di Preview o Test quando c’è una richiesta attiva.

Reload definition inventory

Rilegge le ricette memorizzate e aggiorna la lista.

Recipe workflow and limits

Apre l’aiuto del contratto API delle ricette.

New Acquisition plugin project…

Crea un progetto nativo e mantiene il Builder delle ricette aperto.

Open Acquisition plugin project…

Apre un progetto nativo già preparato.

Validate

Controlla la coerenza dei metadati e dei profili del progetto.

Build

Avvia la compilazione del progetto con la toolchain abilitata.

Test

Esegue le prove del progetto su una sorgente di test del profilo scelto.

Export candidate

Esporta il candidato nelle condizioni ammesse dal progetto.