Create.Course.Folder

This method creates a single folder in the Course files area ("imported resource files").

It is very similar to Create.MyFiles.Folder's private files. The only difference is lack of "Visibility" parameter and presence of course identifiers. The course identifiers are validated in the same way as for Create.Course.File.Element. For more detailed information, please refer to Create.MyFiles.Folder documentation.

Input

Name	Description	Type	M/O
Message Type	ID of the course where the element is to be created.	Text. "CreateCourseFolder"	M
SyncKey	External SyncKey for the created content.	Text	M
SiteId	Site where action will be executed	Integer	O
VendorId	VendorId which will be associated with created content	Text	O
UserID	UserID of the creator.	Integer	O/M
UserSyncKey	User SyncKeyID of the creator.	Text	O/M
CourseID	ID of the course where the element is to be created.	Integer	O/M
CourseSyncKey	SyncKeyID of the course where the element is to be created.	Text	O/M
ParentID	ID of the folder into which the folder is to be created. Default is the root.	Integer	O
ParentSyncKey	SyncKey of the folder into which the folder is to be created. Default is the root.	Text	O
Name	Name of the folder.	Text. Must not be blank. Follow same rules as the UI.	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.

Both ParentID and ParentSyncKey are optional. Possible use only one of them either ParentID or ParentSyncKey.

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="SyncKeys" minOccurs="0" maxOccurs="1">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="SyncKey" minOccurs="0" maxOccurs="1" type="xs:string" />
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
                <xs:element name="SiteId" minOccurs="0" maxOccurs="1" type="xs:int" />
                <xs:element name="VendorId" minOccurs="0" maxOccurs="1">
                    <xs:simpleType>
                        <xs:restriction base="xs:string">
                            <xs:minLength value="1"/>
                            <xs:maxLength value="36"/>
                        </xs:restriction>
                    </xs:simpleType>
                </xs:element>
                <xs:element name="CreateCourseFolder" minOccurs="1" maxOccurs="1">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:choice minOccurs="1" maxOccurs="1">
                                <xs:element name="UserId" type="xs:integer" />
                                <xs:element name="UserSyncKey" type="xs:string" />
                            </xs:choice>
                            <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:element name="Name" minOccurs="1" maxOccurs="1" type="xs:string" />
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    
</xs:schema>

Sample request

<Message xmlns="urn:message-schema">
    <CreateCourseFolder>
        <UserId>1</UserId>
        <CourseId>6</CourseId>
        <ParentSyncKey>3d63eb7e-d5c4-49c0-ae3e-365fe5da559c</ParentSyncKey>
        <Name>p6[][]()()</Name>
    </CreateCourseFolder>
</Message>