Zum Hauptinhalt springen
Version: 4.1 (2026-H2)

ExistingListDataProvider

Mit dem ExistingListDataProvider können Benutzer auf ihre eigene Excel-Dateien zugreifen, ohne dass diese zentral erfasst und konfiguriert werden müssen. Die Auswahl der Excel-Datei erfolgt direkt über eine Dateiauswahl auf dem jeweiligen Gerät.

info

Für “verwaltete” CSV- oder Excel-Dateien, welche z.B. zentral hinterlegt sind, eignet sich der CsvDataProvider oder ExcelDataProvider besser.

Konfiguration​

Der ExistingListDataProvider kann in der Dokumentfunktion Forms optional mit einem Namen versehen werden (z.B. “Excel-Export aus CRM”), um die Erkennung für Benutzer zu erleichtern. Eine weitere Konfiguration ist nicht zwingend erforderlich.

<ExistingListDataProvider DisplayName="Excel Export aus CRM" 
 DefaultSheetName="Daten" EnableCustomSheetSelection="true" AutoAddAllEntries="true"
 SkipMappingIfComplete="true" />

Neben dem DisplayName können folgende optionale Attribute definiert werden. Diese steuern, wie die Excel-Datei beim Import verarbeitet wird und welche Auswahlmöglichkeiten dem Benutzer angezeigt werden:

  • DefaultSheetName: Name der vorausgewählten Arbeitsmappe der Excel-Datei. Ist kein Wert definiert, wird automatisch die erste Arbeitsmappe vorselektiert.
  • EnableCustomSheetSelection (true/false): Zeigt dem Benutzer ein Dropdown zur manuellen Auswahl der Arbeitsmappe an.
  • AutoAddAllEntries (true/false): Fügt automatisch alle Listeneinträge hinzu, sodass keine manuelle Auswahl durch den Benutzer erforderlich ist.
  • SkipMappingIfComplete (true/false): Überspringt den Mapping-Dialog, wenn alle Spalten der Excel-Datei mit dem konfigurierten Mapping übereinstimmen.