plan-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.

Ein Planner V4-Plan. Ein Plan kann über den Besitzer des Containers (eine Gruppe, ein Teams-Kanal oder ein Benutzer) gefunden werden und enthält Buckets, Aufgaben, Ziele, Abhängigkeiten und andere Planner-Daten. Ein Plan ist ohne seinen besitzenden Container bedeutungslos und wird daher container standardmäßig zusammen mit id, displayName, , createdBy, createdDateTimelastModifiedBylastModifiedDateTime, , und archivalInfo/isArchivedzurückgegeben.

Erbt von plannerDelta.

Methoden

Methode	Rückgabetyp	Beschreibung
List	plan-Sammlung	Rufen Sie eine Liste der Planobjekte und ihrer Eigenschaften ab.
Create	plan	Erstellen Sie ein neues Planobjekt.
Get	plan	Lesen Sie die Eigenschaften und Beziehungen des Planobjekts .
Update	plan	Aktualisieren der Eigenschaften eines Planobjekts.
Löschen	Keine	Ein Planobjekt löschen.
Buckets auflisten	bucket-Sammlung	Rufen Sie eine Liste der Bucketobjekte und ihrer Eigenschaften ab.
Bucket erstellen	bucket	Erstellen Sie ein neues Bucket-Objekt.
Kontexte auflisten	planContextLink-Auflistung	Rufen Sie eine Liste der planContextLink-Objekte und ihrer Eigenschaften ab.
planContextLink erstellen	planContextLink	Erstellen Sie ein neues planContextLink-Objekt.
Liste customFieldDefinitions	customFieldDefinition collection	Rufen Sie eine Liste der customFieldDefinition-Objekte und ihrer Eigenschaften ab.
Fügen Sie customFieldDefinition hinzu	customFieldDefinition	Fügen Sie customFieldDefinitions hinzu, indem Sie in der customFieldDefinitions-Auflistung posten.
Entfernen von customFieldDefinitions	Keine	Entfernen Sie ein customFieldDefinition-Objekt .
Abhängigkeiten auflisten	Dependency Collection	Rufen Sie eine Liste der Abhängigkeitsobjekte und ihrer Eigenschaften ab.
App-Abhängigkeit	Abhängigkeit	Fügen Sie Abhängigkeiten hinzu, indem Sie in der Abhängigkeitensammlung posten.
Abhängigkeiten entfernen	Keine	Entfernen Sie ein Abhängigkeitsobjekt .
Ziele auflisten	Zielsammlung	Rufen Sie eine Liste der Zielobjekte und ihrer Eigenschaften ab.
Ziel hinzufügen	das Ziel	Fügen Sie Ziele hinzu, indem Sie in der Zielerfassung posten.
Ziele entfernen	Keine	Entfernen eines Zielobjekts .
list historyItems	historyItem-Sammlung	Rufen Sie eine Liste der historyItem-Objekte und ihrer Eigenschaften ab.
HistoryItem hinzufügen	historyItem	Fügen Sie historyItems hinzu, indem Sie in der historyItems-Sammlung posten.
Entfernen von historyItems	Keine	Entfernen Sie ein historyItem-Objekt .
Listenlinks	contentLink-Sammlung	Rufen Sie eine Liste der contentLink-Objekte und ihrer Eigenschaften ab.
ContentLink erstellen	contentLink	Erstellen Sie ein neues contentLink-Objekt.
Aufgaben auflisten	task-Sammlung	Rufen Sie eine Liste der Aufgabenobjekte und ihrer Eigenschaften ab.
Aufgabe hinzufügen	task	Hinzufügen von Aufgaben durch Posten in der Aufgabensammlung.
Aufgaben entfernen	Keine	Entfernen Sie ein Aufgabenobjekt .

Eigenschaften

Eigenschaft	Typ	Beschreibung
archivalInfo	plannerArchivalInfo	Informationen darüber, ob und wann die Entität archiviert wurde.
Kalender	planCalendar	Arbeitszeitkalendereinstellungen für den Plan.
Fähigkeiten	planCapability	Vom Server berechnete, schreibgeschützte Funktionsflags, die angeben, welche optionalen Features für die Entität aktiviert sind.
Container	planContainer	Identifiziert die Gruppe, den Teams-Kanal oder den Benutzer, der den Plan besitzt. Erforderlich und nach der Erstellung unveränderlich.
contentSensitivityLabelAssignment	contentSensitivityLabelAssignment	Die Vertraulichkeitsbezeichnung, die Inhalten zugeordnet ist, die dem Plan zugeordnet sind.
creationInfo	creationInfo	Schreibgeschützte Erstellungsmetadaten für die Entität.
displayName	Zeichenfolge	Der Titel des Plans.
Dauer	Int32	Dauer des Plans in Tagen.
Erweiterungen	extensionFieldCollection	Feldwerte für benutzerdefinierte Erweiterungen, die für die Entität festgelegt wurden. Unterstützt $select.
hasChat	Boolean	Gibt an, ob dem Plan ein Chat zugeordnet ist.
id	Zeichenfolge	Der eindeutige Bezeichner der Entität. Schreibgeschützt. Von Entität geerbt
lastModifiedBy	identitySet	Die Identität des Benutzers (oder der Anwendung), der die Entität zuletzt geändert hat. Schreibgeschützt.
lastModifiedDateTime	DateTimeOffset	Datum und Uhrzeit der letzten Änderung der Entität. Der Wert wird im ISO 8601-Format dargestellt und immer in UTC-Zeit angegeben. Schreibgeschützt.
planView	planView	Planbezogene Ansichtseinstellungen, einschließlich Kategoriedefinitionen.
sharedWithContainers	plannerSharedWithContainersammlung	Die Liste der Container (z. B. zusätzliche Gruppen oder Kanäle), für die der Plan freigegeben ist.

Beziehungen

Beziehung	Typ	Beschreibung
buckets	bucket-Sammlung	Die Auflistung der Buckets im Plan. Schreibgeschützt. Nullwerte zulassend.
Kontexte	planContextLink-Auflistung	Die Sammlung von Kontextlinks, die beschreiben, wo der Plan angezeigt wird. Schreibgeschützt. Nullwerte zulassend.
customFieldDefinitions	customFieldDefinition collection	Die Auflistung der benutzerdefinierten Felddefinitionen im Plan. Schreibgeschützt. Nullwerte zulassend.
dependencies	Dependency Collection	Die Auflistung von Abhängigkeiten zwischen Elementen im Plan. Schreibgeschützt. Nullwerte zulassend.
Ziele	Zielsammlung	Die Sammlung der Ziele im Plan. Schreibgeschützt. Nullwerte zulassend.
historyItems	historyItem-Sammlung	Die Sammlung von Verlaufselementen (Audit) für den Plan. Schreibgeschützt. Nullwerte zulassend.
Links	contentLink-Sammlung	Die Sammlung von Inhaltslinks, die dem Plan zugeordnet sind. Schreibgeschützt. Lässt Nullwerte zu.
tasks	task-Sammlung	Die Sammlung der Aufgaben im Plan. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.plan",
  "id": "String (identifier)",
  "displayName": "String",
  "container": {
    "@odata.type": "microsoft.graph.planContainer"
  },
  "calendar": {
    "@odata.type": "microsoft.graph.planCalendar"
  },
  "creationInfo": {
    "@odata.type": "microsoft.graph.creationInfo"
  },
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  },
  "planView": {
    "@odata.type": "microsoft.graph.planView"
  },
  "contentSensitivityLabelAssignment": {
    "@odata.type": "microsoft.graph.contentSensitivityLabelAssignment"
  },
  "hasChat": "Boolean",
  "duration": "Int32",
  "sharedWithContainers": [
    {
      "@odata.type": "microsoft.graph.plannerSharedWithContainer"
    }
  ],
  "capabilities": {
    "@odata.type": "microsoft.graph.planCapability"
  },
  "extensions": {
    "@odata.type": "microsoft.graph.extensionFieldCollection"
  }
}