educationAssignment-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt Aufgaben oder Arbeitseinheiten dar, die einem Lernenden oder Teammitglied in einem Kurs als Teil des Unterrichts zugewiesen werden.

Aufgaben enthalten Handzettel und Aufgaben, an denen der Kursleiter arbeiten soll. Jeder Schüleraufgabe ist eine Einreichung zugeordnet, die alle Arbeiten enthält, um deren Abgabe der Lehrer gebeten hat. Nur Lehrkräfte oder Teambesitzer können Aufgaben erstellen. Ein Lehrer kann der vom Schüler eingereichten Einreichung Bewertungen und Feedback hinzufügen.

Wenn eine Aufgabe erstellt wird, befindet sie sich im Status "Entwurf". Kursteilnehmer können die Aufgabe nicht sehen, und es werden keine Einreichungen erstellt. Sie können den Status einer Aufgabe mithilfe der Aktion "Veröffentlichen" ändern. Sie können keine PATCH-Anforderung verwenden, um den Status der Aufgabe zu ändern.

Die Zuweisungs-APIs werden im Klassennamespace verfügbar gemacht.

Erbt von entity.

Methoden

Methode Rückgabetyp Beschreibung
Create educationAssignment Erstellen Sie eine neue Aufgabe.
Get educationAssignment Lesen von Eigenschaften und Beziehungen eines educationAssignment-Objekts .
Update educationAssignment Aktualisieren eines educationAssignment-Objekts .
Löschen Keine Löschen Sie ein educationAssignment-Objekt .
Publish educationAssignment Ändern Sie den Status eines educationAssignment-Objekts von "Entwurf" in "Veröffentlicht".
Aufgabenressource erstellen educationAssignmentResource Erstellen Sie eine Aufgabenressource.
Zugeordnete Ressource abrufen educationAssignmentResource Abrufen der Eigenschaften einer Bildungszuweisungsressource , die einer Aufgabe zugeordnet ist.
Zuweisungsressource löschen Keine Löschen Sie eine bestimmte Ressource für Bildungsaufgaben, die mit einer Aufgabe verknüpft ist.
Einrichten des Ordners „Aufgabenressourcen“ string Erstellen Sie einen SharePoint-Ordner (unter einem vordefinierten Speicherort), um Dateien als Zuordnungsressourcen hochzuladen.
Einrichten des Ressourcenordners für Aufgabenfeedback educationAssignment Erstellen Sie einen SharePoint-Ordner, um Feedbackdateien für einen bestimmten educationSubmission hochzuladen.
Ressourcen auflisten educationAssignmentResource collection Rufen Sie eine educationAssignmentResource-Objektsammlung ab.
Übermittlungen auflisten educationSubmission collection Rufen Sie eine "educationSubmission" -Objektsammlung ab.
Kategorien auflisten educationCategory-Sammlung Abrufen einer "educationCategory"- Objektsammlung.
Kategorien hinzufügen educationCategory Weisen Sie dieser Aufgabe eine "educationCategory " zu, die zur Klasse gehört.
Kategorie entfernen Keine Entfernen Sie eine educationCategory , die zur Klasse gehört, aus dieser Aufgabe.
Rubrik anfügen Keine Fügen Sie dieser Aufgabe eine vorhandene "educationRubric" hinzu.
Rubrik entfernen Keine Trennen Sie die educationRubric von dieser Aufgabe.
Delta abrufen educationAssignment-Sammlung Rufen Sie eine Liste der neu erstellten oder aktualisierten Aufgaben ab, ohne die Sammlung vollständig lesen zu müssen.
Bewertungskategorie hinzufügen educationGradingCategory Fügen Sie gradingCategory hinzu, indem Sie in der gradingCategory-Sammlung posten .
Bewertungskategorie entfernen Keine Entfernen Sie ein educationGradingCategory-Objekt .
Aufgabe aktivieren educationAssignment Aktivieren Sie eine inaktive educationAssignment , um zu signalisieren, dass die Aufgabe weitere Aktionselemente für Lehrkräfte oder Kursteilnehmer enthält.
Aufgabe deaktivieren educationAssignment Markieren Sie eine zugewiesene educationAssignment als inaktiv, um zu signalisieren, dass die Aufgabe keine weiteren Aktionselemente für Lehrer und Schüler/Studenten enthält.
Benotungsschema hinzufügen educationGradingScheme Fügen Sie ein vorhandenes educationGradingScheme zu einer vorhandenen educationAssignment hinzu.

Eigenschaften

