Тип ресурса approvalItem
Пространство имен: microsoft.graph
Важно!
API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Представляет запрос на утверждение, включая связанные решения, состояние и ответы. Пользователи могут создавать новые элементы утверждения, просматривать отправленные или полученные элементы утверждения, а также выполнять действия с элементами утверждения.
Методы
| Метод | Тип возвращаемых данных | Описание |
|---|---|---|
| Список | Коллекция approvalItem | Получите список объектов approvalItem и их свойств. |
| Создание | ApprovalItem | Создайте объект approvalItem . |
| Получение | ApprovalItem | Чтение свойств и связей объекта approvalItem . |
| Отмена | Нет | Отмена элемента утверждения. Владелец утверждения может активировать эту конечную точку. |
| Перечисление запросов | Коллекция approvalItemRequest | Получите коллекцию approvalItemRequest для объекта approvalItem. |
| Вывод списка ответов | Коллекция approvalItemResponse | Получите коллекцию approvalItemResponse для объекта approvalItem. |
| Создание ответа | approvalItemResponse | Создайте объект approvalItemResponse . |
Свойства
| Свойство | Тип | Описание |
|---|---|---|
| allowCancel | Логический | Указывает, можно ли отменить элемент утверждения. |
| allowEmailNotification | Логический | Указывает, включено ли уведомление по электронной почте. |
| approvalType | approvalItemType | Тип рабочего процесса элемента утверждения. Допустимые значения: basic, basicAwaitAll, custom, customAwaitAll. Обязательно. |
| Утверждающих | Коллекция approvalIdentitySet | Удостоверение субъектов, которым изначально был назначен элемент утверждения. Обязательно. |
| completedDateTime | DateTimeOffset | Дата и время завершения запроса на утверждение. Только для чтения. |
| createdDateTime | DateTimeOffset | Дата и время создания запроса на утверждение. Только для чтения. |
| description | String | Описание запроса на утверждение. |
| displayName | String | DisplayName запроса на утверждение. Обязательный. |
| id | String | Уникальный идентификатор элемента утверждения. Только для чтения. |
| owner | approvalIdentitySet | Набор удостоверений субъекта, которому принадлежит элемент утверждения. Укажите значение этого свойства только при создании элемента утверждения от имени субъекта. Если поле владельца не указано, используются сведения о пользователе из контекста пользователя. |
| responsePrompts | Коллекция строк | Ответные запросы на утверждение. Укажите значение этого свойства только при создании пользовательского элемента утверждения. Для пользовательских элементов утверждения укажите две строки запроса на ответ. Ответные запросы по умолчанию: "Утвердить" и "Отклонить". |
| result | String | Поле результата заполняется только после того, как элемент утверждения находится в окончательном состоянии. Результат элемента утверждения основан на типе утверждения. Для основных элементов утверждения результатом является "Утверждено" или "Отклонено". Для пользовательских элементов утверждения результатом может быть один ответ или несколько ответов, разделенных точкой с запятой. Только для чтения. |
| 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"
}