Leere, ungültige, fehlgeschlagene und teilweise Ergebnisse unterscheiden.
Ein Import ist eine Folge von Entscheidungen: Dateityp prüfen, Text gewinnen, Felder lesen und Werte validieren. Lege vor dem ersten Parser fest, welche Beobachtung jeden Schritt erfolgreich macht. Unser Museums-Shop akzeptiert fiktive Produktblätter. Der Textextraktor liefert Status, Text und Abdeckung. ok bedeutet: Die vereinbarte Arbeit ist abgeschlossen. invalid bezeichnet eine unzulässige Eingabe, ambiguous mehrere mögliche Deutungen, failed einen technischen Fehlschlag und partial eine bekannte Teilabdeckung. Diese Zustände ersetzen keine Erklärung: Eine Meldung nennt beispielsweise die verarbeiteten Seiten und die erlaubte Nutzung. Ein erfolgreicher Prozess mit leerem Text kann eine gültige Extraktionsantwort sein; er beweist noch keinen gültigen Produktdatensatz.
Ein Beispiel
Das Blatt Atlas hat acht Seiten. Der Vorschauadapter verarbeitet Seiten 1–2 und liefert einen Titel. Die Textstufe ist partial mit coverage=[1,2] und total_pages=8. Die Anzeige lautet: Vorschau aus zwei von acht Seiten. Das Feld Preis bleibt ungeprüft. Würde dieselbe Anzeige nur Text gefunden melden, verschwände die entscheidende Grenze.
Python 3.11 · Lehrbeispiel
result = {"status": "partial", "text": "Atlas",
"pages": [1, 2], "total_pages": 8}
print(result["status"], len(result["pages"]), result["total_pages"])
Erwartete Ausgabe
partial 2 8
