Ce service gère les unités organisationnelles Brightspace autres que les modèles, les offres et les sections. Cela comprend les départements, les semestres et les types d’unité organisationnelle personnalisés.
Opérations mises en œuvre
- deleteGroup
- replaceGroup
- readGroup
À propos de l’opération deleteGroup
deleteGroup supprime les unités organisationnelles de Brightspace, comme les départements et les semestres.
Utilisez deleteCourseTemplate pour des modèles de cours, deleteCourseOffering pour les offres de cours, deleteCourseSection pour les sections de cours.
Opération traitement deleteGroup
La mise en œuvre de deleteGroup utilise l’une des trois interfaces gestionnaires d’IPSIS selon le type de groupe traité.
- IDeleteDepartmentHandler – utilisée pour les unités organisationnelles ayant le type d’unité organisationnelle Département standard.
- IDeleteOtherOrgUnitHandler – utilisée pour les unités organisationnelles qui ne sont pas Département, Semestre, CourseTemplate, CourseOffering, Section, ou Groupe.
- IDeleteSemesterHandler – utilisée pour les unités organisationnelles ayant le type d’unité organisationnelle de Semestre standard.
Exemple de requête deleteGroup
<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:deleteGroupRequest>
<ims:sourcedId>LIS_Test_Department</ims:sourcedId>
</ims:deleteGroupRequest>
</soapenv:Body>
</soapenv:Envelope>
Exemple de réponse deleteGroup
<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>
À propos de l’opération replaceGroup
replaceGroup crée ou met à jour des unités organisationnelles de Brightspace, comme les départements et les semestres.
Utilisez replaceCourseTemplate pour des modèles de cours, replaceCourseOffering pour les offres de cours, replaceCourseSection pour les sections de cours.
Flux de traitement : replaceGroup
- Brightspace reçoit la demande replaceGroup et la traduit à l’aide des traducteurs LIS configurés pour ITranslateGroup.
- La plateforme IPSIS détermine le gestionnaire à utiliser en fonction du type de groupe.
- Une réponse est générée par le gestionnaire sélectionné.
Exemple de requête replaceGroup
<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>
<ims:sourcedId>Demo_Semester</ims:sourcedId>
<ims:groupRecord>
<ims:sourcedGUID>
<ims:sourcedId>Demo_Semester</ims:sourcedId>
</ims:sourcedGUID>
<ims:group>
<ims:description>
<ims:shortDescription>Demo Semester</ims:shortDescription>
</ims:description>
</ims:group>
</ims:groupRecord>
</ims:replaceGroupRequest>
</soapenv:Body>
</soapenv:Envelope>
Exemple de requête readGroup
<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>