Het exporteren en archiveren van cursussen zijn bewerkingen met totaal verschillende doeleinden in Blackboard Learn:

  • Een cursus exporteren is nuttig wanneer cursusmateriaal op een later tijdstip opnieuw moet worden gebruikt voor nieuwe studenten.
  • Een cursus archiveren is nuttig om een cursus op te volgen.

Meer informatie over het maken van cursussen maken van sjablonen en exportpakketten (cursussen importeren)

Als je een cursus exporteert, wordt er een zip-bestand gemaakt van de cursusinhoud. Dit bestand wordt een cursuspakket genoemd. U kunt cursuspakketten weer importeren in Blackboard Learn om een nieuwe cursus te maken met dezelfde inhoud. Als u een cursus exporteert, wordt alleen de inhoud van de cursus opgenomen in het pakket. Gebruikersinteracties, zoals blogberichten of cijfers, worden niet geëxporteerd.

Als je een cursus archiveert, wordt er ook een zip-bestand gemaakt. Dit bestand of archiefpakket bevat echter niet alleen de inhoud van de cursus, maar ook alle gebruikersinteracties. U kunt archiefpakketten weliswaar terugzetten, maar niet om de cursus opnieuw te geven, aangezien ook alle gebruikersinteracties worden teruggezet. Bewaar archiefpakketten op een veilige locatie.

U mag een cursus- of archiefpakket niet uitpakken of extraheren. Verwijder geen bestanden uit het pakket en probeer geen bestand te importeren uit het pakket. Je kunt de cursus alleen importeren of herstellen als het pakket intact is. Als je het ZIP-bestand wijzigt en het pakket vervolgens importeert of terugzet, zal de herstelde cursus instabiel zijn en onvoorspelbaar gedrag vertonen.

U kunt cursus- of archiefpakketten uit oudere versies van Blackboard Learn importeren in de huidige versie. Pakketten die zijn geëxporteerd uit nieuwere versies kunnen echter niet worden geïmporteerd in oudere versies.


Vereiste gebruikersmachtigingen

Om cursusbestanden op te nemen in een pakket tijdens het exporteren of archiveren van een cursus, moet een gebruiker die het pakket maakt, beschikken over beheerbevoegdheden voor de cursusmap.

Alleen gebruikers met beheertoegang tot de cursusmap kunnen cursusbestanden uit een pakket toevoegen aan een doelmap tijdens het importeren of herstellen van een cursus.

Als de instelling toegang heeft tot functies voor inhoudsbeheer, kunnen gebruikers met leesbevoegdheden koppelingen opnemen naar cursusbestanden tijdens het importeren/exporteren of archiveren/terugzetten van een pakket. Gebruikers met beheerbevoegdheden kunnen koppelingen opnemen naar cursusbestanden en naar kopieën van de cursusbestanden zelf.

Als de gebruiker die de cursus importeert of terugzet niet over beheerbevoegdheden beschikt, wordt mogelijk niet alle inhoud van het pakket goed geüpload.

Koppelingen naar bestanden die niet zijn opgenomen in het pakket, werken niet wanneer het pakket wordt geïmporteerd of teruggezet. Als een cursusgebied bijvoorbeeld is gekoppeld aan een toets maar het pakket geen toetsen, enquêtes en pools bevat, werkt de koppeling naar de toets niet in de nieuwe cursus.

Alle cursusgebruikers hebben leesbevoegdheid voor de cursusbestanden in het pakket. Gebruikers met de volgende rollen hebben beheermachtigingen:

  • Cursusleiders
  • Cursusbouwers
  • Onderwijsassistenten

Meer informatie over inhoud die is bijgevoegd bij het maken van cursuspakketten.


Beschikbaarheid inhoudstype

In versies ouder dan Blackboard Learn 9.1 SP 4 werden alleen beschikbare items opgenomen in een pakket als een cursus werd geëxporteerd of gearchiveerd. Wanneer u een pakket importeert uit een versie vóór SP 4, zijn items die eerder niet beschikbaar waren nu mogelijk wel beschikbaar. Het pakket bevat deze items dan echter niet. Blackboard Learn kan geen onderscheid maken tussen niet-beschikbare cursustools die expliciet zijn uitgesloten van de exportbewerking en nieuwe items die niet aanwezig waren in de oudere versie en die standaard op beschikbaar worden ingesteld. Vanaf versie 9.1 SP4 worden de exacte instellingen op cursusniveau (beschikbaar en niet-beschikbaar) daarom getraceerd en bijgehouden in exportpakketten.


