Ce service sert à affecter les associations entre les sections SIS et les offres de cours de Brightspace.
Opérations mises en œuvre
- deleteSectionAssociation
- replaceSectionAssociation
- readSectionAssociation
À propos de l’opération deleteSectionAssociation
deleteCourseTemplate est l’opération qui sert à supprimer l’unité organisationnelle de Brightspace liée aux associations de section du LIS.
Flux de traitement : deleteSectionAssociation
- À la réception d’une requête deleteSectionAssociation du LIS, l’adaptateur obtient l’ID unique pour l’association de section à partir du champ sourcedId de la requête, sans avoir recours à un traducteur.
- Une fois l’ID de section de cours obtenu, les gestionnaires de la plateforme IPSIS configurés pour IDeleteSectionAssociationHandler traitent la requête.
- La réponse du LIS est ensuite générée depuis le gestionnaire de réponse.
Exemple de requête deleteSectionAssociation
<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:deleteSectionAssociationRequest>
<ims:sourcedId>Demo_Section_Assocation</ims:sourcedId>
</ims:deleteSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
Champs d’en-tête et de corps de requête deleteSectionAssociation
Champs de l’en-tête de la requête
Pour plus d’informations, reportez-vous à la grille d'évaluation Utiliser le service LIS v2.0 > En-têtes de requête et de réponse.
Champs du corps de la requête
L’adaptateur accepte les champs suivants dans la requête :
Propriété
|
Mise en correspondance de requête LIS
|
Requise
|
Code
|
deleteSectionAssociationRequest.sourcedId
|
Oui
|
Exemple de réponse deleteSectionAssociation
<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>CSMS_deleteCourseSection_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>
Champs d’en-tête et de corps de réponse deleteSectionAssociation
Champs de l’en-tête de réponse
Pour plus d’informations, reportez-vous à la grille d'évaluation Utiliser le service LIS v2.0 > En-têtes de requête et de réponse.
Champs du corps de réponse
Aucun champ n’est retourné dans le corps de la réponse.
À propos de l’opération replaceSectionAssociation
L’opération replaceSectionAssociation sert à créer ou mettre à jour des offres de cours de Brightspace et des sections/groupes associées d’après les requêtes d’association de section du LIS.
Lorsque vous utilisez les configurations par défaut, suivant le succès de l’opération, vous pouvez valider la création ou la mise à jour de l’association de section, grâce au DOME dans Gérer les cours dans Brightspace ou le composant graphique Mes cours.
Flux de traitement : replaceSectionAssociation
- Lorsqu’une requête replaceSectionAssociation du LIS est reçue, Brightspace la traduit à l’aide des traducteurs LIS configurés pour ITranslateSectionAssociation qui convertissent la requête dans un format que la plateforme IPSIS comprend.
- Une fois la requête traduite, les gestionnaires de la plateforme IPSIS configurés pour IReplaceSectionAssociationHandler servent à traiter la requête.
- Une réponse du LIS est ensuite générée depuis le gestionnaire de réponse.
Remarque : Si le gestionnaire ReplaceSectionAssociationDatesFromAllSectionsHandler est configuré (automatiquement configuré pour LIS 2.0), la date de début la plus ancienne et la date de fin la plus récente sont utilisées pour le cours.
Exemple de requête replaceSectionAssociation
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<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:replaceSectionAssociationRequest>
<!--Not Used by D2L-->
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
<ims:sectionAssociationRecord>
<ims:sourcedGUID>
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
</ims:sourcedGUID>
<ims:sectionAssociation>
<!--Optional:-->
<ims:title>
<ims:language>en-US</ims:language>
<ims:textString>Demo Section Association</ims:textString>
</ims:title>
<!--Optional:-->
<ims:status>Active</ims:status>
<!--Optional:-->
<ims:courseSectionIdList>
<!--1 or more repetitions:-->
<ims:courseSectionId>Demo_Section_01</ims:courseSectionId>
</ims:courseSectionIdList>
</ims:sectionAssociation>
</ims:sectionAssociationRecord>
</ims:replaceSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
Champs d’en-tête et de corps de requête replaceSectionAssociation
Champs de l’en-tête de la requête
Pour plus d’informations, reportez-vous à la grille d'évaluation Utiliser le service LIS v2.0 > En-têtes de requête et de réponse.
Champs du corps de la requête
Le modèle de configuration du traducteur accepte les champs suivants de la requête :
Propriété
|
Mise en correspondance de requête LIS
|
Requise
|
Code relatif à l’Association de section
|
sectionAssociationRecord.sourcedGUID.sourcedId
|
Oui
|
Nom relatif à l’Association de section
|
sectionAssociationRecord.sourcedGUID.sourcedId
|
Oui
|
Nom relatif à l’Association de section
|
sectionAssociationRecord.sectionAssociation.title.textString
|
Non
|
ID de section
|
sectionAssociationRecord.sectionAssociation.courseSectionIdList{*}.CourseSectionId
|
Oui
|
État
|
sectionAssociationRecord.sectionAssociation.status
|
Non
|
Exemple de réponse replaceSectionAssociation
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo
xmlns:h="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
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>CMS_replaceSectionAssociation_20120419T002302_0384880Z</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>
Champs d’en-tête et de corps de réponse replaceSectionAssociation
Champs de l’en-tête de réponse
Pour plus d’informations, reportez-vous à la grille d'évaluation Utiliser le service LIS v2.0 > En-têtes de requête et de réponse.
Champs du corps de réponse
Aucun champ n’est retourné dans le corps de la réponse.
Exemple de requête readSectionAssociation
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ims="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<soapenv:Header>
<ims:imsx_syncRequestHeaderInfo>
<ims:imsx_version>V1.0</ims:imsx_version>
<ims:imsx_messageIdentifier>MessageId_774290</ims:imsx_messageIdentifier>
</ims:imsx_syncRequestHeaderInfo>
</soapenv:Header>
<soapenv:Body>
<ims:readSectionAssociationRequest>
<ims:sourcedId>Demo_Section_Association</ims:sourcedId>
</ims:readSectionAssociationRequest>
</soapenv:Body>
</soapenv:Envelope>
Exemple de réponse readSectionAssociation
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:imsx_syncResponseHeaderInfo xmlns:h="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0"
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>CMS_readSectionAssociation_20120803T145419_1122428Z</imsx_messageIdentifier>
<imsx_statusInfo>
<imsx_codeMajor>success</imsx_codeMajor>
<imsx_severity>warning</imsx_severity>
<imsx_messageRefIdentifier>MessageId_774290</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">
<readSectionAssociationResponse xmlns="http://www.imsglobal.org/services/lis/cmsv1p0/wsdl11/sync/imscms_v1p0">
<sectionAssociationRecord>
<sourcedGUID>
<sourcedId>Demo_Section_Association</sourcedId>
</sourcedGUID>
<sectionAssociation/>
</sectionAssociationRecord>
</readSectionAssociationResponse>
</s:Body>
</s:Envelope>