Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › Abschnitt "DataSourceInterface"

Abschnitt "DataSourceInterface"

Der Abschnitt "DataSourceInterface" besteht aus Attributen, die die Verbindung und den Verbindungstyp zwischen dem Adapter und der Datenquelle angeben (Messtool, CRM, Systemprotokoll usw.), und ist in zwei Haupttypen unterteilt: Dateischnittstelle und SQL-Schnittstelle.

Dateischnittstelle

Mit dem Dateiadapter können Daten aus Protokolldateien, geplanten Berichten oder anderen textbasierten Dateien abgerufen werden. "DataSourceInterface" definiert Regeln für das Parsen der Informationen aus der Dateidatenquelle und das Extrahieren in Felder.

Der Abschnitt "DataSourceInterface" gibt auch an, wie der Adapter die Quelldatei verwaltet (ob er die ursprüngliche Datei löscht, wenn sie nur für den Adapter erstellt wurde, oder, ob er die Daten beibehält, wenn sie für andere Verwendungen benötigt werden, und so weiter).

XML-Struktur:

<DataSourceInterface WorkFileName="MyWorkingFile.txt" >
   <Files>
	<File
            IsActive="yes"	
		InputFormat="events"
		Path="D:\adapters\sample_data\"
		NamePattern="adapterXXX*.log"
		DeleteFileAfterProcessing="no"
		Delimiters=","
		IgnoreRedundantDelimiters ="no"
		TitleExists="no"
		SleepTime="10">
	</File>	
   </Files>
</DataSourceInterface>

• WorkFileName: optional. "DeleteFileAfterProcessing" = "no": Es wird eine Kopie der Datei mit diesem Namen erstellt. "yes": Die Datei wird in diesen Namen umbenannt. Wenn nichts angegeben wird, wird der Standardwert übernommen ('WorkFile.txt').
  • Files: Sammlung von Dateielementen. (Es können mehrere Dateien in einem Adapter angegeben werden.)
  • File: Gibt die Dateiattribute an.
    • IsActive: optional [yes/no] Definiert, ob diese Datei aktiv ist. ("no": Diese Datei wird nicht gelesen.)
    • InputFormat: Das mit dieser Datei verknüpfte Eingabeformat. Der Adapter verwendet "InputFormat", um die Daten aus der Datenquelle zu extrahieren.
    • Path: Pfad zum Speicherort der Quelldatendateien.
    • NamePattern: Gibt den Datenquelldateinamen an. Verwendung von Platzhalter möglich, wenn mehrere Dateien dasselbe Eingabeformat nutzen.
    • DeleteFileAfterProcessing [yes|no] – Art und Weise, wie der Adapter die Quelldatei verarbeitet. Wenn die Datei nur für den Adapter erstellt wurde und nach der Bearbeitung gelöscht werden kann, wählen Sie "yes". Die Datei wird umbenannt, verarbeitet und dann gelöscht. Wenn Sie "no" wählen, wird die Datei kopiert und die Verarbeitung findet in der kopierten Datei statt. Wenn neue Datensätze am Ende dieser Datei eingefügt werden, kopiert der Adapter diese neuen Datensätze während des nächsten Zyklus in die Arbeitsdatei. Wenn keine neuen Datensätze in die Datei eingefügt werden, sucht der Adapter nach der ersten Datei mit dem gleichen Muster und einem anderen Namen (in lexikografischer Reihenfolge) wie die aktuelle Datei. Wenn der Adapter eine derartige Datei identifiziert, arbeitet er mit dieser Datei weiter. Der Adapter kehrt nicht zur vorherigen Datei zurück, auch wenn neue Datensätze in diese Datei eingefügt werden. Wählen Sie "no", wenn Sie die Integrität der Quelldatei beibehalten müssen.
    • InitialFileName: Name der ersten Datei, von der an der Adapter eine Datei mit dem angegebenen Muster sucht. Verwenden Sie dieses Attribut, wenn "NamePattern" Platzhalter enthält und wenn Sie nicht möchten, dass der Adapter alte Dateien liest.
• Delimiters: optional. Ein oder mehrere Zeichen dienen als Trennzeichen, entsprechend denen Datenzeilen in Felder geparst werden (falls der Standardwert nicht "\t" ist).
• IgnoreRedundantDelimiters: optional [yes/no]. Wenn Sie "yes" wählen, werden mehrere aufeinander folgende Trennzeichen als ein einziges behandelt. Andernfalls wird ein leeres Feld zwischen den Trennzeichen eingefügt.
• RegExForParser: (optional). Regulärer Ausdruck zum Extrahieren der Felder aus der Datenquelle als Ersatz für die obigen Trennzeichen. Zum Beispiel:

  <File
      ….
      RegExForParser="^(.{8}) (.{6}) (?:[ ])*([0-9]+) "
  />
  

  In der Dokumentation zu regulären Ausdrücken finden Sie weitere Informationen.

• TitleExists: optional [yes/no]. Gibt an, ob die erste nicht leere Zeile der Datenquelldatei eine Titelzeile ist. Der Titel kann vom Adapter beim Parsen der Daten verwendet werden.
• SleepTime: Gibt das Datenabrufintervall (in Sekunden) an, d. h. die Anzahl von Sekunden zwischen dem Abrufen von Daten von der Quelldatendatei durch den Adapter.
• LogicLineDefinition: optional

  <File
      ….
      <LogicLineDefinition
                      FirstLine="Job server:.*"
                      NumberOfLines="5"
      />
  />
  

  Wenn der Datensatz aus verschiedenen Zeilen besteht, definieren folgende Attribute den Anfangs- und Endpunkt der Extraktion und die Anzahl der Zeilen mit Daten:

  • AllFile: optional [yes/no]. Wenn Sie "yes" wählen, gilt die gesamte Datei als ein Datensatz und eine logische Zeile.
  • FirstLine: optional. Ein regulärer Ausdruck, der die erste Zeile der logischen Zeile definiert. Diese Definition kann mit oder ohne "LastLine" und/oder "NumberOfLines" vorgegeben werden.
  • LastLine: optional. Ein regulärer Ausdruck, der die letzte Zeile der logischen Zeile definiert. Diese Definition kann mit oder ohne "FirstLine" und/oder "NumberOfLines" vorgegeben werden.
  • NumberOfLines: optional. Zeilenanzahl in einer logischen Zeile. Diese Definition kann mit oder ohne "FirstLine" und/oder "LastLine" vorgegeben werden.
  • MatchCase: optional [yes/no]. Definiert, ob bei den regulären Ausdrücken Groß-/Kleinschreibung zu beachten ist.