Skip to main content

Configureer een cijferlijst-extract

Cijferlijst-extracten zijn volledig geautomatiseerde extracts waarvoor geen goedkeuring van cijfers nodig is om in het extract te worden opgenomen. Om toegang te krijgen tot de Grade Extract Settings voor een cijferlijst-extract:

  1. Open het Beheerpaneel.

  2. Selecteer Platformextensies uit Cloudbeheer.

  3. Kies Instellingen bewerken in het menu Grade Export v2.

  4. Kies de vergrootglas in de kolom Configuratie op de GRADEBOOK_EXTRACT rij die je wilt configureren.

Dit geeft je toegang tot het tabblad Instellingen voor Grade Extract. Dit tabblad heeft zes uitbreidbare secties.

  • Algemene instellingen — stel het integratietype in, stel het schema in en geef de geldige cijfers aan

  • Term Filter — geef aan welke termen in het fragment zullen worden opgenomen

  • Cursusfilter — geef aan welke cursussen in het fragment worden opgenomen

  • Kolomfilter — geef aan welke cijferkolommen in het extract worden opgenomen

  • Kolommapping — stel de mapping van veldnamen in op de Blackboard data die worden geëxtraheerd

  • Instellingen voor overdracht van resultaten — voer de locatie van de instelling in waar de extractbestanden worden geleverd

Algemene instellingen

  1. Kies het Integratietype.

    • NORMAL Integratie: gescheiden bestandsformaat

    • REST-integratie: JSON-formaat specifiek voor cijfersreis.

    • Legacy Banner Integratie: Legacy Banner REST API-formaat

  2. Het CRON Schedule bepaalt hoe vaak het goedgekeurde cijferbestand wordt uitgepakt. Voer een geldige CRON-expressie in om de frequentie van het extract te specificeren.

  3. In het veld Decimalen voer je het aantal cijfers in dat na de decimale plaats voor scorewaarden wordt weergegeven. De waarde wordt afgeknot, niet afgerond, en de standaard is vijf.

  4. Voer de nulwaarde in die wordt teruggegeven voor niet-gegradede, ongemarkeerde items of velden die geen waarde hebben opgeslagen in het veld Waarde extraheren voor ongemarkeerde beoordelingen (bijvoorbeeld "0" of "noValue").

  5. Specificeer een komma-gescheiden lijst van cijfers die als geldige cijferwaarden worden beschouwd in het veld Geldige Cijfers. Dit zouden lettercijfers moeten zijn, geen cijfers. Als een cijferwaarde niet geldig is, wordt deze niet opgenomen in het fragment en wordt er een e-mailmelding getriggerd. Records die van de extractie zijn uitgesloten omdat ze ongeldig zijn, worden toegevoegd aan een bestand dat aan de e-mailmelding is gekoppeld.

    Opmerking

    Als je dit vakje leeg laat, worden alle cijfers als geldig beschouwd.

  6. Voer een geldig datumformaatmasker in het veld Datum opmaken. Dit formaat wordt gebruikt voor alle datumwaarden die in het extract zijn opgenomen. Gebruik Java SimpleDateFormat.

Term Filter

  1. Zet de schakelaar Ingeschakeld aan om het extract op semester te filteren.

  2. Selecteer TOEVOEGEN of DELETE om rijen toe te voegen of te verwijderen.

  3. Selecteer in de kolom TERM de semesters waarmee je het extract wilt filteren. Alleen cursussen die aan de geselecteerde semesters horen, worden opgenomen in het fragment.

  4. Voer een ingangsdatum en een stopdatum in in de juiste kolommen. Gegevens worden gehaald uit cursussen die aan de betreffende semester zijn gekoppeld als de huidige datum tussen de ingangsdatum en de stopdatum ligt. De data kunnen blanco worden gelaten en het fragment zal niet gespecificeerd zijn.

Cursusfilter

Cursussen die in het fragment worden opgenomen, moeten aan alle geconfigureerde criteria voldoen.

  1. Zet de schakelaar Alleen beschikbare Cursussen aan om alleen gegevens van beschikbare cursussen in het cijferlijst-extract op te nemen.

  2. Zoek naar cursussen die in het cijferfragment worden opgenomen. Voer je zoekparameters in, en alle teruggestuurde cursussen worden opgenomen. Je kunt zoeken op:

    • Batch-UID

    • Cursus-ID

    • Naam cursus

    • Gegevensbronsleutel

    • Semester

    • Datum van baancreatie

    • Cursusdatum

  3. Voer een komma-gescheiden lijst van cursus-ID's in die je niet in het cijferlijst-extract wilt opnemen in het Course Exclusion List box.

Kolomfilter

