GroupDocs.Assembly for Java 26.11 sürümünün yayınlandığını duyurmaktan memnuniyet duyuyoruz, Kasım 2026 itibarıyla kullanılabilir. Bu sürüm, GroupDocs.Assembly for .NET 26.11’in özelliklerini ve düzeltmelerini Java’ya getiriyor:

  • şablonlar bir JSON Şeması’na karşı kontrol edilebilir;
  • şablonların ve raporların sayfaları görüntülere render edilebilir;
  • harici kaynakların yüklenmesi uygulamanın kontrolü altındadır;
  • REMOVE_EMPTY_PARAGRAPHS hesap tablosu ve düz metin şablonları için çalışır;
  • <<image>> etiketleri sunumların tablo hücrelerinde çalışır ve göreceli yolları şablon klasörüne göre çözer;
  • renk etiketleri hex dizgilerini kabul eder.

Pakette gelen Aspose motorları erken 2026 sürümlerinden 26.10 sürümüne geçiyor ve bir dizi düzeltme lisanslama, rapor kodlaması, barkodlar ve HTML içeriğini kapsıyor. Java 8 temel olarak kalıyor.

Bu sürümde yenilikler

Anahtar Özet Kategori
ASSEMBLYNET-145 JsonDataSource bir JSON Şeması kabul eder: şemada bildirilen üyeler, veri içinde null, boş veya eksik olsa bile referans alınabilir ve değer tipleri şemadan gelir Özellik
ASSEMBLYNET-8 DocumentAssembler.generatePreview şablonların, birleştirilmiş raporların ve diğer belgelerin sayfalarını PNG, JPEG veya BMP görüntülerine render eder Özellik
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS hesap tablosu şablonları ve düz metin belgeleri için çalışır Özellik
ASSEMBLYNET-140 Şablonlar ve veri tarafından referans verilen harici kaynaklar uygulamanın kontrolü altındadır; veri tarafından referans verilen kaynaklar varsayılan olarak atlanır Güvenlik
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 ve Aspose.BarCode 26.10 paketlenmiştir Güncelleme
ASSEMBLYJAVA-353 GS1 barkodları (EAN-14, SCC-14, SSCC-18 ve DataBar), kod metinlerinin otomatik düzeltmesini Aspose.BarCode 26.10 ile korur Düzeltme
ASSEMBLYNET-52 Bir <<image>> etiketi bir sunumun tablo hücresinde çalışır ve grup şekillerinin şekillerindeki etiketler işlenir Geliştirme
ASSEMBLYNET-62 Veriden gelen göreceli bir görüntü yolu, şablon klasörüne göre çözülür Geliştirme
ASSEMBLYNET-25 Dize olarak verilen bir renk, backColor ve grafik renk etiketlerinde hex değeri olabilir Geliştirme
ASSEMBLYNET-155 JSON, XML veya CSV verisindeki eksik Boolean, ?: ve where, count, any, all ve first içinde false olarak sayılır, hata vermez Düzeltme
ASSEMBLYNET-157 groupBy ve distinct iç içe nesneler üzerinde eşit nesneleri birleştirir; JSON verisinin $id/$ref referansları desteklenir Düzeltme
ASSEMBLYNET-142 License.setLicense(InputStream) akışı, başından zaten okunmuş olsa bile okur Düzeltme
ASSEMBLYNET-143 Ölçülen bir lisansın tüketimi, bir işlem tamamlandığında raporlanır Düzeltme
ASSEMBLYNET-158 Yalnızca ASCII içeren şablonların metin ve HTML raporları UTF-8 olarak yazılır, böylece Latin dışı veriler artık kaybolmaz Düzeltme
ASSEMBLYNET-160 Barkodlar, metin kutusunun yazı tipi yüklü olmadığında NullPointerException hatası vermez Düzeltme
ASSEMBLYNET-159 MSG şablonunun konuşma konusundaki etiketler, konu etiketleri gibi birleştirilir Düzeltme
ASSEMBLYNET-152 Bir hesap tablosu, sunum veya metin şablonundaki <<doc>> etiketi net bir mesajla başarısız olur; başarısız assembleDocument boş bir çıktı dosyası bırakmaz Düzeltme
ASSEMBLYJAVA-354 Paragrafını bitiren bir -html ifade etiketi, blok öğe ile biten HTML’den sonra boş bir paragraf bırakmaz Düzeltme

