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:

  1. Informatie over set met doelen.
  2. 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.
  3. 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:
  • A - (actief) De set met doelen is beschikbaar voor alle cursussen.
  • I - (inactief) De set met doelen is niet beschikbaar voor cursussen.
  • R - (beperkt) De set met doelen is alleen zichtbaar voor cursussen die expliciet zijn gekoppeld aan de categorie. (Als je een categorie wilt koppelen aan een cursus, open je het menu naast de categorie en selecteer je Koppelen aan cursussen.)

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:

  1. In de kolom Set met doelen op het scherm Doelen.
  2. In het veld Naam van set op het scherm Set met doelen bewerken.
  3. In de kolom Naam van set met doelen op het scherm Inhoud.
  4. In de kolom Set met doelen en de vervolgkeuzelijst Set met doelen op het scherm Doelen ontdekken.
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:

  1. In het veld Type set op het scherm Set met doelen bewerken.
  2. In de vervolgkeuzelijst Type voor set met doelen op het scherm Doelen ontdekken.
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
Groep 3
Groep 4
Groep 5
Groep 6

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:

  1. In de kolom Categorie op het scherm Doelen.
  2. In de kolom Categorie op het scherm Inhoud.
  3. In de vervolgkeuzelijst Categorie op het scherm Doelen ontdekken.
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:
  • Y - er gelden geen beperkingen voor het doel.
  • N - er gelden beperkingen voor het doel.

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:

  1. In de kolom Doelen op het scherm Doelen.
  2. In de kolom Doel op het scherm Doelen ontdekken.
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:

  1. In de kolom Doelen op het scherm Doelen.
  2. In de kolom Doel-ID op het scherm Doel bewerken.
  3. In de kolom ID op het scherm Inhoud.
  4. In de lijst Doel op het scherm Doelen ontdekken.

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

  1. 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

    UID
    STANDAARD_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.
          
       

  2. 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

    UID
    STANDAARD_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.

  3. 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

  1. 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

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDAARD_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.
          
       

  2. 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

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDAARD_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

  1. 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
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDAARD_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.
          
       

  2. Als u vervolgens probeert een bestand met de volgende kenmerken te uploaden, lukt dit niet.
    document>
    UID
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDAARD_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.