Eigenschaft Typ Beschreibung
addedStudentAction Zeichenfolge Optionales Feld zum Steuern des Aufgabenverhaltens für Kursteilnehmer, die nach der Veröffentlichung der Aufgabe hinzugefügt werden. Wenn nicht angegeben, wird standardmäßig .none Unterstützte Werte sind: none, assignIfOpen. Beispielsweise kann assignIfOpen ein Lehrer angeben, dass eine Aufgabe jedem neuen Kursteilnehmer zugewiesen werden soll, der dem Kurs beitritt, während die Aufgabe noch geöffnet ist, und none um anzugeben, dass eine Aufgabe neuen Kursteilnehmern nicht zugewiesen werden soll.
addToCalendarAction educationAddToCalendarOptions Optionales Feld zum Steuern des Aufgabenverhaltens beim Hinzufügen von Aufgaben zu den Kalendern von Kursteilnehmern und Lehrern, wenn die Aufgabe veröffentlicht wird. Die möglichen Werte sind: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValueund studentsOnly. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Elemente in dieser entwicklungsfähigen Aufzählung abzurufen: studentsOnly. Der Standardwert ist none.
allowLateSubmissions Boolean Gibt an, ob Kursteilnehmer nach dem Fälligkeitsdatum einreichen können. Wenn diese Eigenschaft beim Erstellen nicht angegeben wird, wird standardmäßig "true" verwendet.
allowStudentsToAddResourcesToSubmission Boolean Gibt an, ob die Schüler/Studierenden einer Einreichung ihre eigenen Ressourcen hinzufügen können oder ob sie nur vom Lehrer hinzugefügte Ressourcen ändern können.
assignDateTime DateTimeOffset Das Datum, an dem die Zuweisung aktiv werden soll. Wenn die Aufgabe dem Kursteilnehmer erst ab diesem Datum angezeigt wird. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
assignTo educationAssignmentRecipient Welche Benutzer oder der gesamte Kurs ein Abgabeobjekt erhalten sollen, sobald die Aufgabe veröffentlicht wurde.
assignedDateTime DateTimeOffset Der Moment, in dem die Aufgabe für die Kursteilnehmer veröffentlicht wurde und die Aufgabe auf der Zeitleiste der Kursteilnehmer angezeigt wird. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
classId Zeichenfolge Klasse, zu der diese Aufgabe gehört.
closeDateTime DateTimeOffset Datum, an dem die Aufgabe für die Einreichung geschlossen wird. Dies ist ein optionales Feld, das null sein kann, wenn die Zuweisung keine LateSubmissions zulässt oder wenn closeDateTime mit der dueDateTime übereinstimmt. Wenn jedoch angegeben, muss die closeDateTime größer oder gleich der dueDateTime sein. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
createdBy identitySet Wer die Aufgabe erstellt hat.
createdDateTime DateTimeOffset Moment, zu dem die Aufgabe erstellt wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
displayName Zeichenfolge Name der Zuweisung.
dueDateTime DateTimeOffset Datum, an dem die Aufgabe des Kursteilnehmers fällig ist. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
feedbackResourcesFolderUrl Zeichenfolge Ordner-URL, in der alle Ressourcen der Feedbackdatei für diese Aufgabe gespeichert sind.
Benotung educationAssignmentGradeType Wie die Aufgabe benotet wird.
id Zeichenfolge Der eindeutige Bezeichner für die Aufgabe. Geerbt von entity. Schreibgeschützt.
Anweisungen itemBody Anweisungen für die Aufgabe. Diese Eigenschaft und der Anzeigename sagen dem Schüler, was er tun soll.
languageTag Zeichenfolge Gibt die Sprache an, in der UI-Benachrichtigungen für die Zuweisung angezeigt werden. Wenn languageTag nicht angegeben wird, ist en-USdie Standardsprache . Optional.
lastModifiedBy identitySet Wer die Zuweisung zuletzt geändert hat.
lastModifiedDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Zuweisung geändert wurde. Die Einreichung eines Kursteilnehmers ändert die Aufgabe nicht. Nur Lehrkräfte können Aufgaben aktualisieren. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z
moduleUrl string Die URL des Moduls, von dem aus auf die Aufgabe zugegriffen werden soll.
notificationChannelUrl Zeichenfolge Optionales Feld zum Angeben der URL des Kanals , um die Benachrichtigung über die Veröffentlichung der Zuweisung zu senden. Wenn nicht angegeben oder NULL, wird standardmäßig der General Kanal verwendet. Dieses Feld gilt nur für Aufgaben , bei denen der Wert "assignTo " "educationAssignmentClassRecipient" lautet. Das Aktualisieren von notificationChannelUrl ist nach der Veröffentlichung der Zuweisung nicht zulässig.
resourcesFolderUrl string Ordner-URL, in der alle Dateiressourcen für diese Aufgabe gespeichert sind.
status Zeichenfolge Status der Aufgabe. Sie können diesen Wert nicht PATCHEN. Mögliche Werte sind: draft, scheduled, published, assigned, unknownFutureValue, inactive. Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Elemente in dieser entwicklungsfähigen Aufzählung abzurufen: inactive.
webUrl string Die Deep-Link-URL für die angegebene Aufgabe.

Beziehungen

Beziehung Typ Beschreibung
Ressourcen educationAssignmentResource collection Learning-Objekte, die dieser Aufgabe zugeordnet sind. Nur Lehrer können diese Liste ändern. Nullwerte zulassend.
Einreichungen educationSubmission collection Nach der Veröffentlichung gibt es für jeden Kursteilnehmer ein Abgabeobjekt , das seine Arbeit und Note darstellt. Schreibgeschützt. Nullwerte zulassend.
categories educationCategory-Sammlung Wenn diese Option festgelegt ist, können Benutzer Aufgaben eines bestimmten Typs leicht finden. Schreibgeschützt. Nullwerte zulassend.
Rubrik AusbildungRubrik Wenn festgelegt, wird die dieser Aufgabe zugeordnete Benotungsrubrik verwendet.
gradingCategory educationGradingCategory-Sammlung Wenn diese Option festgelegt ist, können Benutzer Aufgaben bei der Berechnung einer Klassendurchschnittsnote unterschiedlich gewichten.
gradingScheme educationGradingScheme Ermöglicht Benutzern bei Aktivierung benutzerdefinierte Zeichenfolgennoten basierend auf dem Prozentsatz der Gesamtpunktzahl, der bei dieser Aufgabe erzielt wurde.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "addedStudentAction": "String",
  "addToCalendarAction": "String",
  "allowLateSubmissions": "Boolean",
  "allowStudentsToAddResourcesToSubmission": "Boolean",
  "assignDateTime": "String (timestamp)",
  "assignedDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "feedbackResourcesFolderUrl": "String",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "id": "String (identifier)",
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "languageTag": "String",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",
  "webUrl": "String"
}
  • Zuletzt aktualisiert um