Skip to main content

Exports and archives

This page is the complete reference for everything Artemis can hand out as a file: archives, repositories, submissions, scores, and personal data. Each entry names the minimum role you need, where the action lives in the user interface, and what you get back.

Overview​

The role column is the lowest role that may perform the action. A higher role can always do the same, and some entries have extra conditions that are explained in their section.

Export or archiveMinimum roleWhere in ArtemisWhat you get
Archive a courseInstructorCourse settings pageZIP with every exercise and student submission
Archive an examInstructorExam checklistZIP with every exam exercise and student submission
Export programming exercise materialInstructorExercise detail pageZIP that can be imported into another course
Export student repositories in bulkTutor (anonymized), InstructorScores page, or the course exercises overviewZIP with one entry per participation
Download a template, solution or test repositoryTutorExercise detail pageZIP including the Git history
Download an auxiliary repositoryTutorExercise detail pageZIP including the Git history
Download a single student repositoryOwner of the participation, otherwise TutorScores page, assessment view, exercise pageZIP of the code without the Git history
Download the example solutionStudent after publication, otherwise TutorExercise pageZIP of the code without the Git history
Export exercise submissionsInstructorScores pageZIP of text, modeling or uploaded files
Export exercise resultsInstructorScores pageCSV
Export participant namesInstructorScores pageCSV of the participants
Export course scoresInstructorCourse management, Scores pageExcel or CSV
Export exam scoresInstructorExam scores pageExcel or CSV
Export the exam student listInstructorExam students pageCSV
Export quiz questionsEditorQuiz exercise detail page, or the quiz question listJSON
Export tutorial groupsInstructorTutorial groups managementCSV or JSON
Export an exercise to the Sharing PlatformInstructorExercise detail pageExercise pushed to the connected platform
Request your own data exportAny userPrivacy statement, in the page footerZIP with everything Artemis stores about you
Request a data export for another userAdministratorAdministration, Data exportsThe same ZIP, for the named user

Archives​

An archive is the complete record of a course or an exam, produced once and downloaded as often as needed.

Archive a course​

Archive Course, on the Settings page of the course in the course management, exports all course data. The button appears only once the course end date has passed — while the course is still running there is nothing to archive, so Artemis does not offer it.

Course settings page with Archive Course in its title bar
The archive section of the course settings page

For each exercise the archive contains the problem statement and a JSON file with the exercise details such as points. For programming exercises, the template, solution, test and auxiliary repositories are included as well, and every student repository is added as its own ZIP file inside the archive. All exams of the course are archived along with it.

Beyond the submissions, the archive carries the student data the course has accumulated: course and exam scores, participation results with their feedback, posts and messages, competency progress, learner profiles, tutorial group registrations, Iris chat sessions, and LLM token usage traces.

The archive is built asynchronously and you receive a notification once it is ready. Download Archive, on the same page, hands it to you.

For the exact list of what is and is not part of a course archive, see Course Archive in the administration documentation.

Archive an exam​

The same as a course archive, limited to a single exam, and likewise only possible once the exam end date has passed. Archive Exam on the exam checklist page starts it, and Download Archive on that page hands it over.

Archive Exam on the exam checklist page
Archiving from the exam checklist

Programming exercise repositories​

Every repository export is an ordinary ZIP file. Whether it carries the Git history differs per export and is stated below, because that is what decides if the extracted folder is a usable repository or only a copy of the code.

Export programming exercise material​

Download Exercise, on the exercise detail page, exports the material of a programming exercise: the template, solution, test and auxiliary repositories, the problem statement, and the exercise configuration. This is the format the exercise import reads, so it is the way to move an exercise to another course or another Artemis instance.

Export actions on a programming exercise detail page
The export actions on a programming exercise

Export student repositories in bulk​

Exports the repositories of many participations at once, for graded and practice participations alike.

Open the Scores page of the exercise, click Export, and choose Download Repos. The same action is available on the course exercises overview, where it exports the selected programming exercises together.

The Export Repositories dialog takes either a comma-separated list of logins or team short names, or Or download the repositories of all students. Nothing is requested from the server until one of the two is set.

Repository export dialog with the participant selection and the rewrite options
Choosing participants and export options

The dialog also offers options that rewrite what is exported:

OptionEffect
Add student name to projectRenames the project inside the repository so the participant is identifiable, and several can be imported into an IDE side by side. On by default
Combine changes into one commitSquashes the student commits into a single commit, which is easier to read than a history. On by default
Normalize code styleStandardizes line endings and encoding
Filter late submissionsMoves the branch back to the last commit before Date to filter late submissions, which defaults to the due date
Exclude practice submissionsSkips participations made after the due date in practice mode
Anonymize repositoryRemoves the student name from the commit messages and the directory name

