Preparing Moodle 20/es: Difference between revisions

From Joomdle
Jump to navigationJump to search
Created page with '{{Languages}} {{Current Version}} <blockquote style="background-color:#FFECAF; padding:1em; border:1px solid #8FBC8F; font-size: 10pt"> <tt>Nota: Este documento se aplica a la …'
 
No edit summary
Line 61: Line 61:
{{End of Section}}
{{End of Section}}


==Check user capability==
==Comprobar las capacidades del usuario==


====Check user permissions====
====Comprobar permisos del usuario====


For Joomdle to connect to Moodle using Web services, a specific user must be created in Moodle, as defined above. Once defined this user must be given the appropriate access to the Web services protocol being used, XML-RPC. This is done by defining a role, assigning the user to that role and then granting that role access to the Web services. In this section, we show you how to:
Para que Joomdle pueda conectar con los servicios web de Moodle, debemos crear un nuevo usuario en Moodle, como hizimos antes. Una vez creado, debemos dar a este usuario el acceso apropiado a los servicios web XML-RPC. Hacemos este definiendo un nuevo rol, asignando al usuario a este rol, y dando a este rol el acceso a los servicios web. En esta sección te mostramos como:
* Check the permissions of existing users
* Comprobar los permisos de los usuarios existentes
* Create a new role
* Crear un nuevo rol
* Assign a specific user, eg. Joomdle Connector, to a given role
* Asignar a un usuario, ej. Joomdle Connector, a un rol


 
De la lista de tares de configuración, selecciona 4. Check user capability.  Elige al usuario que creaste para usar los servicios web, y pulsa el botón '''Show this user's permissions'''.
From the table click on 4. Check user capability.  Select the user who you have created to be the Web services user and press the '''Show this user's permissions''' button.




Line 77: Line 76:
[[File:Checkpermissions.png]]
[[File:Checkpermissions.png]]


Scroll down until you see XML-RPC and ensure this is set to yes. The background colour will have changed as well. In this case the background colour is light blue/green indicating it is set to yes in comparison to pink for no.
Baja hasta encontrar XML-RPC, y asegurate de que está a Si. También cambia el color de fondo. En este caso, el color de fondo es azul/verde claro, indicando que está a Sí, al contrario que los No, que están en rosa.


