| Classes in this File | Line Coverage | Branch Coverage | Complexity | ||||
| CourseOfferingAdminDisplay |
|
| 1.0;1 |
| 1 | package org.kuali.student.enrollment.courseoffering.infc; | |
| 2 | ||
| 3 | import org.kuali.student.r2.common.infc.IdEntity; | |
| 4 | import org.kuali.student.r2.common.infc.IdNamelessEntity; | |
| 5 | import org.kuali.student.r2.common.infc.RichText; | |
| 6 | ||
| 7 | import java.util.List; | |
| 8 | ||
| 9 | ||
| 10 | public interface CourseOfferingAdminDisplay extends IdNamelessEntity { | |
| 11 | ||
| 12 | ||
| 13 | ||
| 14 | /** | |
| 15 | * Custom Descr for the course Offering | |
| 16 | * @name Course Offering Description | |
| 17 | */ | |
| 18 | public RichText getDescr(); | |
| 19 | ||
| 20 | /** | |
| 21 | * A unique identifier assigned to all approved courses that exist | |
| 22 | * in the catalog This is not updatable once initialized. | |
| 23 | * | |
| 24 | * @name Course Id | |
| 25 | * @readOnly | |
| 26 | * @required | |
| 27 | * @impl this maps the the version dependent id as the offering | |
| 28 | * must point to one and only one version of the | |
| 29 | * course. Maps to cluId in Lui. | |
| 30 | */ | |
| 31 | public String getCourseId(); | |
| 32 | ||
| 33 | ||
| 34 | /** | |
| 35 | * Academic term of course offering | |
| 36 | * | |
| 37 | * @name Term Id | |
| 38 | * @readOnly | |
| 39 | * @required | |
| 40 | * @impl set during the #createCourseOffering and then maps to | |
| 41 | * the aptKey on the Lui | |
| 42 | */ | |
| 43 | public String getTermId(); | |
| 44 | ||
| 45 | ||
| 46 | /** | |
| 47 | * Identifies the number of a course as reflected in the course catalog. | |
| 48 | * This typically must be unique across all courses offered during that | |
| 49 | * term. If the user wants to create two separate offerings for the same | |
| 50 | * course they must modify this code to make it unique. For example: An | |
| 51 | * on-line offering of the course might have an "O" appended to it to | |
| 52 | * distinguish it from the face to face offering, i.e. ENG101 and ENG101O | |
| 53 | * Initially copied from the course catalog but then, depending on the | |
| 54 | * configuration it may be updatable. Often this field is configured so that | |
| 55 | * it is not not directly updatable but rather is calculated from it's two | |
| 56 | * constituent parts, the subject area and the course number suffix. For | |
| 57 | * example: Subject Area = "ENG" and Suffix = "101" then code = "ENG101" | |
| 58 | * | |
| 59 | * @name Course Offering Code | |
| 60 | * @readOnly | |
| 61 | */ | |
| 62 | public String getCourseOfferingCode(); | |
| 63 | ||
| 64 | /** | |
| 65 | * Identifies the department and/subject code of the course as reflected in | |
| 66 | * the course catalog. Initially copied from the course catalog but then, | |
| 67 | * depending on the configuration it may be updatable. In most | |
| 68 | * configurations this should not be updatable. Often used in the | |
| 69 | * calculation of the courseCode | |
| 70 | * | |
| 71 | * @name Subject Area | |
| 72 | * @readOnly | |
| 73 | */ | |
| 74 | public String getSubjectArea(); | |
| 75 | ||
| 76 | /** | |
| 77 | * Name of the course used in the college catalog. Initially copied from the | |
| 78 | * course catalog but then, depending on the configuration it may be | |
| 79 | * updatable. For regular courses this is not generally allowed to be | |
| 80 | * updated on the offering, but for special topics courses this is often | |
| 81 | * overridden to capture the particular topic being taught offered this | |
| 82 | * term. Note: the configuration of the validation for titles is typically | |
| 83 | * restricted to exclude line breaks. This may have to be loosened as some | |
| 84 | * schools may want the particular topic to appear on a 2nd line. For | |
| 85 | * example: SPECIAL TOPICS: AN EXPLORATION OF DEEP SPACE ARTIFACTS | |
| 86 | * | |
| 87 | * @name Course Title | |
| 88 | * @readOnly | |
| 89 | \ */ | |
| 90 | public String getCourseOfferingTitle(); | |
| 91 | ||
| 92 | ||
| 93 | ||
| 94 | ||
| 95 | /** | |
| 96 | * The name of the Type that the Course Offering or the underlying LUI | |
| 97 | * is of. | |
| 98 | * | |
| 99 | * @name Type name | |
| 100 | * @readOnly on updates | |
| 101 | * @impl Name of the type the CO Info is of, read from TypeInfo object | |
| 102 | */ | |
| 103 | public String getTypeName(); | |
| 104 | ||
| 105 | /** | |
| 106 | * The name of the State that the Course Offering or the underlying LUI | |
| 107 | * is in. | |
| 108 | * | |
| 109 | * @name State Name Owner | |
| 110 | * @readOnly on updates | |
| 111 | * @impl Name of the state the CO Info is in, read from StateInfo object | |
| 112 | */ | |
| 113 | public String getStateName(); | |
| 114 | ||
| 115 | /** | |
| 116 | * The display value of the credit, this is derived by fetching the result value groups for the credit option tied | |
| 117 | * to the course offering and concatenating the values of the options. | |
| 118 | * | |
| 119 | * @name Display Credit | |
| 120 | * @impl Get the credit option values and concatenate to a single field | |
| 121 | * @readOnly on updates | |
| 122 | */ | |
| 123 | public String getDisplayCredit(); | |
| 124 | ||
| 125 | /** | |
| 126 | * The display value of the grading options, this is derived by fetching the result value groups for the grading option tied | |
| 127 | * to the course offering and concatenating the values of the options. | |
| 128 | * | |
| 129 | * @name Display Grading | |
| 130 | * @impl Get the credit option values and concatenate to a single field | |
| 131 | * @readOnly on updates | |
| 132 | */ | |
| 133 | public String getDisplayGrading(); | |
| 134 | ||
| 135 | /** | |
| 136 | * Activty offering types for the course offering | |
| 137 | * | |
| 138 | * @name Actvity Offering Types | |
| 139 | * @impl Get the format offering for the course offering and then the activity types from the Format offering | |
| 140 | * @readOnly on updates | |
| 141 | */ | |
| 142 | public List<String> getActivtyOfferingTypes(); | |
| 143 | ||
| 144 | /** | |
| 145 | * Code for the term the course offering is in | |
| 146 | * | |
| 147 | * @name Term Code | |
| 148 | * @readOnly on updates | |
| 149 | */ | |
| 150 | public String getTermCode(); | |
| 151 | ||
| 152 | ||
| 153 | ||
| 154 | /** | |
| 155 | * Name of the Term the Course Offering is in | |
| 156 | * | |
| 157 | * @name Term Name | |
| 158 | * @readOnly on updates | |
| 159 | */ | |
| 160 | public String getTermName(); | |
| 161 | ||
| 162 | ||
| 163 | ||
| 164 | } |