Caricare corsi: differenze tra le versioni

Da MoodleDocs.
Riga 20: Riga 20:
L’opzione ''Anteprima'' mostra eventuali errori rilevati nelle righe visualizzate in anteprima. Se si rileva qualcosa di sbagliato in un corso ma si procede con il caricamento, il file verrà ignorato e il caricamento interrotto.
L’opzione ''Anteprima'' mostra eventuali errori rilevati nelle righe visualizzate in anteprima. Se si rileva qualcosa di sbagliato in un corso ma si procede con il caricamento, il file verrà ignorato e il caricamento interrotto.


{{Nota| È possibile utilizzare anche la riga di comando ''admin/tool/uploadcourse/cli/uploadcourse.php''.}}===Breve esempio di caricamento tramite un file .CSV ===
{{Nota| È possibile utilizzare anche la riga di comando ''admin/tool/uploadcourse/cli/uploadcourse.php''.}}===Esempio di caricamento tramite un file .CSV ===
''corsidacaricare.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.
{{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.


<code>
<code>

Versione delle 20:24, 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 per aggiornare o eliminare i corsi o importare contenuti da un altro corso. Per maggiori informazioni su come utilizzare questa funzionalità per creare modelli, 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, quindi cliccare sul pulsante Anteprima.
File:26uploadcourses.png
Schermata di amministrazione Caricamento corsi
File:uploadcoursesresults.png
Corsi caricati con successo

L’opzione Anteprima mostra eventuali errori rilevati nelle righe visualizzate in anteprima. Se si rileva qualcosa di sbagliato in un corso ma si procede con il caricamento, il file verrà ignorato e il caricamento interrotto.

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

Esempio di caricamento tramite un 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.

Campi d’azione del corso

Queste impostazioni hanno la precedenza sui parametri di Processo del corso.

delete
1 per eliminare il corso.
rename
Il nome abbreviato con cui rinominare il corso.
backupfile
Un percorso assoluto a un file di backup (.mbz) da importare nel corso.

(Ciò significa che il percorso completo al corso è ad esempio /home/yourmoodle/public_html/moodle27/transfert/backup.mbz. Se non si è sicuri, controllare 'include_path' su Amministrazione del sito > Server > PHP info.)

templatecourse
Il nome abbreviato del corso da cui importare i contenuti.
reset
1 per resettare il corso.

Campi obbligatori

shortname
Questo campo è obbligatorio per ogni operazione ad eccezione della creazione di nuovi corsi. Vedere i dettagli sul parametro del processo del corso 'Shortname template' per maggiori informazioni.
fullname
Richiesto quando si crea un nuovo corso.
category, category_idnumber, category_path
Uno di questi campi è necessario quando si crea un corso.

Opzioni di importazione

Per impedire che si verifichino comportamenti inaspettati, è necessario specificare che cosa si desidera che lo strumento sia in grado di fare.

Modalità caricamento
Consente di specificare se è possibile creare e/o aggiornare i corsi.
Modalità aggiornamento
Abilitando l’aggiornamento dei corsi, è anche necessario indicare come aggiornare i corsi esistenti.
Consenti eliminazioni
Consente di accettare il campo eliminazione.
Consenti cambio titoli
Consente di accettare il campo cambio titoli.
Consenti reset
Consente di accettare il campo reset.

Processo del corso

Permette di specificare le azioni da effettuare per ogni corso caricato.

Shortname template
Se si creano corsi senza nomi abbreviati, si può utilizzare questo campo per generarli in maniera automatica. Questo campo accetta due segnaposti: '%i' per il codice identificativo, '%f' per la descrizione.
Restore file
File di backup (.mbz) da importare nel corso dopo la creazione o l’aggiornamento.
Restore from course
Il nome abbreviato di un corso da cui importare contenuti dopo la creazione o l’aggiornamento.
Reset after upload
Resettare il corso dopo averlo creato/aggiornato.

Valori predefiniti del corso

Si tratta di valori che possono essere impostati nell’interfaccia web per tutti i campi che non sono specificati nel file .CSV. Si noti che vengono sempre utilizzati durante la creazione di un corso, ma solo quando specificato durante l'aggiornamento (vedere sopra 'Update mode').

Aumentare la velocità

Quando si importa il contenuto di un file di backup o un altro corso, viene consigliato di abilitare l’impostazione keeptempdirectoriesonbackup. Ciò velocizzerà notevolmente il processo di caricamento se si importa più volte dalla stessa fonte.

Vedere anche