Teilen über


educationAssignment-Ressourcentyp

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 den Status einer Zuweisung mithilfe der Veröffentlichungsaktion ändern. Sie können eine PATCH-Anforderung nicht verwenden, um den Zuweisungsstatus 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" Zeichenfolge 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 educationAssignmentinactive, um zu signalisieren, dass die Aufgabe weitere Aktionselemente für Lehrer oder Schüler enthält.
Zuweisung deaktivieren educationAssignment Markieren Sie educationAssignmentassigned 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, unknownFutureValueund 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 der Zeitachse 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 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.
Einstufung 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 Zeichenfolge 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 Zeichenfolge 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.
Unterwerfungen 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"
}