customFieldDefinition Ressourcentyp (Planner)

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 in einem Plan definiertes benutzerdefiniertes Feld, das zum Erfassen strukturierter, planspezifischer Daten zu Aufgaben verwendet wird. Auswahloptionen für Single-Choice- und Multiple-Choice-Felder sind unter choiceOptionsenthalten; Werte werden pro Aufgabe über customFieldValue festgelegt.

Erbt von plannerDelta.

Methoden

Methode Rückgabetyp Beschreibung
List customFieldDefinition collection Rufen Sie eine Liste der customFieldDefinition-Objekte und ihrer Eigenschaften ab.
Create customFieldDefinition Erstellen Sie ein neues customFieldDefinition-Objekt.
Get customFieldDefinition Lesen Sie die Eigenschaften und Beziehungen des customFieldDefinition-Objekts .
Update customFieldDefinition Aktualisieren der Eigenschaften eines customFieldDefinition-Objekts.
Löschen Keine Löschen Sie ein customFieldDefinition-Objekt.
Auswahl auflisten Optionen customChoiceOption-Sammlung Rufen Sie eine Liste der customChoiceOption-Objekte und ihrer Eigenschaften ab.
Erstellen Sie customChoiceOption customChoiceOption Erstellen Sie ein neues customChoiceOption-Objekt.

Eigenschaften

Eigenschaft Typ Beschreibung
archivalInfo plannerArchivalInfo Informationen darüber, ob und wann die Entität archiviert wurde.
createdBy identitySet Identität des Benutzers (oder der Anwendung), der das Objekt erstellt hat. Schreibgeschützt.
createdDateTime DateTimeOffset Datum und Uhrzeit der Entität Der Wert wird im ISO 8601-Format dargestellt und immer in UTC-Zeit angegeben. Schreibgeschützt.
deletedBy identitySet Identität des Benutzers, der die benutzerdefinierte Felddefinition gelöscht hat, falls sie gelöscht wurde.
deletedDateTime DateTimeOffset Datum und Uhrzeit der Löschung der benutzerdefinierten Felddefinition, falls zutreffend.
displayName Zeichenfolge Name des benutzerdefinierten Felds.
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.
planId String ID des Plans, auf dem das benutzerdefinierte Feld definiert ist. Erforderlich und nach der Erstellung unveränderlich.
rollupType customFieldRollupType Wie die Werte dieses benutzerdefinierten Felds aufgabenübergreifend hochgerechnet werden Mögliche Werte sind: noRollup, max, min, sum, average, unknownFutureValue.
valueType customFieldValueType Datentyp der Werte des benutzerdefinierten Felds.. Die möglichen Werte sind: text, date, utcDateTime, number, decimalflag, singleChoiceText, multipleChoiceText. unknownFutureValue

Beziehungen

Beziehung Typ Beschreibung
choiceOptions customChoiceOption-Sammlung Die Sammlung auswählbarer Auswahloptionen für ein benutzerdefiniertes Feld mit einfacher Auswahl oder einem benutzerdefinierten Feld mit Vielfachauswahl. Schreibgeschützt. Nullwerte zulassend.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.customFieldDefinition",
  "id": "String (identifier)",
  "planId": "String",
  "displayName": "String",
  "valueType": "String",
  "rollupType": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "deletedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "deletedDateTime": "String (timestamp)",
  "archivalInfo": {
    "@odata.type": "microsoft.graph.plannerArchivalInfo"
  }
}