Aktualisieren von Aufgaben- und Bewertungsdaten

Artikel
03/26/2023

Bildungseinrichtungen verfügen über benutzerdefinierte Tools zum Aktualisieren von Aufgaben- und Bewertungsdaten. Beispielsweise muss ein Lehrer eine Aufgabe aktualisieren, bevor die Kursteilnehmer sie übermitteln, oder eine Änderung an einer Note (Ergebnis) mithilfe eines benutzerdefinierten Tools vornehmen.

Bevor Sie Daten aktualisieren können, müssen Sie die relevanten Klassen- und Memberinformationen abrufen.

Hinweis: Sie können Graph Explorer verwenden, um die in diesem Artikel erwähnten Education-APIs zu testen.

Abrufen von Klassen- und Memberinformationen

Alle Aufgaben und Bewertungsinformationen sind Teil des Teams in Microsoft Teams. Mithilfe der folgenden Teams-APIs können Sie Informationen zu Kursen, Mitgliedern und Rollen (Kursteilnehmer oder Lehrkraft) in einem Team abrufen:

Klassen einer educationSchools auflisten: Gibt eine Liste aller Kurse in Ihrem Education-Mandanten zurück.
Member einer educationClass auflisten: Listen Informationen zu Mitgliedern einer bestimmten Klasse.

Nachdem Sie die relevanten Kurs- und Mitgliedsinformationen erhalten haben, können Sie die aufgaben- und notenrelevanten Informationen abrufen, die Sie benötigen.

Zuordnungs- und Übermittlungsinformationen

Alle Aufgaben- und Kursteilnehmerinformationen sind mit Kurs- bzw. Übermittlungsinformationen verknüpft. Die folgenden APIs rufen Informationen zu Klassenzuweisungen und Übermittlungen ab:

educationAssignment-Ressourcentyp: Listen alle Methoden, die für Aufgaben in einer Klasse verfügbar sind. Ein Benutzer kann alle educationAssignmentResource-Objekte abrufen, die einer Zuweisung zugeordnet sind.
educationSubmission-Ressourcentyp: Ein submissionId wird für jeden Kursteilnehmer erstellt, für den eine Aufgabe veröffentlicht wird. Sie können diese API verwenden, um die Übermittlung status abzurufen, z. B. ob sie abgegeben und bewertet wurde, (Ressourcen), die vom Kursteilnehmer übermittelt wurden, und die Note (Ergebnis) für die Übermittlung.

Aktualisieren von Bewertungsdaten (Ergebnisdaten)

Benutzer können die Eigenschaften eines educationOutcome-Objekts aktualisieren. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei. Nur Lehrkräfte können diesen Vorgang ausführen.

Im folgenden Beispiel wird beschrieben, wie ein Punktergebnis aktualisiert wird.

Anforderung

Das folgende Beispiel zeigt die Antwort.

Hinweis: Der Anforderungstext sollte nur die Werte der Felder enthalten, die aktualisiert werden müssen.

PATCH https://graph.microsoft.com/v1.0/education/classes/acdefc6b-2dc6-4e71-b1e9-6d9810ab1793/assignments/cf6005fc-9e13-44a2-a6ac-a53322006454/submissions/d1bee293-d8bb-48d4-af3e-c8cb0e3c7fe7/outcomes/9c0f2850-ff8f-4fd6-b3ac-e23077b59141
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "points":{
        "@odata.type":"#microsoft.graph.educationAssignmentPointsGrade",
        "points":85.0
    }
}

Antwort

Das folgende Beispiel zeigt die Resposnse.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.educationPointsOutcome",
    "id":"ea1351f6-ba33-4940-b2cb-6a7254af2dc8",
    "lastModifiedBy":{
        "user":{
            "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
        }
    },
    "points":{
        "gradedDateTime":"2019-07-15T22:35:48.2429387Z",
        "points":85.0,
        "gradedBy":{
            "user":{
                "id":"9391878d-903c-406c-bb1c-0f17d00fd878"
            }
        }
    }
}

Diese Anforderung gibt ein aktualisiertes educationOutcome-Objekt im Antworttext zurück.

Berechtigungen

Delegierte Berechtigungen und Anwendungsberechtigungen sind erforderlich, um Daten in Zuweisungen zu aktualisieren. Anwendungsberechtigungen werden derzeit nur in der Betaversion unterstützt.

Hinweis: Da Informationen zu Kursteilnehmern und Noten vertrauliche Daten sind, sollten Sie überprüfen, welche Berechtigungen erforderlich sind.