Een cursus archiveren

Namen van archiefpakketten hebben de volgende syntaxis:

ArchiveFile_cursus_ID_datum/tijdstempel.zip

De pakketindeling van Blackboard Learn is gebaseerd op de IMS Content Packaging-specificatie, met extensies ter ondersteuning van specifieke inhoudstypen voor Blackboard Learn.

  1. Open het configuratiescherm voor systeembeheer en selecteer in het gedeelte Cursussen de optie Cursussen.
  2. Wijs Back-upacties aan en selecteer Cursus archiveren.
  3. Typ een geldige cursus-ID in het vak Broncursus-ID. Als je de cursus-ID niet weet, selecteer je Bladeren om de cursus te zoeken. Raadpleeg Zoeken naar cursussen voor meer informatie.
  4. Schakel het selectievakje naast de cursus-ID in om Inclusief geschiedenis van Grade Center te selecteren. Als je deze optie selecteert, worden bestanden groter en wordt de verwerkingstijd langer.
  5. Geef bij Bestandsbijlagen aan of u alleen de koppelingen naar de cursusbestanden wilt opnemen of de koppelingen naar en kopieën van de inhoud van de cursusbestanden.

    Als je Koppelingen en kopieën van de inhoud kopiëren selecteert, selecteer je Grootte berekenen om te controleren of het pakket niet groter is dan de waarde die wordt weergegeven bij Toegestane pakketgrootte. Je kunt bestanden en mappen uit het pakket verwijderen door Pakketinhoud beheren te selecteren.

  6. Selecteer Verzenden. Blackboard Learn stelt het archiefpakket samen en stuurt een e-mail naar uw account van Blackboard Learn. Deze e-mail bevat een koppeling naar de logbestandinhoud van het pakket en is een bevestiging dat het archiefpakket klaar is.
  7. Ga naar uw e-mailaccount van Blackboard Learn en controleer of u de bevestigingsmail hebt ontvangen.
  8. Open het configuratiescherm voor systeembeheer en selecteer in het gedeelte Cursussen de optie Cursussen.
  9. Zoek de cursus die je hebt gearchiveerd.
  10. Open het menu van de cursus en selecteer Exporteren/archiveren. De pagina Exporteren/archiveren bevat alle export- of archiefpakketten voor deze cursus die niet zijn verwijderd uit Blackboard Learn, zelfs als u het pakket al hebt gedownload. In de bestandsnamen ziet u de datum en tijd waarop het pakket is gemaakt.
  11. Open het menu van een ZIP-bestand en selecteer Openen.
  12. Selecteer in het dialoogvenster Bestand openen de optie Bestand opslaan en selecteer OK om het archiefpakket te downloaden op je computer.
  13. Je kunt het pakket ook permanent verwijderen uit Blackboard Learn door het menu van het ZIP-bestand te openen en Verwijderen te selecteren.

SafeAssign-opdrachten worden niet opgenomen in het archief en kunnen niet worden hersteld. Zie SafeAssign voor meer informatie.

De manier om gecombineerde cursussen te archiveren, is door de bovenliggende cursus te archiveren. Alleen bovenliggende cursussen hebben inhoud, en als u de bovenliggende cursus archiveert, worden ook de onderliggende cursussen gearchiveerd. Het is niet nodig een onderliggende cursus te archiveren aangezien deze alleen inschrijvingen bevat.

Uitgeschakelde inschrijvingen en inschrijvingen voor gebruikers-ID's die zijn uitgeschakeld, worden niet opgenomen in archiefpakketten. Niet-beschikbare inschrijvingen of gebruikers worden wel opgenomen.


Een cursus exporteren

U kunt een geëxporteerde cursus importeren om een nieuwe cursus te maken. Raadpleeg Cursussen maken van sjablonen en exportpakketten (cursussen importeren) voor meer informatie.

