Update.Course.Element.CustomActivity

This will update a custom activity element in a course. It will not update any results, just the custom activity.

What is a custom activity?

This will allow teachers to create, plan and track activities that happen outside itslearning. These activities can be added and managed as any other course activity – including management of deadlines, statuses and assessments. This can be used for simple activities such as homework or offline lab exercise

Initial Validation Rules

Input matches the schema below.
User must exist.
User must not be external.
User must not be deleted.
Course must exist.
Course must not be external.
Course must not be deleted.
Course must not be archived.
If specified: ParentId must be an element ID within the course.
If specified: ParentId must be a folder.
If specified: ParentId must not be deleted.
If specified: ParentSyncKey must be an element ID within the course.
If specified: ParentSyncKey must be a folder.
If specified: ParentSyncKey must not be deleted.
Element must exist.
Element must not be deleted.
Element must be related the course.

Input

Parameters in:

Name	Description	Type	M/O
Message Type	Type of Message.	Text set to message type	M
SiteId	Site where action will be executed	Integer	O
VendorId	VendorId which will be associated with created content	Text	O
CourseID	ID of the course where the element is to be updated.	Integer	O/M
CourseSyncKey	SyncKeyID of the course where the element is to be updated.	Text	O/M
ParentId	ID of the (previously created) folder where the element is to be created.	Integer	O
ParentSyncKey	SyncKey of the (previously created) folder where the element is to be created. If not specified (null) then field won't be updated. If empty string then element will be moved to root. Must be a SyncKey or empty string (means root).	Text	O
ElementID	ElementID f custom activity.	Integer	O/M
ElementSyncKey	ElementSyncKey of custom activity.	Text	O/M
Active	Is the element active. If not specified then field won't be updated.	Boolean. True/False.	O
UserID	UserID of the editor.	Integer	O/M
UserSyncKey	User SyncKeyID of the editor.	Text	O/M
Title	Description of the custom activity.	Text Must not be blank. Must follow same rules as UI.	O
Description	Text (rich content) description of the custom activity. If not specified then field won't be updated.	Text See user story on importing rich content for description of parsing	O
Deadline	If a date is specified then set to the time / date even if in the past. If not specified then field won't be updated.	Text. Valid UTC date.	O
Mandatory	Is the custom activity mandatory. If not specified then field won't be updated.	Boolean: “True” / “False”	O
AssessmentId	This is the ID of the grade, if grading is used. If the value is missing then Assessment scale is not changed. If value is not a valid grade ID then field won't be updated. NOTE: You are not allowed to enter both AssessmentId and MaxScore.	Integer	O
MaxScore	This is the max score value, if custom activity used score as assessment type. Max score should be a valid positive number in range between 0.01 and 99999.99. If the value less than 0.01 or greather than 99999.99 then field won't be updated. If the customer has setting "Use score" is off then do not change assessment scale type and return warning. NOTE: You are not allowed to enter both AssessmentId and MaxScore.	Double	O
AssessmentVisible	If the assessments are available for participants. If not specified then field won't be updated.	Boolean: “True” / “False”	O
Locked	If the custom activity is locked for editing from UI. If not specified then field won't be updated.	Boolean: “True” / “False”	O
SendUpdateNotification	If a notification should be sent to indicate that this activity has been updated. Assume "false" if not specified.	Boolean: “True” / “False”	O
LearningObjectiveAssessment	What kind of assessment to use with learning objectives. If not specified then field won't be updated.	Enumeration: "DoNotUse", "OutcomeStatus", "AssessmentCriteria".	O
AllowStudentsSetCompletion	If participants are allowed to set completion of task. Used only if neither grade nor score is used. If not specified then assume not allowed.	Boolean: “True” / “False”	O
LearningObjectives	List of associated learning objective or null	Object	O
LearningObjectives	Learning objective element	Object	O
LearningObjectiveId	Learning objective identifier from repository	Text	M

Notes

