SetDeterministicDocumentID

Proprietà del documento, ottimizzazione

Descrizione

Abilita o disabilita identificatori di file trailer riproducibili derivati da un seed esplicito o dal contenuto serializzato normalizzato

Sintassi

Delphi

Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;

Parametri

Valori restituiti

Osservazioni

Se abilitato, il prossimo salvataggio completo non cifrato deriva il /ID del trailer dal seed fornito con SetDocumentIDSeed. Senza un seed esplicito, lo scrittore fa passare l'intestazione serializzata e il corpo del documento attraverso SHA-256, normalizza gli identificatori di risorsa generati e gli UUID di istanza XMP e usa i primi 16 byte del digest per entrambe le voci dell'array /ID iniziale. I dati dei riferimenti incrociati, gli offset del trailer e un eventuale /ID del trailer precedente sono esclusi, quindi le modifiche a pagine, risorse, allegati e metadati influenzano l'identificatore mentre gli offset di layout noL'identificatore viene rinfrescato solo sui salvataggi completi. Gli aggiornamenti incrementali non riscrivono mai l'identificatore permanente e i documenti cifrati conservano il loro identificatore esistente, perché la prima voce

/ID partecipa alla derivazione della chiave di cifratura. Le date automatiche e gli altri metadati utente volatili restano contenuto; impostarli esplicitamente quando due documenti generati indipendentemente devono ricevere lo stesso identificatore derivato dal contenuto

Esempio

PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer ID

Vedere anche

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID