Seitenartefakte über Connect markieren

Auf einen Blick

Dieses Rezept schließt Paginierungs-Chrome — laufende Kopf- und Fußzeilen, Seitenzahlen, Wasserzeichen, Hintergründe — über die Connect-Transporte in als Artefakt markierte Inhaltssequenzen ein. Diese Elemente erscheinen weiterhin auf der Seite, bleiben jedoch außerhalb des Strukturbaums und der Lesereihenfolge für Hilfstechnologien. Das Artefakt-Werkzeug gehört zur Enterprise-Stufe: NextPDF erkennt es über eine class_exists()-Prüfung und registriert es nur dann, wenn nextpdf/premium neben dem Server installiert ist. Der Untertyp wird als typisiertes Enum angegeben (Pagination, Layout, Page, Background).

Verwenden Sie zur Überprüfung das Enterprise-Standardprüfungswerkzeug, das Prüfberichte zu PDF/UA-2 ausgibt. Ein bestandenes Ergebnis ist eine Prüfung durch das Werkzeug, keine unabhängige Konformitätszertifizierung.

Installation

composer require nextpdf/server

Prüfen Sie mit einem tools/list-Aufruf, dass das Enterprise-Artefakt-Werkzeug vorhanden ist. Siehe /connect/tool-catalog/.

Konzeptioneller Überblick

Inhalt, der nicht Teil der logischen Struktur ist, wird als Artefakt markiert und aus der Lesereihenfolge ausgeschlossen (PDF/UA-2 §8.3). Artefakte sind Paginierungs-, Layout-, Seiten- oder Hintergrundinhalte, die von echtem Inhalt abgegrenzt werden (PDF/UA-2 §8.3). Echter Inhalt wird im Strukturbaum abgebildet, Artefakte nicht (PDF/UA-2 §8.2.4).

Das Werkzeug öffnet eine als Artefakt markierte Inhaltssequenz des angeforderten Untertyps. Alle Zeichenoperationen, die Sie bis zum zugehörigen Schließen ausführen, werden darin eingeschlossen.

API-Oberfläche

Überprüfen Sie die Werkzeugnamen in der laufenden Registry mit tools/list. Der maßgebliche Katalog ist /connect/tool-catalog/. Dieses Rezept nennt keine feste Werkzeuganzahl.

Codebeispiel — Schnellstart

Öffnen Sie ein Background-Artefakt, zeichnen Sie das Wasserzeichen und schließen Sie es:

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

Codebeispiel — Produktion

Verbinden Sie jedes Öffnen mit einem Schließen und prüfen Sie, dass die Seite keinen verwaisten Inhalt enthält:

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

Nachdem Sie den Fußzeilentext gezeichnet haben, schließen Sie mit dem End-Artefakt-Werkzeug und führen Sie die Standardprüfung gegen PDF/UA-2 aus. Der Strukturbaum darf nur den Textkörperinhalt enthalten; Wasserzeichen und Fußzeile müssen ausgeschlossen sein.

Sonderfälle & Stolperfallen

Unbekannter Untertyp (zum Beispiel "Header") wird abgelehnt. Übergeben Sie einen der Werte Pagination, Layout, Page, Background.
Schließen ohne Öffnen führt zu einem Fehler mit einer Meldung zur Tiefe Null. Verbinden Sie Öffnen und Schließen stets als Paar.
Zeichnen vor jeglichem Artefakt- oder Strukturkontext erzeugt verwaisten Inhalt und einen Verstoß gegen eine Strukturregel. Öffnen Sie zuerst einen Struktur- oder Artefaktkontext.
Werkzeug fehlt. Ohne nextpdf/premium wird das Enterprise-Artefakt-Werkzeug nicht registriert, und der Aufruf schlägt mit einem Fehler wegen eines unbekannten Werkzeugs fehl.

Leistung

Das Frontmatter-Budget ist eine Dokumentationsobergrenze. Das Einschließen als Artefakt fügt keine messbare eigene Phase hinzu.

Sicherheitshinweise

Über die allgemeine Connect-Transportanleitung hinaus gelten keine zusätzlichen Hinweise.

Konformität

PDF/UA-2-Zuordnung

Untertyp	Anwendungsfall
`Pagination`	Laufende Kopf- und Fußzeilen, Seitenzahlen, Navigations-Chrome
`Layout`	Linien, Trennstriche, dekorative Rahmen
`Page`	Seitenbezogene Hilfen (Schnittmarken, Passermarken)
`Background`	Wasserzeichen, Hintergrundfüllungen, Branding

Tag → ISO 32000-2 §14.9-Querverweis

Aussage	Klausel	reference_id
Nichtstruktureller Inhalt als Artefakt markiert, aus der Lesereihenfolge ausgeschlossen	PDF/UA-2 §8.3
Artefakt-Untertypen: pagination/layout/page/background	PDF/UA-2 §8.3
Echter Inhalt im Strukturbaum; Artefakte nicht	PDF/UA-2 §8.2.4

WCAG-2.2-Zuordnung

Das Ausschließen von dekorativem Chrome aus der Lesereihenfolge unterstützt WCAG 2.2 SC 1.3.1 (Info and Relationships) auf der Inhaltsebene.

Ein bestandenes Standardprüfungsergebnis ist eine Prüfung, keine Konformitätszertifizierung. Eine solche Feststellung trifft ein unabhängiger Prüfer.

Kommerzieller Kontext

Das Artefakt-Werkzeug gehört zur Enterprise-Stufe und registriert sich nur dann, wenn nextpdf/premium neben dem Server installiert ist.

Connect-Besonderheiten

Transportverfügbarkeit (MCP / REST / gRPC)

Sie rufen diese Werkzeuge identisch über MCP tools/call, den REST-Werkzeug-Endpunkt und den gRPC-Dienst auf, jeweils über den gemeinsam genutzten Werkzeug-Executor.

HITL-Risikostufe

Artefaktausgabe und Inhaltszeichnung liegen auf der Vorsichtsstufe; die Standardprüfung ist schreibgeschützt. Keines davon ist standardmäßig approval_required. Siehe /connect/hitl-risk-tiers/.

JSON-Umschlag des Bestätigungsgates

Diese Werkzeuge lösen das Gate nicht aus, es sei denn, eine Bedienerüberschreibung setzt eines auf approval_required. Der Umschlag und der Einmal-Token-Vertrag stehen in /connect/hitl-risk-tiers/.

Siehe auch

/cookbook/connect/aria-tagged-pdf/ — Zuordnung von Landmark-Rollen.
/cookbook/connect/figure-caption/ — barrierefreie Bildgruppierung.
/connect/tool-catalog/ — Berechnung des Werkzeugsatzes je Stufe.
/connect/hitl-risk-tiers/ — das Risikomodell und das Gate.