实施指南 › 适配器配置规范 › TranslatorCollection 部分

TranslatorCollection 部分

TranslatorCollection 部分描述了如何将在前一部分中提取的已解析和已处理的数据源记录转换为 CA Business Service Insight 事件。

接口模式为“online”（联机）时，CA Business Service Insight 事件具有包含以下字段的统一结构：

• Timestamp：事件发生的时间。
• ResourceId：与事件关联的 CA Business Service Insight 资源 ID（度量的资源等）。
• EventTypeId：与事件关联的 CA Business Service Insight 事件类型，描述了事件的类型（资源上的度量类型、故障单操作类型等）。
• DataSourceId：（可选）输入数据源的名称（文件名/表名...）。
• Value：事件的值（度量结果、故障单编号等）。 此字段可以出现多次。

接口模式为“offline”（脱机）时，对字段数目或其名称没有任何限制。

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 属性，而不是输入格式。

    LookupValue：字段的值为常量，其值在 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：包含 TimeFormat，仅对 SourceType=constant 和 Type=time 的字段必需。
  • TimeShift：定义偏移时间（以秒为单位），仅适用于时间字段。
  • TimeShiftFieldName：（可选）包含来自输入格式（包含以秒为单位的时间偏移）的字段名称。 TimeShift 和 TimeShiftFieldName 可以一起使用。