Carregar cursos

From MoodleDocs

Categoria:Curso

Nota: Esta página é sobre a criação de cursos com um arquivo de texto (.csv). Se você deseja fazer o upload de um backup do curso no formato .mbz ou .tgz, consulte Restaurar curso.


Carregar cursos

Além de criar novos cursos, a funcionalidade de carregar (upload) cursos também pode ser usada para atualizar ou excluir cursos ou importar conteúdo de outro curso. Para obter informações sobre como usar esta funcionalidade para criar modelos de curso, consulte Criando um novo curso.

Para carregar um ou mais cursos

  1. Vá para Administração do site>Cursos>Carregar cursos
  2. Arraste e solte o arquivo CSV ou clique no botão 'Escolher um arquivo' e selecione o arquivo no seletor de arquivos
  3. Selecione as opções de importação apropriadas com cuidado e clique no botão de visualização.
Tela de carregar cursos
Cursos carregados com sucesso

Nota: Também é possível usar a ferramenta de linha de comando admin/tool/uploadcourse/cli/uploadcourse.php.

Ao usar a interface da web, use a opção Visualizar para ver se algum erro foi detectado nas linhas visualizadas. Se você continuar com o upload e houver algo de errado detectado em um curso, ele será ignorado.

Exemplo de arquivo curto

uploadcurso.csv:

Nota: shortname (nome breve), fullname (nome completo) e category (categoria) são obrigatórios.

O campo categoria leva o id da categoria, com a categoria padrão Miscelânia tendo o id 1. As categorias já devem existir. Se você colocar um ID de categoria que não existe, receberá um erro "Não foi possível resolver a categoria por ID" durante a visualização do upload e os cursos nessa categoria não serão criados.

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

Observe que não há espaços entre os itens.

Criando o arquivo de texto

O arquivo de texto para fazer o upload dos cursos deve ser um arquivo CSV. Ele aceita as seguintes colunas, que são divididas em duas categorias, as informações do curso e as ações do curso.

Campos de informação do curso

A maioria dessas configurações está disponível na página de configurações de um curso. Consulte Configurações do curso para obter mais informações. Os nomes dos campos devem ser minúsculos.

shortname
Nome breve do curso
fullname
Nome completo do curso
idnumber
O número do ID do curso
category
Este é o identificador do banco de dados da categoria (encontrado na URL da categoria) para colocar o curso. Ele tem precedência sobre category_idnumber e category_path.
category_idnumber
O número de ID da categoria (encontrado e editável na página ‘Editar categoria’) para colocar o curso. Isso tem precedência sobre category_path.
category_path
O caminho da categoria (category_path) para colocar o curso. Se você quiser colocar o curso em uma categoria chamada "Ficção científica" que está localizada na categoria "Filmes", o valor a fornecer é:Filmes/Ficção científica. Observe que o separador deve ser [space]/[space]. Observe também que a categoria DEVE existir, ela não será criada. Se você deseja colocar o curso na categoria de nível superior "Filmes", o valor a ser fornecido é: Filmes
visible
1 se o curso estiver visível, 0 se estiver oculto
startdate
A data em que o curso começa. Observe que este valor é passado para a função PHP strtotime para gerar um carimbo de data / hora. Exemplo 01.12.2014 (1º de dezembro de 2014)
enddate
A data em que o curso termina. Observe como com startdate que este valor é passado para a função PHP strtotime para gerar um timestamp. Exemplo 01.12.2014 (1º de dezembro de 2014)
summary
O sumário do curso
format
O formato do curso a ser usado, deve ser um nome de plugin de formato de curso válido. Por exemplo. semanas, tópicos.
theme
O tema utilizado
lang
O idioma utilizado
newsitems
O número de itens de notícias
showgrades
1 para mostrar o livro de notas aos alunos, 0 para ocultá-lo.
showreports
1 para mostrar os relatórios de atividades, 0 para ocultá-los.
legacyfiles
1 para habilitar os arquivos do curso legado, 0 não para.
maxbytes
O tamanho máximo de upload do curso em bytes. Use 0 para o limite do site.
groupmode
0 para Nenhum grupo, 1 para Grupos separados e 2 para Grupos visíveis.
groupmodeforce
1 para forçar o modo de grupo, caso contrário, insira 0.
enablecompletion
1 para habilitar a conclusão da atividade, 0 não para.
tags
Uma lista de tags separadas por vírgulas para adicionar ao curso. As tags existentes serão excluídas. Coloque várias tags entre aspas.

