===== Generische Konfiguration für Kunden- und KonfigurationItemimport =====

==== Konfiguration des CSV-PreProcessors ====

In 5.5.1.0 wurde der Präprozessor umgebaut. Firmen- und Ansprechpartnerdaten sind ab dieser Version in __einer__ .csv-Datei und der Benutzer kann außerdem CustomAttributes importieren. \\

Beispieldateien: 
  * {{:standardimport:import.txt|import.csv}} CSV-Datei. 
  * {{:standardimport:template.xml|}} Template-XML, die das XML-Format definiert, in die die .csv-Datei umgewandelt werden soll. 
\\
Beispielkonfiguration: 

<code xml>
<preProcessorSettings encoding="UTF-8" key="default" delimiter=";" sourceDirectory="ConfigurationItemImport\preProcessDir" fileMask="*.csv" templateFilePath="ConfigurationItemImport\format.xml" useHeaders="true" quote="QuotationMark" />
</code>

**encoding:** Das Encoding der csv-Datei. Kann z.B. "Unicode" oder "UTF-8" sein. [[Import Encpdings]]\\
**delimiter:** Das Trennzeichen zwischen den Spalten \\
**sourceDirectory:** Das Verzeichnis in dem die CSV-Dateien liegen \\
**fileMask:** Filterfunktion, welche CSV-Dateien importiert werden sollen. \\
**templateFilePath:** Die Vorlage-XML-Datei \\
**useHeaders:** Legt fest, ob die Spaltenüberschriften aus der CSV-Datei benutzt werden. Ist es deaktiviert, werden folgende Spaltenüberschriften benutzt: column1, column2, columnN, ...\\
**quote:** (5.5.17.0+) Steuert die Zeichen, welches das Feld im CSV begrenten (vor bzw. nach dem Trennzeichen). Folgende Werte sind möglich: 
^quote^Beispiele^Standardwert^
|NoQuotationMark|foo;bar;foo;bar oder foo;"ba"r;f"o"o;bar| |
|QuotationMark|"foo";"bar";"foo";"bar"|x|
|SingleQuotationMark|'foo';'bar';'foo';'bar'| |
==== Mapping von Feldern beim XML-Import (Kunden- und ConfigurationItemImport) ====

Die Werte von beliebigen Feldern können beim Import einer XML-Datei vor dem Speichern verändert werden.

=== Konfiguration ===

Die Konfiguration des Mappings ist über die Datenbanktabelle "tbImportMapping" möglich. Diese hat folgenden Aufbau:

^Feld^Funktion^
|importName|Der Name des Imports, zu dem das Mapping gehört. z.B. "CustomerImport" oder "ConfigurationItemImport"|
|fieldName|Der Name des Feldes, das verändert werden soll. (siehe unten)|
|currentValue|Der Wert des Feldes, der aktuell zugewiesen ist und ersetzt werden soll.|
|nextValue|Der Wert, den das Feld zukünftig haben wird.|

== Aufbau der FieldNames ==

Der "fieldName" ist jeweils analog der XML-Struktur aufgebaut.\\
Ausnahme: Der XML-Knoten "contactperson" heißt beim Mapping "CustomerContactPerson".

Beispiele beim CustomerImport:
  CustomerContactPerson.attributes.test
  CustomerContactPerson.name
  status
  
Beispiele beim ConfigurationItemImport:
  customerConfigurationItemInfo.field