ColumnDefinition-Ressource

JSON-Darstellung

Es folgt 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" },
  "lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
  "number": { "@odata.type": "microsoft.graph.numberColumn" },
  "personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
  "text": { "@odata.type": "microsoft.graph.textColumn" }
}

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) schließen sich gegenseitig aus. Für eine 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	boolean	Wenn der Wert true ist, dürfen keine der Elemente für diese Spalte den gleichen Wert aufweisen.
hidden	boolean	Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird.
id	string	Die eindeutige ID für die Spalte.
indexed	boolean	Gibt an, ob die Spaltenwerte für das 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	bool	Gibt an, ob die Werte in den Spalten geändert werden können.
required	boolean	Gibt an, ob die Werte in den Spalten obligatorisch sind.
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.
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.

Hinweis: Diese Eigenschaften entsprechen der SPFieldType-Enumeration von SharePoint. Obwohl die meisten gängigen Feldtypen vorstehend dargestellt sind, fehlen bei dieser Beta-API noch einige. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf.

Bemerkungen

ColumnDefinitions und Feldwerte für hidden-Spalten werden standardmäßig nicht angezeigt. Um diese bei der Auflistung von ColumnDefinitions anzuzeigen, fügen Sie hidden in Ihre $select-Anweisung ein. Um sie beim Anzeigen von Feldwerten in listItems anzuzeigen, schließen Sie die gewünschten Spalten anhand des Namens in Ihre $select Anweisung ein.