Descrizione

Genera un file Excel (.xlsx) da un array di oggetti. Pipe da DB Query / Loop output, oppure passa una lista esplicita. Restituisce base64 (pronto per allegato email) o salva su disco.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`sheetName` Nome foglio	`expression`	no	`Sheet1` es. Ordini, Cedolini, RighiOrdine	Nome del foglio nel workbook generato. Default "Sheet1".
`dataExpression` Sorgente righe (opzionale)	`expression`	no	— {{$node.extract_of.json.lines}}	Espressione che ritorna l'array di oggetti riga (es. {{$node.NomeNodo.json.lines}}). Se vuoto, l'engine usa l'input del nodo precedente. Utile quando il nodo precedente NON è la sorgente dati (es. dopo db_insert_batch che ritorna solo {headerId}).
`groupByKey` Raggruppa per (multi-scheda)	`string`	no	— es. supplier_name	Nome del campo per cui raggruppare. Crea UNA SCHEDA Excel per ogni valore distinto. Esempio: groupByKey="supplier_name" → un foglio per fornitore. Lascia vuoto per un singolo foglio con tutte le righe.
`columns` Colonne (opzionale)	`string`	no	— data:Data:date_dmy,prezzo:Prezzo:eur_4,sconto:Sconto:percent_2	Sintassi "key:Label:formato,..." (formato è opzionale). Senza formato i valori vengono scritti come arrivano. Formati disponibili (mostrati con LOCALE ITALIANA): • text → testo grezzo (es. codici con zeri iniziali "001234") • integer → 1.234 • number_2 → 1.234,56 • number_4 → 1.234,5678 • eur_2 → 1.234,56 € • eur_4 → 1.234,5678 € • percent_2 → 10,00% • date_dmy → 23-05-2026 • datetime → 23-05-2026 14:30 Esempio Ordini Fornitori: "nr_ordine:NR.ORDINE:text,data:DATA:date_dmy,descr:DESCRIZIONE,qta:QTA:integer,prezzo:PREZZO UNITARIO:eur_4,sconto:SCONTO:percent_2,totale:TOTALE RIGA:eur_2". Il nodo: 1) coerce stringhe italiane "10,50" → numero 10.5; 2) auto-fit larghezza colonne; 3) header bold + sfondo grigio + prima riga frozen; 4) auto-filter su tutte le colonne. Federico-grade out of the box.
`freezeHeader` Blocca riga header durante scroll	`boolean`	no	`true`	Quando l'utente scrolla verso il basso, la riga header rimane visibile. Disabilita SOLO se serve compatibilità con un tool antiquato che non gestisce frozen panes.
`autoFilter` Aggiungi filtri colonna (frecce dropdown)	`boolean`	no	`true`	Aggiunge un menu a tendina su ogni colonna header per filtrare/ordinare. Standard in Excel/LibreOffice. Disabilita per export "scheda stampa" senza interazione.
`forceItalianStrings` Forza formato italiano universale (consigliato)	`boolean`	no	`true`	ON (default): i valori numerici (€, %, decimali) vengono scritti come STRINGHE già formattate in italiano (es. "1.234,56 €", "0,00%"). Funziona su QUALUNQUE viewer (Excel Android, Google Sheets, Numbers macOS, LibreOffice). Trade-off: perdi ordering/sum numerico Excel-side. OFF: usa numFmt con LCID [$-410]: il viewer deve riconoscere il LCID italiano (Excel Office IT ok, Numbers macOS no, Excel Android no). Lascia ON se il tuo cliente apre il file con Excel mobile, Google Sheets o Numbers.
`path` Salva su disco (opzionale)	`file-picker`	no	— es. output/{{$today}}/ordini.xlsx	Path nel sandbox del tenant dove salvare il file. Se vuoto, il file NON viene salvato — l'output ritorna come base64, ideale per allegato Send Email node.

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

path
base64
fileName
sheetName
rowsWritten
sizeBytes
contentType

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_xlsx_build-1",
  "defId": "action_xlsx_build",
  "label": "Excel: Build (array → xlsx)",
  "config": {
    "sheetName": "Sheet1",
    "freezeHeader": true,
    "autoFilter": true,
    "forceItalianStrings": true
  }
}

Excel: Build (array → xlsx)

Descrizione

⚙️ Parametri di configurazione

⬆️ Output del nodo

💡 Esempio configurazione

🔗 Nodi correlati nella stessa categoria

Pronto a usare Excel: Build (array → xlsx)?