Warum werden manche PDF-Dateien in der Craftboxx-App nicht richtig angezeigt (z. B. Aufmaß, Abnahmeprotokoll)?

🤖 Kurze Zusammenfassung für den Chatbot:

• Wenn einzelne PDFs in der App leer oder unvollständig sind, liegt es meist an der PDF-Struktur (Zeichnungen/Formularaufbau), nicht an Craftboxx.
• Zeichnungen dürfen nicht als reine bearbeitbare Zeichen-PDFs gespeichert sein, sondern müssen „geglättet“ (flattened) werden.
• Wenn ein PDF beschreibbar sein soll, dann immer: Zeichnung zuerst glätten, dann Felder darüberlegen – keine verwaisten Formularfelder, keine leeren /AA‑Aktionen.

Typische Fehlerbilder in der App

Kund:innen beschreiben das Problem oft so:

• „PDF Dateien lassen sich manchmal öffnen, manchmal nicht.“
• „Wenn das Dokument offen ist, wird der Inhalt nicht vollständig angezeigt.“
• „Die Mitarbeiter vor Ort können das Aufmaß oder die Abnahme nicht lesen.“

Wichtig ist hier:
Wenn andere PDFs im gleichen Termin funktionieren, aber bestimmte PDFs immer wieder Probleme machen, ist fast immer der Aufbau dieser speziellen PDFs die Ursache.

Grundprinzip: Zeichnung glätten statt als reine Bearbeitungsdatei speichern

Viele Probleme entstehen, wenn Zeichnungen oder Formulare als „voll bearbeitbares“ PDF mit Ebenen, Kommentaren und CAD-Objekten gespeichert werden. Mobile PDF-Viewer (und damit die App) kommen damit oft schlechter klar als klassische Desktop-Viewer.

Empfohlener Aufbau für PDFs in Craftboxx:

1. Zeichnung fertigstellen und glätten:
   • Zeichnung bzw. Formular in deinem CAD‑/Zeichenprogramm fertig bearbeiten.
   • Danach als „geglättetes“ PDF exportieren, z. B. über Optionen wie:
     • „Druck-PDF“ / „Print PDF“
     • „Ebenen reduzieren“ / „Flatten“ / „Transparenzen reduzieren“
   • Ergebnis: Die Zeichnung liegt als statischer Hintergrund vor, den mobile Viewer stabil anzeigen können.
2. Beschreibbare Version auf Basis der geglätteten Zeichnung:
   • Wenn das Dokument für die App beschreibbar sein soll (Aufmaß, Abnahmeprotokoll etc.):
     • Zuerst die Zeichnung als geglättetes PDF speichern.
     • Dann im PDF-Tool (z. B. Acrobat) Textfelder/Checkboxen über die geglättete Zeichnung legen.
   • So bleibt die Zeichnung unverändert sichtbar und nur die darüberliegenden Felder sind interaktiv.
3. Was vermieden werden muss:
   • Zeichnungen, die komplett als aktive Bearbeitungs-/Zeichenebenen im PDF hängen bleiben.
   • Mischformen, in denen Zeichnung, Kommentare, Ebenen und Formularlogik „wild“ gemischt sind.
   • PDFs, bei denen die Zeichnung selbst noch als Formular-/Objektstruktur vorliegt, statt als flacher Hintergrund.

Technische Problemfälle: Verwaiste Formularfelder & leere Aktionen

Bei PDF-Analysen tauchen häufig Hinweise auf wie:

„Die PDF-Datei enthält 71 verwaiste Formularfelder, die im AcroForm registriert, aber keiner Seite zugeordnet sind, sowie 50 leere Aktionswörterbücher (/AA <<>>).“

Das sind starke Indikatoren dafür, dass das PDF intern kaputt oder zumindest sehr „unsauber“ aufgebaut ist.

Was steckt dahinter?