Het kolomfilter wordt gebruikt om te bepalen welke cijferkolommen worden geëxtraheerd.

  • Kolomfilter Vul dit vakje in als je alleen specifieke kolommen wilt extraheren wanneer provisioning is uitgeschakeld. Voer de kolommen in een komma-gescheiden lijst van kolomnamen. Het doel van deze instelling is om het extract alleen die kolommen te laten bevatten die gerapporteerd moeten worden.

  • Externe cijferkolom (Origineel) of Algemeen Cijfer (Ultra) Alleen Selecteer dit selectievakje als je alleen de kolom externe cijfers (in Originele cursussen) of het algemene cijfer (in Ultra-cursussen) wilt extraheren. Deze instelling gaat voor de kolomfilterinstellingen en de instellingen Provisioning Enabled. Als je dit hebt geselecteerd, is het de enige kolom die wordt geëxtraheerd.

  • Provisioning ingeschakeld Selecteer dit selectievakje als je alleen cijferkolommen wilt extraheren die als onderdeel van de beoordeelbare items uit het Studentinformatiesysteem zijn geïmporteerd. Deze instelling gaat voor boven de kolomfilterinstelling.

  • Neem alleen rijen op sinds de laatste uitvoering Selecteer dit selectievakje als je alleen cijferkolomrecords wilt opnemen waarbij de cijferwaarde is veranderd sinds de laatste extractie.

  • Sluit 'alle' berekende kolommen uit Selecteer dit selectievakje in combinatie met het vorige kolomfilter om te voorkomen dat berekende kolommen worden opgenomen in het cijferextract wanneer de kolomwaarde verandert.

  • Sluit 'alle' records uit met lege cijfers Selecteer dit selectievakje om te voorkomen dat records zonder cijferwaarde in het cijferlijst-extract worden opgenomen.

  • Kolommetadatavalidatie Als je Provisioning Enabled kiest, verschijnt er een kolommetadatavalidatievak. Optioneel voer je een set sleutel/waardeparen en hun verwachte aantal voorkomen in de metadata van de cijferkolom in om te bepalen of de cursus kan worden uitgepakt. Als aan deze parameters niet wordt voldaan, geeft het systeem een foutmelding en worden gegevens uit de cursus niet geëxtraheerd.

Kolommapping

Voer een lijst in van naam/waarde-paren, gescheiden door een pipe-symbool, om de cijferkolom datavelden te identificeren die voor elk record in het rapport worden opgenomen. Als dit veld leeg blijft, wordt een standaardlijst van velden doorgegeven in de extractie.

Een voorbeeldafbeelding is:

external_course_key=Course.getBatchUid|External_person_key.=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

Aanvullende kolommapping

Zet de schakelaar Enable aan voor elk van de volgende Additional Data-velden als je ze in het extract wilt opnemen:

  • Laatste aanwezigheidsdatum De laatste datum waarop een opdracht of beoordelingspoging is aangemaakt. De headerwaarde kan worden aangepast door het veld EXTRACTION KEY bij te werken. De standaardwaarde is last_attendance_date.

  • Feedback van de instructeur De opmerking die door de docent of de keuringspersoon wordt gegeven op een kolom met berekend cijfer. De headerwaarde kan worden aangepast door het veld EXTRACTION KEY bij te werken. De standaardwaarde is instructor_comment. Deze instelling is normaal gesproken niet van toepassing op de cijferlijst-extract, aangezien de feedback van de docent binnen de goedkeuringswerkstroom wordt gegeven.

Instellingen voor resultaatoverdracht

NORMAL Integratieoptie

Instellingen voor resultaatoverdracht

  1. In het veld Filename Mask stel je het patroon in voor de bestandsextractienaam. Wanneer het Overdrachtstype is ingesteld op Gecombineerd Bestand, wordt "combined_" aan het begin van de bestandsnaam toegevoegd.

  2. Kies de overdrachtsmethode. SFTP is de meest voorkomende van de overdrachtsmethoden en de instellingen worden in deze stappen beschreven.

  3. Kies het Overdrachtstype.

    • Elk bestand resulteert in één uitpakbestand per cursus dat individueel wordt overgedragen

    • Gecombineerd bestand resultaten in één bestand zullen alle goedgekeurde rijen voor alle cursussen

  4. Schakel Use Windows EOL in als dit wordt verwerkt in een Windows-omgeving die Windows EOL vereist.

  5. Voer de URL of het IP-adres van de SFTP-server in het veld Server .

  6. Voer de SFTP-serverpoort (meestal 22) in het Port veld.

  7. Voer de SFTP-gebruikersnaam in het veld Gebruikersnaam .

  8. Voer het SFTP-wachtwoord in het Wachtwoord veld.

  9. Voer het pad voor de extractbestanden in het veld Path .

Bestandsformaat uitpakken

  1. Voer de Field Delimiter in om te gebruiken voor het extractbestand. De standaard is een pijp ( | ).

  2. En daar komt de Field Qualifier. Dit is het teken dat gebruikt moet worden als de geëxtraheerde gegevens de scheidingsteken bevatten. De standaard is een dubbele aanhalingswijze ( " ).

REST-integratieoptie

Instellingen voor resultaatoverdracht

  1. Specificeer het eindpunt voor de te plaatsen cijfers in het veld Post Webservice Endpoint.

  2. Voer het maximale aantal records in dat in één transactie moet worden opgenomen in het veld Maximum Rest Records.

Rest (uitgaande) beveiligingsopties

Selecteer Ja om Secure REST API in te schakelen Inschakelen. Als ingeschakeld, stel dan ook een beveiligingsmechanisme in.

OAuth 1.0

  • Gedeeld geheim: betreed het gedeelde geheim van OAuth

  • API-sleutel: voer de OAuth API-sleutel in

MAC Security

Lees meer over MAC-beveiliging.

  • Gedeeld geheim: voer het gedeelde geheim in

  • API-sleutel: voer de API-sleutel in

  • Tijdstempelparameter: voer de parameter in die de tijdstempelwaarde in de querystring aangeeft

  • MAC-parameter: voer de parameter in die de MAC-waarde in de querystring aangeeft

  • API-sleutelparameter: voer de parameter in die de MAC-waarde in de querystring aangeeft

OAuth 2.0

Grade Export zal een verzoek doen naar het REST-token URL geconfigureerde endpoint. De autorisatie wordt verzonden als een request-header. Het type subsidie wordt client_credentials en verzonden in het aanvraagformulier: grant_type: "client_credentials".

  • REST Key: Voer de sleutel in die gebruikt zal worden om toegang te krijgen tot de API

  • REST Secret: Voer het geheim in dat gebruikt zal worden om toegang te krijgen tot de API

  • REST Token URL: Voer de URL in die gebruikt zal worden om een toegangstoken aan te vragen

Selecteer Submit om je keuzes op te slaan.