4.1. PDF帳票出力API¶

現象¶

連票形式 IODBDOC のPDF帳票出力時に、ステータスコード「1」が返りますが、PDF帳票が出力されません。

発生条件¶

• IM-PDFDesigner for Accel Platform 2025 Spring 以前のバージョンでの、連票形式 IODBDOC のPDF帳票出力時

原因¶

次のいずれかの原因が考えられます。

• 明細表を持たない帳票レイアウトを使用している
• 定義したデータ項目変数に、データを渡していない
• 外部変数より先にデータ項目変数にデータを渡している

解決方法¶

次のいずれかの対応を行ってください。

• 明細表を持たない帳票レイアウトを使用している場合

  単票形式 IODOC での帳票作成を検討、または、連票形式 IODBDOC で定義されている外部変数をデータ項目変数に変更してください。

  解決方法の詳細については、「 エラーコード「-23」が発生する 」を参照してください。

• データ項目変数にデータを渡していない場合

  定義したデータ項目変数と渡すデータの数が同じになるようにしてください。

  渡すデータが無い場合は、空文字やスペース等ダミーデータを渡してください。

  コラム

  連票形式 IODBDOC は明細表をメインに扱うツールです。

  そのため、データ項目変数にデータを渡さない、または、渡すデータの数が一致していない状態で帳票作成を行った場合、エラーが発生します。

  注意

  渡すデータとして「null」は指定しないでください。

• 外部変数より先にデータ項目変数にデータを渡している場合

  次の順にデータを渡すようプログラムを修正してください。

  1. 外部変数
  2. データ項目変数

現象¶

連票形式 IODBDOC のPDF帳票出力時にエラーコード「-11」が発生します。

発生条件¶

• 連票形式 IODBDOC のPDF帳票出力時

原因¶

カラムデータに「null」が指定されています。

解決方法¶

カラムデータに「null」を指定しないようプログラムを修正してください。

現象¶

次のいずれかの現象が発生します。

• 単票形式 IODOC のPDF帳票出力時にエラーコード「-23」が発生します。
• 連票形式 IODBDOC のPDF帳票出力時にエラーコード「-23」が発生します。

発生条件¶

• 次のバージョンで単票形式 IODOC のPDF帳票出力実行時

  • 1.9.3.X
  • 1.9.4.0
  • 1.9.4.0.X

• 連票形式 IODBDOC のPDF帳票出力実行時

原因¶

次のいずれかの原因が考えられます。

• 単票形式 IODOC のPDF帳票出力時の場合

  連携エンジン IOWebDOC の不具合です。次のバージョンで発生する可能性があります。

  • 1.9.3.X
  • 1.9.4.0
  • 1.9.4.0.X

• 連票形式 IODBDOC のPDF帳票出力時の場合

  • 明細表を持たない帳票レイアウトを使用しています。
  • 定義したデータ項目変数に、データを渡していません。

解決方法¶

次のいずれかの対応を行ってください。

• 単票形式 IODOC のPDF帳票出力時の場合

  連携エンジン IOWebDOC をアップデートしてください。

  移行手順については、「 IM-PDFDesigner for Accel Platform 移行ガイド 」-「 intra-mart Accel Platform のアップデート 」を参照してください。

• 連票形式 IODBDOC にて、明細表を持たない帳票レイアウトを使用している場合

  連票形式 IODBDOC は明細表をメインに扱うツールのため、明細表を持たない帳票レイアウトで帳票を作成した場合、エラーが発生します。

  連票形式 IODBDOC は、行数可変の明細表の扱いに適しています。

  そのため、明細表を持たない、または、行数固定の明細表を扱う帳票の場合は、単票形式 IODOC での作成を検討してください。

  また、連票形式 IODBDOC では、データ項目変数を1つ以上定義することで、明細表を扱う帳票レイアウトとして見なされます。

  当該帳票レイアウトを引き続き連票形式 IODBDOC で作成する場合は、データ項目変数がデータブロック以外でも使用できることを利用し、定義されている外部変数をデータ項目変数に変更してください。

  外部変数を1つだけデータ項目変数に変更する場合は、次の通りです。

  • 「データ設定」画面-「データ数」を「1」と設定します。
  • 「外部変数設定」画面から変更する外部変数を削除します。
  • 変更する外部変数の「項目属性編集」画面-「基本属性」タブから、「データタイプ」を「データ項目変数」へ変更、「データ」を「$1」へ変更します。
  • 変更する外部変数へ渡していたデータを、データ項目変数へ渡すよう指定します。

  コラム

  データ項目変数を1つ以上定義した際に、データを渡さない、または、渡すデータの数が一致していない状態で帳票作成を行った場合、エラーが発生します。

  そのため、定義したデータ項目変数と渡すデータの数が同じになるようにしてください。

