Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › Abschnitt "General"

Abschnitt "General"

Der Abschnitt "General" besteht aus Attributen und Unterknoten:

XML-Struktur:

<General	
MajorVersion="2345"
MinorVersion="01245"
WorkingDirectoryName=" output"
DataSourceControlFileName="DatasourceControl.xml"
SendFileName="Send.txt"
SendControlFileName="SendControl.xml"
LogDebugMode="no"
ConsoleDebugMode="no"
RunOnce="yes"	
RepeatUntilDry="yes"
RuntimeErrorLimit="1"	
RetryRejectedEvents="yes"
RejectedEventsFileName="rejectedEvents.txt"
RejectedEventsUpperLimit="1000"
RegExUnlimitedSearch (V3.1 Patch)="no"
HoldRejectedEventsSpan="24"
GenerateStatistics="yes"
StatisticsFileName="MyStatistics.txt" >
KeepHistoricState="yes" >
DefaultTimeFormat="%Y/%m/%d-%H:%M:%S"
DefaultDecimalSymbol="."
DataSourceIdMaxLength="60"
DefaultDigitGroupingSymbol=","
SaveIllegalEvents ="no"
WriteEventErrorToLog ="yes"
IllegalEventsDirectoryName="xxxpath"
<DataSourceDifferenceFromUTC 
	DefaultOffset="2"
	TimeFormat="%Y/%m/%d-%H:%M:%S">
	<DayLightSaving 
		From="04.09.01-12:00:00"
		To="09.01.01-12:00:00"
		Shift="1"/>
</ DataSourceDifferenceFromUTC >
</General>

• MajorVersion: Gibt die höchste Versionsnummer an.
• MinorVersion: Gibt die niedrigste Versionsnummer an.
• WorkingDirectoryName: optional.

  Gibt den Standardpfad für die Adapter-Ausgabedateien an (Datenquellensteuerung, Übersetzung, Senden).

  Standardwert = Ausgabeverzeichnis (Ordner) im Verzeichnis der Konfigurationsdatei.

