CSV-Nutzer-Import | Scheer IMC - Customer Documentation (DE)

Dieser Artikel dient als Hilfestellung bei Problemen mit dem Import von Nutzerdaten über CSV-Dateien.

1. Dateiformat prüfen

Problem	Symptom	Lösung	Systempfad
Falsches Trennzeichen	Alle Werte erscheinen in einer einzigen Spalte, bestimmte Werte werden nicht übertragen, Spalten werden nicht befüllt.	Richtiges Trennzeichen verwenden (`;` oder `,`). In Excel: „CSV (Trennzeichen-getrennt)“ speichern.	Importspezifische Konfiguration: Funktion Nutzerimport-Planung → Tab Beschreibung
Falsche Zeichenkodierung	Umlaute/Sonderzeichen werden fehlerhaft dargestellt (z. B. Ã¼ statt ü)	Datei als UTF-8 ohne BOM speichern. In Notepad++: Menü Kodierung → Option In UTF-8 konvertieren	Globale System-Konfiguration: Funktion Konfiguration → Menü Import → Tab Beschreibung

Problem

Symptom

Lösung

Systempfad

Falsches Trennzeichen

Alle Werte erscheinen in einer einzigen Spalte, bestimmte Werte werden nicht übertragen, Spalten werden nicht befüllt.

Richtiges Trennzeichen verwenden (; oder ,).
In Excel: „CSV (Trennzeichen-getrennt)“ speichern.

Importspezifische Konfiguration:

Funktion Nutzerimport-Planung → Tab Beschreibung

Falsche Zeichenkodierung

Umlaute/Sonderzeichen werden fehlerhaft dargestellt (z. B. Ã¼ statt ü)

Datei als UTF-8 ohne BOM speichern.
In Notepad++: Menü Kodierung → Option In UTF-8 konvertieren

Globale System-Konfiguration:

Funktion Konfiguration → Menü Import → Tab Beschreibung

2. Spalten und Header überprüfen

Pflichtfelder müssen vorhanden und korrekt geschrieben sein (z. B. LOGIN, EMAIL,... ).

Das Mapping der Spalten wird unter Attribut-Mapping im Tab Beschreibung der Funktion Nutzerimport-Planung definiert.

sourceField = Spaltenname
clixField = LMS Nutzerattribut

<attributeMapping isReference="false" ignoreUnmappedFields="true">
	<mapping sourceField="E-Mail-Adresse" clixField="LOGIN"/>
	<mapping sourceField="E-Mail-Adresse" clixField="EMAIL"/>
	<mapping sourceField="Nachname" clixField="LASTNAME"/>
	<mapping sourceField="Vorname" clixField="FIRSTNAME"/>
</attributeMapping>

Wenn Sie für ein bestimmtes Attribut leere Werte übertragen möchten, können Sie dies im Mapping mithilfe des optionalen Parameters ignoreEmptyField festlegen, indem Sie den Wert wie unten gezeigt auf false setzen – diese attributspezifische Option überschreibt einen bereits vorhandenen Wert des Nutzerattributs durch einen leeren Wert aus der Importdatei. Die Einstellung wirkt sich nur auf das jeweilige Attribut aus, für das sie verwendet wird.
```
 <mapping sourceField="DIVISION" clixField="UNIT" ignoreEmptyField="false"/>
```
Keine leeren Pflichtfelder

3. Datenvalidierung durchführen

Problem	Symptom	Lösung
Ungültige E-Mail-Adressen	Import-Fehler	E-Mail-Format prüfen (`^[^\s@]+@[^\s@]+\.[^\s@]+$`)
Dubletten	Mehrfache Nutzer	Doppelte Einträge entfernen
Sonderzeichen in Nutzernamen	Import verweigert	Erlaubte Zeichen prüfen (nur Buchstaben, Zahlen, `_`, `-`)

Relevante Fehlercodes und deren Bedeutung:

ID	Identifikator	Kommentar
PRS0001	LOGIN_AUTHENTICATION_LOCKED_USER	Benutzer ist durch Authentifizierungsmechanismus als passiv gekennzeichnet
PRS0002	LOGIN_AUTHENTICATION_MISSING_IDENTIFICATION	Benutzername und Kennwort fehlen für Authentifizierung
PRS0003	LOGIN_AUTHENTICATION_NO_MODULE	Kein weiteres Modul in Sequenz vorhanden; Benutzer nicht authentifiziert
PRS0004	LOGIN_AUTHENTICATION_UNKNOWN_MODULEIDENTIFIER	Identifier für Authentifizierungsmodul stimmt mit keinem registrierten Authentifizierungsmodul überein
PRS0005	LOGIN_AUTHENTICATION_MODULECAST	Casting Exception bei Instanzierung eines Authentifizierungmoduls; fehlerhafte Angabe von classname
PRS0006	LOGIN_FAILED_CONNECTION	Allgemeiner Verbindungsfehler zu Authentifizierungs- oder Profildatenquelle
PRS0010	LOGIN_REGISTRATION_MISSING_REQUIRED_PROFILE_ATTRIBUTES	Nicht alle Pflichprofildaten bei Registrierung vorhanden
PRS0011	LOGIN_REGISTRATION_EXCEEDED_LICENCE	Überschreitung der erlaubten Lizenzen
PRS0033	LOGIN_REGISTRATION_LOGINNAME_UNKNOWN_TEMPLATEKEY	In Template von LoginName wird ein Key ungleich L,F,N verwendet
PRS0038	LOGIN_AUTHENTICATION_NO_UNIQUE_IDENTIFICATION	Es gibt mehrere Benutzer mit dem gleichen Login oder der gleichen Login / Passwort-Kombination
PRS0048	LOGIN_REGISTRATION_LOGINCOMPLEXITY_INSUFFICIENT_LENGTH	Login ist zu kurz
PRS0057	LOGIN_PASSWORDCOMPLEXITY_NOT_ALLOWED_SYMBOL	Passwort enthält ungültige Zeichen; erlaubte Sonderzeichen: !#$%&()*+,- ./:;<= >?@[\]_{}§
PRS0063	LOGIN_REGISTRATION_LOGIN_MISSING_LOGIN	Kein Loginnamen vorhanden
PRS0064	LOGIN_REGISTRATION_LOGIN_INVALID_CHAR	Loginname bei fehlendem Template enthält ungültige Zeichen. Erlaubte Sonderzeichen: . _.
PRS0067	LOGIN_REGISTRATION_CSV_FILE_NOT_FOUND	CSV-Datei nicht gefunden
PRS0068	LOGIN_REGISTRATION_CSV_IO_EXCEPTION	Fehler bei Zugriff auf CSV-Datei
PRS0069	LOGIN_REGISTRATION_CSV_INVALID_NUMBER_OF_RECORDFIELDS	Anzahl der Spalten in einer Zeile stimmt nicht mit Titelzeile überein
PRS0070	LOGIN_REGISTRATION_CSV_NO_COLUMNDEFINITION	Werte in erster Zeile konnten nicht über Parametermapping identifiziert werden
PRS0071	LOGIN_REGISTRATION_CSV_NO_IDENTIFER	Person-Identifier fehlt in Spaltendefinition
PRS0072	LOGIN_REGISTRATION_CSV_PERSON_NOT_FOUND	Profil der gesuchten Person wurde nicht in CSV-Datei gefunden
PRS0073	LOGIN_REGISTRATION_CSV_UNIQUE_KEY_VIOLATION	Identifier der gesuchten Person ist in CSV-Datei mehrfach vorhanden
PRS0074	LOGIN_REGISTRATION_CSV_MISSING_IDENTIFIER	Identifier bei einem Eintrag in der CSV fehlt
PRS0098	LOGIN_AUTHENTIFICATION_DENY_OF_SERVICE	Benutzer für Login gesperrt. Anzahl der Fehlversuche war zu gross.
PRS0099	LOGIN_AUTHENTICATION_NO_SELFREGISTRATION	Authentifizierter Benutzer kann sich wegen conifg-Einstellungen nicht selbst registrieren.
PRS0100	LOGIN_REGISTRATION_NO_IMPORTSOURCE	Keine ProfileDataSource bei Benutzerimport in config hat isImportSource=true
PRS0101	LOGIN_REGISTRATION_PROFILEDATASOURCE_MODULEIDENTIFIERID	Id für Profildatenquelle stimmt mit keiner registrierten Profildatenquelle überein
PRS0102	LOGIN_REGISTRATION_RULES_CONFIG_FILETYPE	Dateityp für Rules-Config-Upload bei Benutzerimport ungültig
PRS0104	LOGIN_REGISTRATION_CSV_CONFIG_FILETYPE	Dateityp für CSV-Config-Upload bei Benutzerimport ungültig
PRS0105	LOGIN_REGISTRATION_CONTENT_FILETYPE	Dateityp für CSV-Upload bei Benutzerimport ungültig
PRS0107	LOGIN_REGISTRATION_INVALID_CSV	Upgeloadete Datei enthält keine gültigen CSV
PRS0109	LOGIN_REGISTRATION_UNKNOWN_CLIXFIELD	ClixField in AttributeMapping ist kein gültiges Personenattribut
PRS0116	LOGIN_REGISTRATION_EXCEEDED_ACTIVE_LICENSES	Keine Lizenzen mehr vorhanden
PRS0117	LOGIN_AUTHENTICATION_UNKNOWN_MODULEID	Id für Authentifizierungsmodul stimmt mit keinem registrierten Authentifizierungsmodul überein
PRS0118	LOGIN_AUTHENTICATION_INVALID_USERMODE	AuthmodeId ist identisch mit Id von Modul User
PRS0119	LOGIN_REGISTRATION_PROFILEDATASOURCE_PROFILEIDENTIFIER	Identifier für Profildatenquelle stimmt mit keiner registrierten Profildatenquelle überein
PRS0124	LOGIN_REGISTRATION_CSV_DUPLICATE_COLUMN	Bezeichner einer Spaltendefinition kommt in CSV-Datei mehrfach vor
PRS0127	LOGIN_REGISTRATION_MISSING_SOURCEFIELD	In Attributemapping vorkommendes Sourcefield ist nicht in Importquelle vorhanden
PRS0128	LOGIN_REGISTRATION_INVALID_CLIENTID	Die Id des Stamm-Mandanten kommt nicht in der Liste der zugeordneten Mandanten vor
PRS0131	LOGIN_REGISTRATION_INVALID_PERSONIDENTIFIER	Einer der in der config angegebenen PersonIdentifier entspricht keinem Person-DB-Feld
PRS0132	LOGIN_REGISTRATION_IDENTIFICATION_FAILED_CLIX_UNIQUENESS	Useridentification bei angegebenen PersonIdentifier und Suchkriterien innerhalb CLIX nicht eindeutig
PRS0134	LOGIN_REGISTRATION_EMPTY_LOGIN	Das Login einer abzuspeichernden Person ist leer und zugehöriger Logingenerator ist disabled
PRS0137	LOGIN_CONFIGURATION_NO_PERSONIDENTIFIER	In der Profildatenquelle der abzuspeichernden Person sind keine PersonIdentifier vorhanden
PRS0138	LOGIN_REGISTRATION_MISSING_PERSONIDENTIFIER	Der abzuspeichernden Person fehlen profildatenabhängige PersonIdentifier-Attribute
PRS0139	LOGIN_REGISTRATION_UPDATEONLY_RESTRICTION	Neue Person kann nicht angelegt werden, da gemäss Configuration für diese Profildatenquelle und Context nur bestehende aktualisiert werden können
PRS0140	LOGIN_REGISTRATION_INSERTONLY_RESTRICTION	Bestehende Person kann nicht abgespeichert werden, da gemäss Konfiguration für diese Profildatenquelle und Context nur neue Personen angelegt werden können
PRS0144	LOGIN_REGISTRATION_COULD_NOT_STORE_PERSON_WITHOUT_ID	Interner Porgammfehler: Speichern einer Person ohne person_id nicht möglich
PRS0145	LOGIN_LDAP_LOGINNAME_FAILED_UNIQUENESS	Zu authentifizierender Loginname ist am LDAP-System nicht eindeutig
PRS0146	LOGIN_CONFIGURATION_INVALID_IMPORTRESTRICTIONS	Die ImportRestrictions sind in der Config-Datei nicht eindeutig eingestellt
PRS0147	LOGIN_REGISTRATION_INVALID_EMAILADDRESS	Syntax der Emailadresse ist ungültig
PRS0148	LOGIN_REGISTRATION_UNIQUEIDGENERATION_FAILED	UniqueIdGenerierung für Personen ist fehlgeschlagen
PRS0149	LOGIN_READ_DEFAULT_VALUES_FAILED	Fehler bei der Initialisierung der Default-Values für Personen
PRS0150	LOGIN_READ_REQUIRED_FIELDS_FAILED	Fehler bei der Initialisierung der Pflichtattribute für Personen
PRS0151	LOGIN_REGISTRATION_NO_UNIQUE_IDENTIFIER	Identifikatorattribute der aktuellen Datenquelle sind nicht eindeutig
PRS0152	LOGIN_AUTHENTICATION_CUSTOM_AUTHIMPL_FAILURE	Unerwarteter Fehler innerhalb einer kundenspezifischen AuthenticationModuleImplementierung
PRS0153	LOGIN_REGISTRATION_LDAP_MISSING_IDENTIFIER	Ein für die Identifizierung per LDAP benötiges Attribut ist im Attribute-Mapping nicht enthalten
PRS0154	LOGIN_REGISTRATION_LDAP_EMPTY_IDENTIFER	Ein für die Profildatenquelle LDAP benötiges Attribut im Mapping ist leer
PRS0155	LOGIN_REGISTRATION_RESOURCE_SYNCRONIZATION_FAILURE	Beim Synchronisierungsversuch der gemappten Resourceperson ist ein Fehler aufgetreten
PRS0156	LOGIN_REGISTRATION_USERID_FAILED_UNIQUENESS	Die User ID der zu speichernden Person ist nicht eindeutig
PRS0159	LOGIN_MULTIPLE_RULES_VALID	Mehrere Regeln gültig
PRS0181	LOGIN_PERSON_MAP_ATTRIBUTE_VALUE	Fehler beim Zuordnen des Wertes eines externen Attributes zu einem CLIX Attribut
PRS0187	LOGIN_NAME_MAPPING_IMPLCAST	Implementierung für LoginNameMapping kann nicht instanziert werden
PRS0188	LOGIN_NAME_MAPPING_EMPTY_NAME	Implementierung fuer LoginNameMapping liefert NULL oder Leerstring zurück
PRS0189	LOGIN_NAME_MAPPING_GENERAL_EXCEPTION	Allgemeiner Fehler zur Verwendung in Implementierung für LoginNameMapping
PRS0190	LOGIN_NAME_MAPPING_TECHNICAL_PROBLEM	Technischer Fehler von externem System, zur Verwendung in Implementierung für LoginNameMapping Interface
PRS0191	LOGIN_NAME_MAPPING_TECHNICAL_PROBLEM_LEARNBASE	Technischer Fehler von externem System Fehlertext für Learnbase, zur Verwendung in Implementierung fuer LoginNameMapping Interface
PRS0193	LOGIN_SECURITY_QUESTION_ANSWER	Es ist keine Antwort zu Sicherheitsfrage angegeben
PRS0201	LOGIN_NO_CLIENT_ID_CHANGE_ALLOWED	Für einen bestehenden Benutzer wurde versucht, den client_id-Wert zu ändern
PRS0202	LOGIN_INVALID_DATE_FORMAT	Ein Datumsfeld hat ein falsches Format
PRS0203	LOGIN_REGISTRATION_MAPPING_MISSING_FILE	Die definierte Attribut-Mapping-Datei ist nicht verfügbar
PRS0204	LOGIN_REGISTRATION_MAPPING_WRONG_FILE	Die definierte Attribut-Mapping-Datei hat keinen gültigen Inhalt
PRS0205	LOGIN_REGISTRATION_LOGINCOMPLEXITY_MISSING_MAIL	E-Mail fehlt beim Anmeldenamen
PRS0206	LOGIN_REGISTRATION_INVALID_DATE_VALUE	Ein Datum hat kein gültiges Zeitstempelformat
PRS0207	LOGIN_REGISTRATION_INVALID_COSTCENTER_VALUE	Der definierte Wert für costcenter_id ist im System nicht vorhanden
PRS0208	LOGIN_REGISTRATION_INVALID_USERTYPE_VALUE	Die angegebene type_id wird vom System nicht unterstützt
PRS0209	LOGIN_REGISTRATION_INVALID_NUMBER_VALUE	Der angegebene Wert muss eine positive ganze Zahl sein
PRS0210	LOGIN_REGISTRATION_INVALID_BOOLEAN_VALUE	Der angegebene Wert ist für diesen Feldtyp nicht gültig
PRS0211	LOGIN_REGISTRATION_INVALID_SELECT_VALUE	Die angegebene select id ist nicht im System vorhanden
PRS0212	LOGIN_REGISTRATION_INVALID_ATTRIBUTE_LENGTH	Der angegebene Wert ist zu lang für dieses Feld
PRS0213	LOGIN_REGISTRATION_UNIMPORTABLE_CLIXFIELD	Das Import-Mapping enthält Attribute, die durch den Import nicht verändert werden dürfen
PRS0214	LOGIN_USER_MARKED_AS_DELETED	Der Benutzer ist bereits zur Löschung vorgemerkt
PRS0306	LOGIN_REGISTRATION_PHONENUMBER_INVALID	Syntax der Telefonnummer ist ungültig
PRS0307	LOGIN_REGISTRATION_PHONENUMBER_MISSING_CODE	Landvorwahl fehlt
PRS0308	LOGIN_REGISTRATION_PHONENUMBER_UNKNOWN_CODE	Landvorwahl fehlt
PRS0402	LOGIN_EXTERNAL_REGISTRATION_NEEDED	Ausnahme, wenn ein Benutzer eine Selbstregistrierung aus externen Daten durchführen muss
PRS403	LOGIN_AUTHENTIFICATION_NO_N_TIMES_NEW_PASSWORD	Exception, wenn ein Benutzer das Passwort in einen Wert ändert, den es bereits innerhalb der letzten n Änderungen (definiert im Mandanten) hatte
PRS404	LOGIN_AUTHENTIFICATION_ERROR_ON_LOADING_PASSWORD_HISTORY	Exception, wenn beim Lesen des Passwortverlaufs ein Fehler auftritt
PRS410	LOGIN_FIRSTNAME_INVALID_CHAR	Das Attribut „Vorname“ enthält ungültige Zeichen
PRS411	LOGIN_LASTNAME_INVALID_CHAR	Das Attribut „Nachname“ enthält ungültige Zeichen

Best Practices

Immer UTF-8 ohne BOM nutzen
Header exakt so schreiben, wie im System erwartet
Vor Import: Dubletten, Sonderzeichen und Leerzeichen bereinigen