jmplace/DocScoDoc
1
0
Fork 0
forked from ScoDoc/DocScoDoc
Code Issues Pull Requests 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 cfb63987f9
1 changed files with 81 additions and 195 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

276
docs/ScoDoc9API.md
View File

@ -167,8 +167,8 @@ informations suivantes:
* **`liste_etudiants`** * **`liste_etudiants`**
* **Méthode:** GET * **Méthode:** GET
* **Paramètres:** `dept`, `formsemestre_id` * **Paramètres:** `dept`, `formsemestre_id`
* **Routes:** `/departements/<string:dept>/etudiants/liste` ou `/api/departements/<string:dept>/etudiants/liste/<int:formsemestre_id>` * **Routes:** `/departements/<string:dept>/etudiants/list` ou `/api/departements/<string:dept>/etudiants/list/<int:formsemestre_id>`
* **Exemple d'utilisation:** `/api/departements/MMI/etudiants/liste` * **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) * **Résultat:** liste des étudiants d'un département, par défaut, ou d'un semestre si renseigné. (json)
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```
@ -210,16 +210,11 @@ informations suivantes:
``` ```
[ [
{ {
"titre": "master machine info", "date_fin": "31/08/2022",
"gestion_semestrielle": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"bul_bgcolor": null,
"date_fin": "15/12/2022",
"resp_can_edit": false, "resp_can_edit": false,
"dept_id": 1, "dept_id": 1,
"etat": true, "etat": true,
"resp_can_change_ens": false, "resp_can_change_ens": true,
"id": 1, "id": 1,
"modalite": "FI", "modalite": "FI",
"ens_can_edit_eval": false, "ens_can_edit_eval": false,
@ -229,29 +224,25 @@ informations suivantes:
"semestre_id": 1, "semestre_id": 1,
"bul_hide_xml": false, "bul_hide_xml": false,
"elt_annee_apo": null, "elt_annee_apo": null,
"titre": "Semestre test",
"block_moyennes": false, "block_moyennes": false,
"scodoc7_id": null,
"date_debut": "01/09/2021",
"gestion_semestrielle": false,
"bul_bgcolor": "white",
"formsemestre_id": 1, "formsemestre_id": 1,
"titre_num": "master machine info semestre 1", "titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01", "date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-12-15", "date_fin_iso": "2022-08-31",
"responsables": [ "responsables": [
3, 12,
2 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
@ -352,8 +343,13 @@ informations suivantes:
"titre_num": "Semestre test semestre 1", "titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01", "date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31", "date_fin_iso": "2022-08-31",
"responsables": [] "responsables": [
} 12,
42
],
"titre_court": "BUT MMI"
},
...
] ]
``` ```
@ -575,30 +571,13 @@ informations suivantes:
## Programmes de formations ## Programmes de formations
* **`formations`** * **`formations_ids`**
* **Méthode:** GET * **Méthode:** GET
* **Routes:** `/ScoDoc/api/formations` * **Routes:** `/ScoDoc/api/formations_ids`
* **Exemple d'utilisation:** `/ScoDoc/api/formations` * **Exemple d'utilisation:** `/ScoDoc/api/formations_ids`
* **Résultat:** Liste des formations. * **Résultat:** Retourne la liste de toutes les id de formations (tous départements)
* **Exemple de résultat:** * **Exemple de résultat:** `[17, 99, 32]`
```
[
{
"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
},
...
]
```
* **`formations_by_id`** * **`formations_by_id`**
* **Méthode:** GET * **Méthode:** GET
@ -624,7 +603,7 @@ informations suivantes:
``` ```
* **`formation_export_by_formation_id`** * **`formation_export_by_formation_id`**
* **Méthode:** GET * **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>` * **Routes:** `/formations/formation_export/<int:formation_id>`
* **Exemple d'utilisation:** `/ScoDoc/api/formations/formation_export/1` * **Exemple d'utilisation:** `/ScoDoc/api/formations/formation_export/1`
* **Résultat:** Retourne la formation, avec UE, matières, modules * **Résultat:** Retourne la formation, avec UE, matières, modules
@ -715,8 +694,16 @@ 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 ### 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`. 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", "titre_num": "Semestre test semestre 1",
"date_debut_iso": "2021-09-01", "date_debut_iso": "2021-09-01",
"date_fin_iso": "2022-08-31", "date_fin_iso": "2022-08-31",
"responsables": [] "responsables": [
12,
42
],
"titre_court": "BUT MMI"
} }
``` ```
* **`formsemestre_apo`** * **`formsemestre_apo`**
@ -764,146 +755,41 @@ Les sessions de formation (dénommées "semestres" même si elles durent une ann
* **Résultat:** Retourne les informations sur les formsemestres * **Résultat:** Retourne les informations sur les formsemestres
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```
{ [
"date_fin": "31/08/2022", {
"resp_can_edit": false, "date_fin": "31/08/2022",
"dept_id": 1, "resp_can_edit": false,
"etat": true, "dept_id": 1,
"resp_can_change_ens": true, "etat": true,
"id": 1, "resp_can_change_ens": true,
"modalite": "FI", "id": 1,
"ens_can_edit_eval": false, "modalite": "FI",
"formation_id": 1, "ens_can_edit_eval": false,
"gestion_compensation": false, "formation_id": 1,
"elt_sem_apo": null, "gestion_compensation": false,
"semestre_id": 1, "elt_sem_apo": null,
"bul_hide_xml": false, "semestre_id": 1,
"elt_annee_apo": null, "bul_hide_xml": false,
"titre": "Semestre test", "elt_annee_apo": null,
"block_moyennes": false, "titre": "Semestre test",
"scodoc7_id": null, "block_moyennes": false,
"date_debut": "01/09/2021", "scodoc7_id": null,
"gestion_semestrielle": false, "date_debut": "01/09/2021",
"bul_bgcolor": "white", "gestion_semestrielle": false,
"formsemestre_id": 1, "bul_bgcolor": "white",
"titre_num": "Semestre test semestre 1", "formsemestre_id": 1,
"date_debut_iso": "2021-09-01", "titre_num": "Semestre test semestre 1",
"date_fin_iso": "2022-08-31", "date_debut_iso": "2021-09-01",
"responsables": [] "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`** * **`bulletins`**
@ -1099,7 +985,7 @@ Les sessions de formation (dénommées "semestres" même si elles durent une ann
XXX A COMPLETER XXX A COMPLETER
``` ```
* **`semestre_index`** * **`programme`**
* **Méthode:** GET * **Méthode:** GET
* **Paramètres:** `dept`, `formsemestre_id` * **Paramètres:** `dept`, `formsemestre_id`
* **Routes:** `/formsemestre/<int:formsemestre_id>/programme` * **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`** * **`moduleimpls_sem`**
* **Méthode:** GET * **Méthode:** GET
* **Paramètres:** `moduleimpl_id` * **Paramètres:** `moduleimpl_id`
* **Routes:** `/formations/moduleimpl/formsemestre/<int:formsemestre_id>/liste` * **Routes:** `/formations/moduleimpl/formsemestre/<int:formsemestre_id>/list`
* **Exemple d'utilisation:** `/ScoDoc/api/formations/moduleimpl/formsemestre/1/liste` * **Exemple d'utilisation:** `/ScoDoc/api/formations/moduleimpl/formsemestre/1/list`
* **Résultat:** Retourne la liste des moduleimpl d'un semestre * **Résultat:** Retourne la liste des moduleimpl d'un semestre
* **Exemple de résultat:** * **Exemple de résultat:**
``` ```