propform è in grado di generare documenti PDF dopo l'invio del modulo — ad esempio documentazione antiriciclaggio, incarichi notarili, verbali di consegna, conferme di prenotazione — e di salvarli in onOffice, allegarli all'e-mail o entrambe le cose.
propform utilizza onOffice PDF Designer per la creazione di PDF. Al momento dell'invio, propform richiede a onOffice di eseguire il rendering del modello selezionato e salva il risultato nel record desiderato.
> ⚠️ Limitazione API importante: attualmente esiste solo la chiamata API PDFExposé, non PDFBrief. Anche i documenti antiriciclaggio, gli incarichi di emergenza ecc. vengono quindi creati come "Exposé", ma dal punto di vista del contenuto sono normali documenti PDF. Da anni propform ha richiesto a onOffice una chiamata API dedicata alle lettere, ma questa non è ancora stata implementata.
Il modello deve essere esplicitamente "attivato" — altrimenti l'utente API non potrà leggerlo:
Dimensioni del logo, margini, caratteri devono essere impostati singolarmente in ogni nuovo modello — il che è complicato. Crea un modello master con la tua configurazione standard (logo in alto, margini, caratteri) e copialo ogni volta, invece di crearne uno nuovo da zero.
Se il PDF visualizza i valori del modulo sotto forma di elenco, il testo continuo risulta subito sgradevole. Meglio: layout tabella.
Durante la configurazione dell'e-mail in propform → clicca su "Aggiungi campi del modulo come macro" nel corpo del messaggio → propform inserisce tutte le macro dei campi in sequenza nel corpo dell'e-mail.
Copia questo blocco (Ctrl+C) e incollalo nel modello PDF. In questo modo avrai già tutte le macro con l'ortografia corretta, risparmiandoti la ricerca manuale.
_xVertragspartner)Risultato: PDF pulito e leggibile con due colonne.
In Impostazioni modulo → "Crea e salva file" configuri:
| Impostazione | Cosa |
|---|---|
| Modello PDF | seleziona dal menu a tendina dei modelli di onOffice |
| Posizione di salvataggio | Indirizzo o immobile (o entrambi) |
| Caratteristica del documento | opzionale — ad es. "Documento antiriciclaggio", "Prenotazione", "Verbale di consegna" |
| Nome file | Testo in chiaro con macro, ad es. Geldwaesche_Doku_<_Vorname>_<_Name> |
| Protezione PDF | opzionale, impedisce la modifica successiva |
Nella configurazione e-mail → spuntare "Allega file inviati tramite modulo". Anche i file creati contano come "file inviati" e vengono allegati automaticamente.
> 💡 Flusso di lavoro: Invio → Il file viene creato in background (1-3 secondi) → Il file viene salvato nel record → L'e-mail viene inviata al destinatario con il file in allegato.
I campi/modelli vengono aggiornati ogni mattina. Se hai appena creato un nuovo modello in onOffice:
Per ulteriori informazioni su questo "trucco di aggiornamento", consulta I campi non vengono visualizzati.
Nei modelli PDF generati tramite invio e-mail, la risoluzione delle macro avviene sul destinatario dell'e-mail — non sul richiedente. Ciò comporta campi vuoti se il destinatario è un collega interno.
| Pre-macro | Significato ||
|---|---||
| _Kaeufer / _Buyer | accede all'acquirente collegato nel modulo |
| _Eigent / _Owner | accede al proprietario collegato nel modulo |
| _Mieter / _Renter | accede all'inquilino collegato nel modulo |
> ⚠️ Convenzioni di scrittura: la pre-macro e il nome del campo vanno scritti senza trattino in mezzo — quindi _KaeuferVorname, non _Kaeufer_Vorname.
Esempio nel PDF:
Käufer: _KaeuferVorname _KaeuferName
Anschrift: _KaeuferStrasse, _KaeuferPlz _KaeuferOrt
Eigentümer: _EigentVorname _EigentName
In questo modo vengono recuperati i dati corretti — indipendentemente dal destinatario dell'e-mail.
📖 Maggiori informazioni sui collegamenti agli indirizzi: Collegare più record e I valori non vengono trasferiti al PDF.
Se il PDF deve contenere firme, scansioni di documenti d'identità o altre immagini dai campi file, utilizza le macro di percorso file:
_dateipfadAdressfeld(unterschrift_kaeufer;400;variabel;mail;html)
Parametri (l'ordine è importante, separati da punto e virgola):
variabel (proporzionale)px o mmmail o htmlPer i campi dei file immobiliari: _dateipfadObjektfeld(...) con la stessa sintassi.
Per contratti notarili o verbali di consegna con più acquirenti/proprietari: utilizzare la macro percorso file all'interno del ciclo di indirizzi — un campo file separato per ogni acquirente:
Vertragspartner:
_buyerbrek_1_
- _BuyerVorname _BuyerName
Unterschrift: _ifEmpty(unterschrift_kaeufer;"";"_dateipfadAdressfeld(unterschrift_kaeufer;400;variabel;mail;html)")
_buyererek_1_
> 🔒 Avvolgere sempre _ifEmpty(...): se un acquirente non ha ancora firmato (campo file vuoto), la macro visualizzerebbe altrimenti un segnaposto. Con il wrapper _ifEmpty, lo spazio rimane semplicemente vuoto — il PDF appare ordinato.
Poiché un campo file memorizza solo un file, per il fronte e il retro del documento d'identità sono necessari due campi file separati (ad es. ausweis_vorne e ausweis_hinten). Nel PDF, inseriscili poi uno dopo l'altro — idealmente con una tabella e una larghezza di 600 px ciascuno.
Se il pulsante "Crea e salva file" è attivo, ma non è stato selezionato alcun modello: non succede nulla. Nessun messaggio di errore, nessun PDF.
Soluzione: selezionare sempre esplicitamente il modello. Se temporaneamente non si desidera un PDF, è preferibile disattivare il pulsante.
_Name, _Vorname, _Strasse)_objektart, _ort, _plz)Scrittura errata → il campo rimane vuoto nel PDF. Maggiori informazioni su I valori non vengono trasferiti al PDF.
Se il modello non compare nel menu a tendina in propform, verificare:
Maggiori informazioni in Il mio modulo non scrive dati punto 6.