CSV

---

Benutzerdaten aus einer CSV-Datei können über die CsvSyncSource gelesen werden.

Hierbei ist es erforderlich, dass die CSV-Datei "Header" besitzt und dass es eine Spalte gibt, welche eindeutige Werte für die Benutzersynchronisation bereitstellt.

Hinweis: Das Mapping wird ebenfalls unterstützt.

---

Konfiguration

<?xml version="1.0" encoding="utf-8"?>
<UserSyncConfig>
  <CsvSyncSource name="Csv" queryKey="primedocsIdentifier">
    <FilePath>\\Share\Users.csv</FilePath>
    <Delimiter>;</Delimiter>
    
    <!-- Column name for user lookup -->
    <KeyColumnName>sid</KeyColumnName>
    
    <!-- Optional: Prevents "stale" data to be synchronized -->
    <TreatFileAsStaleAfterHours>24</TreatFileAsStaleAfterHours>
    
    <!-- Optional: Result Mapping Syntax is supported -->
    <ResultMapping>
      <Mapping>
        <Map Source="email" Target="fromMappingEMail" />
      </Mapping>
    </ResultMapping>
    
    <!-- Claim Mapping - column names are property names-->
    <Claims>
      <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/displayName" ignoreClaimIfEmpty="true" property="displayName" />
      <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/email" ignoreClaimIfEmpty="true" property="fromMappingEMail" />
    </Claims>
    
  </CsvSyncSource>
</UserSyncConfig>

Optionen

Neben den gemeinsamen SyncSource-Attributen (name, queryKey, …) stehen folgende Elemente zur Verfügung:

Element	Erforderlich	Beschreibung
FilePath	ja	Pfad zur CSV-Datei (z. B. eine Netzwerkfreigabe).
Delimiter	ja	Trennzeichen zwischen den Spalten (z. B. ;).
KeyColumnName	ja	Name der Spalte, über die der Benutzer nachgeschlagen wird.
TreatFileAsStaleAfterHours	nein	Verhindert die Synchronisierung veralteter Daten: Ist die Datei älter als die angegebene Stundenzahl, wird sie nicht verwendet.
ResultMapping	nein	Optionales Mapping der Spalten auf Zielwerte.