Batch-Standardprüfung über Connect

Auf einen Blick

In diesem Recipe prüfen Sie viele PDFs in einem einzigen Aufruf gegen eine oder mehrere benannte Richtlinien. Dabei kommt das Batch-Compliance-Tool über die Connect-Transporte zum Einsatz. Das Tool gehört zur Enterprise-Stufe: Es wird per class_exists()-Prüfung erkannt und registriert sich nur, wenn nextpdf/premium zusammen mit dem Server installiert ist. Jedes Dokument wird gegen jede in der Anfrage enthaltene Richtlinie geprüft; die Antwort ist ein zusammengefasster Bericht pro Dokument und pro Richtlinie.

Wie bei der Einzeldokumentprüfung bezeichnet „bestanden“ pro Richtlinie die eigene Prüfung des Tools anhand der von ihm implementierten Regeln — es ist keine unabhängige Konformitätszertifizierung. Ein Validierer trifft die Konformitätsentscheidung.

Installation

composer require nextpdf/server

Vergewissern Sie sich mit einem tools/list-Aufruf, dass das Enterprise-Batch-Tool vorhanden ist. Siehe /connect/tool-catalog/.

Konzeptioneller Überblick

Ein Standard stellt Anforderungen an jedes Dokument, und ein Prüfer wertet jedes Dokument anhand dieser Anforderungen aus (PDF/A-4 §6.2.3). Die Konformität wird anhand der Anforderungen bestimmt, nicht vom Produzenten behauptet (PDF/A-4 §6.7.3). Bei signaturbezogenen Richtlinien sind die PAdES-Baseline-Stufen eigenständig; die Fähigkeiten für B-LT/B-LTA (Validierungsmaterial, Archiv-Zeitstempel) sind ausschließlich der Enterprise-Stufe vorbehalten (ETSI EN 319 142-2 §5.5). Das Batch-Ergebnis aggregiert dieselbe enge Semantik „keine implementierte Regel ist fehlgeschlagen“ über die Dokumentmenge hinweg.

API-Oberfläche

Gleichen Sie Tool-Namen mit tools/list mit der laufenden Registry ab. Der maßgebliche Katalog ist /connect/tool-catalog/. Dieses Recipe wiederholt die Tool-Anzahl nicht.

Codebeispiel — Schnellstart

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

Codebeispiel — Produktion

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

Die Antwort enthält eine Batch-ID, aggregierte pass/fail-Zähler und ein checks-Array pro Dokument mit Ergebnissen pro Richtlinie sowie Fehlergründen. Filtern Sie die fehlgeschlagenen Ergebnisse, beheben Sie sie und reichen Sie nur die betroffenen Dokumente erneut ein.

Randfälle & Fallstricke

Leere sources oder policies führen zu einem Fehler wegen ungültiger Parameter.
Eine fehlende Datei wird als Fehler im jeweiligen Ergebnis ausgewiesen, anstatt den gesamten Batch fehlschlagen zu lassen. Prüfen Sie jedes Ergebnis auf ein Fehlerfeld.
Überschreitung des Batch-Größenlimits ist ein expliziter Fehler. Teilen Sie den Auftrag in kleinere Batches auf.
Unbekannte Richtlinien-ID führt zu einem Fehler wegen eines unbekannten Standards, der die erkannten Bezeichner nennt. Signaturrichtlinien, die auf B-LT/B-LTA verweisen, sind nur in einer Enterprise-Bereitstellung sinnvoll, die dieses Material erzeugen kann.
Tool nicht vorhanden. Ohne nextpdf/premium ist das Enterprise-Batch-Tool nicht registriert; der Aufruf schlägt mit einem Fehler wegen eines unbekannten Tools fehl.

Leistung

Das Budget im Frontmatter dient als Dokumentationsobergrenze. Das Tool verarbeitet Dokumente serverseitig, und der Arbeitsspeicherbedarf pro Dokument ist nicht unerheblich. Richten Sie die Batch-Größe am Speicher des Hosts aus, statt ein globales Zeitlimit zu erhöhen.

Sicherheitshinweise

Protokollieren Sie keine Quellpfade und keinen vollständigen Bericht in Logs, die extern ausgeliefert werden. Protokollieren Sie nur die Batch-ID und die aggregierten pass/fail-Zähler. Ein „bestanden“ pro Richtlinie beschreibt den implementierten Regelsatz, nicht eine Sicherheits- oder Rechtsgewähr.

Konformität

Aussage	Klausel	reference_id
Der Standard stellt Anforderungen; ein Prüfer wertet jedes Dokument aus	PDF/A-4 §6.2.3
Konformität wird anhand der Anforderungen bestimmt, nicht vom Produzenten behauptet	PDF/A-4 §6.7.3
B-LT/B-LTA ergänzen Validierungsmaterial; die Stufen sind verschieden und ausschließlich der Enterprise-Stufe vorbehalten	ETSI EN 319 142-2 §5.5

Die Unterstützung einer Batch-Standardprüfung ist keine Konformitätszertifizierung. Ein unabhängiger Validierer trifft die Konformitätsentscheidung pro Dokument.

Kommerzieller Kontext

Das Batch-Compliance-Tool gehört zur Enterprise-Stufe und registriert sich nur, wenn nextpdf/premium zusammen mit dem Server installiert ist.

Connect-Besonderheiten

Transportverfügbarkeit (MCP / REST / gRPC)

Das Tool wird über MCP tools/call, den REST-Tool-Endpunkt und den gRPC-Dienst identisch über den gemeinsamen Tool-Executor aufgerufen.

HITL-Risikostufe

Die Batch-Prüfung ist schreibgeschützt und standardmäßig nicht als approval_required markiert. Eine Bedienerüberschreibung darf ihre Risikostufe nur erhöhen. Siehe /connect/hitl-risk-tiers/ für Details.

JSON-Umschlag des Bestätigungs-Gates

Das Tool löst das Gate nicht aus, sofern eine Bedienerüberschreibung es nicht auf approval_required anhebt. Der Umschlag und der Vertrag für Einmal-Token sind in /connect/hitl-risk-tiers/ beschrieben.

Siehe auch

/cookbook/connect/compliance-check/ — Standardprüfung für ein einzelnes Dokument.
/cookbook/connect/ai-ready-certification/ — umfassendere KI-Bereitschaftsprüfung.
/connect/tool-catalog/ — Berechnung des Tool-Sets pro Stufe.
/connect/hitl-risk-tiers/ — das Risikomodell und das Gate.