نحن سعداء أن نعلن عن إصدار GroupDocs.Assembly for Java 26.11، المتاح اعتبارًا من نوفمبر 2026. يجلب هذا الإصدار الميزات والإصلاحات من GroupDocs.Assembly for .NET 26.11 إلى Java:

  • يمكن فحص القوالب مقابل JSON Schema؛
  • يمكن تحويل صفحات القوالب والتقارير إلى صور؛
  • تحميل الموارد الخارجية يكون تحت سيطرة التطبيق؛
  • REMOVE_EMPTY_PARAGRAPHS يعمل مع قوالب جداول البيانات والنص العادي؛
  • وسوم <<image>> تعمل في خلايا الجداول في العروض التقديمية وتقوم بحل المسارات النسبية مقابل مجلد القالب؛
  • وسوم اللون تقبل سلاسل hex.

تم نقل محركات Aspose المدمجة من إصداراتها المبكرة في 2026 إلى 26.10، وتغطي مجموعة من الإصلاحات الترخيص، ترميز التقارير، الباركود ومحتوى HTML. لا يزال Java 8 هو الأساس.

ما الجديد في هذا الإصدار

المفتاح الملخص الفئة
ASSEMBLYNET-145 JsonDataSource يقبل JSON Schema: يمكن الإشارة إلى الأعضاء المعلن عنها في المخطط حتى عندما تكون null أو فارغة أو مفقودة في البيانات، وأنواع القيم تأتي من المخطط ميزة
ASSEMBLYNET-8 DocumentAssembler.generatePreview يقوم بتحويل صفحات القوالب، التقارير المجمعة وغيرها من المستندات إلى صور PNG أو JPEG أو BMP ميزة
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS يعمل مع قوالب جداول البيانات ومستندات النص العادي ميزة
ASSEMBLYNET-140 الموارد الخارجية التي تشير إليها القوالب والبيانات تكون تحت سيطرة التطبيق؛ الموارد التي تأتي مراجعها من البيانات يتم تخطيها افتراضيًا أمان
ASSEMBLYJAVA-353 تم دمج Aspose.Words 26.10.1، Aspose.Cells 26.10، Aspose.Slides 26.10، Aspose.Email 26.9 و Aspose.BarCode 26.10 تحديث
ASSEMBLYJAVA-353 باركودات GS1 (EAN-14، SCC-14، SSCC-18 و DataBar) تحتفظ بالتصحيح التلقائي لنص الكود باستخدام Aspose.BarCode 26.10 إصلاح
ASSEMBLYNET-52 وسم <<image>> يعمل في خلية جدول في عرض تقديمي، وتتم معالجة الوسوم في أشكال المجموعات تحسين
ASSEMBLYNET-62 مسار صورة نسبي من البيانات يتم حله مقابل مجلد القالب تحسين
ASSEMBLYNET-25 يمكن أن يكون اللون المعطى كسلسلة قيمة hex في وسوم backColor ووسوم ألوان المخطط تحسين
ASSEMBLYNET-155 القيمة المنطقية المفقودة في بيانات JSON أو XML أو CSV تُحسب كـ false في ?: وفي where و count و any و all و first بدلاً من الفشل بـ NullPointerException إصلاح
ASSEMBLYNET-157 groupBy و distinct على الكائنات المتداخلة تدمج الكائنات المتساوية؛ مراجع $id/$ref لبيانات JSON مدعومة إصلاح
ASSEMBLYNET-142 License.setLicense(InputStream) يقرأ تدفقًا تم قراءته مسبقًا من بدايته إصلاح
ASSEMBLYNET-143 استهلاك الترخيص القائم على القياس يتم الإبلاغ عنه عند إكمال العملية إصلاح
ASSEMBLYNET-158 تقارير النص وHTML للقوالب التي تحتوي على ASCII فقط تُكتب بـ UTF-8، لذا لا تُفقد البيانات غير اللاتينية إصلاح
ASSEMBLYNET-160 الباركودات لم تعد تفشل بـ NullPointerException عندما لا يكون خط صندوق النص مثبتًا إصلاح
ASSEMBLYNET-159 الوسوم في موضوع المحادثة لقالب MSG تُجمع مثل وسوم العنوان إصلاح
ASSEMBLYNET-152 وسم <<doc>> في قالب جدول بيانات أو عرض تقديمي أو نص يفشل برسالة واضحة؛ فشل assembleDocument لا يترك ملف إخراج فارغ إصلاح
ASSEMBLYJAVA-354 وسم تعبير -html الذي ينهي الفقرة لا يترك فقرة فارغة بعد HTML ينتهي بعنصر كتلة إصلاح

