Een mislukte OnlyOffice PDF-export herleiden naar de bron

Sla eerst het brondocument op en bepaal vervolgens of de fout optreedt tijdens de PDF-conversie van ONLYOFFICE of tijdens het downloaden door de browser. Als de editor een conversiefout meldt, controleer dan de logboeken van de documentserver en bevestig dat de server het bronbestand kan bereiken. Als de conversie wel lukt, maar de browser 'Download mislukt' weergeeft, controleer dan de downloadstatus van de browser, de site-machtigingen en de beschikbare schijfruimte.

Illustratief scenario: Stel je voor dat Jordan, een beheerder die een zelfgehoste ONLYOFFICE Docs-editor gebruikt, Bestand > Downloaden als > PDF selecteert voor een projectrapport. De editor geeft een foutmelding en er verschijnt geen PDF. Dit is een hypothetisch voorbeeld, geen getest incident; hetzelfde symptoom kan zich in verschillende fasen voordoen, dus de onderstaande controles volgen het punt waar het proces stopt.

1. Bescherm de broncode en reproduceer de fout eenmaal.

Voordat u problemen oplost, gebruikt u 'Opslaan' of Ctrl+S om uw huidige bewerkingen op te slaan. In de online documenteditor registreert ONLYOFFICE het PDF-exportpad als Bestand > Downloaden als > PDF. De editor kan eerst de PDF voorbereiden en het resultaat vervolgens aan de browser doorgeven, dus een mislukte download door de browser betekent niet altijd dat de conversie zelf is mislukt.

Gebruik hetzelfde rapport om één gecontroleerde nieuwe poging te doen. Noteer of de editor een foutmelding weergeeft, of de browser een melding van een mislukte download aanmaakt en of het probleem alleen dit bestand of alle bestanden betreft. Klik niet herhaaldelijk op Exporteren: dubbele taken maken het lastiger om een ​​tijdstempel te koppelen aan de bijbehorende serverlogboekvermelding.

2. Als de browser een mislukte PDF-download weergeeft.

Open de downloadpagina van uw browser en bekijk het mislukte item. Probeer het nogmaals. Controleer of de browser downloads van de ONLYOFFICE-website heeft geblokkeerd, of er een downloadbevestiging in een ander tabblad staat en of er voldoende vrije ruimte is op de schijf waarop het document is opgeslagen. Als u de browser beheert, test dan hetzelfde opgeslagen document in een andere browser of een leeg browserprofiel. Als dat werkt, kunt u de browserinstellingen, extensies of lokale beveiligingssoftware controleren; wijzig de configuratie van de documentenserver nog niet.

Jordans hypothetische voorbeeld wijst naar de browser wanneer de editor klaar is met het voorbereiden van de PDF, maar de downloadlijst een netwerk- of toegangsfout meldt. Een praktische oplossing is om Bestand > Afdrukken te gebruiken en de optie "Opslaan als PDF" van de browser of het besturingssysteem te selecteren, indien beschikbaar. Controleer de resulterende pagina's, lettertypen en links, aangezien de afdrukuitvoer kan afwijken van de directe PDF-export van de editor. Deze oplossing verhelpt geen conversiefout aan de serverzijde.

3. Als de conversie of het ophalen van de bron mislukt

Bij een zelfgehoste installatie kunt u een beheerder vragen de logbestanden van de documentenserver te controleren op het moment van de herhaalpoging. ONLYOFFICE documenteert Linux-logbestanden onder /var/log/onlyoffice/documentserver; voor Docker zijn de logbestanden beschikbaar in de container op dat pad, en de Docker-uitvoer kan ook worden gecontroleerd met docker logs <container>. De exacte component en de formulering van de logbestanden zijn afhankelijk van de installatie en versie. Zoek naar conversiefouten, time-outs, mislukte verzoeken, HTTP-statuscodes of DNS- en verbindingsfouten. Publiceer geen volledige logregels openbaar als deze privé-URL's, toegangstokens, gebruikersnamen of documentnamen bevatten.

