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