تغييرات السلوك التي يجب التحقق منها قبل الترقية

  1. الموارد الخارجية من البيانات يتم تخطيها افتراضيًا. على سبيل المثال، <<image [item.PhotoUrl]>> حيث PhotoUrl هو URI http أو https الآن ينتج صورة فارغة. أضف المضيفين إلى LoadSaveOptions.getWhitelistedResources()، أو استدعِ LoadSaveOptions.setSkipExternalResources(false) للحفاظ على السلوك السابق. الموارد التي يشير إليها القالب نفسه ومسارات الملفات المحلية تعمل كما كانت.

  2. استدعاء JsonDataSource غير واضح. new JsonDataSource(path, null) مع معامل ثاني null حرفيًا لم يعد يُترجم. قم بتحويل النوع: new JsonDataSource(path, (JsonDataLoadOptions) null). التطبيقات المترجمة لا تتأثر.

  3. تقارير النص وHTML بترميز UTF-8. تقارير النص وHTML للقوالب التي تحتوي على ASCII فقط دون علامة ترتيب البايت الآن تُكتب بـ UTF-8 بدلاً من windows-1252. للحفاظ على صفحة ترميز بايت واحد، أعلن عنها في القالب (<meta charset> في HTML).

  4. groupBy و distinct على الكائنات المتداخلة لبيانات JSON وXML وDataSet الآن تدمج الكائنات المتساوية بدلاً من إعطاء مجموعة واحدة لكل صف.

  5. لا فقرة إضافية بعد HTML. وسوم -html الذي ينهي الفقرة لا يترك فقرة فارغة بعد HTML ينتهي بعنصر كتلة. للحفاظ على سطر فارغ، أنهِ HTML بـ <p>&nbsp;</p>.

  6. باركودات DataBar Expanded. باركود DataBar Expanded أو DataBar Expanded Stacked الذي يحتوي نص كود مكوّن من أرقام فقط الآن يُشفّر كـ GTIN مع معرف التطبيق (01)، مثل الأنواع الأخرى من DataBar.

  7. نص الاستثناء تم تغييره لوسم <<doc>> في قوالب جدول البيانات والعرض التقديمي والنص؛ نوع الاستثناء هو نفسه.

  8. تم إزالة API. تم إزالة ICustomFontsHandler.resetFontSources()؛ استدعِ FontSettings.resetFontSources() بدلاً من ذلك.

الميزات الجديدة

دعم JSON Schema لـ JsonDataSource

يتم فحص القالب مقابل بنية بياناته قبل تقييم أي <<if>>. مع JSON، كانت تلك البنية مأخوذة من البيانات نفسها، لذا كان المرجع داخل فرع لا يتم عرضه يفشل عندما تكون البيانات خلفه null أو مصفوفة فارغة أو مفقودة.

JsonDataSource الآن يقبل JSON Schema، بنفس الطريقة التي يقبل بها XmlDataSource XML Schema، ويتم فحص القالب مقابل المخطط:

  • يمكن الإشارة إلى الأعضاء المعلن عنها في المخطط حتى وإن كانت null أو فارغة أو غائبة في البيانات؛
  • الأعضاء غير المعلن عنها في المخطط لا يزال فشلها يحدث، لذا تُكتشف الأسماء المكتوبة خطأ كما كان من قبل؛
  • أنواع القيم تأتي من المخطط، لذا فإن القيمة المنطقية هي Boolean والسلسلة التي تحتوي أرقامًا تظل سلسلة.

مع عميل لا يمتلك بطاقات دفع ولا بيانات ولاء، ورقم حساب هو سلسلة من الأرقام:

{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "Name": { "type": "string" },
    "Account": { "type": "string" },
    "Cards": {
      "type": "array",
      "items": { "type": "object", "properties": { "Type": { "type": "string" }, "Last4": { "type": "string" } } }
    },
    "Loyalty": { "type": ["object", "null"], "properties": { "Level": { "type": "string" } } }
  }
}

وهذا القالب:

Customer: <<[customer.Name]>>
Account number: <<[customer.Account]>>
<<if [customer.Cards.count() > 0]>>Payment card: <<[customer.Cards.first().Type]>> ending in <<[customer.Cards.first().Last4]>><<else>>No payment card on file.<</if>>
Loyalty program: <<[customer.Loyalty?.Level]>>