• 連票形式 IODBDOC にて、データ項目変数にデータを渡していない場合

  定義したデータ項目変数と渡すデータの数が同じになるようにしてください。

  渡すデータが無い場合は、空文字やスペース等ダミーデータを渡してください。

  コラム

  連票形式 IODBDOC は明細表をメインに扱うツールです。

  そのため、データ項目変数にデータを渡さない、または、渡すデータの数が一致していない状態で帳票作成を行った場合、エラーが発生します。

  注意

  渡すデータとして「null」は指定しないでください。

現象¶

PDF帳票出力時にエラーコード「-24」が発生します。

発生条件¶

• Linux 環境でのPDF帳票出力時

原因¶

連携エンジン IOWebDOC の環境変数が正しく設定されていません。

解決方法¶

連携エンジン IOWebDOC の環境変数を正しく設定してください。

環境変数の設定方法については、「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 環境変数 」を参照してください。

現象¶

PDF帳票出力時にエラーコード「-100」が発生します。

発生条件¶

• Linux 環境で連票形式 IOCELA のPDF帳票を新規追加。

または、

• 通常運用でのPDF帳票出力時。

原因¶

次のいずれかの原因が考えられます。

• 入出力先のディスク容量が不足している。
• 入出力先のディレクトリ、または、ファイルに対するアクセス権限が不足している。
• 入出力先のファイルを別プロセスで使用している。
• 連票形式 IOCELA の帳票レイアウトファイルの改行コードがCRLFになっている。（ Linux 環境のみ）
• 連票形式 IODBDOC のデータ項目変数に渡す画像ファイルの設置場所、または、ファイルパスが正しくない。
• 帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数が一致していない。

解決方法¶

次のいずれかの対策が考えられます。

• 入出力先のディスク容量が不足している場合

  入出力先のディスク容量を増やしてください。

• 入出力先のディレクトリ、または、ファイルに対するアクセス権限が不足している場合

  入出力先のディレクトリ、または、ファイルに対するアクセス権限を変更してください。

• 入出力先のファイルを別プロセスで使用している場合

  入出力先のファイルを使用している別プロセスを終了してください。

• 連票形式 IOCELA の帳票レイアウトファイルの改行コードがCRLFになっている場合（ Linux 環境のみ）

  連票形式 IOCELA の帳票デザインツールは、改行コードがCRLFの帳票レイアウトファイルを出力します。帳票レイアウトファイル（.clf）の改行コードをCRLFからLFに変更してください。

• 連票形式 IODBDOC に渡す画像ファイルの設置場所、または、ファイルパスが正しくない場合

  正しい場所に画像ファイルを設置し、正しいファイルパスを指定してください。

  解決方法の詳細については、「 PDF帳票出力時に画像が埋め込まれない 」を参照してください。

• 帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数が一致していない場合

  帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数を同じにしてください。

現象¶

PDF帳票出力時にエラーコード「-103」が発生します。

発生条件¶

• クライアント版帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

次のいずれかの原因が考えられます。

• 連携エンジン IOWebDOC の実行権限が不足している。
• 連携エンジン IOWebDOC と クライアント版帳票デザインツール IOWebDOC のバージョンが合致していない。

解決方法¶

次のいずれかの対策が考えられます。

• 連携エンジン IOWebDOC の実行権限が不足している場合

  連携エンジン IOWebDOC のbinディレクトリと配下のファイルに実行権限を付与してください。

• 連携エンジン IOWebDOC と クライアント版帳票デザインツール IOWebDOC のバージョンが合致していない場合

  正しい組み合わせで運用してください。バージョンの組み合わせについては、「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 帳票デザインツール・連携エンジンバージョン 」を参照してください。

現象¶

PDF帳票出力時にエラーコード「-104」が発生します。

発生条件¶

• クライアント版帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

連携エンジン IOWebDOC の環境変数が正しく設定されていません。

解決方法¶

連携エンジン IOWebDOC の環境変数を正しく設定してください。

環境変数の設定方法については、次を参照してください。

• Windows の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 環境変数 」

• Linux の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 環境変数 」

現象¶

連票形式 IODBDOC のPDF帳票出力時にエラーコード「-515」が発生します。

発生条件¶

• 連票形式 IODBDOC のPDF帳票出力時

原因¶

帳票レイアウトファイルで定義したカラム数より多くカラムデータが設定されています。

解決方法¶

帳票レイアウトファイルで定義したカラムと同数のカラムデータを設定するようプログラムを修正してください。

現象¶

連票形式 IODBDOC のPDF帳票出力時にエラーコード「-516」が発生します。

発生条件¶

• 連票形式 IODBDOC のPDF帳票出力時

原因¶

次のいずれかの原因が考えられます。

