Strukturelle Barrierefreiheit mit NextPDF Connect prüfen (Pro)

Auf einen Blick

Führen Sie mit NextPDF Connect eine strukturelle Barrierefreiheitsanalyse durch. Das Werkzeug heißt check_accessibility; dies wurde erneut anhand des Pro-Werkzeuganbieters verifiziert, der new CheckAccessibilityTool() unter dem Protokollnamen check_accessibility registriert. Die Werkzeugbeschreibung grenzt den Umfang ein: Es analysiert die strukturelle Barrierefreiheit eines PDFs – Überschriften, Tabellen, Bilder und Indikatoren der Lesereihenfolge. Es zeigt Indikatoren und Hinweise zur Behebung an. Es zertifiziert nicht die PDF/UA- oder WCAG-Konformität. Diese Feststellung trifft ein Konformitätsprüfwerkzeug – zum Beispiel veraPDF oder ein PDF/UA-Testwerkzeug – nicht dieses Werkzeug. check_accessibility ist ein Werkzeug der Pro-Stufe. NextPDF prüft es beim Start mit class_exists() und registriert es nur, wenn das Pro-Paket installiert ist.

Installation

composer require nextpdf/server
composer require nextpdf/pro

Binden Sie einen Transport an. Überprüfen Sie die Verfügbarkeit des Werkzeugs mit diagnostic.capabilities.

Konzeptioneller Überblick

