Skip to main content

Configureer de Goedkeuringswerkstroom

De goedkeuringswerkstroom, indien ingeschakeld, is ingesteld om op een specifiek schema te draaien en haalt automatisch de goedgekeurde cijfers eruit. Om toegang te krijgen tot de Cijfer Extract-instellingen voor de goedkeuringswerkstroom:

  1. Open het Beheerpaneel.

  2. Selecteer Platform Extensies uit Cloudbeheer.

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

  4. Kies de vergrootglas in de Configureer kolom op de GOEDKEURINGS_WERKSTROOM rij.

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

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. Zet de Enabled? aan? toggle als je wilt dat het proces op het aangegeven CRON Schedule draait, voer dan de CRON-expressie in om de frequentie van de extractie aan te geven.

  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.

Kolomfilter

Het kolomfilter wordt gebruikt om te bepalen welke kolommen aan beoordelaars worden getoond ter goedkeuring. Er kan maar één filteroptie tegelijk actief zijn.

  • Kolomfilter Vul dit vakje in als je alleen specifieke kolommen aan beoordelaars wilt tonen 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 Alleen Algemeen Cijfer (Ultra) Selecteer dit selectievakje als je alleen de kolom externe cijfers (in Originele cursussen) of het algemene cijfer (in Ultra-cursussen) aan de beoordelaars wilt tonen. Deze instelling gaat voor de kolomfilterinstellingen en de instellingen Provisioning Enabled.

  • Provisioning ingeschakeld Selecteer dit selectievakje als je alleen cijferkolommen wilt weergeven die geïmporteerd zijn als onderdeel van de gradable items die van het Studentinformatiesysteem naar de beoordelaars zijn geprovisioneerd. Deze instelling gaat voor boven de kolomfilterinstelling.

  • 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 vakje leeg blijft, wordt een standaardlijst van velden in de extractie doorgegeven.

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.

Cursusrolinstellingen extraheren

  1. Zet de schakelaar Inzender Werkstroom in om een extra stap aan de werkstroom toe te voegen waarbij cijfers worden ingediend bij een approver (bijvoorbeeld een onderwijsassistent dient de cijfers in zodat de docent ze goedkeurt).

  2. Voor Rollen die Moeten Goedkeuren, specificeer de cursusrollen die vereist zijn zodat een gebruiker het goedkeuringsproces kan starten om cijfers goed te keuren (zoals Docent). Indien gewenst, specificeer ook eventuele aanvullende institutionele rollen die nodig zijn om cijfers goed te keuren (zoals Grade Approver). Een gebruiker met een van deze rollen kan cijfers goedkeuren.

  3. Voor Rollen die verplicht zijn om in te dienen specificeer je welke cursusrollen vereist zijn zodat een gebruiker het goedkeuringsproces kan starten om cijfers in te dienen (zoals Teaching Assistant). Geef indien gewenst ook eventuele aanvullende institutionele rollen aan die nodig zijn om cijfers in te dienen (zoals Grade Submitter). Een gebruiker met een van deze rollen kan cijfers indienen.

    Opmerking

    Deze instelling wordt alleen weergegeven als de Submitter Werkstroom is ingeschakeld.

  4. Het bericht over toegang geweigerd mag hier niet worden ingevuld; het bericht 'aangepaste toegang geweigerd' wordt nu ingevoerd op het scherm Rollen Configureren.

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 wordt 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

      Opmerking

      Een handmatige extractie genereert een cursusspecifiek extractbestand.

  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

Grades Journ 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".

Vul de volgende velden in:

  • 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

Beoordelingsgoedkeuring en overdrachtsinstellingen