Campos de inscrição

Alguns campos podem ser construídos para habilitar e configurar métodos de inscrição. Os campos devem ser nomeados como enrolment_[number] para o nome do método de inscrição e enrolment_[number]_property para suas propriedades.

enrolment_[number]
O nome do método de inscrição (por exemplo, manual, visitante, auto)
enrolment_[number]
1 para excluir este método de inscrição do curso; se definido como 1, todas as outras propriedades serão ignoradas.
enrolment_[number]_disable
1 para desativar este método de inscrição do curso; se definido como 1, todas as outras propriedades serão ignoradas.
enrolment_[number]_startdate
A data de início da inscrição. Este valor é passado para a função PHP strtotime ().
enrolment_[number]_enddate
A data de término da inscrição. Este valor é passado para a função PHP strtotime ().
enrolment_[number]_enrolperiod
Número de segundos ou, se não for um valor compreendido por strtotime (), como "4 dias".
enrolment_[number]_role
O nome breve do papel
enrolment_[number]_[property]
Onde a propriedade é entendida pelo método de inscrição especificado
enrolment_[number]_password
A chave de inscrição no curso

Nota: O upload de cursos ainda não é compatível com todos os métodos de inscrição (MDL-43127).

'"Exemplo"'

enrolment_1: manual enrolment_1_role: estudante enrolment_1_enrolperiod: 1 mês

enrolment_2: auto enrolment_2_startdate: 2020-01-30

Renomeação de papel

Para renomear alguns papéis, use o seguinte padrão:

role_[shortname]
O novo nome do papel "[shortname]".

'"Exemplo'"

role_student: Aprendiz role_teacher: Mestre role_mycustomrole: Jedi

É importante notar que o nome curto para a função de professor é professor editor e o nome curto para o professor que não edita é professor.

Campos de ação do curso

Essas configurações têm precedência sobre os parâmetros de Processo do curso.

delete
1 para deletar o curso
rename
O nome breve para renomear o curso para
backupfile
Um caminho absoluto para um arquivo de backup (.mbz) para importar no curso.

(Isso significa o caminho completo para o seu curso, por exemplo /home/yourmoodle/public_html/moodle27/transfert/backup.mbz. Se você não tiver certeza disso, consulte include_path em Administração do site>Servidor>PHP info.)

templatecourse
O nome abreviado de um curso do qual vai se importar o conteúdo
reset
1 para redefinir o curso

Campos obrigatórios

shortname
Este campo é obrigatório para todas as operações, exceto para a criação de novos cursos. Veja detalhes sobre o parâmetro de processo do curso Shortname template para mais informações.
fullmane
Obrigatório ao criar um novo curso.
category, category_idnumber, category_path
Um deles é obrigatório ao criar um curso.

Opções de importação

Para evitar um comportamento inesperado, você deve especificar o que deseja que a ferramenta seja capaz de fazer.

Upload mode
Isso permite que você especifique se os cursos podem ser criados e / ou atualizados.
Update mode
Se você permitir que os cursos sejam atualizados, você também deve informar à ferramenta com o que atualizar os cursos.
Allow deletes
Se o campo deletar é aceito ou não
Allow renames
Se o campo renomear é aceito ou não
Allow resets
Se o campo reset é aceito ou não

Processo do curso

Isso permite que você especifique as ações a serem realizadas para cada curso carregado.

Shortname template
Se estiver criando cursos sem um nome curto, você pode usar este campo para gerar um nome curto automaticamente. Este campo aceita dois marcadores de posição: %i para o número de ID, %f para o resumo.
Restore file
Um arquivo de backup (.mbz) para importar no curso após a criação / atualização.
Restore from course
O nome breve de um curso para importar o conteúdo após a criação / atualização.
Reset after upload
Se deve redefinir o curso após criá-lo / atualizá-lo.

Valores padrão do curso

Esses são valores que podem ser definidos na interface da web para todos os campos que não são especificados no arquivo CSV. Observe que eles são sempre usados ao criar um curso, mas apenas quando especificados durante a atualização (consulte Modo de atualização).

Aumentando a velocidade

Ao importar o conteúdo de um arquivo de backup ou de outro curso, é recomendável habilitar a configuração keeptempdirectoriesonbackup. Isso irá acelerar consideravelmente o processo de upload se você estiver importando várias vezes da mesma fonte.

Veja também