Grundlagen
Es steht eine REST-Schnittstelle für den Notenimport zur Verfügung, welche mit JSON kommuniziert.
Authentifizierung
Konzept
Um sich bei der Schnittstelle authentifizieren zu können, müssen folgende Schritte durchgeführt werden:
- Einloggen per BE-Login bei der BU21-Applikation. Es wird geprüft, ob in den letzten 30 Minuten ein Login stattgefunden hat.
- Einmal eingeloggt, kann im Benutzerprofil ein Authentifizierungsschlüssel generiert werden.
- Der API Access Key kann nun verwendet werden, um einen Token zu generieren, der bei jedem Request im Header mitgeschickt werden muss.
Der Token ist eine Stunde gültig, danach muss der Aufruf auf token-auth wiederholt werden.
Token holen
- Produktion https://www.beurteilung.apps.be.ch/api/import/token-auth/
- Testumgebung https://www.testbeurteilung.apps.be.ch/api/import/token-auth/
- Experimental https://bu21exp.cse.ch/api/import/token-auth/
Methode: POST
Body (Content-Type: multipart/form-data)
- username: Benutzername (z.B. faton.bolliger)
- token: Access Key, der in Punkt 2 generiert wurde
Response:
- token: Token, welches bei allen Requests mitgeschickt werden muss.
- user_id: Technische ID Benutzer
- email: e-mail Adresse des Benutzers
Notenimport
Dokumentation abrufen
Um eine Übersicht zu erhalten, welche Fächer für welchen Bericht importiert werden können, sowie welche Werte für das jeweilige Fach erlaubt sind, kann man unter folgender URL eine Dokumentation abrufen.
Methode: GET
Beispiel: Sprache: Deutsch Schuljahr 2022/2023: Bericht: BEBE_DT_P7_V2 (= Beurteilungsbericht 7. Schuljahr)
Produktion: https://www.beurteilung.apps.be.ch/api/import/evaluation/de/2022_2023/BEBE_DT_P7_V2
Testsystem: https://www.testbeurteilung.apps.be.ch/api/import/evaluation/de/2022_2023/BEBE_DT_P7_V2
Experimental: https://bu21exp.cse.ch/api/import/evaluation/de/2022_2023/BEBE_DT_P7_V2
Header:
- Authorization: Token <Token von token-auth>
- token: Token, welches von token-auth im Resultat zurückgegeben wurde.
- soenumber: Schulnummer
- schoolYear: Schuljahr (Format 2022_2023)
Parameter:
Die Parameter werden in der URL übergeben. …/{Sprache: de|fr}/{Schuljahr}/{Bericht ID}
Response (Beispiel):
{
"pensum": [
{
"faecher": [
{
"key": "ABW_ENT",
"name": "Entschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ABW_UNENT",
"name": "Unentschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ADS_BESUCHT",
"name": "besucht",
"typ": "Textfeld",
"wertebereich": "[]"
},
{
"key": "BG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "BS_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "DT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "EN_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "FR_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "HSK_BESUCHT",
"name": "besucht",
"typ": "Boolean",
"wertebereich": "[0|1]"
},
{
"key": "MT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MU_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MUI_BESUCHT",
"name": "besucht",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "NT_NOTE",
"name": "Note (Natur und Technik)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "WAH_NOTE",
"name": "Note (Wirtschaft, Arbeit, Haushalt)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "RZG_NOTE",
"name": "Note (Räume, Zeiten, Gesellschaften)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ERG_BESUCHT",
"name": "Unterricht (Ethik, Religionen, Gemeinschaft)",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "SLE_STATUS",
"name": "Schullaufbahnentscheid der Schulleitung",
"typ": "Auswahl",
"wertebereich": "[Übertritt ins nächste Schuljahr|Überspringen eines Schuljahres|Wiederholen eines Schuljahres|Zuweisung zu einer Klasse zur besonderen Förderung (KbF)|Rückführung aus einer besonderen Klasse in die Regelklasse|Aufnahme in die weiterführenden Bildungsgänge gemäss der entsprechenden Gesetzgebung|Abschluss der Volksschule]"
},
{
"key": "SLT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "SLT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "STG_STATUS",
"name": "Standortgespräch",
"typ": "Auswahl",
"wertebereich": "[Standortgespräch hat stattgefunden|Das Angebot wurde nicht genutzt]"
},
{
"key": "TTG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ZUSATZBERICHT_LIEGT_BEI",
"name": "liegt bei",
"typ": "Boolean",
"wertebereich": "[0|1]"
}
],
"key": "real_d_7",
"name": "der 7. Klasse"
},
{
"faecher": [
{
"key": "ABW_ENT",
"name": "Entschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ABW_UNENT",
"name": "Unentschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ADS_BESUCHT",
"name": "besucht",
"typ": "Textfeld",
"wertebereich": "[]"
},
{
"key": "BG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "BS_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "DT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "EN_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "FR_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "HSK_BESUCHT",
"name": "besucht",
"typ": "Boolean",
"wertebereich": "[0|1]"
},
{
"key": "MT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MU_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MUI_BESUCHT",
"name": "besucht",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "NT_NOTE",
"name": "Note (Natur und Technik)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "WAH_NOTE",
"name": "Note (Wirtschaft, Arbeit, Haushalt)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "RZG_NOTE",
"name": "Note (Räume, Zeiten, Gesellschaften)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ERG_BESUCHT",
"name": "Unterricht (Ethik, Religionen, Gemeinschaft)",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "SLE_STATUS",
"name": "Schullaufbahnentscheid der Schulleitung",
"typ": "Auswahl",
"wertebereich": "[Übertritt ins nächste Schuljahr|Überspringen eines Schuljahres|Wiederholen eines Schuljahres|Zuweisung zu einer Klasse zur besonderen Förderung (KbF)|Rückführung aus einer besonderen Klasse in die Regelklasse|Aufnahme in die weiterführenden Bildungsgänge gemäss der entsprechenden Gesetzgebung|Abschluss der Volksschule]"
},
{
"key": "SLT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "SLT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "STG_STATUS",
"name": "Standortgespräch",
"typ": "Auswahl",
"wertebereich": "[Standortgespräch hat stattgefunden|Das Angebot wurde nicht genutzt]"
},
{
"key": "TTG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ZUSATZBERICHT_LIEGT_BEI",
"name": "liegt bei",
"typ": "Boolean",
"wertebereich": "[0|1]"
}
],
"key": "sek_d_7",
"name": "der 7. Klasse"
},
{
"faecher": [
{
"key": "ABW_ENT",
"name": "Entschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ABW_UNENT",
"name": "Unentschuldigt (in Lektionen)",
"typ": "Zahl",
"wertebereich": "[]"
},
{
"key": "ADS_BESUCHT",
"name": "besucht",
"typ": "Textfeld",
"wertebereich": "[]"
},
{
"key": "BG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "BS_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "DT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "DT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "EN_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "FR_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "FR_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "HSK_BESUCHT",
"name": "besucht",
"typ": "Boolean",
"wertebereich": "[0|1]"
},
{
"key": "MT_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "MU_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "MUI_BESUCHT",
"name": "besucht",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "NT_NOTE",
"name": "Note (Natur und Technik)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "WAH_NOTE",
"name": "Note (Wirtschaft, Arbeit, Haushalt)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "RZG_NOTE",
"name": "Note (Räume, Zeiten, Gesellschaften)",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ERG_BESUCHT",
"name": "Unterricht (Ethik, Religionen, Gemeinschaft)",
"typ": "Auswahl",
"wertebereich": "[besucht|-]"
},
{
"key": "SLE_STATUS",
"name": "Schullaufbahnentscheid der Schulleitung",
"typ": "Auswahl",
"wertebereich": "[Übertritt ins nächste Schuljahr|Überspringen eines Schuljahres|Wiederholen eines Schuljahres|Zuweisung zu einer Klasse zur besonderen Förderung (KbF)|Rückführung aus einer besonderen Klasse in die Regelklasse|Aufnahme in die weiterführenden Bildungsgänge gemäss der entsprechenden Gesetzgebung|Abschluss der Volksschule]"
},
{
"key": "SLT_NIVEAU_ALT",
"name": "Niveau Aktuell",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "SLT_NIVEAU_NEU",
"name": "Niveau Neu",
"typ": "Auswahl",
"wertebereich": "[-|Real|Sek|Spez. Sek]"
},
{
"key": "STG_STATUS",
"name": "Standortgespräch",
"typ": "Auswahl",
"wertebereich": "[Standortgespräch hat stattgefunden|Das Angebot wurde nicht genutzt]"
},
{
"key": "TTG_NOTE",
"name": "Note",
"typ": "Auswahl",
"wertebereich": "[6.0|5.5|5.0|4.5|4.0|3.5|3.0|2.5|2.0|1.5|1.0|6.0*|5.5*|5.0*|4.5*|4.0*|3.5*|3.0*|2.5*|2.0*|1.5*|1.0*|-|besucht]"
},
{
"key": "ZUSATZBERICHT_LIEGT_BEI",
"name": "liegt bei",
"typ": "Boolean",
"wertebereich": "[0|1]"
}
],
"key": "ss_d_7",
"name": "der 7. Klasse"
}
],
"key": "BEBE_DT_P7_V2",
"name": "Beurteilungsbericht 7. Schuljahr"
}
Noten für Bericht importieren
- Produktion: https://www.beurteilung.apps.be.ch/api/import/evaluationimport
- Testsystem: https://www.testbeurteilung.apps.be.ch/api/import/evaluationimport
- Experimenal: https://bu21exp.cse.ch/api/import/evaluationimport
Methode: POST
Header
- Authorization: Token <Token von token-auth>
- soenumber: Schulnummer
- schoolYear: Schuljahr (Format 2022_2023)
Body (Beispiel):
{
"schulkinder" :
[
{
"name": "Baur",
"vorname": "Friedrich",
"geburtsdatum": "27.11.2018",
"reports":
[
{
"key": "BEBE_DT_P7_V1",
"faecher": [
{
"key": "ABW_ENT",
"value": "5"
},
{
"key": "ABW_UNENT",
"value": "11"
},
{
"key": "ADS_BESUCHT",
"value": "Test ADS"
},
{
"key": "BS_NOTE",
"value": "5.5"
},
{
"key": "FR_NOTE",
"value": "4.5"
},
{
"key": "HSK_BESUCHT",
"value": "1"
},
{
"key": "MT_NOTE",
"value": "4.0"
},
{
"key": "MU_NOTE",
"value": "6.0"
},
{
"key": "DT_NOTE",
"value": "5.0"
},
{
"key": "SLE_STATUS",
"value": "Übertritt ins nächste Schuljahr"
},
{
"key": "STG_STATUS",
"value": "Das Angebot wurde nicht genutzt"
},
{
"key": "ZUSATZBERICHT_LIEGT_BEI",
"value": "1"
}
]
}
]
},
{
"name": "Ferrari",
"vorname": "Leano",
"geburtsdatum": "12.12.2015",
"reports": [
{
"key": "BEBE_DT_P7_V1",
"faecher": [
{
"key": "ABW_ENT",
"value": "7"
},
{
"key": "ABW_UNENT",
"value": "0"
}
]
}
]
},
{
"name": "Lanz",
"vorname": "Monika",
"geburtsdatum": "08.08.2020",
"reports": [
{
"key": "BEBE_DT_P7_V1",
"faecher": [
{
"key": "ABW_ENT",
"value": "9"
},
{
"key": "ABW_UNENT",
"value": "1"
}
]
}
]
}
]
}Rückgabe:
Rückgabe:
Alles ok
{
"errors": []
}Im Fehlerfall:
Schule existiert nicht
{
"errors": [
{
"error_message": "School does not exist"
}
]
}Schulkind existiert nicht
{
"errors": [
{
"error_message": "eval_import.error.student_not_found",
"first_name": "Friedrich",
"last_name": "Baur",
"birthdate": "2018-11-27"
},
{
"error_message": "eval_import.error.student_not_found",
"first_name": "Leano",
"last_name": "Ferrari",
"birthdate": "2015-12-12"
},
{
"error_message": "eval_import.error.student_not_found",
"first_name": "Monika",
"last_name": "Lanz",
"birthdate": "2020-08-08"
}
]
}
Fehler in den erfassten Werten
{
"errors": [
{
"error_message": "eval_import.field_code_not_in_accepted_code_d",
"first_name": "Friedrich",
"last_name": "Baur",
"birthdate": "2018-11-27",
"field_code": "d",
"field_value": "5"
},
{
"error_message": "eval_import.value_not_accepted_4.0d",
"first_name": "Friedrich",
"last_name": "Baur",
"birthdate": "2018-11-27",
"field_code": "MT_NOTE",
"field_value": "4.0d"
}
]
}