SetDeterministicDocumentID
خصائص المستند، التحسين
الوصف
تُمكّن أو تُعطّل معرّفات ملف المقطع الختامي القابلة لإعادة الإنتاج المشتقة من بذرة صريحة أو من محتوى متسلسل مطبَّع
الصيغة
Delphi
Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;المعاملات
| Enable | مرر 1 لاشتقاق معرّف ملف المقطع الختامي من بذرة صريحة أو من محتوى مستند مطبَّع، أو 0 لاستعادة المعرّف الافتراضي المشتق من الوقت. |
|---|
قيم الإرجاع
| 0 | قيمة معامل غير صالحة. |
|---|---|
| 1 | طُبق الإعداد بنجاح. |
ملاحظات
عند التمكين، تشتق عملية الحفظ الكامل غير المشفر التالية المقطع الختامي /ID من البذرة الموردة مع SetDocumentIDSeed. ودون بذرة صريحة، يمرر الكاتب الترويسة المتسلسلة وجسم المستند عبر SHA-256، ويطبّع معرّفات الموارد المولدة ومعرّفات XMP UUID للنسخ، ويستخدم أول 16 بايت من الملخص لكلا مدخلي مصفوفة /ID الأولية. وتُستثنى بيانات الإحالة المتقاطعة وإزاحات المقطع الختامي وأي /ID مقطع ختامي سابق، فتؤثر تغييرات الصفحة والمرفقات والبيانات الوصفية والموارد في المعرّف بينما لا تؤثرها إزاحات التخطيطيُحدَّث المعرّف في الحفظ الكامل فقط. ولا تعيد التحديثات التزايدية كتابة المعرّف الدائم أبدًا، ويحتفظ المستندات المشفرة بمعرّفها القائم لأن مدخل
/ID الأول يشارك في اشتقاق مفتاح التشفير. وتبقى التواريخ التلقائية وسائر البيانات الوصفية المتطايرة للمستخدم جزءًا من المحتوى؛ فاضبطها صراحةً عندما يجب أن يتلقى مستندان مولَّدان باستقلال المعرّف المشتق من المحتوى نفسه
مثال
PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer IDانظر أيضًا
GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID