Capture d'écran XML
Configurer la syntaxe XML d'intégration SIS pour la création de cours
Le format Blackboard est une variante de la norme IMS qui s'adresse explicitement aux objets spécifiques à Blackboard. Cette rubrique traite des aspects de ce format relatifs à la création d'un cours à l'aide de l'<group> élément et à son association à un nœud de la hiérarchie de l'établissement.
Au format Blackboard,
Les éléments de groupe sont utilisés pour représenter deux types d'objets : les parcours et les nœuds.
Les éléments de relation constituent le tissu conjonctif du schéma Blackboard : ils relient des nœuds à des nœuds pour former la hiérarchie de l'établissement, et des cours à des nœuds pour créer des associations de cours.
Création d'un élément de groupe de cours
Voici un fragment XML d'un élément <group> qui décrit un cours.
<!-- create a course -->
<group recstatus="1">
<sourcedid>
<source>My Institution SIS</source>
<id>0390COMPSCI697CSec1-1164</id>
</sourcedid>
<grouptype>
<scheme>Blackboard</scheme>
<typevalue level = "20"/>
</grouptype>
<datasource>My Institution SIS</datasource>
<description>
<short>Comp697</short>
<long>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
</group>Modifiez les attributs et les valeurs appropriés dans le code ci-dessus avec les détails du cours.
Note
Vous pouvez également utiliser ce code pour créer un nœud.
Élément/Attribut | Obligatoire | Description |
|---|---|---|
recstatus | Non | Type d'action à effectuer sur un objet. Les chiffres sont utilisés pour garantir l'indépendance linguistique : 1 = Ajouter, 2 = Mettre à jour et 3 = Supprimer. Si aucun attribut recstatus n'est fourni, l'API le définira par défaut sur 1 (Ajouter) si l'enregistrement n'existe pas déjà ou sur 2 (Mettre à jour) si l'enregistrement existe. |
sourcedid | Oui | Identificateur unique de l'objet de groupe composé d'un élément source et d'un élément id. |
source | Oui | Identificateur unique du système qui a créé l'objet groupe. |
id | Oui | Identificateur unique de niveau inférieur pour l'objet groupe. Pour un cours, il identifie de façon unique le cours, la période de cours ou un autre élément spécifique au sein de la communauté ou du système d'origine. Pour un nœud, il identifie de manière unique le département, l'école, etc., au sein de la communauté ou du système. |
grouptype | Oui | Type de groupe. |
scheme | Oui | Schéma de catégorisation des groupes utilisé.
|
typevalue | Oui | Spécifie ce qui est ajouté. Objet représenté par ce groupe. L'attribut typevalue doit être l'un des suivants pour Blackboard Enterprise :
L'attribut typevalue doit être l'un des suivants pour Vista Enterprise :
|
description | Oui | Décrit le cours ou le nœud. |
short | Oui | Pour un cours, identifie la version abrégée du titre du cours. Pour un nœud, identifie le nom du nœud. Par exemple, Ingénierie. |
Long | Non | Identifie le titre du cours. REMARQUE : Si aucune <long> valeur n'est spécifiée, la <short> valeur devient le titre du cours. |
full | Non | Identifie la description complète du cours ou du nœud. |
Associer un cours à un nœud à l'aide d'un élément de relation
Un élément <relationship> est toujours compris dans un élément <group> et décrit la relation de cet élément avec d'autres groupes. Voici un fragment XML d'un élément <relationship> qui décrit l'association de cours à un nœud.
<group recstatus="1">
<sourcedid>
<source>My Institution SIS</source>
<id>0390COMPSCI697CSec1-1164</id>
</sourcedid>
<grouptype>
<scheme>Blackboard</scheme>
<typevalue level = "20"/>
</grouptype>
<datasource>My Institution SIS</datasource>
<description>
<short>Comp697</short>
<long>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
<!-- primary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>CompSciDept</id>
</sourcedid>
<label/>
</relationship>
<!-- secondary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>EEDept</id>
</sourcedid>
<label/>
</relationship>
</group>Lorsqu'un cours comporte plusieurs associations, l'ordre dans lequel ces associations sont spécifiées est important. La première est considérée comme l'association principale ; tous les autres sont secondaires. Lorsqu'un cours doit déterminer les paramètres d'outil du nœud à respecter, il examine son association principale.
Note
Si le cours existe déjà (par exemple, s'il s'agit d'une mise à jour d'un cours existant), la directive ci-dessus efface toutes les associations de nœuds actuelles d'un cours avant d'en créer de nouvelles.
Modifiez les attributs et les valeurs appropriés dans le code ci-dessus avec les détails de l'association.
Élément/Attribut | Obligatoire | Description |
|---|---|---|
relationship | Non | Indique le nœud parent (dans Learning) du cours ou du nœud ajouté. REMARQUE : Cela remplace la ligne de commande et le paramètre par défaut saisis dans l'interface des paramètres d'administration. |
relation | Non | Qualifie le type de relation. Cela devrait toujours être défini sur 1. |
relationship.sourcedid | Oui | sourcedid du nœud parent auquel le cours ou le nœud doit être associé. |
label | Oui | Décrit la relation. REMARQUE : Bien qu'il s'agisse d'un champ obligatoire, une référence d'élément vide peut être utilisée s'il n'y a pas de valeur pour label, comme indiqué dans l'exemple. |