Doelen importeren
Je kunt een reeks XML-bestanden gebruiken om doelen te importeren in Blackboard Learn. Maak een XML-bestand voor iedere set met doelen, zip de XML-bestanden samen en upload het pakket.
Gebruik op een Mac niet de ingebouwde comprimeerfunctie om een zip-bestand te maken voor het importeren van je doelen. Gebruik in plaats daarvan de opdracht compress in Terminal.
Een XML-bestand mag niet meer dan één set met doelen bevatten. Je kunt een oneindig aantal categorieën en doelen hebben in die set met doelen.
Elk bestand bevat deze gegevens:
- Informatie over set met doelen.
- Categoriegegevens. Je moet deze code dupliceren en bewerken voor elke categorie in de set met doelen. Kopieer deze code en plak deze op een regel voor de regel aan het einde van het bestand.
- Informatie over doelen. U moet deze code dupliceren en bewerken voor elk doel in de categorie. Kopieer deze code en plak deze op een regel voor de regel aan het einde van het bestand.
Bestanden uploaden
Open het configuratiescherm voor systeembeheer en klik onder Tools en functies op Doelen. Op de pagina Doelen ga je met de muisaanwijzer over Set met doelen toevoegen om het menu te openen en selecteer je Set met doelen importeren. Blackboard Learn verwerkt alle bestanden tegelijkertijd.
XML-sjabloon van een set met doelen, inclusief categorieën en doelen
<?xml version="1.0" encoding="UTF-8"?>
standard_document year="VOER HIER HET JAARTAL IN" revision_date="VOER HIER DE DATUM EN TIJD VAN DE REVISIE" IN uid=VOER HIER DE ID VAN HET DOCUMENT IN. Gebruik geen spaties."
uid_provider="VOER HIER DE PROVIDERCODE VAN 2 TEKENS IN" status="VOER A, I of R IN" editable="VOER TRUE OF FALSE IN">
VOER HIER DE VOLLEDIGE NAAM VAN DE DOELBRON IN.
VOER HIER DE NAAM VAN DE SET MET DOELEN IN
VOER HIER DE VOLLEDIGE TEKST VAN HET TYPE DOELENSET IN
code="VOER HIER DE ID VOOR DE CATEGORIE IN. Gebruik geen spaties.">VOER HIER DE VOLLEDIGE NAAM VAN DE CATEGORIE IN
VOER HIER DE VOLLEDIGE NAAM VAN DE CATEGORIE IN
stem="VOER HIER VOORLOOPTEKST VOOR HET DOEL IN OF LAAT LEEG" doc_num="VOER HIER DE ID VAN HET DOEL IN OF LAAT LEEG">
VOER HIER DE TEKST VAN DE DOELVERKLARING IN
Voorbeeld
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Doelen practicum natuurkunde
Doelen introductie
De categorie Meting
Meting
leert een micrometer te gebruiken
begrijpt dat metingen in bepaalde mate onzeker zijn
De categorie Notitieblokken voor practicum
Notitieblokken voor practicum
noteert practicumresultaten gedetailleerd
Andere voorbeelden
Je kunt andere voorbeelden van XML-bestanden bekijken (volledig in het Engels) door je aan te melden op Behind the Blackboard en naar artikelnummer 13668, Blackboard Learn and CE/Vista Standards Documents te gaan.
Beschrijvingen elementen/attributen
Pas de relevante attributen en waarden aan in de sjabloon.
| Element/attribuut | Beschrijving |
|---|---|
| standard_document | Het element beschrijft de eigenschappen van de set met doelen. Er mag maar één element aanwezig zijn in het bestand. |
| year | Het jaar, in de notatie JJJJ. Bijvoorbeeld "2013". |
| revision_date | De datum en tijd van de revisie in de notatie JJJJ-MM-DD UU:MM:SS. Bijvoorbeeld "2013-12-20 13:40:00". |
| uid | De document-ID. Gebruik niet meer dan 37 tekens. Gebruik geen spaties. |
| uid_provider | Een ID van twee tekens voor de provider van de set met doelen. Bijvoorbeeld "PS". |
| status | Eén teken om de status aan te geven. Dit element is niet verplicht. Als je het wilt gebruiken, moet het een van de volgende waarden hebben:
Deze waarde wordt vervangen door de keuze van de knop Status in de UI wanneer je het XML-bestand importeert. |
| editable | Dit is "true" of "false". Dit element is niet verplicht. Als u true opgeeft, kan de set met doelen worden gewijzigd in de UI. Als je false opgeeft, zijn wijzigingen niet mogelijk (behalve het instellen van de status op A, I of R). |
| organization | Het element beschrijft de organisatie die de bron vormt van het doel. Er mag maar één element aanwezig zijn in het bestand. Vervang de tijdelijke tekst "TYP HIER DE VOLLEDIGE NAAM VAN DE BRON VOOR DE SET MET DOELEN". Vervang de tekst bijvoorbeeld door "Blackboard College". |
| org_code | Een ID voor de bron. De ID kan uit maximaal 256 tekens bestaan. Bijvoorbeeld "BB". |
| country_code | Een ID van twee tekens die het land van de bron aangeeft. Bijvoorbeeld "NL". |
| subject | Het element bepaalt de naam van de doelenset. Er mag maar één element aanwezig zijn in het bestand. Vervang de tijdelijke tekst "VOER HIER DE NAAM VAN DE SET MET DOELEN IN". Vervang de tekst bijvoorbeeld door "Doelen practicum natuurkunde". Deze naam wordt op de volgende plaatsen weergegeven in de UI:
|
| code | Een ID voor de set met doelen. Gebruik niet meer dan vijf tekens. Gebruik geen spaties. |
| document_set | Het element beschrijft het type doelenset. Er mag maar één element aanwezig zijn in het bestand. Vervang de tijdelijke tekst "TYP HIER DE VOLLEDIGE TEKST VAN HET TYPE SET MET DOELEN". Gebruik niet meer dan 101 tekens. Vervang de tekst bijvoorbeeld door "Doelen introductie". Deze tekst wordt op de volgende plaatsen weergegeven in de UI:
|
| uid | Een ID voor het type set met doelen. Gebruik geen spaties. |
| grade_range | Het element beschrijft een categorie. Het bestand moet een of meer elementen bevatten. Het aantal elementen moet overeenkomen met het aantal elementen . Vervang de tijdelijke tekst "TYP HIER DE VOLLEDIGE NAAM VAN DE CATEGORIE". Gebruik niet meer dan 101 tekens. Deze tekst wordt niet weergegeven in de UI. |
| lo, hi | Aanduidingen voor de laagste en hoogste posities waarop deze categorie moet worden weergegeven in de lijst. Deze argumenten worden meestal gebruikt om een categorie op een andere positie weer te geven dan volgens alfabetische sortering. Met deze regels wordt de categorie "Groep 1-2" bijvoorbeeld boven aan de lijst geplaatst: Groep 1-2 |
| code | Een ID voor de categorie. Gebruik geen spaties. De waarde voor dit element moet overeenkomen met een code-attribuut in een van de elementen . Dit element wordt gebruikt om het element te koppelen aan het element . |
| standard | Het element beschrijft de set met doelen voor een categorie. Het bestand moet een of meer elementen bevatten. Het aantal elementen moet overeenkomen met het aantal elementen . |
| uid | Een ID voor de doelen. Bijvoorbeeld "001". Elk element moet een unieke ID hebben. Deze ID wordt in de UI weergegeven in het veld Unieke ID op het scherm Doel bewerken. |
| title | De titel van de categorie. Bijvoorbeeld "Metingen". Er mag maar één element aanwezig zijn in elk element in het bestand. Deze titel wordt op de volgende plaatsen weergegeven in de UI:
|
| grade_range_ref | Het element koppelt de doelenset aan de categorie. Er mag maar één element aanwezig zijn in elk element in het bestand. |
| code | Voer het code-attribuut van het element voor de overeenkomstige categorie in. |
| item | Het element beschrijft een doel. Het bestand moet een of meer elementen bevatten in elk element . |
| uid | Een unieke ID voor het doel. Gebruik niet meer dan 257 tekens. |
| parent_uid | De ID van het bovenliggende doel. Als er geen bovenliggend doel bestaat, verwijdert u de tijdelijke tekst en laat u dit attribuut leeg. |
| label | Het type doel. Bijvoorbeeld "Type instrument". Deze tekst wordt in de UI weergegeven in de vervolgkeuzelijst Doeltype op het scherm Doelen ontdekken. |
| linkable | Een van deze:
Beperkte doelen zijn alleen zichtbaar voor cursussen die expliciet zijn gekoppeld aan de categorie. Op het scherm Doelen geeft het pijlpictogram naast deze doelen aan dat deze kunnen worden geopend in een nieuw venster. Als je een cursus wilt koppelen aan een categorie, open je het menu van de categorie en selecteer je Koppelen aan cursussen. |
| stem | De voorlooptekst voor het doel. Bijvoorbeeld "De student:". Als er geen voorlooptekst is, verwijder je de tijdelijke tekst en laat je dit attribuut leeg. Deze tekst wordt op de volgende plaatsen weergegeven in de UI:
|
| doc_num | De ID van het doel. Bijvoorbeeld "METINGEN_001". Gebruik niet meer dan 101 tekens. Als je geen ID wilt weergeven voor het doel, verwijder je de tijdelijke tekst en laat je dit attribuut leeg. Deze tekst wordt op de volgende plaatsen weergegeven in de UI:
|
Schema
Hieronder zie je een XML-schema voor deze XML-bestanden:
<?xml version="1.0" encoding="UTF-8"?>
http://www.w3.org/2001/XMLSchema">
De manier waarop deze bestanden de UI beïnvloeden
In de onderstaande afbeeldingen ziet u hoe items in het XML-bestand worden weergegeven in de gebruikersinterface (UI).
De afbeeldingen zijn alleen in het Engels beschikbaar. Hoewel de tekst van de bestanden hierboven wel is vertaald, zal het duidelijk zijn hoe de relaties tussen XML-bestand en UI werken.
Het scherm Doelen
In deze afbeelding zie je hoe het XML-bestand is gerelateerd aan items op het scherm Doelen.
Het scherm Doel bewerken
In deze afbeelding zie je hoe het XML-bestand is gerelateerd aan items op het scherm Doel bewerken. Dit scherm wordt weergegeven als je op het scherm Doelen het menu rechts van een doel opent en Doel bewerken selecteert. De opdracht Doel bewerken is niet beschikbaar als het attribuut editable van het element is ingesteld op "false".
Het scherm Set met doelen bewerken
In deze afbeelding zie je hoe het XML-bestand is gerelateerd aan items op het scherm Set met doelen bewerken. Dit scherm wordt weergegeven als je op het scherm Doelen het menu rechts van de doelenset opent en Bewerken selecteert. De velden Naam instellen en Bestandstype instellen kunnen niet worden gewijzigd als het attribuut editable van het element is ingesteld op “false”.)
Het scherm Inhoud
In deze afbeelding zie je hoe het XML-bestand is gerelateerd aan items op het scherm Inhoud.
Het scherm Doelen ontdekken
In deze afbeelding zie je hoe het XML-bestand is gerelateerd aan items op het scherm Doelen ontdekken. Dit scherm wordt weergegeven wanneer je Overeenstemmingen toevoegen kiest op het scherm Inhoud.
Items verwijderen
Je kunt geen items verwijderen door nieuwe bestanden te uploaden. U kunt items verwijderen via de gebruikersinterface.
Items toevoegen en vervangen
De eenvoudigste manier om items toe te voegen of te vervangen, is door de bestaande items te verwijderen (via de gebruikersinterface) en vervolgens een bestand met de bijgewerkte gegevens te uploaden.
Als u items wilt toevoegen of vervangen zonder de gebruikersinterface, leest u hieronder hoe dat in zijn werk gaat.
De hiërarchie van UID's
- De set met UID's voor een doel (in feite de set met UID's voor , , en ) moet uniek zijn binnen alle bestanden.
- Deze UID's vormen een hiërarchie:
De UID van het element is ook gerelateerd aan het attribuut code van het element , zoals hieronder is beschreven.
Nieuwe items toevoegen
Je kunt nieuwe items toevoegen, of oude items vervangen, door de UID's van items hoger in de hiërarchie ongewijzigd te laten en andere UID's te gebruiken voor items die lager in de hiërarchie staan.
Voorbeeld
- Stel dat je eerst een bestand uploadt met de volgende kenmerken. Het resultaat hiervan bestaat uit een set met doelen, een categorie en een doel.
document>
UID
UID
CODE
UID
UIDSTANDAARD_DOC_1 DOCS_SET_1 CATEGORIE_1 STANDAARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
">Doelenset 1
DOC_SET_1">Type voor doelenset 1
CATEGORY_1">Categorie 1
STANDARD_1">
Categorie 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
Dit is het doel.
- Als je vervolgens een bestand uploadt met de volgende kenmerken, worden er een nieuwe categorie en een nieuw doel aangemaakt.
document>
UID
UID
CODE
UID
UIDSTANDAARD_DOC_1 DOCS_SET_1 CATEGORIE_A STANDAARD_A ITEM_A <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Doelenset 1
DOC_SET_1">Type voor doelenset 1
CATEGORY_A">Categorie A
STANDARD_A">
Categorie A
ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Als je de UID van het element wijzigt, moet je ook het attribuut code van het element wijzigen. Als je alleen de UID van het element wijzigt, mislukt de import.
- Als je vervolgens een bestand uploadt met dezelfde kenmerken maar met andere inhoud, wordt de verklaring van het doel bijgewerkt.
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Doelenset 1
Type voor doelenset 1
Categorie A
Categorie A
This is the new goal.
Namen wijzigen
Als je dezelfde set UID's uploadt maar met andere code-attributen, worden de namen van de items gewijzigd.
Voorbeeld
- Stel dat je eerst een bestand uploadt met de volgende kenmerken. Het resultaat hiervan bestaat uit een set met doelen, een categorie en een doel.
document>
UID
CODEset>
UIDrange>
CODE
UID
UIDSTANDAARD_DOC_1 ONDERWERP_1 DOCS_SET_1 CATEGORIE_1 STANDAARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_1">Goal Set 1
Type voor doelenset 1
CATEGORY_1">Categorie 1
STANDARD_1">
Categorie 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
Dit is het doel.
- Als je vervolgens een bestand uploadt met de volgende kenmerken, wordt de naam van de set met doelen gewijzigd (van Set met doelen 1 in Set met doelen B).
document>
UID
CODEset>
UIDrange>
CODE
UID
UIDSTANDAARD_DOC_1 ONDERWERP_B DOCS_SET_1 CATEGORIE_1 STANDAARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_B">Goal Set B
DOC_SET_1">Type voor doelenset 1
CATEGORY_1">Categorie 1
STANDARD_1">
Categorie 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
Dit is het doel.
Deze procedure werkt ook voor het hernoemen van het attribuut code van het element .
Items hoger in de hiërarchie toevoegen of wijzigen
Je krijgt een foutmelding en het bestand wordt niet geüpload als de UID's voor elementen lager in de hiërarchie al zijn gebruikt, maar met UID's voor elementen hoger in de hiërarchie.
Voorbeeld
- Stel dat je eerst een bestand uploadt met de volgende kenmerken. Het resultaat hiervan bestaat uit een set met doelen, een categorie en een doel.
document>
UIDset>
UIDrange>
CODE
UID
UIDSTANDAARD_DOC_1 DOC_SET_1 CATEGORIE_1 STANDAARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Doelenset 1
DOC_SET_1">Type voor doelenset 1
CATEGORY_1">Categorie 1
STANDARD_1">
Categorie 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
Dit is het doel.
- Als u vervolgens probeert een bestand met de volgende kenmerken te uploaden, lukt dit niet.
document>
UIDset>
UIDrange>
CODE
UID
UIDSTANDAARD_DOC_C DOC_SET_1 CATEGORIE_1 STANDAARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
Blackboard College
Doelenset 1
DOC_SET_1">Type voor doelenset 1
CATEGORY_1">Categorie 1
STANDARD_1">
Categorie 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
Dit is het doel.
Als u items hoger in de hiërarchie wilt toevoegen of wijzigen, moet u andere UID's gebruiken voor items lager in de hiërarchie.
