https://documentacion.siu.edu.ar/wiki/api.php?action=feedcontributions&user=Gapereyra&feedformat=atomSIU - Contribuciones del usuario [es]2024-03-29T13:11:21ZContribuciones del usuarioMediaWiki 1.30.0https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.21.0/interfaces/moodle&diff=87233SIU-Guarani/version3.21.0/interfaces/moodle2022-11-18T19:16:27Z<p>Gapereyra: </p>
<hr />
<div>__NOTOC__<br />
<span id="interfaz_guarani_moodle"></span><br />
=[[#interfaz_guarani_moodle|Interfaz SIU-Guaraní - Moodle]]=<br />
<br />
'''<big>NOTA: SIU-Guaraní 3.21 se probó con Moodle desde 3.4 a 4.0, no se garantiza de que funcione correctamente con otras versiones de este último.</big>'''<br />
<br />
'''<big>Si ya disponemos de una instalación de Moodle con usuarios que ya están haciendo uso de dicha instalación, entonces ver [[SIU-Guarani/version3.21.0/interfaces/vinculacion_usuarios_moodle|Vinculación de usuarios con Moodle]].</big>'''<br />
<br />
<span id="en_moodle"></span><br />
== [[#en_moodle|En Moodle]] ==<br />
<big>Aquí veremos como configurar para que '''Guaraní''' se comunique con '''Moodle'''.</big><br />
<br />
<big>Antes de comenzar con los pasos debemos instalar el Plugin '''Roles WS Plugin (SIU)''', el mismo fue desarrollado por el '''SIU''' y permite obtener los roles de '''Moodle''' vía Web Service. Lo podemos descargar desde [https://gitlab.siu.edu.ar/guarani/moodle-local_user/-/archive/1.0.0/moodle-local_user-1.0.0.zip el siguiente link], e instalarlo en ''Administración del sitio => Extensiones => Instalar Complementos (subdivisión "Extensiones") => Instalar complemento desde un archivo ZIP ''</big> <br />
<br />
<gallery widths="1015" heights="500">Archivo:Moodle - Instalar modulos externos.png | Moodle - Instalar módulos externos</gallery><br />
<br />
<big>Seleccionar el archivo .zip y continuar (luego hacer click en el botón que dice "Actualizar base de datos Moodle ahora").</big><br />
<br />
<gallery widths="690" heights="500">Archivo:Moodle - Seleccionar archivo(modulo externo).png | Moodle - Instalar módulos externos - Selección de archivo</gallery><br />
<br />
<big>Se puede ver una '''vista general''' de los pasos ingresando en el siguiente apartado de la instalación de '''Moodle''': ''Administración del sitio => Servidor => Vista General (subdivisión "Servicios Web")''</big><gallery widths="1227" heights="689"><br />
Archivo:Moodle - Vista_general 4.0.png|Moodle - Vista General Servicios Web</gallery><br />
<span id="habilitar_servicios_web"></span><br />
<big>[[#habilitar_servicios_web|1) Habilitar '''Servicios Web''']]</big><br />
<gallery widths="1504" heights="377">Archivo:Moodle - Habilitar servicios web.png|Moodle - Habilitar servicios web</gallery><br />
<span id="habilitar_protocolo_rest"></span><br />
<big>[[#habilitar_protocolo_rest|2) Habilitar el protocolo '''REST''']]</big><br />
<gallery widths="1224" heights="513">Archivo:Moodle - Habilitar protocolo REST.png|Moodle - Habilitar protocolo REST</gallery><br />
<span id="crear_nuevo_servicio"></span><br />
<big>[[#crear_nuevo_servicio|3) Crear un nuevo '''servicio''']]</big><gallery widths="1225" heights="363">Archivo:Moodle - Crear servicio bis.png|Moodle - Crear servicio</gallery><br />
<br />
<big>La opción '''Habilitado''' debe estar marcada, de lo contrario la opción '''Únicamente usuarios autorizados''' debe estar desmarcada.</big><br />
<br />
<br><br />
<span id="agregar_funciones"></span><br />
<big>[[#agregar_funciones|4) Agregar '''funciones''' para el '''servicio''' creado en el punto 3 (hacer click en el link marcado en violeta)]]</big><br />
<gallery widths="1220" heights="592">Archivo:Moodle - Funciones bis.png|Moodle - Funciones</gallery><br />
<gallery widths="1221" heights="477">Archivo:Moodle - Agregar Funciones bis.png|Moodle - Agregar Funciones</gallery><br />
<big>Se deben agregar las siguientes funciones que '''Guaraní''' requiere para comunicarse con '''Moodle''':</big><br />
* <big>core_webservice_get_site_info</big><br />
* <big>core_course_get_categories</big><br />
* <big>core_course_get_courses</big><br />
* <big>core_course_get_courses_by_field</big><br />
* <big>core_enrol_get_enrolled_users</big><br />
* <big>core_enrol_get_users_courses</big><br />
* <big>core_user_create_users</big><br />
* <big>core_user_update_users</big><br />
* <big>enrol_manual_enrol_users</big><br />
* <big>enrol_manual_unenrol_users</big><br />
* <big>core_course_create_courses</big><br />
* <big>core_course_import_course</big><br />
* <big>core_user_get_users</big><br />
* <big>local_user_get_roles</big><br />
* <big>core_group_create_groups</big><br />
* <big>core_group_add_group_members</big><br />
* <big>core_group_delete_groups</big><br />
<br />
<span id="definir_rol_servicios_web"></span><br />
<big>[[#definir_rol_servicios_web|5) Definir un rol para los '''Servicios Web''']]</big><br />
<br />
<big>Ir a ''Administración del sitio => Usuarios => Definir roles'', luego crear un nuevo rol para '''Servicios web''' (Continuar con ''Ningún rol'' en la opción ''Usar rol o arquetipo'').</big><gallery widths="1220" heights="586"><br />
Archivo:Moodle - Rol Servicios web 4.0.png|Moodle - Definir roles<br />
</gallery><br />
<br />
<big>Dicho rol debe contar con todos los '''contextos''':</big><gallery widths="821" heights="698"><br />
Archivo:Moodle - Asignar Contextos.png|Moodle - Asignar Contextos<br />
</gallery><big>Deben estar marcados todos, para permitir la asignación, sobre-escritura y cambios de roles</big><gallery widths="671" heights="626"><br />
Archivo:Moodle - Roles Permitir.png|Moodle - Roles Permitir<br />
</gallery><br />
<br />
<big>Dicho rol debe también contar con las siguientes '''capacidades''': ''webservice:createtoken'', ''webservice/rest:use y moodle/role:manage''.</big><gallery widths="953" heights="234"><br />
Archivo:Moodle - webservice createtoken.png|Moodle - webservice:createtoken<br />
</gallery><gallery widths="1115" heights="344"><br />
Archivo:Moodle - webservice rest use.png|Moodle - webservice/rest:use<br />
</gallery><br />
<span id="asignar_rol_creado"></span><br />
<big>[[#asignar_rol_creado|6) Asignarle el rol creado en el '''punto 5''' al usuario '''Administrador''']]</big><br><br />
<big>Ir a ''Administración de sitio => Usuarios => Asignar roles de sistema (Subdivisión "Permisos")''. Luego asignar el rol creado en el punto 5.</big><br />
<gallery widths="1220" heights="304"><br />
Archivo:Moodle - Asignar rol admin a servicios web.png|Moodle - Agregar Usuario a Rol<br />
</gallery><br />
<gallery widths="1220" heights="304"><br />
Archivo:Moodle - Asignar roles globales bis.png|Moodle - Asignar Roles Globales - Resultado final<br />
</gallery><br />
<br />
<span id="crear_token"></span><br />
<big>[[#crear_token|7) Crear un '''token''' para el usuario creado en el '''punto 6''']]</big><br />
<br />
<big>Ir a ''Administración => Servidor => Servicios Web => Administrar fichas (tokens) => Crear ficha''. Elija el usuario '''Administrador''' y el '''servicio''' creado en el '''punto 3'''.</big><gallery widths="888" heights="470"><br />
Archivo:Moodle - Crear token bis.png|Moodle - Crear Token<br />
</gallery><br />
<br />
<span id="habilitar_depuracion_desarrolladores"></span><br />
<big>[[#habilitar_depuracion_desarrolladores|8) Habilitar la '''Depuración para desarrolladores''']]</big><br />
<br />
<big>Ir a ''Administración del sitio => Desarrollo => Depuracion (debugging)'', luego en el combo '''Mensajes de depuración''' elegir el valor '''DESARROLLADOR: mensajes extra de depuración Moodle para desarrolladores'''.</big><gallery widths="668" heights="509"><br />
Archivo:Depurando Moodle.png|Moodle - Depurando<br />
</gallery><br />
<br />
<span id="configurar_directivas_php"></span><br />
<big>[[#configurar_directivas_php|9) Configurar las directivas de PHP '''max_input_vars''' y '''post_max_size''']]</big><br />
<br />
<big>Si se va a trabajar con un gran volumen de alumnos/docentes por comisión/curso, se recomienda el incremento de las directivas de PHP '''max_input_vars''' y '''post_max_size''', ubicadas en el archivo "php.ini".</big><br />
<br />
<span id="probar_servicios_web"></span><br />
<big>[[#probar_servicios_web|10) Probar que funcionen los '''Servicios Web''']]</big><br />
<br />
<big>Una vez creado el '''token''', lo podemos obtener en la pantalla '''Administrar tokens'''.</big><gallery widths="1222" heights="300"><br />
Archivo:Moodle - Administrar tokens bis.png|Moodle - Administrar Tokens<br />
</gallery><br />
<br />
<big>Para probar que todo funcione bien acceder a la siguiente URL: '''<URL-MOODLE>'''/webservice/rest/server.php?wstoken='''<TOKEN>'''&moodlewsrestformat=json&wsfunction=core_webservice_get_site_info</big>.<br />
<br />
<big>Donde '''<URL-MOODLE>''' es la URL base de la instalación de Moodle, ej: http://www.ejemplo.edu.ar/moodle.</big><br />
<br />
<big>Y '''<TOKEN>''' seria el recién creado, en nuestro ejemplo seria '''9d27d581881b1cfed9f0d644540ab044'''.</big><br />
<br />
<big>Dicho Servicio Web debería devolver un '''JSON''' con información de Moodle. En caso de dar error, revisar los pasos anteriores.</big><br />
<br />
<br><br />
<span id="configurar_login_sso"></span><br />
<big>[[#configurar_login_sso|11) Configurar login vía '''Single Sign-On''' (SSO) en Moodle]]</big><br />
<br />
<big>Para que los usuarios de '''Guaraní''' se puedan loguear automáticamente en '''Moodle''', se deben seguir [http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.21.0/interfaces/moodle_sso los siguientes pasos].</big><br />
<br />
<span id="en_siu_guarani_gestion"></span><br />
== [[#en_siu_guarani_gestion|En SIU-Guaraní Gestión]] ==<br />
<big>Ir a la operación '''Administrar Configuración del Sistema''', y crear una nueva '''Plataforma de Educación Virtual'''.</big> <br />
<br><br />
<span id="datos_principales"></span><br />
<big>[[#datos_principales|1) Datos Principales]]</big><br />
<gallery widths="949" heights="627">Archivo:Administrar Configuración del Sistema - Datos Principales.png|Administrar Configuración del Sistema - Datos Principales</gallery><br />
Datos a completar:<br />
* '''Nombre:''' Nombre que va a tener la plataforma.<br />
* '''Host:''' Host donde se encuentra la instalación de Moodle, es la URL base. Ej: http://www.ejemplo.edu.ar/moodle.<br />
* '''Activa:''' Si la plataforma esta activa o no.<br />
* '''URL:''' Segmento de la URL de Moodle donde se encuentran los Servicios Web. Para Moodle 3.4.1 es /webservice/rest/server.php.<br />
* '''Usuario:''' Usuario de Moodle. Puede ser cualquier texto, solo a modo descriptivo.<br />
* '''Token:''' Es el token que creamos previamente. Ej: 9d27d581881b1cfed9f0d644540ab044.<br />
* '''Responsables Académicas:''' Responsables Académicas que van a hacer uso de dicho Moodle.<br />
Se puede hacer click en el botón '''Probar Configuración''' para saber si los valores son correctos y se pudo conectar con Moodle.<br />
<br />
<span id="roles_usuarios"></span><br />
<big>[[#roles_usuarios|2) Roles de Usuarios]]</big><br />
<br />
<big>Se deben vincular los '''perfiles de Alumnos y Docentes''' de Guaraní con los '''Roles de Moodle'''.</big><gallery widths="968" heights="556"><br />
Archivo:Administrar Configuración del Sistema - Roles de Usuarios con combo.png|Administrar Configuración del Sistema - Roles de Usuarios<br />
</gallery><br />
<br />
<big>Debido a que '''Moodle no provee ningún Servicio Web para saber los roles''' que posee, la única forma es ingresando a la operación ''Administración del sitio => Usuarios => Definir roles''.</big><gallery widths="1225" heights="792"><br />
Archivo:Moodle - Definir roles bis.png|Moodle - Definir roles<br />
</gallery><big>Al hacer click sobre el rol se podrá ver el '''ID''' del mismo en la '''URL'''.</big><gallery widths="644" heights="42"><br />
Archivo:Moodle - Rol URL bis.png|Moodle - Rol URL<br />
</gallery><big>'''NOTA:''' Si no se asigna algún '''rol de Moodle''' a una '''responsabilidad docente de Guaraní''', a la hora de matricular al docente en Moodle no se sabrá que rol asignar, por lo tanto '''NO se matriculará'''. '''Recordar asignar roles a todos las responsabilidades docentes de Guaraní.'''</big><br />
<br />
<span id="categorias_cursos"></span><br />
<big>[[#categorias_cursos|3) Categorías de Cursos]]</big><br />
<br />
<big>Aquí se selecciona la '''categoría por defecto''' con la que se crearan los cursos en la operación '''Generar Cursos Virtuales Masivamente'''.</big><gallery widths="949" heights="160"><br />
Archivo:Administrar Configuración del Sistema - Categorías de Cursos.png|Administrar Configuración del Sistema - Categorías de Cursos<br />
</gallery><br />
<br />
<span id="consideraciones"></span><br />
== [[#consideraciones|Consideraciones]] ==<br />
<br />
* <big>Si <b>SIU-Guaraní</b> muestra el error <b>Mensaje Moodle: invalidparameter - Invalid parameter value detected</b> se debe [[#habilitar_depuracion_desarrolladores|Habilitar la '''Depuración para desarrolladores''']] para que muestre mas detalles sobre dicho error.</big><br />
<br />
* <big>Las personas de <b>SIU-Guaraní</b> deben tener al menos un email asignado para que se puedan crear los usuarios correspondientes en <b>Moodle</b>.</big><br />
<br />
* <big>El campo usuario de las personas en <b>SIU-Guaraní</b> sólo puede contener caracteres alfanuméricos en minúsculas (letras y números), subrayado (_), guión (-), punto (.) o arroba (@), si contiene otros caracteres mas allá de los mencionados dará error en <b>Moodle</b>.</big></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.21.0/interfaces/moodle&diff=87232SIU-Guarani/version3.21.0/interfaces/moodle2022-11-18T19:14:52Z<p>Gapereyra: </p>
<hr />
<div>__NOTOC__<br />
<span id="interfaz_guarani_moodle"></span><br />
=[[#interfaz_guarani_moodle|Interfaz SIU-Guaraní - Moodle]]=<br />
<br />
'''<big>NOTA: SIU-Guaraní 3.21 se probó con Moodle desde 3.4 a 3.10, no se garantiza de que funcione correctamente con otras versiones de este último.</big>'''<br />
<br />
'''<big>Si ya disponemos de una instalación de Moodle con usuarios que ya están haciendo uso de dicha instalación, entonces ver [[SIU-Guarani/version3.21.0/interfaces/vinculacion_usuarios_moodle|Vinculación de usuarios con Moodle]].</big>'''<br />
<br />
<span id="en_moodle"></span><br />
== [[#en_moodle|En Moodle]] ==<br />
<big>Aquí veremos como configurar para que '''Guaraní''' se comunique con '''Moodle'''.</big><br />
<br />
<big>Antes de comenzar con los pasos debemos instalar el Plugin '''Roles WS Plugin (SIU)''', el mismo fue desarrollado por el '''SIU''' y permite obtener los roles de '''Moodle''' vía Web Service. Lo podemos descargar desde [https://gitlab.siu.edu.ar/guarani/moodle-local_user/-/archive/1.0.0/moodle-local_user-1.0.0.zip el siguiente link], e instalarlo en ''Administración del sitio => Extensiones => Instalar Complementos (subdivisión "Extensiones") => Instalar complemento desde un archivo ZIP ''</big> <br />
<br />
<gallery widths="1015" heights="500">Archivo:Moodle - Instalar modulos externos.png | Moodle - Instalar módulos externos</gallery><br />
<br />
<big>Seleccionar el archivo .zip y continuar (luego hacer click en el botón que dice "Actualizar base de datos Moodle ahora").</big><br />
<br />
<gallery widths="690" heights="500">Archivo:Moodle - Seleccionar archivo(modulo externo).png | Moodle - Instalar módulos externos - Selección de archivo</gallery><br />
<br />
<big>Se puede ver una '''vista general''' de los pasos ingresando en el siguiente apartado de la instalación de '''Moodle''': ''Administración del sitio => Servidor => Vista General (subdivisión "Servicios Web")''</big><gallery widths="1227" heights="689"><br />
Archivo:Moodle - Vista_general 4.0.png|Moodle - Vista General Servicios Web</gallery><br />
<span id="habilitar_servicios_web"></span><br />
<big>[[#habilitar_servicios_web|1) Habilitar '''Servicios Web''']]</big><br />
<gallery widths="1504" heights="377">Archivo:Moodle - Habilitar servicios web.png|Moodle - Habilitar servicios web</gallery><br />
<span id="habilitar_protocolo_rest"></span><br />
<big>[[#habilitar_protocolo_rest|2) Habilitar el protocolo '''REST''']]</big><br />
<gallery widths="1224" heights="513">Archivo:Moodle - Habilitar protocolo REST.png|Moodle - Habilitar protocolo REST</gallery><br />
<span id="crear_nuevo_servicio"></span><br />
<big>[[#crear_nuevo_servicio|3) Crear un nuevo '''servicio''']]</big><gallery widths="1225" heights="363">Archivo:Moodle - Crear servicio bis.png|Moodle - Crear servicio</gallery><br />
<br />
<big>La opción '''Habilitado''' debe estar marcada, de lo contrario la opción '''Únicamente usuarios autorizados''' debe estar desmarcada.</big><br />
<br />
<br><br />
<span id="agregar_funciones"></span><br />
<big>[[#agregar_funciones|4) Agregar '''funciones''' para el '''servicio''' creado en el punto 3 (hacer click en el link marcado en violeta)]]</big><br />
<gallery widths="1220" heights="592">Archivo:Moodle - Funciones bis.png|Moodle - Funciones</gallery><br />
<gallery widths="1221" heights="477">Archivo:Moodle - Agregar Funciones bis.png|Moodle - Agregar Funciones</gallery><br />
<big>Se deben agregar las siguientes funciones que '''Guaraní''' requiere para comunicarse con '''Moodle''':</big><br />
* <big>core_webservice_get_site_info</big><br />
* <big>core_course_get_categories</big><br />
* <big>core_course_get_courses</big><br />
* <big>core_course_get_courses_by_field</big><br />
* <big>core_enrol_get_enrolled_users</big><br />
* <big>core_enrol_get_users_courses</big><br />
* <big>core_user_create_users</big><br />
* <big>core_user_update_users</big><br />
* <big>enrol_manual_enrol_users</big><br />
* <big>enrol_manual_unenrol_users</big><br />
* <big>core_course_create_courses</big><br />
* <big>core_course_import_course</big><br />
* <big>core_user_get_users</big><br />
* <big>local_user_get_roles</big><br />
* <big>core_group_create_groups</big><br />
* <big>core_group_add_group_members</big><br />
* <big>core_group_delete_groups</big><br />
<br />
<span id="definir_rol_servicios_web"></span><br />
<big>[[#definir_rol_servicios_web|5) Definir un rol para los '''Servicios Web''']]</big><br />
<br />
<big>Ir a ''Administración del sitio => Usuarios => Definir roles'', luego crear un nuevo rol para '''Servicios web''' (Continuar con ''Ningún rol'' en la opción ''Usar rol o arquetipo'').</big><gallery widths="1220" heights="586"><br />
Archivo:Moodle - Rol Servicios web 4.0.png|Moodle - Definir roles<br />
</gallery><br />
<br />
<big>Dicho rol debe contar con todos los '''contextos''':</big><gallery widths="821" heights="698"><br />
Archivo:Moodle - Asignar Contextos.png|Moodle - Asignar Contextos<br />
</gallery><big>Deben estar marcados todos, para permitir la asignación, sobre-escritura y cambios de roles</big><gallery widths="671" heights="626"><br />
Archivo:Moodle - Roles Permitir.png|Moodle - Roles Permitir<br />
</gallery><br />
<br />
<big>Dicho rol debe también contar con las siguientes '''capacidades''': ''webservice:createtoken'', ''webservice/rest:use y moodle/role:manage''.</big><gallery widths="953" heights="234"><br />
Archivo:Moodle - webservice createtoken.png|Moodle - webservice:createtoken<br />
</gallery><gallery widths="1115" heights="344"><br />
Archivo:Moodle - webservice rest use.png|Moodle - webservice/rest:use<br />
</gallery><br />
<span id="asignar_rol_creado"></span><br />
<big>[[#asignar_rol_creado|6) Asignarle el rol creado en el '''punto 5''' al usuario '''Administrador''']]</big><br><br />
<big>Ir a ''Administración de sitio => Usuarios => Asignar roles de sistema (Subdivisión "Permisos")''. Luego asignar el rol creado en el punto 5.</big><br />
<gallery widths="1220" heights="304"><br />
Archivo:Moodle - Asignar rol admin a servicios web.png|Moodle - Agregar Usuario a Rol<br />
</gallery><br />
<gallery widths="1220" heights="304"><br />
Archivo:Moodle - Asignar roles globales bis.png|Moodle - Asignar Roles Globales - Resultado final<br />
</gallery><br />
<br />
<span id="crear_token"></span><br />
<big>[[#crear_token|7) Crear un '''token''' para el usuario creado en el '''punto 6''']]</big><br />
<br />
<big>Ir a ''Administración => Servidor => Servicios Web => Administrar fichas (tokens) => Crear ficha''. Elija el usuario '''Administrador''' y el '''servicio''' creado en el '''punto 3'''.</big><gallery widths="888" heights="470"><br />
Archivo:Moodle - Crear token bis.png|Moodle - Crear Token<br />
</gallery><br />
<br />
<span id="habilitar_depuracion_desarrolladores"></span><br />
<big>[[#habilitar_depuracion_desarrolladores|8) Habilitar la '''Depuración para desarrolladores''']]</big><br />
<br />
<big>Ir a ''Administración del sitio => Desarrollo => Depuracion (debugging)'', luego en el combo '''Mensajes de depuración''' elegir el valor '''DESARROLLADOR: mensajes extra de depuración Moodle para desarrolladores'''.</big><gallery widths="668" heights="509"><br />
Archivo:Depurando Moodle.png|Moodle - Depurando<br />
</gallery><br />
<br />
<span id="configurar_directivas_php"></span><br />
<big>[[#configurar_directivas_php|9) Configurar las directivas de PHP '''max_input_vars''' y '''post_max_size''']]</big><br />
<br />
<big>Si se va a trabajar con un gran volumen de alumnos/docentes por comisión/curso, se recomienda el incremento de las directivas de PHP '''max_input_vars''' y '''post_max_size''', ubicadas en el archivo "php.ini".</big><br />
<br />
<span id="probar_servicios_web"></span><br />
<big>[[#probar_servicios_web|10) Probar que funcionen los '''Servicios Web''']]</big><br />
<br />
<big>Una vez creado el '''token''', lo podemos obtener en la pantalla '''Administrar tokens'''.</big><gallery widths="1222" heights="300"><br />
Archivo:Moodle - Administrar tokens bis.png|Moodle - Administrar Tokens<br />
</gallery><br />
<br />
<big>Para probar que todo funcione bien acceder a la siguiente URL: '''<URL-MOODLE>'''/webservice/rest/server.php?wstoken='''<TOKEN>'''&moodlewsrestformat=json&wsfunction=core_webservice_get_site_info</big>.<br />
<br />
<big>Donde '''<URL-MOODLE>''' es la URL base de la instalación de Moodle, ej: http://www.ejemplo.edu.ar/moodle.</big><br />
<br />
<big>Y '''<TOKEN>''' seria el recién creado, en nuestro ejemplo seria '''9d27d581881b1cfed9f0d644540ab044'''.</big><br />
<br />
<big>Dicho Servicio Web debería devolver un '''JSON''' con información de Moodle. En caso de dar error, revisar los pasos anteriores.</big><br />
<br />
<br><br />
<span id="configurar_login_sso"></span><br />
<big>[[#configurar_login_sso|11) Configurar login vía '''Single Sign-On''' (SSO) en Moodle]]</big><br />
<br />
<big>Para que los usuarios de '''Guaraní''' se puedan loguear automáticamente en '''Moodle''', se deben seguir [http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.21.0/interfaces/moodle_sso los siguientes pasos].</big><br />
<br />
<span id="en_siu_guarani_gestion"></span><br />
== [[#en_siu_guarani_gestion|En SIU-Guaraní Gestión]] ==<br />
<big>Ir a la operación '''Administrar Configuración del Sistema''', y crear una nueva '''Plataforma de Educación Virtual'''.</big> <br />
<br><br />
<span id="datos_principales"></span><br />
<big>[[#datos_principales|1) Datos Principales]]</big><br />
<gallery widths="949" heights="627">Archivo:Administrar Configuración del Sistema - Datos Principales.png|Administrar Configuración del Sistema - Datos Principales</gallery><br />
Datos a completar:<br />
* '''Nombre:''' Nombre que va a tener la plataforma.<br />
* '''Host:''' Host donde se encuentra la instalación de Moodle, es la URL base. Ej: http://www.ejemplo.edu.ar/moodle.<br />
* '''Activa:''' Si la plataforma esta activa o no.<br />
* '''URL:''' Segmento de la URL de Moodle donde se encuentran los Servicios Web. Para Moodle 3.4.1 es /webservice/rest/server.php.<br />
* '''Usuario:''' Usuario de Moodle. Puede ser cualquier texto, solo a modo descriptivo.<br />
* '''Token:''' Es el token que creamos previamente. Ej: 9d27d581881b1cfed9f0d644540ab044.<br />
* '''Responsables Académicas:''' Responsables Académicas que van a hacer uso de dicho Moodle.<br />
Se puede hacer click en el botón '''Probar Configuración''' para saber si los valores son correctos y se pudo conectar con Moodle.<br />
<br />
<span id="roles_usuarios"></span><br />
<big>[[#roles_usuarios|2) Roles de Usuarios]]</big><br />
<br />
<big>Se deben vincular los '''perfiles de Alumnos y Docentes''' de Guaraní con los '''Roles de Moodle'''.</big><gallery widths="968" heights="556"><br />
Archivo:Administrar Configuración del Sistema - Roles de Usuarios con combo.png|Administrar Configuración del Sistema - Roles de Usuarios<br />
</gallery><br />
<br />
<big>Debido a que '''Moodle no provee ningún Servicio Web para saber los roles''' que posee, la única forma es ingresando a la operación ''Administración del sitio => Usuarios => Definir roles''.</big><gallery widths="1225" heights="792"><br />
Archivo:Moodle - Definir roles bis.png|Moodle - Definir roles<br />
</gallery><big>Al hacer click sobre el rol se podrá ver el '''ID''' del mismo en la '''URL'''.</big><gallery widths="644" heights="42"><br />
Archivo:Moodle - Rol URL bis.png|Moodle - Rol URL<br />
</gallery><big>'''NOTA:''' Si no se asigna algún '''rol de Moodle''' a una '''responsabilidad docente de Guaraní''', a la hora de matricular al docente en Moodle no se sabrá que rol asignar, por lo tanto '''NO se matriculará'''. '''Recordar asignar roles a todos las responsabilidades docentes de Guaraní.'''</big><br />
<br />
<span id="categorias_cursos"></span><br />
<big>[[#categorias_cursos|3) Categorías de Cursos]]</big><br />
<br />
<big>Aquí se selecciona la '''categoría por defecto''' con la que se crearan los cursos en la operación '''Generar Cursos Virtuales Masivamente'''.</big><gallery widths="949" heights="160"><br />
Archivo:Administrar Configuración del Sistema - Categorías de Cursos.png|Administrar Configuración del Sistema - Categorías de Cursos<br />
</gallery><br />
<br />
<span id="consideraciones"></span><br />
== [[#consideraciones|Consideraciones]] ==<br />
<br />
* <big>Si <b>SIU-Guaraní</b> muestra el error <b>Mensaje Moodle: invalidparameter - Invalid parameter value detected</b> se debe [[#habilitar_depuracion_desarrolladores|Habilitar la '''Depuración para desarrolladores''']] para que muestre mas detalles sobre dicho error.</big><br />
<br />
* <big>Las personas de <b>SIU-Guaraní</b> deben tener al menos un email asignado para que se puedan crear los usuarios correspondientes en <b>Moodle</b>.</big><br />
<br />
* <big>El campo usuario de las personas en <b>SIU-Guaraní</b> sólo puede contener caracteres alfanuméricos en minúsculas (letras y números), subrayado (_), guión (-), punto (.) o arroba (@), si contiene otros caracteres mas allá de los mencionados dará error en <b>Moodle</b>.</big></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=Archivo:Moodle_-_Asignar_rol_admin_a_servicios_web.png&diff=87230Archivo:Moodle - Asignar rol admin a servicios web.png2022-11-18T19:07:15Z<p>Gapereyra: </p>
<hr />
<div></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=Archivo:Moodle_-_Rol_Servicios_web_4.0.png&diff=87226Archivo:Moodle - Rol Servicios web 4.0.png2022-11-18T19:01:59Z<p>Gapereyra: </p>
<hr />
<div></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=Archivo:Moodle_-_Vista_general_4.0.png&diff=87223Archivo:Moodle - Vista general 4.0.png2022-11-18T18:54:03Z<p>Gapereyra: </p>
<hr />
<div></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=Archivo:Moodle_-_Seleccionar_archivo(modulo_externo).png&diff=87210Archivo:Moodle - Seleccionar archivo(modulo externo).png2022-11-18T17:42:12Z<p>Gapereyra: </p>
<hr />
<div></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=Archivo:Moodle_-_Instalar_modulos_externos.png&diff=87209Archivo:Moodle - Instalar modulos externos.png2022-11-18T17:38:49Z<p>Gapereyra: </p>
<hr />
<div></div>Gapereyrahttps://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/Version3.20.0/Novedades_tecnicas&diff=78859SIU-Guarani/Version3.20.0/Novedades tecnicas2022-02-25T19:51:49Z<p>Gapereyra: </p>
<hr />
<div><br />
__NOTOC__<br />
__NOTOC__<br />
= Principales novedades técnicas =<br />
<br />
<p style="clear: both;"></p><br />
<br />
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;"><br />
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.1 | Volver]]</p><br />
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.1</strong></p><br />
<p style="margin: 0; padding: 0;">Fecha de publicación: ''</p><br />
</div><br />
<p style="clear: both;"></p><br />
== Base de Datos ==<br />
=== Diferencias con versiones anteriores ===<br />
<div style="<br />
display: none;"><br />
https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/Novedades_tecnicas<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.20.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.20.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.19.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.18.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.17.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.2]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.16.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.1 Con versión 3.15.0]<br />
</div><br />
<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content"><br />
<br />
== Notas de versión ==<br />
<br />
* Cambios en la configuracion de puertos para usar jasper tenemos que regenerar el CONFIG.PHP<br />
* Se agrega genero x en la API <br />
<br />
<div class="mw-collapsible-content"><br />
<br />
== API-REST Guaraní ==<br />
<br />
<br />
== Gestión ==<br />
<br />
* <br />
<br />
== Autogestión ==<br />
*<br />
</div></div><br />
__NOTOC__<br />
__NOTOC__<br />
= Principales novedades técnicas =<br />
<br />
<p style="clear: both;"></p><br />
<br />
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;"><br />
<p style="margin: 0; padding: 0;">[[SIU-Guarani/Version3.20.0 | Volver]]</p><br />
<p style="margin: 0; padding: 0;">Número de versión: <strong>3.20.0</strong></p><br />
<p style="margin: 0; padding: 0;">Fecha de publicación: '''22/10/2021'''</p><br />
</div><br />
<p style="clear: both;"></p><br />
== Base de Datos ==<br />
=== Diferencias con versiones anteriores ===<br />
<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.19.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.19.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.18.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.18.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.17.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.17.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.2&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.2]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.16.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.16.0]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.1&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.1]<br />
* [https://colab.siu.edu.ar/trac/guarani3/changeset?old=HEAD@/branches/base_diff/versiones/3.15.0&new=HEAD@/branches/base_diff/versiones/3.20.0 Con versión 3.15.0]<br />
<br />
<div class="mw-collapsible" style="width:100%"><div class="mw-collapsible-content"><br />
<br />
== Notas de versión ==<br />
<br />
* Cambios en la documentación de [https://expedientes.siu.edu.ar/docs/guarani/ Expedientes].<br />
<br />
* [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.20.0/instalacion_desde_cero/requisitos_previos/linux Se modifican los requisitos previos]: <br />
<dd>Actualización de tecnologías de base:<br />
* Se actualiza a la versión de '''PHP 7.4.x.''' <br />
Importante:<br />
[https://www.php.net/manual/es/migration74.php Consideraciones de migración de PHP 7.3 a 7.4]<br />
</dd><br />
<br />
<div class="mw-collapsible-content"><br />
<br />
== API-REST Guaraní ==<br />
<br />
<pre style="color: red"> ¡Nuevo esquema de versionado de API! </pre> Permite mantener vivas las versiones anteriores de la API Guaraní, para ello se agrega un indicador de versión a la url. El resultado es ''http://<url_gestion>/rest/v1/''. <br />
<br />
Es muy '''IMPORTANTE''' que al actualizar el módulo de Gestión, cambien las configuraciones de otros sistemas que consumen la API de SIU-Guaraní como SIU-Tehuelche, SIU-Sanaviron-Quilmes, SIU-Quechua y SIDCER.<br />
<br />
Ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/API_REST_GUARANI configuración de API REST].<br />
<br />
Si se posee personalizaciones en la API REST ver [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/personalizaciones/rest Personalizar servicios REST].<br />
<br />
== Gestión ==<br />
<br />
* Se agrega '''jasper_host''' y '''jasper_port''' al archivo '''instalacion.ini''' para personalizar host y puerto del servicio Jasper, respectivamente.<br />
* Se migró de la versión '''3.3.14''' de '''SIU-Toba''' a la versión '''3.3.20'''.<br />
<dd>Para más información [https://github.com/SIU-Toba/framework/blob/v3.3.20/CHANGELOG.md ver documentación aquí].</dd><br />
<br />
== Autogestión ==<br />
<br />
* Se modifica el archivo de configuración [https://documentacion.siu.edu.ar/wiki/SIU-Guarani/Version3.20.0/3w/configuracion config.php]:<br />
<dd>Se agregan nuevas directivas en el archivo '''instalacion/config.php''', se debe recrear a partir de su template (archivo '''instalacion/config_template.php'''):<br />
* Se agrega la directiva '''huarpe_url_bandeja''' para configurar la URL de la bandeja de documentos pendientes de autorización de '''SIU-Huarpe'''.<br />
* Se agrega la directiva '''jasper_host''' para configurar la IP/URL donde se encuentre alojado el servicio '''Jasper'''.<br />
* Se agrega la directiva '''jasper_port''' para configurar el puerto donde se encuentre alojado el servicio '''Jasper'''.<br />
</dd><br />
<br />
* Se migró de la versión '''2.3.0''' de '''Chulupí''' a la versión '''2.4.0'''.<br />
<br />
</div></div></div>Gapereyra