Saltar al contenido principal

Asignación masiva de roles por categoría

Esta guía explica cómo preparar y cargar un archivo CSV utilizando la herramienta Subir usuarios de Moodle para realizar la asignación masiva de roles a nivel de categoría usando las columnas especiales:

  • category{roleid}
  • categoryrole{roleid}

En este ejemplo se utiliza un rol personalizado con permisos de creación de cursos con IA (createcourseai). Sin embargo, este mismo proceso puede aplicarse a cualquier rol requerido por otros plugins de la suite Datacurso IA.

Requisitos previos

Antes de preparar el archivo CSV, asegúrese de que:

  • Cada categoría de curso tenga definido un Número ID de categoría (idnumber).
  • Conozca el roleid del rol que desea asignar.
  • El rol ya esté creado en Moodle.

Configurar el Número ID de categoría

Cada categoría debe tener configurado un Número ID. Este valor se utilizará en el archivo CSV.

  1. Vaya a: Administración del sitio > Cursos > Administrar cursos y categorías

    Administrar categorías

  2. En el menú de acciones de la categoría, haga clic en Editar.

    Editar categoría

  3. En el campo Número ID de la categoría, ingrese un valor (por ejemplo: 123) y guarde los cambios.

    Configurar idnumber

Obtener el ID del rol (roleid)

Necesita el roleid interno para construir correctamente los nombres de las columnas del CSV.

  1. Vaya a: Administración del sitio > Usuarios > Permisos > Definir roles

    Administrar roles

  2. Abra el rol que desea asignar (por ejemplo, createcourseai).

    Abrir rol

  3. En la URL del navegador, ubique el parámetro:

    roleid=XX

    Ejemplo:

    roleid=11

    Roleid

El valor numérico corresponde al roleid.

Estructura del CSV

Su archivo CSV debe contener uno de los siguientes campos para identificar al usuario:

  • username
  • email

Columnas requeridas para la asignación de roles por categoría

Reemplace {roleid} con el ID numérico del rol.

  • category{roleid}
    El Número ID de la categoría (idnumber) configurado en la categoría.

  • categoryrole{roleid}
    El nombre corto del rol (por ejemplo: createcourseai).

Ejemplo (si roleid = 11):

emailcategory11categoryrole11
[email protected]123createcourseai
[email protected]1234createcourseai

Puede descargar un archivo CSV de ejemplo aquí.

En este ejemplo:

  • 123 es el idnumber de la categoría
  • 1234 es otro idnumber de categoría
  • createcourseai es el nombre corto del rol

Este ejemplo utiliza un rol personalizado con permisos de creación de cursos con IA. La misma estructura se aplica si necesita asignar roles requeridos por otros plugins de Datacurso IA.

Asignar múltiples roles en el mismo archivo CSV

El archivo CSV puede asignar más de un rol a nivel de categoría en una sola carga.

Para hacerlo, debe repetir la misma estructura de columnas para cada rol adicional, utilizando el roleid correspondiente.

Para cada rol, debe incluir:

  • category{roleid}
  • categoryrole{roleid}

Cada par de columnas funciona de forma independiente.

Ejemplo: Asignar dos roles diferentes

Suponga:

  • Rol createcourseairoleid = 11
  • Rol createactivityairoleid = 12
  • Número ID de categoría (idnumber) = 123

Su archivo CSV se vería así:

emailcategory11categoryrole11category12categoryrole12
[email protected]123createcourseai123createactivityai
[email protected]123createcourseai123createactivityai

Puede descargar este archivo CSV de ejemplo con múltiples roles aquí.

En este ejemplo:

  • category11 y categoryrole11 asignan el rol createcourseai
  • category12 y categoryrole12 asignan el rol createactivityai
  • Ambos roles se asignan en la misma categoría (idnumber = 123)

Puede repetir esta estructura para tantos roles como sea necesario, siempre:

  1. Obteniendo el roleid correcto
  2. Utilizando exactamente el nombre corto del rol
  3. Verificando que el idnumber de la categoría sea correcto

Esto le permite asignar múltiples roles al mismo usuario (o distintos roles a diferentes usuarios) en una sola carga de CSV.

Subir usuarios para asignar roles

Para cargar el archivo CSV y asignar los roles:

  1. Vaya a:

    Administración del sitio > Usuarios > Cuentas > Subir usuarios

    Menú Subir usuarios

  2. En la página Subir usuarios:

    • Seleccione su archivo CSV.
    • Asegúrese de que el Separador CSV esté configurado como ,
    • La codificación debe permanecer con el valor predeterminado (normalmente UTF-8).

    Formulario Subir usuarios

  3. Haga clic en Subir usuarios.

    Botón Subir usuarios

Configurar ajustes de carga (pantalla de vista previa)

Después de cargar el archivo, Moodle mostrará la pantalla Vista previa de subida de usuarios.

Debe verificar que las siguientes configuraciones estén establecidas exactamente como se muestra:

  • Tipo de subida: Actualizar solo usuarios existentes

  • Detalles del usuario existente: Sin cambios

  • Coincidencia por dirección de correo electrónico:

  • Deje el resto de las opciones con sus valores predeterminados, salvo que su organización requiera lo contrario.

    Configuración vista previa subida
usuarios

Luego desplácese hasta la parte inferior y haga clic en Subir usuarios.

Botón Subir usuarios vista previa

Resultados de la subida de usuarios

Después de hacer clic en Subir usuarios, Moodle mostrará una pantalla de resultados similar a la siguiente:

Resultados Subir usuarios

Esta página muestra:

  • Los usuarios procesados desde el archivo CSV
  • Su estado (actualizado o asignado)
  • Cualquier posible error

Si todo es correcto, haga clic en Continuar para completar el proceso.

Continuar resultados Subir
usuarios

Verificar la asignación de roles por categoría

Para confirmar que los usuarios fueron correctamente asignados al rol en cada categoría:

  1. Vaya a:

    Administración del sitio > Cursos > Administrar cursos y categorías

    Administrar categorías

  2. En la categoría donde se asignó el rol, abra el menú de acciones y haga clic en Permisos.

    Permisos categoría

Por defecto, la vista se abre en la pestaña Permisos.

  1. Cambie el desplegable de Permisos a Asignar roles.

    Desplegable Asignar roles

Confirmar usuarios asignados

Ahora verá la lista de roles disponibles en esa categoría y los usuarios asignados a cada rol.

Por ejemplo:

  • En Categoría 1, el usuario [email protected] está asignado al rol createcourseai.
  • En Categoría 2, el mismo usuario también está asignado al rol createcourseai.

Roles asignados en Categoría
1

Roles asignados en Categoría
2

Esto confirma que la asignación masiva de roles mediante CSV se realizó correctamente.

Consideraciones importantes

  • Si el usuario no aparece bajo el rol esperado, verifique:
    • Que el valor category{roleid} coincida con el Número ID de categoría correcto.
    • Que el valor categoryrole{roleid} coincida exactamente con el nombre corto del rol.
  • Si el Número ID de categoría es incorrecto, la asignación no se aplicará a la categoría prevista.
  • Este proceso de verificación funciona para cualquier rol asignado a nivel de categoría, no solo para roles relacionados con IA.

Esto completa el proceso de asignación masiva de roles por categoría.