uCosminexus EUR システム設計ガイド

[目次][索引][前へ][次へ]

5.3.6 EPS-XLSXログ

EUR サーバ帳票出力機能を使って帳票をExcel形式ファイルに出力する場合に,エラーレベルまたはワーニングレベルのメッセージを出力します。ログ採取レベルは,環境変数EURPS_EXCELLOGFILELEVELで変更できます。

ログファイルに出力する情報
ヘッダ情報として,Excel形式ファイル出力を実行した製品の形名,およびライブラリ(Windows環境の場合はLibXLS.dll,UNIX/Linux環境の場合はlibxls.so)のバージョン,リビジョン番号が出力されます。
ワーニングレベルのメッセージとして,複数のアイテムが同一セルに配置された場合に,出力されないアイテムの情報が出力されます。
エラーレベルのメッセージとして,Excel形式ファイル出力時に発生したエラーメッセージが出力されます。
ログファイルの出力形式の詳細については,「5.3.6(1) EPS-XLSXログの出力形式」を参照してください。
ログファイル名
ログファイルは次の名称で出力されます。
eurpsxlsxYYYYMMDDhhmmsslll_PPPPPPPPPP.log
YYYY
実行時刻の西暦年を示します。
MM
実行時刻の月を示します。
DD
実行時刻の日を示します。
hh
実行時刻の時を示します。
mm
実行時刻の分を示します。
ss
実行時刻の秒を示します。
lll
実行時刻のミリ秒を示します。
PPPPPPPPPP
実行時のプロセスIDを示します。
ログファイルの出力先の指定
環境変数,または環境設定ファイルのEURPS_LOGFILEPATHで指定したeurps.logの出力先フォルダと同じフォルダに出力します。指定したログファイルの出力先が存在しない場合,またはログファイルの出力先が指定されていない場合は,出力先フォルダを自動的に作成し,ログファイルを出力します。
EURPS_LOGFILEPATHについては,マニュアル「EUR 帳票出力 リファレンス EUR Server編」を参照してください。
ログファイルの出力先の自動生成については,「5.3.5(1) 帳票出力時にeurpsログの出力先フォルダを作成する機能」を参照してください。
ログファイルの出力単位
ログファイルは,Excel形式ファイルを出力するたびに,エラーレベルまたはワーニングレベルのメッセージと一緒に一つのファイルとして出力されます。Excel形式ファイルを複数回出力すると,出力した回数だけログファイルが出力されます。ただし,出力するエラーレベルまたはワーニングレベルのメッセージがない場合は,ログファイルは出力されません。
ログファイルの容量
出力されるEPS-XLSXログファイルの最大ファイル容量は2GBです。採取したログの容量が2GBを超えた場合は,2GBまではログファイルに出力されます。それ以降のログは出力されません。
ログファイルへのメッセージ出力レベルの指定
ログファイルに出力するメッセージは,メッセージ出力レベルの指定によって出力する内容を変更できます。メッセージ出力レベルは,環境変数EURPS_EXCELLOGFILELEVELに設定します。次に示す2種類のメッセージ出力レベルを設定することで,出力されるメッセージの内容を選択できます。

表5-10 メッセージ出力レベル

環境変数の設定値 出力されるメッセージの内容
INFO エラーレベル(Error(Err))とワーニングレベル(Warning(War))のログを出力します(デフォルト)。
ERROR エラーレベル(Error(Err))だけを出力します。
ログファイルに出力されるメッセージの内容を次に示します。
エラーレベル
Excel形式ファイル出力時に発生したエラーメッセージを出力します。
ワーニングレベル
複数のアイテムが同一セルに配置された場合に,出力されないアイテムの情報を出力します。
ログファイルに出力される情報の詳細については,「5.3.6(1) EPS-XLSXログの出力形式」を参照してください。
ログファイルに出力されるメッセージは,次に示す文字コードで表示されます。なお,変換できない文字は,「?」で出力されます。
  • Windows環境の場合:UTF-16で表示されます。
  • UNIX/Linux環境の場合:設定されている文字ロケール環境に依存します。
