📥 Campi di download
Con i campi di download puoi mettere a disposizione di chi compila il modulo dei file direttamente da onOffice per il download — ad esempio un contratto di locazione, la scheda informativa aggiornata, i verbali di consegna o la documentazione raccolta relativa al proprietario. Questo tipo di campo è l'equivalente del campo di caricamento file e può essere combinato con esso.
Contenuto
Casi d'uso
- Documenti dell'inquilino: il locatore clicca sul link → il modulo mostra tutti i documenti dell'inquilino (carta d'identità, buste paga) da scaricare
- Pagina di stato del proprietario: il proprietario apre il link → vede il PDF dell'esposizione attuale + il rapporto sulle attività
- Conferma della prenotazione: l'acquirente apre il link → può scaricare l'accordo di prenotazione firmato in formato PDF
- Download della bozza del contratto: il notaio/venditore apre il modulo → riceve la bozza aggiornata del contratto di compravendita
- Download in blocco: più file da una scheda vengono offerti in un unico file ZIP
## Configurazione del campo
- Editor dei moduli → Aggiungi campo → Tipo speciale "Scarica file"
- Assegnare un nome al campo (ad es. "Scarica bozza del contratto")
- Selezionare la fonte del file (vedi sezione successiva)
- Opzionale: configurare il selettore (più recente / più vecchio / tutti / filtrato)
- Opzionale: attivare "Nascondi campo se non viene trovato alcun file" — impedisce la visualizzazione di pulsanti vuoti
---
Fonti dei file
Per ogni campo di download, scegli da dove deve provenire il file:
| Fonte |
A cosa serve |
Dove trova propform il file? |
| Caratteristica del documento |
Flusso di lavoro standard per documentazione strutturata |
Scheda "File" dell'indirizzo / immobile, filtrata per caratteristica del documento |
| Modello di nome file |
Se non si desidera assegnare alcuna caratteristica |
Scheda "File", filtro "Il nome file contiene …" |
| Tipo di file (ad es. immagine di copertina) |
Tipo di file onOffice specifico |
Scheda "File", filtro per tipo di file onOffice |
| Tutti i file della scheda |
Intero contenuto della scheda come download in blocco |
Inventario completo della scheda file |
| Scheda informativa in PDF on-the-fly |
Scheda informativa sempre aggiornata |
propform richiede la scheda informativa tramite l'API di onOffice e la inoltra come download |
| URL fisso |
Link esterno (ad es. Condizioni generali sul proprio sito web) |
Inserimento di un URL statico nel campo |
> 💡 Combinare più fonti: "Caratteristica del documento E nome file contiene 2024" → fornisce solo la variante 2024 del documento selezionato.
Selettori: quale file?
Se più file corrispondono alla fonte (ad es. tre versioni di un contratto), decide il selettore:
| Selettore |
Fornisce |
| Più recente (impostazione predefinita) |
File con data di caricamento più recente |
| Più vecchio |
File con data di caricamento più vecchia |
| Tutti |
Tutti i file corrispondenti (vedi raggruppamento in ZIP sotto) |
Inoltre: Filtro "Il nome del file contiene la stringa" — ad es. solo file con "contratto" nel nome.
Multi-file → Raggruppamento in ZIP
Se il selettore restituisce più file:
- propform li raggruppa automaticamente in un file ZIP
- Il nome del file ZIP può essere configurato (con macro, ad es.
Unterlagen_<Vorname>_<Nachname>.zip)
- Sui browser mobili, il file ZIP viene scaricato come qualsiasi altro file (comportamento standard)
Ibrido: upload + download nello stesso campo
Un campo di upload file può essere dotato anche di una funzione di download — utile per flussi di lavoro del tipo "scarica il documento contrattuale, firmalo, ricaricalo".
Configurazione:
- Campo di caricamento file esistente → Impostazioni campo
- Impostare la modalità su "Modifica + Download" (anziché "Solo caricamento" o "Solo download")
- Sono disponibili entrambe le configurazioni di origine (destinazione di caricamento + origine di download)
Nel modulo l'utente vede:
- Pulsante di download per il file esistente
- Area di caricamento per un file nuovo/sostitutivo
Attività al momento del download
Opzionalmente, puoi creare un'attività in onOffice per ogni download — per audit trail e reporting:
- Configurabile come le altre attività (tipo di azione, tipo di operazione, testo personalizzato)
- Opzionale: registrare l'hash del file — dimostra che è stata scaricata esattamente questa versione del file
- Combinabile con "Attività al richiamo del modulo" (vedi Impostazioni del modulo) — in questo modo avrai sia "L'utente ha aperto il documento" che "L'utente ha scaricato il documento" nella cronologia
Limitazioni
Campi file della maschera onOffice
I file che si trovano nei campi file della maschera Indirizzi/Immobili (cioè direttamente nel record, non nella scheda "File") non sono accessibili tramite l'API di onOffice — vedi FAQ: L'upload del file non va a buon fine.
Conseguenza:
- Nel modulo Immobili: sono accessibili solo i file originariamente caricati tramite propform (con riferimento all'ID file)
- Nel modulo Indirizzi: sono accessibili tutti i file dalla scheda "File" (l'API è completa in questo caso)
Limite di dimensione dei file
- Per file: 128 MB (corrisponde al limite di caricamento, lato nginx)
- Pacchetti ZIP: nessun limite rigido, ma prestazioni lente in presenza di un numero molto elevato di file (>100)
Sicurezza
I campi di download dovrebbero sempre essere combinati con ulteriori meccanismi di protezione:
Correlati