実装ガイド › アダプタ設定の指定 › TranslatorCollection セクション

TranslatorCollection セクション

TranslatorCollection セクションでは、前のセクションで CA Business Service Insight イベントに抽出された解析および操作済みのデータ ソース レコードを変換する方法を記述します。

インターフェース モードが「オンライン」の場合、CA Business Service Insight イベントは、以下のフィールドが含まれる統合型の構造体になります。

• Timestamp： イベントが発生した時刻
• ResourceId： イベントに関連付けられた CA Business Service Insight のリソース ID（測定されたリソースなど）
• EventTypeId： イベントに関連付けられた CA Business Service Insight のイベント タイプ。イベントのタイプを記述します（リソースに関する測定のタイプ、チケット アクションのタイプなど）。
• DataSourceId： （オプション）入力データ ソースの名前（ファイル名、テーブル名など）
• Value - イベントの値（測定結果、チケット番号など） このフィールドは、複数回表示されることがあります。

インターフェース モードが「オフライン」の場合、フィールド数やフィールド名に関する制限はありません。

XML 構造：

<TranslatorCollection>
   <Translator TranslatorName="events" OnDuplication = "ignore">
	<TranslatorFields>
		<TranslatorField Name="ResourceId" SourceType="table"
		    SourceName="ResourcesTranslateTable" Iskey="yes"/>
		<TranslatorField Name="EventTypeId"	SourceType="constant"
		    ConstantValue="1002" Iskey="yes"/>
		<TranslatorField Name="Timestamp"  	SourceType="field"
                SourceName="timestamp" Iskey="yes"/>
		<TranslatorField Name="Value" 	SourceType="table"
                SourceName="valueUpDownTranslateTable" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="nodeName" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="constant"
                Type="integer" ConstantValue="1000" Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="field"
                SourceName ="timestamp" TimeShift="-3600"
                TimeShiftFieldName="createDate"	Iskey="yes"/>
		< TranslatorField Name="Value"  SourceType ="lookup"
                SourceName ="ServiceTable" LookupValue="word"
                Iskey="yes"/>
      </TranslatorFields>
   </Translator>
</TranslatorCollection>

• Translator： 受信した一連のフィールドを出力イベントに変換する方法を記述します。
  • TranslatorName： 一連のフィールドをこのトランスレータに送信する場合に InputFormat で使用される名前。
  • OnDuplication： 重複イベントをどのように処理するかを決める値（「Ignore」、「Add」、「Update」、または「updateAlways」）が保持されるメンバ（「イベント固有性」を参照）。
  • TranslatorFields： TranslatorField エレメントのリストが含まれます。各エレメントは、以下の属性で構成されます。
  • Name： フィールド名。 オンライン インターフェースでは、必ず「Timestamp」、「ResourceId」、「EventTypeId」、「Value」、または「DataSourceId」のいずれかの値になります。
  • SourceType：

    field： このフィールドの値が入力フォーマットのフィールドから取得されます。 SourceName 属性にフィールド名が含まれます。

    table： このフィールドの値が変換テーブルから取得されます。 SourceName 属性にテーブル名が含まれます。

    lookup： このフィールドの値が変換テーブルから取得されます。 SourceName 属性にテーブル名が含まれます。 変換される値は、入力フォーマットではなく LookupValue 属性から取得されます。

    constant： このフィールドの値が定数になり、ConstantValue 属性に含まれます。

  • SourceName： フィールド名または変換テーブル名が含まれます。
  • Type： ［integer/real/string/time］ フィールドのタイプが（フィールド名または SourceType で）事前定義されていない場合にのみ必須です。 オンライン インターフェースでは、SourceType=constant の Value フィールドでのみ必要となります。 オフライン インターフェースでは、SourceType=constant の各フィールドで必要となります。
  • IsKey： イベントに一意のキーを表します。 このキーは、TranslatorFields?IsKey = "yes" と表示されたフィールドから構築されます。

    （「イベント固有性」を参照）

  • LookupValue： SourceType="lookup" を設定している場合に検索値を格納します。
  • ConstantValue： SourceType=constant を設定している場合に定数値を格納します。 フィールドのタイプが「time」の場合、定数値は TimeFormat に基づく形式の文字列（「Now」または「NowUtc」）になります。「Now」はデータ ソース ロケールでの現在の時刻、「NowUtc」は UTC での現在の時刻です。
  • TimeFormat： 時間形式が含まれます。SourceType=constant および Type=time のフィールドでのみ必要となります。
  • TimeShift： 時間シフト（秒単位）を定義します（時間フィールドにのみ使用される）。
  • TimeShiftFieldName： （オプション）時間シフト（秒単位）を含むフィールド名が入力フォーマットから取得されます。 TimeShift と TimeShiftFieldName は併用可能です。