Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › Abschnitt "TranslatorCollection"

Abschnitt "TranslatorCollection"

Der Abschnitt "TranslatorCollection" beschreibt, wie die im vorherigen Abschnitt zu einem CA Business Service Insight-Event extrahierten, geparsten und bearbeiteten Datenquellendatensätze übersetzt werden sollen.

Wenn der Schnittstellenmodus "online" ist, hat das CA Business Service Insight-Event eine einheitliche Struktur, welche die folgenden Felder enthält:

• Timestamp: Die Zeit des Eintretens des Events.
• ResourceId: Die mit dem Event verbundene Ressourcen-ID von CA Business Service Insight (die gemessene Ressource etc.).
• EventTypeId: Der mit dem Event verbundene Event-Typ von CA Business Service Insight, der die Art des Events beschreibt (Art der Messung auf der Ressource, Art der Ticketaktion etc.).
• DataSourceId: (optional) Der Name der Eingabedatenquelle (Dateiname/Tabellenname ...).
• Value: Der Wert des Events (Messergebnis, Ticketnummer etc.). Diese Feld kann mehrmals vorhanden sein.

Wenn der Schnittstellenmodus "offline" ist, gibt es keine Beschränkungen auf die Anzahl der Feldern oder auf deren Namen.

XML-Struktur:

<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: Beschreibt, wie der Satz von Feldern, die er erhält, in das Ausgabe-Event übersetzt wird.
  • TranslatorName: Name, der von "InputFormat" verwendet wird, um diesem Übersetzer Feldeinstellungen zu senden.
  • OnDuplication: Mitglied, das "ignore"-, "add"-, "update"- oder "updateAlways"-Werte enthält, um zu entscheiden, was mit dem doppelten Event zu tun ist (siehe Event-Besonderheit)
  • TranslatorFields: Enthält eine Liste von TranslatorField-Elementen, jeweils mit den folgenden Attributen:
  • Name: Feldname. In der Onlineschnittstelle muss es "Timestamp", "ResourceId", "EventTypeId", "Value" oder "DataSourceId" sein.
  • SourceType:

    Field: Der Wert dieses Feldes wird vom Feld im Eingabeformat übernommen. Das SourceName-Attribut enthält den Feldnamen.

    Table: Der Wert des Feldes wird von der Übersetzungstabelle übernommen. Das SourceName-Attribut enthält den Tabellennamen.

    Lookup: Der Wert dieses Feldes wird von der Übersetzungstabelle übernommen. Das SourceName-Attribut enthält den Tabellennamen. Der zu übersetzende Wert wird vom LookupValue-Attribut und nicht vom Eingabeformat übernommen.

    Constant: Der Wert des Feldes ist konstant, und sein Wert befindet sich im ConstantValue-Attribut.

  • SourceName: Enthält den Feldname zum Übersetzen des Tabellennamens
  • Type: [integer/real/string/time] Nur erforderlich, wenn der Typ des Feldes nicht vordefiniert wird (durch Feldnamen oder durch SourceType). In der Onlineschnittstelle nur für Wertfeld mit SourceType=constant erforderlich. In der Offlineschnittstelle nur für jedes Feld mit SourceType=constant erforderlich.
  • IsKey: Repräsentiert den einmaligen Schlüssel des Events. Dieser Schlüssel wird von Feldern zusammengesetzt, die als TranslatorFields?IsKey = "yes" gekennzeichnet wurden.

    (Siehe Event-Besonderheit)

  • LookupValue: Enthält den Suchwert, wenn SourceType="lookup".
  • ConstantValue: Enthält den konstanten Wert, wenn SourceType=constant. Wenn der Typ des Feldes "Time" ist, wird der konstante Wert formatiert, entsprechend dem "TimeFormat" oder "Now" oder "NowUtc", wo die aktuelle Zeit "Now" im Datenquellen-Gebietsschema ist und "NowUtc", wo die aktuelle Zeit in UTC ist.
  • TimeFormat: Enthält das TimeFormat, nur für Felder mit SourceType=constant und Type=time erforderlich.
  • TimeShift: Definiert die Zeitverschiebung in Sekunden, nur für Zeitfelder.
  • TimeShiftFieldName: (optional) Enthält den Feldnamen vom Eingabeformat, das eine Zeitverschiebung in Sekunden enthält. TimeShift und TimeShiftFieldName können zusammen sein.