• DataSourceControlFileName: optional.

  Name der Datei, die der Adapter verwendet, um die letzten Datensätze nachzuverfolgen, die aus der Datenquelle abgerufen wurden.

  Standardwert = DataSourcecontrol.xml. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• SendFileName: optional

  Name der Datei, die die Events enthält, bevor sie an CA Business Service Insight gesendet werden.

  Standardwert = Send.txt. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• SendControlFileName: optional

  Name der Datei, die der Adapter für das Nachverfolgen des Sendevorgangs nutzt.

  Standardwert = SendControl.xml (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• DataSourceIdMaxLength:

  Maximale Länge für das Feld "DataSourceId" in der Tabelle "t_raw_data". Wenn der Anwender einen längeren String einfügt, gibt der Adapter einen Fehler zurück.

  Dieser Wert muss kleiner als die tatsächliche Größe der Tabelle oder gleich sein.

  Standardwert = 60

• SaveIllegalEvents: Dieses Attribut gibt an, dass ungültige Events in die Datei geschrieben werden müssen.

  Standardwert = no

• WriteEventErrorToLog: Legt fest, ob Datenfehler in die Tabelle "T_Log" geschrieben werden

  Erlaubte Werte = [yes/no]

  Standardwert = yes

• IllegalEventsDirectoryName: kein Standardwert
• SendFileName: optional

  Name der Datei, die die Datensätze enthält, bevor sie an CA Business Service Insight gesendet werden.

  Standardwert = Send.txt. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• §SendControlFileName: optional

  Name der Datei, die der Adapter für das Nachverfolgen des Sendevorgangs nutzt.

  Standardwert = SendControl.xml (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• LogDebugMode: optional

  Erlaubte Werte = [yes/no]

  "yes": Die ursprüngliche Zeile aus der Datenquelle, die Parsing-Ergebnisse und das einheitliche CA Business Service Insight-Event werden protokolliert.

• ConsoleDebugMode: optional

  Erlaubte Werte = [yes/no]

  "yes": Auf der Konsole werden Debug-Meldungen angezeigt.

  • Indikatoren für das Lesen und Übersetzen von Datensätzen:
    • .: Für einen Datensatz, der gelesen und in ein Ausgabe-Event übersetzt wurde.
    • i: Für einen Datensatz, der vom Parser für reguläre Ausdrücke ignoriert wurde.
    • I: Für einen Datensatz, der gelesen und von den Übersetzungstabellen ignoriert wurde.
    • R: Für einen Datensatz, der gelesen, aber von der Übersetzungstabelle abgelehnt wurde (kann nicht von den Übersetzungstabellen übersetzt werden).
    • X: Für einen Datensatz, bei dem beim Parsen ein Problem aufgetreten ist. Er wird ignoriert und geht verloren oder wird im Verzeichnis für unzulässige Events gespeichert.

  Hinweis: Wenn der Lesedatensatz mehr als einen Übersetzer durchläuft, wird die Angabe des Datensatzes in Klammern gesetzt. Zum Beispiel: [...] oder [RRI].

  • Statusindikatoren des Adapters:
    • 0: Der Adapter ist aktiv und liest in der letzten Sekunde keine Datensätze.
    • E: Fehlerstatus.
    • P: Pausenstatus.
    • S: Stoppbefehl von CA Business Service Insight.
    • B: Gesperrter Status, die Tabelle mit abgelehnten Events ist voll.
    • Übersetzungstabellen-Indikatoren:
    • L: Auf Übersetzungstabellen warten.
    • T: Von CA Business Service Insight gesendete/empfangene Übersetzungstabelle.
    • t: Von CA Business Service Insight gesendete/empfangene Änderungen in der Übersetzungstabelle.
    • Verbindungs-Indikatoren:
    • <Connecting CA Business Service Insight: Versuch, eine Verbindung zu CA Business Service Insight herzustellen.
    • <Connecting CA Business Service Insight: Verbindung hergestellt.
    • <Connecting DataSource: Versuch, eine Verbindung zur Datenquelle herzustellen.
    • <Connecting DataSource>: Verbindung hergestellt.
• RunOnce: optional

  Erlaubte Werte = [yes/no]

  "no": Adapter wird kontinuierlich ausgeführt.

  "yes": Der Textdatei-Adapter wird ausgeführt, liest Datensätze und wird automatisch angehalten. Der Dateiadapter liest ganze Dateien, wartet wenige Sekunden, versucht neue Datensätze zu lesen (je nach SleepTime). Wenn keine entsprechenden Datensätze vorhanden sind, wird er angehalten.

  Ein SQL-Adapter führt jede Abfrage nur einmal aus. Wenn "RepeatUntilDry" auf "no" festgelegt wird, wird er sofort angehalten. Wenn "RepeatUntilDry" auf "yes" festgelegt wird, wartet er (abhängig von "SleepTime"), versucht die Abfragen erneut auszuführen (abhängig von der "SleepTime" der Abfrage) und wird angehalten, wenn keine neue Datensätze vorhanden sind.

• RepeatUntilDry: optional

  Erlaubte Werte = [yes/no], Standardwert = yes

  Siehe Attribut "RunOnce" oben.

• RuntimeErrorsLimit: optional

  Bestimmt die Fehlergrenze (beispielsweise für Fehler in den Eingabe-Events), bevor der Adapter gesperrt wird. Bei 0 wird der Adapter nicht gesperrt.

  Standardwert = 1 (Der Adapter wird nach dem ersten Fehler gesperrt.)

• RetryRejectedEvents: optional

  Erlaubte Werte = [yes/no], Standardwert = yes

  "yes": Zu übersetzende Datensätze werden in der Datei mit abgelehnten Events beibehalten, wo sie auf die Übersetzung warten.

  Es wird nicht empfohlen, für dieses Attribut "no" zu wählen, da wichtige Daten verloren gehen können.

• RejectedEventsFileName: optional

  Name der Datei, die der Adapter verwendet, um Datensätze nachzuverfolgen, die aus der Datenquelle abgerufen wurden und auf die Übersetzung warten.

  Standardwert = Value-rejected.txt. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• RejectedEventsUpperLimit: optional

  Bestimmt den Grenzwert für abgelehnte Datensätze, die in der rejected.txt-Datei gespeichert werden. Hat der Adapter diesen oberen Grenzwert erreicht, wird er angehalten und gesperrt, bis diese Daten übersetzt werden.

  Standardwert = 1000

• RegExUnlimitedSearch: Legt fest, dass der Adapter eine vollständige Suche gemäß dem regulären Ausdruck durchführt.

  Erlaubte Werte = [yes/no]

  Standardwert = no

• HoldRejectedEventsSpan: optional

  Legt fest, wie lange die Datei mit abgelehnten Events gespeichert wird (in Stunden). Wenn dieses Attribut angegeben wird, löscht der Adapter alle Events, die verarbeitet werden müssen, bevor der Adapter erneut gestartet werden kann.

  Es wird nicht empfohlen, dieses Attribut zu verwenden, da wichtige Daten verloren gehen können.

• GenerateStatistics: optional

  Erlaubte Werte = [yes/no], Standardwert = yes

  "yes": Der Adapter erstellt minütlich eine Statistikdatei mit Statistikinformationen.

• StatisticsFileName: optional

  Name der Statistikdatei

  Standardwert = Value-statistics.txt. (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• KeepHistoricState: optional

  Erlaubte Werte = [yes/no], Standardwert = no

  "yes": Der Adapter speichert alle Dateien, außer der Protokolldatei, in einem neuen Verzeichnis mit dem Namen "Historic state yyyymmdd-hhmmss", wobei "yyyymmdd" und "hhmmss" Datum und Uhrzeit der Erstellung angeben.

• DefaultTimeFormat: optional

  Standardzeitformat Wenn dieses Attribut angegeben wird, wird es als Zeitformat verwendet, wenn das TimeFormat-Attribut nicht angegeben wird. Wenn es nicht angegeben wird, ist das TimeFormat-Attribut in den anderen Elementen obligatorisch.

• DefaultDecimalSymbol: optional

  Das Standard-Dezimaltrennzeichen für reale Felder.

  Standardwert = (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• DefaultDigitGroupingSymbol: optional

  Standardsymbol für Zifferngruppierung für Felder mit Ganzzahl- und Realwerten.

  Standardwert = (Wenn nicht anders angegeben, wird der Standardwert verwendet.)

• DataSourceDifferenceFromUTC: Gibt den Zeitunterschied zwischen UTC und der Zeitzone der Datenquellenmaschine an.
  • DefaultOffset: Abweichung zu UTC, wenn nicht in Sommerzeit.
  • TimeFormat: Gibt das Format an, in dem die Sommerzeitdetails (als Nächstes beschrieben) geparst werden sollen.
  • DayLightSaving: Gibt einen Sommerzeit-Zeitraum der Datenquellenzeitzone an. Dieses Element ist optional (das heißt, wenn diese Option nicht gewählt wird, wird keine Sommerzeit angegeben) und kann mehr als einmal vorhanden sein. Wenn mehrere Elemente vorhanden sind, müssen sie nach Zeit geordnet werden. Die Zeiträume dürfen sich nicht überschneiden.
    • Von: Anfangsdatum des Zeitraums.
    • Bis: Enddatum des Zeitraums.
    • Unterschied: Zeitverschiebung, die zu "DefaultOffset" innerhalb des Sommerzeit-Zeitraums hinzugefügt wird.