• カラムデータに「null」が指定されています。
• 帳票レイアウトファイルで定義したカラム数より少なくカラムデータが設定されています。

解決方法¶

次のいずれかの対応を行ってください。

• カラムデータに「null」が指定されている場合

  カラムデータに「null」を指定しないようプログラムを修正してください。

• 帳票レイアウトファイルのカラム数よりカラムデータが少ない場合

  帳票レイアウトファイルで定義したカラムと同数のカラムデータを設定するようプログラムを修正してください。

現象¶

連票形式 IODBDOC のPDF帳票出力時にエラーコード「-999」が発生します。

発生条件¶

• 連票形式 IODBDOC のPDF帳票出力時

原因¶

帳票レイアウトファイルで定義したカラム数と設定されているカラムデータの数が一致していません。

解決方法¶

帳票レイアウトファイルで定義したカラムと同数のカラムデータを設定するようプログラムを修正してください。

現象¶

PDF帳票出力時にエラーコード「-1012」が発生します。

発生条件¶

• 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

連携エンジン IOWebDOC のJavaライブラリのライセンスが無効です。

解決方法¶

有効なライセンスを登録してください。

ライセンスの登録方法については、次を参照してください。

• Windows の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

• Linux の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

現象¶

PDF帳票出力時に次の例外ログが出力されます。

java.lang.NoClassDefFoundError

発生条件¶

• 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

次のいずれかの原因が考えられます。

• 連携エンジン IOWebDOC のJavaライブラリが正しく設定されていない。
• OpenJDK、または、Oracle JDK に必要なJavaライブラリが含まれていない。（分散構成でのみ発生します。）

解決方法¶

次のいずれかの対応を行ってください。

• 連携エンジン IOWebDOC のJavaライブラリを正しく設定してください。

  Javaライブラリの設定方法については、次を参照してください。

  • スタンドアローン構成の場合

    • Windows の場合

      「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 JARファイル設置 」

    • Linux の場合

      「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 JARファイル設置 」

  • 分散構成の場合

    • Windows の場合

      「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 JARファイル設置 」

    • Linux の場合

      「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 JARファイル設置 」

• 次の手順で、OpenJDK、または、Oracle JDK に必要なJavaライブラリを設定してください。

  1. 次の jar ファイルをダウンロードします。

     • javax.activation-api-1.2.0.jar （ https://mvnrepository.com/artifact/javax.activation/javax.activation-api ）
     • jaxb-api-2.3.1.jar （ https://mvnrepository.com/artifact/javax.xml.bind/jaxb-api ）
     • jaxb-core-2.3.0.1.jar （ https://mvnrepository.com/artifact/com.sun.xml.bind/jaxb-core ）
     • jaxb-impl-2.3.2.jar （ https://mvnrepository.com/artifact/com.sun.xml.bind/jaxb-impl ）

  2. Apache Tomcat を停止します。

  3. ダウンロードした jar ファイルを、次のフォルダに配置します。

     （Apache Tomcat のインストールフォルダ）/webapps/iowebdoc/WEB-INF/lib
     

現象¶

PDF帳票出力時に次の例外ログが出力されます。

java.lang.UnsatisfiedLinkError

発生条件¶

• 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

連携エンジン IOWebDOC の環境変数が正しく設定されていません。

解決方法¶

連携エンジン IOWebDOC の環境変数を正しく設定してください。

環境変数の設定方法については、次を参照してください。

• Windows の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 環境変数 」

• Linux の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 環境変数 」

現象¶

PDF帳票出力時に次の例外ログが出力されます。

PDFIllegalLicenseException

発生条件¶

• クライアント版帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

IM-PDFDesigner for Accel Platform のライセンスが無効です。

解決方法¶

有効なライセンスを登録してください。

ライセンスの登録方法については、「 intra-mart Accel Platform セットアップガイド 」-「 ライセンスの登録 」を参照してください。

現象¶

運用を開始してからしばらくするとPDF帳票が出力されなくなります。

発生条件¶

• 通常運用でのPDF帳票出力時。

原因¶

次のいずれかの原因が考えられます。

• 連携エンジン IOWebDOC が動作するために必要なメモリ空き容量が不足している。
• 一時ディレクトリに大量のファイルが残っているため一時ファイルが作成できない。

解決方法¶

次のいずれかの対応を行ってください。

• 連携エンジン IOWebDOC が動作するために必要な空きメモリ容量が不足している場合

  連携エンジン IOWebDOC はアプリケーションサーバ（JVM）とは別のメモリ領域も使用します。空きメモリ容量が不足している場合はメモリの増設などを検討してください。

  必要な空きメモリ容量については、「 IM-PDFDesigner for Accel Platform リリースノート 」-「 システム要件 」を参照してください。

