local_ltncresults_upload_csv: gebruiker beheer via CSV
Algemeen
Met de POST functie local_lntcresults_upload heb je als organisatie de mogelijkheid om een CSV bestand aan te bieden aan de leeromgeving. Deze methode zorgt ervoor dat beheerders dit niet meer handmatig hoeven te doen via sitebeheer > Gebruikers > Gebruikers > upload.
Welke parameters zijn er:
Parameter
Type
Omschrijving
Voorbeeld
wstoken
string required
Moodle API generated token
Moodle webservice token.
wsfunction
string required
local_ltncresults_upload_csv
moodlewsrestformat
string optional
Allow returning in JSON format
json
Body
Key
Value
Omschrijving
Voorbeeld
File
CSV comma separated file
Zorg dat hier je CSV file geupload wordt
Zie bijlage
Aanbieden en verwerking van bestand
De file dient via de webservice functie te worden aangeboden. Hiervoor kun je eventueel werken met een PHP file die op basis van een cron taak het bestand aanbiedt.
Moodle controleert met de Cron taak process_upload_csv (standaard elke 5 minuten) of er bestand wordt aangeboden en gaat deze verwerken.
Welke velden kan ik opnemen in de CSV upload
In principe kun je alle velden die worden genoemd in de Moodle documentatie : Upload users gebruiken.
Je kan dus:
- Nieuwe gebruikers aanmaken, inclusief custom profielvelden.
- Gebruiker accounts schorsen en/of verwijderen.
- Gebruikers aanmelden op cursussen, cohorts en/of groepen.
We hanteren de volgende standaard waardes:
- E-mailadres tonen volgens Sitebeheer instellingen.
- Forum auto inschrijvingen volgens sitebeheer instellingen.
- Plaats, IDnummer, Organisatie, Afdeling indien opgenomen in het CSV bestand.
- Wijzigingen in (custom)profielvelden worden altijd aangepast, met uitzondering van gebruikersnamen.
Waarop moet ik letten
- Het CSV bestand moet de kolommen scheidde met een , (komma).
- Moodle zal het csv bestanden onder de noemer “Voeg nieuwe gebruikers toe en update bestaande gebruikers”
- Wanneer in het bestand geen wachtwoord is opgenomen, zal Moodle automatisch een wachtwoord generen. Gebruikers ontvangen dan per mail het wachtwoord van Moodle, en bij eerste inlog wordt ze gevraagd om het wachtwoord te wijzigen.
- Moodle zal automatisch gebruikers met een zwak wachtwoord bij inloggen vragen om een nieuwe wachtwoord te kiezen.
- Wanneer er een wachtwoord in het bestand is opgenomen, zal Moodle dit wachtwoord gebruiken voor de nieuwe gebruiker. Let op: er wordt dan géén mail vanuit Moodle gestuurd.
- Het is niet mogelijk om gebruikersnamen aan te passen en/of dubbele emailadressen toe te staan.