createPerson

Method description

createPerson is the method used to create a single new person in itslearning

Preconditions for use

None.

Message Schema

Input parameters / request message elements

Name	Description	Data type	Allowed values	M/O
sourceId/identifier	The *syncID* of the person to be inserted	Text	Max 64 chars	M
person	The Person data to be stored in the new record. See docs full details on the person object	Object		M

Please refer to the WSDL for the full element structure, only key elements are described here

Response message elements

Name	Description	Data type
`<createPersonResponse` `/>`	Empty response element	Empty

Comments

Note! If the syncID already exists in itslearning, the person with the syncId will be updated instead.

Example

Description

I want to insert a new person in itslearning

Example request message

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ims="http://www.imsglobal.org/services/common/imsMessBindSchema_v1p0" xmlns:ims1="http://www.imsglobal.org/services/pms/xsd/imsPersonManMessSchema_v1p0" xmlns:ims2="http://www.imsglobal.org/services/common/imsCommonSchema_v1p0" xmlns:ims3="http://www.imsglobal.org/services/pms/xsd/imsPersonManDataSchema_v1p0">
    <soapenv:Header>
        <ims:syncRequestHeaderInfo>
            <ims:messageIdentifier>1234567890</ims:messageIdentifier>
        </ims:syncRequestHeaderInfo>
    </soapenv:Header>
    <soapenv:Body>
        <ims1:createPersonRequest>
            <ims1:sourcedId>
                <ims2:identifier>33333</ims2:identifier>
            </ims1:sourcedId>
            <ims1:person>
                <ims3:formatName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
                <ims3:name>
                    <ims3:partName>
                        <ims3:namePartType>Prefix</ims3:namePartType>
                        <ims3:namePartValue>Ms.</ims3:namePartValue>
                    </ims3:partName>
                    <ims3:partName>
                        <ims3:namePartType>First</ims3:namePartType>
                        <ims3:namePartValue>Marylin</ims3:namePartValue>
                    </ims3:partName>
                    <ims3:partName>
                        <ims3:namePartType>Last</ims3:namePartType>
                        <ims3:namePartValue>Monroe</ims3:namePartValue>
                    </ims3:partName>
                    <ims3:partName>
                        <ims3:namePartType>Nick</ims3:namePartType>
                        <ims3:namePartValue>Nickname</ims3:namePartValue>
                    </ims3:partName>
                </ims3:name>
                <ims2:email>marylin@mail.com</ims2:email>
                <ims3:userId>
                    <ims2:userIdValue>marmon</ims2:userIdValue>
                    <ims2:passWord>123</ims2:passWord>
                </ims3:userId>
                <ims3:address>
                    <ims3:street>First street</ims3:street>
                    <ims3:street>Second street</ims3:street>
                </ims3:address>
                <ims3:demographics>
                    <ims3:bday>1926-06-01</ims3:bday>
                </ims3:demographics>
                <ims3:institutionRole>
                    <ims3:institutionRoleType>Student</ims3:institutionRoleType>
                    <ims3:primaryRoleType>true</ims3:primaryRoleType>
                </ims3:institutionRole>
                <ims3:tel>
                    <ims3:telType>Mobile</ims3:telType>
                    <ims3:telValue>7412689</ims3:telValue>
                </ims3:tel>
                <ims3:tel>
                    <ims3:telType>Voice</ims3:telType>
                    <ims3:telValue>55567645</ims3:telValue>
                </ims3:tel>
            </ims1:person>
        </ims1:createPersonRequest>
    </soapenv:Body>
</soapenv:Envelope>

Example response message

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
    <s:Header>
        <h:syncResponseHeaderInfo>
            <messageIdentifier>1234567890</messageIdentifier>
            <statusInfo>
                <codeMajor>success</codeMajor>
                <severity>status</severity>
                <messageIdRef>1234567890</messageIdRef>
            </statusInfo>
        </h:syncResponseHeaderInfo>
        <o:Security s:mustUnderstand="1">
            <u:Timestamp u:Id="_0">
                <u:Created>2011-02-08T08:31:38.939Z</u:Created>
                <u:Expires>2011-02-08T08:36:38.939Z</u:Expires>
            </u:Timestamp>
        </o:Security>
    </s:Header>
    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <createPersonResponse/>
    </s:Body>
</s:Envelope>