Oracle® Student Learning Programmer's Guide Release 3.1.3 Part Number E20666-04 |
|
|
PDF · Mobi · ePub |
This chapter describes the available web services and their descriptions.
The DataLoadingPartyService is used to load party information. This includes institutions, institution groups, people and their relationships.
This method creates new institutions. Note that the new institutions are created according to the order in which they are provided. For example, the first institution in the list is created followed by the second institution in the list.
All new institutions must have a parent institution. This parent institution must be an existing institution or created before it. In addition, under the same parent institution, the names of child institutions must be unique.
An institution should have only one primary address, email contact, and phone contact.
Parameter:
Table 2-1 createInstitutions Parameter Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions to create |
Return:
Table 2-2 createInstitutions Return Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of created institutions |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new institution groups. The institution group name must be unique.
Parameter:
Table 2-3 createInstitutionGroups Parameter Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups to create |
Return:
Table 2-4 createInstitutionGroups Return Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of created institution groups |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the institutions using the IdInfo in the input InstitutionInfo and if the institution is found, it is updated; Otherwise, it is created. Note that the parent institution attribute cannot be updated.
Parameter:
Table 2-5 createOrUpdateInstitutions Parameter Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions to create or update |
Return:
Table 2-6 createOrUpdateInstitutions Return Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the institution groups using the IdInfo in the input InstitutionGroupInfo and if the institution group is found, it is updated; Otherwise, it is created.
Note:
Only Create and Delete actions are allowed in the IdInfoActionInfo.Parameter:
Table 2-7 createOrUpdateInstitutionGroups Parameter Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups to create or update |
Return:
Table 2-8 createOrUpdateInstitutionGroups Return Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the persons using the IdInfo in the input PersonInfo and if the person is found, it is updated; Otherwise, it is created.
Parameter:
Table 2-9 createOrUpdatePersons Parameter Summary
Type | Description |
---|---|
PersonInfo[] |
List of persons to create or update |
Return:
Table 2-10 createOrUpdatePersons Return Summary
Type | Description |
---|---|
PersonInfo[] |
List of persons created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method creates new persons. A person should have only one primary address, email contact, and phone contact.
Parameter:
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method returns the department.
Parameter:
None.
Return:
Exception:
ServiceException
This method finds all the institutions using the IdInfo in the input InstitutionInfo and returns the complete InstitutionInfo including the ContactInfos and AddressInfos.
If the specified institution is not found in the system, no record is returned.
Parameter:
Table 2-14 getInstitutions Parameter Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions to retrieve |
Return:
Table 2-15 getInstitutions Return Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the institution groups using the IdInfo in the input InstitutionGroupInfo and returns the complete InstitutionGroupInfo.
If the specified institution group is not found in the system, no record is returned.
Parameter:
Table 2-16 getInstitutionGroups Parameter Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups to retrieve |
Return:
Table 2-17 getInstitutionGroups Return Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the persons using the IdInfo in the input PersonInfo and returns the complete PersonInfo including the LanguageInfos, ContactInfos, and AddressInfos.
If the specified person is not found in the system, no record is returned.
Parameter:
Return:
Exception:
InvalidParameters, ServiceException
This method searches for the institutions using the IdInfo in the input InstitutionInfo and updates the institutions with the specified attributes. Note that the parent institution cannot be updated.
Parameter:
Table 2-20 updateInstitutions Parameter Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of institutions to update |
Return:
Table 2-21 updateInstitutions Return Summary
Type | Description |
---|---|
InstitutionInfo[] |
List of updated institutions |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the institution groups using the IdInfo in the input InstitutionGroupInfo and updates the institution groups with the specified attributes.
Note:
Only Create and Delete actions are allowed in the IdInfoActionInfo.Parameter:
Table 2-22 updateInstitutionGroups Parameter Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of institution groups to update |
Return:
Table 2-23 updateInstitutionGroups Return Summary
Type | Description |
---|---|
InstitutionGroupInfo[] |
List of updated institution groups |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
The DataLoadingCourseService is used to load course, course tags, offerings, and class information.
This method creates new classes unique within the context of the associated offering. In addition, note the following:
The students and teachers enrolled in the class must come from the same school as the class
The start date of both the student enrollments and teacher enrollments must be on or after the start date of the class
The end date of both the student enrollments and teacher enrollments must be on or before the end date of the class
The start and end dates of the class must be within the start and end dates of the offering.
The offering must belong to the school of the class.
Parameter:
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new courses. Within a school, the course name and code must be unique. The tags attached to the course must also come from the same school.
Parameter:
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new offerings. Within a school, the offering name and code must be unique within the calendar. In addition, note the following:
The framework specified must be adopted by the school.
The course specified must belong to the same school as the offering.
The calendar of the offering must be the calendar of the adopted framework or one of its sub-calendars.
The start and end dates of the offering must be between the start and end dates of the calendar.
There can only be one offering for a course, framework, and calendar combination and if the class is found.
The calendar must be one of the adopted calendars of the school, or one of their sub-calendars.
Parameter:
Table 2-30 createOfferings Parameter Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings to create |
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the classes using the IdInfo in the input ClassInfo and if class is found, it is updated; Otherwise, it is created. The restrictions in createClasses and updateClasses are also applicable here.
Parameter:
Table 2-32 createOrUpdateClasses Parameter Summary
Type | Description |
---|---|
ClassInfo[] |
List of classes to create or update |
Return:
Table 2-33 createOrUpdateClasses Return Summary
Type | Description |
---|---|
ClassInfo[] |
List of classes created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the courses using the IdInfo in the input CourseInfo and if the course is found, it is updated; Otherwise, it is created. Note that the institution of the course cannot be updated.
Parameter:
Table 2-34 createOrUpdateCourses Parameter Summary
Type | Description |
---|---|
CourseInfo[] |
List of courses to create or update |
Return:
Table 2-35 createOrUpdateCourses Return Summary
Type | Description |
---|---|
CourseInfo[] |
List of courses created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the offerings using the IdInfo in the input OfferingInfo and if the offering is found, it is updated; Otherwise, it is created. The restrictions for createOfferings and updateOfferings are also applicable here.
Parameter:
Table 2-36 createOrUpdateOfferings Parameter Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings to create or update |
Return:
Table 2-37 createOrUpdateOfferings Return Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the tags using the IdInfo in the input TagInfo and if the tag is found, it is updated; Otherwise, it is created.
Parameter:
Table 2-38 createOrUpdateTags Parameter Summary
Type | Description |
---|---|
TagInfo[] |
List of tags to create or update |
Return:
Table 2-39 createOrUpdateTags Return Summary
Type | Description |
---|---|
TagInfo[] |
List of tags created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method creates new tags. Within a school, the tag name must be unique.
Parameter:
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method finds all the classes using the IdInfo in the input ClassInfo and returns the complete ClassInfo.
If the specified class is not found in the system, no record is returned.
Parameter:
Return:
Exception:
InvalidParameters, ServiceException
This method finds all the courses using the IdInfo in the input CourseInfo and returns the complete CourseInfo.
If the specified course is not found in the system, no record is returned.
Parameter:
Return:
Exception:
InvalidParameters, ServiceException
This method finds all the offerings using the IdInfo in the input OfferingInfo and returns the complete OfferingInfo.
If the specified offering is not found in the system, no record is returned.
Parameter:
Table 2-46 getOfferings Parameter Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings to retrieve |
Return:
Exception:
InvalidParameters, ServiceException
This method finds all the tags using the IdInfo in the input TagInfo and returns the complete TagInfo.
If the specified tag is not found in the system, no record is returned.
Parameter:
Return:
Exception:
InvalidParameters, ServiceException
This method searches for the classes using the IdInfo in the input ClassInfo and updates the classes with the specified attributes. The offering and school of the class cannot be updated. In addition, enrollments cannot be changed if the class is end-dated. Removing teacher enrollments and student enrollments are also prohibited if there is one or more learning items created in the class lesson plan.
Parameter:
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the courses using the IdInfo in the input CourseInfo and updates the course with the specified attributes. Note that the institution of the course cannot be updated.
Parameter:
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the offerings using the IdInfo in the input OfferingInfo and updates the offering with the specified attributes. Note that the calendar, course, framework, and school cannot be updated.
Parameter:
Table 2-54 updateOfferings Parameter Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings to update |
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the tags using the IdInfo in the input TagInfo and updates the tag with the specified attributes.
Parameter:
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method finds all the classes using the IdInfo in the input ClassInfo and removes it. A class cannot be removed if there are enrollments in the class.
Parameter:
Return:
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the courses using the IdInfo in the input CourseInfo and removes them. If a course is referenced by an offering, then it cannot be removed.
Parameter:
Return:
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the offerings using the IdInfo in the input OfferingInfo and removes them. An offering cannot be removed if there are any classes referencing it.
Parameter:
Table 2-62 removeOfferings Parameter Summary
Type | Description |
---|---|
OfferingInfo[] |
List of offerings to remove |
Return:
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
The DataLoadingCalendarService is used to load calendar information and also to adopt department calendars.
This method adopts a department calendar for use at a school. Only department calendars can be adopted. A calendar can only be adopted by a school once. Note that the parent calendar has to be adopted before the sub-calendars can be adopted.
Parameter:
Table 2-66 adoptCalendars Parameter Summary
Type | Description |
---|---|
AdoptCalendarInfo[] |
List of department calendars to adopt |
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new calendars. The calendar name must be unique within an institution. For a sub-calendar, the sub-calendar name must be unique under the parent calendar. Note that the start and end date of a sub-calendar must not exceed the start and end date of the parent calendar.
Parameter:
Table 2-68 createCalendars Parameter Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars to create |
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the calendars using the IdInfo in the input CalendarInfo and if a calendar is found, it is updated; Otherwise, it is created. The restrictions in createCalendars and updateCalendars are also applicable here.
Parameter:
Table 2-70 createOrUpdateCalendars Parameter Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars to create or update |
Return:
Table 2-71 createOrUpdateCalendars Return Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method finds all the calendars using the IdInfo in the input CalendarInfo and returns the complete CalendarInfo.
If the specified calendar is not found in the system, no record is returned.
Parameter:
Table 2-72 getCalendars Parameter Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars to retrieve |
Return:
Exception:
InvalidParameters, ServiceException
This method searches for the calendars using the IdInfo in the input CalendarInfo and updates the calendars with the specified attributes.
Note that the parent calendar association cannot be updated.
Parameter:
Table 2-74 updateCalendars Parameter Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars to update |
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method finds all the calendars using the IdInfo in the input CalendarInfo and removes them. When a calendar is removed, all the sub-calendars under it are also removed. However, a school calendar cannot be removed if it is referenced in a framework adoption or an offering.
Parameter:
Table 2-76 removeCalendars Parameter Summary
Type | Description |
---|---|
CalendarInfo[] |
List of calendars to remove |
Return:
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
The DataLoadingCurriculumService is used to load framework and framework-related information such as framework items, blueprint nodes, and proficiency sets.
This method creates a new blueprint node hierarchy. A blueprint node with no parent blueprint node is created as the root blueprint node. There can only be one root blueprint node for a framework. Framework node names must be unique within a framework. Framework node start and end dates must be between the start and end dates of both the parent framework node and the framework.
Note:
All blueprint nodes directly or indirectly under the root blueprint node are created in the same framework as specified in the framework of the root blueprint node.Parameter:
Table 2-78 createBlueprintHieararchies Parameter Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes to create |
Return:
Table 2-79 createBlueprintHieararchies Return Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of created blueprint nodes |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new contexts. Contexts with no parent context specified are created as department contexts. Contexts with parent context specified are created as school contexts. School contexts cannot have child contexts.
Parameter:
Table 2-80 createContexts Parameter Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts to create |
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the blueprint nodes using the IdInfo in the input BlueprintNodeInfo and if the blueprint node is found, it is updated; Otherwise, it is created. The restrictions in createBlueprintHierarchies and updateBlueprintHierarchies are also applicable here.
Parameter:
Table 2-82 createOrUpdateBlueprintHieararchies Parameter Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes to create or update |
Return:
Table 2-83 createOrUpdateBlueprintHieararchies Return Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the contexts using the IdInfo in the input ContextInfo and if a context is found, it is updated; Otherwise, it is created.
The restrictions in createContexts and updateContexts are applicable here.
Parameter:
Table 2-84 createOrUpdateContexts Parameter Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts to create or update |
Return:
Table 2-85 createOrUpdateContexts Return Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the outcome statement descriptor types using the IdInfo in the input OutcomeStatementDescTypeInfo and if an outcome statement descriptor type is found, it is updated; Otherwise, it is created.
The restrictions in createOutcomeStatementDescTypes and updateOutcomeStatementDescTypes are applicable here.
Parameter:
Table 2-86 createorUpdateOutcomeStatementDescriptorType Parameter Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types to create or update |
Return:
Table 2-87 createorUpdateOutcomeStatementDescriptorType Return Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the outcome statements using the IdInfo in the input OutcomeStatementInfo and if the outcome statement is found, it is updated; Otherwise, it is created.
The restrictions in createOutcomeStatements and updateOutcomeStatements are also applicable here.
Parameter:
Table 2-88 createOrUpdateOutcomeStatements Parameter Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements to create or update |
Return:
Table 2-89 createOrUpdateOutcomeStatements Return Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method creates new outcome statements. The proficiency level specified must be from the outcome proficiency set associated with the specified framework item. Also, this proficiency level must not be a proficiency sub-level (For example, a proficiency level with a parent proficiency level).
Outcome statement names must be unique within a framework item. Demonstrable outcome statements must have an associated proficiency level. Indicative outcome statements must not have an associated proficiency level. The start and end dates of the outcome statement must be between those of the framework item.
Parameter:
Table 2-90 createOutcomeStatements Parameter Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements to create |
Return:
Table 2-91 createOutcomeStatements Return Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of created outcome statements |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new outcome statement descriptor types. Within a framework, the outcome statement descriptor type name must be unique.
Parameter:
Table 2-92 createOutcomeStatementDescriptorType Parameter Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types to create |
Return:
Table 2-93 createOutcomeStatementDescriptorType Return Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of created outcome statement descriptor types |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new Frameworks. The name of each framework must be unique in the system.
Parameter:
Table 2-94 createFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks to create |
Return:
Table 2-95 createFrameworks Return Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of created frameworks |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new Framework Item Hierarchies. A framework item with no parent framework item is created as the top level framework item. The blueprint node of top level framework item is set to the root blueprint node.
Note the following:
The outcome proficiency set, if specified, must belong to the same framework as the framework item
The specified blueprint node must belong to the same framework as the framework item
The framework item must be aligned to the specified blueprint node. (For example, the specified blueprint node must be the child of the blueprint node of the parent framework item)
Framework item codes must be unique within a framework.
If a framework item's "Confirming Level" flag is set, then a proficiency set must be specified.
A framework item's start and end dates must be between those of the blueprint node and the parent framework item.
Parameter:
Table 2-96 createFrameworkItemHieararchies Parameter Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items to create |
Return:
Table 2-97 createFrameworkItemHieararchies Return Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of created framework items |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the Framework item nodes using the IdInfo in the input FrameworkItemInfo and if a framework item is found, it is updated; Otherwise, it is created. The restrictions in createFrameworkItemHierarchies and updateFrameworkItemHierarchies are also applicable here.
Parameter:
Table 2-98 createOrUpdateFrameworkItemHieararchies Parameter Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items to create or update |
Return:
Table 2-99 createOrUpdateFrameworkItemHieararchies Return Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the frameworks using the IdInfo in the input FrameworkInfo and if a framework is found, it is updated; Otherwise, it is created.
Parameter:
Table 2-100 createOrUpdateFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks to create or update |
Return:
Table 2-101 createOrUpdateFrameworks Return Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the proficiency sets using the IdInfo in the input ProficiencySetInfo and if a proficiency set is found, it is updated; Otherwise, it is created. The restrictions in createProficiencySets and updateProficiencySets are also applicable here.
Parameter:
Table 2-102 createOrUpdateProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of proficiency sets to create or update |
Return:
Table 2-103 createOrUpdateProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of proficiency sets created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method creates new outcome proficiency sets. Note that the outcome proficiency levels can have at most only one level of parent/child relationship. For example, an outcome proficiency level can have one or more proficiency sub-levels as its child, but the proficiency sub-levels cannot have subordinate proficiency levels.
In addition, within an outcome proficiency set, all proficiency level names must be unique. Every proficiency set with a framework must have a unique name. The start and end dates of a proficiency set must be between those of the framework.
Parameter:
Table 2-104 createProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of outcome proficiency sets to create |
Return:
Table 2-105 createProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of created outcome proficiency sets |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method finds all the blueprint nodes using the IdInfo in the input BlueprintNodeInfo and returns the complete BlueprintNodeInfo including the child blueprint nodes.If the specified blueprint node is not found in the system, no record is returned.
Parameter:
Table 2-106 getBlueprintHieararchies Parameter Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes to retrieve |
Return:
Table 2-107 getBlueprintHieararchies Return Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the contexts using the IdInfo in the input ContextInfo and returns the complete ContextInfo.
If the specified context is not found in the system, no record is returned.
Parameter:
Table 2-108 getContexts Parameter Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts to retrieve |
Return:
Exception:
InvalidParameters, ServiceException
This method finds all the frameworks using the IdInfo in the input FrameworkInfo and returns the complete FrameworkInfo.
If the specified framework is not found in the system, no record is returned.
Parameter:
Table 2-110 getFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks to retrieve |
Return:
Table 2-111 getFrameworks Return Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the framework item nodes using the IdInfo in the input FrameworkItemInfo and returns the complete FrameworkItemInfo including child framework items.If the specified framework item is not found in the system, no record is returned.
Parameter:
Table 2-112 getFrameworkItemHieararchies Parameter Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items to retrieve |
Return:
Table 2-113 getFrameworkItemHieararchies Return Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the outcome statements using the IdInfo in the input OutcomeStatementInfo and returns the complete OutcomeStatementInfo.
If the specified outcome statement is not found in the system, no record is returned.
Parameter:
Table 2-114 getOutcomeStatements Parameter Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements to retrieve |
Return:
Table 2-115 getOutcomeStatements Return Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the outcome statement descriptor types using the IdInfo in the input OutcomeStatementDescTypeInfo and returns the OutcomeStatementDescTypeInfo.
If the specified outcome statement descriptor type is not found in the system, no record is returned.
Parameter:
Table 2-116 getOutcomeStatementDescriptorType Parameter Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types to retrieve |
Return:
Table 2-117 getOutcomeStatementDescriptorType Return Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the outcome proficiency sets using the IdInfo in the input ProficiencySetInfo and returns the complete ProficiencySetInfo.
If the specified outcome proficiency set is not found in the system, no record is returned.
Parameter:
Table 2-118 getProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of proficiency sets to retrieve |
Return:
Table 2-119 getProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of proficiency sets retrieved |
Exception:
InvalidParameters, ServiceException
This method loads the entire framework data. This includes:
Create the framework and set up the institution and group availability
Create the blueprint node hieararchy
Create the proficiency sets
Create the outcome statement descriptor types
Create the framework item hieararchy
Create the outcome statements
Create the contexts
If the framework is to be published, it is pubslihed
The restrictions in createFrameworks, createBlueprintHierarchies, createProficiencySets, createOutcomeStatementDescTypes, createFrameworkItemHierarchies, createOutcomeStatements, createContexts, and publishFrameworks are still applicable.
Parameter:
Return:
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method finds all the blueprint nodes using the IdInfo in the input BlueprintNodeInfo and removes them. Any subordinate nodes are also deleted. If the blueprint node is associated with a framework item, then it is not allowed to be deleted.
Parameter:
Table 2-122 removeBlueprintHieararchies Parameter Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes to remove |
Return:
Table 2-123 removeBlueprintHieararchies Return Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of removed blueprint nodes |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the contexts using the IdInfo in the input ContextInfo and removes them. Any subordinate context are also deleted. However, a context cannot be deleted if the context has been adopted by any school.
Parameter:
Table 2-124 removeContexts Parameter Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts to remove |
Return:
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the frameworks using the IdInfo in the input FrameworkInfo and removes them and all framework-related entities such as outcome proficiency sets, blueprint nodes, framework items, outcome statements and contexts. A framework cannot be removed if it has been adopted by a school.
All restrictions in removeFrameworkItemHierarchies, removeBlueprintHierarchies, removeOutcomeStatementDescTypes, removeProficiencySets, removeOutcomeStatements, and removeContexts are still applicable.
Parameter:
Table 2-126 removeFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks to remove |
Return:
Table 2-127 removeFrameworks Return Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of removed frameworks |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the Framework item nodes using the IdInfo in the input FrameworkItemInfo and removes them. All subordinate framework items are also deleted. A framework item cannot be deleted if it is associated with any learning item, demonstration or confirmation.
Parameter:
Table 2-128 removeFrameworkItemHieararchies Parameter Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items to remove |
Return:
Table 2-129 removeFrameworkItemHieararchies Return Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of removed framework items |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the outcome statements using the IdInfo in the input OutcomeStatementInfo and removes them. Any associated outcome statement descriptors are also deleted. If the outcome statement is associated with any learning item or assessments (confirmations or demonstrations), it cannot be deleted.
Parameter:
Table 2-130 removeOutcomeStatements Parameter Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements to remove |
Return:
Table 2-131 removeOutcomeStatements Return Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of removed outcome statements |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the outcome statements descriptor types using the IdInfo in the input OutcomeStatementDescTypeInfo and removes them. An outcome statement descriptor type cannot be deleted if it is being used in an outcome statement descriptor.
Parameter:
Table 2-132 removeOutcomeStatementDescriptorType Parameter Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types to remove |
Return:
Table 2-133 removeOutcomeStatementDescriptorType Return Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of removed outcome statement descriptor types |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the proficiency sets using the IdInfo in the input ProficiencySetInfo and removes them. Any associated proficiency levels are also deleted. If the proficiency set is associated with a framework item, then it is not allowed to be deleted.
Parameter:
Table 2-134 removeProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of outcome proficiency sets to remove |
Return:
Table 2-135 removeProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of removed outcome proficiency sets |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method searches for the blueprint nodes using the IdInfo in the input BlueprintNodeInfo and updates the blueprint nodes with the specified attributes. Note that the parent/child relationship of a blueprint node cannot be updated. In addition, the framework of a blueprint node cannot be updated.
Parameter:
Table 2-136 updateBlueprintHieararchies Parameter Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of blueprint nodes to update |
Return:
Table 2-137 updateBlueprintHieararchies Return Summary
Type | Description |
---|---|
BlueprintNodeInfo[] |
List of updated blueprint nodes |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the contexts using the IdInfo in the input ContextInfo and updates the contexts with the specified attributes. Note that the framework item cannot be updated.
Parameter:
Table 2-138 updateContexts Parameter Summary
Type | Description |
---|---|
ContextInfo[] |
List of contexts to update |
Return:
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the frameworks using the IdInfo in the input FrameworkInfo and updates the frameworks with the specified attributes.
Parameter:
Table 2-140 updateFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of frameworks to update |
Return:
Table 2-141 updateFrameworks Return Summary
Type | Description |
---|---|
FrameworkInfo[] |
List of updated frameworks |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the nodes using the IdInfo in the input FrameworkItemInfo and updates the objects with the specified attributes. The framework, parent framework item, and blueprint node cannot be updated. When deleting a framework item, all subordinate framework items are also deleted. However, a framework item cannot be deleted if it is associated with any learning item.
Parameter:
Table 2-142 updateFrameworkItemHieararchies Parameter Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of framework items to update |
Return:
Table 2-143 updateFrameworkItemHieararchies Return Summary
Type | Description |
---|---|
FrameworkItemInfo[] |
List of updated framework items |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the outcome proficiency sets using the IdInfo in the input ProficiencySetInfo and updates the outcome proficiency sets with the specified attributes.
Parameter:
Table 2-144 updateProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of outcome proficiency sets to update |
Return:
Table 2-145 updateProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of updated outcome proficiency sets |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the statements using the IdInfo in the input OutcomeStatementInfo and updates the outcome statements with the specified attributes. The framework item cannot be updated.
Parameter:
Table 2-146 updateOutcomeStatements Parameter Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of outcome statements to update |
Return:
Table 2-147 updateOutcomeStatements Return Summary
Type | Description |
---|---|
OutcomeStatementInfo[] |
List of updated outcome statements |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method searches for the outcome statement descriptor types using the IdInfo in the input OutcomeStatementDescTypeInfo and updates the outcome statement descriptor types. The framework cannot be updated.
Parameter:
Table 2-148 updateOutcomeStatementDescriptorType Parameter Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of outcome statement descriptor types to update |
Return:
Table 2-149 updateOutcomeStatementDescriptorType Return Summary
Type | Description |
---|---|
OutcomeStatementDescTypeInfo[] |
List of updated outcome statement descriptor types |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
The DataLoadingCurriculumAdoptionService is used to adopt frameworks and contexts by schools.
This method adopts contexts as part of the larger curriculum framework adoptions. The framework with which the context is associated must be adopted by the school.
Parameter:
Table 2-150 adoptContexts Parameter Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of contexts to adopt |
Return:
Table 2-151 adoptContexts Return Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of adopted contexts |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method adopts frameworks by schools for a school calendar. Before the framework can be adopted, it must be published. A school can only adopt a framework once and can only do so if the framework is made available to the school for adoption. Note that the specified calendar must belong to the school adopting the framework.
Parameter:
Table 2-152 adoptFrameworks Parameter Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of frameworks to adopt |
Return:
Table 2-153 adoptFrameworks Return Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of adopted frameworks |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method finds all the context adoptions using the IdInfo in the input ContextAdoptionInfo and returns the complete ContextAdoptionInfo.
If the specified context adoption is not found in the system, no record is returned.
Parameter:
Table 2-154 getContextAdoptions Parameter Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of context adoptions to retrieve |
Return:
Table 2-155 getContextAdoptions Return Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of context adoptions retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the framework adoptions using the IdInfo in the input FrameworkAdoptionInfo and returns the complete FrameworkAdoptionInfo.
If the specified framework adoption is not found in the system, no record is returned.
Parameter:
Table 2-156 getFrameworkAdoptions Parameter Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of framework adoptions to retrieve |
Return:
Table 2-157 getFrameworkAdoptions Return Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of framework adoptions retrieved |
Exception:
InvalidParameters, ServiceException
This method finds all the context adoption using the IdInfo in the input ContextAdoptionInfo and removes them. If a context adoption is removed, all subordinate context adoptions are also removed. Note that a context adoption cannot be removed if the adopted context is used in any learning items, confirmations or demonstrations.
Parameter:
Table 2-158 removeContextAdoptions Parameter Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of context adoptions to remove |
Return:
Table 2-159 removeContextAdoptions Return Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of removed context adoptions |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
This method finds all the framework adoptions using the IdInfo in the input FrameworkAdoptionInfo and removes them. A framework adoption can only be removed if there are no offerings created for the adopted framework.
Parameter:
Table 2-160 removeFrameworkAdoptions Parameter Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of framework adoptions to remove |
Return:
Table 2-161 removeFrameworkAdoptions Return Summary
Type | Description |
---|---|
FrameworkAdoptionInfo[] |
List of removed framework adoptions |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
The DataLoadingGradeService is used to load graded proficiency set information. Adoption of department graded proficiency sets is also done through this service.
This method adopts a department graded proficiency set for use in a school. A school can only adopt a department graded proficiency set once.
Parameter:
Table 2-162 adoptProficiencySets Parameter Summary
Type | Description |
---|---|
AdoptProficiencySetInfo[] |
List of graded proficiency sets to adopt |
Return:
Table 2-163 adoptProficiencySets Return Summary
Type | Description |
---|---|
AdoptProficiencySetInfo[] |
List of adopted graded proficiency sets |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method creates new graded proficiency sets. A graded proficiency set must have a unique name within the school and have at least one proficiency level. Within a graded proficiency set, the proficiency levels must have unique names and codes and cannot have proficiency sub-levels. Collectively, the proficiency levels must cover the entire numeric range 0-100 and there must be no overlapping numeric ranges between the proficiency levels.
Parameter:
Table 2-164 createGradedProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets to retrieve |
Return:
Table 2-165 createGradedProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets retrieved |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method searches for the graded proficiency sets using the IdInfo in the input ProficiencySetInfo and if a graded proficiency set is found, it updates it; Otherwise, it creates it.
The restrictions in createGradedProficiencySets and updateGradedProficiencySets are applicable here.
Parameter:
Table 2-166 createOrUpdateGradedProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets to create or update |
Return:
Table 2-167 createOrUpdateGradedProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets created or updated |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method finds all the proficiency sets using the IdInfo in the input ProficiencySetInfo and returns the complete ProficiencySetInfo including the proficiency levels.
If the specified graded proficiency set is not found in the system, no record is returned
Parameter:
Table 2-168 getGradedProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets to retrieve |
Return:
Table 2-169 getGradedProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets retrieved |
Exception:
InvalidParameters, ServiceException
This method searches for the proficiency sets using the IdInfo in the input ProficiencySetInfo and updates the objects with the specified attributes. Note that the proficiency levels referenced in learning item assessments cannot be deleted.
Parameter:
Table 2-170 updateGradedProficiencySets Parameter Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of graded proficiency sets to update |
Return:
Table 2-171 updateGradedProficiencySets Return Summary
Type | Description |
---|---|
ProficiencySetInfo[] |
List of updated graded proficiency sets |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
This method finds all the graded proficiency sets using the IdInfo in the input ProficiencySetInfo and removes them. The proficiency levels within the graded proficiency sets are also deleted. A department graded proficiency set cannot be deleted if a school has adopted it. Furthermore, a graded proficiency set cannot be deleted if it is referenced in a learning item.
Parameter:
Table 2-172 removeGradedProficiencySets Parameter Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of context adoptions to remove |
Return:
Table 2-173 removeGradedProficiencySets Return Summary
Type | Description |
---|---|
ContextAdoptionInfo[] |
List of removed context adoptions |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException
The DataLoadingLookupValueService is used to update list of values information.
This method finds all the value types using the IdInfo in the input LookupTypeInfo and returns the complete LookupTypeInfo.
If the specified list of values is not found in the system, no record is returned.
Parameter:
Table 2-174 getValueTypes Parameter Summary
Type | Description |
---|---|
LookupTypeInfo[] |
List of value types to retrieve |
Return:
Table 2-175 getValueTypes Return Summary
Type | Description |
---|---|
LookupTypeInfo[] |
List of value types retrieved |
Exception:
InvalidParameters, ServiceException
This method searches for the value types using the IdInfo in the input LookupTypeInfo and updates the objects with the specified attributes. Within the list of values, the value names must be unique.
Note that for values provisioned by OSL, only the external id, external system id, meaning, and description can be updated. Some of these OSL-provisioned values cannot be removed or end-dated.
Parameter:
Table 2-176 updateValueTypes Parameter Summary
Type | Description |
---|---|
LookupTypeInfo[] |
List of value types to update |
Return:
Table 2-177 updateValueTypes Return Summary
Type | Description |
---|---|
LookupTypeInfo[] |
List of updated value types |
Exception:
DataConstraintException, InvalidParameters, ServiceException, UpdateException
The DataLoadingProfileService is used to load preference information.
This method creates new profileOptionValues. A profileOptionValue must have a PersonId and profileCode in the input ProfileOptionInfo.
Parameter:
Table 2-178 createProfileOption Parameter Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of profile options to create |
Return:
Table 2-179 createProfileOption Return Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of created profile options |
Exception:
CreationException, DataConstraintException, InvalidParameters, ServiceException
This method finds the profileOptionValue using the PersonId and profileCode in the input ProfileOptionInfo. If the PersonId is not specified or no profileOptionValue can be located for the specified PersonId and profileCode, the site-wide profileOptionValue for the specified profileCode is returned.
Parameter:
Table 2-180 getProfileOptions Parameter Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of profile options to retrieve |
Return:
Table 2-181 getProfileOptions Return Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of profile options retrieved |
Exception:
InvalidParameters, ServiceException
This method searches for profileOptionValues using the PersonId and profileCode in the input ProfileOptionInfo and updates the profileOptionValue with the specified attribute. If the PersonId is not specified, the site-wide profileOptionValue for the specified profileCode is updated.
Parameter:
Table 2-182 updateProfileOptions Parameter Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of profile options to update |
Return:
Table 2-183 updateProfileOptions Return Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of updated profile options |
Exception:
UpdateException, DataConstraintException, InvalidParameters, ServiceException
This method finds profileOptionValue using the PersonId and profileCode in the input ProfileOptionInfo and removes them.
Parameter:
Table 2-184 removeProfileOptions Parameter Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of profile options to remove |
Return:
Table 2-185 removeProfileOptions Return Summary
Type | Description |
---|---|
ProfileOptionInfo[] |
List of removed profile options |
Exception:
DataConstraintException, InvalidParameters, RemoveException, ServiceException