このたび、GroupDocs.Assembly for Java 26.11 をリリースいたしました。リリース日は 2026年11月 です。このリリースは、GroupDocs.Assembly for .NET 26.11 の機能と修正を Java にもたらします。
- テンプレートを JSON Schema に対して検証できるようになりました;
- テンプレートやレポートのページを 画像としてレンダリング できるようになりました;
- 外部リソース の読み込みがアプリケーション側で制御できるようになりました;
REMOVE_EMPTY_PARAGRAPHSが スプレッドシートおよびプレーンテキスト テンプレートで機能します;<<image>>タグが プレゼンテーションのテーブルセル で機能し、相対パス をテンプレートフォルダーに対して解決します;- カラータグが 16進文字列 を受け入れます。
バンドルされた 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 | 文字列として指定されたカラーは backColor およびチャートカラータグで 16 進値として使用できます |
強化 |
| ASSEMBLYNET-155 | JSON、XML、CSV データの欠損した Boolean は、失敗する代わりに ?: および where、count、any、all、first で false とみなされます |
修正 |
| ASSEMBLYNET-157 | ネストされたオブジェクトに対する groupBy と distinct が等しいオブジェクトをマージします。JSON データの $id/$ref 参照がサポートされます |
修正 |
| ASSEMBLYNET-142 | License.setLicense(InputStream) が、すでに先頭から読み取られたストリームを読み取ります |
修正 |
| ASSEMBLYNET-143 | メータードライセンスの消費が、操作完了時に報告されます | 修正 |
| ASSEMBLYNET-158 | ASCII のみのテンプレートのテキストおよび HTML レポートが UTF-8 で書き込まれるようになり、ラテン文字以外のデータが失われなくなります | 修正 |
| ASSEMBLYNET-160 | テキストボックスのフォントがインストールされていない場合でも、バーコードが NullPointerException で失敗しなくなります |
修正 |
| ASSEMBLYNET-159 | MSG テンプレートの会話トピック内のタグが、件名のタグと同様に組み立てられます | 修正 |
| ASSEMBLYNET-152 | スプレッドシート、プレゼンテーション、テキストテンプレート内の <<doc>> タグが明確なメッセージで失敗します。失敗した assembleDocument は空の出力ファイルを残しません |
修正 |
| ASSEMBLYJAVA-354 | -html 式タグが段落の終わりにある場合、ブロック要素で終わる HTML の後に空の段落が残らなくなります |
修正 |
アップグレード前に確認すべき動作変更
-
データからの外部リソースはデフォルトでスキップされます。 例えば、
<<image [item.PhotoUrl]>>でPhotoUrlが http または https の URI の場合、空の画像が出力されます。ホストをLoadSaveOptions.getWhitelistedResources()に追加するか、LoadSaveOptions.setSkipExternalResources(false)を呼び出して以前の動作を維持してください。テンプレート自体が参照するリソースやローカルファイルパスは従来通り機能します。 -
曖昧な
JsonDataSource呼び出し。 リテラルnullを第2引数にしたnew JsonDataSource(path, null)はコンパイルできなくなりました。引数をキャストしてください:new JsonDataSource(path, (JsonDataLoadOptions) null)。コンパイル済みのアプリケーションには影響ありません。 -
UTF-8 テキストおよび HTML レポート。 BOM がない ASCII のみのテキストおよび HTML テンプレートのレポートは、従来の windows-1252 の代わりに UTF-8 で書き込まれます。シングルバイトコードページを維持したい場合は、テンプレート内で宣言してください(HTML の
<meta charset>)。 -
JSON、XML、DataSet データのネストされたオブジェクトに対する
groupByとdistinctは、行ごとにグループを作る代わりに等しいオブジェクトをマージします。 -
HTML の後に余分な段落が残らない。 段落の終わりにある
-htmlタグは、ブロック要素で終わる HTML の後に空の段落を残さなくなります。空行を保持したい場合は、HTML を<p> </p>で終わらせてください。 -
DataBar Expanded バーコード。 数字のみのコードテキストを持つ DataBar Expanded または DataBar Expanded Stacked バーコードは、他の DataBar タイプと同様に (01) アプリケーション識別子付きの GTIN としてエンコードされます。
-
例外テキストが変更されました スプレッドシート、プレゼンテーション、テキストテンプレートの
<<doc>>タグに対して; 例外の型は同じです。 -
API が削除されました。
ICustomFontsHandler.resetFontSources()は削除され、代わりにFontSettings.resetFontSources()を呼び出してください。
新機能
JsonDataSource の JSON Schema サポート
テンプレートは、<<if>> が評価される前にデータの構造に対して検証されます。JSON では、その構造はデータ自体から取得されていたため、決してレンダリングされないブランチ内の参照は、背後のデータが null、空配列、または欠落している場合に失敗していました。
JsonDataSource は現在、XmlDataSource が XML Schema を受け入れるのと同様に JSON 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"));
結果は口座番号 00042 とともに No payment card on file. となります。スキーマなしでは、同じテンプレートは customer.Cards.first().Type で失敗し、口座番号は数値 42 として読み取られます。
スキーマはファイルパスまたは InputStream として指定でき、JsonDataLoadOptions の有無にかかわりません。サポートされるキーワードは type(nullable 型を含む)、properties、items、format(date-time と date)、enum、const、allOf、ローカル $ref ポインタです。oneOf、anyOf、not、リモートまたは再帰的 $ref、タプル形式の items、配列の配列はサポートされていません。
ドキュメントプレビュー
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 の 4 つのメンバーがこれを制御します:
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);
}
}
}
}
外部リソースとは、ネットワークに到達するリソースで、http、https、ftp の URI、UNC パス、リモートホスト付きの file URI です。ローカルファイルパスは影響を受けません。スキップされたドキュメントの画像は透明画像に置き換えられ、スキップされた <<image>> または <<doc>> の値は空の値として扱われます。
強化
プレゼンテーションのテーブルセルとグループシェイプ内の画像
プレゼンテーションテンプレートでは、<<image>> タグはテキストボックスにしか配置できませんでした。テーブルセルも画像コンテナになり、画像はセルのピクチャーフィルとして設定され、<<foreach>> で繰り返される行のセルも含まれるため、画像付きの項目一覧テーブルを作成できます。-fitHeight を使用すると、行は画像のアスペクト比を保って拡大します。グループシェイプ内のシェイプ(入れ子のグループを含む)にあるタグも、他のシェイプと同様に処理されます。
テンプレートフォルダーに対して解決される相対画像パス
データから相対ファイルパス(例: Images/photo.png)を取得する <<image>> タグは、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"));
}
その場所にファイルが存在しない場合は、従来通り現在のディレクトリが使用されます。
16 進カラー文字列
文字列として指定されたカラーは、カラー名や ARGB 整数に加えて、16 進値("#RRGGBB"、"#RGB"、"#AARRGGBB")としても使用できるようになりました。backColor やチャートカラータグで使用できます。例えば、データから来た "#FF0000" を持つ <<backColor [item.Color]>> は赤を適用します。
修正
- JSON、XML、CSV データの欠損した Boolean は、
NullPointerExceptionで失敗する代わりに、条件演算子?:およびwhere、count、any、all、firstの述語でfalseとみなされます。 - JSON と XML データのネストされたオブジェクトに対する
groupByとdistinctはオブジェクトを値で比較し、等しい顧客は1つのグループになります。参照が保持された JSON($id/$ref)がサポートされるようになりました。 License.setLicense(InputStream)は、マーク位置からByteArrayInputStreamを、位置0からFileInputStreamを読み取ります。そのため、別の GroupDocs 製品のライセンスに既に使用されたストリームが “Unexpected EOF in prolog” で失敗しなくなります。- メータードライセンスの消費は、ドキュメントの組み立てやプレビュー生成が完了した時点で報告され、バックグラウンドスレッドからの遅延報告は行われません。
- ASCII のみのテンプレートのテキストおよび HTML レポートは UTF-8 で書き込まれ、
CaféやПриветなどのデータが windows-1252 で失われなくなります。 - エンジンが描画するコードテキストを持つバーコード(QR、DataMatrix、Aztec など)は、テキストボックスのフォントがインストールされていない場合でも失敗しなくなります(Linux では通常 Calibri がインストールされていません)。代わりにフォールバックフォントが使用されます。
- 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 は 2026 年初期の Aspose ライブラリをバンドルしていたため、その後に修正された脆弱性がセキュリティスキャナで報告されていました。バンドルされたエンジンは現在次の通りです:
| エンジン | 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 ユーザーへの注意点
- JSON や CSV データの
Zまたはオフセット付きの日付 は、その瞬間を表すjava.util.Date値で、フォーマットパターンは JVM のデフォルトタイムゾーンで出力します。サーバーに依存しない出力を得るには、JVM を固定タイムゾーンで実行してください(例:-Duser.timezone=UTC)。 ExternalResourceOriginとPreviewFormatsはint定数のクラスで、Java API の他の列挙と同様です。CreatePageStreamとReleasePageStreamは関数型インターフェースで、ラムダ式が使用できます。
アップデートの取得方法
Maven
pom.xml に GroupDocs リポジトリと依存関係を追加します:
<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 download page.