Method description
A method to completely replace all properties of a group. Can also be used to create a group.
Preconditions for use
You will need to know the syncID of the parent hierarchy where you want to update/add the group in itslearning.
Message Schema
Input parameters / request message elements
Name | Description | Data type | Allowed values | M/O |
---|---|---|---|---|
<sourcedId ><identifier> | The syncID of the group to be updated. | Text | Max 64 chars | M |
<group> | The full or partial group object to be updated. Refer to GroupManagement service and the group object for details | Object | Valid (partial) group 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 |
---|---|---|
replaceGroupResponse | Empty createGroupResponse element | Empty |
Comments
If the syncID to update does not exist, itslearning will try to create it. Depending on the data provided, there may or may not be enough data to successfully create the group.
Example
Description
I want to insert or update a group in itslearning.
See also createGroup for more information.
Example request message
This is identical to createGroup requests, only with a different method name
<
soapenv
:Envelope
xmlns:soapenv
=
"http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims
=
"http://www.imsglobal.org/services/gms/xsd/imsGroupManMessSchema_v1p0"
xmlns:ims1
=
"http://www.imsglobal.org/services/common/imsCommonSchema_v1p0"
xmlns:ims2
=
"http://www.imsglobal.org/services/gms/xsd/imsGroupManDataSchema_v1p0"
xmlns:ims3
=
"http://www.imsglobal.org/services/common/imsMessBindSchema_v1p0"
>
<
soapenv
:Header>
<
ims3
:syncRequestHeaderInfo>
<
ims3
:messageIdentifier>1234567890</
ims3
:messageIdentifier>
</
ims3
:syncRequestHeaderInfo>
</
soapenv
:Header>
<
soapenv
:Body>
<
ims
:replaceGroupRequest>
<
ims
:sourcedId>
<
ims1
:identifier>YYY</
ims1
:identifier>
</
ims
:sourcedId>
<
ims
:group>
<
ims2
:groupType>
<
ims2
:scheme>ItslearningOrganisationTypes</
ims2
:scheme>
<
ims2
:typeValue>
<
ims2
:type>Unspecified</
ims2
:type>
<
ims2
:level>-1</
ims2
:level>
</
ims2
:typeValue>
</
ims2
:groupType>
<
ims2
:relationship>
<
ims2
:relation>Child</
ims2
:relation>
<
ims2
:sourceId>
<
ims1
:identifier>AAA</
ims1
:identifier>
</
ims2
:sourceId>
</
ims2
:relationship>
<
ims2
:description>
<
ims2
:descShort>English</
ims2
:descShort>
<
ims2
:descLong>English Language Course for 13-18 yr olds</
ims2
:descLong>
<
ims2
:descFull>English for 13-18 yr olds</
ims2
:descFull>
</
ims2
:description>
<
ims2
:extension>
<
ims1
:extensionField>
<
ims1
:fieldName>course</
ims1
:fieldName>
<
ims1
:fieldType>String</
ims1
:fieldType>
<
ims1
:fieldValue>English course</
ims1
:fieldValue>
</
ims1
:extensionField>
<
ims1
:extensionField>
<
ims1
:fieldName>course/code</
ims1
:fieldName>
<
ims1
:fieldType>String</
ims1
:fieldType>
<
ims1
:fieldValue>ENG13/18</
ims1
:fieldValue>
</
ims1
:extensionField>
</
ims2
:extension>
</
ims
:group>
</
ims
:replaceGroupRequest>
</
soapenv
:Body>
</
soapenv
:Envelope>
Example response message
This is identical to createGroup responses, only with a different method name
<
s
:Envelope
xmlns:s
=
"http://schemas.xmlsoap.org/soap/envelope/"
>
<
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-03T13:35:24.387Z</
u
:Created>
<
u
:Expires>2011-02-03T13:40:24.387Z</
u
:Expires>
</
u
:Timestamp>
</
o
:Security>
</
s
:Header>
<
s
:Body >
<
replaceGroupResponse
/>
</
s
:Body>
</
s
:Envelope>