إنشاء جدول من جدول البيانات

مقدمة

إن إنشاء الجداول ديناميكيًا من مصادر البيانات يعد مهمة شائعة في العديد من التطبيقات. سواء كنت تقوم بإنشاء تقارير أو فواتير أو ملخصات بيانات، فإن القدرة على ملء جدول بالبيانات برمجيًا يمكن أن توفر لك الكثير من الوقت والجهد. في هذا البرنامج التعليمي، سنستكشف كيفية إنشاء جدول من جدول بيانات باستخدام Aspose.Words for Java. سنقوم بتقسيم العملية إلى خطوات يمكن إدارتها، مما يضمن لك فهمًا واضحًا لكل جزء.

المتطلبات الأساسية

قبل الغوص في الكود، دعنا نتأكد من أن لديك كل ما تحتاجه للبدء:

مجموعة تطوير Java (JDK): تأكد من تثبيت JDK على جهازك. يمكنك تنزيله من موقع أوراكل .
Aspose.Words for Java: ستحتاج إلى مكتبة Aspose.Words. يمكنك تنزيل أحدث إصدار من صفحة إصدارات Aspose .
IDE: بيئة التطوير المتكاملة (IDE) مثل IntelliJ IDEA أو Eclipse سوف تجعل عملية البرمجة أسهل.
المعرفة الأساسية بلغة Java: ستساعدك المعرفة بمفاهيم برمجة Java على فهم مقتطفات التعليمات البرمجية بشكل أفضل.
بيانات العينة: في هذا البرنامج التعليمي، سنستخدم ملف XML باسم “List of people.xml” لمحاكاة مصدر البيانات. يمكنك إنشاء هذا الملف باستخدام بيانات العينة للاختبار.

الخطوة 1: إنشاء مستند جديد

أولاً، نحتاج إلى إنشاء مستند جديد حيث سيتم وضع الجدول. هذا هو القماش الذي سنستخدمه في عملنا.

Document doc = new Document();

هنا، نقوم بإنشاء مثيل جديدDocument الكائن. سيكون هذا بمثابة وثيقة العمل التي سنقوم من خلالها ببناء الجدول الخاص بنا.

الخطوة 2: تهيئة DocumentBuilder

بعد ذلك، سوف نستخدمDocumentBuilder الفئة، التي تسمح لنا بالتعامل مع المستند بسهولة أكبر.

DocumentBuilder builder = new DocumentBuilder(doc);

الDocumentBuilder يوفر الكائن طرقًا لإدراج الجداول والنصوص والعناصر الأخرى في المستند.

الخطوة 3: تعيين اتجاه الصفحة

نظرًا لأننا نتوقع أن يكون جدولنا عريضًا، فسوف نقوم بتعيين اتجاه الصفحة إلى أفقي.

doc.getFirstSection().getPageSetup().setOrientation(Orientation.LANDSCAPE);

تعتبر هذه الخطوة بالغة الأهمية لأنها تضمن أن الجدول الخاص بنا يتناسب بشكل جيد مع الصفحة دون أن يتم قطعه.

الخطوة 4: تحميل البيانات من XML

الآن، نحتاج إلى تحميل بياناتنا من ملف XML إلىDataTableومن هنا تأتي بياناتنا.

DataSet ds = new DataSet();
ds.readXml(getMyDir() + "List of people.xml");
DataTable dataTable = ds.getTables().get(0);

هنا، نقرأ ملف XML ونسترد الجدول الأول من مجموعة البيانات.DataTable سوف تحتوي على البيانات التي نريد عرضها في مستندنا.

الخطوة 5: استيراد الجدول من DataTable

الآن يأتي الجزء المثير: استيراد بياناتنا إلى المستند على شكل جدول.

Table table = importTableFromDataTable(builder, dataTable, true);

نحن نطلق على هذه الطريقةimportTableFromDataTable ، مروراDocumentBuilder ، ملكناDataTable، وقيمة منطقية للإشارة إلى ما إذا كان سيتم تضمين عناوين الأعمدة.

الخطوة 6: تصميم الجدول

بمجرد أن نحصل على طاولتنا، يمكننا تطبيق بعض التصميمات عليها لجعلها تبدو جيدة.

table.setStyleIdentifier(StyleIdentifier.MEDIUM_LIST_2_ACCENT_1);
table.setStyleOptions(TableStyleOptions.FIRST_ROW | TableStyleOptions.ROW_BANDS | TableStyleOptions.LAST_COLUMN);

يطبق هذا الكود نمطًا محددًا مسبقًا على الجدول، مما يعزز جاذبيته البصرية وسهولة قراءته.

الخطوة 7: إزالة الخلايا غير المرغوب فيها

