1.3.6 動作定義ファイルの設定

API連携機能では、log4jを使用してログを出力しています。

ログ設定ファイル(environment.properties)は抽出機能で出力するログファイルの出力情報のレベルと出力するログファイルの最大サイズを設定します。

表1.5 ログ設定ファイルの設定項目
No.	項目名	型	説明
1	log_PropertyFile	半角英数字	log4jログ設定ファイルのファイル名をCLASSPATHからの相対パスで設定します。ここで「/log4j.properties」と設定し、「CLASSPATH=/dir1」と設定されていた場合、log4jログ設定ファイル名は「/dir1/log4j.properties」となります。
2	logLevel_API	半角英字	API連携機能のログの出力レベルを設定します。設定値は以下のとおりです。デフォルトはINFOです。 DEBUG すべてのログを出力します。 INFO INFO,WARNING,ERRORレベルのログを出力します。 WARNING WARNING,ERRORレベルのログを出力します。 ERROR ERRORレベルのログのみ出力します。
3	logLevel_Default	半角英字	ログの出力レベルを設定します。設定値は以下のとおりです。デフォルトはINFOです。 DEBUG すべてのログを出力します。 INFO INFO,WARNING,ERRORレベルのログを出力します。 WARNING WARNING,ERRORレベルのログを出力します。 ERROR ERRORレベルのログのみ出力します。
4	logSize	数字	出力するログファイルのサイズをバイト単位で設定します。 0を設定した場合はデフォルトの5メガバイト(5242880)として動作します。

記述サンプル

### システム定義  （編集しないでください）
logSysOutOption  = false
############################################################

### ログ設定
log_PropertyFile = /log4j.properties
logLevel_API     = INFO
logLevel_Default = INFO
logSize = 5242880

注意

・log4jログ設定ファイルはCLASSPATHに記述されたパスの順にサーチされます。

例えば、CLASSPATH=/dir1;/dir2;/dir3、log_PropertyFile=/a/log4j.propertiesの場合、以下の順にサーチされます。

/dir1/a/log4j.properties

/dir2/a/log4j.properties

/dir3/a/log4j.properties

1.3.6.2 log4j設定ファイル(log4j.properties)

API連携機能ではログ出力部品であるlog4jを使用してログを出力していますので、出力するログファイル名を変更する場合はlog4jの設定ファイル(log4j.properties)の「log4j.appender.R.File」および「log4j.appender.API.File」の項目を変更します。他の項目は固定ですので変更しないでください。

なお、log4jは指定されたディレクトリパスが存在しない場合は、ディレクトリを作成した後、ログファイルを作成します。

表1.6 log4j設定ファイルの設定項目
No.	項目名	型	説明
1	log4j.appender.R.File	半角英数字	API連携機能で出力するログファイルをフルパス形式で指定します。
2	log4j.appender.API.File	半角英数字	API連携機能で出力するログファイルをフルパス形式で指定します。

記述サンプル(太字部分以外は固定です)

log4j.category.R=debug, R
log4j.category.API=debug, API

log4j.appender.R =  org.apache.log4j.FileAppender
log4j.appender.API =org.apache.log4j.FileAppender

log4j.logger.EventLog=ERROR,R
log4j.logger.EventLog=ERROR,API

# 内部のログファイルの出力先
# 出力先を変更する場合は、フルパスで指定する。
# 例：log4j.appender.Appender1.File = D:\\TestLog4j.log
log4j.appender.R.File = /iis_log/iis_com.log
log4j.appender.API.File = /iis_log/iis_api.log

log4j.appender.R.layout = org.apache.log4j.PatternLayout
log4j.appender.API.layout = org.apache.log4j.PatternLayout

log4j.appender.R.layout.ConversionPattern = %d %m [%t]%n
log4j.appender.API.layout.ConversionPattern = %d %m [%t]%n

注意

・API連携機能を使用する業務アプリケーションでlog4jを使用する場合は、log4jの競合を防止するために、本API連携機能のlog4j設定ファイルの内容を業務側で使用するlog4j設定ファイルに追記してください。

・「R」および「API」は予約語であるため、この文字列を使ったものは作成しないでください。

・XML形式のlog4j設定ファイルは使用しないでください。

1.3.6.3 動作設定ファイル(dfhexapi_setting.properties)

API連携機能の動作環境を設定します。

表1.7 動作設定ファイルの設定項目
No.	項目名	型	説明
1	timeout	数字	抽出制御プロセスからの最大応答待ち時間を指定します。初期値は0で、省略不可です。単位は分で、0～70000の範囲で指定します。設定した時間を過ぎても抽出制御プロセスから応答がない場合は、タイムアウトとなりアプリケーションにエラーを通知します。0を指定した場合は、応答があるまで待ち続けます。
2	readBufSize	数字	抽出制御プロセスが出力した抽出結果情報を読み込むバッファの大きさを指定します。初期値は524288(512キロバイト)で、省略不可です。単位はバイトで、10～67108864(64メガバイト)の範囲で指定します。

記述サンプル

timeout=1320
readBufSize=524288