approvalItem-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Stellt eine Genehmigungsanforderung dar, einschließlich der zugehörigen Entscheidungen, status und Antworten. Benutzer können neue Genehmigungselemente erstellen, Genehmigungselemente anzeigen, die gesendet oder empfangen werden, und Aktionen für Genehmigungselemente ausführen.

Methoden

Methode	Rückgabetyp	Beschreibung
List	approvalItem-Sammlung	Ruft eine Liste der approvalItem-Objekte und deren Eigenschaften ab.
Create	approvalItem	Erstellen Sie ein neues approvalItem-Objekt .
Get	approvalItem	Lesen der Eigenschaften und Beziehungen eines approvalItem-Objekts .
Cancel	Keine	Abbrechen des Genehmigungselements. Der Besitzer der Genehmigung kann diesen Endpunkt auslösen.
Anforderungen auflisten	approvalItemRequest-Auflistung	Ruft die Auflistung von approvalItemRequest für das approvalItem-Objekt ab.
Antworten auflisten	approvalItemResponse-Auflistung	Ruft die Auflistung von approvalItemResponse für das approvalItem-Objekt ab.
Antwort erstellen	approvalItemResponse	Erstellen Sie ein neues approvalItemResponse-Objekt .

Eigenschaften

Eigenschaft	Typ	Beschreibung
allowCancel	Boolesch	Gibt an, ob das Genehmigungselement abgebrochen werden kann.
allowEmailNotification	Boolesch	Gibt an, ob E-Mail-Benachrichtigungen aktiviert sind.
approvalType	approvalItemType	Der Workflowtyp des Genehmigungselements. Mögliche Werte sind: basic, basicAwaitAll, custom, customAwaitAll. Erforderlich.
Genehmigenden	approvalIdentitySet-Sammlung	Die Identität der Prinzipale, denen das Genehmigungselement ursprünglich zugewiesen wurde. Erforderlich.
completedDateTime	DateTimeOffset	Datum und Uhrzeit des Abschlusses der Genehmigungsanforderung. Schreibgeschützt.
createdDateTime	DateTimeOffset	Erstellungsdatum und -uhrzeit der Genehmigungsanforderung. Schreibgeschützt.
description	String	Die Beschreibung der Genehmigungsanforderung.
displayName	String	Der displayName der Genehmigungsanforderung. Erforderlich.
id	String	Die eindeutige ID für das Genehmigungselement. Schreibgeschützt.
owner	approvalIdentitySet	Der Identitätssatz des Prinzipals, dem das Genehmigungselement gehört. Geben Sie nur einen Wert für diese Eigenschaft an, wenn Sie ein Genehmigungselement im Namen des Prinzipals erstellen. Wenn das Feld besitzer nicht angegeben wird, werden die Benutzerinformationen aus dem Benutzerkontext verwendet.
responsePrompts	Zeichenfolgensammlung	Aufforderungen zur Genehmigungsantwort. Geben Sie nur einen Wert für diese Eigenschaft an, wenn Sie ein benutzerdefiniertes Genehmigungselement erstellen. Geben Sie für benutzerdefinierte Genehmigungselemente zwei Antwortaufforderungszeichenfolgen an. Die Standardantwortaufforderungen sind "Genehmigen" und "Ablehnen".
result	String	Das Ergebnisfeld wird erst aufgefüllt, wenn sich das Genehmigungselement im endgültigen Zustand befindet. Das Ergebnis des Genehmigungselements basiert auf dem approvalType. Bei grundlegenden Genehmigungselementen lautet das Ergebnis entweder "Genehmigt" oder "Abgelehnt". Bei benutzerdefinierten Genehmigungselementen kann das Ergebnis entweder eine einzelne Antwort oder mehrere Durch einen Semikolon getrennte Antworten sein. Schreibgeschützt.
state	approvalItemState	Der Status des Genehmigungselements. Mögliche Werte sind: canceled, created, pending, completed. Schreibgeschützt.
Aussichtspunkt	approvalItemViewPoint	Stellt Benutzersichtdaten für das ApprovalItem-Objekt dar. Die Daten enthalten die Benutzerrollen in Bezug auf das Genehmigungselement. Schreibgeschützt.

Beziehungen

Beziehung	Typ	Beschreibung
Aufforderungen	approvalItemRequest-Auflistung	Eine Auflistung von Anforderungen, die für jede genehmigenden Person für das Genehmigungselement erstellt wurden.
Antworten	approvalItemResponse-Auflistung	Eine Sammlung von Antworten, die für das Genehmigungselement erstellt wurden.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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