Implementierungshandbuch › Eigenschaften der Adapterkonfiguration › InputFormatCollection-Abschnitt

InputFormatCollection-Abschnitt

Dieser Abschnitt beschreibt die Struktur der aus der Datenquelle abgerufenen Daten (wie eine Datenzeile in Felder aufgeteilt werden soll, die Feldtypen und die Formate). In diesem Abschnitt erfolgen in den kombinierten Feldern die Eingangsdatenfilterung und Datenbearbeitung.

Der allgemeine Workflow dieses Abschnitts ist folgendermaßen:

• Die Datenzeile stimmt mit einem oder mehreren InputFormat-Elementen überein.
• Die Daten werden nach der Übereinstimmung der Spezifikation "InputFormat" in Felder zerlegt.
• Kombifeldern werden Werte zugewiesen, indem Datenfelder verbunden und geteilt werden.
• Verarbeitete Daten werden gegen TranslatorSwitch-Bedingungen überprüft.
• Verarbeitete Daten werden zum passenden Übersetzer gesandt oder ignoriert.

Der Knoten "InputFormatCollection" kann einen oder mehrere InputFormat-Knoten enthalten.

XML-Struktur:

<InputFormatCollection>
	<InputFormat InputFormatName="MyInputFormat">
	<InputFormatFields> 
		<InputFormatField Name="sid_id" Type="string"/>
		<InputFormatField Name="content" Type="string"/>
		<InputFormatField Name="date" Type="time" 
               TimeFormat="%d/%m/%Y %H:%M:%S"/>
		<InputFormatField Name="server" Type="string" 
               Source="compound">
		<Compound>
			<Segment SourceField="content" 
                     RegularExpression=".*Job server: ([^\n]+).*" />
		</Compound>
		</InputFormatField>
	</InputFormatFields>
<TranslatorSwitch DefaultTranslator="GeoTranslator">
	<TranslatorCase  TranslatorName="NonGeoTranslator" Break="yes">
		<Condition SourceField="routing_info" Operator="EQ"
             Value="cnano"/>
	</TranslatorCase>
</TranslatorSwitch>
</InputFormat>
</InputFormatCollection>

• InputFormat:
  • InputFormatName - Ein beliebiger Name für dieses Format, zum Verweis durch den DataSourceInterface-Abschnitt.
• RequiredFields - (optional) Minimale Anzahl von Feldern, die voraussichtlich in einer Datenzeile gefunden werden. Eine Reihe, die weniger Felder enthält, wird ignoriert, und ein Fehler wird protokolliert.
• InputFormatFields - InputFormatFields kann entsprechend der Anzahl der Eingangsdatenfelder der Datenquelle einen oder mehrere Feldknoten enthalten.
  • InputFormatField - Gibt ein Datenfeld der ursprünglichen Datenzeile oder ein Kombifeld an.

    	<InputFormatField Name="timestamp" Type="time"
    	TimeFormat="%d/%m/%Y %H:%M:%S"/>
    

  • Name - Ein Name für dieses Feld, auf das andere Elemente Bezug nehmen können.
  • Type - Datentyp vom Feld aus string/integer/real/time
  • Source - (optional) Der übernommener Standardwert ist "event", mögliche Werte:
  • event - Der Feldwert wird vom Event der Datenquelle übernommen. Die Werte werden in derselben Reihenfolge entnommen, in der sie von der Datenquelle eingehen.
  • compound - Feld ist eine Zusammensetzung. Es erhält seine Werte nach der Bearbeitung anderer Feldwerte oder Konstanten.
  • Title - Der Feldwert wird vom Titelfeldnamen übernommen. Das betreffende Feld sollte schon definiert sein
  • filename - Der Feldwert wird dem Dateinamen der Datenquelle nur für Textdateiadapter entnommen.
  • constant - Der Feldwert ist konstant und der ConstantValue-Eigenschaft entnommen, die als Nächstes angezeigt werden sollte.
  • FieldTitleName - Wenn die Quelle ein Titel ist, wird der zu verwendende Feldtitel angegeben. Das Quellenfeld muss vorher definiert werden.
  • ConstantValue - Wenn die Quelle konstant ist, wird der Wert angegeben, der angepasst werden muss. 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: Format, in dem das Feld analysiert ist. Die folgenden Zeichencodes können für das Datums- und Zeitformat verwendet werden:

    

  • DecimalSymbol - (optional) Das dezimale Symbol für Felder. Wenn nicht angegeben, wird das DefaultDecimalSymbol vom allgemeinen Abschnitt übernommen.
  • DigitGroupingSymbol - (optional) Dieses Symbol wird als Standard-Stellengruppierungssymbol für Felder mit Ganzzahl- und Realwerten verwendet. Wenn nicht angegeben, wird das DefaultDigitGroupingSymbol, vom allgemeinen Abschnitt übernommen.
