Moodle API - Historial de revisió

Enric: /* Introducció */

2017-05-03T14:58:30Z

Introducció

Enric a 14:53, 3 maig 2017

2017-05-03T14:53:09Z

Enric: /* Python */

2017-05-03T14:46:58Z

Python

Enric: /* PHP */

2017-05-03T14:43:27Z

PHP

Enric a 14:38, 3 maig 2017

2017-05-03T14:38:51Z

Enric: Es crea la pàgina amb «El CMS Moodle disposa d'una API per accedir a les seves funcions internes i afegir funcionalitat com, per exemple, crear cursos automàticament des d'un script...».

2017-05-02T16:17:44Z

Es crea la pàgina amb «El CMS Moodle disposa d'una API per accedir a les seves funcions internes i afegir funcionalitat com, per exemple, crear cursos automàticament des d'un script...».

Pàgina nova

El [[CMS]] Moodle disposa d'una [[API]] per accedir a les seves funcions internes i afegir funcionalitat com, per exemple, crear cursos automàticament des d'un script.

La API és accessible de diferents maneres (SOAP, REST, etc.) de les quals ens interessa REST.

Per activar-la haurem de seguir les passes (són unes quantes) que s'indica dintre del mateix moodle, a la secció:
Site Administration -> Plugins -> Web Services -> Overview

Un cop hagueu creat un rol i usuari amb els permisos adequats per a la API, finalment podeu seguir les passes descrites a la web per accedir a la API:
* Demanar token
* Executar funció
Explicat aquí:
https://docs.moodle.org/dev/Creating_a_web_service_client

Ai! però dona un error.
Can not find data record in database table external_functions.

Es veu que passa quan creem una nova funció personalitzada a la API. Cal actualitzar unes taules, i això no passa automàticament.

Per forçar l'actualització de les funcions aquí suggereixen elevar la versió de version.php i així el moodle automàticament farà un upgrade.
http://stackoverflow.com/questions/38891022/moodle-custom-service-creation-issue

Un cop fet l'upgrade simulat, tindrem disponible la nova funció.

@@ Línia 16: / Línia 16: @@
 Tot sembla senzill en un principi, però hi ha lio per passar els arguments. Seria d'agrair passar-los en JSON o similars, però es veu que la cosa no va així. Buscant per aquí i per allà he trobat aquestes explicacions amagades:
 * https://moodle.org/mod/forum/discuss.php?d=232130 (mirar el 3r post on ho aclareix)
-* ...
+* http://stackoverflow.com/questions/36375380/how-to-create-a-user-in-the-moodle-rest-ws-using-the-python-requests-module (mirar la resposta)
 O sigui que els paràmetres s'han de passar en URLencode a l'estil:

@@ Línia 14: / Línia 14: @@
   https://docs.moodle.org/dev/Creating_a_web_service_client
-<br>
+Tot sembla senzill en un principi, però hi ha lio per passar els arguments. Seria d'agrair passar-los en JSON o similars, però es veu que la cosa no va així. Buscant per aquí i per allà he trobat aquestes explicacions amagades:
+* https://moodle.org/mod/forum/discuss.php?d=232130 (mirar el 3r post on ho aclareix)
-== Custom functions ==
+* ...
-Per forçar l'actualització de les funcions aquí suggereixen elevar la versió de version.php i així el moodle automàticament farà un upgrade.
+O sigui que els paràmetres s'han de passar en URLencode a l'estil:
- http://stackoverflow.com/questions/38891022/moodle-custom-service-creation-issue
+ .....&criteria[0][key]=email&criteria[0][value]=aname@somedomain
 <br>
@@ Línia 97: / Línia 89: @@
 </syntaxhighlight>
 <br>

← Versió més antiga		Revisió del 14:46, 3 maig 2017
Línia 69:		Línia 69:

	== Python ==		== Python ==
		+	Recursos:
		+	* http://stackoverflow.com/questions/36375380/how-to-create-a-user-in-the-moodle-rest-ws-using-the-python-requests-module
		+	* Utilitzem la llibreria "requests" per facilitar: http://docs.python-requests.org
		+
		+	<syntaxhighlight lang="python">
		+
		+	import requests
		+	import json
		+
		+	token = "xxxyyyzzz"
		+	url = "https://el.meu.moodle.com/moodle/webservice/rest/server.php?wstoken=" + token + ""
		+	# afegir aixo si vols resposta json
		+	#url=url+"&moodlewsrestformat=json"
		+
		+	# dades minimes per crear un curs
		+	data = {
		+	'wsfunction': 'core_course_create_courses',
		+	'courses[0][fullname]' : "CURS DE TEST 3",
		+	'courses[0][shortname]' : "test3",
		+	'courses[0][categoryid]' : 4
		+	}
		+
		+	r = requests.post(url, params=data, verify=False)
		+
		+	print data
		+	print r.text
		+
		+	</syntaxhighlight>

	<br>		<br>

@@ Línia 32: / Línia 32: @@
 == PHP ==
 <br>
 == Python ==
 <br>

@@ Línia 1: / Línia 1: @@
 El [[CMS]] Moodle disposa d'una [[API]] per accedir a les seves funcions internes i afegir funcionalitat com, per exemple, crear cursos automàticament des d'un script.
@@ Línia 12: / Línia 14: @@
   https://docs.moodle.org/dev/Creating_a_web_service_client
-Ai! però dona un error.
+<br>
   Can not find data record in database table external_functions.
@@ Línia 21: / Línia 28: @@
 Un cop fet l'upgrade simulat, tindrem disponible la nova funció.