Opetussuunnitelma sisältää opetussuunnitelman kuvaustiedot, tiedot ajoitussuunnitelmista ja opintopoluista sekä listan rakennenäkymiä.
Oliomalli
Opetussunnitelma sisältää kuvaustiedot ja listan rakennenäkymiä.
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| id | numero | Opetussuunnitelman yksilöllinen tunniste |
| code | teksti | Tunnus |
| name | teksti | Nimi |
| description | teksti | Kuvaus |
| content | teksti | Sisältö |
| furtherInformation | teksti | Lisätiedot |
| currentStatus | teksti | Opetussuunnitelman tila, luonnos "DRAFT", valmis hyväksyttäväksi "READY", hyväksytty "APROVED", julkaistu "PUBLISHED" |
| duration | numero | Opetussuunnitelman kesto |
| language | teksti | Opetussuunnitelman kieli |
| plans | lista | Lista ajoitussuunnitelmien kuvaustietoja, jotka on liitetty opetussuunnitelmaan |
| specialisationOptions | lista | Lista opintopolkujen kuvaustietoja, jotka on liitetty opetussuunnitelmaan |
| structureViews | lista | Lista rakennenäkymiä. |
Opintojakson kuvaustiedot
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| id | numero | Opintojakson yksilöllinen tunniste |
| code | teksti | Tunnus |
| name | teksti | Nimi |
| credits | numero | Opintopistemäärä |
| currentStatus | teksti | Opintojakson tila |
| yearOfFoundation | numero | Perustamisvuosi |
| teachingLanguage | teksti | Opetuskieli |
| content | teksti | Opintojakson sisältö |
| furtherInformation | teksti | Lisätiedot |
| qualifications | teksti | Esitietovaatimukset |
| objective | teksti | Osaamistavoitteet |
| evaluationCriteria1 | teksti | Arviointikriteeri, tyydyttävä (1-2) |
| evaluationCriteria2 | teksti | Arviointikriteeri, hyvä (3-4) |
| evaluationCriteria3 | teksti | Arviointikriteeri, kiitettävä (5) |
| evaluationCriteria4 | teksti | Arviointikriteeri, hyväksytty/hylätty |
| teachingMethods | teksti | Opetusmetodit |
| materials | teksti | Materiaalit |
Haku
Haku palauttaa sisällön kielen mukaan seuraavasti. Ensisijaisesti käytetään pyynnön header-tietoihin asetettua "Accept-Language" tietoa, muuten kielitieto luetaan erillisestä parametrista esim. "?l=fi". Oletuksena käytetään suomea.
Opetussuunnitelmien haku
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| name | teksti | Opetussuunnitelman nimi |
| codes | lista | Lista opetussuunnitelman tunnuksia |
| specialisationStructureViews | lista | Lista opintopolkuja, joille halutaan oma rakennenäkymä. Mikäli halutaan palauttaa rakennenäkymät jokaista opintopolkua varten, asetetaan listan ensimmäiseksi tunnisteeksi "all" |
| accomplishmentPlanStructureViews | lista | Lista ajoitussuunnitelmien tunnisteita, joille halutaan oma rakennenäkymä. Mikäli halutaan palauttaa rakennenäkymät jokaista ajoitussuunnitelmaa varten, asetetaan listan ensimmäiseksi tunnisteeksi "all" |
Esimerkki:
{
"codes": ["GS05S_W0808"],
"specialisationStructureViews": ["all"],
"accomplishmentPlanStructureViews": ["all"]
}
Opetussuunnitelman hakeminen tunnuksen perusteella:
curl -u "oma_api_key:" -X POST http://opendata.metropolia.fi/r1/curriculum/search -d '{ "codes": ["GS05S_W0808"]}'
Vastaus
| Kenttä | Kuvaus |
|---|---|
| status | Tieto onnistuiko pyyntö vai oliko mahdollisia virheitä. "success", "warn", "error" |
| message | Mahdollinen tarkentava viesti esimerkiksi virhetilanteissa. |
| programmes | Opetussuunnitelmien tiedot |
Esimerkki:
{
"status": "success",
"programmes": [ {
"id": "62868",
"code": "GS05S_W0808",
"currentStatus": "DRAFT",
"duration": 4,
"language": "fi",
"plans": [ {
"id": "3308",
"startSemester": 0,
"startYear": 2012,
"name": "Oletussuunnitelma"
}],
"specialisationOptions": [ {
"id": "370",
"name": "Graafinen suunnittelu",
"shortName": "Graafi",
"description": "GRAAFINE"
}],
"structureViews": [
{
"id": "182222",
"relations": [
{
"id": "182222",
"level": "0",
"treeId": "182222",
"learningUnit": {
"id": "62868",
"code": "GS05S_W0808",
"credits": 182,
"type": "PROGRAMME",
"status": "DRAFT",
"name": "Viestinnän koulutusohjelma"
}
},
{
"id": "182223",
"level": "1",
"treeId": "182222",
"learningUnit": {
"id": "62869",
"code": "GS05S_W0808-1000",
"credits": 50,
"type": "STUDY_MODULE",
"status": "DRAFT",
"luOptionality": "ALL_OF",
"name": "Perusopinnot"
}
},
{
"id": "182225",
"level": "2",
"treeId": "182222",
"learningUnit": {
"id": "78459",
"code": "MUK1011",
"credits": 3,
"type": "COURSE_UNIT",
"status": "DRAFT",
"name": "Piirustus ja maalaus I"
}
}
]
},
{
"id": "s370",
"relations": [
{
"id": "182222",
"level": "0",
"treeId": "182222",
"learningUnit": {
"id": "62868",
"code": "GS05S_W0808",
"credits": 6,
"type": "PROGRAMME",
"status": "DRAFT",
"name": "Viestinnän koulutusohjelma"
}
}
]
},
{
"id": "a3308",
"relations": [
{
"id": "182222",
"level": "0",
"treeId": "182222",
"learningUnit": {
"id": "62868",
"code": "GS05S_W0808",
"credits": 182,
"type": "PROGRAMME",
"status": "DRAFT",
"name": "Viestinnän koulutusohjelma"
},
"periods": [
{
"credits": 0,
"periodNumber": 0
},
{
"credits": 0,
"periodNumber": 1
},
{
"credits": 0,
"periodNumber": 2
},
{
"credits": 0,
"periodNumber": 3
},
{
"credits": 0,
"periodNumber": 4
},
{
"credits": 0,
"periodNumber": 5
},
{
"credits": 0,
"periodNumber": 6
},
{
"credits": 0,
"periodNumber": 7
},
{
"credits": 0,
"periodNumber": 8
},
{
"credits": 0,
"periodNumber": 9
},
{
"credits": 0,
"periodNumber": 10
},
{
"credits": 0,
"periodNumber": 11
},
{
"credits": 0,
"periodNumber": 12
},
{
"credits": 0,
"periodNumber": 13
},
{
"credits": 0,
"periodNumber": 14
},
{
"credits": 0,
"periodNumber": 15
}
]
}
]
}
],
"name": "Viestinnän koulutusohjelma",
"description": "",
"content": "",
"development": "",
"furtherInformation": ""
}]
}
Opintojaksojen haku
| Kenttä | Tyyppi | Kuvaus |
|---|---|---|
| name | teksti | Opintojakson nimi |
| codes | lista | Lista opintojaksojen tunnuksia |
Esimerkki:
{
"codes": ["TD00AB32"]
}
Opintojakson hakeminen tunnuksen perusteella:
curl -u "oma_api_key:" -X POST http://opendata.metropolia.fi/r1/courseunit/search -d '{ "codes": ["TD00AB32"]}'
Vastaus
| Kenttä | Kuvaus |
|---|---|
| status | Tieto onnistuiko pyyntö vai oliko mahdollisia virheitä. "success", "warn", "error" |
| message | Mahdollinen tarkentava viesti esimerkiksi virhetilanteissa. |
| courseUnits | Opintojaksot |
Esimerkki:
{
"status": "success",
"courseUnits": [ {
"id": "89460",
"code": "TD00AB32",
"credits": 3,
"currentStatus": "DRAFT",
"yearOfFoundation": 2011,
"name": "Ohjelmointi 2",
"content": "1. Muuttujat ja tietotyypit.\r\n2. Ohjelman perusrakenteet: peräkkäisyys, valinta ja toisto.\r\n3. Tietorakenteet, esim. taulukot ja tietueet.\r\n4. Omien funktioiden ja aliohjelmien määrittely.\r\n5. Tekstitiedostojen käyttö.\r\n6. Olio-ohjelmoinnin perusteet.",
"furtherInformation": "",
"qualifications": "Ohjelmointi 1",
"objective": "- Opiskelija osaa ohjelmoida jollakin Olio-ohjelmointikielellä (C++, C#, Java).\r\n- Opiskelija osaa ohjelmointikielen perusrakenteet ja toiminnan. \r\n- Opiskelija tuntee Olio-ohjelmoinnin peruskäsitteet: luokka, olio, metodi ja attribuutti.",
"evaluationCriteria1": "Kokeessa suoritettu vähintään 40 % oikein ja suurin osa kurssin viikkotehtävistä on suoritettu.",
"evaluationCriteria2": "Kokeessa suoritettu vähintään 60 % oikein ja suurin osa kurssin viikkotehtävistä on suoritettu.",
"evaluationCriteria3": "Kokeessa suoritettu vähintään 80 % oikein ja kaikki kurssin viikkotehtävät on suoritettu.",
"evaluationCriteria4": "",
"teachingMethods": "",
"materials": ""
}]
}