• Compound - Erforderlich wenn source=compound. Gibt die in einem Kombifeld zu erfassenden Feldbearbeitungen an.
  • Segment - Gibt eine der erstellten Zusammensetzung hinzuzufügende Feldbearbeitung an. Nur das SourceField-Attribut wird benötigt.
  • SourceField - Feld, das als Basis dienen soll. Das angegebene Feld sollte bereits definiert sein.
  • RegularExpression - Ausdrucksregeln für die Bearbeitung.
  • MatchCase - (optional) [yes/no] Definiert, ob bei den Ausdrucksregeln Groß-/Kleinschreibung zu beachten ist.
  • SelectionStart - Startposition zum Extrahieren von Text, beginnend mit null.
  • SelectionLength - Größe des zu extrahierenden Texts.
  • Prefix - String als Präfix für das Bearbeitungsergebnis.
  • Suffix - String als Suffix für das Bearbeitungsergebnis.
  • XpathExpression - Der xpath-Ausdruck für die Bearbeitung.
• InputFormatSwitch - Wird verwendet, um Formatkriterien anzugeben, wenn Datenzeilen in mehr als einem Format vorliegen.

  Hinweis: Bei der Verwendung von InputFormatSwitch ist die Reihenfolge von InputFormat-Knoten wichtig - ein angegebenes Feld sollte bereits vorher definiert worden sein.

  DefaultInputFormat - Gibt den Namen des InputFormat-Elements an, an das weitergeleitet werden soll.

• InputFormatCase - Gibt ein Kriterium an, das für Datenzeilen getestet werden muss, um zu entscheiden, an welches InputFormat-Element es weitergeleitet werden soll.
• InputFormatName - Das InputFormat, wenn die Kriterien übereinstimmen.
• LogicOperator = (optional) [und/oder].
• und - Alle Bedingungen müssen angepasst werden. (der Standard).
• oder- Mindestens eine Bedingungen muss angepasst werden.
  • Condition - Bedingung, die für eine Datenzeile geprüft wird, um deren Format zu bestimmen.

    SourceField - Feld, das geprüft werden muss.

    Operator - Prüfart der folgenden Optionen:

    • EQ – Gleich
    • NE – Nicht gleich
    • GT – Größer als
    • LT – Kleiner als
    • GE – Größer oder gleich
    • LE – Kleiner oder gleich
    • MATCH – Ausdrucksregel muss angepasst werden.
    • UNMATCH – Ausdrucksregel muss nicht angepasst werden.

    ValueType - (optional) [constant/field/previousValue]

    • constant - Der Inhalt des Wert-Attributs ist konstant, unabhängig von den Quellendaten.
    • field - Der Inhalt des Wert-Attributs ist der Name des Feldes aus dem gleichen Datensatz.
    • previousValue - Der Inhalt des Wert-Attributs ist der Name des Feldes aus dem vorherigen Datensatz in der gleichen Abfrage und mit dem gleichen Eingabeformat.

    Value - Wert, der angepasst werden muss, oder eine Ausdrucksregel.

    MatchCase - (optional) [yes/no] Definiert, ob beim Prüfen Groß-/Kleinschreibung zu beachten ist. Wenn die Option auf "yes" gesetzt ist, werden die zwei Werte vor dem Test in Kleinbuchstaben übersetzt.

• TranslatorSwitch - Legt fest, welcher Übersetzer verwendet werden soll, um die Datenzeile in ein einheitliches CA Business Service Insight-Event zu übersetzen.
  • DefaultTranslator - Übersetzer, der zu verwenden ist, falls keine Kriterien übereinstimmen. Wenn der Wert "Ignorieren" ist, wird kein Übersetzer verwendet, und die Zeile wird ignoriert.
  • TranslatorCase - Gibt Kriterien für verarbeitete Daten an, um festzulegen, zu welchem Übersetzer sie weitergeleitet werden sollen.

    Break [yes|no]

    "yes" - (Standard) Wenn mit den Kriterien übereinstimmend, müssen keine weiteren Kriterien geprüft werden.

    "no" - Fahren Sie nach der Bewertung der Kriterien und der Ausführung des Übersetzers (bei Übereinstimmung) in jedem Fall mit den nächsten Kriterien fort.

    LogicOperator = (optional) [und/oder].

    • und - Alle Bedingungen müssen angepasst werden. (der Standard).
    • oder- Mindestens eine Bedingungen muss angepasst werden.

    TranslatorName - Der Übersetzer, zu dem geleitet wird, wenn die Bedingungen erfüllt werden.

    Condition - Die Bedingung, die für verarbeitete Daten geprüft werden muss, um den zu verwendenden Übersetzer zu bestimmen. Es ist die gleiche wie die Bedingung im InputFormatSwitch.