Pagina-artefacten markeren via Connect

In een oogopslag

Dit recipe verpakt pagineringselementen, zoals doorlopende kop- en voetteksten, paginanummers, watermerken en achtergronden, via Connect-transporten in content die als artefact is gemarkeerd. De elementen verschijnen nog steeds op de pagina, maar blijven buiten de structuurboom en de leesvolgorde voor hulptechnologie. De artefacttool valt onder de Enterprise-laag: NextPDF ontdekt deze met een class_exists()-controle en registreert deze alleen wanneer nextpdf/premium naast de server is geïnstalleerd. Het subtype gebruikt een getypeerde enum (Pagination, Layout, Page, Background).

Gebruik de Enterprise-standaardcontroletool om de uitvoer te verifiëren; deze rapporteert aan de hand van PDF/UA-2. Een geslaagd resultaat is de controle-uitkomst van de tool zelf, geen onafhankelijke conformiteitscertificering.

Installeren

composer require nextpdf/server

Controleer met een tools/list-aanroep dat de Enterprise-artefacttool aanwezig is. Zie /connect/tool-catalog/.

Conceptueel overzicht

Content die geen deel uitmaakt van de logische structuur, wordt als artefact gemarkeerd en uitgesloten van de leesvolgorde (PDF/UA-2 §8.3). Artefacten omvatten paginerings-, lay-out-, pagina- of achtergrondcontent en onderscheiden zich van echte content (PDF/UA-2 §8.3). Echte content wordt weerspiegeld in de structuurboom; artefacten niet (PDF/UA-2 §8.2.4).

De tool opent een content-reeks die als artefact is gemarkeerd, met het gevraagde subtype. Alle tekenbewerkingen die je vóór de bijbehorende afsluiting uitvoert, worden daarin verpakt.

API-oppervlak

Controleer toolnamen aan de hand van het actieve register met tools/list. De gezaghebbende catalogus is /connect/tool-catalog/. Dit recipe herhaalt de toolset niet.

Codevoorbeeld — snelstart

Open een Background-artefact, teken het watermerk en sluit het af:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Background" }
  }
}

Codevoorbeeld — productie

Koppel elke opening aan een afsluiting en controleer dat de pagina geen verweesde content bevat:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Page", "attached": "Bottom" }
  }
}

Nadat je de voettekst hebt getekend, sluit je deze af met de end-artifact-tool en voer je de standaardcontrole uit aan de hand van PDF/UA-2. De structuurboom mag alleen de hoofdcontent bevatten; het watermerk en de voettekst moeten worden uitgesloten.

Randgevallen en valkuilen

Onbekend subtype (bijvoorbeeld "Header") wordt afgewezen. Geef een van Pagination, Layout, Page, Background door.
Afsluiten zonder opening mislukt met een depth-zero-melding. Koppel openen en afsluiten altijd aan elkaar.
Tekenen vóór enige artefact- of structuurcontext levert verweesde content en een structuurregelfout op. Open eerst een structuur- of artefactcontext.
Tool afwezig. Zonder nextpdf/premium wordt de Enterprise-artefacttool niet geregistreerd en mislukt de aanroep met een unknown-tool-fout.

Prestaties

Het frontmatter-budget is een documentatielimiet. Het verpakken in artefacten voegt geen meetbare afzonderlijke fase toe.

Beveiligingsnotities

Niet van toepassing buiten de algemene richtlijnen voor Connect-transport.

Conformiteit

PDF/UA-2-toewijzing

Subtype	Toepassing
`Pagination`	Doorlopende kop-/voetteksten, paginanummers, navigatie-elementen
`Layout`	Lijnen, scheidingstekens, decoratieve randen
`Page`	Paginagebonden hulpmiddelen (snijtekens, registratie)
`Background`	Watermerken, achtergrondvullingen, branding

Tag → ISO 32000-2 §14.9 kruisverwijzing

Bewering	Clausule	reference_id
Niet-structurele content gemarkeerd als artefact, uitgesloten van de leesvolgorde	PDF/UA-2 §8.3
Artefactsubtypen: pagination/layout/page/background	PDF/UA-2 §8.3
Echte content in de structuurboom; artefacten niet	PDF/UA-2 §8.2.4

WCAG 2.2-toewijzing

Het uitsluiten van decoratieve elementen uit de leesvolgorde draagt op contentniveau bij aan Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.3.1 (Info and Relationships).

Een geslaagd standaardcontroleresultaat is een controle-uitkomst, geen conformiteitscertificering. Een onafhankelijke controleur stelt dat vast.

Commerciële context

De artefacttool valt onder de Enterprise-laag en registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd.

Connect-specifieke informatie

Beschikbaarheid van transporten (MCP / REST / gRPC)

Je roept deze tools op dezelfde manier aan via MCP tools/call, het REST-toolendpoint en de gRPC-service. Alle drie gebruiken de gedeelde tool-executor.

HITL-risicolaag

Artefactuitvoer en het tekenen van content vallen onder het waarschuwingsniveau; de standaardcontrole is alleen-lezen. Geen daarvan is standaard approval_required. Zie /connect/hitl-risk-niveaus/.

JSON-envelop van de bevestigingspoort

Deze tools activeren de poort niet, tenzij een operatoroverschrijving een ervan naar approval_required verheft. De envelop en het contract voor het token voor eenmalig gebruik staan in /connect/hitl-risk-niveaus/.

Zie ook

/cookbook/connect/aria-tagged-pdf/ — toewijzing van landmark-rollen.
/cookbook/connect/figure-caption/ — toegankelijke afbeeldingsgroepering.
/connect/tool-catalog/ — berekening van de toolset per laag.
/connect/hitl-risk-niveaus/ — het risicomodel en de poort.