مرّر المخطط بجانب البيانات:

JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));

النتيجة هي No payment card on file. مع رقم الحساب 00042. بدون المخطط، يفشل نفس القالب عند customer.Cards.first().Type، ويُقرأ رقم الحساب كرقم 42.

يمكن إعطاء المخطط كمسار ملف أو InputStream، مع أو بدون JsonDataLoadOptions. الكلمات المفتاحية المدعومة هي type (بما في ذلك الأنواع القابلة للـ null)، properties، items، format (date-time و date)، enum، const، allOf ومؤشرات $ref المحلية. لا يتم دعم oneOf، anyOf، not، $ref البعيد أو المتكرر، items بصيغة tuple ومصفوفات المصفوفات.

معاينة المستند

DocumentAssembler.generatePreview يحول صفحات المستند إلى صور PNG أو JPEG أو BMP: قالب، مستند تم تجميعه بواسطة GroupDocs.Assembly، أو أي مستند آخر بتنسيق مدعوم، من ملف أو تدفق. يتم تحويل صفحات مستندات معالجة النصوص، النص وHTML، صفحات جداول البيانات المطبوعة، شرائح العروض التقديمية ورسائل البريد الإلكتروني مع رأسها.

DocumentAssembler assembler = new DocumentAssembler();

ByteArrayOutputStream report = new ByteArrayOutputStream();
try (InputStream template = new FileInputStream("Customer orders.docx"))
{
    assembler.assembleDocument(template, report,
        new DataSourceInfo(new JsonDataSource("Customers.json"), "customers"));
}

// A stream is created for every page and released when the page is written.
PreviewOptions options = new PreviewOptions(
    pageNumber -> new FileOutputStream("page" + pageNumber + ".png"),
    (pageNumber, pageStream) -> pageStream.close());
options.setPreviewFormat(PreviewFormats.PNG);
options.setResolution(120);                    // dots per inch; 96 by default
// options.setPageNumbers(new int[] { 1, 2 }); // all pages by default

assembler.generatePreview(new ByteArrayInputStream(report.toByteArray()), options);

عند ضبط كل من setWidth و setHeight, يتم تحجيم الصفحات لتناسب ذلك الحجم مع الحفاظ على نسبة الأبعاد. تُولد المعاينات دون تحميل أي موارد خارجية، وتُحسب الصور المولدة ضمن الترخيص القائم على القياس مثل المستندات المجمعة.

REMOVE_EMPTY_PARAGRAPHS لقوالب جداول البيانات والنص العادي

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS الآن يعمل مع قوالب جداول البيانات ومستندات النص العادي أيضًا. هناك، الفقرة هي سطر نص: سطر من نص الخلية أو من مستند نصي، يصبح فارغًا بعد معالجة وسوم القالب يُحذف مع فاصل السطر الخاص به. الوسوم مثل <<if>> و <<foreach>> المكتوبة على أسطرها الخاصة لم تعد تترك أسطرًا فارغة خلفها.

DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));

القالب:

Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix

النتيجة:

Prefix
Suffix

نفس نص القالب في خلية جدول بيانات يعطي نفس النتيجة داخل الخلية. مستندات HTML وXML تبقى كما هي.

الأمان: التحكم في الموارد الخارجية

يمكن لوسم <<image>> أو <<doc>> أن يُقيم إلى URI مأخوذ من البيانات، وكان GroupDocs.Assembly يجلبه دون أي طريقة لمنعه. وبالتالي يمكن لخادم يجمع المستندات من بيانات يقدمها الآخرون أن يُجبر على طلب عناوين داخلية.

الآن يوضح GroupDocs.Assembly من أين يأتي كل مرجع لمورد خارجي (ExternalResourceOrigin):

  • TEMPLATE — مستند القالب يشير إلى المورد نفسه، بما في ذلك URI حرفي في وسم مثل <<image ["https://example.com/logo.png"]>>؛
  • DATA — المرجع يأتي من البيانات، مثل URI يُقيمه تعبير وسم.

