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 | 审批项的工作流类型。 可能的值包括 basic 、basicAwaitAll 、custom 、customAwaitAll 。 必填。 |
审批者 | approvalIdentitySet 集合 | 最初向其分配审批项的主体的标识。 必填。 |
completedDateTime | DateTimeOffset | 审批请求完成日期和时间。 只读。 |
createdDateTime | DateTimeOffset | 审批请求的创建日期和时间。 只读。 |
description | String | 审批请求的说明。 |
displayName | String | 审批请求的 displayName。 必需。 |
id | String | 审批项的唯一 ID。 只读。 |
owner | approvalIdentitySet | 拥有审批项的主体的标识集。 仅在代表主体创建审批项时为此属性提供值。 如果未提供所有者字段,则使用用户上下文中的用户信息。 |
responsePrompts | 字符串集合 | 审批响应提示。 仅在创建自定义审批项目时为此属性提供值。 对于自定义审批项,请提供两个响应提示字符串。 默认响应提示为“批准”和“拒绝”。 |
result | String | 仅当审批项处于最终状态时,才会填充结果字段。 审批项的结果基于 approvalType。 对于基本审批项目,结果为“已批准”或“已拒绝”。 对于自定义审批项,结果可以是单个响应,也可以是用分号分隔的多个响应。 只读。 |
state | approvalItemState | 审批项状态。 可能的值包括 canceled 、created 、pending 、completed 。 只读。 |
观点 | 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"
}