columnDefinition-Ressourcentyp

Namespace: microsoft.graph

Stellt eine Spalte in einer [Website,][] [Liste][]oder [inhaltstyp][]dar.

ColumnDefinitions- und Feldwerte für hidden Spalten werden standardmäßig nicht angezeigt. Um ausgeblendete columnDefinitions aufzuführen, fügen hidden Sie sie in Ihre Anweisung $select ein. Wenn Sie ausgeblendete Feldwerte in listItemsauflisten möchten, fügen Sie die gewünschten Spalten nach Namen in Ihre $select Anweisung ein.

Methoden

Methode Rückgabetyp Beschreibung
Auflisten von Spalten in einer Website columnDefinition-Auflistung Dient zum Abrufen einer Liste der columnDefinition -Objekte und deren Eigenschaften in einer Website.
Spalten in einer Liste auflisten columnDefinition-Auflistung Dient zum Abrufen einer Liste der columnDefinition -Objekte und deren Eigenschaften in einer Liste.
Spalten in einem Inhaltstyp auflisten columnDefinition-Auflistung Dient zum Abrufen einer Liste der columnDefinition -Objekte und deren Eigenschaften in einem Inhaltstyp.
Erstellen von columnDefinition für eine Website columnDefinition Erstellen sie ein neues columnDefinition -Objekt in einer Website.
Erstellen von columnDefinition für eine Liste columnDefinition Erstellen eines neuen columnDefinition -Objekts in einer Liste.
Erstellen von columnDefinition für einen Inhaltstyp columnDefinition Erstellen eines neuen columnDefinition-Objekts in einem Inhaltstyp.
ColumnDefinition abrufen columnDefinition Lesen der Eigenschaften und Beziehungen eines columnDefinition-Objekts.
ColumnDefinition aktualisieren columnDefinition Dient zum Aktualisieren der Eigenschaften eines columnDefinition-Objekts.
ColumnDefinition löschen Keine Löscht ein columnDefinition-Objekt.

Eigenschaften

Spalten können verschiedene Datentypen enthalten. Die folgenden Eigenschaften geben an, welche Arten von Daten in einer Spalte gespeichert werden sowie weitere Einstellungen für die Daten. Die typbezogenen Eigenschaften (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text, term, hyperlinkOrPicture, thumbnail, and contentApprovalStatus) schließen sich gegenseitig aus. In einer Spalte kann nur eine davon angegeben werden.

