educationAssignment-Ressourcentyp

Namespace: microsoft.graph

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

Nur Lehrer oder Teambesitzer können Aufgaben erstellen. Aufgaben enthalten Handzettel und Aufgaben, an denen der Kursteilnehmer arbeiten soll. Jeder Kursteilnehmerzuweisung ist eine Übermittlung zugeordnet, die jede Arbeit enthält, die ihr Lehrer angefordert hat, um abgegeben zu werden. Ein Lehrer kann der vom Kursteilnehmer abgegebenen Übermittlung Punkte und Feedback hinzufügen.

Wenn eine Aufgabe erstellt wird, befindet sie sich im Entwurfszustand. Kursteilnehmer können die Aufgabe nicht sehen, und Übermittlungen werden nicht erstellt. Sie können den Status einer Zuweisung mithilfe der Veröffentlichungsaktion ändern. Sie können eine PATCH-Anforderung nicht verwenden, um den Zuordnungsstatus zu ändern.

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

Methoden

Methode	Rückgabetyp	Beschreibung
Aufgabenressource erstellen	educationAssignmentResource	Erstellen Sie eine neue educationAssignmentResource durch Veröffentlichen in der Ressourcensammlung.
Aufgabe abrufen	educationAssignment	Lesen von Eigenschaften und Beziehungen eines educationAssignment-Objekts .
Update	educationAssignment	Dient zum Aktualisieren eines educationAssignment-Objekts .
Delete	Keine	Dient zum Löschen eines educationAssignment-Objekts .
Publish	educationAssignment	Ändern Sie den Status eines educationAssignment-Objekts von Entwurf in veröffentlicht.
Einrichten des Ordners "Zuordnungsressourcen"	string	Erstellen Sie einen SharePoint Ordner (unter einem vordefinierten Speicherort), um Dateien als Zuordnungsressourcen hochzuladen.
Ressourcen auflisten	educationAssignmentResource-Sammlung	Dient zum Abrufen einer educationAssignmentResource-Objektsammlung .
Übermittlungen auflisten	educationSubmission-Sammlung	Dient zum Abrufen einer educationSubmission-Objektsammlung .
Kategorien auflisten	educationCategory-Sammlung	Dient zum 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-Datei hinzu.
Rubrik entfernen	Keine	Trennen Sie educationRubric von dieser Aufgabe.
Delta abrufen	educationAssignment-Sammlung	Rufen Sie eine Liste der neu erstellten oder aktualisierten educationAssignment-Objekte ab, ohne die Auflistung vollständig lesen zu müssen.Get a list of newly created or updated educationAssignment objects without having to perform a full read of the collection.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Schreibgeschützt.
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 der Wert standardmäßig verwendet none . Derzeit werden nur zwei Werte unterstützt: none oder assignIfOpen.
addToCalendarAction	educationAddToCalendarOptions	Optionales Feld zum Steuern des Aufgabenverhaltens zum Hinzufügen von Aufgaben zu den Kalendern von Kursteilnehmern und Lehrern, wenn die Aufgabe veröffentlicht wird. Die folgenden Werte sind möglich: none, studentsAndPublisher, studentsAndTeamOwners, unknownFutureValueund studentsOnly. Beachten Sie, dass Sie den Prefer: include-unknown-enum-members Anforderungsheader verwenden müssen, um die folgenden Werte in dieser evolvablen Enumeration 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, ist sie standardmäßig auf "true" festgelegt.
allowStudentsToAddResourcesToSubmission	Boolesch	Gibt an, ob Kursteilnehmer einer Übermittlung eigene Ressourcen hinzufügen können oder ob sie nur vom Lehrer hinzugefügte Ressourcen ändern können.
assignDateTime	DateTimeOffset	Das Datum, an dem die Aufgabe aktiv werden soll. Wenn die Aufgabe in Zukunft dem Kursteilnehmer erst an diesem Datum angezeigt wird. Der Timestamp-Typ 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 ganze Klasse ein Übermittlungsobjekt erhalten sollen, nachdem die Zuweisung veröffentlicht wurde.
assignedDateTime	DateTimeOffset	Der Moment, in dem die Aufgabe für Kursteilnehmer veröffentlicht wurde und die Aufgabe auf der Kursteilnehmerzeitachse 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 Übermittlungen geschlossen wird. Dies ist ein optionales Feld, das null sein kann, wenn die Zuordnung keineLateSubmissions zulässt oder wenn "closeDateTime" mit "dueDateTime" identisch ist. Wenn jedoch angegeben, muss "closeDateTime" größer oder gleich "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 Zuordnung erstellt.
createdDateTime	DateTimeOffset	Moment, in 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 Zuordnung.
dueDateTime	DateTimeOffset	Datum, an dem die Aufgabe der Kursteilnehmer 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
Verschneidungen	educationAssignmentGradeType	Wie die Aufgabe benotet wird.
Anweisungen	itemBody	Anweisungen für die Zuordnung. Dies zusammen mit dem Anzeigenamen teilt dem Kursteilnehmer mit, was zu tun ist.
lastModifiedBy	identitySet	Wer die Zuordnung zuletzt geändert.
lastModifiedDateTime	DateTimeOffset	Moment, in dem die Zuordnung zuletzt geändert 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
notificationChannelUrl	Zeichenfolge	Optionales Feld zum Angeben der URL des Kanals zum Veröffentlichen der Benachrichtigung über die Zuordnung . Wenn nicht angegeben oder null, standardmäßig auf den General Kanal. Dieses Feld gilt nur für Zuordnungen , bei denen der assignTo-Wert educationAssignmentClassRecipient ist. Das Aktualisieren des notificationChannelUrl-Objekts ist nach der Veröffentlichung der Zuweisung nicht zulässig.
status	Zeichenfolge	Status der Zuordnung. Sie können diesen Wert nicht PATCHen. Mögliche Werte: draft, scheduled, published, assigned
webUrl	string	Die Deep-Link-URL für die angegebene Aufgabe.
resourcesFolderUrl	string	Ordner-URL, unter der alle Dateiressourcen für diese Zuordnung gespeichert sind.

Beziehungen

Beziehung	Typ	Beschreibung
Ressourcen	educationAssignmentResource-Sammlung	Learning Objekte, die dieser Zuordnung zugeordnet sind. Nur Lehrer können diese Liste ändern. Lässt NULL-Werte zu.
Einreichungen	educationSubmission-Sammlung	Nach der Veröffentlichung gibt es ein Übermittlungsobjekt für jeden Kursteilnehmer, der seine Arbeit und Benotung darstellt. Schreibgeschützt. Lässt NULL-Werte zu.
categories	educationCategory-Sammlung	Wenn diese Option festgelegt ist, können Benutzer aufgaben eines bestimmten Typs problemlos finden. Schreibgeschützt. Lässt NULL-Werte zu.
Rubrik	educationRubric	Wenn diese Einstellung festgelegt ist, wird die dieser Aufgabe zugeordnete Benotungsrubrik verwendet.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "String (identifier)",
  "addedStudentAction": "none",
  "addToCalendarAction": "string",  
  "allowLateSubmissions": true,
  "allowStudentsToAddResourcesToSubmission": true,
  "assignDateTime": "String (timestamp)",
  "assignTo": {"@odata.type": "microsoft.graph.educationAssignmentRecipient"},
  "assignedDateTime": "String (timestamp)",
  "classId": "String",
  "closeDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.identitySet"},
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "dueDateTime": "String (timestamp)",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "notificationChannelUrl": "string",
  "status": "string",
  "webUrl": "string",
  "resourcesFolderUrl": "string"
}