Acasă
» Cum să
»
Urmăriți un export PDF ONLYOFFICE eșuat la sursa sa
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 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.
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.
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.
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.