إدارة خصائص المستند

مقدمة

يوفر Microsoft Excel القدرة على إضافة خصائص إلى ملفات جداول البيانات. توفر هذه الخصائص المستندية معلومات مفيدة وتنقسم إلى فئتين كما هو موضح أدناه.

  • الخصائص المعرفة مسبقًا (المدمجة): الخصائص المدمجة تحتوي على معلومات عامة حول المستند مثل عنوان المستند واسم المؤلف وإحصائيات المستند وما إلى ذلك.
  • الخصائص المخصصة (المخصصة): الخصائص المخصصة المحددة من قبل المستخدم النهائي في شكل زوج اسم-قيمة.

إدارة خصائص المستند باستخدام Microsoft Excel

يتيح Microsoft Excel إدارة خصائص المستند في ملفات Excel بطريقة WYSIWYG. يرجى اتباع الخطوات التالية لفتح حوار Properties في Excel 2016.

  1. من القائمة ملف, حدد معلومات.
اختيار قائمة المعلومات
todo:image_alt_text
  1. انقر على عنوان الخصائص وحدد “الخصائص المتقدمة”.
النقر على اختيار الخصائص المتقدمة
todo:image_alt_text
  1. إدارة خصائص مستند الملف.
مربع الحوار الخصائص
todo:image_alt_text
في مربع حوار الخصائص، هناك علامات تبويب مختلفة، مثل العامة، والملخص، والإحصائيات، والمحتويات، والمخصصة. تساعد كل علامة تبويب في تكوين أنواع مختلفة من المعلومات ذات الصلة بالملف. تُستخدم علامة التبويب المخصصة لإدارة الخصائص المخصصة.

العمل مع خصائص المستند باستخدام Aspose.Cells

يمكن للمطورين إدارة خصائص الوثيقة بشكل ديناميكي باستخدام واجهات برمجة التطبيقات Aspose.Cells. تساعد هذه الميزة المطورين في تخزين معلومات مفيدة إلى جانب الملف، مثل متى تم استلام الملف ومعالجته وتسجيل الوقت وما إلى ذلك.

الوصول إلى خصائص المستند

تدعم واجهات برمجة التطبيقات Aspose.Cells كلا من أنواع خصائص المستند، المدمجة والمخصصة. يمثل Workbook لـ Aspose.Cells ملف Excel و، مثل ملف Excel، يمكن أن يحتوي Workbook الفصول المتعددة، يمثل كل منها بواسطة فئة Worksheet في حين أن مجموعة الفصول تمثل بواسطة فئة WorksheetCollection.

استخدم WorksheetCollection للوصول إلى خصائص المستند كما هو موضح أدناه.

كل من WorksheetCollection.BuiltInDocumentProperties وWorksheetCollection.CustomDocumentProperties تعيد نموذجًا من صنف DocumentPropertyCollection. تحتوي هذه المجموعة على DocumentProperty كائن، كل منها يُمثل خاصية مستند مدمجة أو مخصصة واحدة.

من متطلبات التطبيق كيفية الوصول إلى الخاصية ، أي؛ باستخدام فهرس أو اسم الخاصية من DocumentPropertyCollection كما هو موضح في المثال أدناه.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
// Accessing a custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("ContentTypeId");
System.out.println(customProperty1.getName() + " " + customProperty1.getValue());
// Accessing a custom document property by using the property index
DocumentProperty customProperty2 = customProperties.get(0);
System.out.println(customProperty2.getName() + " " + customProperty2.getValue());

يتيح فئة DocumentProperty استرداد اسم وقيمة ونوع خاصية المستند:

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
// Accessing a custom document property
DocumentProperty customProperty1 = customProperties.get(0);
// Storing the value of the document property as an object
Object objectValue = customProperty1.getValue();
// Accessing a custom document property
DocumentProperty customProperty2 = customProperties.get(1);
// Checking the type of the document property and then storing the value of the
// document property according to that type
if (customProperty2.getType() == PropertyType.STRING)
{
String value = customProperty2.getValue().toString();
}

إضافة أو إزالة الخصائص المخصصة للمستند

كما وصفنا في وقت سابق في بداية هذا الموضوع ، لا يمكن للمطورين إضافة أو إزالة الخصائص المدمجة لأن هذه الخصائص محددة من النظام ولكن من الممكن إضافة أو إزالة الخصائص المخصصة لأنها معرفة من قبل المستخدم.

إضافة الخصائص المخصصة

قدمت واجهات برمجة التطبيقات الخاصة بـ Aspose.Cells الطريقة add لفئة CustomDocumentPropertyCollection من أجل إضافة خصائص مخصصة إلى المجموعة. تقوم الطريقة add بإضافة الخاصية إلى ملف Excel وتُرجع مرجعًا لخاصية المستند الجديدة ككائن DocumentProperty.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
// Adding a custom document property to the Excel file
DocumentProperty publisher = customProperties.add("Publisher", "Aspose");

تكوين خاصية مخصصة “ربط بالمحتوى”

لإنشاء خاصية مخصصة مرتبطة بمحتوى نطاق محدد ، اتصل بالطريقة CustomDocumentPropertyCollection.addLinkToContent وقم بتمرير اسم الخاصية والمصدر. يمكنك التحقق مما إذا كانت الخاصية مكونة كمرتبطة بالمحتوى باستخدام الخاصية DocumentProperty.isLinkedToContent. علاوة على ذلك ، من الممكن أيضًا الحصول على نطاق المصدر باستخدام الخاصية Source من فئة DocumentProperty.

نحن نستخدم ملف نموذجي بسيط لبرنامج Microsoft Excel في المثال. يحتوي دفتر العمل على نطاق مسمى محدد يحمل التسمية MyRange والذي يشير إلى قيمة الخلية.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
// Add link to content.
customProperties.addLinkToContent("Owner", "MyRange");
// Accessing the custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("Owner");
// Check whether the property is lined to content
Boolean islinkedtocontent = customProperty1.isLinkedToContent();
// Get the source for the property
String source = customProperty1.getSource();

إزالة الخصائص المخصصة

لإزالة الخصائص المخصصة باستخدام Aspose.Cells، قم بالاتصال بالطريقة DocumentPropertyCollection.remove وقم بتمرير اسم خاصية المستند التي تريد إزالتها.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
// Removing a custom document property
customProperties.remove("Publisher");