Yükseltmeden önce kontrol edilmesi gereken davranış değişiklikleri

  1. Veriden gelen harici kaynaklar varsayılan olarak atlanır. Örneğin, PhotoUrl bir http veya https URI’sı olduğunda <<image [item.PhotoUrl]>> artık boş bir görüntü verir. Hostları LoadSaveOptions.getWhitelistedResources()‘a ekleyin veya önceki davranışı korumak için LoadSaveOptions.setSkipExternalResources(false) çağırın. Şablonun kendisi tarafından referans verilen kaynaklar ve yerel dosya yolları önceki gibi çalışır.
  2. Belirsiz JsonDataSource çağrısı. İkinci argümanı literal null olan new JsonDataSource(path, null) artık derlenmez. Argümanı şu şekilde dönüştürün: new JsonDataSource(path, (JsonDataLoadOptions) null). Derlenmiş uygulamalar etkilenmez.
  3. UTF-8 metin ve HTML raporları. Byte order mark olmadan yalnızca ASCII içeren metin ve HTML şablonlarının raporları artık windows-1252 yerine UTF-8 olarak yazılır. Tek baytlık bir kod sayfasını korumak için şablonda (HTML'de <meta charset>) belirtin.
  4. JSON, XML ve DataSet verilerinde iç içe nesneler üzerinde groupBy ve distinct artık satır başına bir grup vermek yerine eşit nesneleri birleştirir.
  5. HTML’den sonra ekstra paragraf yok. Paragrafını bitiren bir -html etiketi, blok öğe ile biten HTML’den sonra boş bir paragraf bırakmaz. Boş bir satır tutmak için HTML’i <p>&nbsp;</p> ile sonlandırın.
  6. DataBar Expanded barkodları. Sadece rakamlardan oluşan kod metnine sahip bir DataBar Expanded veya DataBar Expanded Stacked barkodu, artık diğer DataBar tipleri gibi (01) uygulama tanımlayıcısı ile GTIN olarak kodlanır.
  7. Hesap tablosu, sunum ve metin şablonlarındaki <<doc>> etiketi için istisna metni değiştirildi; istisna tipi aynı kalır.
  8. Kaldırılan API. ICustomFontsHandler.resetFontSources() kaldırıldı; yerine FontSettings.resetFontSources() çağırın.

Yeni özellikler

JsonDataSource için JSON Şeması desteği

Bir şablon, herhangi bir <<if>> değerlendirilmeden önce verisinin yapısına karşı kontrol edilir. JSON ile bu yapı, veriden alınırdı, bu yüzden hiç render edilmeyen bir dal içinde referans, arkasındaki veri null, boş dizi veya eksik olduğunda başarısız olurdu.

JsonDataSource artık bir JSON Şeması kabul eder, XmlDataSource bir XML Şeması kabul ettiği gibi, ve şablon şemaya karşı kontrol edilir:

  • şemada bildirilen üyeler, veri içinde null, boş veya eksik olsa bile referans alınabilir;
  • şemada bildirilmeyen üyeler hâlâ hata verir, böylece yanlış yazılmış adlar önceki gibi tespit edilir;
  • değer tipleri şemadan gelir, böylece bir boolean Boolean olur ve rakam içeren bir dize dize olarak kalır.

Ödeme kartı olmayan ve sadakat verisi bulunmayan bir müşteri ve sadece rakamlardan oluşan bir hesap numarası verildiğinde:

{ "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" } } }
  }
}

ve bu şablon:

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]>>

şemayı verinin yanına şu şekilde verin:

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

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

Sonuç, No payment card on file. ve hesap numarası 00042 olur. Şema olmadan aynı şablon customer.Cards.first().Type üzerinde başarısız olur ve hesap numarası 42 sayısı olarak okunur.

Şema, dosya yolu ya da bir InputStream olarak, JsonDataLoadOptions ile ya da olmadan verilebilir. Desteklenen anahtar kelimeler type (null olabilir tipler dahil), properties, items, format (date-time ve date), enum, const, allOf ve yerel $ref işaretçileri. oneOf, anyOf, not, uzak ya da özyinelemeli $ref, tuple biçimli items ve dizi içinde dizi desteklenmez.

Belge önizlemesi

DocumentAssembler.generatePreview bir belgenin sayfalarını PNG, JPEG veya BMP görüntülerine render eder: bir şablon, GroupDocs.Assembly tarafından birleştirilmiş bir belge veya desteklenen formatta herhangi bir belge, dosyadan ya da akıştan. Kelime işlem, metin ve HTML belgelerinin sayfaları, hesap tablolarının yazdırılmış sayfaları, sunum slaytları ve başlıklarıyla e-posta mesajları render edilir.

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 ve setHeight birlikte ayarlandığında, sayfalar bu boyuta sığacak şekilde en boy oranını koruyarak ölçeklendirilir. Önizlemeler, harici kaynaklar yüklenmeden oluşturulur ve oluşturulan görüntüler, birleştirilmiş belgeler gibi ölçülen lisanslama ile sayılır.