<この項の構成>
(1) EPS-XLSXログの出力形式
(2) 出力例

(1) EPS-XLSXログの出力形式

EPS-XLSXログの出力形式について,次に示します。

(a) ヘッダ情報

EPS-XLSXログは,次に示す形式でヘッダ情報を出力します。

 
PP△VV-RR[Ret]
[Ret]
 
PP
EUR Server Standardの形名を示します。
VV
ライブラリ(Windows環境の場合はLibXLS.dll,UNIX/Linux環境の場合はlibxls.so)のバージョン番号を示します。
RR
ライブラリ(Windows環境の場合はLibXLS.dll,UNIX/Linux環境の場合はlibxls.so)のリビジョン番号を示します。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。
(b) メッセージ情報

EPS-XLSXログは,次に示す形式でメッセージ情報を出力します。

 
YY/MM/DD△HH:MM:SS△PPPPPPPPPP△状態△実メッセージ[Ret]
 
YY
実行時刻の西暦下2桁を示します。
MM
実行時刻の月を示します。
DD
実行時刻の日を示します。
HH
実行時刻の時を示します。
MM
実行時刻の分を示します。
SS
実行時刻の秒を示します。
PPPPPPPPPP
実行時のプロセスIDを示します。
状態
メッセージのレベル(エラー(Err)またはワーニング(War))を示します。
実メッセージ
EPS-XLSXログに出力される詳細情報を示します。詳細情報については,「5.3.6(1)(c) 実メッセージに出力される情報(エラーレベルのメッセージ)」および「5.3.6(1)(d) 実メッセージに出力される情報(ワーニングレベルのメッセージ)」を参照してください。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。
(c) 実メッセージに出力される情報(エラーレベルのメッセージ)

メッセージのレベルが「Err」(エラーレベル)のログについて,実メッセージに出力される情報を次に示します。

 
APINAME:reason(0xXXXXXXXX):module(0xXXXXXXXX):pos(0xXXXXXXXX):errno(xx):message(xx)
 

なお,「errno(xx)」および「message(xx)」は,システムエラーの場合だけ出力されます。

APINAME
エラーが発生したAPI名を示します。
reason(0xXXXXXXXX)
エラーが発生した場合の理由コードを示します。
module(0xXXXXXXXX)
メンテナンスコードのモジュール番号を示します。
pos(0xXXXXXXXX)
メンテナンスコードのエラー出力位置を示します。
errno(xx)
エラーコードを示します。「xx」は,Windows環境の場合は,GetLastError関数で返ってきた値,UNIX/Linux環境の場合は,errnoに設定されている値を示します。
message(xx)
errno(xx)で取得したエラーコードに対応するシステムエラーメッセージを示します。Windows環境の場合は,FormatMessage関数で返ってきた値,UNIX/Linux環境の場合は,strerror関数で取得した値を示します。
(d) 実メッセージに出力される情報(ワーニングレベルのメッセージ)

メッセージのレベルが「War」(ワーニングレベル)のログについて,実メッセージに出力される情報を説明します。

複数のアイテムが同一セルに配置された結果,出力されなかったアイテムの情報はアイテムごとに1行で記述されます。

出力されないアイテムごとの,実メッセージに出力される情報を次に示します。

文字アイテム(固定文字列,マッピングデータ(文字列型,日付型),またはユーザ定義データ(文字列型,日付型))
 
KEEU320-W△type=String,△sheet=SHEET,△rc=RC[Ret]
 
type
アイテム種別を示します。固定文字列,マッピングデータ(文字列型,日付型),およびユーザ定義データ(文字列型,日付型)の場合は,「String」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが本来配置されるはずだった,Excelのセルの行列番号を示します。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。
文字アイテム(マッピングデータ(数値型),またはユーザ定義データ(数値型))
 
KEEU320-W△type=Numeric,△sheet=SHEET,△rc=RC[Ret]
 