Instellingen voor Beoordelingsgoedkeuring en Overdracht

  1. Schakel Grade Approval Required in om cijfergoedkeuring op kolom- of cijferniveau mogelijk te maken. Als dit niet is ingeschakeld, kunnen cijfers alleen op cursusniveau worden goedgekeurd.

  2. Selecteer Knop Cijfers Extracteren ingeschakeld om de knop Cijfers-extractie te laten verschijnen voor goedkeurers. Graders kunnen de extractie direct uitvoeren. Voor een NORMAL-integratie wordt het extract alleen gegenereerd en verzonden wanneer het Transfer Type is ingesteld op Each File.

    Opmerking

    De knop 'Cijfers extraheren' verschijnt altijd voor gebruikers van Grade Approver Admin.

  3. Selecteer Cijfers verzenden-knop ingeschakeld? om de knop 'Cijfers indienen' te laten verschijnen voor inzenders.

    Opmerking

    Als de inzenderwerkstroom niet is ingeschakeld, wordt dit selectievakje verborgen.

    De knop Submit Grades verschijnt altijd voor Grade Approver Admin-gebruikers als de inzenderwerkstroom is ingeschakeld.

  4. Selecteer Alleen goedkeuringen voor ingediende cijfers toestaan om te voorkomen dat cijfers met een andere status dan ingediend worden goedgekeurd of niet goedgekeurd.

    Opmerking

    Als de inzenderwerkstroom niet is ingeschakeld, wordt dit selectievakje verborgen.

  5. Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.

  6. Selecteer Instructeurfeedback inschakelen als de kolom Instructeurfeedback beschikbaar zou moeten zijn voor docenten in het Cijfergoedkeuringsgebied voor cijfers die horen bij berekende en handmatige kolommen.

  7. Selecteer Cursuszoekopdracht toestaan voor Grade Approvers? of de Link Geavanceerde Zoekopdracht zichtbaar zou moeten zijn voor docenten in het Cijfergoedkeuringsgebied zodat ze kunnen zoeken naar een ander vak waar ze aan toegewezen zijn.

  8. Selecteer Toets Goedkeuren-knop ingeschakeld? om de knop 'Cijfers goedkeuren' te laten verschijnen voor goedkeurers.

    Opmerking

    De knop 'Cijfers goedkeuren' verschijnt altijd voor gebruikers van Grade Approver Admin.

  9. Selecteer Alleen toestaan van het afnemen van goedkeuringen met redenmelding? om te voorkomen dat cijfers worden afgekeurd in de Cijfergoedkeuring en Overdracht tool als er geen reden is ingevoerd.

    Opmerking

    Als de inzenderwerkstroom niet is ingeschakeld, wordt het selectievakje verborgen.

  10. Selecteer Beperk de toegang tot kindcursussen tot alleen inzenders of goedkeurers om inzenders of goedkeurers te beperken tot alleen het zien van studenten op het cijferniveau voor kindcursussen waaraan zij zijn toegewezen.

  11. Selecteer Beperk de operaties tot het cijferniveau om alle goedkeuringsacties op het niveau van de cursus en de kolom te voorkomen. Indieners en goedkeurers kunnen alleen actie ondernemen op het niveau van het cijferniveau.

  12. De instelling Direct naar het cijferniveau starten is bedoeld voor een aankomende functie in de goedkeuringswerkstroom en mag niet worden geselecteerd.

  13. Selecteer Niet-geplaatste cijfers opnemen om cijfers op te nemen die niet in het cijferuittreksel zijn geplaatst. Dit omvat geen handmatige kolommen of kolommen waarbij cijfers zijn overschreven maar nog niet geplaatst.

  14. Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.

Configuratie van de Cijferweergavewaarde

Stel de cijferwaarde in om te worden weergegeven in de Goedkeuringswerkstroom:

  • Cijferletter: als de schemawaarde een letter is, geeft het een lettercijfer terug; anders geeft het een lege string terug

  • Schemawaarde: retourneert de cijferkolom Primaire weergave

  • Percentage score: geeft de berekende procentscore terug

  • Secundaire schemawaarde: geeft de cijferkolom terug Secundair display (geldt alleen voor Originele cursussen)

  • Scorewaarde: geeft de scorewaarde terug

Grade Center Alleen-lezen (Origineel)

De volgende opties gelden alleen voor de Originele cursuservaring. De opties voor de Ultra-cursuservaring worden behandeld in het volgende gedeelte.

Je kunt de cursus-cijfers vergrendelen en gebruikers die proberen cijfers te bereiken doorverwijzen naar een alleen-lezen pagina. Voor Vergrendelen op Goedkeuring kies je een van drie opties:

  • Direct na goedkeuring: sluit de cijfercentrum direct af nadat een cijfer voor die cursus door de goedkeurder is goedgekeurd

  • Na de einddatum van de cijferkolom vergrendel het cijfercentrum nadat de einddatum van de geselecteerde cijferkolom is bereikt

    Opmerking

    Als deze optie is geselecteerd, moet u Verbeterde Alleen-lezen functies inschakelen en de naam invoeren van de kolom van de bevoegdheidsgraad waarvan de einddatum wordt gebruikt om te bepalen wanneer het beoordelingscentrum wordt vergrendeld in het vakje Naam van de Cijferkolom vergrendelen.

  • Uitgeschakeld: sluit het cijfercentrum niet af.

