District Term
- Zach Zhao (Unlicensed)
| Property | Data Type | Description |
|---|---|---|
| DistrictTermID | INTEGER | a unique ID that identifies the district term in the LinkIt! database. This property is required when editing or deleting a district term. |
| Name | STRING (100) | the name of the district term. EXAMPLES: 2012-13 FY, 12-13 Q2 |
| Code | STRING (50) | the code used by some Student Information System to identify district terms. Reserved for future use. |
| DateStart | DATETIME | the start date of the district term. EXAMPLE: 8/1/2012 12:00:00 AM |
| DateEnd | DATETIME | the end date of the district term. EXAMPLE: 9/30/2013 12:00:00 AM |
| CreatedDate | DATETIME | the date and time when the district term is created in the LinkIt! database. EXAMPLE: 9/30/2013 12:00:00 AM |
| ModifiedDate | DATETIME | the date and time when the district term is last updated in the LinkIt! database. EXAMPLE: 9/30/2013 12:00:00 AM |
The examples provided here are meant to illustrate the format in which the requested information is returned following an API call. In many cases, you do not have to conform strictly to these formats when searching for, editing or creating a district term. E.g. MM/DD/YYYY, MM/DD/YY, M/D/YYYY are all acceptable DATETIME formats.
The Name of the district term is visible to the user on the LinkIt! portal when generating bubble sheets or assigning online tests. It is also often appended to the end of the class name in various parts of the LinkIt! reporting module to help users differentiate classes that are taught in multiple years/semesters/quarters. Furthermore, the exact name of the district term has to be included in the roster when creating classes via the LinkIt! roster uploader. Therefore, a succinct and meaningful district term name is always recommended.
DateStart and DateEnd are the other two important properties of a district term. Together, they define the date range during which the district term is considered active by the system. The status of a district term affects the user experience in various ways:
- Only classes associated with an active district term are considered active classes by the system.
- Only students associated with an active class are considered active students by the system.
- Users cannot generate bubble sheets for classes that have expired.
- Users cannot assign online tests to classes that have expired.
- On the Teacher Reporting Dashboard within LinkIt!, only classes whose associated district terms overlap with the selected date range will show up.
As such, we recommend setting the DateStart a few days before the actual start date of the district term and DateEnd a few days after the actual end date of the district term. This will provide users with some buffer time when generating bubble sheets or assigning tests online (e.g. in the case of make-up tests).
Navigation and Reference