26/Subir usuarios

Moodle 2.6

Moodle 2.x

Nota del traductor: Esta documentación corresponde a Moodle 2.6 y anteriores. Si Usted quiere ver la versión más reciente, para Moodle 2.7 y siguientes, vaya a Subir usuarios.

Un administrador puede subir múltiples cuentas de usuarios mediante un archivo de texto en Administración > Administracón del sitio > Usuarios > Cuentas > Subir usuarios.

Existen muchas opciones robustas para subir información (campos asociados con un usuario) con este método: desde inscribir (matricular) usuarios en múltiples cursos con roles específicos del curso, hasta actualizar la información del usuario en el Perfil de usuario para eliminar usuarios del sitio.

En lugar de subir el el archivo de texto, puede simplemente arrastrarlo desde el escritorio de su computadora casera y soltarlo dentro del área de subida, como se demuestra en el screencast Drag and drop new users into Moodle 2.3 (by Mary Cooch).

Tip: Usualmente no es necesario subir usuarios en masa con la opción para subir usuarios; para tener bajo trabajo de mantenimiento, Usted debería de explorar primeramente formas de Autenticación que no requieran mantenimiento manual, tales como Autenticación con BasedeDatos externa o permitirles a los usuarios que creeen sus propias cuentas con Auto inscripción). Vea Autenticación para mayor información.

Pantalla inicial para subir usuarios

Proceso para subir usuarios

Aquí hay una descripción del proceso:

1. Crear el archivo a subir
2. Ir a Configuraciones > Administración del sitio > Usuarios > Cuentas > Subir usuarios
3. Añadir el archivo a subir. Es muy importante que el delimitador CVS seleccionado sea el mismo caracter (, ; :) que Usted usó en el archivo CVS)
4. Vista previa de subida de usuarios - revisar configuraciones y configuraciones del perfil de usuario por defecto
5. Vista previa de subida de usuarios - elegir "Subir usuarios (Upload users)"
6. Resultados de subida de usuarios - muestra lista de usuarios, las excepciones hechas al subirlos y un resumen acerca del número de usuarios
7. Resultados de subida de usuarios - elegir "Continuar"
8. Regresa a la pantalla para Subir usuarios

Vista previa al actualizar usuarios

Hay varias configuraciones para un mejor control del comportamiento al subir deseado. Estas configuraciones se encuentran en la página de "Vista previa de Subir usuarios (Upload users preview)".

Vista previa para subir usuarios en Moodle 2.x

Configuraciones

Por defecto, Moodle añade nuevas cuentas de usuarios y se salta a los usuarios existentes en donde el username coincida con una cuenta existente. Configurar el "Tipo de subida (Upload Type)" a Agregar nuevos y actualizar usuarios existentes, y las cuentas de los usuarios existentes serán actualizadas.

• Agregar todo, añadir contador a nombres_de_usuarios si fuera necesario.
• Actualizar sólo usuarios existentes
• Actualizar sólo usuarios existentes

Advertencia: los errores al actualizar las cuentas existentes pueden afectar muy negativamente a sus usuarios. Sea cuidadoso al usar las opciones que permiten actualizar.

Opciones adicionales

También existen configuraciones de campos para forzar a que se haga un cambio de contraseña, permitir renombrados, permitir eliminaciones, impedir duplicados de cuentas de Email, estandarizar nombres_de_usuarios ( usernames ) y seleccionar para operaciones masivas (usuarios nuevos, actualizar usuarios, todos los usuarios).

• Estandarizar nombres_de_usuarios ( usernames ) - Esto convierte los nombres_de_usuarios (username) a minúsculas y remueve los caracteres ilegales. Esto es equivalente en grandes rasgos, a:

 $username = preg_replace('/[^-\.@_a-z0-9]/', , $username);

Configurar valores de usuario por defecto

Usted puede configurar valores para campo de usuario por defecto, si los campos no fueran incluidos dentro del archivo a subir en esta página.

Resultados de la subida de usuarios

Después de aceptar las configuraciones de la vista previa al elegir "Subir usuarios", Usted debería de ver la pantalla de resultados de la subida de usuarios.

La pantalla de resultados; ¡todo salió bien!

