Voorbeelden van cursussen voor snapshots met platte bestanden
De volgende voorbeelden geven de compositie van COURSE-gegevensfeeds weer terwijl ze aan verschillende praktijkvoorbeelden voldoen. Deze voorbeelden gebruiken de eenvoudigste invoer van gegevensfeeds die nodig is om aan het praktijkvoorbeeld te voldoen. Er zijn nog veel meer COURSE-feedheaders die u kunt gebruiken bij het maken van cursusrecords - analyse van het informatiesysteem van uw instelling en de vereisten en planning van registrars helpt bij het bepalen van de diepte van de gegevens die nodig zijn om Blackboard correct te vullen, te voldoen aan uw gegevens en levenscyclusdoelen van cursussen.
Opmerking
De voorbeelden zijn gebaseerd op standaard Blackboard-instellingen die zichtbaar zijn in de gebruikersinterface van de integratieconfiguratie. Als je deze configuratie-elementen wijzigt, worden de resultaten van het voorbeeld gewijzigd. Uitleg over deze instellingen is beschikbaar in Overzicht van Studentinformatiesysteem Framework en Snapshot Flat File Integration Configuration. Het wordt ook aangenomen, indien anders aangegeven, dat de integratie geconfigureerd is om dezelfde gegevensbron te gebruiken voor alle inkomende gegevens.
Cursussen
Cursusgegevens zijn de primaire informatieset die een cursus beschrijft in Blackboard. In de context van SIS-gegevens worden COURSE-objecten vaak 'SECTIONS' genoemd en dit wordt weerspiegeld in bestaande standaarden. Het Blackboard Snapshot Flat File dateert van vóór veel van deze standaarden en gebruikt 'COURSE' om te verwijzen naar cursusgerelateerde records op basis van de context.
Taken
Gegevens kunnen aan Blackboard worden verstrekt en vervolgens worden bijgewerkt, verwijderd of gewijzigd, zodat je kunt beginnen met de eenvoudigste gegevensset en deze uitbreiden als de gegevensvereisten van je instelling veranderen.
Opmerking
Het enige onveranderlijke COURSE-veld is COURSE_ID - dit veld mag niet worden gewijzigd nadat een record is gemaakt en de record moet worden uitgeschakeld en verwijderd als de COURSE_ID moet worden gewijzigd. Dit heeft invloed op records van activiteiten. Het wordt daarom nadrukkelijk aanbevolen om een gegevenselement te gebruiken dat waarschijnlijk niet zal worden gewijzigd tijdens de levensduur van de cursus.
Gegevensbeheer van snapshot-flatbestanden
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctief bestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron onbedoeld kan leiden tot het verwijderen of massaal uitschakelen van gegevens. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
Het Studentinformatiesysteem Framework ondersteunt het uploaden van Snapshot Flat File-gegevensfeeds via een UI Feed Upload en via een set URL's die door het Blackboard-systeem worden geleverd.
Open HTTP-gegevens en Invoerbestand uploaden via het integratiemenu in de Gegevensintegratie van de Systeembeheerder voor UI-integraties voor Studenteninformatiesystemen.
In beide gevallen wordt het gedrag van de gegevensbewerking aangestuurd door de configuratie van de integratie en het geselecteerde type bewerking. Het geselecteerde type gegevensbewerking bepaalt hoe de gegevens in de feed 'geïnterpreteerd' worden en elke URL geeft een ander resultaat om te voldoen aan de gewenste doelen van de integratie.
Bewerking | Beschrijving |
|---|---|
Opslaan | Wanneer je dit type taak gebruikt, dan worden gegevens die deel uitmaken van het bestand opgeslagen of bijgewerkt (per configuratie-instellingen) voor alle gegevensbronnen die eigendom zijn van de integratie. (zie het overzicht van SIS Framework voor gegevenseigendom en gegevensbron ) |
Volledig vernieuwen | Met deze taak worden gegevens opgeslagen of bijgewerkt die deel uitmaken van de gegevensfeed tijdens het uitschakelen van gegevens die niet zijn opgenomen in de gegevensfeed die is gekoppeld aan de integratie in alle gegevensbronnen. U moet Geavanceerde opties inschakelen selecteren om deze optie beschikbaar te maken wanneer u een bestand handmatig uploadt. |
Verwijderen | Deze taak schakelt per integratie-instellingen de records uit in de gegevensfeed die gekoppeld is aan de integratie in alle gegevensbronnen. |
Complete Refresh By Data Source | Met deze bewerking wordt een volledige vernieuwing uitgevoerd van de gegevens die ALLEEN zijn gekoppeld aan de integratie geconfigureerde gegevensbron. Deze taak imiteert de opdrachtregel nauwkeuriger voor het momentopnameproces voor het vernieuwen van gegevens. U moet Geavanceerde opties inschakelen selecteren om deze optie beschikbaar te maken wanneer u een bestand handmatig uploadt. |
De objecten die zijn gekoppeld aan Course-taken zijn:
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctief bestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron onbedoeld kan leiden tot het verwijderen of massaal uitschakelen van gegevens. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
Object | Taken |
|---|---|
Cursus | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Cursuskoppeling | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Koppeling cursusstandaard | Store, Complete Refresh, Delete, Complete Refresh By Data Source |
Voorbeelden van cursuskoppelingen kun je vinden in de sectie Hiërarchievoorbeeld.
De opgegeven voorbeelden worden weergegeven met behulp van de Momentopname Framework UI-functie voor het uploaden van invoerbestanden. Voor meer informatie over het automatiseren of gebruik van andere opdrachtregel-/ programmatische taken, raadpleeg je Automatisering van Momentopname-bestand.
Een herinnering over gegevensbronsleutels
Alle gegevensobjecten ondersteunen de mogelijkheid om de gegevensbronsleutel voor de groepering van die gegevensset te wijzigen en kunnen worden gebruikt om de bijbehorende gegevensbron te wijzigen - Opmerking: dit is geen verplicht veld in op Framework gebaseerde gegevensfeeds en, tenzij anders vermeld, wordt in de volgende voorbeelden ervan uitgegaan dat de integratie is geconfigureerd om één gegevensbron te gebruiken.
Raadpleeg Beheer gegevensbronsleutel en de sectie over het wijzigen van een gegevensbron van een cursusrecord.
Een opmerking over het in kaart brengen van velden
Field mapping biedt de mogelijkheid om binnenkomende gegevens te wijzigen voordat deze worden opgeslagen in Blackboard. Hierdoor heb je volledige controle over de gegevens die worden opgeslagen en kun je voldoen aan Blackboard-specifieke regels wanneer de Studentinformatiesysteem-gegevens die je krijgt onvoldoende zijn, bijvoorbeeld: het maken van een geschikte cursusnaaminvoer. Wanneer het script wordt toegepast op een COURSE-objectveld, wordt het bijbehorende script per cursusrecord uitgevoerd, waardoor de gegevens worden gewijzigd of verstrekt voordat deze worden opgeslagen in Blackboard. Voor meer informatie over veldtoewijzing, raadpleeg je Aangepaste veldtoewijzing van Momentopname-bestand.
Voorbeelden van cursusbewerkingen
Je kunt op een hoog niveau drie gegevensfeedpatronen van SIS-integratie vaststellen die toegepast kunnen worden op alle taken voor cursusgegevens en de selectie van het patroon is afhankelijk van de gegevens die je opgeeft.
Als je een enkel invoerbestand gebruikt, kun je de records opslaan en bijwerken (Store) om een afzonderlijk proces te gebruiken voor het uitschakelen (Delete) van records
Als je een enkel invoerbestand gebruikt, kun je records opslaan, bijwerken en uitschakelen (Volledig vernieuwen)
Als je een combinatie van bestanden gebruikt, kun je met één opslaan en met een tweede uitschakelen.
Ten slotte, en dit is geen Studentinformatiesysteem-feedpatroon, maar het vermelden waard, kunt u ook uitschakelen en verwijderen op basis van alleen DSK met behulp van de tool voor Gegevensbronbeheer die beschikbaar is in de gebruikersinterface. Je moet uiterst zorgvuldig zijn met de SIS-gegevens die je op deze manier verkrijgt. Dit is uiterst nuttig bij het wissen van gegevens die nooit of niet meer via het Studentinformatiesysteem zijn verstrekt of het resultaat zijn van testoperaties.
Alleen de basis: Cursussen
Voor alle cursusaccounts is een basisset van informatie vereist om een account op te kunnen stellen. Zie Gegevensindeling van Momentopname-bestand en Header-beschrijvingen van Momentopname-bestand voor meer informatie.
Opmerking
Als je momenteel de UI-batchtools gebruikt om te schakelen naar SIS Framework en de minimale cursusgegevens en de UI-uploadfuncties van het SIS Framework, bieden we een betere logboekregistratie en rapportage van je gegevensuploads zonder je processen voor gegevensverzameling aan te passen.
Gegevens in het kort
De minimale dataset of headers die nodig zijn voor het maken van een cursusaccount in Blackboard bestaan uit:
EXTERNAL_COURSE_KEY: een unieke ID voor deze cursusrecord.
DATA_SOURCE_KEY - een unieke ID voor de gegevensset van deze record. Let op: dit wordt verstrekt in de feed of via de integratieconfiguratie)
COURSE_ID: de ID van de cursus, deze wordt gebruikt als een unieke weergave-ID voor de cursus. COURSE_NAME: de titel van de cursus.
Het SIS Framework biedt per integratieconfiguratie standaardwaarden voor de niet-verplichte velden, of negeert deze. Twee nuttige velden die niet vereist zijn voor een COURSE-invoer zijn AVAILABLE_IND en ROW_STATUS. Deze worden besproken in het volgende praktijkvoorbeeld.
Opmerking
Elk van deze headers wordt volledig beschreven in Header-beschrijvingen van Momentopname-bestanden.
Cursusinformatie toevoegen
Er zijn twee voorbeelden voor het toevoegen van COURSE-informatie. De eerste is om COURSE-informatie additief op te slaan waardoor het toevoegen of bijwerken van de records wordt weergegeven in de gegevensfeed. De tweede is het VERNIEUWEN van CURSUSINFORMATIE die al aanwezig is in Blackboard, wat resulteert in het toevoegen van nieuwe of het bijwerken van bestaande records zoals weergegeven in het gegevensbestand, terwijl bestaande Blackboard-records die niet aanwezig zijn in het COURSE-gegevensbestand worden uitgeschakeld.
Voorbeelden store-taak
Voorbeeld #1: Cursussen maken
Je wilt cursussen toevoegen aan BLACKBOARD zonder dat dit gevolgen heeft voor bestaande accounts. Je hebt de integratie geconfigureerd om dezelfde gegevensbron voor alle inkomende gegevens te gebruiken.
Voorwaarde
Geen.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Oplossing
Maak een COURSE.txt-gegevensbestand met de vereiste kopteksten en de bijbehorende gegevens per COURSE die je wilt toevoegen aan het systeem. Bijvoorbeeld:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1
testCourse2|Course.2.1.SP2013|Test Course 2
testCourse3|Course.3.1.FA2013|Test Course 3
Gebruik de UI om dit bestand te uploaden via het gegevenstype van de COURSE met behulp van de STORE-taak. De cursusaccounts worden gemaakt en je kunt ze vinden via de cursustools van de systeembeheerder.
Voorwaarde achteraf
Er worden CURSUS-records gemaakt voor Course.1.1.SP2013, Course.2.1.SP2013 en Course.3.1.FA2014.
Voorbeeld #2: Cursussen bijwerken
Je hebt cursusaccounts gemaakt en je moet deze wijzigen. Bijvoorbeeld: in bovenstaand voorbeeld stond de term niet in de naam van de cursus.
Voorwaarde
Geen: bestaande cursussen worden bijgewerkt, alle nieuwe cursusgegevens in de feed zullen nieuwe cursussen maken.
Oplossing
Maak een COURSE.txt-gegevensbestand met de vereiste kopteksten en de bijbehorende gegevens per COURSE die je wilt bijwerken in het systeem. Bijvoorbeeld:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Opmerking
Omdat STORE alleen werkt op de gegevens in het bestand, wordt het eerder ingediende record Course.3.1.FA2013 niet beïnvloed.
Gebruik de UI om dit bestand te uploaden via het gegevenstype van de COURSE met behulp van de STORE-taak. De cursusrecords in het bestand worden bijgewerkt.
Voorwaarde achteraf
De COURSE-record voor Course.1.1.SP2013 en Course.2.1.SP2013 wordt bijgewerkt om de semester op te nemen in de COURSE_NAME
Dit heeft geen invloed op de COURSE-record voor Course.3.1.FA2014 wordt niet beïnvloed.
Cursus: Volledige verversingscursus verrichting
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctiebestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron er onbedoeld toe kan leiden dat veel cursussen onverwacht worden uitgeschakeld. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
COMPLETE REFRESH werkt anders dan STORE. Met COMPLETE REFRESH worden twee taken uitgevoerd die een vergelijking hebben tussen de gegevens in het invoerbestand en de records in LEARN die eigendom zijn van de integratie: opslaan van nieuwe records, bijwerken van bestaande records of het uitschakelen van records in LEARN die niet in het gegevensbestand staan.
Voorbeeld: Volledig vernieuwen
De gegevens die uw Studentinformatiesysteem verstrekt, bevatten een volledige momentopname van de CURSUSSEN die in BLACKBOARD zouden moeten bestaan. Deze gegevens bevatten CURSUS-records die moeten worden toegevoegd, COURSE-records die moeten worden bijgewerkt en records die zijn verwijderd sinds eerdere COMPLETE-REFRESH-bewerkingen die op de juiste manier per configuratie moeten worden afgehandeld (uitschakelen of verwijderen).
Voorwaarde
Geen.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Oplossing
Beginnend met de gegevens van onze eerste COURSE-opslagbewerking en het toevoegen van Course.1.2.SP2013 aan de datafeed en het verwijderen van Course.3.1.FA2013:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
testCourse2|Course.2.1.SP2013|Test Course 2 (SP2013)
Houd er rekening mee dat als andere COURSE-records door deze integratie worden beheerd, deze worden uitgeschakeld of verwijderd vanwege hun afwezigheid in de bovenstaande gegevensfeed.
Voorwaarde achteraf
De COURSE-record voor Course.1.1.SP2013 wordt behouden en bijgewerkt om de sectie op te nemen in de COURSE_NAME
De COURSE-record voor Course.1.2.SP2013 is toegevoegd aan Blackboard
De COURSE-record voor Course.2.1.SP2013 blijft behouden en wordt niet beïnvloed.
De COURSE-record voor Course.3.1.FA2013 is, omdat deze afwezig is in de gegevensfeed, gemarkeerd als uitgeschakeld of klaar voor verwijdering per integratieconfiguratie.
Cursus: Volledig vernieuwen per gegevensbron
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctiebestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron er onbedoeld toe kan leiden dat veel cursussen onverwacht worden uitgeschakeld. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
VOLLEDIGE VERNIEUWING PER GEGEVENSBRON voert een bewerking VOLLEDIGE VERNIEUWING uit, maar beperkt de getroffen gegevens tot de gegevens die alleen zijn gekoppeld aan de gegevensbron van de integratie.
Voorbeeld: Volledig vernieuwen per gegevensbron
De gegevens die uw Studentinformatiesysteem verstrekt, bevatten een volledige momentopname van de CURSUSSEN die in BLACKBOARD zouden moeten bestaan. Deze gegevens bevatten CURSUS-records die moeten worden toegevoegd, COURSE-records die moeten worden bijgewerkt en records die zijn verwijderd sinds eerdere COMPLETE-REFRESH-bewerkingen die op de juiste manier per configuratie moeten worden afgehandeld (uitschakelen of verwijderen). Daarnaast zijn alle gegevens in deze vernieuwing bestemd om dezelfde gegevensbron te gebruiken zoals gedefinieerd in de integratie en worden ALLEEN gegevens met betrekking tot deze gegevensbronsleutel beïnvloed.
Voorwaarde
Geen.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
Oplossing
De gegevens van onze laatste opslagbewerking gebruiken en Course.2.1.SP2013 uit de gegevensfeed verwijderen:
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)
Voorwaarde achteraf
De COURSE-records voor Course.1.1.SP2013 en Course.1.2.SP2013 worden behouden en niet beïnvloed.
De COURSE-record voor Course.2.1.SP2013 is gemarkeerd als uitgeschakeld of klaar voor verwijdering per integratieconfiguratie.
Als andere COURSE-records worden beheerd door deze integratie, worden ze NIET uitgeschakeld of verwijderd vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie.
Cursusbeschikbaarheid
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctiebestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron er onbedoeld toe kan leiden dat veel cursussen onverwacht worden uitgeschakeld. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
De instelling voor de COURSE-beschikbaarheid zorgt ervoor dat een account in LEARN zichtbaar is voor studenten (beschikbaar) of niet zichtbaar (niet-beschikbaar). Houd er rekening mee dat dit niet hetzelfde is als het uitschakelen van een cursus, waardoor de cursus niet alleen niet beschikbaar is voor Studenten en docenten, maar ook niet beschikbaar is voor aanvullende bewerkingen, zoals lidmaatschapsbeheer. De toevoeging van deze gegevensfeedheader heeft geen invloed op het bovenstaande gebruik van STORE, COMPLETE REFRESH, COMPLETE REFRESH BY DATA SOURCE voor het maken van COURSE-records.
Let op de standaardinstellingen voor integratie wanneer een AVAILABILITY-instelling niet geleverd is voor het object dat beschikbaar gemaakt moet worden voor de taken maken/bijwerken.
Voorbeeld: Beschikbaarheid cursusaccount
Je Studentinformatiesysteem-instellingen LEREN de beschikbaarheid van toegang en de datafeed geeft de beschikbaarheidsinstelling aan die gebruikers moeten bepalen wanneer ze toegang hebben tot Blackboard, en je wilt deze toegangsinstelling beheren bij het maken/bijwerken van PERSONEN.
Voorwaarde
Geen.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
AVAILABILITY_IND
Oplossing
Voeg de koptekst AVAILABLE_IND toe aan uw gegevensfeed en geef het enkele teken van Y op voor beschikbaar en N voor niet beschikbaar.
Voorwaarde achteraf
STORE
Alleen de COURSE-records voor Course.1.1.SP2013 en Course.1.2.SP2013 worden bijgewerkt (ze zijn eerder gemaakt) en Course.5.1.FA2013 wordt gemaakt.
COMPLETE REFRESH
De COURSE-records voor Course.1.1.SP2013 en Course.1.2.SP2013 worden bijgewerkt (ze zijn eerder gemaakt) en Course.5.1.FA2013 wordt gemaakt. Alle andere records worden uitgeschakeld of gemarkeerd voor verwijdering vanwege hun afwezigheid in de bovenstaande gegevensfeed.
COMPLETE REFRESH BY DATA SOURCE
De COURSE-records voor Course.1.1.SP2013 en Course.1.2.SP2013 worden bijgewerkt (ze zijn eerder gemaakt) en Course.5.1.FA2013 wordt gemaakt met beschikbaarheid die expliciet is ingesteld op Y waardoor de cursussen beschikbaar zijn.
Als andere COURSE-records worden beheerd door deze integratie, worden ze NIET uitgeschakeld of verwijderd vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie. COMPLETE REFRESH BY DATA SOURCE werkt alleen voor records van de gegevensbron van de integratie.
Cursusrecords uitschakelen
Als je een COURSE-record in Blackboard uitschakelt, is het ontoegankelijk voor alle gebruikers (de uitgeschakelde status heeft voorrang op de beschikbaarheidsinstelling) en wordt het record ook ontoegankelijk voor UI-bewerkingen - bijvoorbeeld: je kunt de meeste eigenschappen van een uitgeschakelde COURSE niet beheren via de gebruikersinterface. Systeembeheerders kunnen een uitgeschakelde cursus bekijken en weer inschakelen in het systeembeheerpaneel, anders is deze meestal 'onzichtbaar'. Als je een record van Blackboard wilt verwijderen, moet die record bovendien eerst worden uitgeschakeld.
Opmerking
Als je een record uitschakelt en vervolgens verwijdert, worden alle verwijzingen naar die record van Blackboard verwijderd - het wordt aanbevolen om uitgeschakelde records pas te verwijderen na een periode die wordt bepaald door je bedrijf en/of juridische praktijken die anders een registratie van activiteiten vereisen. Bovendien: aangezien een cursus voor gehandicapten niet toegankelijk is, zullen mensen, als ze toch toegang nodig hebben, contact opnemen met uw Helpdesk en zal de voortdurende behoefte worden opgemerkt voordat het te laat is.
Het uitschakelen van records kan op twee manieren verlopen: uitschakelen via uitsluiting van feedgegevens bij REFRESH-bewerkingen en uitschakelen via het gebruik van de feedheader ROW_STATUS.
Belangrijk
De bovenstaande COURSE-bewerkingen met behulp van REFRESH-bewerkingen demonstreren 'impliciete' uitschakeling door uitsluiting, het volgende geval en voorbeeld demonstreren dit door het gebruik van ROW_STATUS.
Voorbeeld: Cursusrecords uitschakelen
Het beleid schrijft voor dat je cursussen na een periode van 5 jaar volledig van Blackboard verwijdert. Om je hierop voor te bereiden, kun je plannen om de cursus een tijdje expliciet uit te schakelen met behulp van de kop ROW_STATUS. Dit zorgt ervoor dat niemand nog op de baan vertrouwt, omdat ze er geen toegang meer toe hebben.
Voorwaarde
Er bestaat een cursus of er wordt een cursus gemaakt en row_status ingesteld zoals aangegeven in de datafeed.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
ROW_STATUS
Oplossing
Voeg de koptekst ROW_STATUS toe aan uw gegevensfeed en geef INGESCHAKELD op voor ingeschakeld en UITGESCHAKELD voor uitgeschakeld.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|ROW_STATUS
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|enabled
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|enabled
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|disabled
Voorwaarde achteraf
STORE
Alleen de COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt met de ROW_STATUS die expliciet zijn bijgewerkt.
COMPLETE REFRESH
De COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt met de ROW_STATUS die expliciet zijn bijgewerkt. Alle andere course-records die eigendom zijn van deze integratie, worden uitgeschakeld of gemarkeerd voor verwijdering vanwege hun afwezigheid in de bovenstaande gegevensfeed.
COMPLETE REFRESH BY DATA SOURCE
De COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waarbij de ROW_STATUS expliciet worden bijgewerkt.
Als andere COURSE-records worden beheerd door deze integratie, worden ze NIET uitgeschakeld of verwijderd vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie. COMPLETE REFRESH BY DATA SOURCE werkt alleen voor records van de gegevensbron van de integratie.
Cursus samenvoegen
Course Merge biedt de mogelijkheid om meerdere secties van een cursus als één cursus te presenteren in Blackboard. Dit wordt gerealiseerd door de cursussen met relaties tussen boven- en onderliggende elementen samen te voegen. Het bovenliggende element wordt weergegeven aan gebruikers als de cursus waaraan ze deelnemen en de onderliggende secties/cursussen nemen de lidmaatschappen, etc. Cursusleiders hoeven dan slechts voor één cursus inhoud aan te leveren en het Blackboard-systeem onderhoudt een koppeling met het Studentinformatiesysteem met betrekking tot cursus-ID's, waardoor de communicatie van cursusgerelateerde informatie tussen Blackboard en het Studentinformatiesysteem wordt vergemakkelijkt.
Voorbeeld: Cursus samenvoegen
De afdeling Engels heeft vier cursussen op instapniveau waarvoor meerdere secties nodig zijn om de gewenste verhouding van studenten en cursusleiders te kunnen bieden. Ze willen één cursus bieden voor de cursusleiders om hun cursus te beheren.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
MASTER_COURSE_KEY
Oplossing
Voeg de koptekst ROW_STATUS toe aan uw gegevensfeed en geef INGESCHAKELD op voor ingeschakeld en UITGESCHAKELD voor uitgeschakeld.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|MASTER_COURSE_KEY
testCourse1|Course.1.1.SP2013|Test Course 1.1 (SP2013)|
testCourse1.2|Course.1.2.SP2013|Test Course 1.2 (SP2013)|testCourse1
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Als je MASTER_COURSE_KEY leeg laat, betekent dit dat er geen 'bovenliggende' is voor de cursus of dat de cursus niet wordt samengevoegd met een bovenliggende cursus.
Voorwaarde achteraf
STORE
Alleen de COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waardoor een ouder-kindrelatie tot stand wordt gebracht tussen Course.1.1.SP2013 (bovenliggend) en Course.1.2.SP2013.
COMPLETE REFRESH
De COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waardoor een ouder-kindrelatie tot stand wordt gebracht tussen Course.1.1.SP2013 (bovenliggend) en Course.1.2.SP2013. Alle andere course-records die eigendom zijn van deze integratie, worden uitgeschakeld of gemarkeerd voor verwijdering vanwege hun afwezigheid in de bovenstaande gegevensfeed.
COMPLETE REFRESH BY DATA SOURCE
De COURSE-records voor Course.1.1.SP2013, Course.1.2.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waardoor een ouder-kindrelatie tot stand wordt gebracht tussen Course.1.1.SP2013 (bovenliggend) en Course.1.2.SP2013.
Als andere COURSE-records worden beheerd door deze integratie, worden ze NIET uitgeschakeld of verwijderd vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie. COMPLETE REFRESH BY DATA SOURCE werkt alleen voor records van de gegevensbron van de integratie.
Cursus sjabloon
Cursussjablonen worden gebruikt op het moment dat een cursus wordt gemaakt om consistentie te bieden in het uiterlijk, cijferlijsten, inhoudsstructuur, etc. Een cursus die is gemaakt met behulp van een sjabloon is een afspiegeling van dat sjabloon met uitzondering van de specifieke cursusinstellingen die in de COURSE-gegevensfeed worden weergegeven. Je kunt een willekeurige cursus voor dit doel gebruiken.
Belangrijk
Sjablonen worden alleen gebruikt wanneer een cursus wordt gemaakt. Als u een cursus wilt maken en vervolgens een sjabloon wilt aanbieden via een updatefeed, kunt u dit doen door Systeembeheerder → Studentinformatiesysteem-integraties → (uw integratie) ⧩ → Geavanceerde configuratie → cursussen ⧩ → Veldtoewijzing → Kopiesleutel voor broncursus in te stellen en het selectievakje Wijzigen bij bijwerken in te schakelen (dat niet standaard is ingeschakeld).
Voorbeeld: Cursussjabloon
Waarschuwing
Houd er rekening mee dat het uploaden van een kort correctiebestand met de bewerking Vernieuwen voltooien of Vernieuwen per gegevensbron er onbedoeld toe kan leiden dat veel cursussen onverwacht worden uitgeschakeld. Om dit te voorkomen, raden we het handmatige gebruik van de bewerkingstypen Volledig vernieuwen of Volledig vernieuwen op gegevensbron af. Deze opties zijn standaard niet beschikbaar op de pagina Feedbestand uploaden. Als u echter beide opties inschakelt, schakelt u het selectievakje Geavanceerde opties inschakelen onder Bewerkingstype in.
De afdeling Wiskunde vereist dat alle wiskundecursussen een vergelijkbare look en feel hebben met een vergelijkbare inhoudslay-out en gevuld zijn met een aantal kerninhoud.
Voorwaarde
Er is een cursusstructuur gemaakt met de vereiste inhoud, opmaak en instellingen.
Minimale vereisten voor datafeeds
EXTERNAL_COURSE_KEY
COURSE_ID
COURSE_NAME
TEMPLATE_COURSE_KEY
Oplossing
Voeg de koptekst TEMPLATE_COURSE_KEY toe aan uw gegevensfeed en geef de external_course_key op van de cursus die de sjabloon vertegenwoordigt.
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|TEMPLATE_COURSE_KEY
testCourse1|Course.6.1.SP2013|Test Course 1.1 (SP2013)|testCourseTemplate.SP2013
testCourse5.1|Course.5.1.FA2013|Test Course 5.2 (FA2013)|
Als je TEMPLATE_COURSE_KEY leeg laat, betekent dit dat er voor de cursus geen sjabloon nodig is.
Voorwaarde achteraf
STORE
Alleen de COURSE-record voor Course.6.1.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waarbij Course.6.1.SP2013 wordt gemaakt met behulp van de sjabloon testCourseTemplate.SP2013.
COMPLETE REFRESH
Alleen de COURSE-record voor Course.6.1.SP2013 en Course.5.1.FA2013 worden gemaakt of bijgewerkt, waarbij Course.6.1.SP2013 wordt gemaakt met behulp van de sjabloon testCourseTemplate.SP2013. Alle andere records worden uitgeschakeld of gemarkeerd voor verwijdering vanwege hun afwezigheid in de bovenstaande datafeed.
COMPLETE REFRESH BY DATA SOURCE
Alleen de COURSE-record voor Course.6.1.SP2013 en Course.5.1.FA2013 wordt gemaakt of bijgewerkt, waarbij Course.6.1.SP2013 wordt gemaakt met behulp van de sjabloon testCourseTemplate.SP2013.
Als andere COURSE-records worden beheerd door deze integratie, worden ze NIET uitgeschakeld vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie. COMPLETE REFRESH BY DATA SOURCE werkt alleen voor records van de gegevensbron van de integratie.
Compleet voorbeeld
Als je de bovenstaande headers combineert in één bestand dan kunnen we meer praktijkvoorbeelden tegelijkertijd bespreken.
Voorwaarde
De taak voor het kopiëren van sjablonen kan alleen slagen als testCourse8 niet eerder is gemaakt.
Opmerking
Om de serversnelheid te behouden en onnodige databasebelasting te voorkomen, is er een limiet voor het aantal Studentinformatiesysteem-gestuurde kopieertaken dat gelijktijdig in de cluster kan worden uitgevoerd. U kunt de status van deze taken bekijken in Systeembeheerder → Logboeken → Systeemtaakstatus
EXTERNAL_COURSE_KEY|COURSE_ID|COURSE_NAME|AVAILABLE_IND|ROW_STATUS|MASTER_COURSE_KEY|TEMPLATE_COURSE_KEY
testCourse8|Course.8.SP2013|Test Course 8 (SP2013)|Y|ENABLED||testCourseTemplate.SP2013
testCourse8.1|Course.8.1.SP2013|Test Course 8.1 (SP2013)|Y|ENABLED|testCourse8|
testCourse8.2|Course.8.2.SP2013|Test Course 8.2 (SP2013)|Y|ENABLED|testCourse8|
testCourse9.1|Course.9.1.FA2013|Test Course 5.2 (FA2013)|Y|DISABLED||
Voorwaarde achteraf
STORE
Alleen de COURSE-records voor Cursus.1.1.SP2013, Cursus.1.2.SP2013 en Cursus.5.1.FA2013 worden gemaakt of bijgewerkt met de volgende resultaten:
Voor alle cursussen is de beschikbaarheid ingesteld op Y, wat aangeeft dat de cursussen beschikbaar zijn.
Course.1.1.SP2013 en Course.1.2.SP2013 zijn ingesteld op ENABLED, terwijl Course.5.1.FA2013 is ingesteld op DISABLE.
Breng een ouder-kindrelatie tot stand tussen Course.1.1.SP2013 (bovenliggend) en Course.8.1.SP2013 en Course.8.2.SP2013.
Bij het maken van Course.8.SP2013 worden de inhoud en instellingen van de sjabloon testCourseTemplate.SP2013 gekopieerd naar Course.8.SP2013.
COMPLETE REFRESH
Hetzelfde resultaat als bij de opslagbewerking met de toevoeging dat alle andere records worden uitgeschakeld of gemarkeerd voor verwijdering vanwege hun afwezigheid in de gegevensfeed.
COMPLETE REFRESH BY DATA SOURCE
Hetzelfde resultaat als de winkelbewerking met de toevoeging dat als andere COURSE-records worden beheerd door deze integratie, deze NIET worden uitgeschakeld vanwege hun afwezigheid in de bovenstaande gegevensfeed, tenzij ze dezelfde gegevensbron hebben als gespecificeerd door de integratie. COMPLETE REFRESH BY DATA SOURCE werkt alleen voor records van de gegevensbron van de integratie.