Errore durante il caricamento del file

L'utente del modulo carica un file, ma questo non viene ricevuto da onOffice — oppure il modulo si interrompe durante il caricamento. Ecco le cause più comuni.

1. File troppo grande

propform accetta file fino a 128 MB per singolo file — questo è il limite nginx lato server. I singoli file più grandi vengono respinti dal server prima ancora di arrivare a propform.

Se il tuo file è più grande:

• Comprimilo / ridimensionalo prima del caricamento
• In caso di più file di grandi dimensioni: suddividili in più operazioni di caricamento

2. L'utente API non dispone dei diritti di scrittura per i file

L'utente API di propform necessita dei diritti di scrittura per i file nel rispettivo modulo (indirizzo o immobile).

Soluzione: verificare i diritti API — vedi Diritti utente API onOffice.

3. La caratteristica del documento non esiste o è disattivata

Se nelle impostazioni dei campi hai selezionato una caratteristica del documento (solo per il caricamento di file relativi agli immobili), verifica in onOffice se questa caratteristica del documento esiste ancora ed è attiva.

Errore comune: hai rinominato o eliminato una caratteristica del documento in onOffice. propform salva l'ID e non è più in grado di associare l'attributo del documento rinominato.

Soluzione: modifica il campo di caricamento file in propform e seleziona nuovamente l'attributo del documento.

Caso speciale: l'attributo del documento e il caricamento multiplo sono incompatibili

Se hai assegnato un caratteristico del documento e il visitatore deve comunque caricare più file: ciò non è possibile a livello di API (1 caratteristico = 1 file).

Sintomi: Solo l'ultimo file caricato finisce in onOffice, gli altri vengono scartati in modo silenzioso.

Soluzioni:

• Creare più campi separati con caratteristiche diverse
• Attivare il raggruppamento in ZIP/PDF — tutti i file vengono uniti in un unico file che riceve la caratteristica
• Utilizzare un campo file senza caratteristica (in questo modo sono possibili un numero illimitato di caricamenti)

4. Per i caricamenti di immobili: manca il diritto „Commercializzazione (sito web)"

Se il file deve essere pubblicato su un sito web al momento dell'attivazione (ad es. un'immagine per una pagina di presentazione online), l'utente API necessita del diritto „Commercializzazione (sito web)".

5. Il raggruppamento in ZIP o PDF non va a buon fine

Se desideri unire più file in un unico file ZIP o PDF:

Raggruppamento in PDF — solo immagini e PDF

Il raggruppamento in PDF funziona solo con immagini (JPG, PNG, HEIC) e file PDF. Altri tipi di file (Word, Excel, ZIP, video) non possono essere raggruppati in un unico PDF.

Soluzione: Scegli l'aggregazione in ZIP (funziona con tutti i tipi di file) oppure carica i file singolarmente.

L'unione in PDF non riesce con i PDF protetti da password → ripiego automatico su ZIP

Se l'opzione "Unisci più file in un unico PDF" è attiva e uno dei file PDF caricati è protetto da password (ad es. certificati energetici Vonovia, alcuni PDF bancari), l'unione dei PDF fallisce. propform ricorre quindi automaticamente al raggruppamento in ZIP: il destinatario riceve un file ZIP invece del PDF previsto.

> 💡 Il fallback si attiva solo se l'opzione di unione è attiva. In caso di caricamento di un singolo file o di caricamento multiplo senza opzione di unione, il file viene elaborato normalmente.

Soluzioni alternative:

• Disattivare l'opzione nelle impostazioni del campo, se nella maggior parte dei casi è previsto un solo file (ad es. solo un PDF di certificato energetico)
• Decodificare il PDF in anticipo (ad es. tramite Adobe Acrobat "Rimuovi impostazioni di sicurezza") e ricaricarlo
• Accettare che, in caso di PDF di origine protetti, il risultato sia un file ZIP — nella maggior parte dei casi è comunque meglio che avere file singoli

Raggruppamento in ZIP

Funziona con tutti i tipi di file. Se comunque non funziona, verificare:

• I singoli file sono troppo grandi? (ognuno deve essere inferiore a 128 MB, altrimenti scatta il limite di nginx)
• Il nome del file contiene un carattere non valido? (Caratteri speciali come /, \, :, * non sono ammessi nei nomi dei file)

6. Immagini HEIC dall'iPhone

Le immagini dell'iPhone in formato HEIC vengono convertite automaticamente in JPEG da propform prima del caricamento su onOffice. Non devi fare nulla. Se ciò non dovesse funzionare, scrivici brevemente — molto raramente si verificano file HEIC difettosi.

7. iPhone: caricare più foto contemporaneamente

Sull'iPhone il campo di caricamento dei file presenta una trappola:

• "Scatta foto" → ti permette di scattare e caricare solo UNA foto
• "Libreria" → puoi selezionare più foto contemporaneamente

Soluzione alternativa per il caricamento di più foto dal cellulare:

1. Scatta prima le foto con la normale app della fotocamera (quante ne servono)
2. Passa poi al modulo → Caricamento file → seleziona "Libreria"
3. Toccare più foto → tutte finiscono nel campo

> ⚠️ Distinzione importante — campo di caricamento generico vs. campo file dalla maschera onOffice: > - Il campo generico „Carica file“ (campo superiore nella selezione dei moduli) consente il caricamento multiplo > - I campi file creati nella maschera indirizzi/immobili di onOffice (ad es. il campo "Certificato energetico") consentono solo UN file — si tratta di una limitazione dell'API di onOffice, non modificabile

8. Nomi file speciali

I nomi file molto lunghi o contenenti caratteri speciali insoliti possono causare problemi in onOffice. propform risolve automaticamente i casi tipici, ma caratteri molto esotici (ad es. caratteri arabi nel nome del file) possono causare problemi.

Soluzione: Definisci un nome file con macro nelle impostazioni del campo — ad es. Anfrage_Name_Vorname — in questo modo il nome del file verrà generato automaticamente in modo corretto.

9. Il file è stato caricato, ma non compare tramite l'API

Se al di fuori di propform inserisci direttamente i file in un campo file della maschera indirizzi/immobili di onOffice (manualmente, non tramite modulo), questi file non compaiono nella chiamata API GetEstateFiles / GetAddressFiles — propform non può quindi elaborarli ulteriormente né offrirli tramite il modulo di download.

Motivo: limitazione dell'API di onOffice — i file nei campi file della maschera non sono accessibili direttamente tramite l'API.

Soluzione alternativa: caricare sempre i file tramite il modulo propform — propform li inserisce prima nella scheda "File" e poi li inserisce nel campo file. In questo modo sono accessibili tramite API.

Se nulla funziona

Scrivici all'indirizzo hello@propform.io fornendo le seguenti informazioni:

• URL del modulo
• Data e ora
• Dimensione del file + tipo di file + nome del file
• Quale opzione di raggruppamento (se attiva)