Create an academic level
post
/fscmRestApi/resources/11.13.18.05/academicLevels
Request
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
-
Upsert-Mode: string
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
assignments: array
Assignments
Title:
AssignmentsThe assignments resource provides a list of academic entities which have been assigned. -
Description: string
Title:
Academic Level DescriptionMaximum Length:1000The description of the academic level. -
enrollmentInclusions: array
Enrollment Inclusions
Title:
Enrollment InclusionsThe enrollment inclusions resource is a child of the academic levels resource and provides a complete list of enrollment inclusions associated with an academic level. -
ForCreditFlag: boolean
Title:
For CreditMaximum Length:1Default Value:trueIndicates the academic level is for credit. -
institutions: array
Institutions
Title:
InstitutionsThe institutions resource is a child of the academic levels resource and provides a complete list of institutions associated with an academic level. -
LevelCode(required): string
Title:
Academic Level CodeMaximum Length:100The code of the academic level. -
LevelName(required): string
Title:
Academic Level NameMaximum Length:100The name of the academic level. -
LevelStatusCode: string
Title:
Level Status CodeMaximum Length:30Default Value:ORA_INACTIVEThe status code of the academic level. A list of accepted values is defined in the lookup type ORA_HER_ACADEMIC_LEVEL_STATUS. -
MinimumFullTimeUnits: number
Title:
Minimum Full Time UnitsDefault Value:0The minimum full time units indicates the minimum number of units of credit required to be considered a full time student. -
PrimacyNumber(required): integer
(int32)
Title:
Primacy NumberThe primacy number of the academic level. Use primacy numbers to specify the primary program for purposes such as reporting and tuition calculation. -
RepeatFailureHandlerCode: string
Title:
Enrollment Repeat OptionMaximum Length:30Default Value:ORA_NONEIndicates the action to be taken when a course repeat attempt isn't successful. A list of accepted values is defined in the lookup type ORA_HER_REPEAT_CONTROL_TYPE. -
RequiresStudentProgramFlag(required): boolean
Title:
Requires student programMaximum Length:1Indicates that a student can enroll only if the student is assigned to a program. -
TypeOfCreditCode(required): string
Title:
Type of Credit CodeMaximum Length:30Indicates the type of credit generally earned for this academic level. A list of accepted values is defined in the lookup type ORA_HER_CREDIT_TYPE_CODE.
Nested Schema : Assignments
Type:
arrayTitle:
AssignmentsThe assignments resource provides a list of academic entities which have been assigned.
Show Source
Nested Schema : Enrollment Inclusions
Type:
arrayTitle:
Enrollment InclusionsThe enrollment inclusions resource is a child of the academic levels resource and provides a complete list of enrollment inclusions associated with an academic level.
Show Source
Nested Schema : Institutions
Type:
arrayTitle:
InstitutionsThe institutions resource is a child of the academic levels resource and provides a complete list of institutions associated with an academic level.
Show Source
Nested Schema : schema
Type:
Show Source
object-
AssignedEntityId: integer
(int64)
Title:
Entity IDThe unique identifier of the associated entity. -
AssignedEntityTypeCode: string
Title:
Entity Type CodeMaximum Length:30A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE. -
AssignmentEndDate: string
(date)
Title:
Assignment End DateThe end or expiration date of the entity assignment. -
AssignmentStartDate: string
(date)
Title:
Assignment Start DateThe start date of the entity assignment.
Nested Schema : schema
Type:
Show Source
object-
IncludeAcademicLevelId: integer
(int64)
Title:
Included Academic Level IDThe unique identifier for the academic level that's included for enrollment.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : academicLevels-item-response
Type:
Show Source
object-
AcademicLevelId: integer
(int64)
Title:
Academic Level IDRead Only:trueThe unique identifier for an academic level. -
ActiveFlag: boolean
Title:
Academic Level ActiveRead Only:trueMaximum Length:1Indicates the active status of the academic level. -
AllInstitutionsFlag: boolean
Title:
Available for all institutionsRead Only:trueMaximum Length:1Default Value:falseIndicates the academic level is available for all academic institutions. -
assignments: array
Assignments
Title:
AssignmentsThe assignments resource provides a list of academic entities which have been assigned. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the row. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date the row was created. -
Description: string
Title:
Academic Level DescriptionMaximum Length:1000The description of the academic level. -
enrollmentInclusions: array
Enrollment Inclusions
Title:
Enrollment InclusionsThe enrollment inclusions resource is a child of the academic levels resource and provides a complete list of enrollment inclusions associated with an academic level. -
ForCreditFlag: boolean
Title:
For CreditMaximum Length:1Default Value:trueIndicates the academic level is for credit. -
institutions: array
Institutions
Title:
InstitutionsThe institutions resource is a child of the academic levels resource and provides a complete list of institutions associated with an academic level. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date the row was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the row. -
LevelCode: string
Title:
Academic Level CodeMaximum Length:100The code of the academic level. -
LevelName: string
Title:
Academic Level NameMaximum Length:100The name of the academic level. -
LevelStatus: string
Title:
Level StatusRead Only:trueMaximum Length:80The status meaning of the academic level. -
LevelStatusCode: string
Title:
Level Status CodeMaximum Length:30Default Value:ORA_INACTIVEThe status code of the academic level. A list of accepted values is defined in the lookup type ORA_HER_ACADEMIC_LEVEL_STATUS. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MinimumFullTimeUnits: number
Title:
Minimum Full Time UnitsDefault Value:0The minimum full time units indicates the minimum number of units of credit required to be considered a full time student. -
PrimacyNumber: integer
(int32)
Title:
Primacy NumberThe primacy number of the academic level. Use primacy numbers to specify the primary program for purposes such as reporting and tuition calculation. -
RepeatFailureHandlerCode: string
Title:
Enrollment Repeat OptionMaximum Length:30Default Value:ORA_NONEIndicates the action to be taken when a course repeat attempt isn't successful. A list of accepted values is defined in the lookup type ORA_HER_REPEAT_CONTROL_TYPE. -
RepeatFailureHandlerMeaning: string
Title:
Repeat Handler MeaningRead Only:trueMaximum Length:80The meaning of repeat failure handler code. Valid values include None, Error or Warning. A list of accepted values is defined in the lookup type ORA_HER_REPEAT_CONTROL_TYPE. -
RequiresStudentProgramFlag: boolean
Title:
Requires student programMaximum Length:1Indicates that a student can enroll only if the student is assigned to a program. -
TypeOfCredit: string
Title:
Type of CreditRead Only:trueMaximum Length:80The meaning of the type of credit. Valid values include Continuing education units, Credit hours and No Credit Type. A list of accepted values is defined in the lookup type ORA_HER_CREDIT_TYPE_CODE. -
TypeOfCreditCode: string
Title:
Type of Credit CodeMaximum Length:30Indicates the type of credit generally earned for this academic level. A list of accepted values is defined in the lookup type ORA_HER_CREDIT_TYPE_CODE.
Nested Schema : Assignments
Type:
arrayTitle:
AssignmentsThe assignments resource provides a list of academic entities which have been assigned.
Show Source
Nested Schema : Enrollment Inclusions
Type:
arrayTitle:
Enrollment InclusionsThe enrollment inclusions resource is a child of the academic levels resource and provides a complete list of enrollment inclusions associated with an academic level.
Show Source
Nested Schema : Institutions
Type:
arrayTitle:
InstitutionsThe institutions resource is a child of the academic levels resource and provides a complete list of institutions associated with an academic level.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : academicLevels-assignments-item-response
Type:
Show Source
object-
AssignedEntityCode: string
Title:
Entity CodeRead Only:trueMaximum Length:100The user defined identifier of the associated entity. -
AssignedEntityId: integer
(int64)
Title:
Entity IDThe unique identifier of the associated entity. -
AssignedEntityName: string
Title:
Entity NameRead Only:trueMaximum Length:100The name of the associated entity. -
AssignedEntityStatusCode: string
Title:
Assigned Entity Status CodeRead Only:trueMaximum Length:30The status code of the entity. This controls the availability of the entity for assignments to settings. -
AssignedEntityStatusMeaning: string
Title:
Assigned Entity StatusRead Only:trueMaximum Length:80The status of the entity. -
AssignedEntitySubTypeCode: string
Title:
Entity Subtype CodeRead Only:trueMaximum Length:30The entity subtype code of the associated entity. -
AssignedEntitySubTypeMeaning: string
Title:
Entity SubtypeRead Only:trueMaximum Length:80The entity subtype of the associated entity. -
AssignedEntityTypeCode: string
Title:
Entity Type CodeMaximum Length:30A list of accepted values is defined in the lookup type ORA_HER_ASSOCIATED_OBJECT_TYPE. -
AssignedEntityTypeMeaning: string
Title:
Entity TypeRead Only:trueMaximum Length:80The entity type of the associated entity. -
AssignmentEndDate: string
(date)
Title:
Assignment End DateThe end or expiration date of the entity assignment. -
AssignmentStartDate: string
(date)
Title:
Assignment Start DateThe start date of the entity assignment. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the row. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date the row was created. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date the row was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the row. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
SettingsAssignmentId: integer
(int64)
Title:
Settings Assignment IDRead Only:trueThe unique identifier for the setup association record.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : academicLevels-enrollmentInclusions-item-response
Type:
Show Source
object-
EnrollmentInclusionId: integer
(int64)
Title:
Academic Level Enrollment Inclusion IDRead Only:trueThe unique identifier for an enrollment inclusion. Enrollment inclusions at the course academic level indicate the student academic levels that are eligible to enroll in a course. Inclusions apply only when enrollment is restricted to students who are assigned to a program. -
IncludeAcademicLevelId: integer
(int64)
Title:
Included Academic Level IDThe unique identifier for the academic level that's included for enrollment. -
IncludeLevelCode: string
Title:
Included Level CodeRead Only:trueMaximum Length:100The code of the academic level. -
IncludeLevelName: string
Title:
Included Level NameRead Only:trueMaximum Length:100The name of the academic level. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : academicLevels-institutions-item-response
Type:
Show Source
object-
AcademicLevelId: integer
(int64)
Title:
Academic Level IDRead Only:trueUnique identifier for an academic level. -
AcademicLevelInstitutionId: integer
(int64)
Title:
Academic Level Institution IDRead Only:trueThe unique identifier for the institution that's associated with an academic level. -
InstitutionId: integer
(int64)
Title:
Institution IDRead Only:trueThe unique identifier of an academic institution. -
InstitutionName: string
Title:
InstitutionRead Only:trueMaximum Length:50The name of the institution. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- assignments
-
Parameters:
- AcademicLevelId:
$request.path.AcademicLevelId
The assignments resource provides a list of academic entities which have been assigned. - AcademicLevelId:
- enrollmentInclusions
-
Operation: /fscmRestApi/resources/11.13.18.05/academicLevels/{AcademicLevelId}/child/enrollmentInclusionsParameters:
- AcademicLevelId:
$request.path.AcademicLevelId
The enrollment inclusions resource is a child of the academic levels resource and provides a complete list of enrollment inclusions associated with an academic level. - AcademicLevelId:
- institutions
-
Parameters:
- AcademicLevelId:
$request.path.AcademicLevelId
The institutions resource is a child of the academic levels resource and provides a complete list of institutions associated with an academic level. - AcademicLevelId:
- levelStatusCodeLOV
-
Parameters:
- finder:
ByLookupTypeFinder%3BLookupCode%3D{LevelStatusCode}%2CLookupType%3DORA_HER_ACADEMIC_LEVEL_STATUS
The following properties are defined on the LOV link relation:- Source Attribute: LevelStatusCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- typeOfCreditCodeLOV
-
Parameters:
- finder:
ByLookupTypeFinder%3BLookupCode%3D{TypeOfCreditCode}%2CLookupType%3DORA_HER_CREDIT_TYPE_CODE
The following properties are defined on the LOV link relation:- Source Attribute: TypeOfCreditCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder: