| title | workbookDocumentTask resource type |
|---|---|
| description | Represents a document task in a workbook. |
| author | VictorZheng-qizheng |
| ms.localizationpriority | medium |
| ms.subservice | excel |
| doc_type | resourcePageType |
| toc.title | Document task |
| ms.date | 07/22/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Represents a document task in a workbook. A workbookDocumentTask is associated with a comment.
Inherits from entity.
| Method | Return type | Description |
|---|---|---|
| List workbookDocumentTasks | workbookDocumentTask collection | Get a list of workbookDocumentTask objects. |
| Get workbookDocumentTask | workbookDocumentTask | Get the properties and relationships of a workbookDocumentTask object. |
| List workbookDocumentTaskChanges | workbookDocumentTaskChange collection | Get a list of workbookDocumentTaskChange objects. |
| Property | Type | Description |
|---|---|---|
| assignees | workbookEmailIdentity collection | A collection of user identities the task is assigned to. |
| completedBy | workbookEmailIdentity | The identity of the user who completed the task. Nullable. |
| completedDateTime | DateTimeOffset | Date and time when the task was completed. Nullable. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| createdBy | workbookEmailIdentity | A user identity that creates the task. Nullable. |
| createdDateTime | DateTimeOffset | Date and time when the task was created. Nullable. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. |
| id | String | The unique identifier for the task. Inherited from entity. |
| percentComplete | Int32 | An integer value from 0 to 100 that represents the percentage of the completion of the task. 100 means that the task is completed. Nullable. |
| priority | Int32 | An integer value from 0 to 10 that represents the priority of the task. A lower value indicates a higher priority. Nullable. |
| startAndDueDateTime | workbookDocumentTaskSchedule | Start and due date of the task. Nullable. |
| title | String | The title of the task. |
| Relationship | Type | Description |
|---|---|---|
| changes | workbookDocumentTaskChange collection | A collection of task change histories. |
| comment | workbookComment | The comment that the task is associated with. |
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.workbookDocumentTask",
"assignees": [{"@odata.type": "microsoft.graph.workbookEmailIdentity"}],
"completedBy": {"@odata.type": "microsoft.graph.workbookEmailIdentity"},
"completedDateTime": "String (timestamp)",
"createdBy": {"@odata.type": "microsoft.graph.workbookEmailIdentity"},
"createdDateTime": "String (timestamp)",
"id": "String (identifier)",
"percentComplete": "Int32",
"priority": "Int32",
"startAndDueDateTime": {"@odata.type": "microsoft.graph.workbookDocumentTaskSchedule"},
"title": "String"
}