Zum Hauptinhalt springen
Version: 4.1 (2026 H2)

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​

ElementnameBeschreibung
FilePathstring, Pfad zur XLSX Datei
HasHeadersbool, 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).
SheetNamestring, 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.

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>