Controleren op structurele toegankelijkheid via NextPDF Connect (Pro)

In het kort

Voer een structurele toegankelijkheidsanalyse uit via NextPDF Connect. Gebruik check_accessibility, geverifieerd via de Pro-toolprovider, die new CheckAccessibilityTool() registreert onder de protocolnaam check_accessibility. De beschrijving van het hulpprogramma bakent het bereik af: het analyseert de structurele toegankelijkheid van een PDF — koppen, tabellen, afbeeldingen en indicatoren voor leesvolgorde. Het retourneert indicatoren en herstelaanwijzingen. Het certificeert geen conformiteit met Portable Document Format/Universal Accessibility (PDF/UA) of Web Content Accessibility Guidelines (WCAG). Dat moet een conformiteitscontroleur vaststellen, zoals veraPDF of een PDF/UA-testhulpprogramma. check_accessibility is een hulpprogramma op Pro-niveau. NextPDF detecteert het bij het opstarten met class_exists() en registreert het alleen wanneer het Pro-pakket is geïnstalleerd.

Installatie

composer require nextpdf/server
composer require nextpdf/pro

Koppel een transport en bevestig het hulpprogramma vervolgens met diagnostic.capabilities.

Conceptueel overzicht

Een toegankelijke documentstructuur hangt af van twee dingen: een logische structuurboom van structuurelementen (ISO 32000-2 §14.7) en een gedeclareerde documenttaal, ingesteld via de catalogusvermelding Lang (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility inspecteert deze structurele indicatoren en retourneert bevindingen met ernstniveau en herstelaanwijzingen. Beschouw elke numerieke score of pass/fail-waarde in het rapport als een samenvatting van indicatoren, niet als een certificering. Gebruik het voor triage.

API-oppervlak

Tool	Tier	Rol	Risiconiveau
`create_pdf`, `add_text`	Core	Inhoud opbouwen om te inspecteren	Veilig / Voorzichtig
`check_accessibility`	Pro	Structurele toegankelijkheidsanalyse	Veilig
`output_pdf`	Core	De PDF renderen en retourneren	Goedkeuring vereist / Beoordeling (base64)

Toolnamen zijn de protocolnamen uit het register. De toolcatalogus is de gezaghebbende catalogus. Het geïnstalleerde niveau bepaalt welke tools beschikbaar zijn.

Codevoorbeeld — Snelstart

create_pdf → voeg inhoud toe met add_text.
check_accessibility met de document_id.
Beoordeel de bevindingen: ernst, de indicator, de betreffende pagina en de herstelaanwijzing.
Eventueel output_pdf (base64) voor handmatige beoordeling naast het rapport.

Codevoorbeeld — Productie

Beschouw het rapport als triage-invoer, niet als een oordeel. Koppel elke bevinding aan een concrete herstelactie: schakel getagde uitvoer in, stel de documenttaal in en voeg een koppenstructuur toe. Gebruik een externe controleur als conformiteitspoort. Beschouw dat oordeel als gezaghebbend, niet de score van dit hulpprogramma. Voer de controle uit vóór output_pdf met destroy: true, anders kan het hulpprogramma het document niet zien.

Randgevallen en valkuilen

Geen inhoud. Een leeg document levert een bevinding zonder inhoud op, geen certificering.
Groot document. Een time-out begrenst de analyse; splits grote invoer op of verwerk deze in bereiken.
Vernietigde sessie. Voer de controle uit voordat de uitvoer de sessie vernietigt.
Versleutelde bron. Geef het wachtwoord op.
Pro ontbreekt. Met alleen Core is check_accessibility niet geregistreerd.

Prestaties

De time-out in het budget begrenst de analyse. Het profiel is semantic: het rapport is uitvoer van structurele analyse, dus vergelijk bevindingen, niet byte-uitvoer.

Beveiligingsnotities

Het rapport beschrijft structuur, geen geheime inhoud. Het document dat wordt geanalyseerd kan nog steeds gevoelig zijn, dus houd het binnen je vertrouwensgrens. Het analysepad schrijft niet naar het bestandssysteem.

Conformiteit

Verklaring	Specificatie	Clausule
Logische structuur is een boom van structuurelementen.	ISO 32000-2	§14.7
De documenttaal wordt gedeclareerd via de vermelding `Lang`.	ISO 32000-2	§14.9
Voor toegankelijk auteurschap moet de natuurlijke taal worden opgegeven.	PDF/UA-2	§8.4.4

check_accessibility rapporteert structurele indicatoren die toegankelijk auteurschap ondersteunen. Het doet geen uitspraak over PDF/UA- of WCAG-conformiteit. Een onafhankelijke controleur stelt dat vast.

Commerciële context

check_accessibility is een hulpprogramma op Pro-niveau. NextPDF registreert het alleen wanneer het Pro-pakket bij het opstarten van de server kan worden geladen.

PDF/UA-2-mapping

De structurele indicatoren die dit hulpprogramma inspecteert, sluiten aan op de auteursvereisten van PDF/UA-2: een getagde structuurboom (ISO 32000-2 §14.7) en een gedeclareerde documenttaal (PDF/UA-2 §8.4.4). Het hulpprogramma rapporteert of deze indicatoren aanwezig of afwezig zijn. Een PDF/UA-controleur stelt PDF/UA-2-conformiteit vast, niet het rapport van het hulpprogramma.

Tag → ISO 32000-2 §14-kruisverwijzing

Bevindingen over koppen en tabellen komen overeen met logische structuurelementen in de structuurboom uit ISO 32000-2 §14.7. De taalbevinding komt overeen met de §14.9-vermelding Lang. Het hulpprogramma rapporteert of deze structurele ankers aanwezig zijn. Het valideert niet elke §14-tagregel; dat is de taak van een controleur.

WCAG 2.2-mapping

Bevindingen over contrast en leesvolgorde hebben betrekking op WCAG-succescriteria, zoals contrast en betekenisvolle volgorde. Het hulpprogramma rapporteert indicatorwaarden, zoals een gemeten contrastverhouding. Een WCAG-conformiteitsclaim vereist een volledige WCAG-evaluatie; dit hulpprogramma voert die niet uit en doet zo’n claim niet.

Beschikbaarheid van transport

Transport	Beschikbaar	Opmerkingen
MCP (stdio)	Ja (Pro)	Het rapport is een toolresultaat.
REST	Ja (Pro)	Het rapport is de body van de respons.
gRPC	Ja (Pro)	Unary; rapport in het responsbericht.

HITL-risiconiveau

check_accessibility is Veilig (alleen-lezen analyse) en activeert nooit een poort. output_pdf naar een bestand vereist Goedkeuring, en de base64-modus is Beoordeling (HITL-risiconiveaus).

JSON-envelop voor bevestigingspoort

De analyse activeert nooit een poort:

{ "allowed": true }