• Verwaiste Formularfelder:
  • Im AcroForm des PDFs sind Felder registriert, die aber auf keiner sichtbaren Seite liegen.
  • Der Viewer versucht, diese Einträge zu interpretieren, findet aber keinen passenden Anker → das kann zu Anzeigeproblemen führen.
• Leere Aktionswörterbücher (/AA <<>>):
  • Das PDF enthält definierte Aktionen („bei Klick“, „bei Fokus“), denen keine echte Aktion zugeordnet ist.
  • Viele solcher leeren/inkonsistenten Einträge blähen das Dokument auf und bringen einfache Viewer durcheinander.

Folgen in der App können sein:

• Dokument öffnet, bleibt aber komplett weiß.
• Nur Teile der Zeichnung oder des Formulars werden angezeigt.
• Viewer braucht extrem lange oder reagiert gar nicht mehr.

So bereitest du „Craftboxx-taugliche“ PDFs im Büro vor

1. PDF direkt im Ursprungsprogramm sauber exportieren:
   1. Zeichnung/Formular finalisieren:
      • Alle relevanten Inhalte (Linien, Texte, Maße) fertigstellen.
   2. Als geglättetes PDF exportieren:
      • In den Exportoptionen nach „Flatten“, „Druck-PDF“, „Ebenen reduzieren“ o. Ä. suchen.
   3. Bei Bedarf Formularfelder darüber anlegen:
      • Nur die wirklich benötigten Felder anlegen (Textfelder, Checkboxen).
      • Keine unnötige Skript-/Aktionslogik verwenden.
2. Problematische PDFs bereinigen (wenn sie schon existieren):
   1. PDF in einem Profi-Tool (z. B. Acrobat Pro) öffnen:
      • PDF-Preflight oder Prüfwerkzeug starten.
      • Auf Warnungen wie „verwaiste Felder“, „leere Aktionen“, „defekte Formularstruktur“ achten.
   2. Formularstruktur aufräumen:
      • Verwaiste Formularfelder entfernen.
      • Leere /AA‑Einträge und unnötige Aktionen löschen.
      • Ggf. Formularlogik vereinfachen.
   3. Dokument neu als bereinigtes PDF speichern:
      • Möglichst wieder als „flattened“ Version mit einfachen Feldern.
3. Testlauf vor dem breiten Einsatz:
   1. Test-Termin in Craftboxx anlegen:
      • Das bereinigte/geglättete PDF als Dokument anhängen.
   2. Auf typischen Geräten prüfen:
      • Auf mindestens einem iOS‑ und einem Android‑Gerät in der App öffnen.
   3. Prüfen:
      • Lädt das PDF schnell?
      • Ist der vollständige Inhalt sichtbar?
      • Funktionieren die beschreibbaren Felder (falls vorhanden)?

Was Mitarbeitende vor Ort tun sollten, wenn ein PDF nicht lesbar ist

1. Vergleichstest machen:
   • Im selben Termin andere PDFs öffnen.
   • Wenn nur ein bestimmtes Dokument problematisch ist, liegt es mit hoher Wahrscheinlichkeit an genau diesem PDF.
2. Fehler an das Büro melden (mit klaren Angaben):
   • Termin, Dokumentname und betroffene Person (z. B. „Cristian Nigro“) nennen.
   • Kurz beschreiben, was passiert („öffnet nicht“, „bleibt leer“, „unterer Teil fehlt“).
   • Wenn möglich, Screenshot oder kurzes Video mitschicken.

💡 HINWEIS:
Netzwerk- oder App-Probleme können die Anzeige natürlich ebenfalls beeinflussen. Wenn aber immer wieder dieselben PDFs auffallen – besonders Zeichnungen/Formulare mit vielen Ebenen oder kaputten Formularstrukturen –, sollten diese Dateien grundsätzlich neu und sauber als geglättete, ggf. beschreibbare PDFs erzeugt werden, bevor sie in Craftboxx eingesetzt werden.