Hesap tablosu ve düz metin şablonları için REMOVE_EMPTY_PARAGRAPHS

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS artık hesap tablosu şablonları ve düz metin belgeleri için de çalışır. Burada bir paragraf, bir metin satırıdır: bir hücrenin metin satırı ya da bir metin belgesinin satırı, şablon etiketleri işlendiğinde boş kalırsa satır sonu ile birlikte kaldırılır. <<if>> ve <<foreach>> gibi kendi satırlarında yazılan etiketler artık boş satır bırakmaz.

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

Şablon:

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

Sonuç:

Prefix
Suffix

Aynı şablon metni bir hesap tablosu hücresinde aynı sonucu hücre içinde verir. HTML ve XML belgeleri olduğu gibi kalır.

Güvenlik: harici kaynakların kontrolü

<<image>> veya <<doc>> etiketi, veriden alınan bir URI’ye değerlendirilebilir ve GroupDocs.Assembly bunu engelleme imkanı olmadan alıyordu. Başkaları tarafından sağlanan verilerle belge birleştiren bir sunucu, bu sayede iç adreslere istek yapabilir.

GroupDocs.Assembly artık her bir harici kaynağa referansın nereden geldiğini (ExternalResourceOrigin) bildirir:

  • TEMPLATE — şablon belgesi kaynağa kendisi referans verir, örneğin <<image ["https://example.com/logo.png"]>> gibi bir etiket içinde literal URI içerir;
  • DATA — referans veriden gelir, örneğin bir etiket ifadesinin değerlendirdiği URI.

Varsayılan olarak, şablon tarafından referans verilen kaynaklar önceki gibi yüklenir ve veri tarafından referans verilen kaynaklar atlanır. Bu davranışı kontrol eden dört LoadSaveOptions üyesi vardır:

  • setSkipExternalResources (true varsayılan) — harici kaynaklar yüklenmez;
  • setTrustTemplateResources (true varsayılan) — atlama açıkken bile şablon tarafından referans verilen kaynaklar yüklenir; şablonlar güvenilmeyen kaynaklardan geldiğinde bunu false yapın;
  • getWhitelistedResources — atlama açıkken bile izin verilen host adları veya mutlak URI önekleri;
  • setExternalResourceHandler — her harici kaynak istenmeden önce çağrılan bir ExternalResourceHandler, kaynağı izin vermek, atlamak ya da içeriğini sağlamak için.
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);
            }
        }
    }
}

Harici kaynaklar, ağa ulaşan kaynaklardır: http, https ve ftp URI’ları, UNC yolları ve uzak hostlu dosya URI’ları. Yerel dosya yolları etkilenmez. Bir belgedeki atlanan görüntü şeffaf bir görüntüyle değiştirilir; atlanan <<image>> veya <<doc>> değeri boş bir değer olarak ele alınır.

Geliştirmeler

Sunumların tablo hücrelerindeki ve grup şekillerindeki görüntüler

Bir sunum şablonunda, <<image>> etiketi yalnızca bir metin kutusuna yerleştirilebilirdi. Artık bir tablo hücresi de bir görüntü kapsayıcısıdır: görüntü, hücrenin resim doldurması olur, <<foreach>> ile tekrarlanan satırların hücreleri dahil, böylece öğeleri resimleriyle listeleyen bir tablo oluşturulabilir. -fitHeight ile satır, görüntüyü en boy oranı ile gösterecek şekilde büyür. Grup şekillerinin şekillerindeki etiketler, iç içe gruplar dahil, artık diğer şekiller gibi işlenir.

Göreceli görüntü yolları şablon klasörüne göre çözülür

Veriden gelen Images/photo.png gibi göreceli bir dosya yolu alan bir <<image>> etiketi, artık Microsoft Office belgelerindeki bağlı kaynaklara benzer şekilde önce şablon klasörüne göre çözülür. Akıştan yüklenen bir şablon için klasörü LoadSaveOptions.setResourceLoadBaseUri ile ayarlayın:

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"));
}

Orada dosya yoksa, önceki gibi geçerli dizin kullanılır.

Hex renk dizgileri