Each participation appears in the archive as its own folder containing the code and a .git directory, so the full history is available after extracting.

Download a template, solution or test repository​

Download Repository on the exercise detail page downloads one of the exercise's own repositories including its Git history.

Download an auxiliary repository​

The same for an auxiliary repository, if the exercise defines any.

Download a single student repository​

Download Repository on a participation gives you that one repository as a ZIP file without the .git directory, so it contains the submitted code but no history.

Students see this button on their own exercise page and can only download their own participation. Instructors can open student repositories from the participation and score lists. Tutors can open them through Code while support access is available: before the exercise due date when manual or semi-automatic assessment is enabled, or at any time for automatically assessed course programming exercises and exercises without a due date.

After the manual-assessment deadline, tutors use the Assessment Dashboard to view and download anonymized submissions selected by participation ID. Names and direct repository access are hidden on the participation and score pages. See Access Rights.

Download the example solution​

Download Example Solution gives you the solution repository as a ZIP file without the .git directory. Students can do this only once the example solution publication date of the exercise has passed; before that, the button is limited to tutors and above. Download tests with example solution appears in place of it when the exercise is configured to release the tests together with the solution.

Submissions, results and scores​

The exercise Scores page collects the per-exercise exports behind one Export button. Which entries the resulting Export Options list offers depends on the exercise type and on your role.

Export Options list on the exercise scores page
The export options of a text exercise

Export exercise submissions​

Export Submissions exports the submissions of everyone who participated in a text, modeling or file upload exercise. Text submissions become text files, modeling submissions become JSON files, and file upload submissions are exported as the uploaded files, each collected in one ZIP file. Filter late submissions cuts the export off at a date you give, which defaults to the due date.

For programming exercises, use Export student repositories in bulk instead.

Export exercise results​

Export Results exports the results of one exercise as a CSV file. For a programming exercise it offers three levels of detail — Without test cases, With test cases, and With test cases and feedback, which adds a copy of the feedback given for each failed test. Every other exercise type produces the plain file directly.

The file is assembled in your browser from the data already on the page, so it contains exactly the participations the page shows.

Export participant names​

Export Names writes the participants of the exercise to a CSV file, without their results. Use it when you need the list of who took part rather than how they did. For a team exercise the file has a row per team — team name, short name, and the students in it — rather than a bare list of names.

Export course scores​

The Scores page of the course management shows every student's points exercise by exercise, and Export turns that table into a file. The table, its statistics (average, median and standard deviation) and the export list students only: users who currently hold the tutor, editor or instructor role in the course are left out, even if they took part in exercises.

Course scores page with the Export action in its title bar
The course scores page

Export opens the Export Options dialog with a tab per format. Excel writes an .xlsx workbook and has nothing to configure. CSV takes the three settings that decide whether another program reads the result correctly: the Field Separator, whether strings are wrapped in Quote Strings, and the Decimal Separator — a comma for locales that write 1,42, a period for those that write 1.42.

Export Options dialog with the Excel and CSV choices
Choosing the file format and its separators

Export exam scores​

The same dialog, from the Export button on an exam's scores page.

Export the exam student list​

Exports the students registered for an exam as a CSV file, from the exam students page. Use it to hand the registration list to another system, for example for seat planning.

Other exports​

Export quiz questions​

Exports the questions of a quiz, including their sample solutions, as a JSON file. Export on the detail page of the quiz writes the whole quiz; the quiz question list of the course lets you pick individual questions across quizzes and export only those.

The file is written by your browser from the quiz that is already loaded, and it can be imported into another quiz.

Export tutorial groups​

Export Tutorial Groups on the tutorial groups management page exports the groups with their registrations. The dialog asks which fields to include and then writes them through Export as CSV or Export as JSON. See Tutorial groups.

Export an exercise to the Sharing Platform​

Publishes an exercise to a connected sharing platform instead of downloading it. This is only available when an administrator has configured the platform. See Sharing Platform.

User data​

Request your own data export​

Exports everything Artemis stores about you: your account details, your submissions and results, the feedback you received, your messages, and more. Follow Privacy in the page footer, then the Data Export link on the privacy statement, and click Request data export. You confirm by typing your own login, and receive an email with a download link once the export is ready.

Data export page with the Request data export button
Requesting your own data export

Programming exercise participations appear in the export as one folder per participation with a working .git directory, so your own commit history is part of it.

You can hold one export at a time. Once you have downloaded it, or once Artemis has deleted it, the page names the date from which you may request the next one.

The full list of what the export contains is documented on the student page, Exports.

Request a data export for another user​

Administrators can request and download a data export on behalf of a user, for example to answer a data access request that reaches the institution rather than the platform. The action lives under Administration in the Data exports section and produces the same archive as a self-service request.

Search documentation