educationAssignment-Ressourcentyp

Artikel
01/10/2024

Namespace: microsoft.graph

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 Kursteilnehmer arbeiten soll. Jeder Kursteilnehmeraufgabe ist eine Übermittlung zugeordnet, die alle Arbeiten enthält, um die der Lehrer gebeten hat, abgegeben zu werden. Nur Lehrkräfte oder Teambesitzer können Aufgaben erstellen. Ein Lehrer kann der vom Kursteilnehmer eingereichten Übermittlung Bewertungen und Feedback hinzufügen.

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

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

Erbt von entity.

Methoden

Methode	Rückgabetyp	Beschreibung
Aufgabenressource erstellen	educationAssignmentResource	Erstellen Sie eine neue educationAssignmentResource , indem Sie in der Ressourcensammlung veröffentlichen.
Aufgabe abrufen	educationAssignment	Lesen von Eigenschaften und Beziehungen eines educationAssignment-Objekts .
Update	educationAssignment	Aktualisieren eines educationAssignment-Objekts .
Delete	Keine	Löschen sie ein educationAssignment-Objekt .
Publish	educationAssignment	Ändern Sie den Status eines educationAssignment-Objekts von "draft" in "Published".
Einrichten des Ordners "Zuweisungsressourcen"	string	Erstellen Sie einen SharePoint-Ordner (unter vordefiniertem Speicherort), um Dateien als Zuweisungsressourcen hochzuladen.
Einrichten des Ressourcenordners für Zuweisungsfeedback	educationAssignment	Erstellen Sie einen SharePoint-Ordner, um Feedbackdateien für eine bestimmte educationSubmission hochzuladen.
Ressourcen auflisten	educationAssignmentResource-Sammlung	Rufen Sie eine educationAssignmentResource-Objektauflistung ab.
Auflisten von Übermittlungen	educationSubmission-Sammlung	Rufen Sie eine educationSubmission-Objektauflistung ab.
Kategorien auflisten	educationCategory-Sammlung	Rufen Sie eine educationCategory-Objektauflistung ab.
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-Instanz an.
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.
educationGradingCategory hinzufügen	educationGradingCategory	Fügen Sie der educationGradingCategory-Auflistung ein educationGradingCategory-Objekt hinzu.
entfernen EducationGradingCategory	Keine	Entfernen Sie ein educationGradingCategory-Objekt aus der educationGradingCategory-Auflistung .
Zuweisung aktivieren	educationAssignment	Aktivieren Sie educationAssignment`inactive`, um zu signalisieren, dass die Aufgabe weitere Aktionselemente für Lehrer oder Schüler enthält.
Zuweisung deaktivieren	educationAssignment	Markieren Sie educationAssignment`assigned` als , um `inactive` zu signalisieren, dass die Aufgabe keine weiteren Aktionselemente für Lehrer und Schüler enthält.

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 der Standardwert auf festgelegt `none`. Unterstützte Werte sind: `none`, `assignIfOpen`. Ein Lehrer kann beispielsweise verwenden `assignIfOpen` , um anzugeben, dass eine Aufgabe jedem neuen Kursteilnehmer zugewiesen werden soll, der dem Kurs beitritt, während die Aufgabe noch offen ist, und `none` um anzugeben, dass eine Aufgabe nicht neuen Schülern zugewiesen werden soll.
addToCalendarAction	educationAddToCalendarOptions	Optionales Feld zum Steuern des Zuordnungsverhaltens zum Hinzufügen von Aufgaben zu den Kalendern von Kursteilnehmern und Lehrkräften, wenn die Aufgabe veröffentlicht wird. Die möglichen Werte sind: `none`, `studentsAndPublisher`, `studentsAndTeamOwners`, `unknownFutureValue`und `studentsOnly`. Sie müssen den Anforderungsheader `Prefer: include-unknown-enum-members` verwenden, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: `studentsOnly`. Der Standardwert ist `none`.
allowLateSubmissions	Boolesch	Gibt an, ob Kursteilnehmer nach dem Fälligkeitsdatum einreichen können. Wenn diese Eigenschaft während der Erstellung nicht angegeben wird, wird sie standardmäßig auf true festgelegt.
allowStudentsToAddResourcesToSubmission	Boolesch	Gibt an, ob Kursteilnehmer eigene Ressourcen zu einer Übermittlung hinzufügen können oder ob sie nur ressourcen ändern können, die vom Lehrer hinzugefügt wurden.
assignDateTime	DateTimeOffset	Das Datum, an dem die Zuweisung aktiv werden soll. Wenn in der Zukunft, wird die Aufgabe dem Kursteilnehmer bis zu diesem Datum nicht angezeigt. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist `2014-01-01T00:00:00Z`
assignTo	educationAssignmentRecipient	Welche Benutzer oder die gesamte 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 den Kursteilnehmern Zeitleiste 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 Zuweisung gehört.
closeDateTime	DateTimeOffset	Datum, an dem die Zuweisung für Übermittlungen geschlossen wird. Dies ist ein optionales Feld, das NULL sein kann, wenn die Zuweisung keineLateSubmissions zulässt oder wenn closeDateTime mit dueDateTime übereinstimmt. Falls 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 Zuweisung erstellt hat.
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 Zuweisung.
dueDateTime	DateTimeOffset	Datum, an dem die Kursteilnehmeraufgabe 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 Feedbackdateiressourcen für diese Zuweisung gespeichert sind.
Verschneidungen	educationAssignmentGradeType	Wie die Aufgabe bewertet wird.
id	Zeichenfolge	Der eindeutige Bezeichner für die Zuweisung. Geerbt von entity. Schreibgeschützt.
Anweisungen	itemBody	Anweisungen für die Zuweisung. Die Anweisungen und der Anzeigename teilen dem Kursteilnehmer mit, was zu tun ist.
lastModifiedBy	identitySet	Wer die Zuweisung zuletzt geändert hat.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit, an dem die Zuordnung geändert wurde. Eine Kursteilnehmereinsendung ändert die Aufgabe nicht. nur Lehrer 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 Zuweisung zugegriffen werden soll.
notificationChannelUrl	Zeichenfolge	Optionales Feld, um die URL des Kanals anzugeben, der die Veröffentlichungsbenachrichtigung für die Zuweisung posten soll. Wenn nicht angegeben oder NULL, wird standardmäßig der `General` Kanal verwendet. Dieses Feld gilt nur für Zuordnungen , bei denen der assignTo-WerteducationAssignmentClassRecipient ist. 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 Zuweisung gespeichert sind.
status	educationAssignmentStatus	Status der Zuweisung. Sie können diesen Wert nicht patchen. Mögliche Werte sind: `draft`, `scheduled`, `published`, `assigned`, `unknownFutureValue` und `inactive`. Beachten Sie, dass Sie den `Prefer: include-unknown-enum-members` Anforderungsheader verwenden müssen, um die folgenden Werte in dieser verteilbaren Enumeration abzurufen: `inactive`.
webUrl	string	Die DeepLink-URL für die angegebene Zuweisung.

