PDF Generation: genera cataloghi PDF automatici dai dati prodotto
Prima di creare l'automazione, verifica che siano soddisfatte entrambe le condizioni:
Gli attributi dei prodotti sono configurati e i valori sono compilati per tutte le lingue che vuoi esportare. È inoltre importante avere già un Marker di Completeness applicato ai prodotti da includere nel catalogo PDF.
Con l'automazione PDF Generation (powered by Cloud2Print), THRON genera cataloghi PDF aggiornati direttamente dai dati prodotto presenti in piattaforma. Ogni modifica agli attributi o alle immagini si riflette automaticamente nel PDF all'esecuzione successiva — senza copia-incolla manuale.
Nota: Al momento l'automazione supporta la selezione dei prodotti esclusivamente tramite Marker. La selezione tramite filtri avanzati è in valutazione per future evoluzioni.
Non hai ancora un Marker? → Cosa sono e come configurare i Marker di Completeness
Crea l'automazione
- Vai in Impostazioni di Piattaforma → Flussi & Automazioni → Automazioni.
- Clicca su Nuova e seleziona PDF Generation (with Cloud2Print).
Questa scelta determina i passaggi di configurazione disponibili e imposta il formato di output su PDF.
Configura i metadati principali
| Parametro | Obbligatorio | Note |
|---|---|---|
| Nome | ✅ | Usa un nome logico e riconoscibile (es. Vendor Catalogue, Catalogo Tecnico IT) |
| Automation Owner | ✅ | L'utente selezionato viene impersonificato durante l'esecuzione: i suoi permessi si applicano a tutte le operazioni e risulta autore dei PDF generati |
Configura la destinazione
Definisci dove vengono salvati i PDF e come vengono collegati ai prodotti.
| Parametro | Obbligatorio | Note |
|---|---|---|
| Catalogue Destination Folder | ✅ | Cartella della Library in cui i PDF generati vengono archiviati |
| Catalogue Destination Media Attribute | ✅ | Attributo media del prodotto attraverso cui il PDF viene reso disponibile. Il catalogo non è solo archiviato: viene collegato dinamicamente ai prodotti tramite questo attributo |
Seleziona le lingue di esportazione
In Export to the following locales seleziona uno o più locale (es. it-IT, en-US, de-DE).
L'automazione genera un PDF distinto per ciascun locale, riflettendo i valori localizzati degli attributi prodotto.
Imposta il trigger di esecuzione
Scegli la frequenza di esecuzione dell'automazione:
- Every day
- Every week
- Every first of the month
Ad ogni esecuzione il sistema verifica se esistono variazioni che richiedono la generazione o l'aggiornamento del catalogo.
Configura la selezione dei prodotti
Selezione tramite Marker
In Products to be used seleziona il Marker da usare come criterio di inclusione. Puoi usare un solo Marker per automazione.
Imposta la condizione sul Marker (es. Marker ≥ 80%): solo i prodotti che soddisfano la soglia vengono inclusi nel catalogo.
Nota: La configurazione è locale-aware. Ogni locale viene validato separatamente. Se il Marker selezionato è presente anche nella seconda lingua da configurare, il campo viene precompilato automaticamente. Se il Marker non è configurato per un locale specifico, il sistema segnala un errore.
Genera il catalogo solo se tutti gli attributi sono compilati
Attiva l'opzione Generate catalogue only if all attributes are filled in per evitare la creazione di cataloghi con campi vuoti.
Nota: Questa opzione si attiva automaticamente se selezioni un Marker impostato al 100%.
Seleziona il template PDF
Scegli il template
Seleziona il template dalla libreria disponibile. Ogni template ha un'anteprima con i campi compilabili e il tipo di contenuto accettato (immagine, testo, ecc.).
Template disponibili di default: Product Tag, Tabular Datasheet, Technical Data Sheet, Spare Parts.
I template disponibili sono placeholder di riferimento, pensati per coprire i casi d'uso più comuni. Se hai esigenze di layout specifiche — struttura personalizzata, branding aziendale, sezioni dedicate — clicca su "Richiedi il tuo template custom": il team valuterà con te fattibilità e dettagli, e il template verrà inserito in un'automazione dedicata.
Mappa gli attributi al template
La mappatura associa ogni campo del template all'attributo THRON corrispondente. È un passaggio obbligatorio: senza mappatura il sistema non sa quale valore inserire in ciascun campo.
Regole di mappatura:
- Se l'attributo è localizzato, viene preso di default il valore nella lingua della configurazione locale.
- Se l'attributo è di tipo Media Gallery, specifica la posizione dell'asset all'interno della gallery (numero intero che indica il posizionamento).
- I campi lasciati vuoti nella mappatura vengono rimossi dal template: non è obbligatorio compilare tutti gli spazi.
⚠️ Attenzione: Se i prodotti e gli attributi non sono ancora mappati al template, il sistema mostra un messaggio di warning. Completa la mappatura prima di attivare l'automazione.
Come funziona l'esecuzione
Ad ogni run schedulata, il sistema verifica se ci sono variazioni che richiedono la rigenerazione:
- Aggiornamento attributi prodotto → qualsiasi modifica rispetto all'ultima esecuzione innesca la rigenerazione.
-
Aggiornamento immagini → il sistema controlla
last modifiedecontent ID; qualsiasi variazione comporta la rigenerazione. - Aggiunta nuovi prodotti → i prodotti che soddisfano i criteri vengono inclusi automaticamente.
- Versioning → in caso di modifiche rilevanti viene creata una nuova versione del PDF esistente, non un nuovo file separato. Il versioning è attivo dalla seconda generazione in poi.
Report di esecuzione
Al termine di ogni run, THRON genera automaticamente un report:
| Campo | Descrizione |
|---|---|
| Product ID | Identificativo del prodotto elaborato |
| Content ID | Lista dei content ID coinvolti, se presenti |
| Esito generazione |
OK o Error
|
| Motivo dell'errore | Dettaglio del fallimento |
Errori possibili: impossibile accedere al prodotto · impossibile recuperare tutti gli attributi (quando il toggle di generazione completa è attivo) · errore di generazione PDF ricevuto dal fornitore (Cloud2Print) · impossibile salvare il contenuto nella cartella di destinazione · impossibile associare l'asset alla media gallery.
Configurazione Consigliata
Se configuri l'automazione per la prima volta, usa questo preset come punto di partenza:
| Parametro | Valore consigliato | Perché |
|---|---|---|
| Trigger | Every first of the month | Catalogo aggiornato ogni mese senza esecuzioni ridondanti |
| Soglia Marker | ≥ 100% | Solo prodotti completi entrano nel catalogo |
| Generate only if all attributes filled | ON | Evita PDF con campi vuoti |
| Locale | Parti con 1 sola lingua | Testa il flusso end-to-end prima di aggiungere altri locale |
| Mappatura template | Compila solo i campi critici | Lascia vuoti i campi opzionali finché il flusso non è validato |