SetDeterministicDocumentID
Dokumentegenskaber, optimering
Beskrivelse
Aktiverer eller deaktiverer reproducerbare trailer-filidentifikatorer afledt af en eksplicit seed eller normaliseret serialiseret indhold
Syntaks
Delphi
Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;Parametre
| Enable | Giv 1 for at aflede trailerens filidentifikator fra en eksplicit seed eller normaliseret dokumentindhold, eller 0 for at gendanne den tidsafledte standardidentifikator |
|---|
Returværdier
| 0 | Ugylig parameterværdi |
|---|---|
| 1 | Indstillingen blev anvendt |
Bemærkninger
Når den er aktiveret, afleder den næste fulde ukrypterede gemning trailerens /ID fra den seed, der leveres med SetDocumentIDSeed. Uden en eksplicit seed streamer skriveren den serialiserede header og dokumentkrop gennem SHA-256, normaliserer genererede ressourceidentifikatorer og XMP-instans-UUID'er og bruger de første 16 digest-bytes til begge poster i det oprindelige /ID-array. Krydsreferencedata, trailerforskydninger og eventuelle tidligere trailer-/ID er udeladt, så side-, ressource-, vedhæftnings- og metadataændringer påvirker identifikatoren, mens layoutforskydninger ikke gørIdentifikatoren opdateres kun ved fulde gemninger. Inkrementelle opdateringer omskriver aldrig den permanente identifikator, og krypterede dokumenter beholder deres eksisterende identifikator, fordi den første
/ID-post indgår i afledningen af krypteringsnøglen. Automatiske datoer og anden flygtig brugermetadata forbliver indhold; sæt dem eksplicit, når to uafhængigt genererede dokumenter skal have samme indholdsafledte identifikator
Eksempel
PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer IDSe også
GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID