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"
}