type
アイテム種別を示します。マッピングデータ(数値型),およびユーザ定義データ(数値型)の場合は,「Numeric」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが,本来配置されるはずだったExcelのセルの行列番号を示します。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。
線アイテム
 
KEEU320-W△type=Line,△sheet=SHEET,△rc=RC,△btrl=D,△Color="RRGGBB",△pattern="PAT"[Ret]
 
type
アイテム種別を示します。線アイテムの場合は,「Line」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが,本来配置されるはずだったExcelのセルの行列番号を示します。
btrl
出力されなかったアイテムがrcで示したセルのどの位置の罫線として配置されるはずだったかを示します。Dにはbottom(下罫線),top(上罫線),right(右罫線),left(左罫線)のどれかが表示されます。
Color
線アイテムの色を16進数表記のRGB値で示します。
pattern
線アイテムの線種を示します。PATにはExcel形式ファイルに出力した場合の線種が表示されます。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。
網掛けアイテム,角丸四角アイテム
 
KEEU320-W△type=Rectangle,△sheet=SHEET,△rc=RC,△bgColor="RRGGBB",△pattern="PAT"[Ret]
 
type
アイテム種別を示します。網掛けアイテム,角丸四角アイテムの場合は,「Rectangle」になります。
sheet
シート番号を示します。
rc
出力されなかったアイテムが,本来配置されるはずだったExcelのセルの行列番号を示します。
bgColor
網掛けアイテム,角丸四角アイテムの背景色を16進数表記のRGB値で示します。
pattern
網掛けアイテム,角丸四角アイテムの塗りつぶしパターンを示します。PATにはExcel形式ファイルに出力した場合の塗りつぶしパターンが表示されます。
[Ret]
改行コード(Windows環境の場合CR+LF,UNIX/Linux環境の場合LF)を示します。
半角空白を示します。

(2) 出力例

EPS-XLSXログの出力例を次に示します。

(a) メッセージレベルがINFOの場合
文字アイテム(固定文字列,マッピングデータ(文字列型,日付型),またはユーザ定義データ(文字列型,日付型))が出力されないとき
Excelの1シート目でセルA1に出力されるはずだった文字アイテム(固定文字列,マッピングデータ(文字列型,日付型),またはユーザ定義データ(文字列型,日付型))が,ほかのアイテムと同一セルに配置された結果,出力されなかった場合の出力例を次に示します。
出力例
09/02/06 15:13:29 [      3356] War KEEU320-W type=String, sheet=1, rc=A1
文字アイテム(マッピングデータ(数値型),またはユーザ定義データ(数値型))が出力されないとき
Excelの1シート目でセルA1に出力されるはずだった文字アイテム(マッピングデータ(数値型),またはユーザ定義データ(数値型))が,ほかのアイテムと同一セルに配置された結果,出力されなかった場合の出力例を次に示します。
出力例
09/02/06 15:13:29 [      3356] War KEEU320-W type=Numeric, sheet=1, rc=A1
線アイテムが出力されない場合
Excelの1シート目でセルA1の左罫線に出力されるはずだった線アイテム(色:黒,線種:実線,線幅:細線)が,ほかのアイテムと同一セルに配置された結果,出力されなかった場合の出力例を次に示します。
出力例
09/02/06 15:13:30 [      3420] War KEEU320-W type=Line, sheet=1, rc=A1, btrl=left, Color="auto", pattern="thin"
網掛けアイテム,角丸四角アイテムが出力されない場合
Excelの1シート目でセルA1に出力されるはずだった網掛けアイテム(色:白,網掛けパターン:薄い網掛け)が,ほかのアイテムと同一セルに配置された結果,出力されなかった場合の出力例を次に示します。
出力例
09/02/06 15:13:29 [       128] War KEEU320-W type=Rectangle, sheet=1, rc=A1, bgColor="auto", pattern="gray0625"
(b) メッセージレベルがERRORの場合
出力例
09/02/06 15:13:30 [      3220] Err _AbortDoc:reason(0x20001000):module(0xfc000001):pos(0x433):errno(87):message(パラメータが間違っています。)