Diferencia entre revisiones de «Archivo plano»

De MoodleDocs
({{Pendiente de traducir}})
(updated as per 3.0 Docs)
Línea 3: Línea 3:
{{Notadeltraductor|La palabra inglesa [https://docs.moodle.org/26/en/Enrolments enrolments] se tradujo al [[Español internacional]] como [[Matriculaciones|matriculaciones]] y en el [[Español de México]] como [[Inscripciones]].}}
{{Notadeltraductor|La palabra inglesa [https://docs.moodle.org/26/en/Enrolments enrolments] se tradujo al [[Español internacional]] como [[Matriculaciones|matriculaciones]] y en el [[Español de México]] como [[Inscripciones]].}}


Localización: Enlace hacia configuraciones para archivo plano en '' Administración del sitio > Plugins > Inscripciones > Gestionar plugins de inscripción''
__NOTOC__The flat file enrolment plugin allows bulk enrolment management (enrol or unenrol) of existing users in existing course via a CSV file.


Un archivo plano '''[[CSV]]''' permite gestionar la inscripción (matriculación) y des-inscripción masiva de usuarios existentes a un curso existente. El archivo es leido una sola vez por Moodle y después es borrado. El archivo está localizado dentro de la estructura de archivos de Moodle como un archivo de texto y [[Cron]] proporciona el tiempo cuando es leido.
{{Nuevas características de Moodle 3.0}}The file is processed by the Flat file enrolment sync [[Scheduled tasks|scheduled task]] (new in Moodle 3.0; previously the legacy cron function was used) and then deleted.


==Opciones==
El administrador del sitio debería de editar las opciones para un archivo plano si está habilitado.


[[Image:EnrolSettngsFlatFile_2.0 SPANISH.png|600px]]
The file should include action, role, user ID number, and course ID number; start time and end time are optional fields. Details of the file format are shown on the flat file settings page ''Site administration > Plugins > Enrolments > Flat file (CSV)''.


Usted debería de especificar una ruta absoluta para el archivo a subir (por ejemplo: /var/moodledata/enrolments.txt) en donde pueda ser leido y modificado por el proceso del servidor web.
==Enabling flat file enrolment==


Usted puede elegir que le envíen un Email para notificar al Administrador, a los Profesores o a los Estudiantes cuando este archivo haya sido procesado.
An administrator can enable flat file enrolment as follows:


==Estructura del archivo plano==
# Go to ''Site administration > Plugins > Enrolments > Manage enrol plugins'' and click the eye icon opposite Flat file (CSV). When enabled, it will no longer be greyed out.
El archivo debería de estar estructurado con la acción, el rol, ID del usuario y con número ID del curso. Opcionalmente, se pueden añadir una hora de inicio y de término como campos adicionales.
# Click the settings link, configure as required (see details of settings below), then click the 'Save changes' button.


Archivo de ejemplo:
===File location===


add, student, 5, CF101
You should specify an absolute path for the upload file (eg /var/moodledata/enrolments.txt) where it can be read and modified by the web server process. The file is automatically deleted after processing.
add, teacher, 6, CF101
add, teacheredit, 7, CF101
del, student, 8, CF101
del, student, 17, CF101
add, student, 21, CF101, 1091115000, 1091215000


'''Nota''': Estos campos usan palabras clave en idioma inglés por defecto; pero Usted puede configurar el mapeo de roles para archivo plano en '' Administración del sitio > Plugins > Inscripciones > Gestionar plugins de inscripción'':
===File encoding===
[[Archivo:Mapeo de roles en archivo plano.png|400px]]
 
Make sure, you save the file (for example in a text editor) with the same encoding.
 
===Notification===
 
You can choose to have an email sent to notify the Administrator, Teachers and/or students when the file has been processed.
 
===Unenrolment action===
*"Unenrol user from course" When the user disappears from the external source, the enrolment is completely removed and all the roles removed. This means some user data and settings are purged from course during course unenrolment (that usually include grades, activity attempts, etc.)
*"Keep user enrolled" When the user disappears from the external source, the enrolment is kept as is, and the user is still able to enter the course and perform activities, access resources, etc. It's a "do nothing" option.
*"Disable course enrolment and remove roles" When the user disappears from the external source, the enrolment is suspended and roles assigned by enrol instance are removed. Please note that user may "disappear" from gradebook and other areas.
 
==¿Preguntas?==
 
Please post in the [http://moodle.org/mod/forum/view.php?id=2981 Enrolment forum] on moodle.org.


==Vea también==
==Vea también==

Revisión del 23:38 28 feb 2016

Esta página necesita actualizarse con la información existente en la documentación vigente/moderna/actualizada en el idioma inglés original para Moodle. Se le sugiere al lector que consulte la página original en idioma inglés cuyo enlace está al fondo de esta página. y que, por favor, actualice esta información y quite la plantilla {{Actualizar}} cuando haya terminado.     (otras páginas pendientes de actualizar)

Nota: Pendiente de Traducir. ¡Anímese a traducir esta página!.     ( y otras páginas pendientes)

translator note icon.png Nota del traductor: La palabra inglesa enrolments se tradujo al Español internacional como matriculaciones y en el Español de México como Inscripciones.


The flat file enrolment plugin allows bulk enrolment management (enrol or unenrol) of existing users in existing course via a CSV file.

¡Nueva característica
en Moodle 3.0!
The file is processed by the Flat file enrolment sync scheduled task (new in Moodle 3.0; previously the legacy cron function was used) and then deleted.


The file should include action, role, user ID number, and course ID number; start time and end time are optional fields. Details of the file format are shown on the flat file settings page Site administration > Plugins > Enrolments > Flat file (CSV).

Enabling flat file enrolment

An administrator can enable flat file enrolment as follows:

  1. Go to Site administration > Plugins > Enrolments > Manage enrol plugins and click the eye icon opposite Flat file (CSV). When enabled, it will no longer be greyed out.
  2. Click the settings link, configure as required (see details of settings below), then click the 'Save changes' button.

File location

You should specify an absolute path for the upload file (eg /var/moodledata/enrolments.txt) where it can be read and modified by the web server process. The file is automatically deleted after processing.

File encoding

Make sure, you save the file (for example in a text editor) with the same encoding.

Notification

You can choose to have an email sent to notify the Administrator, Teachers and/or students when the file has been processed.

Unenrolment action

  • "Unenrol user from course" When the user disappears from the external source, the enrolment is completely removed and all the roles removed. This means some user data and settings are purged from course during course unenrolment (that usually include grades, activity attempts, etc.)
  • "Keep user enrolled" When the user disappears from the external source, the enrolment is kept as is, and the user is still able to enter the course and perform activities, access resources, etc. It's a "do nothing" option.
  • "Disable course enrolment and remove roles" When the user disappears from the external source, the enrolment is suspended and roles assigned by enrol instance are removed. Please note that user may "disappear" from gradebook and other areas.

¿Preguntas?

Please post in the Enrolment forum on moodle.org.

Vea también

Using Moodle forum discussions: