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_PARAGRAPHShesap 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
- Veriden gelen harici kaynaklar varsayılan olarak atlanır. Örneğin,
PhotoUrlbir 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çinLoadSaveOptions.setSkipExternalResources(false)çağırın. Şablonun kendisi tarafından referans verilen kaynaklar ve yerel dosya yolları önceki gibi çalışır. - Belirsiz
JsonDataSourceçağrısı. İkinci argümanı literalnullolannew JsonDataSource(path, null)artık derlenmez. Argümanı şu şekilde dönüştürün:new JsonDataSource(path, (JsonDataLoadOptions) null). Derlenmiş uygulamalar etkilenmez. - 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. - JSON, XML ve DataSet verilerinde iç içe nesneler üzerinde
groupByvedistinctartık satır başına bir grup vermek yerine eşit nesneleri birleştirir. - HTML’den sonra ekstra paragraf yok. Paragrafını bitiren bir
-htmletiketi, blok öğe ile biten HTML’den sonra boş bir paragraf bırakmaz. Boş bir satır tutmak için HTML’i<p> </p>ile sonlandırın. - 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.
- Hesap tablosu, sunum ve metin şablonlarındaki
<<doc>>etiketi için istisna metni değiştirildi; istisna tipi aynı kalır. - Kaldırılan API.
ICustomFontsHandler.resetFontSources()kaldırıldı; yerineFontSettings.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
Booleanolur 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(truevarsayılan) — harici kaynaklar yüklenmez;setTrustTemplateResources(truevarsayılan) — atlama açıkken bile şablon tarafından referans verilen kaynaklar yüklenir; şablonlar güvenilmeyen kaynaklardan geldiğinde bunufalseyapın;getWhitelistedResources— atlama açıkken bile izin verilen host adları veya mutlak URI önekleri;setExternalResourceHandler— her harici kaynak istenmeden önce çağrılan birExternalResourceHandler, 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 vewhere,count,any,allvefirstöngörülerindefalseolarak sayılır,NullPointerExceptionile başarısız olmaz. - JSON ve XML verilerinde iç içe nesneler üzerinde
groupByvedistinctnesneleri 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 birByteArrayInputStreamve konum 0’dan birFileInputStreamokur, 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ızassembleDocumentartık boş bir çıktı dosyası bırakmaz. - HTML içeriği: paragrafını bitiren bir
-htmlifade 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
Zveya bir ofset içeren tarih tam o anınjava.util.Datedeğ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. ExternalResourceOriginvePreviewFormats, Java API’nin diğer enum’ları gibiintsabit sınıflarıdır.CreatePageStreamveReleasePageStreamfonksiyonel 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.