Eine barrierefreie Struktur beruht auf zwei Dingen: einem logischen Strukturbaum aus Strukturelementen (ISO 32000-2 §14.7) und einer deklarierten Dokumentsprache, die über den Katalogeintrag Lang festgelegt wird (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility untersucht diese strukturellen Indikatoren und gibt einen Bericht mit Befunden zurück, jeweils mit Schweregrad und Hinweisen zur Behebung. Jeder numerische Wert und jede pass/fail-Angabe im Bericht ist als Indikatorzusammenfassung, keine Zertifizierung zu lesen – also als Triage-Signal.

API-Oberfläche

Werkzeug	Stufe	Rolle	Risikostufe
`create_pdf`, `add_text`	Core	Zu prüfende Inhalte erstellen	Sicher / Vorsicht
`check_accessibility`	Pro	Strukturelle Barrierefreiheitsanalyse	Sicher
`output_pdf`	Core	Das PDF rendern und zurückgeben	Genehmigung erforderlich / Prüfung (Base64)

Werkzeugnamen sind die Protokollnamen in der Registry. Der Werkzeugkatalog ist die maßgebliche Referenz. Welche Werkzeuge verfügbar sind, hängt von der installierten Stufe ab.

Codebeispiel – Schnellstart

create_pdf → Inhalt mit add_text hinzufügen.
check_accessibility mit der document_id.
Lesen Sie die Befunde: Schweregrad, Indikator, betroffene Seite und Hinweis zur Behebung.
Optional output_pdf (Base64) zur manuellen Prüfung ergänzend zum Bericht.

Codebeispiel – Produktion

Behandeln Sie den Bericht als Triage-Eingabe, nicht als Urteil. Ordnen Sie jedem Befund eine konkrete Behebung zu: getaggte Ausgabe aktivieren, die Dokumentsprache festlegen, Überschriftenstruktur hinzufügen. Für ein Konformitätstor führen Sie ein externes Prüfwerkzeug aus und behandeln dessen Urteil – nicht den Wert dieses Werkzeugs – als maßgeblich. Führen Sie die Prüfung aus, bevor output_pdf mit destroy: true die Sitzung zerstört; sonst kann das Werkzeug das Dokument nicht mehr sehen.

Randfälle & Stolperfallen

Kein Inhalt. Ein leeres Dokument ergibt den Befund „kein Inhalt“, aber keine Zertifizierung.
Großes Dokument. Die Analyse ist an ein Zeitlimit gebunden; teilen Sie große Eingaben auf oder grenzen Sie sie ein.
Zerstörte Sitzung. Führen Sie die Prüfung aus, bevor die Ausgabe die Sitzung zerstört.
Verschlüsselte Quelle. Geben Sie das Passwort an.
Pro nicht vorhanden. Wenn nur Core vorhanden ist, ist check_accessibility nicht registriert.

Leistung

Das Zeitlimit im Budget begrenzt die Analyse. Das Profil ist semantic: Der Bericht ist das Ergebnis einer Strukturanalyse; ein ehrlicher Vergleich beruht daher auf den Befunden, nicht auf der Byte-Ausgabe.

Sicherheitshinweise

Der Bericht beschreibt die Struktur, nicht die vertraulichen Inhalte selbst. Das untersuchte Dokument kann dennoch sensibel sein; halten Sie es daher innerhalb Ihrer Vertrauensgrenze. Der Analysepfad schreibt nichts in das Dateisystem.

Konformität

Aussage	Spezifikation	Klausel
Die logische Struktur ist ein Baum aus Strukturelementen.	ISO 32000-2	§14.7
Die Dokumentsprache wird über den Eintrag `Lang` deklariert.	ISO 32000-2	§14.9
Für barrierefreies Authoring muss die natürliche Sprache angegeben werden.	PDF/UA-2	§8.4.4

check_accessibility meldet strukturelle Indikatoren, die barrierefreies Authoring unterstützen. Es behauptet keine PDF/UA- oder WCAG-Konformität; das stellt ein unabhängiges Prüfwerkzeug fest.

Kommerzieller Kontext

check_accessibility ist ein Werkzeug der Pro-Stufe und wird nur registriert, wenn sich das Pro-Paket beim Serverstart auflösen lässt.

PDF/UA-2-Zuordnung

Die strukturellen Indikatoren, die das Werkzeug untersucht, decken sich mit den Authoring-Anforderungen von PDF/UA-2: einem getaggten Strukturbaum (ISO 32000-2 §14.7) und einer deklarierten Dokumentsprache (PDF/UA-2 §8.4.4). Das Werkzeug meldet, ob diese Indikatoren vorhanden sind. Die PDF/UA-2-Konformität stellt ein PDF/UA-Prüfwerkzeug fest, nicht der Bericht des Werkzeugs.

Tag → ISO 32000-2 §14-Querverweis

Befunde zu Überschriften und Tabellen beziehen sich auf logische Strukturelemente im Strukturbaum nach ISO 32000-2 §14.7. Der Sprachbefund bezieht sich auf den Eintrag Lang nach §14.9. Das Werkzeug zeigt an, ob diese strukturellen Anker vorhanden sind. Es validiert nicht jede §14-Tag-Regel; das ist die Aufgabe eines Prüfwerkzeugs.

WCAG-2.2-Zuordnung

Befunde zu Kontrast und Lesereihenfolge beziehen sich auf WCAG-Erfolgskriterien, etwa Kontrast und sinnvolle Reihenfolge. Das Werkzeug meldet Indikatorwerte, zum Beispiel ein gemessenes Kontrastverhältnis. Eine WCAG-Konformitätsaussage erfordert eine vollständige WCAG-Bewertung, die dieses Werkzeug weder durchführt noch behauptet.

Transportverfügbarkeit

Transport	Verfügbar	Hinweise
MCP (stdio)	Ja (Pro)	Der Bericht ist ein Werkzeugergebnis.
REST	Ja (Pro)	Der Bericht ist der Antwortkörper.
gRPC	Ja (Pro)	Unär; der Bericht steht in der Antwortnachricht.

HITL-Risikostufe

check_accessibility ist Sicher (schreibgeschützte Analyse) und nie gated. Für output_pdf in eine Datei ist Genehmigung erforderlich; der Base64-Modus ist Prüfung (HITL-Risikostufen).

JSON-Umschlag des Bestätigungstors

Die Analyse ist nie gated:

{ "allowed": true }