3.20.2　メッセージ定義ファイル

(a)　ログ出力アクティビティでの任意のメッセージの出力方法

ログ出力アクティビティで任意のメッセージを出力する場合，次のどちらかの方法で指定します。

• ［ログ出力アクティビティ］ダイアログの［任意の文字列］に，メッセージを直接指定する

• メッセージ定義ファイルにメッセージを記述しておき，該当するプロパティのキーを［ログ出力アクティビティ］ダイアログの［リソースKey］に指定する

この項では，メッセージ定義ファイルの作成について説明します。

［ログ出力アクティビティ］ダイアログと各定義ファイルの関係，およびログファイルの出力結果については，マニュアル「サービスプラットフォーム 解説」の「3.9　ログ出力アクティビティでのログ出力」を参照してください。

また，［ログ出力アクティビティ］ダイアログの指定方法については，「1.4.21　ログ出力アクティビティダイアログ」を参照してください。

(b)　作成手順

メッセージ定義ファイルの作成から，ログ出力アクティビティに割り当てるまでの流れを次に示します。

1. 次のテンプレートファイルを基に，メッセージ定義ファイルをプロパティ形式で記述します。

   <サービスプラットフォームのインストールディレクトリ>\CSC\config\bp\templates\message_definition.properties

   メッセージ定義ファイルには次の項目を記述します。各項目の指定規則は「(3)　設定できるプロパティ」を参照してください。

   • キー名には，リソースKeyと，ログの出力レベルを「-（半角ハイフン）」で連結して記述します。

   • 指定値には，出力するメッセージを記述します。

   1つのメッセージ定義ファイルには複数行記述できます。

   ファイルは，ログ出力識別子ごと（ログの出力先ごと）に分けて作成してください。

2. メッセージ定義ファイルを格納します。

   格納場所とファイル名は任意です。

3. メッセージ定義ファイルのパスをログ出力アクティビティ定義ファイルのlog-activity.<ログ出力識別子>.message-definition-filepathプロパティに設定します。

   これによってログ出力識別子に割り当てられます。パスの設定方法については，「3.20.1　ログ出力アクティビティ定義ファイル」を参照してください。

4. ログ出力アクティビティの定義時に，［ログ出力アクティビティ］ダイアログの［リソースKey］を指定します。

   ［リソースKey］には，メッセージ定義ファイルに記述したプロパティのキー「リソースKey-ログの出力レベル」を指定してください。

   複数のログ出力アクティビティから，1つのメッセージ定義ファイルを指定することもできます。

なお，メッセージ定義ファイルの定義内容は，HCSCサーバの次回起動時から有効になります。