Pearson
Always Learning

Overview

Updates the course details for a single course section. The course section to be updated must already exist prior to calling this method. The list of elements available for update for a given course section are listed below.

Accessing the Enterprise Course Service

LearningStudio requires a username and password to access the API web services. Your Client Services representative should have provided you with the necessary login credentials. These credentials are included in the SOAP header.

Element Description
Operation Name UpdateCourseSection
End-point URL https://ccws-services.ecollege.com/EnterpriseServices/v2.2/EnterpriseCourse.svc
WSDL Compressed zip file of WSDL files
WS-Address http://ccws-services.ecollege.com/EnterpriseServices/v2.2/EnterpriseCourse.svc
Learn more about WS-Addressing in Terms & Courses APIs

Tip: If you are programming in .NET, use WCF 4.0 for communicating with Terms & Courses services.

Request Header

All requests must include a WS-Security SOAP Header with the username and password for your campus' SIS system. Your SOAP library is likely capable of creating this header for you. For more information on the requirements, see SOAP API Security.

Below is a sample CopyCourseSectionAndContent header.

<header xmlns:wsa="http://www.w3.org/2005/08/addressing"><security soap:mustunderstand="true" xmlns:wsse="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><usernametoken wsu:id="UsernameToken-1" xmlns:wsu="http://docs.oasisopen.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"><username>{USERNAME}</username><password type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-usernametoken-profile-1.0#PasswordText">{PLAINTEXT_PASSWORD}</password><nonce encodingtype="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soapmessage-security-1.0#Base64Binary">{RANDOM_VALUE}</nonce><created>{UTC_TIMESTAMP}</created></usernametoken></security><action>{ACTION_DEFINED_BY_WSDL}</action><to>{ADDRESSING_URL}</to></header>

Request Body

The elements of the UpdateCourseSection request XML request body are detailed in the following table. The top level element is always UpdateCourseSection, and all these elements are children of the top node.


Element Description Required?
updateCourseSectionRequest Container for course section and content information. Required
updateCourseSectionRequest
    ↳ClientString
LearningStudio Client String for the campus / Education Partner (client). For Strata University, this would be strata. Required
updateCourseSectionRequest
    ↳PrimaryClientSortString
LearningStudio node sort string where the course section to be updated resides. For example, if this is in the business school node at Strata University, this value may be strata.business. (in Client Sort Strings, always include the final period). Required
updateCourseSectionRequest
    ↳DestinationCourseIdentifier
Container for your system's course identifier for this course section. Required
updateCourseSectionRequest
    ↳DestinationCourseIdentifier
            ↳ID
Your system's identifier for the course section to being updated. Required
updateCourseSectionRequest
    ↳DestinationCourseIdentifier
            ↳MappingType
How the course you're updating is identified.
  • CallNumber
  • SourcedID
Required
updateCourseSectionRequest
    ↳DestinationCourseIdentifier
            ↳CourseCallNumbers
                  ↳CourseCallNumbers
A two-leveled container for additional call numbers you wish to assign to this course. Note, you need to nest CourseCallNumber inside CourseCallNumbers, and then nest the element in the next row under these elements. See the example for clarity. This functionality was added in version 2.2 of this service. Optional
updateCourseSectionRequest
    ↳DestinationCourseIdentifier
            ↳CourseCallNumbers
                  ↳CourseCallNumber
                        ↳ClientCallNumber
The additional call number to add to this course. Repeat this element under CourseCallNumber for each additional call number. Optional
updateCourseSectionRequest
    ↳CourseCallNumbersExpireOn
Updated date the call number for the course section expires. The max date this value can be set to is 6/6/2079. However, to instead set this value to NULL, simply omit this element from the request. Optional
updateCourseSectionRequest
    ↳DestinationSectionTitle
The revised title for the course section. Optional
updateCourseSectionRequest
    ↳DestinationSectionDescription
The revised description for the course section.. Optional
updateCourseSectionRequest
    ↳DestinationDisplayCourseCode
The revised display course code for the course section. Optional
updateCourseSectionRequest
    ↳DestinationSectionNumber
The revised section number for the course section. If used, the value must be numeric and between 0 - 255. Optional

Request Body Sample

Here is a text view of the body from a sample UpdateCourseSection request message:

<updatecoursesection><updatecoursesectionrequest><clientstring>gbtestc</clientstring><coursecallnumbersexpireon>2078-12-31</coursecallnumbersexpireon><destinationcourseidentifier><id>ACCT4430_Fall12_Bus1</id><mappingtype>CallNumber</mappingtype><coursecallnumbers><coursecallnumber><clientcallnumber>ACCT4430_Fall12Accelerated_Bus2</clientcallnumber><clientcallnumber>ACCT4430_Fall12Accelerated_Bus3A</clientcallnumber></coursecallnumber></coursecallnumbers></destinationcourseidentifier><destinationdisplaycoursecode>ACCT4430</destinationdisplaycoursecode><destinationsectiondescription>via Course Service v2.1</destinationsectiondescription><destinationsectionnumber>20</destinationsectionnumber><destinationsectiontitle>Super Advanced Auditing</destinationsectiontitle><primaryclientsortstring>gbtestc.two.</primaryclientsortstring></updatecoursesectionrequest></updatecoursesection>

Response

UpdateCourseSectionResponse schema overview:

Element Description
UpdateCourseSectionResponse Top level element
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
Container for call result
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
            ↳ID
Container for identifying destination.
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
            ↳ID
                  ↳ID
External identifier for the destination section.
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
            ↳ID
                  ↳MappingType
How the new section is identified. Possible values are:

  • CallNumber
  • SourcedID
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
            ↳JobStatusID
Identifies the system job for the call.
UpdateCourseSectionResponse
    ↳UpdateCourseSectionResult
            ↳Status
The success, failure or other status of the call.

Response Body Sample

Here is a text view of the body from a sample UpdateCourseSection response message:

<updatecoursesectionresponse xmlns="urn:eclg:coursecopy:enterprisecourse"><updatecoursesectionresult xmlns:b="http://CCWSServices.eCollege.com/EnterpriseServices/Types/v2.1/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"><id><id>ACCT4430_CCWSv2.1DocCreate</id><mappingtype>CallNumber</mappingtype></id><jobstatusid i:nil="true"></jobstatusid><status i:nil="true"></status></updatecoursesectionresult></updatecoursesectionresponse>

2615 reads
Always Learning
Pearson