Esta pantalla mostrará cualquier excepción o cambios que hubieran sido realizados a cada usuario durante el proceso de subida. Por ejemplo, si Usted estuviera actualizando información del usuario, se mostrará la información actualizada. O si un usuario no hubiese sido añadido, ese registr estará resaltado.

La pantalla resumirá cuantos usuarios fueron subidos o actualizados, indicará el número de contraseñas débiles y el número de errores.

Formatos de archivo para 'archivo para subir usuarios'

El archivo usado para subir usuarios tiene campos separados por comas (o algun otro delimitador) SOLAMENTE - sin espacios. La primera línea contiene los nombres de campo válidos. El resto de las líneas (registros) contienen información acerca de cada usuario.

:Tip: Evite el empleo de caracteres especiales en la información de los campos, tales como símbolos de comillas o más comas. Haga una prueba con solamente un registro antes de una subida grande. Recuerde que existen otras maneras de autenticar usuarios en su sitio, o para inscribir (matricular) usuarios dentro de un curso.

:Tip: Usted podría usar un programa de hoja de cálculo (spreadsheet) para crear el archivo con las columnas y los campos requeridos. Después, guarde dicho archivo como un archivo de tipo "CSV (delimitado por coma 0 comma delimited)". Estos archivos pueden abrirse facilmente con editores de texto simple para verificarlos (se recomienda usar Notepad++ en lugar del Notepad estándard incluido con Windows).

Archivo válido para probar subida

Aquí hay un ejemplo de un archvo válido (sin errores) para subir usuarios, que usted puede copiar y pegar en Notepad++ (Los encabezados de las columnas en la primera línea del archivo solamente están resaltados en negritas en este ejemplo para distinguirlos del resto de los detalles de los datos de los usuarios):

username,password,firstname,lastname,email,course1,group1,cohort1
jonest,vmuysecreto,Tom,Jones,jonest@someplace.edu,math102,Seccion 1,semestre 3
reznort,unsecreto,Trent,Reznor,reznort@someplace.edu,math102,Seccion 3,semestre 4

Campos que pueden incluirse

:Tip: Nosotros le recomendamos encarecidamente que haga una prueba con un archivo que contenga los campos que Usted se propone usar, pero con solamente un usuario (una línea de datos) antes de intentar por primera vez el subir usuarios por archivo. El sitio http://demo.moodle.net podría ser un buen lugar para experimentar (probar) si su archivo de trabajo funciona.

• Campos requeridos obligatorios:

username,firstname,lastname,email

Se realizan revisiones para validación para:

1. username solamente puede contener caracteres de letras del alfabeto 'minúsculas, números, guión '-', guión bajo de subrayado (underscore) '_', punto '.', o el signo de arroba '@'
2. email estará en la foma de: nombre@ejemplo.com .

