H スキーマ参照: ロケール・メッセージ・カタログl10n_msgcat.dtd

この付録では、特定のJavaロケールに対してローカライズされたログ・メッセージの定義に使用するXMLの背後にあるスキーマである、l10n_msgcat.dtdスキーマの要素へのリファレンスを示します。

この付録の内容は次のとおりです。

• H.1項「ロケール・メッセージ・カタログ要素の概要」

• H.2項「locale_message_catalog」

• H.3項「logmessage」

• H.4項「message」

• H.5項「messagebody」

• H.6項「messagedetail」

• H.7項「cause」

• H.8項「action」

H.1 ロケール・メッセージ・カタログ要素の概要

Oracle Event Processingでは、特定Javaロケールに対してローカライズされたログ・メッセージの定義に使用できる、多数のロケール・メッセージ・カタログ要素が提供されます。

H.1.1 要素の階層

最上位Oracle Event Processingロケール・メッセージ・カタログ要素は、メッセージのカタログ・タイプに応じて次の階層で構成されます。

• 例H-1「ロケール固有のログ・メッセージ・カタログの階層」

• 例H-2「ロケール固有のシンプル・テキスト・カタログの階層」

例H-1 ロケール固有のログ・メッセージ・カタログの階層

locale_message_catalog
    logmessage
        messagebody
        messagedetail
        cause
        action

例H-1 ロケール固有のログ・メッセージ・カタログの階層

message_catalog
    message
        messagebody

H.1.2 例

この項では、次のメッセージ・カタログの例を示します。

• 例H-3「ロケール固有のログ・メッセージ・カタログ」

• 例H-4「ロケール固有のシンプル・テキスト・カタログ」

例H-3 ロケール固有のログ・メッセージ・カタログ

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </log_message>
</message_catalog>

例H-4 ロケール固有のログ・メッセージ・カタログ

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<locale_message_catalog 
  l10n_package="programs.utils"
  subsystem="MYUTIL" 
  version="1.0">
  <message>
    <messageid="FileMenuTitle">
    <messagebody> Fichier </messagebody>
  </message>
</locale_message_catalog>

H.2 locale_message_catalog

この要素を使用すると、EPLプロセッサ・コンポーネントにおいてパラメータ化されたOracle CQLまたはEPLルールの値を定義できます。

H.2.1 子要素

locale_message_catalog要素は次の子要素をサポートしています。

• message

• logmessage

H.2.2 属性

表H-1では、locale_message_catalog要素の属性を示します。

表H-1 locale_message_catalog要素の属性

属性	説明	データ型	必須?
I10n_package	このカタログに対して生成された LogLocalizer または TextLocalizer プロパティを含むJavaパッケージ。プロパティ・ファイルの名前はカタログ・ファイル名に基づいて設定されます。 たとえば、mycat.xml という名前のフランス語版のログ・メッセージ・カタログでは、<l10n_package>.mycatLogLocalizer_fr_FR.propertiesというプロパティ・ファイルが生成されます。	String	いいえ。
version	使用されるI10n_msgcat.dtdのバージョンを指定します。 使用方法: "1.0"である必要があります。 構文: x.y - ここで、xおよびyは数値です。 例: version="1.0"	String	はい。

H.2.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のmessage_catalog要素の使用方法を示します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>

H.3 logmessage

この要素を使用して正式なログ・メッセージを定義します。

H.3.1 子要素

logmessageコンポーネント構成要素では、次の子要素をサポートしています。

• messagebody

• messagedetail

• cause

• action

H.3.2 属性

表H-6ではlogmessageコンポーネント構成要素の属性が一覧表示されています。

表H-2 logmessage要素の属性

属性	説明	データ型	必須?
messageid	このログ・メッセージのユニークな識別子。識別子は、すべてのカタログにわたりユニークである必要があります。値は、baseid属性とendid属性で定義された範囲で指定する必要があります。 使用方法: 値は、message_catalog要素に定義されているbaseidおよびendid属性で定義された範囲内である必要があります。 構文: 1桁から6桁の数値。 例: messageid="600001"	String	はい。
datelastchanged	このメッセージの修正管理に使用される日付と時刻のスタンプ。日付は、カタログで動作するユーティリティによって提供されます。 使用方法: 日付はカタログで動作するユーティリティによって提供されます。 構文: Long.toString(new Date().getTime());	String	いいえ。

H.3.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のlogmessage要素の使用方法を示します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>

H.4 message

この要素を使用して非公式のログ・メッセージを定義します。

H.4.1 子要素

message要素は、次の子要素をサポートしています。

• messagebody

H.4.2 属性

表H-3では、message要素の属性を示します。

表H-3 message要素の属性

属性	説明	データ型	必須?
messageid	このログ・メッセージの、英数字文字列での一意の識別子。このカタログでのみ、一意である必要があります。	String	はい。
datelastchanged	このメッセージの修正管理に使用される日付と時刻のスタンプ。日付は、カタログで動作するユーティリティによって提供されます。 使用方法: 日付はカタログで動作するユーティリティによって提供されます。 構文: Long.toString(new Date().getTime());	String	いいえ。

H.4.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のmessage要素の使用方法を示します。

<?xml version="1.0"?> 
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<locale_message_catalog
  l10n_package="programs.utils"
  version="1.0">
  <message messageid="FileMenuTitle">
    <messagebody>
      File
    </messagebody>
  </message>
</message_catalog>

H.5 messagebody

この要素を使用して、簡潔な1行ログ・メッセージの本文を定義します。

H.5.1 子要素

messagebody要素には子要素はありません。

H.5.2 属性

messagebody要素には属性はありません。

H.5.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のmessagebody要素の使用方法を説明します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>

H.6 messagedetail

この要素を使用して、ログに記録される問題の詳細な説明を定義します。

H.6.1 子要素

messagedetail要素は子要素をサポートしていません。

H.6.2 属性

messagedetail要素には属性はありません。

H.6.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のmessagedetail要素の使用方法を説明します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>

H.7 cause

この要素を使用して、ログに記録される問題の根本的な原因を定義します。

H.7.1 子要素

cause要素は子要素をサポートしていません。

H.7.2 属性

cause要素には属性はありません。

H.7.3 例

次の例は、ログ・メッセージ・カタログ・ファイル内のcause要素の使用方法を説明します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>

H.8 action

この要素を使用して、該当する場合に、ログに記録される問題の解決方法を定義します。

H.8.1 子要素

action要素は子要素をサポートしていません。

H.8.2 属性

action要素には属性はありません。

H.8.3 例

次の図は、ログ・メッセージ・カタログ・ファイル内のaction要素の使用方法を説明します。

<?xml version="1.0"?>
<!DOCTYPE message_catalog PUBLIC 
   "weblogic-locale-message-catalog-dtd"
   "http://www.bea.com/servers/wls90/dtd/l10n_msgcat.dtd">
<message_catalog 
  l10n_package="programs.utils"
  version="1.0">
  <logmessage
    messageid="600001">
    <messagebody>
      Could not open file, {0} on {1,date} after {2,number} attempts.
    </messagebody>
    <messagedetail>
      The configuration for this application will be defaulted to
      factory settings. Custom configuration information resides
      in file, {0}, created on {1,date}, but is not readable.
    </messagedetail>
    <cause>
      The user is not authorized to use custom configurations. Custom
     configuration information resides in file, {0}, created on
     {1,date}, but is not readable.The attempt has been logged to
     the security log.
    </cause>
    <action>
      The user needs to gain approriate authorization or learn to
      live with the default settings.
    </action>
  </logmessage>
</message_catalog>