افتراضيًا، تُحمَّل الموارد التي يشير إليها القالب كما كان من قبل، وتُتخطى الموارد التي تأتي مراجعها من البيانات. أربعة أعضاء من LoadSaveOptions يتحكمون في ذلك:

  • setSkipExternalResources (true افتراضيًا) — لا يتم تحميل الموارد الخارجية؛
  • setTrustTemplateResources (true افتراضيًا) — تُحمَّل الموارد التي يشير إليها القالب حتى عندما يكون التخطي مفعلاً؛ اضبطه على false عندما تكون القوالب من مصادر غير موثوقة؛
  • getWhitelistedResources — أسماء المضيفين أو بادئات URI المطلقة المسموح بها حتى عندما يكون التخطي مفعلاً؛
  • setExternalResourceHandler — ExternalResourceHandler يُستدعى لكل مورد خارجي قبل طلبه، للسماح به أو تخطيه أو توفير محتواه.
final String photoUri = "https://images.example.com/photos/no-photo.jpg";
DocumentAssembler assembler = new DocumentAssembler();

// Default options: the URI comes from data, so the image is skipped and left empty.
assembler.assembleDocument("Inserting image.docx", "Skipped.docx", new DataSourceInfo(photoUri, "expression"));

// Allow a trusted host and see every decision. The handler can also provide the content itself.
LoadSaveOptions options = new LoadSaveOptions();
options.getWhitelistedResources().add("images.example.com");
options.setExternalResourceHandler(new LocalImageHandler("no-photo.jpg"));

assembler.assembleDocument("Inserting image.docx", "Provided.docx", options, new DataSourceInfo(photoUri, "expression"));
public class LocalImageHandler extends ExternalResourceHandler
{
    private final String mImagePath;

    public LocalImageHandler(String imagePath) { mImagePath = imagePath; }

    @Override
    public void onLoading(ExternalResourceLoadingArgs args)
    {
        System.out.println(ExternalResourceOrigin.toString(args.getOrigin()) + " resource " + args.getUri() + ": "
            + (args.isSkipped() ? "skipped" : "allowed"));

        // Provide the content instead of requesting it.
        if (!args.isSkipped() && args.getUri().toLowerCase().startsWith("https://images.example.com/"))
        {
            try
            {
                args.setData(Files.readAllBytes(Paths.get(mImagePath)));
            }
            catch (IOException e)
            {
                throw new UncheckedIOException(e);
            }
        }
    }
}

الموارد الخارجية هي الموارد التي تصل إلى الشبكة: URIs http و https و ftp، مسارات UNC و URIs ملفات مع مضيف بعيد. مسارات الملفات المحلية لا تتأثر. تُستبدل الصورة المتخطاة في مستند بصورة شفافة؛ تُعامل القيمة المتخطاة لـ <<image>> أو <<doc>> كقيمة فارغة.

التحسينات

الصور في خلايا الجداول وأشكال المجموعات في العروض التقديمية

في قالب عرض تقديمي، كان يمكن وضع وسم <<image>> فقط في مربع نص. الآن خلية الجدول هي أيضًا حاوية صورة: تصبح الصورة تعبئة خلية الصورة، بما في ذلك خلايا الصفوف المتكررة بواسطة <<foreach>>، بحيث يمكن بناء جدول يسرد العناصر مع صورها. باستخدام -fitHeight، ينمو الصف لعرض الصورة بنسبة أبعادها. الوسوم في أشكال المجموعات، بما في ذلك المجموعات المتداخلة، تُعالج الآن مثل الأشكال الأخرى.

حل مسارات الصور النسبية مقابل مجلد القالب

وسم <<image>> الذي يحصل على مسار ملف نسبي من البيانات، مثل Images/photo.png، الآن يحله مقابل مجلد القالب أولاً، على غرار الموارد المرتبطة في مستندات Microsoft Office. للقالب المحمَّل من تدفق، اضبط المجلد باستخدام LoadSaveOptions.setResourceLoadBaseUri:

DocumentAssembler assembler = new DocumentAssembler();

// A template loaded from a stream has no folder: set it with setResourceLoadBaseUri.
LoadSaveOptions options = new LoadSaveOptions();
options.setResourceLoadBaseUri("C:\\Reports\\Templates");

try (InputStream template = new FileInputStream("C:\\Reports\\Templates\\Inserting image.docx");
     OutputStream report = new FileOutputStream("output-from-stream.docx"))
{
    assembler.assembleDocument(template, report, options, new DataSourceInfo("../Images/no-photo.jpg", "expression"));
}

إذا لم يكن هناك ملف هناك، يُستخدم الدليل الحالي كما كان من قبل.

سلاسل ألوان Hex

يمكن الآن أن يكون اللون المعطى كسلسلة قيمة hex — "#RRGGBB"، "#RGB" أو "#AARRGGBB" — بالإضافة إلى اسم اللون وعدد صحيح ARGB، في وسوم backColor وألوان المخططات. على سبيل المثال، <<backColor [item.Color]>> مع "#FF0000" القادم من البيانات يطبق اللون الأحمر الآن.

