ExcelDataProvider

---

Über die ExcelData-Schnittstelle kann auf Excel-Dateien zugegriffen werden.

Konfiguration

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

<ExcelDataProvider DisplayName="Kundenadressen">
  <Options>
    <FilePath>\\fileshare\addressdata.xlsx</FilePath>
    <HasHeaders>true</HasHeaders>
    <SheetName>Data</SheetName>
  </Options>
    ...
</ExcelDataProvider>

Inhalte für Options in ExcelDataProvider

Elementname	Beschreibung
FilePath	string, Pfad zur XLSX Datei
HasHeaders	bool, Angabe ob die erste Zeile eine Kopfzeile ist Wenn keine Header vorhanden sind, werden die Spalten wie in Excel hochgezählt (A, B, …) (wichtig für SearchParameters und Mapping). Mit Kopfzeile erhält eine leere Überschrift den Spaltenbuchstaben und eine doppelte einen Zähler, z.B. Name (2). SearchParameters und Mapping verwenden diese Namen, siehe Leere und doppelte Überschriften.
SheetName	string, Name des Tabellenblatts. Ist kein Wert angegeben oder wird das Tabellenblatt nicht gefunden, wird das erste Tabellenblatt verwendet.

Suche und Dateizugriff

• Suche: Die Id eines SearchParameter wird auf den Spaltennamen (bei Kopfzeile) bzw. den Spaltenbuchstaben (A, B, … 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

<ExcelDataProvider DisplayName="Kundenadressen">
  <Options>
    <FilePath>\\fileshare\addressdata.xlsx</FilePath>
    <HasHeaders>true</HasHeaders>
    <SheetName>Data</SheetName>
  </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>
</ExcelDataProvider>