Implementierungshandbuch › Implementierung › Datenerfassung (Datenexperte) › Konfigurieren von Adaptern und Übersetzungen › Dateiadapter-Falluntersuchung › Abschnitt "TranslatorCollection" der Konfigurationsdatei

Abschnitt "TranslatorCollection" der Konfigurationsdatei

Der Abschnitt "Translator Collection" definiert, wie der geparste und verarbeitete Datenquellen-Datensatz, der in vorherigen Abschnitten extrahiert wurde, in ein CA Business Service Insight-Event übersetzt wird.

Dieser Abschnitt gibt auch an, wie doppelte Events gehandhabt werden und der Mechanismus der Event-Besonderheit verwendet wird (weitere Informationen finden Sie unter Event-Besonderheit).

Wenn der Schnittstellenmodus auf "Online" gesetzt wird, hat das CA Business Service Insight-Event eine einheitliche Struktur, die folgende Felder enthält:

• Timestamp: Die Zeit des Eintretens des Events.
• ResourceId: Die Ressourcen-ID, die mit dem Event verknüpft ist (die Ressource, die innerhalb dieses Events gemessen wurde).
• EventTypeId: Der Event-Typ, der mit dem Event verknüpft ist, beschreibt den Event-Typ (Typ der Ressourcenmessung, Ticketaktion usw.).
• DataSourceId (optional): Jeder Wert. Liefert zusätzliche Filterkriterien für Rohdaten-Events.
• Value (mehrere): Wert(e) des Events (Messevent, Ticketnummer usw.). Dieses Feld ist häufig mehr als einmal vorhanden.

Die Struktur des Übersetzers entspricht der Struktur des Event-Typs in CA Business Service Insight und auch der Datenbanktabelle T_RAW_DATA, die das Event, wie in der folgenden Abbildung angezeigt, speichert:

• Translator: Beschreibt, wie der Satz von Feldern, die er erhält, in das Ausgabe-Event übersetzt wird.
• TranslatorName: Der Name, der von InputFormat verwendet wird, um Feldsätze an diesen Übersetzer zu senden. Dieses Beispiel verwendet den Namen "Translator1". Beziehen Sie sich auf die vorherige Abbildung für Werte, die für dieses Szenario verwendet werden können.
• TranslatorFields: Enthält eine Liste von TranslatorField-Elementen, die jeweils die folgenden Attribute enthalten:
  • Name: Feldname. Bei der Onlineschnittstelle muss er Timestamp, ResourceId, EventTypeId, ResourceId oder Value lauten.
  • SourceType: Gibt die Quelle des Feldwerts an. Hierbei kann es sich um einen der folgenden Optionen handeln:
    • Field: Der Wert dieses Feldes wird vom Feld im Eingabeformat übernommen. Das SourceName-Attribut enthält den InputFormat-Feldnamen.
    • Table: Der Wert des Feldes wird von der Übersetzungstabelle übernommen. Das SourceName-Attribut enthält den Namen der Übersetzungstabelle, der sich auf einen Namen bezieht, der im nächsten Abschnitt von "TranslationTableCollection" angegeben wird. Dieser Typ wird für Werte verwendet, die ausgewählt werden, um in Ressourcen und Event-Typen des Events übersetzt zu werden.
    • Lookup: Der Wert dieses Feldes wird von der Übersetzungstabelle übernommen. Das SourceName-Attribut enthält den Tabellennamen. Der Wert soll vom Attribut "LookupValue" und nicht vom Eingabeformat übersetzt werden. Er wird üblicherweise verwendet, wenn ein konstanter Wert zum Übersetzen benötigt wird.
    • Constant: Der Wert des Feldes ist konstant, und sein Wert befindet sich im Attribut "ConstantValue". Wird ein konstanter Wert verwendet, ist es notwendig, den Feldtyp durch die Verwendung des Typattributs anzugeben.
  • SourceName: Enthält den Feldnamen oder den Namen der Übersetzungstabelle.
  • 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 entsprechend dem "TimeFormat" (festgelegt im Abschnitt "Allgemein" des Adapters), "Now" oder "NowUtc" formatiert, wobei "Now" die aktuelle Zeit im Datenquellen-Gebietsschema und "NowUtc" die aktuelle Zeit in UTC-Format ist.

Dieser Abschnitt enthält auch die Zuordnungstabellen, die die Zuordnung von Datenquellenwerten zu CA Business Service Insight-Event-Feldern festlegen, und die Tabellendefinition mit dem zugehörigen Datenquellenwert, der übersetzt werden soll.

• LoadingMode: Der Standardwert für die Onlineschnittstelle ist "Remote" und für die Offlineschnittstelle "Eigenständig".

  Festgelegte Lademethode der Übersetzungstabellen ist wie folgt:

  • Standalone: Der Adapter lädt die Übersetzungstabellen lokal. Es gibt in Bezug auf die Übersetzung keine Verbindung zum CA Business Service Insight-Server. Änderungen in den Übersetzungstabellen werden nur in der lokalen Datei gespeichert.
  • Remote: Der Adapter sendet eine Anfrage, um alle Tabellen des CA Business Service Insight-Servers zu laden. In den Übersetzungstabellen vorgenommene Änderungen werden auch lokal gespeichert.
• TranslationTable: Verlinkt den Ereigniswert zur Zuordnungstabelle.Name: Field name.
  • Name: Name der Übersetzungstabelle, den der Übersetzer verwendet und auf den er sich bezieht.
  • DestinationType: [resource, event_type, contract_party, service, time_zone, value]. Enthält den Typ der Übersetzungstabelle. In diesem Beispiel wird die Spalte Server in der Datenquellendatei in eine CA Business Service Insight-Ressource übersetzt. Daher ist der Typ der Übersetzungstabelle "Ressource", und die Tabelle enthält die Übersetzungen der Werte in Ressourcen-IDs in CA Business Service Insight.
  • TranslationField: Der Feldname, von dem übersetzt werden soll und der von den Eingabeformatfeldern übernommen wird. Kann maximal fünf Felder enthalten.

Jede in der Konfigurationsdatei festgelegte Übersetzungstabelle muss eine entsprechende Definition in der CA Business Service Insight-Benutzeroberfläche aufweisen.

Die XML-Darstellung einer Beispielkonfigurationsdatei sieht wie folgt aus:

<?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>