Eerst deze opmerking: Het is gewoonlijk niet nodig om gebruikers in bulk te importeren - om je onderhoudstaken te beperken, kun je beter eerst manieren verkennen die geen manueel onderhoud vragen, zoals connectie met externe databanken of gebruikers zelf accounts laten aanmaken. Meer over dit onderwerp in het authenticatiedeel van de beheermenu's.
Als je echt een reeks gebruikers wil importeren vanuit een tekstbestand, dan moeten je tekstbestanden als volgt opgemaakt worden:
Vereiste veldnamen: deze velden moeten in de eerste record staan en voor elke gebruiker bepaald zijn
firstname, lastname,
Optionele veldnamen: deze zijn optioneel - als ze niet bijgevoegd worden, dan worden de standaardwaarden gebruikt
institution, department, city, country, lang, auth, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop, deleted
Aanmeldingsvelden (optioneel): De course names zijn de "verkorte namen" van de cursussen - als ze opgegeven worden, dan zal de gebruiker aangemeld worden bij die cursussen. Groepnamen moeten geassocieerd worden met de overeenstemmende cursus, bv. group1 bij course1, enz.
code>course1, group1, type1, role1, course2, group2, type2, role2, etc.
Hier krijg je een voorbeeld van een geldig bestand om te importeren:
username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1
reznort, somesecret, Trent, Reznor, reznort@someplace.edu, en_us, 6736733, 0, Advanced202, Section 3, 3
De standaardwaarden worden verwerkt als sjablonen waarin volgende codes toegelaten zijn:
%l
- zal vervangen worden door de achternaam%f
- zal vervangen worden door de voornaam%u
- zal vervangen worden door de gebruikersnaam/li>
%%
- zal vervangen worden door de %Tussen het procent-teken (%) en de andere codeletters (l, f of u) zijn volgende operatoren toegelaten:
Bijvoorbeeld: als de voornaam John is en de achternaam is Doe, dat zullen volgende waarden verkregen worden met de verschillende sjablonen:
Het verwerken van sjablonen wordt alleen voor de standaardwaarden gedaan en niet voor de waarden die uit het CSV-bestand gehaald worden.
Om juiste Moodle gebruikersnamen te maken wordt de gebruikersnaam altijd naar kleine letters geconverteerd. Meer nog, als de "Uitgebreide tekenset in gebruikersnamen toestaan" optie op de site-reglementpagina is uitgeschakeld, dan zullen alle tekens die geen letters zijn, zoals cijfers, liggend streepje (-), en punt (.) verwijderd worden. Als de voornaam bijvoorbeeld John Jr. is en de achternaam Doe, dan zal username %-f_%-l john jr._doe produceren wanneer Uitgebreide tekenset in gebruikersnamen toestaan ingeschakeld is, en johnjr_doe wanneer uitgeschakeld.
Wanneer "Afhandeling van dubbele nieuwe gebruikersnamen" is ingesteld op Teller toevoegen, dan zal een opklimmend cijfer toegevoegd worden bij dubbele gebruikersnamen die het sjabloon produceerd. Bijvoorbeeld, als het CSV-bestand de gebruikers John Doe, Jane Doe and Jenny Doe bevat zonder gebruikersnamen, de standaard gebruikersnaam is ingesteld als %-1f%-l en de Afhandeling van dubbele nieuwe gebruikersnamen is ingesteld op teller toevoegen, dan zullen de geproduceerde gebruikersnamen jdoe, jdoe2 en jdoe3 zijn.
Standaard veronderstelt Moodle dat je nieuwe gebruikersaccounts wil aanmaken en zal records waarvan de gebruikersnaam overeenkomt met een bestaande account overslaan. Je kunt echter door de instelling "Update bestaande accounts" op Ja zet, dan zal de bestaande gebruikersaccount aangepast worden.
Bij het updaten van bestaande accounts, kun je gebruikersnamen ook aanpassen. Zet de instelling "Gebruikersnamen bijwerken toestaan" op Ja en geef in je bestand een veld me met als veldnaam oldusername
.
Opgelet: fouten tijdens het updaten van bestaande gebruikersaccounts, kan de gegevens van die accounts behoorlijk beschadigen. Wees voorzichtig met de updatefunctie.
Als het veld deleted
toegevoegd wordt, zullen gebruikers die daar een waarde 1 opgegeven kregen verwijderd worden. Hiervoor mag je alle velden weglaten, behalve het veld username
(dat in het CSV bestand moet zitten of je moet er een standaardwaarde voor opgeven.
Verwijderen en uploaden van accounts kan met een enkel CSV-bestand gedaan worden. Onderstaand bestand zal bijvoorbeeld de gebruiker Tom Jones toevoegen en de gebruiker reznort verwijderen:
username, firstname, lastname, deleted
jonest, Tom, Jones, 0
reznort, , , 1