Urmăriți un export PDF ONLYOFFICE eșuat la sursa sa

Salvați mai întâi documentul sursă, apoi determinați dacă eroarea apare în conversia PDF a ONLYOFFICE sau în descărcarea finală a browserului. Dacă editorul raportează o eroare de conversie, verificați jurnalele serverului de documente și confirmați că serverul poate accesa fișierul sursă. Dacă conversia reușește, dar browserul afișează mesajul „Descărcare eșuată”, verificați în schimb starea de descărcare a browserului, permisiunile site-ului și spațiul disponibil pe disc.

Scenariu ilustrativ: Imaginați-vă că Jordan, un administrator care folosește un editor ONLYOFFICE Docs auto-găzduit, selectează Fișier > Descărcare ca > PDF pentru un raport de proiect. Editorul afișează o eroare și nu apare niciun PDF. Acesta este un exemplu ipotetic, nu un incident testat; același simptom poate apărea din etape diferite, așadar verificările de mai jos urmează punctul în care procesul se oprește.

Meniul Fișier al editorului de documente ONLYOFFICE cu opțiunea Descărcare ca deschis și PDF selectată
Meniul Fișier al editorului online oferă opțiunile Descărcare ca și format PDF; imaginea este o vizualizare ilustrativă a interfeței.

1. Protejați sursa și reproduceți eroarea o singură dată

Înainte de depanare, utilizați Salvare sau Ctrl+S pentru a salva editările curente. În Editorul de documente online, ONLYOFFICE documentează calea de export PDF ca Fișier > Descărcare ca > PDF. Editorul poate pregăti mai întâi PDF-ul și apoi poate transmite rezultatul browserului, astfel încât o descărcare eșuată din browser nu înseamnă întotdeauna că conversia în sine a eșuat.

Folosește același raport pentru a face o singură reîncercare controlată. Notează dacă editorul afișează o casetă de dialog de eroare, dacă browserul creează o intrare de descărcare eșuată și dacă problema afectează doar acest fișier sau toate fișierele. Evită să dai clic în mod repetat pe Export: joburile duplicate îngreunează potrivirea unei marchete temporale cu intrarea corespunzătoare din jurnalul serverului.

2. Dacă browserul afișează o descărcare PDF eșuată

Deschideți pagina Descărcări a browserului și verificați elementul eșuat. Încercați din nou o dată. Verificați dacă browserul a blocat descărcările de pe site-ul ONLYOFFICE, dacă o confirmare a descărcării așteaptă într-o altă filă și dacă unitatea de destinație are suficient spațiu liber. Dacă gestionați browserul, testați același document salvat într-un browser alternativ curent sau într-un profil de browser curat. Dacă funcționează, concentrați-vă pe setările browserului, extensii sau software-ul de securitate local; nu modificați încă configurația serverului de documente.

Cazul ipotetic al lui Jordan ar indica browserul atunci când editorul termină de pregătit PDF-ul, dar lista de descărcări raportează o eroare de rețea sau de permisiune. O soluție practică este să utilizați Fișier > Imprimare și să alegeți destinația „Salvare în PDF” a browserului sau a sistemului de operare, dacă este disponibilă. Verificați paginile, fonturile și linkurile rezultate, deoarece rezultatul imprimării poate diferi de exportul direct în PDF al editorului. Această soluție nu repară o eroare de conversie pe partea de server.

Pagina generică de descărcări a browserului care afișează o descărcare nereușită a unui raport.pdf și un control Reîncercare
O intrare de descărcare în browser care spune că a eșuat indică etapa finală de transfer; încercați din nou și verificați permisiunile de descărcare din browser.

3. Dacă conversia sau recuperarea sursei eșuează

Pentru o instalare auto-găzduită, solicitați unui administrator să inspecteze jurnalele Document Server în momentul reîncercării. ONLYOFFICE documentează jurnalele Linux sub /var/log/onlyoffice/documentserver; pentru Docker, jurnalele sunt disponibile în interiorul containerului la acea cale, iar ieșirea Docker poate fi, de asemenea, inspectată cu docker logs <container>. Formularea exactă a componentelor și a jurnalului depinde de instalare și versiune. Căutați erori de conversie, expirari, solicitări eșuate, coduri de stare HTTP sau erori DNS și de conexiune. Nu postați public linii complete de jurnal dacă acestea conțin adrese URL private, token-uri de acces, nume de utilizator sau nume de documente.

Când jurnalele sau API-ul identifică o problemă la descărcarea sursei, verificați dacă serverul de documente poate accesa adresa URL a documentului sursă din propriul spațiu de nume de rețea. Un administrator poate testa adresa URL autorizată de pe server sau container și poate verifica DNS, rutare, regulile firewall, setările proxy, certificatele TLS și răspunsul aplicației de stocare. O adresă URL care se deschide în browserul desktopului poate fi totuși inaccesibilă de pe serverul de documente. În schimb, dacă sursa se descarcă cu succes, dar conversia eșuează, investigați eroarea convertorului în loc să modificați accesul la rețea.

Pentru fluxurile de lucru de conversie bazate pe API, utilizați codul de eroare returnat pentru a restrânge problema. ONLYOFFICE definește eroarea de conversie -4ca o eroare la descărcarea fișierului de intrare, -2ca o expirare, -3ca o eroare de conversie și -8ca un token nevalid. Aceste coduri sunt specifice răspunsului API de conversie; mesajul generic „Descărcare eșuată” din editor nu dovedește în sine că o conversie PDF a returnat unul dintre ele.

Vizualizator ilustrativ de jurnal de diagnosticare cu evenimente de rețea și conversie, inclusiv o livrare eșuată a răspunsului
Aspect ilustrativ al jurnalului: corelați eroarea de rețea sau de conversie cu momentul exportului eșuat; câmpurile reale ale jurnalului variază.

4. Verificați accesul, permisiunile și dimensiunea doar atunci când există dovezi care indică acest lucru

Dacă eșuează doar fișierele stocate pe o platformă conectată, verificați adresa serverului de documente și setările de acces intern ale conectorului. Serviciul de editare trebuie să poată prelua fișierul din sistemul său de stocare. Documentația de depanare ONLYOFFICE descrie mesajul „Descărcare eșuată” în timpul încărcării editorului, ca fiind imposibilitatea serviciului de editare de a accesa adresa URL a fișierului. Aceste îndrumări sunt utile atunci când raportul nu se poate deschide sau încărca; dacă editorul se deschide normal și eșuează doar exportul PDF, inspectați mai întâi etapa de export sau descărcare.

Dacă API-ul raportează un token nevalid, comparați configurația secretului JWT, a antetului și a token-ului pe ambele părți. Nu dezactivați JWT ca scurtătură. Dacă API-ul indică o limită de dimensiune, comparați fișierul cu limitele configurate în implementarea dvs. Un fișier mare sau o sursă neacceptată/coruptă poate necesita o soluție diferită; schimbarea browserului sau a rețelei nu va remedia o limită de conversie sau un document deteriorat.

Activați jurnalizarea de depanare numai dacă jurnalele obișnuite nu arată unde se oprește solicitarea și dezactivați-o din nou după colectarea dovezilor necesare. Jurnalele de depanare pot conține detalii sensibile ale solicitării. Urmați instrucțiunile ONLYOFFICE pentru tipul de instalare și partajați un extras redactat din jurnal cu administratorul sau echipa de asistență, în loc să expuneți adresele URL ale documentelor sau token-urile.

Listă de verificare pentru diagnosticarea exportului PDF care acoperă accesul la fișierul sursă, finalizarea conversiei și permisiunile de descărcare din browser
Folosește cele trei etape în ordine: recuperarea sursei, conversia PDF-ului, apoi descărcarea din browser.