Als logboeken of de API een probleem met het downloaden van de bron aangeven, controleer dan of de documentserver de URL van het brondocument kan bereiken vanuit zijn eigen netwerknaamruimte. Een beheerder kan de geautoriseerde URL vanaf de server of container testen en de DNS, routering, firewallregels, proxy-instellingen, TLS-certificaten en de reactie van de opslagapplicatie controleren. Een URL die in uw desktopbrowser wordt geopend, is mogelijk nog steeds niet bereikbaar vanaf de documentserver. Omgekeerd, als de bron wel succesvol wordt gedownload maar de conversie mislukt, onderzoek dan de fout in de converter in plaats van de netwerktoegang te wijzigen.

Voor API-gebaseerde conversieworkflows kunt u de geretourneerde foutcode gebruiken om het probleem te lokaliseren. ONLYOFFICE definieert conversiefouten -4als een fout bij het downloaden van het invoerbestand, -2een time-out, -3een conversiefout en -8een ongeldig token. Deze codes zijn specifiek voor de API-respons van de conversie; het algemene bericht 'Download mislukt' in de editor bewijst op zichzelf niet dat een PDF-conversie een van deze codes heeft geretourneerd.

4. Controleer de toegang, machtigingen en grootte alleen als er aanwijzingen voor zijn.

Als alleen bestanden die op één verbonden platform zijn opgeslagen niet werken, controleer dan het adres van de documentserver en de interne toegangsinstellingen van de connector. De bewerkingsservice moet het bestand kunnen ophalen uit het opslagsysteem. In de documentatie voor probleemoplossing van ONLYOFFICE wordt de foutmelding "Download mislukt" tijdens het laden van de editor beschreven als een probleem waarbij de bewerkingsservice geen toegang heeft tot de URL van het bestand. Deze informatie is nuttig wanneer het rapport niet kan worden geopend of geladen; als de editor normaal opent en alleen de PDF-export mislukt, controleer dan eerst de export- of downloadfase.

Als de API een ongeldig token meldt, vergelijk dan het JWT-geheim, de header en de tokenconfiguratie aan beide zijden. Schakel JWT niet uit als noodoplossing. Als de API een groottelimiet aangeeft, vergelijk dan het bestand met de limieten die in uw implementatie zijn geconfigureerd. Een groot bestand of een niet-ondersteunde/beschadigde bron vereist mogelijk een andere oplossing; het wijzigen van de browser of het netwerk lost een conversielimiet of een beschadigd document niet op.

Schakel debug-logging alleen in als gewone logs niet laten zien waar het verzoek stopt, en schakel het weer uit nadat u het benodigde bewijsmateriaal hebt verzameld. Debug-logs kunnen gevoelige details over verzoeken bevatten. Volg de instructies van ONLYOFFICE voor uw installatietype en deel een geanonimiseerd logfragment met uw beheerder of supportteam in plaats van document-URL's of tokens openbaar te maken.

Controleer het resultaat

• Controleer of het gedownloade bestand bestaat, een grootte heeft die groter is dan nul en of het in een PDF-lezer kan worden geopend.
• Vergelijk de eerste en laatste pagina's, het paginanummer en een paar belangrijke lettertypen of afbeeldingen met de brontekst.
• Herhaal de export na de betreffende correctie. Als het nog steeds mislukt, noteer dan het tijdstip, de ONLYOFFICE Docs-versie, de exportfase en de geanonimiseerde foutcode of het logboekfragment.

De documentatie van ONLYOFFICE maakt onderscheid tussen de stappen voor het downloaden van PDF-bestanden en conversiefouten. Raadpleeg de instructies voor het downloaden en afdrukken van de documenteditor , de officiële handleiding voor het oplossen van integratieproblemen , de foutcodes van de conversie-API en de handleiding voor het loggen van foutopsporing voor details die van toepassing zijn op uw implementatie.