Salva prima il documento sorgente, quindi verifica se l'errore si verifica nella conversione PDF di ONLYOFFICE o nel download finale del browser. Se l'editor segnala un errore di conversione, controlla i log del server documenti e verifica che il server possa raggiungere il file sorgente. Se la conversione ha esito positivo ma il browser visualizza "Download non riuscito", controlla invece lo stato del download del browser, le autorizzazioni del sito e lo spazio su disco disponibile.
Scenario esemplificativo: Immaginiamo che Jordan, un amministratore che utilizza un editor ONLYOFFICE Docs self-hosted, selezioni File > Scarica come > PDF per un report di progetto. L'editor visualizza un errore e non viene generato alcun file PDF. Questo è un esempio ipotetico, non un caso verificato; lo stesso sintomo può manifestarsi in fasi diverse, pertanto i controlli seguenti si riferiscono al punto in cui il processo si interrompe.
Prima di procedere alla risoluzione dei problemi, utilizzare Salva o Ctrl+S per salvare le modifiche correnti. Nell'editor di documenti online, ONLYOFFICE documenta il percorso di esportazione in PDF come File > Scarica come > PDF. L'editor potrebbe prima preparare il PDF e poi inviare il risultato al browser, quindi un download non riuscito dal browser non significa necessariamente che la conversione stessa sia fallita.
Utilizza lo stesso report per effettuare un tentativo di ripetizione controllato. Verifica se l'editor visualizza una finestra di dialogo di errore, se il browser crea una voce di download non riuscito e se il problema riguarda solo questo file o tutti i file. Evita di fare clic ripetutamente su Esporta: i processi duplicati rendono più difficile associare un timestamp alla corrispondente voce del registro del server.
Apri la pagina Download del browser ed esamina l'elemento non scaricato. Riprova. Verifica se il browser ha bloccato i download dal sito ONLYOFFICE, se è presente una conferma di download in un'altra scheda e se l'unità di destinazione dispone di spazio libero sufficiente. Se gestisci il browser, prova lo stesso documento salvato in un browser alternativo attualmente in uso o in un profilo browser pulito. Se funziona, concentrati sulle impostazioni del browser, sulle estensioni o sul software di sicurezza locale; non modificare ancora la configurazione del server documenti.
Il caso ipotetico di Jordan indicherebbe un problema con il browser quando l'editor termina la preparazione del PDF ma l'elenco dei download segnala un errore di rete o di autorizzazione. Una soluzione alternativa pratica è utilizzare File > Stampa e scegliere l'opzione "Salva in PDF" del browser o del sistema operativo, se disponibile. Verificare le pagine, i caratteri e i collegamenti risultanti, poiché la stampa può differire dall'esportazione diretta in PDF dell'editor. Questa soluzione alternativa non risolve un errore di conversione lato server.
Per un'installazione self-hosted, chiedi a un amministratore di esaminare i log del Document Server al momento del nuovo tentativo. ONLYOFFICE documenta i log di Linux in /var/log/onlyoffice/documentserver; per Docker, i log sono disponibili all'interno del container in quel percorso e l'output di Docker può essere esaminato anche con docker logs <container>. Il componente esatto e la dicitura del log dipendono dall'installazione e dalla versione. Cerca errori di conversione, timeout, richieste non riuscite, codici di stato HTTP o errori DNS e di connessione. Non pubblicare righe di log complete pubblicamente se contengono URL privati, token di accesso, nomi utente o nomi di documenti.
Quando i log o l'API rilevano un problema di download del documento sorgente, verificare che il Document Server possa raggiungere l'URL del documento sorgente dal proprio spazio dei nomi di rete. Un amministratore può testare l'URL autorizzato dal server o dal contenitore e controllare DNS, routing, regole del firewall, impostazioni del proxy, certificati TLS e la risposta dell'app di archiviazione. Un URL che si apre nel browser del computer potrebbe comunque non essere raggiungibile dal Document Server. Al contrario, se il download del documento sorgente ha esito positivo ma la conversione fallisce, è necessario analizzare l'errore di conversione anziché modificare l'accesso alla rete.
Per i flussi di lavoro di conversione basati su API, utilizzare il codice di errore restituito per circoscrivere il problema. ONLYOFFICE definisce l'errore di conversione -4come un errore durante il download del file di input, -2un timeout, -3un errore di conversione e -8un token non valido. Questi codici sono specifici della risposta dell'API di conversione; il messaggio generico "Download non riuscito" nell'editor non dimostra di per sé che una conversione PDF abbia restituito uno di questi codici.
Se si verificano problemi solo con i file archiviati in una piattaforma connessa, verificare l'indirizzo del server documenti del connettore e le impostazioni di accesso interne. Il servizio di modifica deve essere in grado di recuperare il file dal proprio sistema di archiviazione. La documentazione di ONLYOFFICE per la risoluzione dei problemi descrive l'errore "Download non riuscito" durante il caricamento dell'editor come l'impossibilità del servizio di modifica di accedere all'URL del file. Questa indicazione è utile quando il report non si apre o non si carica; se l'editor si apre normalmente e si verifica solo un errore nell'esportazione in PDF, esaminare prima la fase di esportazione o download.
Se l'API segnala un token non valido, confronta la configurazione del segreto JWT, dell'intestazione e del token su entrambi i lati. Non disabilitare JWT come scorciatoia. Se l'API indica un limite di dimensione, confronta il file con i limiti configurati nella tua implementazione. Un file di grandi dimensioni o una sorgente non supportata/danneggiata potrebbero richiedere una soluzione diversa; cambiare browser o rete non risolverà un limite di conversione o un documento danneggiato.
Abilita la registrazione di debug solo se i log ordinari non mostrano dove si interrompe la richiesta e disattivala dopo aver raccolto le prove necessarie. I log di debug possono contenere dettagli sensibili sulla richiesta. Segui le istruzioni di ONLYOFFICE per il tuo tipo di installazione e condividi un estratto del log anonimizzato con il tuo amministratore o il team di supporto anziché divulgare URL di documenti o token.
La documentazione di ONLYOFFICE distingue tra le fasi di download dei PDF e gli errori di conversione. Consulta le istruzioni per il download e la stampa nell'editor di documenti , la guida ufficiale alla risoluzione dei problemi di integrazione , i codici di errore dell'API di conversione e la guida alla registrazione di debug per i dettagli relativi alla tua implementazione.
Distinguete i problemi di download del browser dagli errori di conversione lato server e utilizzate il registro o il controllo di accesso appropriato per far funzionare l'esportazione in PDF.
Abbina il segreto JWT utilizzato da ONLYOFFICE Docs e Nextcloud, applicalo in modo sicuro alle installazioni Docker o Linux e verifica la connessione senza compromettere l'autenticazione.
Installa ONLYOFFICE Workspace Community su Ubuntu 24.04 utilizzando lo script Docker ufficiale, verifica i requisiti del server, salta la configurazione della posta elettronica se necessario e verifica la sicurezza del portale.
Configura i segreti JWT corrispondenti per ONLYOFFICE Docs e il suo connettore, con passaggi sicuri per pacchetti Linux, implementazioni Docker e verifica.
Personalizza l'editor integrato di ONLYOFFICE Docs con il logo e i colori della tua azienda tramite un file di tema personalizzato e la configurazione dell'editor. Consulta i limiti di edizione e i controlli di distribuzione.
Tieni traccia delle modifiche in Writer, conserva un file sorgente ODT modificabile e controlla il file DOCX esportato in Word prima di condividerlo.
Segui la procedura SP7 di SUSE per abilitare la modalità FIPS, riavvia in modo sicuro, verifica i criteri attivi e controlla se i requisiti di conformità prevedono moduli convalidati.
Confronta YaST e cryptsetup per un nuovo volume dati SLES crittografato, scegli LUKS1 o LUKS2 e verifica in modo sicuro il comportamento di sblocco e montaggio.
Configurare RMT su SLES 15, replicare i repository autorizzati e verificare la registrazione HTTPS e l'accesso ai pacchetti da un client di test.
Collega SLES 15 ad Active Directory utilizzando la gestione degli accessi basata su SSSD di YaST, quindi verifica la ricerca nella directory, l'accesso al dominio e i ticket Kerberos.
