Batchgewijze standaardcontrole via Connect

In het kort

Gebruik dit recipe om in één aanroep veel PDF-bestanden aan een of meer benoemde beleidsregels te toetsen. Daarbij wordt de batch compliance-tool via de Connect-transporten aangeroepen. De tool valt onder het Enterprise-niveau: een class_exists()-test detecteert de tool, en hij wordt alleen geregistreerd wanneer nextpdf/premium naast de server is geïnstalleerd. De tool toetst elk document aan elke beleidsregel in het verzoek en geeft daarna een samengevoegd rapport per document en per beleidsregel terug.

Net als bij de controle van één document betekent „geslaagd” per beleidsregel alleen dat de tool de regels heeft gecontroleerd die hij implementeert. Het is geen onafhankelijke conformiteitscertificering. De conformiteit wordt door een validator vastgesteld.

Installeren

composer require nextpdf/server

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

Conceptueel overzicht

Een standaard stelt eisen aan elk document, en een controleur toetst elk document aan die eisen (PDF/A-4 §6.2.3). Conformiteit wordt bepaald aan de hand van de eisen, niet doordat de producent die beweert (PDF/A-4 §6.7.3). Voor handtekeninggerelateerde beleidsregels zijn de baselineniveaus van PDF Advanced Electronic Signatures (PAdES) afzonderlijk, en zijn de niveaus B-LT/B-LTA (validatiemateriaal, archieftijdstempel) Enterprise-exclusief (ETSI EN 319 142-2 §5.5). Voor de hele documentenset heeft het batchresultaat dezelfde beperkte betekenis: „geen geïmplementeerde regel is mislukt”.

API-oppervlak

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

Codevoorbeeld — Snelstart

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

Codevoorbeeld — Productie

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; }

Het antwoord bevat een batch-id, samengevoegde aantallen pass/fail en een checks-array per document met resultaten per beleidsregel en redenen voor mislukking. Filter de mislukte controles, herstel ze en dien alleen de betrokken documenten opnieuw in.

Randgevallen en valkuilen

Lege sources of policies geeft een fout wegens ongeldige parameters terug.
Een ontbrekend bestand verschijnt als een fout per resultaat in plaats van de hele batch te laten mislukken. Controleer elk resultaat op een foutveld.
Limiet voor batchgrootte overschreden geeft een expliciete fout terug. Verdeel het werk over kleinere batches.
Onbekende beleids-id geeft een fout voor een onbekende standaard terug waarin de herkende identifiers worden genoemd. Handtekeningbeleidsregels die verwijzen naar B-LT/B-LTA zijn alleen zinvol op een Enterprise-implementatie die dat materiaal kan produceren.
Tool ontbreekt. Zonder nextpdf/premium wordt de Enterprise-batchtool niet geregistreerd; de aanroep mislukt met een fout voor een onbekende tool.

Prestaties

Het budget in de front matter is een documentatielimiet. De tool verwerkt documenten aan de serverzijde, en elk document kan veel werkgeheugen gebruiken. Stem de batchgrootte af op het geheugen van de host in plaats van een globale time-out te verhogen.

Beveiligingsopmerkingen

Log geen bronpaden of het volledige rapport op een logniveau dat extern wordt verzonden. Log alleen de batch-id en de samengevoegde aantallen pass/fail. „Geslaagd” per beleidsregel beschrijft de geïmplementeerde regelset, geen beveiligings- of juridische garantie.

Conformiteit

Bewering	Clausule	reference_id
Een standaard stelt eisen; een controleur toetst elk document	PDF/A-4 §6.2.3
Conformiteit wordt bepaald aan de hand van eisen, niet beweerd door de producent	PDF/A-4 §6.7.3
B-LT/B-LTA voegen validatiemateriaal toe; het zijn afzonderlijke, Enterprise-exclusieve niveaus	ETSI EN 319 142-2 §5.5

Ondersteuning voor een batchgewijze standaardcontrole is geen conformiteitscertificering. Een onafhankelijke validator bepaalt de conformiteit per document.

Commerciële context

De batch compliance-tool valt onder het Enterprise-niveau en wordt alleen geregistreerd wanneer nextpdf/premium naast de server is geïnstalleerd.

Specifieke kenmerken van Connect

Beschikbaarheid van transporten (MCP / REST / gRPC)

Roep de tool op dezelfde manier aan via Model Context Protocol (MCP) tools/call, het REST-toolendpoint en de gRPC-service; ze gebruiken allemaal de gedeelde tool-executor.

HITL-risiconiveau

De batchcontrole is alleen-lezen en is standaard niet approval_required. Een operatoroverride kan het risiconiveau alleen verhogen. Zie /connect/hitl-risk-niveaus/ voor details.

JSON-envelop van de bevestigingspoort

De tool activeert de poort niet, tenzij een operatoroverride deze verhoogt naar approval_required. Het contract voor de envelop en het eenmalig te gebruiken token staat in /connect/hitl-risk-niveaus/.

Zie ook

/cookbook/connect/compliance-check/ — standaardcontrole voor één document.
/cookbook/connect/ai-ready-certification/ — bredere controle op AI-gereedheid.
/connect/tool-catalog/ — berekening van de toolset per niveau.
/connect/hitl-risk-niveaus/ — risicomodel en poortgedrag.