|
|
|
### This page is a collection of information regarding exercise export from sharing / import to artemis.
|
|
|
|
|
|
|
|
*STATUS: `work in progress`*
|
|
|
|
|
|
|
|
#### Prerequisites Sharing to allow 'Export to Artemis'
|
|
|
|
|
|
|
|
- The metadata key `format` has to contain `artemis` or `Artemis`
|
|
|
|
- If an exercise is in a private gitlab repository, you need to be part of the corresponding group to be able to export the exercise
|
|
|
|
|
|
|
|
|
|
|
|
#### Prerequesites Artemis to allow 'Import from Sharing'
|
|
|
|
- You have to be logged in as an instructor
|
|
|
|
- There has to be at least one course with permissions to be edited.
|
|
|
|
- Metadata requirements:
|
|
|
|
- `projectType` has to be one of `[XCODE, PLAIN_MAVEN, GCC, PLAIN, PLAIN_GRADLE, GRADLE_GRADLE, MAVEN_MAVEN, FACT]`
|
|
|
|
- `difficulty` has to be one of `[simple, medium, advanced]`
|
|
|
|
|
|
|
|
|
|
|
|
#### Additional requirements for a better import
|
|
|
|
|
|
|
|
The problem statement has to be in a .md file. If this is not the case, the problem statement will be 'Statement not found!'
|
|
|
|
|
|
|
|
#### Bugs
|
|
|
|
|
|
|
|
##### Missing `Export to Artemis` button
|
|
|
|
|
|
|
|
The 'Export to Artemis' button is only available when clicking 'More ...' in sharing search. The button is not visible when entering metadata via direct link `https://search.sharing-codeability.uibk.ac.at/item/<itemId>`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
##### Cloning of repositories does not work
|
|
|
|
|
|
|
|
When importing a sharing exercise to Artemis, the exercise itself is created, but the logs show that the repositories `template`, `solution` and `tests` are not cloned correctly.
|
|
|
|
|
|
|
|
The repository URLs lead to an empty project:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
*Note:* Downloading an Artemis exercise as .zip file and importing it in a new course works without problems, so there must be a problem with the structure of .zip files created in sharing.
|
|
|
|
|
|
|
|
#### Comparison Artemis - Sharing .zip files
|
|
|
|
|
|
|
|
Many of the import problems may be caused by the different structure of the .zip files. While an Artemis export has a repository zip file containing three zip files for exercise, solution and tests, there is no standard for sharing exports yet.
|
|
|
|
|
|
|
|
##### Artemis
|
|
|
|
|
|
|
|
structure:
|
|
|
|
- Exercise-Details.json
|
|
|
|
- Problem-Statement.md
|
|
|
|
- \<ExerciseName\>.zip
|
|
|
|
- \<ExerciseName\>-exercise.zip
|
|
|
|
- \<ExerciseName\>-solution.zip
|
|
|
|
- \<ExerciseName\>-tests.zip
|
|
|
|
|
|
|
|
|
