Een conformiteitsmodus kiezen via Connect

Een conformiteitsmodus selecteren via Connect

Grens. Het instellen van een conformiteitsmodus bedraadt de catalogus en metadata die de bijbehorende standaard vereist. Daardoor produceert de engine uitvoer die bedoeld is om te voldoen aan die standaard. Dit maakt het document niet „conform”. Een validator, zoals veraPDF, bepaalt de conformiteit. Lees iedere „conformiteits”-uitspraak op deze pagina als „bedoeld om te voldoen; de validator bepaalt de uitkomst”.

In een oogopslag

Een document heeft precies één conformiteitsdiscriminator: plain, een tagged/PDF-UA-modus of een PDF/A-modus. Die discriminator vertelt de writer welke catalogus-, structuur- en metadatabedrading hij moet uitschrijven. Gebruik dit recipe om de discriminator via de Connect-transporten in te stellen. De tagged-modus-setter is core. De PDF/A-4-modus-setter is permanent Premium-niveau (ADR-011) en registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd.

Als u beide setters aanroept, worden beide feature-stacks gestapeld. De enkelwaardige discriminator volgt nog steeds last-wins en de engine geeft een clobber-waarschuwing, zodat tooling de overschrijving kan detecteren.

Installatie

composer require nextpdf/server

Controleer met een tools/list-aanroep of de PDF/A-modus-setter aanwezig is. Zie /connect/tool-catalog/.

Conceptueel overzicht

De conformiteitsmarkering verklaart beoogde conformiteit. Een validator bepaalt de daadwerkelijke conformiteit (PDF/A-4 §6.7.3). Conformiteit wordt bepaald aan de hand van de eisen van de standaard en niet beweerd door de producerende software (PDF/A-4 §6.7.3). De tagged-modus bedraadt de structuurboom en de mark-info-catalogusvermeldingen (ISO 32000-2 §14.7).

Een moduswisseling is een bedradingsoperatie. Die bereidt het document voor op controle tegen de standaard, maar is zelf geen conformiteitsresultaat.

API-oppervlak

Toolnamen worden via tools/list geverifieerd tegen het actieve register. De maatgevende catalogus is /connect/tool-catalog/. Dit recipe herhaalt geen toolaantallen. Selecteer de discriminator vóór de eerste content-aanroep. De writer bevriest de modus bij de eerste pagina-emissie.

Codevoorbeeld — Snelstart

Maak een document aan en zet het daarna om naar de tagged/PDF-UA-modus:

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

Het antwoord rapporteert de actieve modus-predicaten (tagged / accessibility / archival) die de writer op elke emissielocatie controleert. Het rapporteert ook de catalogusbedrading die is toegevoegd. De predicaten tonen wat de writer zal uitschrijven; ze beweren niet dat het resultaat voldoet.

Codevoorbeeld — Productie

Schakel over naar PDF/A-4 (Premium-niveau) en voer daarna de controle uit. Behandel een niet-geslaagde status als een normaal resultaat om te inspecteren:

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

Als u beide setters aanroept, volgt de discriminator last-wins en geeft de engine een clobber-waarschuwing. Voer de standaardcontrole uit voor elke flavour waarvan de feature-stack bedraad blijft, omdat de bedrading additief is, ook al geldt dat niet voor de enkele discriminator.

Randgevallen en valkuilen

Modus ingesteld na de eerste pagina wordt geweigerd met een frozen-mode-fout. Stel de modus direct na het aanmaken van het document in.
PDF/A-setter zonder Premium mislukt — deze is permanent Premium-niveau (ADR-011). Een plain PDF 2.0-document heeft geen PDF/A-modus nodig.
Onbekende enum-waarde wordt geweigerd. De ondersteunde archiveringswaarde is PDF/A-4 (verouderde PDF/A-profielen zijn uitgefaseerd).
Bewerking die door de archiveringsmodus wordt verboden (bijvoorbeeld ingebedde JavaScript) wordt geweigerd zolang het archival-predicaat actief is.
Flavour/modus-mismatch bij de controle levert een non-conform markeringsbevinding op. Geef de flavour door die overeenkomt met de actieve modus, of beide wanneer beide stacks zijn bedraad.

Prestaties

Het frontmatter-budget is een documentatielimiet. Modusbedrading voegt geen afzonderlijke, meetbare fase toe.

Beveiligingsnotities

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

Conformiteit

Bewering	Clausule	reference_id
De conformiteitsmarkering verklaart beoogde conformiteit; een validator bepaalt de uitkomst	PDF/A-4 §6.7.3
Conformiteit wordt bepaald aan de hand van eisen, niet beweerd door de producent	PDF/A-4 §6.7.3
De tagged-modus bedraadt de structuurboom en de mark-info-vermeldingen	ISO 32000-2 §14.7

Het selecteren van een conformiteitsmodus zorgt ervoor dat de engine uitvoer produceert die bedoeld is om te voldoen. Het is geen conformiteitscertificering; een validator bepaalt de uitkomst.

Commerciële context

De PDF/A-4-modus-setter is permanent Premium-niveau (ADR-011) en registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd. De tagged-modus-setter is core-functionaliteit.

Connect-specifieke aspecten

Transportbeschikbaarheid (MCP / REST / gRPC)

De modus-setters en de controle worden identiek aangeroepen via MCP tools/call, het REST-tool-endpoint en de gRPC-service, allemaal via de gedeelde tool-executor.

HITL-risiconiveau

Modus-setters bevinden zich op caution-niveau. De controle is read-only. Geen daarvan is standaard approval_required. Een operator-override kan het risico alleen verhogen. Zie /connect/hitl-risk-niveaus/.

JSON-envelop van de bevestigingspoort

Deze tools activeren de poort niet, tenzij een operator-override er een 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/ — valideren tegen de actieve standaard.
/cookbook/connect/tagged-pdf-tutorial/ — end-to-end walkthrough van tagged-PDF.
/connect/tool-catalog/ — berekening van de toolset per niveau.
/connect/hitl-risk-niveaus/ — het risicomodel en de poort.