Methoden voor velddefinitie
Op deze pagina worden de veelgebruikte velddefinities beschreven die beschikbaar zijn voor opname in de belasting voor geëxtraheerde cijfers. De werkelijke velddefinitie die in het veld Gegevenswaarde moet worden geplaatst, zie je onderaan elke cel ‘Beschrijving’.
Cursusvelden
Veld | Beschrijving |
|---|---|
Primaire sleutel | De interne Blackboard-ID voor de cursus. Deze waarde is een geheel getal dat automatisch wordt verhoogd en dat wordt gegenereerd door het Blackboard schema wanneer een cursus wordt gemaakt. Dit heeft meestal geen betekenis buiten Blackboard.
|
Externe cursussleutel | Een niet op gebruikers gerichte unieke ID die meestal wordt ingevuld via Momentopname of een vergelijkbare integratie. Als er een cursus wordt gemaakt via de GUI, is de 'Externe cursussleutel' hetzelfde als de 'Cursus-ID'. Dit vakgebied wordt ook wel het Batch-UID genoemd.
|
Classificatie | De titel van de classificatie van deze cursus.
|
Cursus-ID | De unieke, gebruikersidentificatie voor de cursus.
|
Beschikbaarheid | ‘Y’ als de cursusrecord beschikbaar is, ‘N’ als deze niet beschikbaar is.
|
Type | 'FULL' voor normale cursussen, 'COMMUNITY' voor organisaties. Er kunnen andere waarden bestaan voor interne cursussen, zoals 'SYSTEEM', maar cijfers van deze cursussen zouden niet bestaan.
|
Aanmaakdatum | De datum waarop het cursus is gemaakt.
|
Datum gewijzigd | De datum waarop de cursus het laatst is gewijzigd. Dit heeft alleen betrekking op het wijzigen van de cursusrecord zelf en NIET op inhoud, opdrachten, etc.
|
Titel | De gebruikersgerichte titel of 'cursusnaam' van de cursus.
|
Categorie-ID’s | Gescheiden lijst met ID's van alle cursuscategorieën voor de cursus (indien aanwezig). Het subscheidingsteken wordt geconfigureerd in de extractie-eigenschappen. Voorbeeld (uitgaande van een onderscheidingsteken voor leidingen): WISKUNDE|ALGEBRA
|
Categorienamen | Gescheiden lijst met de namen van alle cursuscategorieën voor de cursus (indien aanwezig). Het subscheidingsteken wordt geconfigureerd in de extractie-eigenschappen. Voorbeeld (uitgaande van een onderscheidingsteken voor leidingen): WISKUNDE|ALGEBRA
|
Gebruikersvelden
Veld | Beschrijving |
|---|---|
Primaire sleutel | De interne Blackboard-id voor de gebruiker. Deze waarde is een automatisch oplopend geheel getal dat wordt gegenereerd door het Blackboard-schema wanneer een gebruiker wordt gemaakt en die over het algemeen geen betekenis heeft buiten Blackboard.
|
External Person Key | Een niet op gebruikers gerichte unieke ID die meestal wordt ingevuld via Momentopname of een vergelijkbare integratie. Als een gebruiker wordt aangemaakt via de GUI, komt de "External Person Key" overeen met de "User Id". Dit vakgebied wordt ook wel het Batch-UID genoemd.
|
Zakelijk telefoonnummer 1 | Primair zakelijk telefoonnummer voor de gebruiker.
|
Zakelijk telefoonnummer 2 | Secundair zakelijk telefoonnummer voor de gebruiker.
|
Bedrijf | Bedrijf van de gebruiker.
|
Land | Land van het adres van de gebruiker.
|
Afdeling | Afdeling van de gebruiker.
|
E-mailadres van de gebruiker.
| |
Achternaam | De achternaam of familienaam van de gebruiker.
|
Voornaam | De voornaam of roepnaam van de gebruiker.
|
Telefoonnummer huis 1 | Primair huistelefoonnummer voor de gebruiker.
|
Telefoonnummer huis 2 | Secundair huistelefoonnummer voor de gebruiker.
|
Beschikbaarheid | ‘Y’ als de gebruikersrecord beschikbaar is, ‘N’ als deze niet beschikbaar is.
|
Functie | De functie van de gebruiker.
|
Datum laatste aanmelding | Datum waarop de gebruiker zich voor het laatst heeft aangemeld bij het systeem. Als de gebruiker nog nooit heeft ingelogd, is deze waarde leeg.
|
Tweede naam | Tweede naam van gebruiker.
|
Mobiele telefoon | Het mobiele telefoonnummer van gebruiker.
|
Student-ID | Student-ID-kenmerk van de gebruikersrecord. Niet dat deze waarde NIET gegarandeerd uniek is in het systeem. Alleen gebruikersnaam en External Person Key zijn gegarandeerd unieke velden.
|
Titel | Titel van de gebruiker. Vb.: Dhr. Mevr. Dr.
|
Gebruikers-ID | De unieke gebruikersidentificatie van de gebruiker. Ook wel bekend als de gebruikersnaam.
|
ID’s van instellingsrollen | Door dubbele punten gescheiden lijst van alle ID’s van instellingsrollen voor de gebruiker. De primaire rol-ID wordt als eerste weergegeven, gevolgd door alle secundaire rol-ID's (indien aanwezig) voor die gebruiker. Staff:Observer:Role_13
|
Namen van instellingsrollen | Door dubbele punten gescheiden lijst van alle namen van instellingsrollen voor de gebruiker. De naam van de primaire rol staat op de eerste plaats, gevolgd door alle namen van de secundaire rollen (indien aanwezig) voor die gebruiker. Staff:Observer:Role 13
|
ID van primaire instellingsrol | De ID van de primaire instellingsrol voor de gebruiker.
|
Naam van primaire instellingsrol | De naam van de primaire instellingsrol voor de gebruiker.
|
ID van secundaire instellingsrol | Door dubbele punten gescheiden lijst van alle secundaire rol-ID’s (indien aanwezig) voor de gebruiker. Observer:Role_13
|
Namen van secundaire instellingsrol | Door dubbele punten gescheiden lijst van alle secundaire rolnamen (indien aanwezig) voor de gebruiker. Observer:Role 13
|
ID’s van systeemrollen | Door dubbele punten gescheiden lijst van alle ID’s van systeemrollen voor de gebruiker in het STANDAARD-domein. De primaire systeemrol-id wordt als eerste weergegeven, gevolgd door alle secundaire systeemrol-id's (indien aanwezig) voor die gebruiker. N:U:C
|
Namen van systeemrollen | Door dubbele punten gescheiden lijst van alle namen van systeemrollen voor de gebruiker in het STANDAARD-domein. De naam van de primaire systeemrol wordt als eerste weergegeven, gevolgd door alle namen van de secundaire systeemrollen (indien aanwezig) voor die gebruiker. Geen:GebruikerAdministrator:Cursusbeheerder
|
Primaire systeemrol-ID | ID van de primaire systeemrol voor de gebruiker.
|
Primaire systeemrolnaam | De naam van de primaire systeemrol voor de gebruiker.
|
Secundaire systeemrol-ID’s | Door dubbele punten gescheiden lijst van alle secundaire systeemrol-ID’s (indien aanwezig) voor de gebruiker in het STANDAARD-domein. U:C
|
Secundaire systeemrolnamen | Door dubbele punten gescheiden lijst van alle secundaire systeemrolnamen (indien aanwezig) voor de gebruiker in het STANDAARD-domein. Gebruikersbeheerder:Cursusbeheerder
|
Cijfervelden
De velden in deze sectie worden gebruikt voor toegang tot informatie over het cijfer van een student voor een bepaald item (of een kolom) vanuit het Blackboard Learn Grade Center.
Veld | Beschrijving |
|---|---|
Primaire sleutel | De interne Blackboard-ID voor het cijfer. Deze waarde is een automatisch oplopend geheel getal dat wordt gegenereerd door het Blackboard-schema wanneer een gebruiker wordt gemaakt en die over het algemeen geen betekenis heeft buiten Blackboard.
|
Cijfer voor poging | Het visuele cijfer van de laatste poging ten opzichte van het beoordeelbare item voor de inschrijving. Als het cijfer geen Opdracht of beoordeling is, is er maar één poging.
|
Score voor de poging | De decimalen van de laatste poging ten opzichte van het beoordeelbare item voor de inschrijving.
|
Datum van de poging | De datum waarop het poging is gemaakt. Voor beoordelingen en opdrachten is dit de datum waarop het item door de student is aangemaakt. Voor handmatig ingevoerde cijfers (d.w.z. die rechtstreeks in het Grade Center-werkblad zijn ingevoerd) is dit de datum waarop de cursusleider het cijfer heeft gegeven. Merk op dat dit NIET moet worden verward met de door de instructeur ingevoerde override-datum, wat een ander veld is.
|
Pogingstatus | De numerieke weergave van de pogingstatus:
|
Handmatig cijfer | De weergavewaarde van een handmatig vervangend cijfer voor de student. Als het cijfer niet handmatig is overschreven, is deze waarde leeg.
|
Handmatige score | De decimalen van een handmatig vervangend cijfer voor de student. Als het cijfer niet handmatig is overschreven, is deze waarde leeg.
|
Weergavecijfer | De waarde van het cijfer zoals dit wordt weergegeven in Grade Center. Deze waarde is goed voor meerdere pogingen en handmatig overschreven cijfers. In de meeste gevallen is dit de waarde die je in het uittreksel wilt opnemen.
|
Weergavescore | De decimale waarde van het cijfer in Grade Center. Deze waarde is goed voor meerdere pogingen en handmatig overschreven cijfers. In de meeste gevallen is dit de waarde die je in het uittreksel wilt opnemen.
|
Indicatoren voor uitsluiting | 'Y' als het cijfer is uitgesloten door de cursusleider, anders 'N'.
|
Indicator nul-cijfer | ‘Y’ als het cijfer niet bestaat, anders ‘N’.
|
Indicator handmatig/vervangend cijfer | 'Y' als het cijfer handmatig vervangen is door de cursusleider, anders 'N'.
|
Vervangende datum | De datum waarop het cijfer is vervangen door de cursusleider. Houd er rekening mee dat dit NIET hetzelfde is als een handmatig toegewezen cijfer via het werkblad van Grade Center, maar de datum waarop een daadwerkelijk vervangend cijfer is opgegeven (toegevoegd of bijgewerkt).
|
Grade Center-itemvelden
De velden in deze sectie zijn van toepassing op de items (of kolommen) van Grade Center.
Veld | Beschrijving |
|---|---|
Primaire sleutel | De interne Blackboard-ID voor het beoordeelbare item. Deze waarde is een automatisch oplopend geheel getal dat wordt gegenereerd door het Blackboard-schema wanneer een gebruiker wordt gemaakt en die over het algemeen geen betekenis heeft buiten Blackboard.
|
Indicator extern cijfer | 'Y' als het item het externe cijfer voor de cursus is. "N" anders. Houd er rekening mee dat er per cursus slechts één item kan worden gemarkeerd als het externe cijfer.
|
Weergavebeschrijving | De naar gebruikers gerichte beschrijving van het beoordeelbare item.
|
Weergavekolomnaam | De weergavekolomnaam is een vereiste waarde in het Blackboard Grade Center en is de waarde die wordt weergegeven aan eindgebruikers, TENZIJ een weergavetitel is opgegeven.
|
Mogelijk aantal punten | Decimaal getal dat het aantal mogelijke punten aangeeft voor het beoordeelbare item.
|
Weergavetitel | De weergavetitel is niet vereist. Als deze titel echter is opgegeven voor een item in Grade Center, wordt het item weergegeven aan eindgebruikers in plaats van de ‘weergavekolomnaam’.
|
Lidmaatschapsvelden
Veld | Beschrijving |
|---|---|
Primaire sleutel | De interne Blackboard-ID voor de inschrijving. Deze waarde is een automatisch oplopend geheel getal dat wordt gegenereerd door het Blackboard-schema wanneer een gebruiker wordt gemaakt en die over het algemeen geen betekenis heeft buiten Blackboard.
|
Beschikbaarheid | 'Y' als de inschrijvingsrecord beschikbaar is, 'N' als deze niet beschikbaar is.
|
Datum van inschrijving | De datum waarop de gebruiker is ingeschreven voor de cursus. Houd er rekening mee dat deze waarde null kan zijn als de inschrijvingsdatum niet expliciet bij de integratie is opgegeven.
|
Datum gewijzigd | De datum waarop de inschrijving het laatst is gewijzigd.
|
Datum van laatste toegang | De datum waarop de gebruiker de cursus het laatst heeft geopend. Deze waarde is null als de gebruiker de cursus niet heeft geopend.
|
Statisch gegevensveld
Veld | Beschrijving |
|---|---|
Statische waarde | Maakt het mogelijk om statische inhoud op te nemen voor kolomtoewijzing, waarbij XXX de waarde is van de statische inhoud die moet worden opgenomen. In dit veld kunnen speciale tekens worden opgenomen als onderdeel van de statische waarde. De speciale tekens moeten worden geconfigureerd als hun gecodeerde waarde. Bijvoorbeeld: PROCESSSTATUS=::static::I%7C schrijft de waarde “I|” in het uittrekbestand met de kolomkop PROCESSSTATUS.
|
Speciale afgeleide waarden
De velden in deze sectie zijn speciale velden die hun waarden afleiden van andere velden.
Veld | Beschrijving |
|---|---|
Grade.PERCENTAGE_SCORE | Deze waarde bevat alleen de punten gedeeld door het mogelijke aantal punten als dit kan worden berekend. Anders is het leeg. |
Grade.LETTER_GRADE | Deze waarde is alleen de schemawaarde als er een letter aanwezig is. Anders is het leeg. |
Item.EXTERNAL_SEQNUM | Deze waarde is de waarde die is opgegeven in de externe volgordetoewijzing. |
User.OPTIONAL_DATA:XXX | Deze waarde is de waarde van de optionele gegevens van de inschrijving van de gebruiker zoals opgegeven in XXX. Voorbeeld: Als de inslag voor inlevering een optioneel gegevensveld-COHORT doorgeeft met de inschrijvingsgegevens van de gebruiker, is de implementatie die in het uittreksel moet worden opgenomen: User.OPTIONAL_DATA: COHORT |
Grade.OPTIONAL_DATA:XXX | Deze waarde is de waarde van de optionele cijfergegevens zoals opgegeven in XXX. Voorbeeld: Als de inrichting voor binnenkomend verkeer een optioneel gegevensveld PartTerm doorgeeft aan het item dat kan worden beoordeeld, is de implementatie die in het uittreksel moet worden opgenomen: Grade.OPTIONAL_DATA:PartTerm |
Grade.getCategoryName | Deze waarde wordt gebruikt voor de naam van de cijfercategorie (bijvoorbeeld Opdracht). |
User.EXTRACTOR_BATCH_UID | Deze waarde wordt gebruikt door de batch_uid van de gebruiker die de extractie heeft goedgekeurd. |
User.EXTRACTOR_USER_ID | Deze waarde wordt gebruikt door de gebruikers-ID van de gebruiker die de extractie heeft goedgekeurd. |
User.EXTRACTOR_FULLNAME | Deze waarde wordt gebruikt voor de volledige naam van de gebruiker die de extractie heeft goedgekeurd. |
User.EXTRACTOR_EMAIL | Deze waarde wordt gebruikt voor de e-mail van de gebruiker die de extractie heeft goedgekeurd. |
User.GRADER_FULLNAME | Deze waarde bestaat uit de volledige naam van de laatste beoordelaar van het beoordeelbare item. |
User.GRADER_EMAIL | Deze waarde is het e-mailadres van de laatste beoordelaar van het beoordeelde item. |
Course.TERM_CODE | Deze waarde is de naam van het semester waaraan het cursusgedeelte is gekoppeld. |
X::regEx:Y | De waarde is het resultaat van de reguliere expressie die door Y is opgegeven voor het veld X. Voorbeeld: Course.getBatchUid::regEx:^.*?_(.*?) waarbij de koers batch_uid 202210_12345 is, 12345 zou retourneren |
Grade.getPostedDate | Deze waarde wordt gebruikt voor de geposte datum (voor Ultra-cursussen). |
Term.getSourceId | Deze waarde is de bron-ID van het semester waaraan het cursusgedeelte is gekoppeld. |