businessScenarioTask 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示与 businessScenario 关联的 plannerTask，并包含其他方案数据。
继承自 plannerTask。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | businessScenarioTask 集合 | 获取 businessScenarioTask 对象及其属性的列表。 |
| 创建 | businessScenarioTask | 创建新的 businessScenarioTask 对象。 |
| Get | businessScenarioTask | 读取 businessScenarioTask 对象的属性和关系。 |
| 更新 | businessScenarioTask | 更新 businessScenarioTask 对象的属性。 |
| 删除 | None | 删除 businessScenarioTask 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| activeChecklistItemCount | Int32 | 核对清单项的数量，其值设置为 false，表示项目不全。 继承自 plannerTask。 |
| appliedCategories | plannerAppliedCategories | 任务已应用到的类别。 有关可能的值，请参阅 plannerAppliedCategories。 继承自 plannerTask。 |
| assigneePriority | String | 用于在列表视图中对此类项进行排序的提示。 有关支持的格式的详细信息，请参阅 在 Planner 中使用订单提示。 继承自 plannerTask。 |
| assignments | plannerAssignments | 被分配任务的接受者集合。 继承自 plannerTask。 |
| bucketId | String | 此任务所属的存储桶 ID。 继承自 plannerTask。 |
| businessScenarioProperties | businessScenarioProperties | 任务的特定于方案的属性。 创建任务时必须指定 externalObjectId 和 externalBucketId 属性。 |
| checklistItemCount | Int32 | 任务上存在的核对清单项的数目。 继承自 plannerTask。 |
| completedBy | identitySet | 完成任务的用户的标识。 继承自 plannerTask。 只读。 |
| completedDateTime | DateTimeOffset | 任务的 percentComplete 设置为 100的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 plannerTask。 此为只读属性。 |
| conversationThreadId | 字符串 | 任务上的会话的线程 ID。 此属性包含组中创建的会话线程对象的 ID。 继承自 plannerTask。 |
| createdBy | identitySet | 创建任务的用户的标识。 继承自 plannerTask。 只读。 |
| createdDateTime | DateTimeOffset | 创建任务的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 继承 2014-01-01T00:00:00Z 自 plannerTask。 此为只读属性。 |
| creationSource | plannerTaskCreation | 包含有关任务源的信息。 继承自 plannerTask。 |
| dueDateTime | DateTimeOffset | 任务截止的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 plannerTask。 |
| hasDescription | Boolean |
True 指示任务的详细信息对象具有非空说明;否则为 false。 继承自 plannerTask。 只读。 |
| id | String | 任务的唯一标识符。 继承自 entity。 此为只读属性。 |
| orderHint | String | 用于在列表视图中对此类项进行排序的提示。 有关支持的格式的详细信息，请参阅 在 Planner 中使用订单提示。 继承自 plannerTask。 |
| percentComplete | Int32 | 任务完成百分比。
100设置为 时，任务被视为已完成。 继承自 plannerTask。 |
| planId | String | 任务所属的计划标识符。 继承自 plannerTask。 |
| previewType | plannerPreviewType | 这将设置显示在任务上的预览类型。 可取值为：automatic、noPreview、checklist、description、reference。 继承自 plannerTask。 |
| priority | Int32 | 任务优先级。 值的有效范围介于 0 和 10 (包含) 之间，递增值 (0 优先级最高且 10 优先级) 最低。 目前，Planner 将 值 0 和 1 解释为“紧急”、 2、 3和 4 作为“重要”、 5、 6和 7 “medium”，以及 8、 9和 10 “low”。 目前，Planner 将值 1 设置为“urgent”、“ 3 important”、“ 5 medium”和 9 “low”。 继承自 plannerTask。 |
| referenceCount | Int32 | 任务上存在的外部引用的数量。 继承自 plannerTask。 |
| startDateTime | DateTimeOffset | 任务开始的日期和时间。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息，始终采用 UTC 时区。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 继承自 plannerTask。 |
| target | businessScenarioTaskTargetBase | 指定应放置任务的位置的任务的目标。 必须在创建任务时指定。 |
| title | String | 任务的标题。 继承自 plannerTask。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| assignedToTaskBoardFormat | plannerAssignedToTaskBoardTaskFormat | 用于在按 assignedTo 分组时在任务板视图中正确呈现任务。 继承自 plannerTask。 |
| bucketTaskBoardFormat | plannerBucketTaskBoardTaskFormat | 用于在按 存储桶分组时在任务板视图中正确呈现任务。 继承自 plannerTask。 |
| 详细信息 | plannerTaskDetails | 有关任务的其他详细信息。 继承自 plannerTask。 |
| progressTaskBoardFormat | plannerProgressTaskBoardTaskFormat | 用于在按 进度分组时在任务板视图中正确呈现任务。 继承自 plannerTask。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.businessScenarioTask",
"activeChecklistItemCount": "Int32",
"appliedCategories": {"@odata.type": "microsoft.graph.plannerAppliedCategories"},
"assigneePriority": "String",
"assignments": {"@odata.type": "microsoft.graph.plannerAssignments"},
"bucketId": "String",
"businessScenarioProperties": {"@odata.type": "microsoft.graph.businessScenarioProperties"},
"checklistItemCount": "Int32",
"completedBy": {"@odata.type": "microsoft.graph.identitySet"},
"completedDateTime": "String (timestamp)",
"conversationThreadId": "String",
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"creationSource": {"@odata.type": "microsoft.graph.plannerTaskCreation"},
"dueDateTime": "String (timestamp)",
"hasDescription": "Boolean",
"id": "String (identifier)",
"orderHint": "String",
"percentComplete": "Int32",
"planId": "String",
"previewType": "String",
"priority": "Int32",
"referenceCount": "Int32",
"startDateTime": "String (timestamp)",
"target": {"@odata.type": "microsoft.graph.businessScenarioTaskTargetBase"},
"title": "String"
}