Se ONLYOFFICE visualizza il messaggio "Download non riuscito" dopo l'esportazione di un documento in PDF, individua innanzitutto la causa del problema: la generazione del PDF, il trasferimento da ONLYOFFICE al dispositivo o il salvataggio finale da parte del browser. Un'esportazione riuscita dovrebbe produrre un PDF non vuoto che si apre correttamente e che conserva le interruzioni di pagina, le tabelle e i caratteri importanti. Esegui i controlli seguenti in ordine; ognuno di essi aiuta a individuare la causa del problema senza modificare il documento originale.
Inizia identificando la tua versione di ONLYOFFICE
Nell'editor di documenti online, il percorso documentato è File > Scarica come > PDF . "Salva copia con nome" salva una copia sul portale anziché scaricarla sul computer. Negli editor desktop, utilizzare File > Salva con nome e selezionare PDF. Le etichette e le opzioni disponibili variano a seconda dell'applicazione e della versione, quindi non dare per scontato che sia presente un menu online nell'applicazione desktop. Consultare le istruzioni di ONLYOFFICE per il download e la stampa dei documenti e la guida alla scheda File .
Se stai modificando un PDF esistente nell'editor PDF online, il relativo processo di download si trova anch'esso in File, ma si tratta di un editor diverso. Segui le istruzioni relative all'applicazione che hai attualmente aperta.
1. Proteggi le modifiche prima di procedere alla risoluzione dei problemi.
Prima di ripetere un'esportazione, salva il documento sorgente. Nell'editor online, usa Ctrl+S o File > Salva, se disponibile, e attendi che l'indicatore di salvataggio si stabilizzi. ONLYOFFICE salva automaticamente i documenti nel suo editor online, ma è comunque consigliabile verificare che le modifiche correnti siano state salvate prima di aggiornare o chiudere una sessione. Negli editor desktop, salva prima il file di lavoro normalmente.
Quindi, crea una copia del documento e prova a esportarlo da quella copia. In questo modo potrai effettuare un test in sicurezza senza rischiare di danneggiare l'originale. Evita di cliccare ripetutamente su Esporta mentre una richiesta è ancora in corso; i download sovrapposti possono rendere difficile capire quale file è stato scaricato correttamente.
2. Utilizzare un piccolo documento di prova per isolare l'errore
Crea un nuovo documento di una pagina con una breve riga di testo ed esportalo in formato PDF utilizzando la stessa app e lo stesso dispositivo. Verifica che il PDF compaia nell'elenco dei download del browser o nella cartella selezionata nella finestra di dialogo di salvataggio sul desktop e accertati che la dimensione del file sia maggiore di zero. Aprilo con un visualizzatore di PDF e verifica che il testo sia leggibile.
- Il PDF di prova funziona: il percorso di esportazione è disponibile. Il file originale potrebbe contenere contenuti o formattazione che causano un problema di conversione, oppure il suo download potrebbe essere insolitamente grande o lento. Procedi con una copia dell'originale e semplifica temporaneamente le immagini pesanti, gli oggetti incorporati o il layout complesso, una categoria alla volta.
- Il PDF di prova non funziona nemmeno nell'editor online: verifica i download del browser e prova il percorso alternativo indicato di seguito. Se il problema persiste su diversi browser o per diversi utenti, potrebbe essere necessario intervenire sul servizio online o sulla sua integrazione.
- Il PDF di prova funziona negli editor desktop ma non online: il problema è probabilmente legato al browser, alla sessione online, al portale o alla connessione al server dei documenti, piuttosto che all'esportazione in PDF in generale.
Questo confronto è un indizio diagnostico, non la prova di una singola causa principale. Tieni traccia dell'applicazione, del browser, dell'ora, delle dimensioni del documento e se l'errore interessa un singolo file o tutti i file.
3. Generazione separata del PDF dal download tramite browser
Nell'editor online, seleziona File > Scarica come > PDF una sola volta, quindi controlla il pannello dei download del browser. Se è presente un file, utilizza la funzione "Mostra nella cartella" o un'opzione equivalente del browser e verifica le sue dimensioni. Se il file si apre correttamente, significa che la generazione del PDF è andata a buon fine; il problema rimanente potrebbe risiedere nella posizione in cui il browser ha salvato il file o nel modo in cui ha gestito il download.
Se il download è bloccato, interrotto o mancante, controlla le notifiche di download del browser e lo spazio su disco disponibile nel sistema operativo. Se il tuo browser o la tua organizzazione bloccano i download dal sito, chiedi all'amministratore se il sito è autorizzato a scaricare file. Per una prova una tantum, utilizza un altro browser supportato sullo stesso dispositivo o un altro dispositivo con lo stesso account. Se funziona, concentrati sulle impostazioni di download, le estensioni, il software di sicurezza o lo spazio di archiviazione locale del primo browser, anziché modificare il documento.
La navigazione in incognito può aiutare a determinare se il problema è causato da un'estensione o da dati di siti web memorizzati, ma solo se è possibile accedere e aprire lo stesso documento in tale modalità. Non risolve gli errori di esportazione lato server e potrebbe non essere adatta per gli account gestiti. Non cancellare tutti i dati del browser come primo passaggio; ciò potrebbe comportare la disconnessione da servizi non correlati.
4. Prova un percorso alternativo e confronta il risultato
Per un documento nell'editor di documenti online, prova File > Salva copia con nome e scegli PDF se questo formato è disponibile. In questo modo viene salvata una copia sul portale; non viene testato lo stesso percorso di download dal browser al computer. Se la copia sul portale si apre, è probabile che l'esportazione abbia prodotto un PDF e che il problema più specifico risieda nel percorso di download diretto.
Puoi anche provare a stampare in PDF come soluzione temporanea. ONLYOFFICE documenta un'opzione di stampa e osserva che Firefox può stampare senza prima scaricare il PDF. Scegli una destinazione PDF nella finestra di dialogo di stampa se il tuo browser o sistema operativo lo prevede. Negli editor desktop, usa l'opzione PDF della finestra di dialogo di stampa, se disponibile. Confronta il numero di pagine, le interruzioni di pagina e qualsiasi contenuto vicino ai margini con l'originale.
La funzione "Stampa in PDF" non è identica all'esportazione. Può applicare impostazioni di layout di stampa, modificare la scala della pagina o omettere contenuti al di fuori dell'area stampabile. Utilizzala solo se il file risultante supera i tuoi controlli visivi, soprattutto per moduli, fogli di calcolo o documenti con impaginazione precisa.
5. Se utilizzi editor desktop, salva in un semplice percorso locale
In Desktop Editors, scegli File > Salva con nome, seleziona PDF e salva una copia in una cartella in cui hai i permessi di scrittura, ad esempio la cartella Documenti. Assegna un nome file breve utilizzando lettere e numeri comuni. Durante il primo test, non salvare direttamente in una condivisione di rete, in una cartella sincronizzata, in un'unità rimovibile o in una directory di sistema protetta. Se la copia locale funziona, riprova in seguito con la destinazione desiderata; questo confronto indica un problema di destinazione o di autorizzazioni.
Se la finestra di dialogo di salvataggio si completa ma non viene visualizzato alcun PDF utilizzabile, verificare che la cartella sia scrivibile e che disponga di spazio libero. Chiudere un visualizzatore di PDF che potrebbe aver bloccato il file di destinazione, scegliere un nuovo nome file e riprovare. Se solo un documento di origine non viene salvato correttamente mentre un test di base ha esito positivo, creare una copia di lavoro ed eseguire un test dopo aver rimosso o sostituito supporti di grandi dimensioni o danneggiati. Conservare l'originale senza modifiche fino a quando non si è verificata la copia.
6. Quando un amministratore dovrebbe ispezionare il server
Se tutti gli utenti riscontrano l'errore nell'editor online, o se sia il download diretto che la copia dal portale non riescono, comunica all'amministratore di ONLYOFFICE l'ora del tentativo, le dimensioni approssimative del documento interessato, il browser e la versione utilizzati e se anche un piccolo documento di prova presenta lo stesso problema. Per un'installazione integrata o self-hosted, l'amministratore dovrebbe controllare i log del Document Server e della piattaforma relativi a tale data e ora, verificare che l'editor e la piattaforma di archiviazione possano comunicare tra loro e analizzare le recenti modifiche al proxy o alla rete.
La guida alla risoluzione dei problemi di ONLYOFFICE associa alcuni errori dell'editor a token di sicurezza scaduti, sessioni interrotte o errori di salvataggio e consiglia agli amministratori di controllare i log di DocService e la raggiungibilità delle callback per individuare gli errori di salvataggio. Questi messaggi sono diagnostici correlati, non una spiegazione universale per ogni avviso "Download non riuscito". Se l'istanza si trova dietro un proxy inverso, verificare le intestazioni host e di protocollo inoltrate confrontandole con la guida di configurazione del proxy ONLYOFFICE corrente. Gli amministratori possono seguire le istruzioni di debug di ONLYOFFICE per raccogliere maggiori dettagli, quindi ripristinare il livello di registrazione normale dopo la diagnosi.
Non modificare i segreti JWT, non disabilitare l'autenticazione e non esporre pubblicamente il Document Server a scopo di test. Tali modifiche possono creare problemi di sicurezza e di integrazione, lasciando irrisolto l'errore di esportazione.
Come verificare che il problema sia stato risolto
Esporta un piccolo documento di prova, quindi la copia di lavoro dell'originale. Verifica che ogni PDF abbia una dimensione diversa da zero, si apra senza errori, abbia il numero di pagine previsto e conservi testo, tabelle, immagini e interruzioni di pagina importanti. Se hai utilizzato "Salva copia con nome" o "Stampa in PDF", verifica che il file si trovi nel portale o nella cartella locale previsti e confronta il suo layout con l'esportazione normale. Se solo una delle due opzioni funziona, segnala questa differenza all'amministratore; ciò indica la fase che necessita ancora di approfondimenti.
Riferimenti ufficiali