Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
api:api_applications_id_studyplans_id [2015/02/13 16:17] – [Explanation of data] Lauri Elevantapi:api_applications_id_studyplans_id [2016/06/01 14:48] – [Explanation of data] Lauri Elevant
Line 3: Line 3:
 ===== HEAD, GET ===== ===== HEAD, GET =====
  
-A study plan is always created in a particular application and are related to a particular course (you can see the identifiers in the example data below).+A study plan is always created in a particular application and are related to a particular course.
  
 +==== Insert subjects vs Select subjects ====
 +
 +If you look at the tow examples below, you can see that there is a small different in the way the ''subjects'' property is formed. 
 +
 +This has to do with two different ways a study plan can be created in DreamApply.
 +
 +a) if the subjects list has been imported into DreamApply, then the applicant can simply "tick" the subjects he/she wants to take. This is both easier for the applicant and guarantees that the data in the study plan is consistent. This also means that each subject has a proper ID, thus we can show it in the ''subjects'' dataset.
 +  
 +b) if the subjects list is not inserted into DreamApply, the applicant is presented with a form that he/she can fill manually, by typing the code, name, Fall/Spring and credits points manually. It is expected that the applicant has some sort of Excel/PDF for reference, but obviously there is no guarantee that the data in the study plan is correct.
  
  
Line 12: Line 21:
   * ''code'' This is the subject code, normally what is used by the university internally. You may use this code to match the study plan entries to your SIS.   * ''code'' This is the subject code, normally what is used by the university internally. You may use this code to match the study plan entries to your SIS.
   * ''name'' name of the subject.   * ''name'' name of the subject.
-  * ''academic-year'' holds an identifier to a resource describing the academic year (Fall,Spring etc.).+  * ''academic-term-type'' holds an identifier to a resource describing the academic year (Fall,Spring etc.).
   * ''credits'' is the number of ECTS credits for this subject.   * ''credits'' is the number of ECTS credits for this subject.
-  * ''type'' refers to the [[api:api_classificators|classificator]] ''Subject type''.+  * ''type'' refers to the [[api:api_classificators|classificator]] ''Subject type''. This is only available if the applicant selects the subjects (as opposed to inserting manually).
  
 The statuses can currently be: The statuses can currently be:
Line 42: Line 51:
             "code": "ASTR",             "code": "ASTR",
             "name": "Astronomy",             "name": "Astronomy",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "5"             "credits": "5"
         },         },
Line 48: Line 57:
             "code": "BOT",             "code": "BOT",
             "name": "Botany",             "name": "Botany",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "2"             "credits": "2"
         },         },
Line 54: Line 63:
             "code": "CAL",             "code": "CAL",
             "name": "Calligraphy",             "name": "Calligraphy",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "3"             "credits": "3"
         }         }
Line 61: Line 70:
     "revised": "2015-02-13T15:56:10+00:00",     "revised": "2015-02-13T15:56:10+00:00",
     "course": "/api/courses/321",     "course": "/api/courses/321",
 +    "applicant": "/api/applicants/123",
     "application": "/api/applications/123",     "application": "/api/applications/123",
     "status": "Prepare"     "status": "Prepare"
   }   }
- 
 ==== Response example (applicant chooses subjects) ==== ==== Response example (applicant chooses subjects) ====
  
Line 73: Line 82:
             "type": "UG",             "type": "UG",
             "name": "Astronomy",             "name": "Astronomy",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "5"             "credits": "5"
         },         },
Line 80: Line 89:
             "type": "UG",             "type": "UG",
             "name": "Botany",             "name": "Botany",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "2"             "credits": "2"
         },         },
Line 87: Line 96:
             "type": "UG",             "type": "UG",
             "name": "Calligraphy",             "name": "Calligraphy",
-            "academic-term": "/api/academic-terms/1",+            "academic-term-type": "/api/academic-terms/types/1",
             "credits": "3"             "credits": "3"
         }         }
Line 94: Line 103:
     "revised": "2015-02-13T15:56:10+00:00",     "revised": "2015-02-13T15:56:10+00:00",
     "course": "/api/courses/321",     "course": "/api/courses/321",
 +    "applicant": "/api/applicants/123",
     "application": "/api/applications/123",     "application": "/api/applications/123",
     "status": "Prepare"     "status": "Prepare"
   }   }