CsvDataProvider

---

Über die CsvData-Datenschnittstelle kann auf .csv-Dateien zugegriffen werden.

Konfiguration

Neben der Mapping-Konfiguration und den optionalen SearchParameters (siehe Datenschnittstelle) kann der CsvDataProvider im Options-Element noch weiter konfiguriert werden:

<CsvDataProvider DisplayName="Kundenadressen">
  <Options>
    <FilePath>\\fileshare\addressdata.csv</FilePath>
    <HasHeaders>true</HasHeaders>
    <Delimiter>,</Delimiter>
  </Options>
    ...
</CsvDataProvider>

Inhalte für Options in CsvDataProvider

Elementname	Beschreibung
FilePath	string, Pfad zur CSV Datei
HasHeaders	bool, Angabe, ob die erste Zeile eine Kopfzeile ist Wenn keine Header vorhanden sind, werden die Spalten nummeriert (0, 1, …) (wichtig für SearchParameters und Mapping). Mit Kopfzeile erhält eine leere Überschrift den 0-basierten Spaltenindex (z.B. 1 für die zweite Spalte) und eine doppelte einen Zähler, z.B. Name (2). SearchParameters und Mapping verwenden diese Namen. Fehlende Werte am Ende einer Zeile sind mit Kopfzeile leer, überzählige Werte werden ignoriert.
Delimiter	string, Angabe des Trennzeichens

Suche und Dateizugriff

• Suche: Die Id eines SearchParameter wird auf den Spaltennamen (bei Kopfzeile) bzw. den 0-basierten Spaltenindex (ohne Kopfzeile) abgebildet. Der Vergleich erfolgt als Teilstring (enthält) und ist nicht gross-/kleinschreibungssensitiv. Leere Suchparameter werden ignoriert. Mehrere Suchparameter sind UND-verknüpft.
• Dateizugriff: Der FilePath wird serverseitig (auf dem Server, der die Datenschnittstelle ausführt) aufgelöst und geöffnet. Es wird ein absoluter Pfad oder ein UNC-Pfad erwartet. Die Datei muss für den Serverprozess erreichbar sein. Sie wird nur gelesen und darf dabei in Excel geöffnet sein.

Beispiel-XML-Konfiguration

<CsvDataProvider DisplayName="Kundenadressen">
  <Options>
    <FilePath>\\fileshare\addressdata.csv</FilePath>
    <HasHeaders>true</HasHeaders>
    <Delimiter>,</Delimiter>
  </Options>
  <SearchParameters>
    <Text Id="Firma" Label="Firmenname" />
    <Text Id="Ort" Label="Ort" />
  </SearchParameters>
  <Mapping>
    <Map Source="Firma" Target="CompanyName" />
    <Map Source="Strasse" Target="Street" />
    <Map Source="PLZ" Target="PostalCode" />
    <Map Source="Ort" Target="City" />
    <Map Source="Land" Target="Country" />
  </Mapping>
</CsvDataProvider>