Import, Export und Sammeländerungen
Diese Befehle arbeiten mit vielen Konten auf einmal. Jeder wählt Konten mit den Filtern von exp:user:list aus
(--state, --group, --search, --days).
Was Sie am Ende haben
Eine Datei mit Konten, Konten aus einer Datei angelegt, oder eine Änderung an vielen Konten.
Konten exportieren
./console exp:user:export --output=var/tmp/editors.csv --group=Editors
./console exp:user:export --type=json --state=inactive --days=365 > var/tmp/inactive.json--type ist csv (Vorgabe) oder json. Ohne --output geht die Datei auf die Standardausgabe.
Jedes Konto hat diese Felder: id, login, email, first_name, last_name, name, enabled, states, groups
(Knoten-IDs, getrennt durch |), main_group, last_visit, login_count. Ein Export enthält nie ein Passwort oder
einen Passwort-Hash.
Datenschutz: Die Datei enthält personenbezogene Daten: Namen und E-Mail-Adressen. Bewahren Sie sie dort auf, wo nur die Personen sie lesen können, die sie brauchen, und entfernen Sie sie, wenn die Arbeit erledigt ist.
Konten importieren
Die Datei ist CSV oder JSON. Eine CSV-Datei beginnt mit dieser Kopfzeile:
login,email,first_name,last_name,groups
jdoe,[email protected],Jane,Doe,Members
rroe,[email protected],Richard,Roe,Members|1234Eine JSON-Datei ist ein Array von Objekten mit denselben Schlüsseln. groups enthält Knoten-IDs oder Namen, getrennt
durch |.
./console exp:user:import var/tmp/members.csv --send-activation
./console exp:user:import var/tmp/members.csv --send-activation --apply
./console exp:user:import var/tmp/staff.json --type=json --disabled --group=Editors --apply- Wählen Sie genau eines von
--send-activationund--disabled.--send-activation: jede Person erhält die Aktivierungsmail und wählt dann mit Passwort vergessen ein Passwort.--disabled: die Konten werden deaktiviert angelegt; Sie setzen ihre Passwörter später zurück.
- Zeilen ohne Gruppen kommen in
--group(für weitere Gruppen wiederholen), standardmäßig in[UserSettings] DefaultUserPlacement. - Ein Anmeldename, den es schon gibt, wird übersprungen und aufgelistet.
- Eine Datei mit irgendeiner Passwortspalte wird verweigert.
- Jedes Konto wird genau wie mit
exp:user:createangelegt: mit seinen Prüfungen, Workflows und Audit-Ereignissen.
Der Probelauf prüft jede Zeile und listet auf, was angelegt würde. Jede Zeile hat ein Ergebnis: would_create im
Probelauf, created mit --apply, oder skipped oder refused mit den Gründen.
Die Aufgabe Schritt für Schritt: Mitglieder aus einer CSV-Datei importieren.
Sammeländerungen
./console exp:user:bulk disable --state=inactive --days=730
./console exp:user:bulk disable --state=inactive --days=730 --confirm=42 --applyDie Aktionen sind disable, enable, delete, approve, reject und unlock. Sie gelten für die Konten, die die
Filter auswählen, höchstens --limit (Vorgabe 500, höchstens 5000).
- Führen Sie den Befehl ohne
--applyaus. Der Probelauf listet die Konten und ihre Anzahl auf. - Prüfen Sie die Liste.
- Führen Sie den Befehl erneut mit
--applyund--confirm=<die Anzahl>aus. Die Zahl muss mit dem übereinstimmen, was die Filter in diesem Moment auswählen. Stimmt sie nicht, ändert sich nichts.
Geschützte Konten und der letzte Administrator werden übersprungen und aufgelistet, nie geändert. Jedes Konto wird so geändert, wie es der einzelne Befehl ändern würde, mit seinem eigenen Audit-Ereignis.
Achtung: delete und reject entfernen Konten endgültig. Exportieren Sie die Konten vorher, und nehmen Sie
lieber disable.
Verwandte Seiten
- Einen Rückstau von Registrierungen freigeben:
bulk approveundbulk reject. - Audit und Kontenpflege: die Konten finden, die eine Sammeländerung auswählen soll.
- JSON-Ausgabe von exp:user: die Schlüssel von
export,importundbulk.