Scegliere una modalità di conformità tramite Connect

Ambito. L’impostazione di una modalità di conformità cabla il catalogo e i metadati previsti dallo standard corrispondente. Fa sì che il motore produca un output destinato a conformarsi a quello standard. Non rende però il documento «conforme»: è un validatore (per esempio veraPDF) a decidere la conformità. In questa pagina, leggere ogni affermazione di «conformità» come «destinato a conformarsi; è il validatore a determinare l’esito».

In sintesi

Un documento contiene esattamente un discriminatore di conformità: semplice, una modalità tagged/PDF-UA oppure una modalità PDF/A. Tale discriminatore determina il cablaggio di catalogo, struttura e metadati emesso dal writer. Questa ricetta imposta il discriminatore tramite i trasporti Connect. Il setter della modalità tagged è core. Il setter della modalità PDF/A-4 è permanentemente di livello Premium (ADR-011) e si registra solo quando nextpdf/premium è installato insieme al server.

Chiamare entrambi i setter sovrappone entrambi gli stack di funzionalità. Il discriminatore a valore singolo continua comunque a collassare secondo last-wins e viene emesso un avviso di sovrascrittura, così che gli strumenti possano rilevare l’overwrite.

Installazione

composer require nextpdf/server

Verificare che il setter della modalità PDF/A sia presente con una chiamata tools/list. Vedere /connect/tool-catalog/.

Panoramica concettuale

Il marcatore di conformità dichiara la conformità prevista; un validatore determina la conformità effettiva (PDF/A-4 §6.7.3). La conformità è determinata rispetto ai requisiti dello standard, non asserita dal software che produce il documento (PDF/A-4 §6.7.3). La modalità tagged cabla l’albero della struttura e le voci di catalogo mark-info (ISO 32000-2 §14.7).

Di conseguenza, un cambio di modalità è un’operazione di cablaggio. Prepara il documento a essere verificato rispetto allo standard. Non è di per sé un risultato di conformità.

Superficie API

I nomi degli strumenti vengono verificati sul registro in esecuzione tramite tools/list. Il catalogo di riferimento è /connect/tool-catalog/. Questa ricetta non ripete il conteggio degli strumenti. Selezionare il discriminatore prima della prima chiamata di contenuto. Il writer congela la modalità all’emissione della prima pagina.

Esempio di codice — Avvio rapido

Creare un documento, quindi abilitarlo in modalità tagged/PDF-UA:

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

La risposta riporta i predicati di modalità attivi (tagged / accessibilità / archiviazione) che il writer consulta in ogni punto di emissione. Riporta inoltre il cablaggio di catalogo aggiunto. I predicati indicano ciò che il writer emetterà; non asseriscono che il risultato sia conforme.

Esempio di codice — Produzione

Abilitare PDF/A-4 (livello Premium), quindi verificare. Trattare uno stato di non successo come un esito normale da ispezionare:

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

Se vengono chiamati entrambi i setter, il discriminatore collassa secondo last-wins e viene emesso un avviso di sovrascrittura. Eseguire la verifica degli standard per ciascuna variante il cui stack di funzionalità rimane cablato, perché il cablaggio è additivo anche se il discriminatore singolo non lo è.

Casi limite e insidie

L’impostazione della modalità dopo la prima pagina viene rifiutata con un errore di modalità congelata. Impostare la modalità immediatamente dopo aver creato il documento.
Il setter PDF/A senza Premium fallisce: è permanentemente di livello Premium (ADR-011). Un documento PDF 2.0 semplice non necessita di alcuna modalità PDF/A.
Un caso di enum sconosciuto viene rifiutato. Il caso di archiviazione supportato è PDF/A-4 (i profili PDF/A legacy sono stati ritirati).
Un’operazione vietata dalla modalità di archiviazione (per esempio JavaScript incorporato) viene rifiutata mentre il predicato di archiviazione è attivo.
Una mancata corrispondenza variante/modalità nella verifica restituisce un riscontro di marcatore non conforme. Passare la variante corrispondente alla modalità attiva, oppure entrambe se entrambi gli stack sono cablati.

Prestazioni

Il budget del front-matter è un limite documentale. Il cablaggio della modalità non aggiunge fasi separate misurabili.

Note di sicurezza

Non applicabile oltre le indicazioni generali sul trasporto Connect.

Conformità

Affermazione	Clausola	reference_id
Il marcatore di conformità dichiara la conformità prevista; un validatore determina l’esito	PDF/A-4 §6.7.3
La conformità è determinata rispetto ai requisiti, non asserita dal produttore	PDF/A-4 §6.7.3
La modalità tagged cabla l’albero della struttura e le voci mark-info	ISO 32000-2 §14.7

Selezionare una modalità di conformità fa sì che il motore produca un output destinato a conformarsi. Non è una certificazione di conformità. Un validatore determina l’esito.

Contesto commerciale

Il setter della modalità PDF/A-4 è permanentemente di livello Premium (ADR-011) e si registra solo quando nextpdf/premium è installato insieme al server. Il setter della modalità tagged è una funzionalità core.

Specifiche di Connect

Disponibilità dei trasporti (MCP / REST / gRPC)

I setter di modalità e la verifica vengono invocati nello stesso modo tramite MCP tools/call, l’endpoint REST degli strumenti e il servizio gRPC attraverso l’esecutore di strumenti condiviso.

Livello di rischio HITL

I setter di modalità appartengono al livello cautela. La verifica è di sola lettura. Nessuno è approval_required per impostazione predefinita. Un override dell’operatore può soltanto aumentare il rischio. Vedere /connect/hitl-risk-tiers/.

Envelope JSON del gate di conferma

Questi strumenti non attivano il gate a meno che un override dell’operatore non porti uno di essi a approval_required. L’envelope e il contratto del token monouso si trovano in /connect/hitl-risk-tiers/.

Vedere anche

/cookbook/connect/compliance-check/ — validare rispetto allo standard attivo.
/cookbook/connect/tagged-pdf-tutorial/ — guida tagged-PDF end-to-end.
/connect/tool-catalog/ — calcolo dell’insieme di strumenti per livello.
/connect/hitl-risk-tiers/ — il modello di rischio e il gate.