Pearson
Always Learning

Overview

This operation allows you to remove call numbers from a course section. Because call numbers can only be used once for all courses, unless and until the call number expires, this operation can be handy if you mistakenly assign a call number or need to repurpose one.

This operation was added in version 2.2 of the Terms & Courses services.

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 RemoveCourseCallNumbers
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 RemoveCourseCallNumbers 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 RemoveCourseCallNumbers request XML request body are detailed in the following table. The top level element is always RemoveCourseCallNumbers, and all these elements are children of the top node.


Element Description Required?
callNumbersRemoveRequest Container for course section and content information. Required
callNumbersRemoveRequest
    ↳ClientString
LearningStudio Client String for the campus / Education Partner (client). For Strata University, this would be strata. Required
callNumbersRemoveRequest
    ↳DestinationCourseIdentifier
Container for your system's course identifier for this course section. Required
callNumbersRemoveRequest
    ↳DestinationCourseIdentifier
            ↳ID
The identifier for the course section being updated. You will typically use your system's identifier for the course section you're updating.

As of version 2.2 of this service, you can now use the LearningStudio Course ID for the course you're updating, for example: 01234567.

Required
callNumbersRemoveRequest
    ↳DestinationCourseIdentifier
            ↳MappingType
How the course you're updating is identified.
  • CallNumber
  • SourcedID
  • CourseID
Required
callNumbersRemoveRequest
    ↳DestinationCourseIdentifier
            ↳CourseCallNumbers
                  ↳CourseCallNumbers
A two-leveled container for the call numbers you wish to remove from this course. Note, you need to nest CourseCallNumber inside CourseCallNumbers, and then next the element in the next row under these elements. See the example for clarity. Required
callNumbersRemoveRequest
    ↳DestinationCourseIdentifier
            ↳CourseCallNumbers
                  ↳CourseCallNumber
                        ↳ClientCallNumber
The call number to remove from this course. Repeat this element under CourseCallNumber for each additional call number you are deleting. Optional

Request Body Sample

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

<removecoursecallnumbers><callnumbersremoverequest><clientstring>strata</clientstring><destinationcourseidentifier><coursecallnumbers><coursecallnumber><clientcallnumber>ACCT_204_FallAccelerated_Bus1</clientcallnumber></coursecallnumber></coursecallnumbers><id>ACCT_204_Fall</id><mappingtype>Call Number</mappingtype></destinationcourseidentifier></callnumbersremoverequest></removecoursecallnumbers>

Response

The RemoveCourseCallNumbersResult elements

Element Description
RemoveCourseCallNumbersResponse Top Level Element
RemoveCourseCallNumbersResponse
    ↳RemoveCourseCallNumbersResult
Holds the Course ID for the course from which the call numbers were deleted.


Response Body Example

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

<removecoursecallnumbersresponse xmlns="urn:eclg:coursecopy:enterprisecourse"><removecoursecallnumbersresult>01234567</removecoursecallnumbersresult></removecoursecallnumbersresponse>
1911 reads
Always Learning
Pearson