Compartir a través de


tipo de recurso approvalItem

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa una solicitud de aprobación, incluidas las decisiones, el estado y las respuestas asociados. Los usuarios pueden crear nuevos elementos de aprobación, ver los elementos de aprobación que se envían o reciben y realizar acciones en los elementos de aprobación.

Métodos

Método Tipo devuelto Descripción
List approvalItem (colección) Obtenga una lista de los objetos approvalItem y sus propiedades.
Crear approvalItem Cree un nuevo objeto approvalItem .
Get approvalItem Lea las propiedades y relaciones de un objeto approvalItem .
Cancel Ninguno Cancele el elemento de aprobación. El propietario de la aprobación puede desencadenar este punto de conexión.
Enumerar solicitudes colección approvalItemRequest Obtenga la colección de approvalItemRequest para approvalItem.
Enumerar respuestas colección approvalItemResponse Obtenga la colección de approvalItemResponse para approvalItem.
Crear respuesta approvalItemResponse Cree un nuevo objeto approvalItemResponse .

Propiedades

Propiedad Tipo Descripción
allowCancel Booleano Indica si el elemento de aprobación se puede cancelar.
allowEmailNotification Booleano Indica si la notificación por correo electrónico está habilitada.
approvalType approvalItemType Tipo de flujo de trabajo del elemento de aprobación. Los valores posibles son: basic, basicAwaitAll, custom y customAwaitAll Obligatorio.
Aprobadores colección approvalIdentitySet Identidad de las entidades de seguridad a las que se asignó inicialmente el elemento de aprobación. Obligatorio.
completedDateTime DateTimeOffset Fecha y hora de finalización de la solicitud de aprobación. Solo lectura.
createdDateTime DateTimeOffset Fecha y hora de creación de la solicitud de aprobación. Solo lectura.
description Cadena Descripción de la solicitud de aprobación.
displayName Cadena DisplayName de la solicitud de aprobación. Necesario.
id Cadena Identificador único del elemento de aprobación. Solo lectura.
owner approvalIdentitySet Conjunto de identidades de la entidad de seguridad propietaria del elemento de aprobación. Proporcione solo un valor para esta propiedad al crear un elemento de aprobación en nombre de la entidad de seguridad. Si no se proporciona el campo propietario, se usa la información del usuario del contexto de usuario.
responsePrompts Colección de cadenas Solicitudes de respuesta de aprobación. Proporcione solo un valor para esta propiedad al crear un elemento de aprobación personalizado. Para los elementos de aprobación personalizados, proporcione dos cadenas de solicitud de respuesta. Las solicitudes de respuesta predeterminadas son "Aprobar" y "Rechazar".
result Cadena El campo de resultado solo se rellena una vez que el elemento de aprobación está en su estado final. El resultado del elemento de aprobación se basa en approvalType. Para los elementos de aprobación básicos, el resultado es "Aprobado" o "Rechazado". En el caso de los elementos de aprobación personalizados, el resultado podría ser una única respuesta o varias respuestas separadas por un punto y coma. Solo lectura.
estado approvalItemState Estado del elemento de aprobación. Los valores posibles son: canceled, created, pending, completed. Solo lectura.
punto de vista approvalItemViewPoint Representa los datos de puntos de vista del usuario en ApprovalItem. Los datos incluyen los roles de los usuarios con respecto al elemento de aprobación. Solo lectura.

Relaciones

Relación Tipo Descripción
Solicitudes colección approvalItemRequest Colección de solicitudes creadas para cada aprobador en el elemento de aprobación.
Respuestas colección approvalItemResponse Colección de respuestas creadas para el elemento de aprobación.

Representación JSON

La siguiente representación JSON muestra el 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"
}