Zet de schakelaar Verbeterde Alleen-lezen functies in om extra alleen-lezen-functies in te stellen voor Originele cursussen.

  • Paginatitel: voer een paginatitel in voor de alleen-lezen pagina

  • Naam van de Slotkolom Niveau: voer de naam in van de kolom waarvan de einddatum wordt gebruikt om te bepalen wanneer het beoordelingscentrum wordt afgesloten

  • Tijd om te vergrendelen: optioneel voer je een tijd in waarop de vergrendelingsklus moet worden uitgevoerd. Als er geen tijd wordt ingevoerd, loopt de klus om middernacht.

  • Tijd om handmatig ontgrendelde cursussen (Uren) te behouden: voer optioneel een waarde in voor hoe lang (in uren) een handmatig ontgrendelde cursus ontgrendeld moet blijven voordat deze automatisch weer wordt vergrendeld

  • Tijd om het cijfercentrum (uren) automatisch te vergrendelen: voer optioneel een waarde in voor hoe lang (in uren) het cijfercentrum moet worden afgesloten nadat het goedkeuringsproces van de beoordelingen heeft plaatsgevonden

  • Lock Approval Exception (Uren): vul optioneel een waarde in voor hoe lang (in uren) een rol met Keuringsrechten nog toegang heeft tot het beoordelingscentrum na het vergrendelingsevent

  • Lock Unapproval Exception (Uren): voer optioneel een waarde in voor hoe lang (in uren) een rol met Submitter-rechten nog toegang heeft tot het cijfercentrum na het vergrendelen, zelfs als er niet-goedgekeurde cijfers bestaan

  • Cursusrol niet beïnvloed door lock: selecteer cursusrollen(en) die niet worden doorgestuurd naar de read-only weergavepagina van het cijfercentrum en die nog steeds toegang krijgen tot de volledige pagina met Cijferoverdracht en Goedkeuring, zelfs als deze vergrendeld is

    Opmerking

    Systeembeheerder is de enige rol die altijd toegang heeft tot de volledige pagina Grade Transfer and Approval.

Grade Center Alleen-lezen (Ultra)

De volgende opties gelden alleen voor de Ultra-cursuservaring. De opties voor de Oorspronkelijke cursuservaring worden behandeld in de voorgaande sectie.

Je kunt de cursus-cijfers vergrendelen en gebruikers die proberen cijfers te bereiken doorverwijzen naar een alleen-lezen pagina. Voor Lock on Approval heb je de volgende opties:

  • Direct na goedkeuring: deze optie geldt niet voor de Ultra Read-Only weergave

  • Na de einddatum van de cijferkolom vergrendel het cijfercentrum nadat de einddatum van de geselecteerde cijferkolom is bereikt

    Opmerking

    Als deze optie is geselecteerd, moet u Verbeterde Alleen-lezen functies inschakelen en de naam invoeren van de kolom van de bevoegdheidsgraad waarvan de einddatum wordt gebruikt om te bepalen wanneer het beoordelingscentrum wordt vergrendeld in het vakje Naam van de Cijferkolom vergrendelen.

    Opmerking

    Je kunt de cursus tijdelijk ontgrendelen indien nodig nadat de vergrendelingsklus is voltooid.

  • Uitgeschakeld: sluit het cijfercentrum niet af.

Zet de schakelaar Enhanced Read-Only Features in om de Slot Grade Column Name in te stellen en tijd om de cursus voor Ultra-cursussen te vergrendelen.

  • Naam van de Slotkolom Niveau: voer de naam in van de kolom waarvan de einddatum wordt gebruikt om te bepalen wanneer het beoordelingscentrum wordt afgesloten

  • Tijd om te vergrendelen: optioneel voer je een tijd in waarop de vergrendelingsklus moet worden uitgevoerd. Als er geen tijd wordt ingevoerd, loopt de klus om middernacht.

Opmerking

Geen van de andere Enhanced Read-Only functies geldt voor Ultra Courses.

Kies één of meer plaatsen

Specificeer de LTI-plaatsingen die gebruikt zullen worden om de Grade Approval and Transfer tool van Original en Ultra-cursussen te gebruiken. De Instructor Tool en de Administrator Tool zijn verplichte plaatsingen. Selecteer Launch in New Window om de LTI in een apart venster te laten openen.

Selecteer Indienen om al je keuzes op te slaan.