cleo/DocScoDocPE
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge branch 'master' of https://scodoc.org/git/leonard.montalbano/DocScoDoc

Browse Source
This commit is contained in:
Emmanuel Viennet 2022-05-06 17:46:07 +02:00
commit b56018283a
1 changed files with 81 additions and 195 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

272
docs/ScoDoc9API.md
View File

@ -167,8 +167,8 @@ informations suivantes:
* **`liste_etudiants`**
* **Méthode:** GET
* **Paramètres:** `dept`, `formsemestre_id`
* **Routes:** `/departements/<string:dept>/etudiants/liste` ou `/api/departements/<string:dept>/etudiants/liste/<int:formsemestre_id>`
* **Exemple d'utilisation:** `/api/departements/MMI/etudiants/liste`
* **Routes:** `/departements/<string:dept>/etudiants/list` ou `/api/departements/<string:dept>/etudiants/list/<int:formsemestre_id>`
* **Exemple d'utilisation:** `/api/departements/MMI/etudiants/list`
* **Résultat:** liste des étudiants d'un département, par défaut, ou d'un semestre si renseigné. (json)
* **Exemple de résultat:**
```
@ -210,16 +210,11 @@ informations suivantes:
```
[
{
"titre": "master machine info",
"gestion_semestrielle": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"bul_bgcolor": null,
"date_fin": "15/12/2022",
"date_fin": "31/08/2022",
"resp_can_edit": false,
"dept_id": 1,
"etat": true,
"resp_can_change_ens": false,
"resp_can_change_ens": true,
"id": 1,
"modalite": "FI",
"ens_can_edit_eval": false,
@ -229,31 +224,27 @@ informations suivantes:
"semestre_id": 1,
"bul_hide_xml": false,
"elt_annee_apo": null,
"titre": "Semestre test",
"block_moyennes": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"gestion_semestrielle": false,
"bul_bgcolor": "white",
"formsemestre_id": 1,
"titre_num": "master machine info semestre 1",
"titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-12-15",
"date_fin_iso": "2022-08-31",
"responsables": [
3,
2
]
12,
42
],
"titre_court": "BUT MMI"
},
...
]
```
* **`referentiel_competences`**
* **Méthode:** GET
* **Paramètres:** `dept`, `formation_id`
* **Routes:** `/departements/<string:dept>/formations/<int:formation_id>/referentiel_competences`
* **Exemple d'utilisation:** `api/departements/MMI/formations/1/referentiel_competences`
* **Résultat:** Le référentiel de compétences d'une formation donnée (json). (_pas toujours présent_)
* XXX obtenir la liste des référentiels
### Etudiants
* **`etudiants_courant`**
@ -352,8 +343,13 @@ informations suivantes:
"titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31",
"responsables": []
}
"responsables": [
12,
42
],
"titre_court": "BUT MMI"
},
...
]
```
@ -575,30 +571,13 @@ informations suivantes:
## Programmes de formations
* **`formations`**
* **`formations_ids`**
* **Méthode:** GET
* **Routes:** `/ScoDoc/api/formations`
* **Exemple d'utilisation:** `/ScoDoc/api/formations`
* **Résultat:** Liste des formations.
* **Exemple de résultat:**
```
[
{
"id": 1,
"acronyme": "BUT R&amp;T",
"titre_officiel": "Bachelor technologique réseaux et télécommunications",
"formation_code": "V1RET",
"code_specialite": null,
"dept_id": 1,
"titre": "BUT R&amp;T",
"version": 1,
"type_parcours": 700,
"referentiel_competence_id": null,
"formation_id": 1
},
...
]
```
* **Routes:** `/ScoDoc/api/formations_ids`
* **Exemple d'utilisation:** `/ScoDoc/api/formations_ids`
* **Résultat:** Retourne la liste de toutes les id de formations (tous départements)
* **Exemple de résultat:** `[17, 99, 32]`
* **`formations_by_id`**
* **Méthode:** GET
@ -624,7 +603,7 @@ informations suivantes:
```
* **`formation_export_by_formation_id`**
* **Méthode:** GET
* **Paramètres:** `formation_id`, `export_ids` (False par défaut)
* **Paramètres:** `formation_id`, `export_ids` (False par défaut. Ajouter `/with_ids` pour le passer à True)
* **Routes:** `/formations/formation_export/<int:formation_id>`
* **Exemple d'utilisation:** `/ScoDoc/api/formations/formation_export/1`
* **Résultat:** Retourne la formation, avec UE, matières, modules
@ -716,6 +695,14 @@ informations suivantes:
]
}
```
* **`referentiel_competences`**
* **Méthode:** GET
* **Paramètres:** `formation_id`
* **Routes:** `/formations/<int:formation_id>/referentiel_competences`
* **Exemple d'utilisation:** `api/formations/1/referentiel_competences`
* **Résultat:** Le référentiel de compétences d'une formation donnée (json). (_pas toujours présent_)
* XXX obtenir la liste des référentiels
### Semestres de formation
Les sessions de formation (dénommées "semestres" même si elles durent une année ou un mois) sont représentées par les `formsemestre`.
@ -753,7 +740,11 @@ Les sessions de formation (dénommées "semestres" même si elles durent une ann
"titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31",
"responsables": []
"responsables": [
12,
42
],
"titre_court": "BUT MMI"
}
```
* **`formsemestre_apo`**
@ -764,148 +755,43 @@ Les sessions de formation (dénommées "semestres" même si elles durent une ann
* **Résultat:** Retourne les informations sur les formsemestres
* **Exemple de résultat:**
```
{
"date_fin": "31/08/2022",
"resp_can_edit": false,
"dept_id": 1,
"etat": true,
"resp_can_change_ens": true,
"id": 1,
"modalite": "FI",
"ens_can_edit_eval": false,
"formation_id": 1,
"gestion_compensation": false,
"elt_sem_apo": null,
"semestre_id": 1,
"bul_hide_xml": false,
"elt_annee_apo": null,
"titre": "Semestre test",
"block_moyennes": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"gestion_semestrielle": false,
"bul_bgcolor": "white",
"formsemestre_id": 1,
"titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31",
"responsables": []
}
[
{
"date_fin": "31/08/2022",
"resp_can_edit": false,
"dept_id": 1,
"etat": true,
"resp_can_change_ens": true,
"id": 1,
"modalite": "FI",
"ens_can_edit_eval": false,
"formation_id": 1,
"gestion_compensation": false,
"elt_sem_apo": null,
"semestre_id": 1,
"bul_hide_xml": false,
"elt_annee_apo": null,
"titre": "Semestre test",
"block_moyennes": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"gestion_semestrielle": false,
"bul_bgcolor": "white",
"formsemestre_id": 1,
"titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31",
"responsables": [
12,
42
],
"titre_court": "BUT MMI"
},
...
]
```
* **`etudiant_bulletin`**
* **Méthode:** GET
* **Paramètres:** `formsemestre_id`, `dept`, `etudid`, `nip`, `ine`
* **Routes:** `/formsemestre/<int:formsemestre_id>/departements/<string:dept>/etudiant/etudid/<int:etudid>/bulletin` ou `/formsemestre/<int:formsemestre_id>/departements/<string:dept>/etudiant/nip/<int:nip>/bulletin` ou `/formsemestre/<int:formsemestre_id>/departements/<string:dept>/etudiant/ine/<int:ine>/bulletin`
* **Exemple d'utilisation:** `/ScoDoc/api/formsemestre/1/departements/MMI/etudiant/etudid/1/bulletin`
* **Résultat:** Retourne le bulletin de note d'un étudiant
* **Exemple de résultat:**
```
{
"etudid": 1,
"formsemestre_id": 1,
"date": "2022-04-27T10:44:47.448094",
"publie": true,
"etapes": [],
"etudiant": {
"etudid": 1,
"code_nip": "1",
"code_ine": "1",
"nom": "COSTA",
"prenom": "Sacha",
"civilite": "",
"photo_url": "/ScoDoc/TAPI/Scolarite/get_photo_image?etudid=1&amp;size=small",
"email": "SACHA.COSTA@example.com",
"emailperso": "",
"sexe": ""
},
"note": {
"value": "10.60",
"min": "-",
"max": "-",
"moy": "-"
},
"rang": {
"value": "10",
"ninscrits": 16
},
"rang_group": [
{
"group_type": "TD",
"group_name": "",
"value": "",
"ninscrits": ""
}
],
"note_max": {
"value": 20
},
"bonus_sport_culture": {
"value": 0
},
"ue": [
{
"id": 1,
"numero": "1",
"acronyme": "RT1.1",
"titre": "Administrer les réseaux et l’Internet",
"note": {
"value": "08.50",
"min": "06.00",
"max": "16.50",
"moy": "11.31"
},
"rang": "12",
"effectif": 16,
"ects": "12",
"code_apogee": "",
"module": [
{
"id": 1,
"code": "R101",
"coefficient": 1,
"numero": 10,
"titre": "Initiation aux réseaux informatiques",
"abbrev": "Init aux réseaux informatiques",
"note": {
"value": "12.00",
"moy": "-",
"max": "-",
"min": "-",
"nb_notes": "-",
"nb_missing": "-",
"nb_valid_evals": "-"
},
"code_apogee": "",
"evaluation": [
{
"jour": "2022-04-20",
"heure_debut": "08:00:00",
"heure_fin": "09:00:00",
"coefficient": 1,
"evaluation_type": 0,
"evaluation_id": 1,
"description": "eval1",
"note": "12.00"
}
]
}
]
}
],
"ue_capitalisee": [],
"absences": {
"nbabs": 2,
"nbabsjust": 1
},
"appreciation": []
}
```
* **`bulletins`**
* **Méthode:** GET
* **Paramètres:** `formsemestre_id`
@ -1099,7 +985,7 @@ Les sessions de formation (dénommées "semestres" même si elles durent une ann
XXX A COMPLETER
```
* **`semestre_index`**
* **`programme`**
* **Méthode:** GET
* **Paramètres:** `dept`, `formsemestre_id`
* **Routes:** `/formsemestre/<int:formsemestre_id>/programme`
@ -1220,8 +1106,8 @@ On peut récupérer soit un module par son id, soit la listes des modules d'un s
* **`moduleimpls_sem`**
* **Méthode:** GET
* **Paramètres:** `moduleimpl_id`
* **Routes:** `/formations/moduleimpl/formsemestre/<int:formsemestre_id>/liste`
* **Exemple d'utilisation:** `/ScoDoc/api/formations/moduleimpl/formsemestre/1/liste`
* **Routes:** `/formations/moduleimpl/formsemestre/<int:formsemestre_id>/list`
* **Exemple d'utilisation:** `/ScoDoc/api/formations/moduleimpl/formsemestre/1/list`
* **Résultat:** Retourne la liste des moduleimpl d'un semestre
* **Exemple de résultat:**
```