• Campo de contraseña: el campo de "password" es opcional si se elige la configuración para " Crear contraseña si es necesario " (opción por defecto).
  • Si se incluyen, los valores deben de cumplir con los requisitos para la Política de contraseñas del sitio. Para forzar a que se realice un cambio de contraseña para un usuario particular, configure el campo de contraseña (password) a changeme (cámbiame).
  • Si se omite, se generará una contraseña para cada usuario (durante el siguiente trabajo del Cron y se enviarán Emails de biuenvenida al sitio.
  • Nota: el texto para el Email de bienvenida al sitio se encuentra dentro de las configuraciones del Idioma. Por favor vea el hilo del foro forum thread para ver los detalles al respecto.

• Campos opcionales: Para proporcionar valores diferentes a los que se usan por defecto, incluya alguno de los siguientes:

institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,htmleditor,autosubscribe

• Campos de nombre adicionales
• Country (país)- use el CÓDIGO DE DOS LETRAS PARA SU PAÍS (ES=España, MX=México, ... es el mismo código de internet para los sitios de cada nación).
• Algunos campos tienen un número máximo de caracteres permitidos (particularmente, institution deberá de ser cuando máximo de 40 caracteres de largo). Vea sugerencias más adelante...
• Maildisplay, htmleditor y autosubscribe pueden configurarse desde una pantalla de importación.

• Nombres de campo de perfil personalizado: (Opcional). donde xxxxx es el nombre del campo del perfil de usuario personalizado real (por ejemplo, el nombre_corto único)

profile_field_xxxxx

Cree el campo personalizado ANTES de hacer la importación. Use el encabezado estándar. El (nombre_corto) "shortname" para su campo de usuario es xxxxx (Nota importante: el nombre_corto ( shortname ) debe estar todo en minúsculas, o de lo contrario no será reconocido). El primer registro deberá de incluir "profile_field_xxxxx".

Ejemplo: Para crear un campo personalizado de género, Usted debe de incluir un nombre_corto "genero" (sin acento) en el nuevo campo, y escribir "profile_field_genero" en el encabezado de su archivo .CSV

Para campos personalizados de perfil que sean fechas, use el formato estándar ISO YYYY-MM-DD (año con 4 dígitos-mes con 2 dígitos-día con 2 dígitos), por ejemplo: 2014-06-19 el cual será presentado en el formato local de manera adecuada en la interfaz.

¡Nueva característica
en Moodle 2.3!

Moodle 2.7

Moodle 2.6

Moodle 2.5

Moodle 2.4

Moodle 2.3

Para los campos de perfil personalizados que son un menú, use el valor correspondiente.

Ejemplo: Un campo personalizado 'Departamento' con uno de tres valores posibles 'RH', 'Ventas' o 'Entrenamiento'. Solamente inserte una de las tres palabras descritas (por ejemplo: 'Entrenamiento') como el valor para ese campo.

• Campos especiales: Usados para cambiar los nombres_de_usuario ( usernames ) o para eliminar usuarios

oldusername, deleted

• Campos de Inscripción: (Opcional):

course1,type1,role1,group1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enrolperiod2,enrolstatus2 etc.

• Los campos del encabezado deben de tener un sufijo numérico tal que type1,role1,group1,enrolperiod1 y enrolstatus1 todos aplican a course1 para course1 hasta coursen.
• course es el "nombre_corto" del curso, si está presente el usuario será inscrito (matriculado) en ese curso.
• type configura el rol a usarse para la inscripción. Un valor de 1 es el rol del curso por defecto, 2 es el rol heredado (antiguo) de Profesor y 3 es el Profesor-sin-derechos-de-edición heradado (antiguo).
• role puede usarse para especificar directamente roles, usando, ya sea nombre_corto o id (nombres numéricos de roles no están soportados).
• group puede usarse para asignar usuarios a grupos en curso, usando nombre (name) o id (los nombres numéricos de grupos no están soportados)
• enrolperiod puede usarse para configurar la duración de la Inscripción (matriculación), en días, para cada curso.
• enrolstatus puede suspender usuarios de un curso cuando se configura a 1 o se deja vacío para inscritos.

Moodle 2.6

• Usted puede suspender usuarios de cursos al usar el campo de enrolstatus (status_de_inscripción), donde un 1 para un usuario significa que está suspendido (y dejarlo vacío significa que todavía continúa inscrito/matriculado).

• Campo de Cohorte: (Opcional):

cohort1

Para las cohortes existentes, use los números ID internos de las cohortes o ID de cohortes no-numéricos.

¡Nueva característica
en Moodle 2.8!

Si Usted usa el nombre de una cohorte, entonces ésta será creada cuando Usted suba el archivo CSV.

• mnethostid (Opcional)

Los usuarios existentes de MNet pueden añadirse a cursos, grupos o cohortes, según se ve debajo:

1. inscribir a cursos: username+mnethostid+course requeridos
2. añadir a grupo: username+mnethostid+course+group requeridos
3. añadir a cohorte: username+mnethostid+cohort requeridos
4. suspender/revivir cuentas: username+mnethostid+suspended requeridos

Todas las demás operaciones son ignoradas. Usted no puede añadir usuarios, eliminarlos ni actualizarlos (como cambiarles nombres o Email, campos de perfil, etc).

Las comas dentro de un campo deben de codificarse como &#44 - el script las decodificará de regreso a comas.

Para campos Booleanos (cierto o falso), use 0 para falso y use 1 para verdadero.

Para impedir que los usuarios reciban muchos Emails de los foros o foros de suscripcion forzosa, use maildigest. Las opciones para este campo son 0 = Sin resumenes, 1 = Resumenes completos y 2 = Resumen con solamente los asuntos.

Posibilidades avanzadas para Subir usuarios

Plantillas

Nota: Esta sección requiere revisión y actualización si fuera necesaria para Moodle 2.0. Por favor, corríjala y elimine esta nota cuando termine.

Los valores por defecto son procesados como plantillas en las cuales están permitidos los siguientes códigos:

• %l - será remplazado por el lastname (apellido(s))
• %f - será remplazado por el firstname (nombre(s))
• %u - será remplazado por el username (nombre_de_usuario)
• %% - será remplazado por el  %

Entre el signo de porcentaje (%) y cualquiera de las letras código (l, f , u) se permiten los siguientes modificadores:

• (-) signo de menos - la información especificada por la letra código será convertida a minúsculas
• (+) signo de más - la información especificada por la letra código será convertida a MAYÚSCULAS
• (~) tilde - la información especificada por la letra código será convertida a Mayúsculas Para Letras Iniciales
• un número decimal - la información especificada por la letra código será truncada a ese número de caracteres

Por ejemplo, si el nombre (firstname) fuera Juanito y el Apellido Camaney, los siguientes valores se obtendrán con las plantillas especificadas:

• %l%f = CamaneyJuanito
• %l%1f = CamaneyJ
• %-l%+f = camaneyJUANITO
• %-f_%-l = juanito_camaney
• http://www.ejemplo.com/~%u/ resulta en http://www.ejemplo.com/~jdoe/ (si el nombre_de_usuario ( username ) es jcamaney o %-1f%-l)

El procesamiento de plantillas se realiza solamente sobre los valores por defecto, y no sobre los valores obenidos a partir del archivo CSV.

Para poder crear correctamente nombres_de_usuarios ( usernames ) de Moodle, el username siempre es convertido a minúsculas. Aun más, si la opción para "Permitir caracteres extendidos en nombres_de_usuarios ( Allow extended characters in usernames )" dentro de las Políticas del sitio estuviera desactivada, los caracteres diferentes a las letras, dígitos, guión (-) y punto (.) son removidos. Por ejemplo, si el nombre fuera Juanito Jr. y el apellido es Camaney, el nombre_de_usuario ( username ) %-f_%-l producirá juanito jr._camaney cuando está activado el "Permitir caracteres extendidos en nombres_de_usuarios", y produciría juanitojr.camaney si estuviera desactivado.

Cuando la configuración para "Manejo de duplicados en nuevos nombres_de_usuarios" está configurada en "Añadir contador a nombres_de_usuarios si fuera necesario", se añadirá un contador auto-incrementablea los nombres_de_usuario duplicados producidos por la plantilla. Por ejemplo, si el archivo CSV contiene los usuarios llamados John Doe, Jane Doe and Jenny Doe sin nombres_de_usuarios explícitos, el nombre_de_usuario por defecto es %-1f%-l ay el manejo de Nuevos nombres_de_usuario duplicados está configurado a Añadir contador, entonces los nombres_de_usuario producidos serán jdoe, jdoe2 y jdoe3.

Eliminar cuentas

Si el campo de deleted está presente, los usuarios que lo tengan con valor de 1 serán eliminados. En este caso, todos los campos pueden omitirse, excepto por username. Después de subir el archivo, asegúrese de cambiar el "Tipo de subida " a "Solamente actualizar usuarios existentes" y la opción para "Permitir eliminaciones" a "Si".

Tip: Hay un campo similar disponible para suspended. Esto permite que una cuenta de usuario sea deshabilitada temporalmente en lugar de removerla completamente.

El eliminar y actualizar cuentas puede hacerse con un solo archivo CSV. Por ejemplo, el archivo siguiente añadirá al usuario Tom Jones y eliminará al usuario reznort:

username,firstname,lastname,deleted
jonest,Tom,Jones,0
reznort,,,1

Codificación del formato del archivo

En la pantalla inicial para Subir usuarios, Usted puede seleccionar el formato para la codificación del archivo a partir de un menú desplegable. Entre las opciones se incluyen UTF-8 (la opción por defecto), ASCII, ISO-8859-1 a ISO-8859-11 o uno cualquiera de los más de 36 formatos existentes.

Sugerencias

Hoja de cálculo

Si Usted usa un programa de hoja de cálculo (spreadsheet), como por ejemplo, Excel, para crear su archivo .csv le conviene revisar la salida resultante en un editor de texto (Notepad++) antes de subir dicho archivo. Con frecuencia aparecen comas en exceso cuando quedó un campo vacío si Usted añadió o eliminó columnas de información antes de guardar el archivo final. También le conviene revisar la codificación de caracteres. Un archivo csv es un archivo de texto plano (texto simple) ya sea ASCII o Unicode, que puede usarse para subir cuentas de usuario.

Excel traduce las contraseñas que comiencen con - (menos) o + (más) como ceros. Aun y cuando lo guarde como .csv y que le diga "Sí" a "Conservar este formato y quitar las características incompatibles (Keep this format, and leave out any incompatible features)." Revise ésto antes de subirlo, porque un cero detendrá el proceso de subida.

Si Usted usa una fórmula en Excel para crear los campos (por ejemplo, la función de concatenación ( concatenate function ) para crear un nombre de usuario), entonces debe recordar copiar las celdas con la fórmula y usar el pegado especial con valores revisados para hace rlos datos aceptables para un archivo CSV.

La subida también fallará si Usted tuviera espacios de más ( trailing spaces ) al final de sus campos de datos. A menudo, estos espacios excesivos no ueden removerse facilmente mediante la función de buscar " " y remplazar con "". Si se ha copiado información proveniente de la web, es posible que se hayan incluido espacios que no se separan ( non-breaking spaces ), lo que impedirá que su subida de datos se complete correctamente. Para encontrar estos espacios invisibles, use la función de Excel para Buscar y Remplazar; en el campo de buscar mantenga presionada la tecla Alt y escriba 0160. Deje el campo de remplazar vacío.

País

El país debe de escribirse como un código de dos letras, en MAYÚSCULAS. Por ejemplo, use BE para Bélgica, NL para Países Bajos (Netherlands). Si Usted erroneamente intenta usar "be" o "nl" como códigos de país, estos códigos de país ocasionarán un error en la BasedeDatos.

Tip: España= ES, México=MX, Colombia=CO, Argentina=AR, Chile=CL...

Tip: Si tiene problemas para recordar el código de dos letras para cada país, consulte la lista country names and code elements disponible en el sitio web de ISO. Un error común para los angloparlantes es usar UK para el Reino Unido de la Gran Bretaña, que debería de escribirse GB.

Límites al tamaño del campo

Algunos campos tienen longitudes máximas de caracteres. Típicamente, el archivo permitirá la importación hasta la pantalla de vista previa a la importación, pero no se terminará el proceso. Si activa el modo de depuración de errores (debugging) , verá los campos que son demasiadolargos. Algunos campos que comunmente causan estos errores son "Institution" que está limitado a 40 carcteres, y "City", que está limitado a solamente 20 caracteres. El error será "Error - Usuario no añadido (User not added - error)".

Zonas horarias

La entrada es sensible a MAYÚSCULAS/minúsculas, por lo que Europe/London funcionará, pero europe/london no funcionará.

Todos los campos enlistados aquí

Todos los campos válidos se enlistan debajo, exceptuando a los campos personalizados que Usted hubiese creado.

firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe ,institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername , deleted, suspended, course1, course2, course3, course4

Inscribir (matricular) usuarios a Cohortes (grupos del sistema)

Usted puede inscribir (matricular) usuarios a cualquier cohorte (grupo a nivel del sistema) al usar solamente "username" y la "Cohort ID". Aquí hay un archivo CSV de ejemplo:

username,cohort1
maestro1,maestros-del-sistema
maestro2,maestros-del-sistema
maestro3,maestros-del-sistema

Asegúrese de configurar el "Tipo de subida" a "Solamente actualizar usuarios existentes" (Para que así no le pidan añadir también los campos de nombre, apellido(s) y Emails)

Vea también

• Inscripción mediante Archivo plano
• Campos de perfil de usuario para detalles sobre cómo incluir datos acerca de campos de perfil de usuario en el archivo para subir usuarios
• Adding users by using a CSV in Moodle MoodleBites video en YouTube
• Subir cursos (nuevo en 2.6)

Using Moodle forum discussions:

• Can I auto enroll from Excel?
• Uploading users to custom roles
• User upload option: standardise usernames
• Matriculacion con flat file csv - discussion in Spanish