De pakketindeling van Blackboard Learn is gebaseerd op de IMS Content Packaging-specificatie, met extensies ter ondersteuning van specifieke inhoudstypen voor Blackboard Learn.

  1. Open het configuratiescherm voor systeembeheer en selecteer in het gedeelte Cursussen de optie Cursussen.
  2. Wijs Back-upacties aan en selecteer Cursus exporteren.
  3. Typ een geldige cursus-ID in het vak Broncursus-ID. Als je de cursus-ID niet weet, selecteer je Bladeren om de cursus te zoeken. Zie Zoeken naar cursussen voor meer informatie.
  4. Selecteer Verzenden.
  5. Geef op de pagina Cursus exporteren aan of u alleen de koppelingen naar de cursusbestanden wilt opnemen of de koppelingen naar en kopieën van de inhoud van de cursusbestanden.
    Als je Koppelingen en kopieën van de inhoud kopiëren selecteert, selecteer je Grootte berekenen om te controleren of het pakket niet groter is dan de waarde die wordt weergegeven bij Toegestane pakketgrootte. Je kunt bestanden en mappen uit het pakket verwijderen door Pakketinhoud beheren te selecteren.
  6. Schakel bij Cursusmateriaal selecteren de selectievakjes in voor alle cursusgebieden en tools in de cursus die u wilt exporteren. Raadpleeg Cursussen maken voor meer informatie over wat er bij elk item hoort.
  7. Selecteer Verzenden.

Cursussen herstellen

Als u een cursus herstelt (terugzet), wordt het archiefpakket geüpload naar Blackboard Learn en wordt de cursus hersteld naar de toestand van het moment waarop de cursus is gearchiveerd. Archiefpakketten bevatten cursusinhoud, gebruikersgegevens en gebruikersinteracties.

Archiefpakketten zijn bedoeld als permanente archieven van een cursus. Als u cursusmateriaal wilt opslaan om het materiaal later voor een andere groep studenten te gebruiken, moet u de cursus exporteren en niet archiveren. Raadpleeg Cursussen maken van sjablonen en exportpakketten (cursussen importeren) voor meer informatie.

Wanneer een cursus wordt hersteld, vervangen de instellingen en opties in het archiefpakket de standaardinstellingen en opties voor het cursusmenu die worden gebruikt voor nieuwe cursussen.

cursuspakketten die in eerdere versies van Blackboard Learn zijn gemaakt, worden mogelijk niet ondersteund. Raadpleeg de Releaseopmerkingen voor de release waarin u werkt om te zien welke versies worden ondersteund.

Groottelimiet voor het herstellen van een cursus

De standaardlimiet voor inhoud die wordt geüpload via de gebruikersinterface is 2,5 GB. Als gebruikers via de interface bestanden groter dan 2,5 GB proberen te uploaden, verschijnt er een foutmelding. Deze limiet geldt niet voor het uploaden naar webmappen of gedeelde locaties (WebDAV).

Als u grotere bestanden wilt uploaden, kunnen beheerders dit doen via de opdrachtregel of door de standaardlimiet van Tomcat te wijzigen.

Je kunt de limiet voor het uploaden van bestanden verhogen door config/bb-config.properties te openen en de waarde van de parameter 'upload limit' te wijzigen. De limiet voor het uploaden van bestanden geldt voor Tomcat en is dus niet van toepassing op WebDAV-uploads. Aangezien de instelling geldt voor Tomcat, wordt de nieuwe instelling pas van kracht wanneer de services opnieuw zijn gestart.

Je kunt de maximale grootte voor het uploaden van pakketten ook verhogen via het Configuratiescherm voor systeembeheer. Selecteer Cursusinstellingen > Standaardlimiet cursusomvang en typ een nieuwe grootte of selecteer Onbeperkt.

Gebruikersrecords herstellen

Bij het uitvoeren van een herstelbewerking controleert Blackboard Learn of gebruikers in het systeem voorkomen door gebruikersnamen te vergelijken met e-mailadressen.

Als een gebruikersnaam wordt gevonden met een ander e-mailadres dan het adres in het archiefpakket, maakt Blackboard Learn een nieuwe gebruikersaccount. De nieuwe account heeft dezelfde gebruikersnaam, maar met een cijfer eraan toegevoegd.

Als de gebruikersnaam bestaat met hetzelfde e-mailadres, wordt er geen nieuwe gebruiker gemaakt door Blackboard Learn.