الإصلاحات

  • القيم المنطقية المفقودة في بيانات JSON و XML و CSV تُحسب الآن كـ false في العامل الشرطي ?: وفي موصلات where و count و any و all و first، بدلاً من الفشل بـ NullPointerException.
  • groupBy و distinct على الكائنات المتداخلة لبيانات JSON و XML تقارن الكائنات بالقيمة، لذا العملاء المتساويون يُشكلون مجموعة واحدة. الآن يتم دعم JSON المكتوب مع مراجع محفوظة ($id/$ref).
  • License.setLicense(InputStream) يقرأ ByteArrayInputStream من علامته و FileInputStream من الموضع 0، لذا لا يفشل التدفق المستخدم مسبقًا لترخيص منتج GroupDocs آخر بعد الآن مع رسالة “Unexpected EOF in prolog”.
  • استهلاك الترخيص القائم على القياس يُبلغ عنه عند إكمال تجميع مستند أو إنشاء معاينة، بدلاً من لاحقًا من خيط خلفية.
  • تقارير النص وHTML للقوالب التي تحتوي على ASCII فقط تُكتب بـ UTF-8، لذا لا تُفقد البيانات مثل Café أو Привет إلى windows-1252.
  • الباركودات التي يُرسم نص الكود الخاص بها بواسطة المحرك (QR، DataMatrix، Aztec وغيرها) لم تعد تفشل عندما لا يكون خط صندوق النص مثبتًا — عادةً Calibri على Linux. يُستخدم خط بديل بدلاً من ذلك.
  • قوالب MSG: تُعالج الوسوم في موضوع المحادثة مثل وسوم العنوان، لذا يقوم Outlook بربط الرسائل بشكل صحيح.
  • <<doc>> في قوالب جدول البيانات أو العرض التقديمي أو النص يفشل برسالة تقول إن الوسم غير مدعوم لهذا التنسيق، ولا يترك assembleDocument الفاشل ملف إخراج فارغ.
  • محتوى HTML: وسوم تعبير -html الذي ينهي الفقرة لا يترك فقرة فارغة إضافية بعد HTML ينتهي بعنصر كتلة (ASSEMBLYJAVA-354).
  • باركودات GS1: الآن يقوم GroupDocs.Assembly بتصحيح نصوص الكود المكوّنة من أرقام فقط لباركودات EAN-14 و SCC-14 و SSCC-18 و DataBar بنفسه، لأن Aspose.BarCode 26.10 توقف عن ذلك، لذا تبقى هذه الباركودات كما هي في 26.10.1.

محركات Aspose تم ترقيتها إلى 26.10

GroupDocs.Assembly for Java 26.10.1 دمج مكتبات Aspose من أوائل 2026، لذا تم الإبلاغ عن الثغرات التي تم إصلاحها فيها منذ ذلك الحين بواسطة ماسحات الأمان. الآن المحركات المدمجة هي:

المحرك 26.10.1 26.11
Aspose.Words for Java 26.3 26.10.1
Aspose.Cells for Java 26.3 26.10
Aspose.Slides for Java 26.2 26.10
Aspose.Email for Java 26.1 26.9
Aspose.BarCode for Java 26.6 26.10

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

ملاحظات لمستخدمي Java

  • التواريخ مع Z أو إزاحة في بيانات JSON أو CSV هي قيم java.util.Date لتلك اللحظة الدقيقة، ونمط التنسيق يطبعها في المنطقة الزمنية الافتراضية للـ JVM. للحصول على إخراج لا يعتمد على الخادم، شغّل الـ JVM بمنطقة زمنية ثابتة، مثلًا -Duser.timezone=UTC.
  • ExternalResourceOrigin و PreviewFormats هما فئات من ثوابت int، مثل باقي التعدادات في واجهة برمجة تطبيقات Java. CreatePageStream و ReleasePageStream هما واجهات وظيفية، لذا تتناسب مع تعبيرات lambda.

كيفية الحصول على التحديث

Maven

أضف مستودع GroupDocs والاعتماد إلى ملف pom.xml الخاص بك:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <name>GroupDocs Artifacts Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>26.11</version>
    </dependency>
</dependencies>

التحميل المباشر

حمّل ملف JAR من صفحة تحميل GroupDocs.Assembly for Java 26.11.

الموارد