Momentopname XML
XML-syntaxis voor SIS-integratie configureren voor het maken van cursussen
Het Blackboard-formaat is een variant van de IMS-standaard die expliciet is gericht op Blackboard-specifieke objecten. Dit onderwerp houdt zich bezig met de aspecten van dat formaat die betrekking hebben op het maken van een cursus met behulp van het <group> element en het associëren met een knooppunt in de instelling hiërarchie.</group>
In het Blackboard-formaat,
Groepselementen worden gebruikt om twee soorten objecten weer te geven: cursussen en knooppunten.
Relatie-elementen vormen het bindweefsel van het Blackboard-schema: ze koppelen knooppunten aan knooppunten om de instellingenhiërarchie te vormen, en cursussen aan knooppunten om cursusassociaties te maken.
Een cursusgroepselement maken
Het volgende is een XML-fragment van een <groep> element dat een cursus beschrijft.
<!-- 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>Bewerk de relevante attributen en waarden in de bovenstaande code met de details van de cursus.
Opmerking
Je kunt deze code ook gebruiken om een knooppunt te maken.
Element/attribuut | Vereist | Beschrijving |
|---|---|---|
recstatus | Nee | Type actie dat moet worden uitgevoerd op een object. Getallen worden gebruikt voor taalonafhankelijkheid: 1 = Toevoegen, 2 = Bijwerken en 3 = Verwijderen. Als er geen recstatus-attribuut wordt opgegeven, heeft de API standaard 1 (Toevoegen) als de record nog niet bestaat of 2 (Bijwerken) als de record wel bestaat. |
sourcedid | Ja | Unieke ID voor het groepsobject dat bestaat uit een bronelement en een ID-element. |
source | Ja | Unieke ID van het systeem waarmee het groepsobject is gemaakt. |
id | Ja | Unieke ID op het lagere niveau voor het groepsobject. Voor een cursus geeft dit de unieke ID weer van de specifieke cursus, semester, etc. binnen de organisatie of het oorspronkelijke systeem. Voor een knooppunt identificeert het op unieke wijze de afdeling, school, enzovoort, binnen de organisatie of het systeem. |
grouptype | Ja | Het type groep. |
scheme | Ja | Groepscategorisatieschema wordt gebruikt.
|
typevalue | Ja | Geeft aan wat er wordt toegevoegd. Het object waar deze groep voor staat. De ‘typevalue’ voor Blackboard Enterprise moet een van de volgende waarden zijn:
De ‘typevalue’ voor Vista Enterprise moet een van de volgende waarden zijn:
|
beschrijving | Ja | Beschrijft de cursus of het knooppunt. |
short | Ja | Geeft voor een cursus de beknopte versie van de cursustitel aan. Geeft voor een knooppunt de knooppuntnaam aan. Bijvoorbeeld: Engineering. |
long | Nee | Geeft de cursustitel aan. OPMERKING: Als er geen <long> waarde is opgegeven, <short> wordt de waarde de cursustitel.</short></long> |
full | Nee | Geeft de volledige cursus- of knooppuntbeschrijving aan. |
Koppel een cursus aan een knooppunt met behulp van een relatie-element
Een <relationship> element leeft altijd in een <group> element en beschrijft de relatie van dat element tot andere groepen. Het volgende is een XML-fragment van een <relationship> element dat de cursusassociatie met een knooppunt beschrijft.
<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>Als een cursus meerdere koppelingen heeft, is de volgorde waarin die koppelingen zijn opgegeven van belang. De eerste wordt beschouwd als de primaire koppeling; alle anderen zijn secundair. Wanneer een cursus moet bepalen welk knooppunt de toolinstellingen moet gebruiken, wordt er gekeken naar de primaire koppeling.
Opmerking
Als de cursus al bestaat (bijvoorbeeld als dit een update van een bestaande cursus is), worden de huidige knooppunten van de cursus gewist door de bovenstaande richtlijn voordat de nieuwe knooppunten worden gemaakt.
Bewerk de relevante attributen en waarden in de bovenstaande code met de details van de koppeling.
Element/attribuut | Vereist | Beschrijving |
|---|---|---|
relationship | Nee | Geeft het bovenliggende knooppunt (leercontext) aan van de cursus of het knooppunt die/dat wordt toegevoegd. OPMERKING: De opdrachtregel en de standaardinstelling die zijn ingevoerd in de interface met beheerinstellingen worden hierdoor vervangen. |
relatie | Nee | Kwalificeert het type relatie. Dit moet altijd een waarde van 1 zijn. |
relationship.sourcedid | Ja | sourcedid van het bovenliggende knooppunt waaraan de cursus of het knooppunt moet worden gekoppeld. |
label | Ja | Beschrijft de relatie. OPMERKING: Hoewel dit een verplicht veld is, kan een verwijzing naar een leeg element worden gebruikt als er geen waarde voor label is, zoals in het voorbeeld. |