approvalItem 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示审批请求,包括关联的决策、状态和响应。 用户可以创建新的审批项目、查看已发送或接收的审批项目,以及对审批项目执行操作。

方法

方法 返回类型 Description
List approvalItem 集合 获取 approvalItem 对象及其属性的列表。
创建 approvalItem 创建新的 approvalItem 对象。
Get approvalItem 读取 approvalItem 对象的属性和关系。
Cancel None 取消审批项目。 审批的所有者可以触发此终结点。
列出请求 approvalItemRequest 集合 获取 approvalItem 的 approvalItemRequest 集合。
列出响应 approvalItemResponse 集合 获取 approvalItem 的 approvalItemResponse 集合。
创建响应 approvalItemResponse 创建新的 approvalItemResponse 对象。

属性

属性 类型 说明
allowCancel 布尔值 指示是否可以取消审批项目。
allowEmailNotification 布尔值 指示是否启用电子邮件通知。
approvalType approvalItemType 审批项的工作流类型。 可能的值包括 basicbasicAwaitAllcustomcustomAwaitAll。 必填。
审批者 approvalIdentitySet 集合 最初向其分配审批项的主体的标识。 必填。
completedDateTime DateTimeOffset 审批请求完成日期和时间。 只读。
createdDateTime DateTimeOffset 审批请求的创建日期和时间。 只读。
description String 审批请求的说明。
displayName String 审批请求的 displayName。 必需。
id String 审批项的唯一 ID。 只读。
owner approvalIdentitySet 拥有审批项的主体的标识集。 仅在代表主体创建审批项时为此属性提供值。 如果未提供所有者字段,则使用用户上下文中的用户信息。
responsePrompts 字符串集合 审批响应提示。 仅在创建自定义审批项目时为此属性提供值。 对于自定义审批项,请提供两个响应提示字符串。 默认响应提示为“批准”和“拒绝”。
result String 仅当审批项处于最终状态时,才会填充结果字段。 审批项的结果基于 approvalType。 对于基本审批项目,结果为“已批准”或“已拒绝”。 对于自定义审批项,结果可以是单个响应,也可以是用分号分隔的多个响应。 只读。
state approvalItemState 审批项状态。 可能的值包括 canceledcreatedpendingcompleted。 只读。
观点 approvalItemViewPoint 表示 ApprovalItem 上的用户视点数据。 数据包括有关审批项的用户角色。 只读。

关系

关系 类型 说明
请求 approvalItemRequest 集合 针对审批项的每个审批者创建的请求集合。
反应 approvalItemResponse 集合 为审批项创建的响应的集合。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.approvalItem",
  "id": "String (identifier)",
  "displayName": "String",
  "description": "String",
  "allowEmailNotification": "Boolean",
  "approvalType": "String",
  "responsePrompts": [
    "String"
  ],
  "approvers": [
    {
      "@odata.type": "microsoft.graph.approvalIdentitySet"
    }
  ],
  "state": "String",
  "allowCancel": "Boolean",
  "createdDateTime": "String (timestamp)",
  "completedDateTime": "String (timestamp)",
  "viewPoint": {
    "@odata.type": "microsoft.graph.approvalItemViewPoint"
  },
  "owner": {
    "@odata.type": "microsoft.graph.approvalIdentitySet"
  },
  "result": "String"
}