Skip to main content

Converti in XLSX

Converti in XLSX | Sybot Documentation

CONVERTI IN XLSX

Il Task Converti in XLSX esegue l'operazione inversa rispetto al task Converti in CSV: prende un file di dati in formato CSV e lo converte in un foglio di calcolo Excel (.xlsx). È particolarmente utile per generare report o file che devono essere facilmente consultabili, formattati e manipolabili da utenti finali con software come Microsoft Excel.

Configurazione​

La configurazione del Task richiede di specificare il file CSV di origine e il separatore che utilizza, oltre alla destinazione opzionale per il file Excel.

  • File to Import: In questo campo va inserito il percorso completo del file CSV da convertire. Può essere un valore statico o un parametro dinamico.
  • Input CSV Separator: Questo campo è cruciale per la corretta interpretazione del file di origine. Qui va inserito il carattere che il file CSV di input usa per separare i suoi valori.
  • Il valore di default è la virgola (,).
  • Se il file di origine usa un separatore diverso (es. il punto e virgola), è fondamentale impostarlo correttamente in questo campo. Un'impostazione errata causerà il fallimento della conversione o la generazione di un file Excel con tutti i dati scorrettamente raggruppati in un'unica colonna.
  • 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 Excel 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 XLSX 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.csv), il file XLSX 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 XLSX appena creato (es. /percorso/output/dati_convertiti.xlsx). 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 XLSX generato (es. dati_convertiti.xlsx).
  • 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.