実装ガイド › 実装 › データ収集（データ ソース エキスパート） › アダプタおよび変換の設定方法 › ファイル アダプタのケース スタディ › 設定ファイルの TranslatorCollection セクション

設定ファイルの TranslatorCollection セクション

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

このセクションでは、重複するイベントを処理する方法およびイベント固有性メカニズムを使用する方法も定義します（詳細については「イベント固有性」を参照してください）。

インターフェース モードをオンラインに設定する場合、CA Business Service Insight イベントは以下のフィールドを含む統合構造を持ちます。

• Timestamp： イベントの発生時間。
• ResourceId： イベントに関連付けられたリソース ID（そのイベントで測定されたリソース）。
• EventTypeId： イベントと関連付けられたイベント タイプであり、イベント タイプの説明（リソースの測定値のタイプ、チケット アクションのタイプなど）。
• DataSourceId（オプション）： 任意の値です。 Raw データ イベントに追加するフィルタ基準です。
• Value（複数可）： イベントの値（測定結果、チケット番号など）。 多くの場合、このフィールドは 1 回以上出現します。

トランスレータの構造は、CA Business Service Insight のイベント タイプ、および以下の図に示すようにイベントを格納するデータベース テーブル T_RAW_DATA に対応しています。

• Translator： 取得するフィールド セットを出力イベントに変換する方法を説明します。
• TranslatorName： このトランスレータへフィールド セットを送信するために InputFormat によって使用される名前。 この例では「Translator1」を使用します。 このシナリオで使用できる値については、上の図を参照してください。
• TranslatorFields： TranslatorField エレメントのリストが含まれており、それぞれが以下の属性を持ちます。
  • Name： フィールド名。 オンライン インターフェースでは、Timestamp、ResourceId、EventTypeId、ResourceId または Value にする必要があります。
  • SourceType： フィールド値のソースを指定します。 以下のいずれかになります。
    • Field： このフィールドの値は入力フォーマットのフィールドから取得されます。 SourceName 属性には InputFormat フィールド名が格納されます。
    • Table： フィールドの値が変換テーブルから取得されます。 SourceName 属性には、次の TranslationTableCollection セクションに定義されている名前を参照する変換テーブルの名前が格納されます。 このタイプは、イベントのリソースおよびイベント タイプに変換する値に使用します。
    • Lookup： このフィールドの値は変換テーブルから取得されます。 SourceName 属性にはテーブル名が含まれます。 入力フォーマットではなく LookupValue 属性から変換される値です。 通常、変換に定数が必要な場合に使用します。
    • Constant： フィールドの値は定数で、値は ConstantValue 属性にあります。 定数を使用する場合は、Type 属性を使用してフィールド タイプを指定する必要があります。
  • SourceName： フィールド名または変換テーブル名が格納されます。
  • LookupValue： SourceType="lookup" を設定している場合に検索値を格納します。
  • ConstantValue： SourceType=constant を設定している場合に定数値を格納します。 フィールド タイプが時間であるとき、定数値は TimeFormat（アダプタの General セクションで設定）に従ってフォーマットされた文字列、または「Now」か「NowUtc」になります。「Now」はデータ ソース ロケールの現在の時刻、「NowUtc」は UTC の現在の時刻です。

このセクションには、データ ソース値の CA Business Service Insight イベント フィールドへのマッピングを定義するマッピング テーブルも含まれており、変換する参照データ ソース値と共にテーブルの定義が保持されます。

• LoadingMode： オンライン インターフェースのデフォルトは「remote」、オフライン インターフェースは「standalone」です。

  変換テーブルのローディング メソッドは以下のとおりです。

  • Standalone： アダプタは変換テーブルをローカルにロードします。 変換に関しては CA Business Service Insight サーバと接続しません。 変換テーブルの変更はローカル ファイル内にのみ保持されます。
  • Remote： アダプタは CA Business Service Insight サーバからすべてのテーブルをロードするリクエストを送信します。 変換テーブルの変更は同じくローカルに格納されます。
• TranslationTable： イベント値をマッピング テーブルにリンクします。
  • Name： トランスレータによって使用され参照される変換テーブルの名前。
  • DestinationType： [resource、event_type、contract_party、service、time_zone、value]。 変換テーブルのタイプを保持します。 この例では、データ ソース ファイルの Servers 列が CA Business Service Insight リソースに変換されます。 そのため、変換テーブル タイプは Resource になり、CA Business Service Insight のリソース ID へ変換値を保持します。
  • TranslationField： 入力フォーマット フィールドに取得される変換元前のフィールド名。 最大で 5 つのフィールドを格納することができます。

設定ファイルに定義された変換テーブルは、それぞれ CA Business Service Insight ユーザ インターフェース内に対応する定義が必要です。

サンプル設定ファイルの XML 表現は以下のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<AdapterConfiguration>
     <General MajorVersion="4" MinorVersion="0" RunOnce="yes" LogDebugMode="yes"
ConsoleDebugMode="yes" WorkingDirectoryName="output" RejectedEventsUpperLimit="10000">
     <DataSourceDifferenceFromUTC DefaultOffset="0" TimeFormat="%d/%m/%Y %H:%M">
          <DaylightSaving From="20/04/2001 00:00" To="15/10/2001 00:00" Shift="1"/>
     </DataSourceDifferenceFromUTC>
</General>
     <OblicoreInterface Mode="online">
          <OnlineInterface Port="5555" SecurityLevel="none"/>
     </OblicoreInterface>
     <DataSourceInterface>
          <Files>
               <File DeleteFileAfterProcessing="no" InputFormat="InputFormat1" NamePattern="servers*.csv" Path=" C:¥Program Files¥Oblicore¥Adapters¥ServersAdapter¥data¥" TitleExists="yes" SleepTime="60" Delimiters=","/>
      </Files>
</DataSourceInterface>
<InputFormatCollection>
     <InputFormat InputFormatName="InputFormat1">
          <InputFormatFields>
               <InputFormatField Name="resource" Type="string"/>
                    <InputFormatField Name="timestamp" Type="time" TimeFormat="%d.%m.%Y %H:%M"/>
                        <InputFormatField Name="memory_util" Type="real"/>
                        <InputFormatField Name="cpu_util" Type="real"/>
                </InputFormatFields>
     <TranslatorSwitch DefaultTranslator="Translator1"/>
     </InputFormat>
</InputFormatCollection>
<TranslatorCollection>
<Translator TranslatorName="Translator">
         <TranslatorFields>
            <TranslatorField Name="ResourceId" SourceType="table" SourceName="ResourceTable"/>
            <TranslatorField Name="EventTypeId" SourceType="lookup" SourceName="EventTable" LookupValue="PerformanceEvent"/>
            <TranslatorField Name="Timestamp" SourceType="field" SourceName="timestamp"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="memory_util"/>
            <TranslatorField Name="Value" SourceType="field" SourceName="cpu_util"/>
         </TranslatorFields>
      </Translator>
   </TranslatorCollection>
   <TranslationTableCollection LoadingMode="remote">
      <TranslationTable Name="ResourceTable" DestinationType="resource">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
      <TranslationTable Name="EventTable" DestinationType="event_type">
         <TranslationField>resource</TranslationField>
      </TranslationTable>
   </TranslationTableCollection>
</AdapterConfiguration>