Partager via

type de ressource approvalItem

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Représente une demande d’approbation, y compris les décisions, l’état et les réponses associés. Les utilisateurs peuvent créer de nouveaux éléments d’approbation, afficher les éléments d’approbation envoyés ou reçus et effectuer des actions sur les éléments d’approbation.

Méthodes

Méthode Type de retour Description
List collection approvalItem Obtenez la liste des objets approvalItem et de leurs propriétés.
Create approvalItem Créez un objet approvalItem .
Obtenir approvalItem Lire les propriétés et les relations d’un objet approvalItem .
Cancel Aucune Annulez l’élément d’approbation. Le propriétaire de l’approbation peut déclencher ce point de terminaison.
Répertorier les demandes collection approvalItemRequest Obtenez la collection de approvalItemRequest pour l’objet approvalItem.
Lister les réponses collection approvalItemResponse Obtenez la collection de approvalItemResponse pour l’objet approvalItem.
Créer une réponse approvalItemResponse Créez un objet approvalItemResponse .

Propriétés

Propriété Type Description
allowCancel Valeur booléenne Indique si l’élément d’approbation peut être annulé.
allowEmailNotification Valeur booléenne Indique si la notification par e-mail est activée.
approvalType approvalItemType Type de flux de travail de l’élément d’approbation. Les valeurs possibles sont : basic, basicAwaitAll, custom, customAwaitAll. Obligatoire.
Approbateurs collection approvalIdentitySet Identité des principaux auxquels l’élément d’approbation a été initialement affecté. Obligatoire.
completedDateTime DateTimeOffset Date et heure d’achèvement de la demande d’approbation. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de la demande d’approbation. En lecture seule.
description Chaîne Description de la demande d’approbation.
displayName Chaîne DisplayName de la demande d’approbation. Obligatoire.
id Chaîne ID unique de l’élément d’approbation. En lecture seule.
owner approvalIdentitySet Jeu d’identité du principal propriétaire de l’élément d’approbation. Fournissez une valeur pour cette propriété uniquement lors de la création d’un élément d’approbation au nom du principal. Si le champ propriétaire n’est pas fourni, les informations utilisateur du contexte utilisateur sont utilisées.
responsePrompts String collection Invites de réponse d’approbation. Fournissez une valeur pour cette propriété uniquement lors de la création d’un élément d’approbation personnalisé. Pour les éléments d’approbation personnalisés, fournissez deux chaînes d’invite de réponse. Les invites de réponse par défaut sont « Approuver » et « Rejeter ».
result Chaîne Le champ de résultat n’est rempli qu’une fois que l’élément d’approbation est dans son état final. Le résultat de l’élément d’approbation est basé sur le type d’approbation. Pour les éléments d’approbation de base, le résultat est « Approuvé » ou « Rejeté ». Pour les éléments d’approbation personnalisés, le résultat peut être une seule réponse ou plusieurs réponses séparées par un point-virgule. En lecture seule.
state approvalItemState État de l’élément d’approbation. Les valeurs possibles sont canceled, created, pending, completed. En lecture seule.
point de vue approvalItemViewPoint Représente les données des points de vue de l’utilisateur sur l’objet ApprovalItem. Les données incluent les rôles des utilisateurs concernant l’élément d’approbation. En lecture seule.

Relations

Relation Type Description
Requêtes collection approvalItemRequest Collection de demandes créées pour chaque approbateur sur l’élément d’approbation.
Réponses collection approvalItemResponse Collection de réponses créées pour l’élément d’approbation.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@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"
}