Als er een gebruikersaccount bestaat, maar deze is uitgeschakeld, wordt er een nieuwe gebruikersaccount gemaakt door Blackboard Learn. Om te voorkomen dat er een andere gebruiker wordt gemaakt in het systeem, moet de oorspronkelijke gebruikersaccount worden ingeschakeld.

Voorbeeld: er wordt een gearchiveerd pakket geüpload met een account waaraan de gebruikersnaam bb_user is gekoppeld. Tijdens het herstelproces wordt er in Blackboard Learn gezocht naar gebruikers met deze gebruikersnaam. Als bb_gebruiker in het systeem voorkomt, worden de e-mailadressen vergeleken. Als de e-mailadressen overeenkomen, wordt er voor de bestaande gebruiker (bb_user) een nieuwe inschrijvingsrecord gemaakt in course_users. Als de e-mailadressen verschillen, wordt er een nieuwe gebruiker gemaakt (bb_user1).

om veiligheidsredenen krijgen gebruikers die tijdens een herstelbewerking worden toegevoegd alleen hun primaire systeemrol. Secundaire systeemrollen worden niet opgenomen.


Een cursus herstellen

  1. Open het configuratiescherm voor systeembeheer en selecteer in het gedeelte Cursussen de optie Cursussen.
  2. Zoek naar een cursus. Zie Zoeken naar cursussen voor meer informatie.
  3. Wijs Cursus maken aan en selecteer Herstellen. In deze tabel worden de beschikbare velden beschreven. [v] geeft een verplicht veld aan.
    Beschikbare velden voor het herstellen van een cursus
    Veld Beschrijving
    Doelcursus-ID Typ een ID voor de nieuwe cursus. Blackboard Learn maakt een cursus met de gegevens en instellingen uit het archiefpakket.

    U kunt cijfers, letters, afbreekstreepjes (-), liggende streepjes (_) en punten (.) gebruiken in een cursus-ID. Alle andere tekens, inclusief spaties, zijn niet toegestaan.

    Je kunt een ingestelde cursus-ID achteraf niet meer wijzigen.

    Er kunnen zoekopdrachten worden uitgevoerd op de inhoud van dit veld.

    Pakket selecteren Geef de exacte bestandslocatie van het archiefpakket op of selecteer Bladeren in Mijn Computer om naar het bestand te navigeren.
    Map voor Content Collection-bestanden Dit veld wordt alleen weergegeven als de instelling toegang heeft tot de functies voor inhoudsbeheer.

    Als je bestanden van Content Collection wilt uitsluiten, selecteer je Standaardmap cursusbestanden.

    Om bestanden van Content Collection wel te herstellen, selecteert u Map selecteren. Selecteer Bladeren om naar de map te navigeren. Blackboard Learn maakt een submap en kopieert de bestanden van Content Collection naar deze map.

  4. Selecteer Verzenden.

Export- en archieflogboeken weergeven

  1. Open het configuratiescherm voor systeembeheer en selecteer in het gedeelte Cursussen de optie Cursussen.
  2. Zoek naar een cursus. Zie Zoeken naar cursussen voor meer informatie.
  3. Open het menu van de cursus en selecteer Exporteren/archiveren. De pagina Cursus exporteren/archiveren bevat alle export- of archiefpakketten voor deze cursus die niet zijn verwijderd uit Blackboard Learn, zelfs als je het pakket al hebt gedownload. In de bestandsnamen ziet u de datum en tijd waarop het pakket is gemaakt.
  4. Open het menu van een ZIP-bestand.
  5. Om de datum en tijd te bekijken waarop het pakket is gemaakt, evenals de status van het pakket, selecteert u Basislogbestand bekijken.
  6. Om naast deze gegevens een lijst van het cursusmateriaal in het pakket weer te geven, selecteer je Gedetailleerd logbestand bekijken.

Cursussen batchgewijs exporteren, archiveren en herstellen

Blackboard Learn wordt geleverd met de tool batch_ImportExport voor het importeren/exporteren en archiveren/herstellen van een aantal cursussen tegelijkertijd. Met deze tool kunnen ook bestanden worden geïmporteerd/hersteld die groter zijn dan de standaardlimiet voor uploaden.

Met deze tool kun je batchbestanden verwerken waarin de cursus-ID en het volledige pad naar het zip-pakket zijn opgenomen.

