Report
Come generare report PDF con i dati delle tue collezioni.
Cos'e un report
Un report e un documento PDF generato automaticamente a partire da blocchi di contenuto strutturato. I report possono includere dati dalle tue collezioni, branding aziendale e diversi tipi di contenuto.
I report possono essere generati dalla dashboard, dall'API oppure da un agente WhatsApp/email tramite lo strumento generate_report.
Creare un report dalla dashboard
Il modulo di creazione include:
- Titolo — Campo di testo per il titolo del report.
- Branding — Configurazione del marchio aziendale (vedi sezione sotto).
- Blocchi — Costruttore di blocchi di contenuto dove aggiungi intestazioni, testi, tabelle e coppie chiave-valore.
Tipi di blocchi
Un report e composto da blocchi ordinati:
| Tipo | Descrizione |
|---|---|
| heading | Titolo o sottotitolo (livello 1 o 2) |
| text | Testo su una riga |
| paragraph | Testo lungo con interruzioni di riga |
| table | Tabella con intestazioni e righe |
| key_value | Coppie chiave-valore (es: "Cliente: Giovanni", "Data: 2024-03-15") |
Esempio di tabella
{
"type": "table",
"headers": ["Apparecchiatura", "Seriale", "Stato"],
"rows": [
["Laptop HP", "ABC-123", "Attivo"],
["Monitor Dell", "DEF-456", "In riparazione"]
]
}Esempio di chiave-valore
{
"type": "key_value",
"items": [
{"label": "Cliente", "value": "Giovanni Rossi"},
{"label": "Data", "value": "15 marzo 2024"},
{"label": "Stato", "value": "Approvato"}
]
}Branding aziendale
I report supportano branding personalizzato:
| Opzione | Descrizione |
|---|---|
| Nome dell'azienda | Appare nell'intestazione |
| URL del logo | URL dell'immagine PNG/JPG che appare nell'intestazione |
| Righe di intestazione | Testo aggiuntivo accanto al logo (es: divisione, telefono) |
| Testo a destra | Testo allineato a destra nell'intestazione (es: "Riservato") |
| Testo a pie di pagina | Appare nel pie di pagina insieme a data e numero di pagina |
Dati automatici dalle collezioni
Un report puo includere dati direttamente da una collezione:
- Specifica l'ID della collezione come fonte dati.
- Facoltativamente, aggiungi una query di ricerca per filtrare i record.
- I record trovati vengono inseriti automaticamente in una tabella del report.
Visualizzare i report generati
Vai su Dati > Report per consultare lo storico dei report generati. Ogni report mostra:
- Titolo del report
- Data di creazione
- Pagine — Numero di pagine del PDF
- Dimensione — Dimensione del file
- Scarica — Pulsante per scaricare il PDF
Generare con gli agenti
Quando configuri l'azione generate_report in uno strumento, i tuoi agenti possono generare report durante una conversazione. L'agente:
- Raccoglie le informazioni dall'utente (titolo, tipo di dati).
- Applica il branding e la struttura configurati come valori predefiniti.
- Genera il PDF e lo consegna all'utente.