إذا كان لديك أي أعمدة لا تريد عرضها، مثل عمود صورة، فيمكنك إزالته بسهولة.

table.getFirstRow().getLastCell().removeAllChildren();

تضمن هذه الخطوة أن يعرض جدولنا المعلومات ذات الصلة فقط.

الخطوة 8: حفظ المستند

وأخيرًا، نحفظ مستندنا بالجدول الذي تم إنشاؤه.

doc.save(getArtifactsDir() + "WorkingWithTables.BuildTableFromDataTable.docx");

يحفظ هذا السطر المستند في الدليل المحدد، مما يسمح لك بمراجعة النتائج.

طريقة importTableFromDataTable

دعونا نلقي نظرة فاحصة علىimportTableFromDataTable الطريقة. هذه الطريقة مسؤولة عن إنشاء بنية الجدول وملئها بالبيانات.

الخطوة 1: ابدأ الجدول

أولاً، علينا أن نبدأ جدولاً جديدًا في المستند.

Table table = builder.startTable();

يؤدي هذا إلى تهيئة جدول جديد في مستندنا.

الخطوة 2: إضافة عناوين الأعمدة

إذا أردنا تضمين عناوين الأعمدة، نتحقق منimportColumnHeadings علَم.

if (importColumnHeadings) {
    // تخزين التنسيق الأصلي
    boolean boldValue = builder.getFont().getBold();
    int paragraphAlignmentValue = builder.getParagraphFormat().getAlignment();

    // تعيين تنسيق العنوان
    builder.getFont().setBold(true);
    builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);

    // إدراج أسماء الأعمدة
    for (DataColumn column : dataTable.getColumns()) {
        builder.insertCell();
        builder.writeln(column.getColumnName());
    }

    builder.endRow();

    // استعادة التنسيق الأصلي
    builder.getFont().setBold(boldValue);
    builder.getParagraphFormat().setAlignment(paragraphAlignmentValue);
}

يقوم هذا الكتلة من التعليمات البرمجية بتنسيق صف العنوان وإدراج أسماء الأعمدة منDataTable.

الخطوة 3: ملء الجدول بالبيانات

الآن، نمر عبر كل صف منDataTable لإدراج البيانات في الجدول.

for (DataRow dataRow : (Iterable<DataRow>) dataTable.getRows()) {
    for (Object item : dataRow.getItemArray()) {
        builder.insertCell();
        switch (item.getClass().getName()) {
            case "DateTime":
                Date dateTime = (Date) item;
                SimpleDateFormat simpleDateFormat = new SimpleDateFormat("MMMM d, yyyy");
                builder.write(simpleDateFormat.format(dateTime));
                break;
            default:
                builder.write(item.toString());
                break;
        }
    }
    builder.endRow();
}

في هذا القسم، سنتعامل مع أنواع مختلفة من البيانات، وتنسيق التواريخ بشكل مناسب أثناء إدراج بيانات أخرى كنص.

الخطوة 4: إنهاء الجدول

وأخيرًا، ننتهي من الجدول بعد إدخال كافة البيانات.

builder.endTable();

يشير هذا الخط إلى نهاية جدولنا، مما يسمح بـDocumentBuilder لنعلم أننا انتهينا من هذا القسم.

خاتمة

والآن، لقد تعلمت بنجاح كيفية إنشاء جدول من جدول بيانات باستخدام Aspose.Words for Java. باتباع هذه الخطوات، يمكنك بسهولة إنشاء جداول ديناميكية في مستنداتك استنادًا إلى مصادر بيانات مختلفة. سواء كنت تقوم بإنشاء تقارير أو فواتير، فإن هذه الطريقة ستبسط سير عملك وتعزز عملية إنشاء المستندات.

الأسئلة الشائعة

ما هو Aspose.Words لـ Java؟

Aspose.Words for Java عبارة عن مكتبة قوية لإنشاء مستندات Word ومعالجتها وتحويلها برمجيًا.

هل يمكنني استخدام Aspose.Words مجانًا؟

نعم، تقدم Aspose نسخة تجريبية مجانية. يمكنك تنزيلها من هنا .

كيف أقوم بتنسيق الجداول في Aspose.Words؟

بإمكانك تطبيق الأنماط باستخدام معرفات الأنماط المحددة مسبقًا والخيارات التي توفرها المكتبة.

ما هي أنواع البيانات التي يمكنني إدراجها في الجداول؟

يمكنك إدراج أنواع مختلفة من البيانات، بما في ذلك النصوص والأرقام والتاريخ، والتي يمكن تنسيقها وفقًا لذلك.

أين يمكنني الحصول على الدعم لـ Aspose.Words؟

يمكنك العثور على الدعم وطرح الأسئلة على منتدى اسبوس .

Go Top