Caricare corsi: differenze tra le versioni

Da MoodleDocs.
Riga 45: Riga 45:


;shortname
;shortname
: Il titolo abbreviato
: Il titolo abbreviato del corso.
;fullname
;fullname
: Il titolo del corso
: Il titolo completo del corso.
;idnumber
;idnumber
: Il codice identificativo (ID)
: Il codice identificativo (ID) del corso.
;category
;category
: Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a ''category_idnumber'' e ''category_path''.
: Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a ''category_idnumber'' e ''category_path''.
Riga 55: Riga 55:
: Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a ''category_path''.
: Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a ''category_path''.
;category_path
;category_path
: Il percorso della categoria in cui collocare il corso. Se si vuole inserire il corso in una categoria chiamata 'Science-Fiction' che è situata sotto la categoria 'Movies', il valore da fornire è: ''Movies / Science-Fiction''. Si noti che il separatore deve essere:[spazio]/[spazio]. Si noti inoltre che la categoria DEVE esistere e non sarà creata. Se si desidera collocare il corso nella categoria di primo livello, 'Movies', il valore da fornire è:  ''Movies''
: Il percorso della categoria in cui collocare il corso. Se si vuole inserire il corso in una categoria chiamata 'Fantascienza' che è situata sotto la categoria 'Film', il valore da fornire è: ''Film/Fantascienza''. Si noti che il separatore deve essere:[spazio]/[spazio]. Si noti inoltre che la categoria DEVE esistere e non sarà creata. Se si desidera collocare il corso nella categoria di primo livello, 'Film', il valore da fornire è:  ''Film''.
;visible
;visible
: 1 se il corso è visibile, 0 se è nascosto
: 1 se il corso è visibile, 0 se è nascosto.
;startdate
;startdate
: La data di inizio del corso. Si prega di notare che questo valore viene trasferito alla funzione PHP {{en}} [http://php.net/manual/en/function.strtotime.php strtotime] per generare un timestamp. Esempio: 16.12.2018 (16 Dicembre 2018)
: La data di inizio del corso. Si prega di notare che questo valore viene trasferito alla funzione PHP {{en}} [http://php.net/manual/en/function.strtotime.php strtotime] per generare un timestamp. Esempio: 16.12.2018 (16 Dicembre 2018).
 
;enddate
;enddate
: The time at which the course ends. Please note as with startdate that this value is passed to the PHP function [http://php.net/manual/en/function.strtotime.php strtotime] to generate a timestamp. Example 01.12.2014 (1st December 2014)
: Il momento in cui il corso finisce. Si noti che con ''startdate'' questo valore è passato alla funzione PHP {{en}} [http://php.net/manual/en/function.strtotime.php strtotime] per generare un timestamp. Esempio: 16.12.2018 (16 Dicembre 2018).
;summary
;summary
: The summary of the course
: La descrizione del corso.
;format
;format
: The course format to use, this must be a valid course format plugin name. E.g. ''weeks'', ''topics''.
: Il formato del corso da utilizzare; deve essere un nome valido per il formato del corso. Ad esempio, settimanale, per argomenti.
;theme
;theme
: The theme to use
: Il tema da utilizzare.
;lang
;lang
: The language to use
: La lingua da utilizzare.
;newsitems
;newsitems
: The number of news items
: Il numero di annunci da visualizzare.
;showgrades
;showgrades
: 1 to show the gradebook to students, 0 to hide it.
: 1 per mostrare il registro agli Studenti, 0 per nasconderlo.
;showreports
;showreports
: 1 to show the activity reports, 0 to hide it.
: 1 per mostrare i report delle attività, 0 per nasconderli.
;legacyfiles
;legacyfiles
: 1 to enable the legacy course files, 0 not to.
: 1 per abilitare i file legacy del corso, 0 per non abilitarli.
;maxbytes
;maxbytes
: The maximum upload size of the course in bytes. Use 0 for the site limit.
: La dimensione massima dei file caricabili nel corso espressa in byte. Utilizzare 0 per il limite del sito.
;groupmode
;groupmode
: 0 for ''No groups'', 1 for ''Separate groups'' and 2 for ''Visible groups''.
: 0 per ''Senza gruppi'', 1 per ''Gruppi separati'' e 2 per ''Gruppi visibili''.
;groupmodeforce
;groupmodeforce
: 1 to force the group mode, otherwise enter 0.
: 1 per forzare la modalità gruppo, altrimenti inserire 0.
;enablecompletion
;enablecompletion
: 1 to enable the activity completion, 0 not to.
: 1 per abilitare il tracciamento del completamento delle attività, 0 per non abilitarlo.
;tags
;tags
: A comma-separated list of tags to add to the course. Existing tags will be deleted. Enclose multiple tags in quotes.
: Una lista di tag separati da virgole da aggiungere al corso. I tag esistenti verranno eliminati. Racchiudere tag multipli tra virgolette.


====Enrolment fields====
====Campi di iscrizione====
 
Alcuni campi possono essere costruiti per abilitare e configurare i metodi di iscrizione. I campi devono chiamarsi ''enrolment_[number]'' per il nome del metodo di iscrizione ''e enrolment_[number]_property'' per le sue proprietà.
Some fields can be constructed to enable and configure enrolment methods. The fields must be named ''enrolment_[number]'' for the enrolment method name, and ''enrolment_[number]_property'' for its properties.


;enrolment_[number]
;enrolment_[number]
: The name of the enrolment method (eg, manual, guest, self)
: Il nome del metodo di iscrizione (ad esempio iscrizione manuale, accesso ospiti, iscrizione spontanea).
;enrolment_[number]_delete
;enrolment_[number]_delete
: 1 to delete this enrolment method from the course, if set to 1 all the other properties will be ignored.
: 1 per eliminare questo metodo di iscrizione dal corso. Se impostato su 1, tutte le altre proprietà verranno ignorate.
;enrolment_[number]_disable
;enrolment_[number]_disable
: 1 to disable this enrolment method from the course, if set to 1 all the other properties will be ignored.
: 1 per disabilitare questo metodo di iscrizione nel corso. Se impostato su 1, tutte le altre proprietà verranno ignorate.
;enrolment_[number]_startdate
;enrolment_[number]_startdate
: The enrolment start date. This value is passed to the PHP function strtotime().
: La data di inizio dell’iscrizione. Questo valore viene passato alla funzione PHP strtotime().
;enrolment_[number]_enddate
;enrolment_[number]_enddate
: The enrolment end date. This value is passed to the PHP function strtotime().
: La data di scadenza dell’iscrizione. Questo valore viene passato alla funzione PHP strtotime().
;enrolment_[number]_enrolperiod
;enrolment_[number]_enrolperiod
: Number of seconds, or if not a value understood by strtotime() such as "4 days".
: Numero di secondi oppure un valore comprensibile a strtotime(), come “4 giorni”.
;enrolment_[number]_role
;enrolment_[number]_role
: The role short name
: Il nome abbreviato del ruolo.
;enrolment_[number]_[property]
;enrolment_[number]_[property]
: Where property is understood by the specified enrolment method
: Il parametro 'proprietà' deve essere comprensibile al metodo di iscrizione specificato.
;enrolment_[number]_password
;enrolment_[number]_password
: The course enrolment key
: La chiave di iscrizione al corso.


Note: Upload courses is not yet compatible with all [[Enrolments|enrolment methods]] (MDL-43127).
Note: Upload courses is not yet compatible with all [[Enrolments|enrolment methods]] (MDL-43127).


'''Example'''
{{Nota|Il caricamento dei corsi non è ancora compatibile con tutti i [[Iscrizione|metodi di iscrizione]] - {{en}} (MDL-43127).}}
 
'''Esempio:'''


  enrolment_1: manual
  enrolment_1: iscrizione manuale
  enrolment_1_role: student
  enrolment_1_role: studente
  enrolment_1_enrolperiod: 1 month
  enrolment_1_enrolperiod: 1 mese
   
   
  enrolment_2: self
  enrolment_2: iscrizione spontanea
  enrolment_2_startdate: 2013-01-30
  enrolment_2_startdate: 2013-01-30


====Role renaming====
====Personalizzazione dei nomi dei ruoli====


To rename some roles, using the following pattern:
Utilizzare il modello riportato qui di seguito per personalizzare alcuni nomi dei ruoli:


;role_[shortname]
;role_[shortname]
: The new name of the role ''[shortname]''.
: Il nuovo nome del ruolo''[shortname]''.


'''Example'''
'''Esempio:'''


  role_student: Apprentice
  role_student: Apprendista
  role_teacher: Master
  role_teacher: Maestro
  role_mycustomrole: Jedi
  role_mycustomrole: Jedi


It is worth noting that the short name for the teacher role is ''editingteacher'' and the short name for the non-editing teacher is ''teacher''.
È bene notare che il nome abbreviato del ruolo Docente è ''editingteacher'' e quello del Docente non editor è ''teacher''.


===Course action fields===
===Course action fields===

Versione delle 06:42, 22 dic 2018

Attenzione: Pagina in costruzione


Nota: Questa pagina riguarda la creazione di corsi con file .CSV. Se si desidera caricare il backup di un corso nel formato .mbz o .tgz, consultare Ripristinare corsi.


Caricare corsi

Oltre a creare nuovi corsi, la funzionalità Caricamento corsi, in Amministrazione del sito > Corsi, può essere utilizzata anche per aggiornare o eliminare i corsi o importare contenuti da un altro corso. Per maggiori informazioni su come utilizzare questa funzionalità per creare modelli dei corsi, consultare Modelli di corso.

Per caricare uno o più corsi:

  1. Andare su Amministrazione del sito > Corsi > Caricamento corsi.
  2. Trascinare e rilasciare il file .CSV o cliccare sul pulsante Scegli un file... e selezionare il file nel File picker.
  3. Selezionare attentamente le Opzioni di importazione appropriate, poi cliccare sul pulsante Anteprima.
File:26uploadcourses.png
Schermata di amministrazione Caricamento corsi
File:uploadcoursesresults.png
Corsi caricati con successo


Nota: È possibile utilizzare anche la riga di comando admin/tool/uploadcourse/cli/uploadcourse.php.

Se si sta utilizzando l’interfaccia web, l’opzione Anteprima mostra eventuali errori rilevati nelle righe visualizzate in anteprima. Se si procede con il caricamento e si rileva qualcosa di sbagliato in un corso, verrà ignorato.

Breve esempio di file .CSV

corsidacaricare.csv :

Nota: Il titolo abbreviato, il titolo del corso e la categoria sono obbligatori

Il campo category prende l'ID della categoria, con la categoria predefinita Miscellaneous che ha ID 1. Le categorie devono già esistere. Se si inserisce un ID di categoria che non esiste, durante l'anteprima del caricamento si visualizzerà l’errore "Non è stato possibile individuare la categoria tramite l'ID" e i corsi in quella categoria non verranno creati.

shortname,fullname,category,summary,enrolment_1,enrolment_1_role,enrolment_1_enrolperiod,role_student courserestored,Course restored,1,a summary,manual,student,1 month, courserestored2,Course restored 2,1,a summary,,,, courserestored3,Course restored 3,1,a summary,,,,padawan courserestored4,Course restored 4,1,"a summary, with comma",manual,student,1 month,padawan Si noti che non ci sono spazi tra gli elementi.

Creare il file .CSV

È un semplice file di testo con estensione .CSV. It accepts the following columns which are divided in two categories, the course information, and the course actions.

Il file di testo da utilizzare per caricare i corsi deve essere un file .CSV, ovvero un file di testo con estensione .csv. Accetta le seguenti colonne suddivise in due categorie, le informazioni sul corso e le azioni del corso.

Campi di informazione sul corso

Molte di queste impostazioni sono disponibili nella pagina delle impostazioni di un corso. Consultare Impostazioni Corso per maggiori informazioni. I nomi dei campi devono essere in minuscolo.

shortname
Il titolo abbreviato del corso.
fullname
Il titolo completo del corso.
idnumber
Il codice identificativo (ID) del corso.
category
Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a category_idnumber e category_path.
category_idnumber
Il codice identificativo della categoria in cui collocare il corso. Ha la precedenza rispetto a category_path.
category_path
Il percorso della categoria in cui collocare il corso. Se si vuole inserire il corso in una categoria chiamata 'Fantascienza' che è situata sotto la categoria 'Film', il valore da fornire è: Film/Fantascienza. Si noti che il separatore deve essere:[spazio]/[spazio]. Si noti inoltre che la categoria DEVE esistere e non sarà creata. Se si desidera collocare il corso nella categoria di primo livello, 'Film', il valore da fornire è: Film.
visible
1 se il corso è visibile, 0 se è nascosto.
startdate
La data di inizio del corso. Si prega di notare che questo valore viene trasferito alla funzione PHP (EN) strtotime per generare un timestamp. Esempio: 16.12.2018 (16 Dicembre 2018).
enddate
Il momento in cui il corso finisce. Si noti che con startdate questo valore è passato alla funzione PHP (EN) strtotime per generare un timestamp. Esempio: 16.12.2018 (16 Dicembre 2018).
summary
La descrizione del corso.
format
Il formato del corso da utilizzare; deve essere un nome valido per il formato del corso. Ad esempio, settimanale, per argomenti.
theme
Il tema da utilizzare.
lang
La lingua da utilizzare.
newsitems
Il numero di annunci da visualizzare.
showgrades
1 per mostrare il registro agli Studenti, 0 per nasconderlo.
showreports
1 per mostrare i report delle attività, 0 per nasconderli.
legacyfiles
1 per abilitare i file legacy del corso, 0 per non abilitarli.
maxbytes
La dimensione massima dei file caricabili nel corso espressa in byte. Utilizzare 0 per il limite del sito.
groupmode
0 per Senza gruppi, 1 per Gruppi separati e 2 per Gruppi visibili.
groupmodeforce
1 per forzare la modalità gruppo, altrimenti inserire 0.
enablecompletion
1 per abilitare il tracciamento del completamento delle attività, 0 per non abilitarlo.
tags
Una lista di tag separati da virgole da aggiungere al corso. I tag esistenti verranno eliminati. Racchiudere tag multipli tra virgolette.

Campi di iscrizione

Alcuni campi possono essere costruiti per abilitare e configurare i metodi di iscrizione. I campi devono chiamarsi enrolment_[number] per il nome del metodo di iscrizione e enrolment_[number]_property per le sue proprietà.

enrolment_[number]
Il nome del metodo di iscrizione (ad esempio iscrizione manuale, accesso ospiti, iscrizione spontanea).
enrolment_[number]_delete
1 per eliminare questo metodo di iscrizione dal corso. Se impostato su 1, tutte le altre proprietà verranno ignorate.
enrolment_[number]_disable
1 per disabilitare questo metodo di iscrizione nel corso. Se impostato su 1, tutte le altre proprietà verranno ignorate.
enrolment_[number]_startdate
La data di inizio dell’iscrizione. Questo valore viene passato alla funzione PHP strtotime().
enrolment_[number]_enddate
La data di scadenza dell’iscrizione. Questo valore viene passato alla funzione PHP strtotime().
enrolment_[number]_enrolperiod
Numero di secondi oppure un valore comprensibile a strtotime(), come “4 giorni”.
enrolment_[number]_role
Il nome abbreviato del ruolo.
enrolment_[number]_[property]
Il parametro 'proprietà' deve essere comprensibile al metodo di iscrizione specificato.
enrolment_[number]_password
La chiave di iscrizione al corso.

Note: Upload courses is not yet compatible with all enrolment methods (MDL-43127).

Nota: Il caricamento dei corsi non è ancora compatibile con tutti i metodi di iscrizione - (EN) (MDL-43127).


Esempio:

enrolment_1: iscrizione manuale
enrolment_1_role: studente
enrolment_1_enrolperiod: 1 mese

enrolment_2: iscrizione spontanea
enrolment_2_startdate: 2013-01-30

Personalizzazione dei nomi dei ruoli

Utilizzare il modello riportato qui di seguito per personalizzare alcuni nomi dei ruoli:

role_[shortname]
Il nuovo nome del ruolo[shortname].

Esempio:

role_student: Apprendista
role_teacher: Maestro
role_mycustomrole: Jedi

È bene notare che il nome abbreviato del ruolo Docente è editingteacher e quello del Docente non editor è teacher.

Course action fields

Those settings take precedence over the Course process parameters.

delete
1 to delete the course
rename
The shortname to rename the course to
backupfile
An absolute path to a backup file (.mbz) to import in the course.

(This means the full path to your course, for example /home/yourmoodle/public_html/moodle27/transfert/backup.mbz . If you are unsure of this, look at include_path in Site administration>Server>PHP info.)

templatecourse
The short name of a course to import the content from
reset
1 to reset the course

Mandatory fields

shortname
This field is mandatory for every operation, with the only exception of creating new courses. See details on the course process parameter Shortname template for more information.
fullname
Required when creating a new course.
category, category_idnumber, category_path
One of these is required when creating a course.

Import options

To prevent unexpected behaviour, you have to specify what you want the tool to be able to do.

Upload mode
This allows you to specify if courses can be created and/or updated.
Update mode
If you allow courses to be updated, you also have to tell the tool what to update the courses with.
Allow deletes
Whether the delete field is accepted or not
Allow renames
Whether the rename field is accepted or not
Allow resets
Whether the reset field is accepted or not

Course process

This allows you to specify actions to be taken for every course uploaded.

Shortname template
If you are creating courses without a shortname, you can use this field to automatically generate a shortname. This field accepts two placeholders: %i for the ID number, %f for the summary.
Restore file
A backup file (.mbz) to import in the course after create/update.
Restore from course
The shortname of a course to import content from after create/update.
Reset after upload
Whether to reset the course after creating/updating it.

Default course values

Those are values that can be set in the web interface for all the fields that are not specified in the CSV file. Note that they are always used when creating a course, but only when specified during update (see Update mode).

Increasing speed

When importing the content of a backup file, or another course, you are advised to enable the setting keeptempdirectoriesonbackup. This will considerably speed up the process of the upload if you are importing multiple times from the same source.

Vedere anche