Deposito elettronico dei documenti

In sintesi

NextPDF Enterprise ottimizza un PDF in un artefatto di recapito idoneo al deposito elettronico presso tribunali ed enti pubblici, secondo la configurazione di un profilo di giurisdizione, e lo suddivide in segmenti delimitati per dimensione quando un limite di dimensione del profilo viene superato. Prepara i formati per il deposito secondo la configurazione; non garantisce che un qualsiasi documento sia accettato da un tribunale o da un registro.

Disponibilità e licenze

Questa funzionalità è distribuita in NextPDF Enterprise (nextpdf/enterprise) e si attiva con un envelope di licenza di livello Enterprise. Una distribuzione priva di tale entitlement non carica le classi della funzionalità. Confronta le edizioni e ottieni una licenza.

Installazione

composer require nextpdf/enterprise:^3

Panoramica concettuale

EFilingOptimizer esegue una pipeline fissa su un PDF di input:

1. Sanificazione. Il contenuto attivo (JavaScript e azioni) viene rimosso tramite il motore di content-disarm-and-reconstruction.
2. Linearizzazione. Il documento viene linearizzato per una visualizzazione web rapida.
3. Controllo di dimensione e suddivisione. Se il risultato supera il limite di dimensione del profilo, SizeAwareSplitter lo divide in segmenti che rientrano ciascuno nel limite, usando una ricerca binaria sul numero di pagine per scegliere i punti di suddivisione.

Un profilo di giurisdizione (EFilingProfile) trasporta i vincoli: dimensione massima del file per segmento, qualità di ricompressione JPEG, appiattimento dei moduli, rimozione del JavaScript, linearizzazione e compressione degli object stream. I profili integrati includono US PACER (limite di 25 MiB), EU e-Justice (limite di 10 MiB) e Taiwan Judicial Yuan (limite di 10 MiB). Il risultato (EFilingResult) riporta i segmenti, le dimensioni originale e ottimizzata, le ottimizzazioni applicate ed eventuali avvisi.

L’output del deposito elettronico è un artefatto di recapito, non uno stato del ciclo di vita del documento. Un PDF ottimizzato o suddiviso è definitivo per la trasmissione e non deve rientrare in una pipeline di firma o di archiviazione, perché la rielaborazione spezzerebbe le catene di hash e l’integrità probatoria.

Cosa questo modulo dichiara e non dichiara

Questo modulo prepara formati per il deposito elettronico presso tribunali ed enti pubblici secondo la configurazione. Non garantisce l’accettazione da parte di un qualsiasi tribunale, registro o portale di deposito. Le regole del portale, i formati accettati, i limiti di dimensione e i requisiti procedurali variano in base alla giurisdizione e cambiano nel tempo. I profili integrati codificano i vincoli comunemente pubblicati come comodità; verificarli rispetto alle regole correnti del registro di destinazione prima del deposito.

Perché funziona in questo modo

La pipeline viene eseguita in un unico ordine fisso — sanifica, linearizza, controlla la dimensione — perché ogni fase consuma l’output della fase precedente. Il content disarm and reconstruction viene eseguito per primo, perché gli input di deposito arrivano da parti non attendibili e devono essere disarmati prima della riscrittura. La linearizzazione precede il controllo di dimensione perché modifica la disposizione dei byte, e quindi la dimensione che lo splitter deve rispettare. splitByMaxSize() verifica poi ogni segmento prodotto rispetto al limite maxFileSizeBytes del profilo, anziché fidarsi di una stima media per pagina. Una singola pagina che supera ancora il limite è indivisibile, perciò emerge come avviso anziché essere scartata. L’artefatto di recapito è escluso dalla rifirma e dalla riarchiviazione, perché rielaborare i byte depositati spezzerebbe le catene di hash probatorie.

Contesto di progettazione: Sanificare i PDF non attendibili: content disarm and reconstruction.

Superficie API

Classe	Responsabilità
EFilingOptimizer	Eseguire la pipeline sanifica → linearizza → suddividi per dimensione.
EFilingProfile	Profilo di vincoli di giurisdizione (pacer(), euJustice(), taiwan() o personalizzato).
SizeAwareSplitter	Suddividere un PDF in segmenti al di sotto di un limite di byte.
EFilingSegment	Un segmento di output: byte, intervallo di pagine, dimensione, indice.
EFilingResult	Aggregato: segmenti, dimensioni, ottimizzazioni, avvisi.

Esempio di codice — Avvio rapido

use NextPDF\Enterprise\Document\EFiling\EFilingOptimizer;
use NextPDF\Enterprise\Document\EFiling\EFilingProfile;

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::pacer());

Esempio di codice — Produzione

$result = (new EFilingOptimizer())->optimize($pdfBytes, EFilingProfile::euJustice());

foreach ($result->warnings as $warning) {
    $logger->warning('efiling.warning', ['message' => $warning]);
}

foreach ($result->segments as $segment) {
    $store->put("filing/{$segment->segmentIndex}.pdf", $segment->pdfData);
}
// Confirm the destination registry's current rules before submitting.

Casi limite e insidie

• Un documento già al di sotto del limite del profilo restituisce un unico segmento, invariato in termini di dimensione.
• Una singola pagina che supera il limite non può essere suddivisa ulteriormente; viene restituita come un unico segmento oltre i limiti con un avviso. Ridurre la qualità delle immagini in un profilo personalizzato o pre-elaborare la pagina.
• Se la sanificazione rifiuta l’input, viene registrato un avviso e i byte originali vengono conservati; esaminare gli avvisi prima del deposito.
• I limiti dei profili integrati riflettono valori comunemente pubblicati, non un feed in tempo reale da ciascun portale. Trattarli come valori predefiniti da confermare.

Prestazioni

Il costo cresce con la dimensione del documento e il numero di pagine. La suddivisione esegue una ricerca binaria sul numero di pagine, perciò il numero di tentativi di suddivisione è logaritmico nel numero di pagine. La linearizzazione e la ricompressione dominano il tempo wall per i documenti di grandi dimensioni ricchi di immagini.

Note di sicurezza

Il contenuto attivo viene rimosso prima del recapito tramite content disarm and reconstruction. Trattare come ostili i PDF di input provenienti da parti non attendibili; il passo di sanificazione è una mitigazione, non una garanzia di sicurezza per i sistemi a valle.

Residenza dei dati e mitigazioni dei dati personali (PII)

I documenti depositati contengono frequentemente dati personali e di causa. L’elaborazione è in-process e locale; il modulo non effettua alcuna chiamata di rete in uscita. Applicare i propri controlli di conservazione ai segmenti e all’originale.

Telemetria sicura e sanificazione dei log

Gli avvisi e i record di ottimizzazione descrivono le azioni della pipeline, non il contenuto del documento. Evitare di registrare percorsi di file o identificatori di causa dal codice circostante su sink condivisi.

Conformità

Comportamento	Riferimento	Stato
Semantica della relazione del file associato	ISO 19005-3:2012 §6.7.8	Rispettata dove si applicano i carrier
Requisiti del carrier per i file incorporati	ISO 19005-4:2020 Annex A	Rispettata dove si applicano i carrier

Questa tabella registra le specifiche in base alle quali è costruita la gestione PDF/A circostante. Non è una dichiarazione di accettazione da parte di un qualsiasi tribunale o registro.

Comportamento in modalità FIPS

Questo modulo non esegue alcuna operazione crittografica.

Modello di minaccia

I PDF di input non attendibili che trasportano contenuto attivo sono l’input principale. Mitigazione: content disarm and reconstruction prima della linearizzazione e del recapito; l’artefatto di recapito è escluso dalla rifirma e dalla riarchiviazione per proteggere l’integrità probatoria.

Contratto di comportamento

• EFilingOptimizer esegue una pipeline fissa: content disarm and reconstruction, linearizzazione, quindi un controllo di dimensione con suddivisione tramite ricerca binaria quando un limite del profilo viene superato.
• Un documento già al di sotto del limite del profilo restituisce un unico segmento di dimensione invariata.
• Una singola pagina oltre il limite viene restituita come un unico segmento oltre i limiti con un avviso; non può essere suddivisa ulteriormente.
• Un artefatto di deposito elettronico è definitivo per la trasmissione e non deve rientrare in una pipeline di firma o di archiviazione; la rielaborazione spezzerebbe le catene di hash e l’integrità probatoria.

Confine di pubblicazione

Questa pagina documenta soltanto il comportamento osservabile dall’esterno e la superficie API pubblica supportata. I percorsi di namespace interni, le classi helper, le tabelle dei meccanismi, i nomi di file di runbook e i prefissi di ticket sono fuori ambito.

Fallback di Core

NextPDF Core non dispone di alcun optimizer per il deposito elettronico basato su profili di giurisdizione, di alcuna fase di sanificazione CDR né di alcun splitter consapevole della dimensione. Una distribuzione solo-Core deve costruire da sé qualsiasi pipeline di preparazione al deposito.

Fallback di Pro

NextPDF Pro non fornisce l’optimizer per il deposito elettronico basato su profili di giurisdizione, i profili integrati PACER / EU e-Justice / Taiwan Judicial Yuan, la fase di sanificazione CDR né lo splitter consapevole della dimensione. Una configurazione che richiede l’ottimizzazione per il deposito elettronico guidata da profili in una distribuzione solo-Pro non ha alcun componente Enterprise che la soddisfi. Vedere la panoramica Enterprise per la superficie Enterprise.

Nota sul confine Enterprise

I dettagli interni dei meccanismi restano nella documentazione interna del repository sorgente e sono fuori ambito per questo manuale.

Confine di distribuzione

I limiti dei profili integrati codificano i vincoli comunemente pubblicati come comodità, non un feed in tempo reale da ciascun portale; la conferma rispetto alle regole correnti del registro di destinazione prima del deposito è responsabilità del depositante. L’elaborazione è in-process e locale; il modulo non effettua alcuna chiamata di rete in uscita. Il trasporto verso un tribunale, un registro o un portale di deposito è esterno a questo modulo.

Confine di conformità legale

NextPDF prepara i formati per il deposito elettronico presso tribunali ed enti pubblici secondo la configurazione di un profilo di giurisdizione. Non garantisce che un documento sia accettato da un qualsiasi tribunale, registro, organo giurisdizionale o portale di deposito, e non fornisce consulenza legale. Le regole di deposito, i formati accettati, i limiti di dimensione, i requisiti di firma e i termini procedurali sono stabiliti dall’autorità competente, variano in base alla giurisdizione e cambiano. La verifica e il rispetto di tali regole sono responsabilità del depositante. Consultare i propri legali e le indicazioni correnti del registro di destinazione.

Vedere anche

• Riferimento del deposito elettronico dei documenti — superficie API pubblica completa per questo modulo.
• Invoice — generazione di fatture strutturate.
• Panoramica Enterprise
• Matrice delle funzionalità Core vs Pro vs Enterprise