Eigenschaftenname Typ Beschreibung
columnGroup string Für Websitespalten der Name der Gruppe, zu der dieser Spalte gehört. Dadurch können dazugehörige Spalten einfacher organisiert werden.
description string Für den Benutzer sichtbare Beschreibung der Spalte.
displayName string Für den Benutzer sichtbarer Name der Spalte.
enforceUniqueValues Boolescher Wert Wenn true , haben keine zwei Listenelemente den gleichen Wert für diese Spalte.
hidden Boolean Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird.
id Zeichenfolge Die eindeutige ID für die Spalte.
indexed Boolescher Wert Gibt an, ob die Spaltenwerte zum Sortieren und Suchen verwendet werden können.
name string Der in der API sichtbare Name der Spalte, wie er in den Feldern eines ListItem angezeigt wird. Weitere Informationen zum für den Benutzer sichtbaren Namen finden Sie unter displayName.
readOnly Boolescher Wert Gibt an, ob die Werte in den Spalten geändert werden können.
required Boolescher Wert Gibt an, ob der Spaltenwert nicht optional ist.
boolean booleanColumn In dieser Spalte werden boolesche Werte gespeichert.
calculated calculatedColumn Die Daten in dieser Spalte werden anhand von anderen Spalten berechnet.
choice choiceColumn In dieser Spalte werden Daten aus einer Auswahlliste gespeichert.
currency currencyColumn In dieser Spalte sind die Währungswerte gespeichert.
dateTime dateTimeColumn In dieser Spalte sind die DateTime-Werte gespeichert.
defaultValue defaultColumnValue Der Standardwert für diese Spalte.
Geolocation geolocationColumn In dieser Spalte wird ein Geolocation gespeichert.
lookup lookupColumn Die Daten in dieser Spalte werden aus einer anderen Quelle dieser Website abgerufen.
number numberColumn In dieser Spalte werden Zahlenwerte gespeichert.
personOrGroup personOrGroupColumn In dieser Spalte werden Personen- oder Gruppenwerte gespeichert.
text textColumn In dieser Spalte werden Textwerte gespeichert.
isDeletable Boolescher Wert Gibt an, ob diese Spalte gelöscht werden kann.
propagateChanges Boolescher Wert Bei "true" werden Änderungen an dieser Spalte an Listen weitergegeben, die die Spalte implementieren.
isReorderable Boolescher Wert Gibt an, ob Werte in der Spalte neu angeordnet werden können. Schreibgeschützt.
Issealed Boolescher Wert Gibt an, ob die Spalte geändert werden kann.
Validierung columnValidation In dieser Spalte werden die Validierungsformel und die Meldung für die Spalte gespeichert.
hyperlinkOrPicture hyperlinkOrPictureColumn In dieser Spalte werden Hyperlink- oder Bildwerte gespeichert.
Begriff termColumn In dieser Spalte werden Taxonomiebegriffe gespeichert.
sourceContentType contentTypeInfo ContentType, von dem diese Spalte geerbt wird. Nur in der ContentTypes-Spaltenantwort vorhanden. Schreibgeschützt.
thumbnail thumbnailColumn In dieser Spalte werden Miniaturansichtswerte gespeichert.
type columnTypes Bei Websitespalten der Spaltentyp. Schreibgeschützt.
contentApprovalStatus contentApprovalStatusColumn In dieser Spalte wird der Status der Inhaltsgenehmigung gespeichert.

Beziehungen

Eigenschaftenname Typ Beschreibung
Sourcecolumn columnDefinition Die Quellspalte für die Inhaltstypspalte.

Hinweis: Diese Eigenschaften entsprechen der SharePoint [SPFieldType-Enumeration.][] Beachten Sie, dass die gängigsten Feldtypen in der vorherigen Tabelle dargestellt werden. Dieser API fehlen jedoch noch einige. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf. Die Antwort auf Websites und Listenspalten enthält keine Eigenschaften "isDeletable", "propagateChanges", "isReorderable", "isSealed", "validation", "hyperlinkOrPicture", "term", "sourceContentType", "thumbnail", "type", "contentApprovalStatus" und "sourceColumn".

JSON-Darstellung

Hier sehen Sie eine JSON-Darstellung einer columnDefinition-Ressource.

{
  "columnGroup": "string",
  "description": "description",
  "displayName": "friendly name",
  "enforceUniqueValues": true,
  "hidden": false,
  "id": "string",
  "indexed": true,
  "name": "staticNameForApi",
  "readOnly": false,
  "required": false,
  "boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
  "calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
  "choice": { "@odata.type": "microsoft.graph.choiceColumn" },
  "currency": { "@odata.type": "microsoft.graph.currencyColumn" },
  "dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
  "defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
  "geolocation": { "@odata.type": "microsoft.graph.geolocationColumn" },
  "lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
  "number": { "@odata.type": "microsoft.graph.numberColumn" },
  "personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
  "text": { "@odata.type": "microsoft.graph.textColumn" },
  "isDeletable" : false,
  "propagateChanges": false,
  "isReorderable": false,
  "isSealed": false,
  "validation": { "@odata.type": "microsoft.graph.columnValidation" },
  "hyperlinkOrPicture": { "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" },
  "term": { "@odata.type": "microsoft.graph.termColumn" },
  "sourceContentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "thumbnail": { "@odata.type": "microsoft.graph.thumbnailColumn" },
  "type": { "@odata.type": "microsoft.graph.columnTypes" },
  "contentApprovalStatus": { "@odata.type": "microsoft.graph.contentApprovalStatusColumn" }
}