If it is not set to '''Yes''' you will need to do one or more of the following:
Si no está a '''' deberás hacer una o más de estas cosas:
* Create a new role
* Crear un nuevo rol
* Assign the user to the specific role
* Asignar el usuario al rol


[[File:Checkuserpermission.png]]
[[File:Checkuserpermission.png]]
Line 87: Line 86:
{{End of Section}}
{{End of Section}}


====Define a new role, to manage access to Joomdle Web services====
====Crear un nuevo rol, para controlar el acceso a los Servicios Web Joomdle====


To define a new role, go to Site Administration->Users->Permissions->Define roles, and click the 'Add a new role' button. Then enter a unique name, short name and description.  These should be something that you will recognise relating to Joomdle services.
Para definir un nuevo rol, ve a Site Administration->Users->Permissions->Define roles, y pulsa 'Add a new role'. Después, introduce un nombre único, un nombre corto y una descripción.  


[[File:newrole.png]]
[[File:newrole.png]]


Then, check 'System' as Context types where this role may be assigned.
Ahora, marca 'System' como tipos de contexto donde este rol puede ser asignado.


Scroll down looking through the Capability table and Allow (check):
Baja buscando en la tabla de Capabilities y Permite (marca):
* Use XML-RPC protocol
* Use XML-RPC protocol
* View discussions
* View discussions
Line 103: Line 102:
{{End of Section}}
{{End of Section}}


====Assign the user to the new role====
====Asigna el usuario al nuevo rol====


After you have created the new role, you will need to add your Joomdle Web services user (eg. joomdle connector) to this role.
Después de crear el nuevo rol, necesitarás añadir tu usuario de servicios web Joomdle (ej. joomdle connector) a este rol.


Go to Users->Permissions->Assign System roles, and select the new role.
Ve a Users->Permissions->Assign System roles, y selecciona el nuevo rol.




Line 114: Line 113:
{{End of Section}}
{{End of Section}}


==Add a new service==
==Añadir un nuevo servicio==


Next we must add a new "service" for Joomdle. This "service" will allow you to define what Joomdle can do inside Moodle. For example pulling course details information from Moodle or creating a new user in Moodle. This task is split into two tasks:
Ahora debemos añadir un nuevo "servicio" para Joomdle. Este "servicio" te permitirá definir que podrá hacer Joomdle en Moodle. Por ejemplo, obtener los detalles de un curso de Moodle o crear un nuevo usuario en Moodle. Esta tarea se divide en dos:
* Create a new service
* Crear un nuevo servicio
* Defining what functions this new service can perform (See the next section)
* Definir que funciones puede ejecutar este nuevo servicio (ver siguiente sección)


This is done in Site Administration->Plugins->Web services->External services
Esto se hace en Site Administration->Plugins->Web services->External services


[[File:newservice.png]]
[[File:newservice.png]]
Line 126: Line 125:
==Add functions to service==
==Add functions to service==


Normally, this would be the first time you are setting up Joomdle on this webserver. Therefore, it is assumed the '''Joomdle for Moodle''' has not been installed and you will not be able to perform this task at this time. Instead, this activity will be completed as part of the [[Installing Joomdle in Moodle 2|Installing Joomdle in Moodle 2.0]] task.
Normalmente, esta será la primera vez que estás instalando Joomdle. Así, se asume que '''Joomdle para Moodle''' no se ha instalado aún, y no podrás realizar esta tarea en este momento. En su lugar, esta actividad se completará como parte de la tarea [[Installing Joomdle in Moodle 2/es|Instalando Joomdle en Moodle 2.0]].
 




If Joomdle has already been installed, you can perform this task now. The details of this task can be found here [[Installing Joomdle in Moodle 2#Add_functions_to_service|Add Functions to Service]]
Si Joomdle ya está instalado, puedes realizar esta tarea ahora. Los detalles de la misma están en [[Installing Joomdle in Moodle 2/es#Add_functions_to_service|Añadir funciones al servicio]]


{{End of Section}}
{{End of Section}}

Revision as of 11:55, 1 November 2010

This document applies to Joomdle Release 2.0.0

Nota: Este documento se aplica a la preparación de Joomdle con Moodle 2.0+ Si estás instalando Joomdle para Moodle 1.9+ por favor consulta este documento Preparando Moodle 1.9+ para Joomdle

Requisitos previos de Moodle 2

Si estás instalando Moodle por primera vez, éste comprobará si la extensión XML-RPC para PHP está habilitada. Por favor, asegurate de que está instalada.

xmlrpc_check.jpg

Para obtener más información sobre PHP XML-RPC, consulta PHP XML-RPC Prerequisites


.

Configurando los Servicios Web de Moodle

Moodle 2.0 usa un nuevo sistema para la integración con aplicaciones externas, como Joomdle. Así, a partir de Moodle 2.0, deberás completar los pasos siguientes para integrar Joomdle con Moodle.


Para hacerlo más fácil, Moodle 2 tiene una lista de pasos que debes seguir para configurar los servicios web de Moodle. Puedes acceder aqui:


Site Administration->Plugins->Web services->Overview.


File:Wsoverview.png



.

Activar servicios web

Enable Web Services. Cambiar estado a Sí.

File:Enablews.png



.

Activar protocolos: XMLRPC

Joomdle usa XMLRPC para conectar con Moodle. Debes seleccionar el paso 2. Enable Protocols, de la lista y activa XMLRPC. Necesitarás asegurarte de que tu servidor dispone de soporte XMLRPC. Consulta Requisitos previos PHP para obtener más información.


File:Enablexmlrpc.png


.

Crea un usuario específico

Los servicios web de Moodle requieren de un usuario para la conexión con Joomdle.


Para configurar los servicios web de Moodle, es necesario definir un usuario específico, al que daremos los permisos adecuados para conectar con Moodle. Idealmente, este usuario debe ser usado unicamente para conectar Joomla con Moodle. No debe usarse como usuario en Joomla o Moodle, ni debe ser un usuario administrador. Por ejemplo, nosotros creamos un usuario llamado joomdle connector.


.

Comprobar las capacidades del usuario

Comprobar permisos del usuario

Para que Joomdle pueda conectar con los servicios web de Moodle, debemos crear un nuevo usuario en Moodle, como hizimos antes. Una vez creado, debemos dar a este usuario el acceso apropiado a los servicios web XML-RPC. Hacemos este definiendo un nuevo rol, asignando al usuario a este rol, y dando a este rol el acceso a los servicios web. En esta sección te mostramos como:

  • Comprobar los permisos de los usuarios existentes
  • Crear un nuevo rol
  • Asignar a un usuario, ej. Joomdle Connector, a un rol

De la lista de tares de configuración, selecciona 4. Check user capability. Elige al usuario que creaste para usar los servicios web, y pulsa el botón Show this user's permissions.


Baja hasta encontrar XML-RPC, y asegurate de que está a Si. También cambia el color de fondo. En este caso, el color de fondo es azul/verde claro, indicando que está a Sí, al contrario que los No, que están en rosa.

Si no está a deberás hacer una o más de estas cosas:

  • Crear un nuevo rol
  • Asignar el usuario al rol


.

Crear un nuevo rol, para controlar el acceso a los Servicios Web Joomdle

Para definir un nuevo rol, ve a Site Administration->Users->Permissions->Define roles, y pulsa 'Add a new role'. Después, introduce un nombre único, un nombre corto y una descripción.

Ahora, marca 'System' como tipos de contexto donde este rol puede ser asignado.

Baja buscando en la tabla de Capabilities y Permite (marca):

  • Use XML-RPC protocol
  • View discussions

File:Capabilities.png


.

Asigna el usuario al nuevo rol

Después de crear el nuevo rol, necesitarás añadir tu usuario de servicios web Joomdle (ej. joomdle connector) a este rol.

Ve a Users->Permissions->Assign System roles, y selecciona el nuevo rol.



.

Añadir un nuevo servicio

Ahora debemos añadir un nuevo "servicio" para Joomdle. Este "servicio" te permitirá definir que podrá hacer Joomdle en Moodle. Por ejemplo, obtener los detalles de un curso de Moodle o crear un nuevo usuario en Moodle. Esta tarea se divide en dos:

  • Crear un nuevo servicio
  • Definir que funciones puede ejecutar este nuevo servicio (ver siguiente sección)

Esto se hace en Site Administration->Plugins->Web services->External services

File:Newservice.png

Add functions to service

Normalmente, esta será la primera vez que estás instalando Joomdle. Así, se asume que Joomdle para Moodle no se ha instalado aún, y no podrás realizar esta tarea en este momento. En su lugar, esta actividad se completará como parte de la tarea Instalando Joomdle en Moodle 2.0.


Si Joomdle ya está instalado, puedes realizar esta tarea ahora. Los detalles de la misma están en Añadir funciones al servicio


.

Add user as authorized user for the service

Now that we have created a new service and added the appropriate functions (All Joomdle functions), we need to authorise / grant the Joomdle Web services 'user' to the newly created service. This is done in:

Site Administration->Plugins->Web services->External services

Click on Authorized users for the new service and add the Joomdle Web services user we created before.


.

Create token

The final step is to create a token which will be entered in Joomdle configuration page in the Joomdle Joomla component. Without this token, even if everything is configured in Moodle, Joomla and Joomdle correctly, Joomdle will not be able to connect with Moodle.

In the Moodle Administration menu:

Site Administration->Plugins->Web services->Manage tokens, click on Add.

File:Addtoken.png


Select the user and the service we created, and Save.

File:Tokens.png


You will get a new token, to enter in Joomdle's component configuration in Joomla. Refer to this page for entering the token in Joomdle.