Version: 4.0 (2026 H1)

SQL

Konfiguration

Benutzerdaten aus einer SQL-Datenbank können über die SqlSyncSource synchronisiert werden. Die Verbindung wird über das ConnectionString-Element aufgebaut, welche auch verschlüsselt abgelegt werden kann.

Über das ConnectionProvider-Element werden folgende ADO.NET-Provider unterstützt. Die Benutzersynchronisierung läuft serverseitig; die dafür nötigen Provider-Bibliotheken werden mit dem Server ausgeliefert und beim Start von primedocs registriert — eine zusätzliche Installation ist nicht nötig:

System.Data.SqlClient — Microsoft SQL Server
MySqlConnector — MySQL/MariaDB (der ältere Name MySql.Data.MySqlClient wird als Alias weiterhin akzeptiert)
Oracle.ManagedDataAccess.Client — Oracle
System.Data.Odbc — generischer ODBC-Zugriff; hierfür muss auf dem Server zusätzlich ein passender ODBC-Treiber bzw. DSN für die Zieldatenbank vorhanden sein (Betriebssystem-Ebene)

Die Abfrage wird über das Query-Element definiert. Als Parameter wird der queryKey benötigt. Der Syntax im Query-Element muss dem SQL Datenbanksystem entsprechen:

Beispiel: MS SQL

SELECT FirstName, LastName FROM Users WHERE Email = @queryKey

info

Das Mapping wird ebenfalls unterstützt.

Konfiguration

<?xml version="1.0" encoding="utf-8"?>
<UserSyncConfig>
  <SqlSyncSource name="Sql" queryKey="primedocsIdentifier">
    <ConnectionString>Data Source=sqlserver.local;Initial Catalog=SampleData;User ID=user;Password=pw;Encrypt=False</ConnectionString>
    <ConnectionProvider>System.Data.SqlClient</ConnectionProvider>
    <Query>SELECT [givenname],[surname], [email] FROM [Table] WHERE UserId = @queryKey</Query>
    
    <!-- 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/givenname" ignoreClaimIfEmpty="true" property="givenname" />
      <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/surname" ignoreClaimIfEmpty="true" property="surname" />
      <Claim type="http://schema.oneoffixx.com/ws/2011/01/identity/claims/email" ignoreClaimIfEmpty="true" property="fromMappingEMail" />
    </Claims>
  </SqlSyncSource>
</UserSyncConfig>

Konfiguration​

Konfiguration