Standaardlimiet voor uploaden

De standaardlimiet voor inhoud die wordt geüpload via de gebruikersinterface is 2,5 GB. Als gebruikers via de interface bestanden groter dan 2,5 GB proberen te uploaden, verschijnt er een foutmelding. Deze limiet geldt niet voor het uploaden naar webmappen of gedeelde locaties (WebDAV).

Als u grotere bestanden wilt uploaden, kunnen beheerders dit doen via de opdrachtregel of door de standaardlimiet van Tomcat te wijzigen.

Je kunt de limiet voor het uploaden van bestanden verhogen door config/bb-config.properties te openen en de waarde van de parameter 'upload limit' te wijzigen. De limiet voor het uploaden van bestanden geldt voor Tomcat en is dus niet van toepassing op WebDAV-uploads. Aangezien de instelling geldt voor Tomcat, wordt de nieuwe instelling pas van kracht wanneer de services opnieuw zijn gestart.

Je kunt de maximale grootte voor het uploaden van pakketten ook verhogen via het Configuratiescherm voor systeembeheer. Selecteer Cursusinstellingen > Standaardlimiet cursusomvang en typ een nieuwe grootte of selecteer Onbeperkt.


Het batchbestand maken voor exporteren/archiveren en importeren/herstellen

Een batchbestand voor de tool batch_ImportExport tool bevat in elke rij slechts twee waarden: de cursus-ID en het volledige pad naar het zip-pakket.

  • Als u een export- of archiefbewerking uitvoert, maakt Blackboard Learn een zip-bestand aan de hand van het pad en de bestandsnaam die u opgeeft.
  • Als u een import- of herstelbewerking uitvoert, verwijzen het opgegeven pad en de opgegeven bestandsnaam naar het zip-bestand dat aan de doelcursus-ID is gekoppeld.

Hieronder wordt een aantal voorbeelden gegeven van de inhoud van een batchbestand voor gebruik met de tool batch_ImportExport. Sla batchbestanden op als tekstbestanden (TXT).

Voorbeeld: batchbestanden voor exporteren en archiveren

In batchbestanden voor export- en archiefbewerkingen hoeft u alleen het pad op te geven naar de map waar de pakketten worden opgeslagen. U hoeft geen pakketnaam op te geven. Als u dat wel doet, treedt er een fout op.

Er zijn drie optionele Booleaanse vlaggen voor het opgeven van de pakketopties.

  • Optie 1: geef true of false op om aan te geven of cursusbestanden onder de basismap van de cursus moeten worden gearchiveerd/geëxporteerd. Als u geen waarde opgeeft, wordt automatisch true gebruikt.
  • Optie 2: geef true of false op om aan te geven of de cijfergeschiedenis moet worden gearchiveerd/geëxporteerd. Als je geen waarde opgeeft, wordt automatisch false gebruikt.
  • Optie 3: geef true of false op om aan te geven of cursusbestanden buiten de basismap van de cursus moeten worden gearchiveerd/geëxporteerd. Als je geen waarde opgeeft, wordt automatisch false gebruikt.

HIST101, C:\Cursusarchieven\,true,true,true
HIST201, C:\Cursusarchieven\,true,,true
HIST301, C:\Cursusarchieven\,true,false,true
HIST401, C:\Cursusarchieven\

Voorbeeld: batchbestanden voor importeren en herstellen

In batchbestanden voor import- of herstelbewerkingen moet je het exacte bestandspad opgeven, inclusief de naam van het pakket.

HIST101, C:\Course_archives\Archive_File_HIST101.zip
HIST201, C:\Course_archives\Archive_File_HIST201.zip
HIST301, C:\Course_archives\Archive_File_HIST301.zip
HIST401, C:\Course_archives\Archive_File_HIST401.zip
HIST331, C:\Course_archives\Archive_File_HIST331.zip


De batchtool uitvoeren

U moet de batchtool voor het uitvoeren van import-, export-, archief- en herstelbewerkingen vanaf de opdrachtregel uitvoeren. De tool moet worden uitgevoerd vanaf de web-/toepassingsserver. De syntaxis voor de opdracht wordt hieronder weergegeven.

Syntaxis voor Windows:

