إزالة المؤلف والعنوان والخصائص المخصصة عند تحويل ملفات Office في Java
مستودع العينة المرافق (قيد النشر): remove-office-properties-java
إزالة بيانات التعريف الوصفية للـ Office هي سير عمل GroupDocs.Conversion للـ Java يقوم بمسح خصائص المستند المصدر أثناء تصدير ملفات Office. وهو يعالج جزءًا صغيرًا لكنه سهل الفوت من عملية تسليم المستند: قد يبدو الملف جاهزًا بينما لا يزال حقل المؤلف أو العنوان أو المرجع الداخلي يصف مسودة. تتبع هذه المقالة تقرير Word عبر هذا القرار، ثم تطبق نفس السياسة على Excel وPowerPoint. الكود مثبت على الإصدار 26.10 ويستخدم ملفات إدخال خيالية.
المقدمة
افترض أن تقريرًا يخرج من عملية مراجعة داخلية. العنوان الظاهر صحيح، والأشكال معتمدة، وملف PDF يفتح بشكل طبيعي. لا يخبرك أي من هذه الفحوصات بما يحتويه حقل Author. يمكن لملف Excel أو عرض تقديمي أيضًا أن يحمل خاصية مخصصة ذات معنى داخل فريق ولكن لا تضيف شيئًا إلى المنتج الخارجي. اعتبر هذه المعلومات قرار تصدير بدلاً من مفاجأة يكتشفها المستلم.
العينة تنتج نسختين من كل تقرير. واحدة تحتفظ بخصائص المصدر؛ والأخرى تطلب إزالة الخصائص المدمجة والمخصصة. كما تكتب نسخة Office بنفس التنسيق لكل تشغيل حتى يمكن فحص القيم المفحوصة بشكل مستقل. هذا مثال مراقب عن قصد. نريد دليلًا على أن الإعدادات غيرت الناتج، وليس افتراضًا بناءً على مظهر الصفحة الأولى.
لماذا تنظيف الخصائص مهم عند التصدير
خطوة التصدير هي المكان الذي يتحول فيه المستند المصدر إلى قطعة تسليم. وهذا يجعلها نقطة مفيدة لتقرير ما إذا كانت الخصائص الداخلية يجب أن تسافر مع المحتوى. GroupDocs.Conversion للـ Java 26.10 يتيح ضوابط منفصلة للخصائص المدمجة والمخصصة للمستند. يمكنك تطبيقها أثناء تحميل مصدر Office، قبل حفظ PDF. المثال يفعّل الفئتين للنسخة الخارجية.
هذا ليس بديلاً عن مراجعة المستند نفسه. قد يظهر اسم المؤلف أيضًا في فقرة أو خلية أو ملاحظة أو ملف مضمّن. تلك المواقع تحتاج إلى معالجة منفصلة. أصف الميزة بأنها تنظيف خصائص في خط أنابيب التصدير، لأن هذه الصياغة تتطابق مع ما يثبت الكود فعليًا. كما أنها تتجنب الوعد بنتيجة خصوصية أوسع مما يغطي الاختبار.
متى يجب مسح خصائص Office؟
امسح خصائص المصدر عندما تستثني سياسة التسليم الخاصة بك المؤلف الداخلي أو عناوين المسودات أو حقول المرجع المخصصة من التقرير المصدّر. اضبط خيارات التحميل قبل إنشاء Converter، وقارن بين المخرجات المحتفظ بها والمنقاة باستخدام علامات معروفة. يغطي المثال مصادر DOCX وXLSX وPPTX. راجع المحتوى الظاهر بشكل منفصل، واسمح لحقول PDF التي يولدها الإخراج مثل Producer بالبقاء بعد التنظيف.
المتطلبات المسبقة
المشروع الكامل يستخدم JDK 11، Maven وGroupDocs.Conversion للـ Java 26.10. يحتوي دليل المستندات على ثلاثة تقارير خيالية. تحتاج إلى ترخيص يغطي هذا الإصدار للتحقق غير المقيد؛ قد تمنع حدود التقييم إكمال المقارنة بالكامل. الكود يبقي إعداد الترخيص خارج طرق الميزة ويستخدم عنصر نائب في المصدر الموزع. لا تضع ملف ترخيص في المشروع.
التثبيت
ملف pom.xml الخاص بالمشروع يعلن عن مستودع Java الخاص بـ GroupDocs والاعتماد الموضح أدناه. شغّل أمر Maven من دليل المشروع هذا. كتل Java في هذه المقالة هي أجسام طرق من العينة التي تم التحقق منها؛ تفترض الاستيرادات ذات الصلة، وجود دليل Result، ومعامل منطقي اسمه clear.
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-conversion</artifactId>
<version>26.10</version>
</dependency>
mvn compile exec:java
الخطوة 1: جعل سياسة الخصائص صريحة
الطرق الثلاث تستقبل نفس السياسة المنطقية. تمرير false يحتفظ بإعدادات المصدر لتشغيل تحكم؛ تمرير true يطلب إزالة الفئتين. في WordProcessingLoadOptions، تُستخدم الطرق setClearBuiltInDocumentProperties وsetClearCustomDocumentProperties. SpreadsheetLoadOptions وPresentationLoadOptions يقدمان الضوابط المقابلة. يتيح هذا التناسق مراجعة سياسة واحدة عبر ثلاث عائلات إدخال متميزة دون إخفاء أي محمل يفتح كل ملف.
تشغيل النسخة المحتفظ بالخصائص مهم. إذا لم يصل علامة المصدر إلى الإخراج العادي، فإن إخراج نظيف فارغ يُعد دليلًا ضعيفًا. لذلك يتحقق العرض من وجود كل علامة في نسخة Office المحتفظ بها وغيابها في النسخة المنقاة. هذا يمنح المقارنة تحكمًا إيجابيًا. احتفظ باختبار مماثل عندما تُدخل قالب مستند جديد أو تغير نسخة الاعتماد.
الخطوة 2: تصدير تقرير Word
مسار Word يبدأ بـ documents/report.docx. يحتوي على خصائص مستند خيالية وتقرير مرئي قصير. convertWord ينشئ خيارات مكتوبة، يعيّن السياسة، ويوفر تلك الخيارات عبر مُنشئ Converter. الطريقة تكتب PDF للتسليم ونسخة DOCX لفحص الخصائص. كلاهما ملفات إخراج جديدة؛ المصدر لا يُعاد كتابته في هذه العينة.
WordProcessingLoadOptions options = new WordProcessingLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/docx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.docx", () -> options)) {
converter.convert(target + ".pdf", new PdfConvertOptions());
converter.convert(target + ".docx", new WordProcessingConvertOptions());
}
اسم الهدف ينتهي بـ retained أو clean بناءً على الوسيط المنطقي. هذا التمييز يمنع تشغيلين من الكتابة فوق بعضهما. كما يجعل المراجعة اليدوية أسهل: افتح PDF لتفقد العرض وافحص نسخة Office المقابلة للتحقق من تخزين الخصائص. في التشغيل المُتحقق، بقيت خصائص Author وTitle في PDF المحتفظ به واختفت من PDF المنقّى. بقيت معلومات Producer، وهي حقل منفصل يولده الإخراج.
الخطوة 3: تطبيق السياسة على Excel وPowerPoint
لتقرير Excel، استخدم SpreadsheetLoadOptions بدلاً من إعادة استخدام محمل Word. يظل كود التحويل يحمل نفس أعلام الخصائص ويغيّر عائلة الإدخال وخيارات التحكم بنفس التنسيق. ملف XLSX المضمن يحتوي على فراغات فارغة متعمدة، لذا فإن ترقيم صفحاته ليس جزءًا من تأكيد البيانات الوصفية. افحص صفحات PDF بالإضافة إلى نتيجة الخصائص عند تكييفه لتقرير أعمال. نجاح الخصائص لا يثبت أن ورقة واسعة تُطبع كما هو مقصود.
SpreadsheetLoadOptions options = new SpreadsheetLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/xlsx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.xlsx", () -> options)) {
converter.convert(target + ".pdf", new PdfConvertOptions());
converter.convert(target + ".xlsx", new SpreadsheetConvertOptions());
}
يتبع PowerPoint نفس سياسة التحميل باستخدام PresentationLoadOptions. الشريحة المضمنة تحتوي على نص تقرير خيالي، بينما يعيش المؤلف والعنوان والمرجع المخصص في أجزاء خصائص المستند. الطريقة تحفظ PDF بالإضافة إلى PPTX بحيث يبقى مقارنة الخصائص مستقلة عن عرض الشريحة. لا يتم فحص ملاحظات المتحدث أو الكائنات المضمّنة. إذا كانت هذه الأمور مهمة لعملية التسليم الخاصة بك، أدرجها في مراجعة منفصلة قبل الإصدار.
PresentationLoadOptions options = new PresentationLoadOptions();
options.setClearBuiltInDocumentProperties(clear);
options.setClearCustomDocumentProperties(clear);
String target = "Result/pptx-" + (clear ? "clean" : "retained");
try (Converter converter = new Converter("documents/report.pptx", () -> options)) {
converter.convert(target + ".pdf", new PdfConvertOptions());
converter.convert(target + ".pptx", new PresentationConvertOptions());
}
الخطوة 4: التحقق من النتيجة بدلاً من التخمين
PropertyChecks يفحص أجزاء الخصائص للستة ملفات Office المتحكم فيها. يبحث عن Internal Review Team، Quarterly Review Draft وINTERNAL-REF-2610. يجب أن تحتوي النسخ المحتفظ بها على تلك القيم المعروفة، ويجب أن تحذف النسخ المنقاة تلك القيم. يطبع التطبيق سطر PASS لكل ملف مفحوص ويفشل إذا لم تتطابق المقارنة مع التوقع. هذا الفحص مرتبط بالبيانات الخيالية، وليس تأكيدًا على اكتشاف وتصنيف بيانات وصفية عشوائية.
كما فحصنا حقل Author وTitle في PDF باستخدام Poppler pdfinfo. اختفت كلا الحقلين في الصادرات المنقاة من جميع مصادر Office الثلاثة. بقي حقل Producer المولد. هذه النتيجة مفيدة لأنها تضيق الادعاء: تم إزالة خصائص المصدر المطلوبة، بينما لا يزال PDF قادرًا على تحديد البرنامج الذي أنشأه. لا تحول ذلك إلى وعد بوجود قاموس بيانات وصفية فارغ تمامًا.
مثال عملي كامل
OfficeMetadataDemo هو نقطة الدخول في مشروع Maven المرافق. ينشئ دليل Result/، يشغّل جميع طرق التحويل الثلاثة مع false وtrue، ويستدعي PropertyChecks. تُحفظ الأداة منفصلة عن طرق الميزة حتى تظل مقتطفات التحويل قابلة للقراءة. يوضح RUN.md كيفية تطبيق الترخيص المحلي الخاص بك. المستندات المضمنة خيالية ويمكن استخدامها دون اعتماد على بيانات عميل.
تطبيقات واقعية
تسليم تقارير العملاء
يمكن لخدمة تصدير إنتاج PDF الخارجي فقط بعد موافقة التقرير. طبّق سياسة الخصائص في مسار التحويل هذا واحتفظ بالمستند Office الأصلي في موقعه الداخلي الحالي. تجنّب تضمين النسخ المحتفظ بها في حزمة العميل. هي موجودة هنا لجعل الاختبار مرئيًا.
تقديمات Office مختلطة
قد يتلقى فريق تقارير سردية، جداول عمل وملخصات عروض تقديمية. استخدم محملًا مكتوبًا لكل عائلة إدخال وطبق سياسة موثقة باستمرار. سنبقي قرار عائلة الملف مرئيًا في الشيفرة بدلاً من استنتاج الدعم من مثال DOCX واحد ناجح. أضف بيانات تمثيلية عند إدخال قالب آخر.
أفضل الممارسات والنصائح
احتفظ بتنظيف الخصائص وإزالة المعلومات كمتطلبات منفصلة. قرّر أي الخصائص ضرورية للإثبات قبل مسحها. خزن مخرجات التسليم بعيدًا عن الضوابط الداخلية وتعامل مع إعداد الترخيص كتهيئة محلية. عند ترقية SDK، أعد تشغيل النسختين المحتفظ والمنقاة حتى يصبح أي تغيير غير متوقع مرئيًا على أي جانب من المقارنة.
استكشاف المشكلات الشائعة
إذا توقفت العرض الكامل في وضع التقييم، طبّق ترخيصًا يغطي 26.10 في نسختك المحلية وأعد تشغيله. إذا بقيت علامة في النص الظاهر، فهذا خارج فحص تخزين الخصائص هذا. إذا كان تنظيف إدخال PDF هو مطلبك، لا تستبدله في هذه العينة: فشل فحص 26.10 منفصل مع رسالة “CreationDate value is empty” عندما تم تمكين مسح الخصائص المدمجة. نطاق المصدر المختبر في المقالة هو Office.
الخلاصة
ابدأ بالبيانات التمثيلية المرفقة وافحص أزواج المحتفظ والمنقاة. تحقق من خصائص المصدر المسماة، ثم راجع محتوى PDF الفعلي. استبدل البيانات التمثيلية بقوالب معتمدة فقط بعد أن يتصرف هذا المقارنة كما هو متوقع. حافظ على سياسة التصدير قريبة من خيارات التحميل حتى يتمكن المطور التالي من رؤية أي خصائص تغادر النظام.