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 |
---|---|---|
| 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>
<
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>