Verificați rezultatul

  • Confirmați că fișierul descărcat există, are o dimensiune diferită de zero și se deschide într-un cititor PDF.
  • Verificați prima și ultima pagină, numărul de pagini și câteva fonturi sau imagini cheie în raport cu sursa.
  • Repetați exportul o dată după remedierea relevantă. Dacă eșuează în continuare, înregistrați ora, versiunea ONLYOFFICE Docs, etapa de export și codul de eroare sau extrasul din jurnal redactat.

Documentația ONLYOFFICE distinge pașii de descărcare a PDF-urilor de erorile de conversie. Consultați instrucțiunile de descărcare și imprimare ale Editorului de documente , ghidul oficial de depanare a integrării , codurile de eroare API de conversie și ghidul de înregistrare a erorilor pentru detalii care corespund implementării dvs.

Lasă un comentariu

Urmăriți un export PDF ONLYOFFICE eșuat la sursa sa

Urmăriți un export PDF ONLYOFFICE eșuat la sursa sa

Separă problemele legate de descărcarea browserului de erorile de conversie de pe server și folosește jurnalul corect sau verificarea accesului pentru a face exportul PDF să funcționeze.

Rezolvați eroarea „Tokenul nu este valid” a ONLYOFFICE în Nextcloud

Rezolvați eroarea „Tokenul nu este valid” a ONLYOFFICE în Nextcloud

Potrivește secretul JWT utilizat de ONLYOFFICE Docs și Nextcloud, aplică-l în siguranță pentru instalările Docker sau Linux și verifică conexiunea fără a slăbi autentificarea.

Implementați Comunitatea Spațiului de Lucru ONLYOFFICE pe Ubuntu 24.04

Implementați Comunitatea Spațiului de Lucru ONLYOFFICE pe Ubuntu 24.04

Instalați ONLYOFFICE Workspace Community pe Ubuntu 24.04 cu scriptul oficial Docker, verificați cerințele serverului, omiteți Mail dacă este necesar și verificați portalul în siguranță.

Configurați secretele ONLYOFFICE JWT pe server și conector

Configurați secretele ONLYOFFICE JWT pe server și conector

Configurați secrete JWT corespunzătoare pentru ONLYOFFICE Docs și conectorul său, cu pași siguri pentru pachete Linux, implementări Docker și verificare.

Brandificați documentele ONLYOFFICE cu sigla și culorile temei dvs.

Brandificați documentele ONLYOFFICE cu sigla și culorile temei dvs.

Dați unui editor ONLYOFFICE Docs încorporat sigla companiei și culorile interfeței, cu un fișier temă personalizat și o configurație a editorului. Consultați limitele de ediție și verificările de implementare.

Păstrați reviziile Writer vizibile la exportul în DOCX

Păstrați reviziile Writer vizibile la exportul în DOCX

Urmăriți editările în Writer, păstrați o sursă ODT editabilă și verificați fișierul DOCX exportat în Word înainte de a-l partaja.

Activarea modului FIPS pe SLES 15 și verificarea stării de pornire

Activarea modului FIPS pe SLES 15 și verificarea stării de pornire

Urmați procedura SP7 a SUSE pentru a activa modul FIPS, reporniți în siguranță, verificați politica activă și verificați dacă cerința de conformitate necesită module validate.

Configurați un volum de date criptat LUKS pe SLES

Configurați un volum de date criptat LUKS pe SLES

Comparați YaST și cryptsetup pentru un nou volum de date SLES criptat, alegeți LUKS1 sau LUKS2 și verificați comportamentul de deblocare și montare în siguranță.

Construiți un server local de actualizare SUSE cu RMT pe SLES 15

Construiți un server local de actualizare SUSE cu RMT pe SLES 15

Configurați RMT pe SLES 15, oglindiți repozitoriile autorizate și verificați înregistrarea HTTPS și accesul la pachet de la un client de testare.

Conectarea SLES 15 la Active Directory cu SSSD în YaST

Conectarea SLES 15 la Active Directory cu SSSD în YaST

Conectați SLES 15 la AD cu ajutorul gestionării logon-ului bazate pe SSSD din YaST, apoi verificați căutarea în directoare, conectarea la domeniu și tichetele Kerberos.