Bir dize olarak verilen renk artık bir hex değeri — "#RRGGBB", "#RGB" veya "#AARRGGBB" — renk adı ve ARGB tamsayısına ek olarak backColor ve grafik renk etiketlerinde olabilir. Örneğin, veriden gelen "#FF0000" ile <<backColor [item.Color]>> artık kırmızı uygular.

Düzeltmeler

  • JSON, XML ve CSV verilerindeki eksik Boolean’lar artık ?: koşul operatöründe ve where, count, any, all ve first öngörülerinde false olarak sayılır, NullPointerException ile başarısız olmaz.
  • JSON ve XML verilerinde iç içe nesneler üzerinde groupBy ve distinct nesneleri değerlerine göre karşılaştırır, böylece eşit müşteriler bir grup oluşturur. Korunan referanslarla ($id/$ref) yazılmış JSON artık desteklenir.
  • License.setLicense(InputStream) işaretinden bir ByteArrayInputStream ve konum 0’dan bir FileInputStream okur, böylece başka bir GroupDocs ürününün lisansını almak için zaten kullanılan bir akış artık “Unexpected EOF in prolog” hatası vermez.
  • Ölçülen tüketim bir belge birleştirildiğinde veya önizleme oluşturulduğunda raporlanır, daha sonra arka plan iş parçacığından değil.
  • Yalnızca ASCII içeren şablonların metin ve HTML raporları UTF-8 olarak yazılır, böylece Café veya Привет gibi veriler windows-1252’ye kaybolmaz.
  • Barkodların kod metni motor tarafından çizildiğinde (QR, DataMatrix, Aztec ve diğerleri) metin kutusunun yazı tipi yüklü olmadığında artık başarısız olmaz — genellikle Linux’ta Calibri. Bunun yerine yedek bir yazı tipi kullanılır.
  • MSG şablonları: konuşma konusundaki etiketler, konu etiketleri gibi işlenir, böylece Outlook mesajları doğru şekilde dizeler.
  • Hesap tablosu, sunum ve metin şablonlarındaki <<doc>> etiketinin format için desteklenmediğini belirten bir mesajla başarısız olur ve başarısız assembleDocument artık boş bir çıktı dosyası bırakmaz.
  • HTML içeriği: paragrafını bitiren bir -html ifade etiketi, blok öğe ile biten HTML’den sonra ekstra boş paragraf bırakmaz (ASSEMBLYJAVA-354).
  • GS1 barkodları: GroupDocs.Assembly artık EAN-14, SCC-14, SSCC-18 ve DataBar barkodlarının sadece rakam içeren kod metinlerini kendisi düzeltir, çünkü Aspose.BarCode 26.10 bunu durdurdu, bu yüzden bu barkodlar 26.10.1’deki gibi kalır.

Aspose motorları 26.10’a yükseltildi

GroupDocs.Assembly for Java 26.10.1, erken 2026’da çıkan Aspose kütüphanelerini paketledi, bu yüzden o zamandan beri düzeltilen güvenlik açıkları güvenlik tarayıcıları tarafından raporlandı. Paketlenmiş motorlar artık:

Motor 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

Yayınlanan POM hâlâ bağımlılık bildirmemektedir. Motorlar yenilendiği için, yeniden oluşturulan belgeler bayt seviyesinde farklılık gösterebilir ancak görsel ve işlevsel olarak eşdeğerdir. Oluşturulan çıktıyı saklanan temel dosyalarla bayt karşılaştırması yapıyorsanız, yükseltmeden sonra bu temel dosyaları yenileyin.

Java kullanıcıları için notlar

  • JSON veya CSV verilerindeki Z veya bir ofset içeren tarih tam o anın java.util.Date değerleridir ve bir format deseni onları JVM’in varsayılan saat diliminde yazar. Sunucuya bağlı olmayan çıktı için JVM’i sabit bir saat dilimiyle çalıştırın, örneğin -Duser.timezone=UTC.
  • ExternalResourceOrigin ve PreviewFormats, Java API’nin diğer enum’ları gibi int sabit sınıflarıdır. CreatePageStream ve ReleasePageStream fonksiyonel arayüzlerdir, bu yüzden lambda ifadeleri uyumludur.

Güncellemeyi nasıl alabilirsiniz

Maven

pom.xml dosyanıza GroupDocs deposunu ve bağımlılığı ekleyin:

<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>

Doğrudan indirme

JAR dosyasını GroupDocs.Assembly for Java 26.11 indirme sayfası üzerinden indirin.

Kaynaklar