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,
wanneer ingevoegd wordt ofusername
wanneer bestaande accounts aangepast wordenOptionele veldnamen: deze zijn optioneel - als er voor een veld geen waarde is, wordt de standaardwaarde gebruikt
institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe, emailstop
Aangepaste veldnamen in het profiel: optioneel, xxxxx is de echte aangepaste profiel veldnaam (de unieke korte naam)
profile_field_xxxxx
Speciale veldnamen: gebruikt voor het wijzigen van gebruikersnamen en voor het verwijderen van gebruikers, zie verder
deleted, oldusername
Aanmeldingsveldnamen (optioneel): De cursusnamen zijn de "verkorte namen" van de cursussen. Indien opgegeven zal de gebruiker aangemeld worden in de cursus. "Type" betekent de rol die de gebruiker zal krijgen in die cursus na zijn aanmelding. Waarde 1 is de standaard cursus rol, 2 is de standaard leraar rol en 3 is de standaard leraar zonder bewerken rol. Je kunt ook het role-veld gebruiken om een rol rechtstreeks te specifiëren. Gebruik ofwel de verkorte rolnaam of id (numerieke namen van rollen worden niet ondersteund. Gebruikers kunnen ook aan groepen toegewezen worden (group1 in course1, group2 in course2, etc.). Ook groepen worden geïdentifieerd door namen (numerieke namen worden niet ondersteund).
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