Either UserID or UserSyncKey must be specified. This means specify at least one is mandatory.
Either CourseID or CourseSyncKey must be specified. This means specify at least one is mandatory.
Either ElementID or ElementSyncKey must be specified. This means specify at least one is mandatory.
Both ParentID and ParentSyncKey are optional. Possible use only one of them either ParentID or ParentSyncKey.

Output

Finished Status

Returns the ElementID and the SyncKey of the element.

Warning Status

Unknown assessment (grade) ID.
Max score should be a valid positive number in range between 0.01 and 99999.99.
Your settings don't allow you to use score as assessment alternative. Please contact your administrator.
The element has no learning objectives connected to it. LearningObjectivesAssessment is set to DoNotUse.

Errors Status

Invalid format / parameters (different to specified schema).
User with specified UserId/UserSyncKey is not valid.
User with specified UserId/UserSyncKey is external.
User with specified UserId/UserSyncKey is deleted.
Course does not exist.
Course is external.
Course is be deleted.
Course is archived.
ParentSyncKey/ParentId is not an element within the course.
ParentSyncKey/ParentId is not a folder.
Folder related to ParentSyncKey/ParentId has been deleted or removed.
Message must contain valid ParentId.
ParentSyncKey cannot be found in the identifier map or is invalid.
Title must not be blank or contain invalid characters.
Rich content badly formatted or invalid in “Text”.
Invalid deadline date or not in UTC format.
Your security settings doesn't allow you to perform that operation. Please contact administration to grant you an access to {HieararchyName} organization
Element does not exist
Element is deleted
"Assessment set-up for Assessment scale" cannot be changed when participants have already been assessed
"Assessment set-up for Learning objectives" cannot be changed when participants have already been assessed
Element is not within the course specified.
Course has no Learning Objectives enabled.
Learning objective is not a leaf. Only most granular learning objective can be assigned to elements.
Learning objective with UniqueId='{LearningObjectiveId}' is not in the learning objective repository.
Learning objectives cannot be changed if they have already been assessed.
Could not create/update element Custom Activity.

XML

Schema

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           xmlns="urn:message-schema"
           elementFormDefault="qualified"
           targetNamespace="urn:message-schema">
    <xs:element name="Message" type="MessageType" />
    <xs:complexType name="MessageType">
        <xs:sequence>
            <xs:element name="UpdateCourseElementCustomActivity" type="UpdateCustomActivityElementType" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="UpdateCustomActivityElementType">
        <xs:sequence>
            <xs:choice minOccurs="1" maxOccurs="1">
              <xs:element name="CourseId" type="xs:integer" />
              <xs:element name="CourseSyncKey" type="xs:string" />
            </xs:choice>
            <xs:choice minOccurs="0" maxOccurs="1">
              <xs:element name="ParentId" type="xs:integer" />
              <xs:element name="ParentSyncKey" type="xs:string" />
            </xs:choice>
            <xs:choice minOccurs="1" maxOccurs="1">
              <xs:element name="ElementId" type="xs:integer" />
              <xs:element name="ElementSyncKey" type="xs:string" />
            </xs:choice>
            <xs:element name="Active" type="xs:boolean" minOccurs="0" maxOccurs="1" nillable="true" />
            <xs:choice minOccurs="1" maxOccurs="1">
                <xs:element name="UserId" type="xs:integer" />
                <xs:element name="UserSyncKey" type="xs:string" />
            </xs:choice>
            <xs:element name="Title" type="xs:string" minOccurs="0" maxOccurs="1" nillable="true"/>
            <xs:element name="Description" type="xs:string" minOccurs="0" maxOccurs="1" nillable="true"/>
            <xs:element name="Deadline" type="xs:dateTime" minOccurs="0" maxOccurs="1"/>
            <xs:element name="Mandatory" type="xs:boolean" minOccurs="0" maxOccurs="1" nillable="true"/>
            <xs:choice minOccurs="0" maxOccurs="1">
                <xs:element name="AssessmentId" type="xs:int" default="0" />
                <xs:element name="MaxScore" type="xs:double" default="0.00" />
            </xs:choice>
            <xs:element name="AssessmentVisible" type="xs:boolean" minOccurs="0" maxOccurs="1" nillable="true" />
            <xs:element name="Locked" type="xs:boolean" minOccurs="0" maxOccurs="1" nillable="true" />
            <xs:element name="SendUpdateNotification" type="xs:boolean" minOccurs="0" maxOccurs="1" default="false" />
            <xs:element name="LearningObjectiveAssessment" type="LearningObjectiveAssessmentEnum" minOccurs="0" maxOccurs="1" nillable="true" />
            <xs:element name="AllowStudentsSetCompletion" type="xs:boolean" minOccurs="0" maxOccurs="1" nillable="true" />
            <xs:element name="LearningObjectives" type="LearningObjectivesType" minOccurs="0" maxOccurs="1"/>
        </xs:sequence>
    </xs:complexType>
    <xs:simpleType name="LearningObjectiveAssessmentEnum">
      <xs:restriction base="xs:string">
        <xs:enumeration value="DoNotUse"/>
        <xs:enumeration value="OutcomeStatus"/>
        <xs:enumeration value="AssessmentCriteria"/>
      </xs:restriction>
    </xs:simpleType>
 
    <xs:complexType name="LearningObjectivesType">
        <xs:sequence>
            <xs:element name="LearningObjective" type="LearningObjectiveType" minOccurs="0" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <xs:complexType name="LearningObjectiveType">
        <xs:sequence>
            <xs:element name="LearningObjectiveId" type="xs:string" minOccurs="1" maxOccurs="1"/>
        </xs:sequence>
    </xs:complexType>
</xs:schema> 

Sample request with assessment id

<Message xmlns="urn:message-schema">
    <UpdateCourseElementCustomActivity>
        <CourseId>1</CourseId>
        <ElementId>11939</ElementId>
        <Active>true</Active>
        <UserId>2</UserId>
        <Title>My Imported offline assessment - changed</Title>
        <Description>This offline assessment was imported. - changed</Description>
        <Deadline>2013-08-28T18:50:01+04:00</Deadline>
        <Mandatory>true</Mandatory>
        <AssessmentId>2</AssessmentId>
        <AssessmentVisible>true</AssessmentVisible>
        <Locked>false</Locked>
        <SendUpdateNotification>true</SendUpdateNotification>
        <LearningObjectiveAssessment>DoNotUse</LearningObjectiveAssessment>
        <AllowStudentsSetCompletion>false</AllowStudentsSetCompletion>
 
        <LearningObjectives>
          <LearningObjective>
            <LearningObjectiveId>CustomActivityLO1</LearningObjectiveId>
          </LearningObjective>
          <LearningObjective>
            <LearningObjectiveId>CustomActivityLO2</LearningObjectiveId>
          </LearningObjective>
        </LearningObjectives>
 
    </UpdateCourseElementCustomActivity>
</Message>

To remove learning objectives from element set empty LearningObjectives tag.

Sample:

<Message xmlns="urn:message-schema" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <UpdateCourseElementCustomActivity>
        <CourseId>1</CourseId>
        <ElementId>11939</ElementId>
        <Active>true</Active>
        <UserId>2</UserId>
        <Title>My Imported offline assessment - changed</Title>
        <Description>This offline assessment was imported. - changed</Description>
        <Deadline>2013-08-28T18:50:01+04:00</Deadline>
        <Mandatory>true</Mandatory>
        <AssessmentId>2</AssessmentId>
        <AssessmentVisible>true</AssessmentVisible>
        <Locked>false</Locked>
        <SendUpdateNotification>true</SendUpdateNotification>
        <LearningObjectiveAssessment>DoNotUse</LearningObjectiveAssessment>
        <AllowStudentsSetCompletion>false</AllowStudentsSetCompletion>
        <LearningObjectives>
        </LearningObjectives>
    </UpdateCourseElementCustomActivity>
</Message>