v3.0 (2026-11-20)
v3.0では、Claude CodeやCodexなどのCoding Agentでの帳票開発を想定した機能強化を行いました。
- ベクター図形の描画に対応
- Excelのオートシェイプのような任意の形の図形を描画できます。
- サービスキー検証APIの追加
- CI環境での利用を想定しています。
XML Schemaの改定
v3.0に対応するXML Schemaは 2026.3 です。
XMLの xsi:noNamespaceSchemaLocation を以下のURLに更新してください。
- レイアウトXML
- スタイルXML
破壊的変更
不具合の修正に伴い、以下のとおり動作を変更しました。
<Table> 要素配下の <TableColumn> 要素を必須化
<TableColumn> 要素が1つもない <Table> 要素は、レイアウトXMLの読み込み時にエラーになります。
以前のバージョンでは、このような <Table> 要素は読み込まれても描画されませんでした。
該当するテンプレートでは、不要な <Table> 要素を削除してください。
機能強化
⭐ <Vector>, <Path> 要素の追加
任意の形のベクター図形を描画する要素です。SVGのパスに相当する要素です。
<Vector>要素- キャンバスサイズを
width,height属性で指定します。 - この要素には
<Path>要素のみが配置できます。
- キャンバスサイズを
<Path>要素d属性で形状を指定します。- SVGと同様に
M、L、C、Q、A、Zのコマンドを使ってパスを記述します。
<Vector width="30" height="20">
<Path d="M 0 20 L 15 0 L 30 20 Z" fillColor="#FFE0E0" borderColor="red" />
</Vector>
詳しくはテンプレートリファレンスを参照してください。
⭐ サービスキー検証APIの追加
Node.js版のSDKにサービスキーを検証するAPI Debug.verifyServiceKey() を追加しました。
本番環境へのデプロイ前にCIで有効期限切れや不正なキーを検出するような用途での利用を想定しています。
import { Debug } from '@yagisan-reports/sdk/node';
const result = await Debug.verifyServiceKey('YOUR_SERVICE_KEY');
詳しい利用方法については、サービスキーの有効期限の確認 を参照してください。
生成したPDFへのメタデータの付与
SDKで生成したPDFに、以下のメタデータを設定するようにしました。
Producer:yagisan-reports SDK 3.0.0のような生成ソフトウェアの名前とバージョンを示す文字列CreationDate: PDFの生成日時
バグフィックス
<Table> 要素の挙動の修正
<TableColumnTemplate> の align, valign, backgroundColor 属性に指定したテンプレート式が、行ごとに個別に評価されない問題を修正しました。
また、minRows 属性による空行に対して、align, valign, backgroundColor 属性に指定したテンプレート式が適用されないように変更しました。
<Grid> 要素の途中で改ページした際に描画位置がずれることがある不具合を修正
<Grid> 要素の外周罫線が左右で太さが異なる場合、改ページ後のX軸方向の描画位置がずれる問題を修正しました。
<LayoutHeader>, <LayoutBody>, <LayoutFooter> 要素のスタイルを記述できない問題を修正
スタイルXMLで、<LayoutHeader>, <LayoutBody>, <LayoutFooter> 要素を記述すると、構文エラーとして扱われてしまっていた問題を修正しました。
XMLスキーマでも同様に記述不能として定義されていたため、 2026.3 では修正されています。
XMLスキーマの定義ミスの修正
スタイルXML用のXMLスキーマで、<CellRangeList> の key 属性が省略可能になっていた問題を修正しました。
dispose() の挙動の修正
dispose() を呼び出した際にリソースが十分に解放されないことがある問題と、破棄と帳票生成が重なった際の処理を修正しました。テンプレートの破棄時には、そこから作成した PdfReportGenerator も破棄されます。
ユーザーフォントが正しく設定されないことがある問題の修正
SDKのAPIの呼び出し順序によって、ユーザーフォントが正しく設定されないことがある問題を修正しました。
フォントキャッシュ制御の不具合の修正
Webブラウザ版で、一部のフォントキャッシュを更新する際に別のフォントファミリーのキャッシュまで削除され、不要な再ダウンロードが発生する問題を修正しました。
循環参照するデータを入力すると無限ループに陥る問題の修正
Webブラウザ版で、テンプレートに入力するデータに循環参照が含まれる場合、処理が無限ループに陥ることがある問題を修正しました。
日本語ドメインの判定の不具合の修正
Webブラウザ版でライセンス検証を行う際、日本語ドメイン環境では正しく判定されないことがある問題を修正しました。
IPv6のループバックアドレスの判定の不具合の修正
開発環境でIPv6のループバックアドレス [::1] を使用した場合に、正しく判定されないことがある問題を修正しました。
TypeScriptの型定義の修正
TypeScriptの型定義(d.ts ファイル)において、CJS形式でのインポート時に型が正しく解決されない問題を修正しました。