C:\Blackboard\apps\content-exchange\bin\batch_ImportExport.bat -f pad_naar_bestand -l scheidingsteken -t bewerking -n naam_virtuele_host

Gebruik cmd.exe om een opdrachtregel te openen voor het uitvoeren van de tool. Als u de tool via command.exe uitvoert, wordt een foutmelding weergegeven.

Syntaxis voor UNIX:

/usr/local/blackboard/apps/content-exchange/bin/batch_ImportExport.sh -f pad_naar_bestand -l scheidingsteken -t bewerking -n naam_virtuele_host

Het exacte pad naar de Blackboard-map kan variëren al naar gelang de locatie waar Blackboard Learn is geïnstalleerd.

Paden naar de map van Blackboard
Argument Beschrijving
pad_naar_bestand Voer het volledige pad naar het batchbestand in.
scheidingsteken Maak een keuze uit de volgende opties:
  • 1: komma (,) als scheidingsteken.
  • 2: puntkomma (;) als scheidingsteken.
  • 3: TAB als scheidingsteken.
bewerking Gebruik een van de volgende waarden (hoofdlettergevoelig) om het type bewerking aan te geven:
  • import
  • export
  • restore
  • archive
naam_virtuele_host De naam van de virtuele installatie waarvoor de tool wordt uitgevoerd. Als er geen virtuele installaties zijn, of als dit argument niet wordt opgegeven, wordt de tool uitgevoerd voor de standaard virtuele installatie.

In de vierde kolom van het invoerbestand kun je voor batch_ImportExport-bewerkingen eventueel de parameter true/false gebruiken. Deze parameter wordt alleen gebruikt in archiefbewerkingen en bepaalt of de geschiedenis van Grade Center wordt opgenomen in het pakket.


De grootte van de JVM-heap aanpassen voor de tool batch_ImportExport

  1. Open het bestand batch_ImportExport.bat of batch_ImportExport.sh voor bewerken.
  2. Voeg de parameter $OPTS of %OPTS toe om de aangepaste grootte van de JVM-heap op te nemen. De syntaxis voor de opdracht wordt hieronder weergegeven. In het volgende voorbeeld wordt de JVM-heap ingesteld op 6 GB. Pas de waarde aan op basis van de behoeften binnen de instelling.

    Syntaxis voor Windows:

    OPTS="%OPTS -Xmx6g"

    Syntaxis voor UNIX:

    OPTS="$OPTS -Xmx6g"


Ondersteunde producten voor het importeren en herstellen van cursussen

In de volgende tabel ziet u de ondersteunde producten voor het importeren of herstellen van een cursus die is geëxporteerd of gearchiveerd vanuit een ouder LMS. Gecertificeerde producten zijn volledig getest en worden ondersteund door Blackboard. Compatibele producten zijn niet volledig getest, maar zouden gelet op eerdere prestaties goed moeten functioneren.

Producten voor het importeren en herstellen van cursussen zijn niet neerwaarts compatibel. Cursussen kunnen worden geïmporteerd of hersteld naar een nieuwere versie, maar cursussen uit een nieuwere versie kunnen niet worden geïmporteerd of hersteld naar een eerdere versie.

Ondersteunde producten voor het importeren en herstellen van cursussen
Bron Ondersteuning
Blackboard Learn-versie 9.1 Gecertificeerd
Blackboard Learn Release 9.0 Gecertificeerd
Blackboard Academic Suite Release 8 Gecertificeerd
Blackboard Academic Suite Release 7 Gecertificeerd
Blackboard Academic Suite Release 6 Gecertificeerd
Blackboard ML Gecertificeerd
Blackboard 5.5* Gecertificeerd
Blackboard 5.0* Compatibel
CourseInfo 4 Niet ondersteund
Blackboard Vista en CE 8.0.5 of hoger Gecertificeerd
Blackboard Campus Edition 4.1.7 Gecertificeerd
ANGEL LMS 7.3 Niet ondersteund
ANGEL LMS 7.4 Gecertificeerd
ANGEL LMS 8.0 Gecertificeerd

*Blackboard 5 en Blackboard 5.5 hebben geen archief- en herstelfunctie. Cursussen uit deze releases kunnen worden geïmporteerd, maar cursussen kunnen niet worden hersteld met de gebruikersgegevens en interacties intact.