• 一時ディレクトリに大量のファイルが残っているため一時ファイルが作成できない場合

  一時ディレクトリに大量のファイルが残っている場合はファイルを削除してください。IM-PDFDesigner for Accel Platform は次の一時ディレクトリを使用します。

  • OSの一時ディレクトリ
  • Javaの一時ディレクトリ（java.io.tmpdir）
  • intra-mart Accel Platform の一時ディレクトリ

現象¶

次のいずれかの現象が発生します。

• PDF帳票の「英数字/日本語」以外の文字が文字化けして表示されます。
• 固定文字は正しく表示されますが、プログラムから渡す文字が文字化けして表示されます。

発生条件¶

• 通常運用でのPDF帳票出力時。

原因¶

次のいずれかの原因が考えられます。

• PDF帳票の「英数字/日本語」以外の文字が文字化けして表示される場合

  フォント埋め込みが無効になっています。

• 固定文字は正しく表示されるが、プログラムから渡す文字が文字化けして表示される場合

  PDF帳票出力時の文字エンコード形式が指定されていません。

解決方法¶

次のいずれかの対応を行ってください。

• PDF帳票の「英数字/日本語」以外の文字が文字化けして表示される場合

  フォント埋め込みを有効にしてください。設定方法については、次を参照してください。

  • Windows の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

  • Linux の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

• 固定文字は正しく表示されるが、プログラムから渡す文字が文字化けして表示される場合

  PDF帳票出力時の文字エンコード形式を指定するようプログラムを修正してください。

  修正内容については、「 IM-PDFDesigner for Accel Platform API ドキュメント 」を参照してください。

  次はプログラムの修正例です。

  var pdf = new IODoc(iodPath, "");
  pdf.setCharset( "UnicodeLittle" );
  // 後続処理を記載

現象¶

PDF帳票の文字の位置がずれて表示されます。

発生条件¶

• 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）

原因¶

フォント埋め込みが無効になっています。

解決方法¶

フォント埋め込みを有効にしてください。設定方法については、次を参照してください。

• Windows の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

• Linux の場合

  「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

現象¶

PDF帳票の文字が想定していたフォントと異なるフォントで表示されます。

発生条件¶

• 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
• 通常運用でのPDF帳票出力時。

原因¶

次のいずれかの原因が考えられます。

• フォント埋め込みが無効になっています。
• PDFフォント埋込みライセンスが登録されていません。

解決方法¶

次のいずれかの対応を行ってください。

• フォント埋め込みが無効になっている場合

  フォント埋め込みを有効にしてください。設定方法については、次を参照してください。

  • Windows の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

  • Linux の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

• PDFフォント埋込みライセンスが登録されていない場合

  PDFフォント埋込みライセンスを登録してください。ライセンスの登録方法については、次を参照してください。

  • Windows の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

  • Linux の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

現象¶

PDF帳票にフォントが埋め込まれていません。

発生条件¶

• フォント埋め込みの確認時

原因¶

次のいずれかの原因が考えられます。

• フォント埋め込みが無効になっています。
• PDFフォント埋込みライセンスが登録されていません。

解決方法¶

次のいずれかの対応を行ってください。

• フォント埋め込みが無効になっている場合

  フォント埋め込みを有効にしてください。設定方法については、次を参照してください。

  • Windows の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

  • Linux の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 フォント埋め込み設定 」

• PDFフォント埋込みライセンスが登録されていない場合

  PDFフォント埋込みライセンスを登録してください。ライセンスの登録方法については、次を参照してください。

  • Windows の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

  • Linux の場合

    「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 IOWebDOCのインストール 」

現象¶

PDF帳票に、指定した画像が埋め込まれていない状態で出力されます。

発生条件¶

• 通常運用でのPDF帳票出力時。

原因¶

次のいずれかの原因が考えられます。

• 画像ファイルの設置場所が正しくありません。
• 画像ファイルのパスが正しくありません。

解決方法¶

正しい場所に画像ファイルを設置し、正しいファイルパスを指定してください。

画像ファイルは、環境の構成やAPIによって、画像ファイルの設置場所、および、ファイルパスの指定方法が次のように異なります。

• setImageData(id, filepath)を使用する場合

  画像ファイルの設置場所 　スタンドアローン構成	分散構成	パスの指定方法
  < %PUBLIC_STORAGE_PATH% >配下	< %PUBLIC_STORAGE_PATH% >配下、および、 PDF帳票サーバ （※）	< %PUBLIC_STORAGE_PATH% >からの相対パス

  ※各サーバに設置する2つのファイルは、絶対パスが同じ表現となるように設置してください。

• 上記以外のメソッド、および、データファイル内で画像のファイルパスを指定する場合

  画像ファイルの設置場所 　スタンドアローン構成	分散構成	パスの指定方法
  intra-mart Accel Platform	PDF帳票サーバ	絶対パス