Skip to main content

Converti in CSV

Converti in CSV | Sybot Documentation

CONVERTI IN CSV

Il Task Converti in CSV ha lo scopo di convertire un file di dati strutturati, tipicamente un foglio di calcolo Excel (.xlsx), in un file di testo in formato CSV (Comma-Separated Values). Questa operazione è fondamentale per trasformare dati da un formato leggibile e formattato a un formato universale e facilmente elaborabile da altri sistemi automatici o Task successivi (come "CSV to Table").

Configurazione​

La configurazione del Task permette di specificare il file di origine, il separatore per l'output e, opzionalmente, la destinazione del file CSV generato.

  • File to Import: In questo campo va inserito il percorso completo del file da convertire (es. un file .xlsx). Può essere un valore statico o un parametro dinamico proveniente da un Task precedente o dai parametri del Workflow.
  • CSV Output Separator: Questo campo permette di specificare il carattere che verrà utilizzato per separare i valori nelle colonne del file CSV di output. È un'impostazione cruciale per garantire la compatibilità con il sistema che dovrà leggere il file.
  • Il valore di default è la virgola (,).
  • È possibile personalizzarlo con altri separatori comuni, come il punto e virgola (;) o il pipe (|).
  • File Path (Checkbox): Selezionando questa opzione è possibile specificare una destinazione personalizzata per il file di output, altrimenti verrà utilizzata una destinazione di default. Selezionandola, verranno mostrati i seguenti campi:
  • Path output: Qui va inserito il percorso della cartella in cui si desidera salvare il file CSV convertito.
  • Crea percorso se non esiste: Se attivata, crea automaticamente la cartella di destinazione se non esiste. Se disattivata, il Task andrà in errore se la cartella non è presente.

Destinazione di Default​

Il comportamento di default dipende da come viene fornito il file di origine:

  • Caso 1: Input tramite Parametro di tipo "File" Quando il file di origine viene passato tramite un parametro dinamico proveniente da un Task precedente o dai parametri del Workflow , il file CSV convertito viene salvato in una directory gestita dal sistema.
  • Caso 2: Input tramite Path Scritto Manualmente Quando nel campo "File da importare" si scrive direttamente il percorso completo di un file esistente (es. /dati/input/report.xlsx), il file CSV convertito viene salvato per default nella stessa directory del file di origine (quindi in /dati/input/).

Parametri di Output​

Una volta completata la conversione, il Task espone i seguenti parametri:

  • file: Restituisce il percorso completo del file CSV appena creato (es. /percorso/output/report.csv). Questo parametro è ideale per passare il file a Task successivi, come ad esempio un invio di email con allegato.
  • filename: Restituisce solo il nome del file CSV generato (es. report.csv).
  • result: Indica lo stato complessivo dell'operazione di conversione (es. "Success" o un messaggio di errore).
  • resultJson: Rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.