Beziehungen

Beziehung	Typ	Beschreibung
categories	educationCategory-Sammlung	Wenn diese Einstellung festgelegt ist, können Benutzer problemlos Zuweisungen eines bestimmten Typs finden. Schreibgeschützt. Lässt Nullwerte zu.
Ressourcen	educationAssignmentResource-Sammlung	Lernobjekte, die dieser Aufgabe zugeordnet sind. Nur Lehrkräfte können diese Liste ändern. Nullwerte zulassend.
Rubrik	educationRubric	Wenn diese Einstellung festgelegt ist, wird die Dieser Aufgabe zugeordnete Rubrik für die Bewertung verwendet.
Einreichungen	educationSubmission-Sammlung	Nach der Veröffentlichung gibt es ein Übermittlungsobjekt für jeden Kursteilnehmer, der seine Arbeit und Note darstellt. Schreibgeschützt. Nullwerte zulassend.
gradingCategory	educationGradingCategory-Sammlung	Wenn diese Einstellung festgelegt ist, können Benutzer Zuweisungen beim Berechnen eines Klassendurchschnitts unterschiedlich gewichten.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "addedStudentAction": "String",
  "addToCalendarAction": "String",  
  "allowLateSubmissions": "Boolean",
  "allowStudentsToAddResourcesToSubmission": "Boolean",
  "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)",
  "feedbackResourcesFolderUrl": "String",
  "grading": {"@odata.type": "microsoft.graph.educationAssignmentGradeType"},
  "id": "String (identifier)",
  "instructions": {"@odata.type": "microsoft.graph.itemBody"},
  "lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
  "lastModifiedDateTime": "String (timestamp)",
  "moduleUrl": "String",
  "notificationChannelUrl": "String",
  "resourcesFolderUrl": "String",
  "status": "String",  
  "webUrl": "String"
}