tipo de recurso approvalItem
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa um pedido de aprovação, incluindo as decisões, o estado e as respostas associados. Os utilizadores podem criar novos itens de aprovação, ver itens de aprovação que são enviados ou recebidos e tomar medidas em itens de aprovação.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | coleção approvalItem | Obtenha uma lista dos objetos approvalItem e respetivas propriedades. |
| Create | approvalItem | Crie um novo objeto approvalItem . |
| Get | approvalItem | Leia as propriedades e relações de um objeto approvalItem . |
| Cancel | Nenhum | Cancele o item de aprovação. O proprietário da aprovação pode acionar este ponto final. |
| Listar pedidos | coleção approvalItemRequest | Obtenha a coleção de approvalItemRequest para o approvalItem. |
| Listar respostas | coleção approvalItemResponse | Obtenha a coleção de approvalItemResponse para o approvalItem. |
| Criar resposta | approvalItemResponse | Crie um novo objeto approvalItemResponse . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowCancel | Booliano | Indica se o item de aprovação pode ser cancelado. |
| allowEmailNotification | Booliano | Indica se a notificação por e-mail está ativada. |
| approvalType | approvalItemType | O tipo de fluxo de trabalho do item de aprovação. Os valores possíveis são: basic, basicAwaitAll, custom, customAwaitAll. Obrigatório. |
| aprovadores | approvalIdentitySet collection (coleção approvalIdentitySet ) | A identidade dos principais a quem o item de aprovação foi inicialmente atribuído. Obrigatório. |
| completedDateTime | DateTimeOffset | Data e hora de conclusão do pedido de aprovação. Somente leitura. |
| createdDateTime | DateTimeOffset | Data e hora de criação do pedido de aprovação. Somente leitura. |
| description | Cadeia de caracteres | A descrição do pedido de aprovação. |
| displayName | Cadeia de caracteres | O displayName do pedido de aprovação. Obrigatório. |
| id | Cadeia de caracteres | O ID exclusivo do item de aprovação. Somente leitura. |
| owner | approvalIdentitySet | O conjunto de identidades do principal proprietário do item de aprovação. Forneça apenas um valor para esta propriedade ao criar um item de aprovação em nome do principal. Se o campo de proprietário não for fornecido, são utilizadas as informações do utilizador do contexto de utilizador. |
| responsePrompts | Coleção String | Pedidos de resposta de aprovação. Forneça apenas um valor para esta propriedade ao criar um item de aprovação personalizado. Para itens de aprovação personalizados, forneça duas cadeias de pedido de resposta. Os pedidos de resposta predefinidos são "Aprovar" e "Rejeitar". |
| resultado | Cadeia de caracteres | O campo de resultado só é preenchido quando o item de aprovação estiver no estado final. O resultado do item de aprovação baseia-se no approvalType. Para itens de aprovação básicos, o resultado é "Aprovado" ou "Rejeitado". Para itens de aprovação personalizados, o resultado pode ser uma resposta única ou múltiplas respostas separadas por um ponto e vírgula. Somente leitura. |
| state | approvalItemState | O estado do item de aprovação. Os valores possíveis são: canceled, created, pending, completed. Somente leitura. |
| viewPoint | approvalItemViewPoint | Representa os dados de pontos de vista do utilizador no ApprovalItem. Os dados incluem as funções de utilizador relativamente ao item de aprovação. Somente leitura. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| pedidos | coleção approvalItemRequest | Uma coleção de pedidos criados para cada aprovador no item de aprovação. |
| respostas | coleção approvalItemResponse | Uma coleção de respostas criadas para o item de aprovação. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@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"
}