Benutzer importieren

Importieren Sie Benutzer gesammelt aus einer CSV-Datei, wenn Sie mehr als eine Handvoll auf einmal hinzufügen oder aktualisieren müssen. Jeder importierte Benutzer trägt das Quell-Tag csv, und durch erneutes Hochladen einer aktualisierten Datei bleiben die Benutzer synchron. Der CSV-Import eignet sich gut für erste Datenübernahmen und einmalige Aktualisierungen. Wenn Ihr HR-System die fortlaufende maßgebliche Quelle ist, verwenden Sie stattdessen die HR-Synchronisierung. Sie können auch von Ihnen definierte benutzerdefinierte Attribute als Spalten in die Datei aufnehmen. Wählen Sie unter Directory → Users den Pfeil neben + User und dann Import via CSV.

​

Dateianforderungen

​

Spalten

Der Importdialog listet jede Spalte auf, die Ihre Datei enthalten kann: erforderliche Kernspalten, optionale Kernspalten und alle Spalten für benutzerdefinierte Attribute aus Ihrem Schema. Verwenden Sie die Beispieldatei aus Download sample.csv als Vorlage für Ihre Kopfzeile. Wenn Ihre Spaltennamen mit dem Beispiel übereinstimmen, befüllen die Werte jeder Zeile die entsprechenden Profilfelder des durch externalId identifizierten Benutzers.

​

Erforderlich

Jede Zeile muss für jede dieser Spalten einen nicht leeren Wert enthalten.

​

Optional

Lassen Sie eine Zelle leer oder lassen Sie die Spalte ganz weg, wenn ein Wert nicht benötigt wird. Wenn domain leer ist, leitet Iru sie aus der E-Mail-Adresse ab.

​

Benutzerdefinierte Attribute

Nachdem Sie benutzerdefinierte Attribute in Ihrem Schema definiert haben, listet der Importdialog sie unter Custom attribute columns auf, benannt als categorySlug.attributeSlug aus dem Kategorie-Slug und dem Attribut-Slug. Beispielsweise erscheinen department und title in einer Kategorie mit dem Slug extrainfo als extrainfo.department und extrainfo.title. Fügen Sie Ihrer CSV-Kopfzeile eine Spalte pro Attribut hinzu. Die Namen der Kernspalten müssen exakt übereinstimmen; bei Spaltennamen für benutzerdefinierte Attribute werden Groß-/Kleinschreibung und Leerzeichen ignoriert.

​

Beispieldatei

Wählen Sie im Importdialog Download sample.csv, um eine Startdatei mit allen Kernspalten und einem Beispielbenutzer zu erhalten. Wenn Ihr Schema benutzerdefinierte Attribute enthält, wählen Sie den Pfeil neben Download sample.csv und dann With custom attributes. Diese Beispieldatei fügt für jedes benutzerdefinierte Attribut in Ihrem Schema eine Spalte hinzu und lässt diese Zellen in der Beispielzeile leer, damit Sie sie ausfüllen können. Die Kernspalten und der Beispielbenutzer bleiben gleich. Ersetzen Sie den Beispielbenutzer durch Ihre eigenen Zeilen und lassen Sie die Spaltennamen unverändert.

Anzeigen Varianten optionaler Spalten

Sie benötigen nicht jede optionale Spalte in jeder Zeile. Eine Zeile kann nur die erforderlichen Spalten, eine unvollständige Adresse oder eine Telefonnummer mit oder ohne Ländervorwahl enthalten. Lassen Sie domain leer, wenn sie der E-Mail-Adresse entsprechen soll, und lassen Sie Zellen für benutzerdefinierte Attribute leer, wenn Sie für einen Benutzer keinen Wert haben.

​

Verhalten der Felder

​

Ableitung der Domäne

• Wenn domain leer ist, übernimmt Iru sie aus der E-Mail-Adresse (jane.doe@example.com wird zu example.com).
• Wenn domain angegeben ist, wird dieser Wert unverändert verwendet.
• Eine noch nicht vorhandene Domäne wird automatisch erstellt.

​

Telefonnummern

Telefonnummern werden auf E.164 normalisiert (ein vorangestelltes +, Ländervorwahl, dann Ziffern, ohne Leerzeichen oder Satzzeichen), genauso wie Telefonnummern überall sonst in Iru Identity gespeichert werden.

​

Adressen

Iru speichert eine Adresse, sobald irgendeine Adressspalte einen Wert enthält. Eine unvollständige Adresse (zum Beispiel nur locality und country) ist in Ordnung; fehlende Teile bleiben leer. Wenn alle Adressspalten leer sind, wird keine Adresse gespeichert.

​

Import ausführen

Der Dialog Import users via CSV zeigt die erforderlichen und optionalen Kernspalten, alle Spalten für benutzerdefinierte Attribute aus Ihrem Schema sowie Download sample.csv mit einem Pfeil für With custom attributes. Ziehen Sie eine Datei in den Upload-Bereich oder durchsuchen Sie Ihre Dateien, um eine auszuwählen. Nach dem Hochladen validiert Iru die gesamte Datei. Wenn die Validierung fehlschlägt, wird nichts importiert. Beheben Sie die gemeldeten Probleme und laden Sie die Datei erneut hoch. Wenn die Validierung erfolgreich ist, werden die Zeilen akzeptiert und bereitgestellt, und Benutzer werden im Hintergrund erstellt oder aktualisiert. Prüfen Sie den Import in Ihrem Verlauf, um jede Zeile zu bestätigen. Eine Zeile kann auch nach dem Akzeptieren der Datei beim Anwenden noch fehlschlagen; korrigieren Sie diese Zeilen und importieren Sie sie erneut. Die zwei Prüfphasen sind unter Validierung und Fehler beschrieben.

​

Erstellen vs. Aktualisieren: erneutes Hochladen

Benutzer werden innerhalb der Quelle csv anhand von externalId abgeglichen:

• Eine neue externalId erstellt einen neuen Benutzer mit der Rolle end-user.
• Eine vorhandene externalId aktualisiert das Profil dieses Benutzers anhand der Zeile. Rolle und Gruppenmitgliedschaften ändern sich nicht.

Laden Sie jederzeit eine korrigierte oder erweiterte CSV-Datei erneut hoch, um importierte Benutzer synchron zu halten. Jede externalId in einer Datei muss eindeutig sein.

​

Validierung und Fehler

Die Validierung erfolgt in zwei Phasen. Bis die Datei vollständig akzeptiert ist, wird nichts importiert.

​

Wann die HR-Synchronisierung sinnvoller ist

Laden Sie eine CSV-Datei erneut hoch, wann immer sich Ihre Liste ändert, und Iru prüft jede Zeile erneut. Für eine kontinuierliche, wartungsfreie Bereitstellung verbinden Sie stattdessen Ihr HR-System als maßgeblichen Datensatz.

​

Nächste Schritte