4.1. PDF帳票出力API¶
PDF帳票出力APIで発生するトラブルとその解決方法について説明します。
関連する現象
4.1.1. エラーコード「–23」が発生する¶
現象¶
単票形式 IODOC のPDF帳票出力時にエラーコード「-23」が発生します。
解決方法¶
連携エンジン IOWebDOC をアップデートしてください。
移行手順については、「 IM-PDFDesigner for Accel Platform 移行ガイド 」-「 intra-mart Accel Platform のアップデート 」を参照してください。
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.2. エラーコード「–100」が発生する¶
現象¶
PDF帳票出力時にエラーコード「-100」が発生します。
原因¶
次のいずれかの原因が考えられます。
- 入出力先のディスク容量が不足している。
- 入出力先のディレクトリ、または、ファイルに対するアクセス権限が不足している。
- 連票形式 IOCELA の帳票レイアウトファイルの改行コードがCRLFになっている。（ Linux 環境のみ）
- 帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数が一致していない。
解決方法¶
次のいずれかの対策が考えられます。
入出力先のディスク容量が不足している場合
入出力先のディスク容量を増やしてください。
入出力先のディレクトリ、または、ファイルに対するアクセス権限が不足している場合
入出力先のディレクトリ、または、ファイルに対するアクセス権限を変更してください。
連票形式 IOCELA の帳票レイアウトファイルの改行コードがCRLFになっている場合（ Linux 環境のみ）
連票形式 IOCELA の帳票デザインツールは、改行コードがCRLFの帳票レイアウトファイルを出力します。帳票レイアウトファイル（.clf）の改行コードをCRLFからLFに変更してください。
帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数が一致していない場合
帳票レイアウトファイルで定義したカラム数と、埋め込み用データファイルのカラム数を同じにしてください。
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.3. エラーコード「–103」が発生する¶
現象¶
PDF帳票出力時にエラーコード「-103」が発生します。
発生条件¶
- 帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
次のいずれかの原因が考えられます。
- 連携エンジン IOWebDOC の実行権限が不足している。
- 連携エンジン IOWebDOC と 帳票デザインツール IOWebDOC のバージョンが合致していない。
解決方法¶
次のいずれかの対策が考えられます。
連携エンジン IOWebDOC の実行権限が不足している場合
連携エンジン IOWebDOC のbinディレクトリと配下のファイルに実行権限を付与してください。
連携エンジン IOWebDOC と 帳票デザインツール IOWebDOC のバージョンが合致していない場合
正しい組み合わせで運用してください。バージョンの組み合わせについては、「 IM-PDFDesigner for Accel Platform セットアップガイド 」-「 帳票デザインツール・連携エンジンバージョン 」を参照してください。
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.4. エラーコード「–104」が発生する¶
現象¶
PDF帳票出力時にエラーコード「-104」が発生します。
発生条件¶
- 帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
連携エンジン IOWebDOC の環境変数が正しく設定されていません。
4.1.5. エラーコード「–1012」が発生する¶
現象¶
PDF帳票出力時にエラーコード「-1012」が発生します。
発生条件¶
- 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
連携エンジン IOWebDOC のJavaライブラリのライセンスが無効です。
4.1.6. java.lang.NoClassDefFoundError が発生する¶
発生条件¶
- 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
次のいずれかの原因が考えられます。
- 連携エンジン IOWebDOC のJavaライブラリが正しく設定されていない。
- OpenJDK、または、Oracle JDK に必要なJavaライブラリが含まれていない。（分散構成でのみ発生します。）
解決方法¶
次のいずれかの対応を行ってください。
連携エンジン IOWebDOC のJavaライブラリを正しく設定してください。
Javaライブラリの設定方法については、次を参照してください。
スタンドアローン構成の場合
Windows の場合
Linux の場合
分散構成の場合
Windows の場合
Linux の場合
次の手順で、OpenJDK、または、Oracle JDK に必要なJavaライブラリを設定してください。
次の 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 ）
Apache Tomcat を停止します。
ダウンロードした jar ファイルを、次のフォルダに配置します。
（Apache Tomcat のインストールフォルダ）/webapps/iowebdoc/WEB-INF/lib
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.7. java.lang.UnsatisfiedLinkError が発生する¶
発生条件¶
- 連携エンジン IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
連携エンジン IOWebDOC の環境変数が正しく設定されていません。
4.1.8. PDFIllegalLicenseException が発生する¶
発生条件¶
- 帳票デザインツール IOWebDOC 環境構築直後の動作確認時（バージョンアップ含む）
原因¶
IM-PDFDesigner for Accel Platform のライセンスが無効です。
解決方法¶
有効なライセンスを登録してください。
ライセンスの登録方法については、「 intra-mart Accel Platform セットアップガイド 」-「 ライセンスの登録 」を参照してください。
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.9. 運用を開始してからしばらくするとPDF帳票が出力されなくなる¶
現象¶
運用を開始してからしばらくすると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 の一時ディレクトリ
回避方法¶
ありません。
復旧方法¶
ありません。
4.1.10. PDF帳票の文字が文字化けする¶
発生条件¶
- 通常運用でのPDF帳票出力時。
原因¶
次のいずれかの原因が考えられます。
PDF帳票の「英数字/日本語」以外の文字が文字化けして表示される場合
フォント埋め込みが無効になっています。
固定文字は正しく表示されるが、プログラムから渡す文字が文字化けして表示される場合
PDF帳票出力時の文字エンコード形式が指定されていません。
解決方法¶
次のいずれかの対応を行ってください。
PDF帳票の「英数字/日本語」以外の文字が文字化けして表示される場合
フォント埋め込みを有効にしてください。設定方法については、次を参照してください。
Windows の場合
Linux の場合
固定文字は正しく表示されるが、プログラムから渡す文字が文字化けして表示される場合
PDF帳票出力時の文字エンコード形式を指定するようプログラムを修正してください。
修正内容については、「 IM-PDFDesigner for Accel Platform API ドキュメント 」を参照してください。
次はプログラムの修正例です。
var pdf = new IODoc(iodPath, ""); pdf.setCharset( "UnicodeLittle" ); // 後続処理を記載
回避方法¶
ありません。
復旧方法¶
ありません。