Einen Konformitätsmodus über Connect auswählen

Grenze. Wenn Sie einen Konformitätsmodus setzen, verdrahtet die Engine den Katalog und die Metadaten so, wie es der jeweilige Standard erwartet. Dadurch erzeugt die Engine eine Ausgabe, die zu diesem Standard konform sein soll. Das macht das Dokument nicht „konform“ — ein Validator (zum Beispiel veraPDF) entscheidet über die tatsächliche Konformität. Lesen Sie jede „Konformitäts“-Aussage auf dieser Seite als „soll konform sein; der Validator bestimmt das Ergebnis“.

Auf einen Blick

Ein Dokument trägt genau einen Diskriminator für den Konformitätsmodus: schlichtes PDF, den getaggten/PDF-UA-Modus oder den PDF/A-Modus. Dieser Diskriminator steuert, welche Katalog-, Struktur- und Metadatenverdrahtung der Writer ausgibt. In diesem Rezept setzen Sie den Diskriminator über die Connect-Transporte. Der Setter für den getaggten Modus gehört zum Core. Der Setter für den PDF/A-4-Modus ist dauerhaft Premium-Stufe (ADR-011) und wird nur registriert, wenn nextpdf/premium zusammen mit dem Server installiert ist.

Wenn Sie beide Setter aufrufen, werden beide Feature-Stacks übereinandergelegt. Der einwertige Diskriminator wird dennoch nach „last-wins“ aufgelöst, und es wird eine Überschreibwarnung ausgegeben, damit Tooling die Überschreibung erkennen kann.

Installation

composer require nextpdf/server

Prüfen Sie mit einem tools/list-Aufruf, ob der PDF/A-Modus-Setter vorhanden ist. Siehe /connect/tool-catalog/.

Konzeptioneller Überblick

Der Konformitätsmarker deklariert beabsichtigte Konformität; ein Validator bestimmt die tatsächliche Konformität (PDF/A-4 §6.7.3). Konformität wird anhand der Anforderungen des Standards festgestellt, nicht von der erzeugenden Software behauptet (PDF/A-4 §6.7.3). Der getaggte Modus verdrahtet den Strukturbaum und die MarkInfo-Katalogeinträge (ISO 32000-2 §14.7).

Ein Moduswechsel ist daher eine Verdrahtungs-Operation. Er bereitet das Dokument darauf vor, gegen den Standard geprüft zu werden. Er liefert selbst kein Konformitätsergebnis.

API-Oberfläche

Verifizieren Sie Tool-Namen über tools/list gegen die laufende Registry. Der maßgebliche Katalog ist /connect/tool-catalog/. Dieses Rezept nennt die Tool-Anzahl nicht erneut. Wählen Sie den Diskriminator vor dem ersten Inhaltsaufruf. Der Writer friert den Modus bei der Ausgabe der ersten Seite ein.

Codebeispiel — Schnellstart

Erstellen Sie ein Dokument und schalten Sie es dann in den getaggten/PDF-UA-Modus:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

Die Antwort gibt die aktiven Modus-Prädikate (getaggt / Barrierefreiheit / Archivierung) zurück, die der Writer an jeder Ausgabestelle konsultiert. Außerdem meldet sie die hinzugefügte Katalog-Verdrahtung. Die Prädikate beschreiben, was der Writer ausgeben wird; sie behaupten nicht, dass das Ergebnis konform ist.

Codebeispiel — Produktion

Schalten Sie auf PDF/A-4 (Premium-Stufe) um und prüfen Sie anschließend. Behandeln Sie einen nicht erfolgreichen Status als reguläres, zu prüfendes Ergebnis:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

Werden beide Setter aufgerufen, wird der Diskriminator nach „last-wins“ aufgelöst und es wird eine Überschreibwarnung ausgegeben. Führen Sie die Standardprüfung für jede Variante aus, deren Feature-Stack verdrahtet bleibt, denn die Verdrahtung ist additiv, auch wenn der einwertige Diskriminator es nicht ist.

Randfälle & Fallstricke

Ein nach der ersten Seite gesetzter Modus wird mit einem Fehler abgewiesen, weil der Modus eingefroren ist. Setzen Sie den Modus unmittelbar nach dem Erstellen des Dokuments.
Der PDF/A-Setter ohne Premium schlägt fehl — er gehört dauerhaft zur Premium-Stufe (ADR-011). Ein schlichtes PDF-2.0-Dokument braucht keinen PDF/A-Modus.
Ein unbekannter Enum-Fall wird abgewiesen. Der unterstützte Archivierungsfall ist PDF/A-4 (ältere PDF/A-Profile wurden eingestellt).
Eine vom Archivierungsmodus verbotene Operation (zum Beispiel eingebettetes JavaScript) wird abgewiesen, solange das Archivierungs-Prädikat aktiv ist.
Eine Varianten-/Modus-Diskrepanz bei der Prüfung liefert einen Befund mit einem nicht konformen Marker. Übergeben Sie die zum aktiven Modus passende Variante oder beide, wenn beide Stacks verdrahtet sind.

Performance

Das Budget im Frontmatter ist eine Dokumentationsobergrenze. Die Modus-Verdrahtung fügt keine gesondert messbare Phase hinzu.

Sicherheitshinweise

Über die allgemeine Connect-Transport-Anleitung hinaus nicht zutreffend.

Konformität

Aussage	Klausel	reference_id
Der Konformitätsmarker deklariert beabsichtigte Konformität; ein Validator entscheidet	PDF/A-4 §6.7.3
Konformität wird anhand der Anforderungen festgestellt, nicht vom Erzeuger behauptet	PDF/A-4 §6.7.3
Der getaggte Modus verdrahtet den Strukturbaum und die MarkInfo-Einträge	ISO 32000-2 §14.7

Wenn Sie einen Konformitätsmodus auswählen, erzeugt die Engine eine Ausgabe, die konform sein soll. Das ist keine Konformitätszertifizierung. Ein Validator bestimmt das Ergebnis.

Kommerzieller Kontext

Der PDF/A-4-Modus-Setter gehört dauerhaft zur Premium-Stufe (ADR-011) und wird nur registriert, wenn nextpdf/premium zusammen mit dem Server installiert ist. Der Setter für den getaggten Modus ist eine Core-Fähigkeit.

Connect-Besonderheiten

Transport-Verfügbarkeit (MCP / REST / gRPC)

Die Modus-Setter und die Prüfung werden über MCP tools/call, den REST-Tool-Endpunkt und den gRPC-Dienst über den gemeinsamen Tool-Executor auf dieselbe Weise aufgerufen.

HITL-Risikostufe

Modus-Setter befinden sich auf der Stufe „caution“. Die Prüfung ist schreibgeschützt. Keines dieser Tools ist standardmäßig approval_required. Ein Operator-Override darf das Risiko nur erhöhen. Siehe /connect/hitl-risk-tiers/.

JSON-Envelope des Bestätigungs-Gates

Diese Tools lösen das Gate nicht aus, es sei denn, ein Operator-Override hebt eines davon auf approval_required an. Der Vertrag für Envelope und Einmaltoken steht in /connect/hitl-risk-tiers/.

Siehe auch

/cookbook/connect/compliance-check/ — gegen den aktiven Standard validieren.
/cookbook/connect/tagged-pdf-tutorial/ — durchgängige Anleitung für getaggtes PDF.
/connect/tool-catalog/ — Berechnung des Tool-Sets je Stufe.
/connect/hitl-risk-tiers/ — das Risikomodell und das Gate.