Deze service wordt gebruikt om andere organisatie-eenheden in Brightspace® te beïnvloeden dan sjablonen, edities en secties. Dit omvat afdelingen, semesters en aangepaste typen organisatie-eenheden.
Implementatiebewerkingen
- deleteGroup
- replaceGroup
- readGroup
Info over de deleteGroup-bewerking
deleteGroup is de bewerking waarmee organisatie-eenheden van Brightspace®, zoals afdelingen en semesters, worden verwijderd.
U gebruikt deleteCourseTemplate voor cursussjablonen, deleteCourseOffering voor cursusedities, en deleteCourseSection voor cursussecties.
De bewerking deleteGroup verwerken
De deleteGroup-implementatie maakt gebruik van een van de drie IPSIS-handler-interfaces, afhankelijk van het type groep waarnaar wordt gezocht.
- IDeleteDepartmentHandler - voor die organisatie-eenheden met een standaard type afdeling van de organisatie-eenheid.
- IDeleteOtherOrgUnitHandler - voor organisatie-eenheden die geen standaard type organisatie-eenheid hebben van Afdeling, Semester, Cursussjabloon, Cursuseditie, Sectie of Groep.
- IDeleteSemesterHandler - voor organisatie-eenheden met een standaard type van Semester.
Voorbeeld deleteGroup-aanvraag
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<!--Optioneel:-->
<ims:imsx_version>V1.0</ims:imsx_version>
<!--Optioneel:-->
<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:deleteGroupRequest>
<ims:sourcedId>LIS_Test_Department</ims:sourcedId>
</ims:deleteGroupRequest>
</soapenv:Body>
</soapenv:Envelope>
Koptekst- en tekstvelden voor deleteGroup-aanvraag
Velden van aanvraagkoptekst
Raadpleeg voor meer informatie het onderwerp LIS v2.0-services gebruiken > Aanvraag- en responskopteksten.
Velden van aanvraagtekst
Veld
|
Opmerking
|
Verplicht
|
deleteGroupRequest.sourcedId
|
Dit veld moet een waarde bevatten om de unieke id van de groep die u probeert te verwijderen te communiceren.
|
Ja
|
Voorbeeld van deleteGroup-respons
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>GMS_deleteGroup_20120104T232203_8033886Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>status</imsx_severity>
<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>fullsuccess>/imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Envelope>
Koptekst- en tekstvelden voor deleteGroup-respons
Velden voor responskoptekst
Raadpleeg voor meer informatie het onderwerp LIS v2.0-services gebruiken > Aanvraag- en responskopteksten.
Velden voor responstekst
Er worden geen velden geretourneerd in de tekst van de respons.
Info over de bewerking replaceGroup
replaceGroup is de bewerking die wordt gebruikt voor het maken of bijwerken van organisatie-eenheden voor Brightspace®, zoals afdelingen en semesters.
Gebruik replaceCourseTemplate voor cursussjablonen, replaceCourseOffering voor cursusedities of replaceCourseSection voor cursussecties.
Als u de standaardconfiguraties gebruikt, kunt u na het voltooien van de procedure controleren of de groep is gemaakt of bijgewerkt via de browser voor configuratievariabelen in Brightspace®.
Processtroom: replaceGroup
- Wanneer een LIS-replaceGroup-aanvraag wordt ontvangen, zet Brightspace® de aanvraag om met behulp van de LIS-omzettingsprogramma's die zijn geconfigureerd voor ITranslateGroup. De aanvraag wordt omgezet in een indeling die het IPSIS-platform kan begrijpen.
- Zodra de aanvraag is omgezet, wordt GroupType gebruikt om te bepalen welke handlers van het IPSIS-platform worden aangeroepen.
- Als GroupType is gekoppeld aan het standaardtype voor de organisatie-eenheid Afdeling, wordt de aanvraag verwerkt met de handlers die zijn geconfigureerd voor IReplaceDepartmentHandler.
- Als GroupType is gekoppeld aan het standaardtype voor de organisatie-eenheid Semester, wordt de aanvraag verwerkt met de handlers die zijn geconfigureerd voor IReplaceSemesterHandler.
- Als GroupType iets anders is, wordt de aanvraag verwerkt met de handlers die zijn geconfigureerd voor IReplaceOrgUnitHandler.
- Een LIS-respons wordt gegenereerd op basis van de respons van de handler.
Voorbeeld van een replaceGroup-aanvraag
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:replaceGroupRequest>
<!--niet gebruikt door D2L®-->
<ims:sourcedId>Demo_Semester</ims:sourcedId>
<ims:groupRecord>
<ims:sourcedGUID>
<ims:sourcedId>Demo_Semester</ims:sourcedId>
</ims:sourcedGUID>
<ims:group>
<ims:groupType>
<!--niet gebruikt door D2L®-->
<ims:scheme>
<ims:language>en-US</ims:language>
<ims:textString>D2L</ims:textString>
</ims:scheme>
<ims:typevalue>
<ims:id>
<ims:language>en-US</ims:language>
<ims:textString>Semester</ims:textString>
</ims:id>
<!--niet gebruikt door D2L®-->
<ims:type>
<ims:language>en-US</ims:language>
<ims:textString>Semester</ims:textString>
</ims:type>
<!--niet gebruikt door D2L®-->
<ims:level>
<ims:language>en-US</ims:language>
<ims:textString>1</ims:textString>
</ims:level>
</ims:typevalue>
</ims:groupType>
<ims:description>
<ims:shortDescription>Demo Semester</ims:shortDescription>
</ims:description>
</ims:group>
</ims:groupRecord>
</ims:replaceGroupRequest>
</soapenv:Body>
</soapenv:Envelope>
Koptekst- en tekstvelden voor replaceGroup-aanvraag
Velden van aanvraagkoptekst
Raadpleeg voor meer informatie het onderwerp LIS v2.0-services gebruiken > Aanvraag- en responskopteksten.
Velden van aanvraagtekst
De configuratie van het omzettingsprogramma voor sjablonen accepteert de volgende velden in de aanvraag:
Eigenschap
|
Toewijzing LIS-aanvraag
|
Verplicht
|
Code
|
groupRecord.sourcedGUID.sourcedId
|
Ja
|
Naam
|
groupRecord.group.description.shortDescription
|
Ja
|
Type
|
groupRecord.group.groupType.typeValue(0).id
|
Ja
|
Voorbeeld van replaceGroup-respons
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>GMS_replaceGroup_20120104T232428_1383886Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>warning</imsx_severity>
<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
<imsx_description/>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>partialdatastorage</imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"/>
</s:Envelope>
Koptekst- en tekstvelden voor replaceGroup-respons
Velden voor responskoptekst
Raadpleeg voor meer informatie het onderwerp LIS v2.0-services gebruiken > Aanvraag- en responskopteksten.
Velden voor responstekst
Er worden geen velden geretourneerd in de tekst van de respons.
Voorbeeld van een readGroup-aanvraag
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>1234</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:readGroupRequest>
<ims:sourcedId>LIS_Test_Department</ims:sourcedId>
</ims:readGroupRequest>
</soapenv:Body>
</soapenv:Envelope>
Voorbeeld van een readGroup-respons
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>GMS_readGroup_20120104T231937_2063886Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>warning</imsx_severity>
<imsx_messageRefIdentifier>1234</imsx_messageRefIdentifier>
<imsx_description>GMS.readGroup</imsx_description>
<imsx_codeMinor>
<imsx_codeMinorField>
<imsx_codeMinorFieldName>TargetEndSystem</imsx_codeMinorFieldName>
<imsx_codeMinorFieldValue>partialdatastorage</imsx_codeMinorFieldValue>
</imsx_codeMinorField>
</imsx_codeMinor>
</imsx_statusInfo>
</h:imsx_syncResponseHeaderInfo>
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<readGroupResponse xmlns="http://www.imsglobal.org/services/lis/gms2p0/wsdl11/sync/imsgms_v2p0">
<groupRecord>
<sourcedGUID>
<sourcedId>LIS_Test_Department</sourcedId>
</sourcedGUID>
<group>
<groupType>
<typevalue>
<id>Department</id>
</typevalue>
</groupType>
<description>
<shortDescription>LIS Test Department</shortDescription>
</description>
</group>
</groupRecord>
</readGroupResponse>
</s:Body>
</s:Envelope>