/
Descarregar dados para múltiplos cursos

Descarregar dados para múltiplos cursos

A NAU disponibiliza dois scripts Python para gerar e descarregar os dados para um ou mais cursos - https://github.com/fccn/nau-openedx-extensions/tree/HEAD/bin. Os scripts disponíveis são os seguintes:

  • generate_reports.py gera os relatórios desejados para cada um dos cursos especificados;

  • export_reports.py descarrega os relatórios gerados para uma pasta no seu computador.

Correr um comando em Python

Para correr um comando em Python é necessário descarregar o Python e instalar no seu PC.

Para garantir que tudo está corretamente instalado, insira o seguinte comando na sua linha de comandos:

python generate_reports.py -h

Este comando vai mostrar-lhe todos os parâmetros disponíveis no script.

Se está a correr este comando no Windows, instale as dependências executando pip install requests.

Gerar relatórios para um ou mais cursos

Para gerar relatórios para um ou mais cursos, descarregue o script e coloque-o numa pasta no seu PC.

Eis um exemplo de como correr este comando:

python generate_reports.py --email <email> --password <password> --lms_url https://lms.nau.edu.pt --course_id course-v1:FCT+TPag+2024_T3 --course_ids_file courses.txt --report get_students_profile

Os ID de curso devem estar completos como no exemplo: course-v1:FCT+TPag+2024_T3

Descarregar relatórios

Como no script anterior, para descarregar os relatórios para o seu PC deve colocar este script numa pasta à sua escolha.

Para correr o comando siga o exemplo:

python export_reports.py --email <email> --password <password> --lms_url https://lms.nau.edu.pt --course_id course-v1:FCT+TPag+2024_T3 --report get_students_profile --days_ago 30

O comando permite descarregar os relatórios gerados hoje ou de há vários dias atrás. No caso do exemplo, estamos a descarregar todos os documento de perfil de estudante gerados no último mês através de --days_ago 30. Mais instruções disponíveis no ficheiro do script.

Utilizar um documento para descarregar mais do que um curso

Pode utilizar um documento para descarregar os relatório de múltiplos cursos.

Para o fazer, crie um documento .txt ou .csv onde se encontrem dispostos os IDs dos cursos, um por linha.

course-v1:FCT+TPag+2024_T3 course-v1:FCT+Teste+2024_T3

Para correr o comando, deve agora incluir o caminho para o ficheiro.

python export_reports.py --email <email> --password <password> --lms_url https://lms.nau.edu.pt --course_ids_file courses.txt --report grade_report

Descarregar relatórios de uma unidade especifica.

Para descarregar os relatórios de uma unidade ou problema específico (como os criados para as informações do aluno), deve colocar o ID do curso, separado do identificado do bloco de onde pretende extrair informação.

course-v1:FCT+TPag+2024_T3;block-v1:FCT+TPag+2024_T3+type@problem+block@ac87b7d6c48e343e94b7 course-v1:FCT+Teste+2024_T3;block-v1:FCT+Teste+2024_T3+type@problem+block@1

Tenha atenção aos separadores entre o ID do curso e o identificador do bloco. Apenas ponto e vírgula, vírgula e espaço em branco são permitidos.