Struttura delle griglie e limitazioni note

Se non hai dimestichezza con le rubriche di Classroom, consulta questi articoli del Centro assistenza per scoprire la struttura generale di una rubrica e come viene eseguita la valutazione con le rubriche nell'interfaccia utente di Classroom.

Struttura delle rubriche

Quando utilizzi l'API per interagire con le rubriche, è importante tenere presente alcuni concetti:

  • A un CourseWork è associata (al massimo) una singola scheda, che è univoca per quel CourseWork (non è condivisibile tra le risorse CourseWork).
  • La griglia è composta da criteri, che comprendono livelli. Una rubrica deve sempre avere almeno un criterio e un criterio deve sempre avere almeno un livello.
  • I livelli possono essere con punteggio (con punti) o senza punteggio (senza punti). I livelli devono essere completamente valutati o completamente non valutati in una rubrica.
    • Se ai livelli viene assegnato un punteggio, tutti i livelli di un criterio devono avere un unico valore in punti impostato. I punti possono essere numeri interi (come 10) o valori in virgola mobile (come 9,99). Può essere incluso 0. I valori null non sono accettati. Inoltre, una griglia non può avere un singolo criterio con un singolo livello pari a 0 punti.
    • Se i livelli non sono valutati, il campo punti deve essere omesso. I valori null non sono accettati.
  • L'ordine dei criteri e dei livelli è significativo e riflette l'ordine in cui sono rappresentati nell'UI di Classroom.
    • In particolare, i livelli con punteggio devono sempre essere ordinati in base ai punti in ordine crescente o decrescente.
  • Possono essere presenti fino a 50 criteri per griglia e fino a 10 livelli di rendimento per criterio.

Anche gli oggetti Invio dello studente subiranno delle modifiche:

  • Oltre alle proprietà draftGrade e assignedGrade esistenti, un invio di uno studente valutato con una griglia ha le proprietà draftRubricGrades e assignedRubricGrades. Questi rappresentano i voti della griglia (livelli selezionati e valori in punti) che lo studente riceve durante la valutazione della griglia, rispettivamente negli stati bozza e assegnato.
  • Al momento, queste proprietà sono di sola lettura. Ciò significa che l'API non può essere utilizzata per valutare i contenuti inviati, ma puoi leggere i contenuti valutati nell'interfaccia utente di Classroom.
  • I compiti inviati dagli studenti con una griglia associata contengono un campo rubricId. Questo campo rappresenta la rubrica più recente associata al CourseWork e questo valore potrebbe cambiare se gli insegnanti eliminano e ricreano una rubrica.

Comportamenti delle griglie

L'API mira a eseguire il mirroring dell'interfaccia utente di Classroom ogni volta che è possibile per garantire la coerenza, ma ciò può portare a comportamenti non intuitivi per gli sviluppatori e vale la pena menzionare:

  • Le rubriche hanno lo scopo di guidare la valutazione senza vincolare gli insegnanti. Di conseguenza, un insegnante può fare quanto segue quando valuta un compito con una rubrica:
    • Ignorare completamente la griglia di valutazione durante la valutazione.
    • Sostituisci i punti per un criterio, indipendentemente dai punti disponibili nei livelli del criterio.
    • Seleziona i livelli solo per un sottoinsieme di criteri.
    • Assegna punti per un criterio senza selezionare un livello corrispondente.
    • Sostituisci i punti totali del compito, indipendentemente dai punti ricavati dalla griglia.

Inoltre, l'API non introduce nuove funzionalità del prodotto. In altre parole, l'API non supporta un comportamento che invece la UI di Classroom non ha già. Ad esempio, l'API non consente l'applicazione dell'utilizzo delle griglie sui compiti né di sostituire la capacità di un insegnante di modificare le griglie e i contenuti inviati oggi.

Limitazioni durante la valutazione

Analogamente, esistono alcune limitazioni aggiuntive alla modifica delle griglie una volta che un professore ha iniziato a utilizzarle per assegnare i voti. Dopo aver iniziato a valutare, sono possibili solo le seguenti modifiche:

  • Le modifiche al testo sono consentite per i titoli e le descrizioni dei criteri e dei livelli.
  • L'ordinamento dei livelli può cambiare all'interno dei criteri.

Ambiti aggiuntivi

Le rubriche possono essere esportate manualmente in Fogli Google per essere riutilizzate dagli insegnanti.

Se crei o aggiorni una griglia da questi fogli di lavoro (vedi un esempio nella guida), la tua applicazione deve richiedere l'ambito https://www.googleapis.com/auth/spreadsheets.readonly o https://www.googleapis.com/auth/spreadsheets. Tieni presente che gli ambiti spreadsheets sono considerati sensibili e potrebbero richiedere la verifica dell'applicazione.

Indietro
Periodi di valutazione