ColumnDefinition-RessourceColumnDefinition resource

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer ColumnDefinition-Ressource.Here is a JSON representation of a ColumnDefinition resource.

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

EigenschaftenProperties

Die ColumnDefinition-Ressource weist folgende Eigenschaften auf.The columnDefinition resource has the following properties.

EigenschaftennameProperty name TypType BeschreibungDescription
columnGroupcolumnGroup stringstring Für Websitespalten der Name der Gruppe, zu der dieser Spalte gehört.For site columns, the name of the group this column belongs to. Dadurch können dazugehörige Spalten einfacher organisiert werden.Helps organize related columns.
descriptiondescription stringstring Für den Benutzer sichtbare Beschreibung der Spalte.The user-facing description of the column.
displayNamedisplayName stringstring Für den Benutzer sichtbarer Name der Spalte.The user-facing name of the column.
enforceUniqueValuesenforceUniqueValues booleanboolean Wenn der Wert true ist, dürfen keine der Elemente für diese Spalte den gleichen Wert aufweisen.If true, no two list items may have the same value for this column.
hiddenhidden booleanboolean Gibt an, ob die Spalte auf der Benutzeroberfläche angezeigt wird.Specifies whether the column is displayed in the user interface.
idid stringstring Die eindeutige ID für die Spalte.The unique identifier for the column.
indexedindexed booleanboolean Gibt an, ob die Spaltenwerte für das Sortieren und Suchen verwendet werden können.Specifies whether the column values can used for sorting and searching.
namename stringstring Der in der API sichtbare Name der Spalte, wie er in den Feldern eines ListItem angezeigt wird.The API-facing name of the column as it appears in the fields on a listItem. Weitere Informationen zum für den Benutzer sichtbaren Namen finden Sie unter displayName.For the user-facing name, see displayName.
readOnlyreadOnly boolbool Gibt an, ob die Werte in den Spalten geändert werden können.Specifies whether the column values can be modified.
requiredrequired booleanboolean Gibt an, ob die Werte in den Spalten obligatorisch sind.Specifies whether the column value is not optional.

Spalten können verschiedene Datentypen enthalten.Columns can hold data of various types. Die folgenden Eigenschaften geben an, welche Arten von Daten in einer Spalte gespeichert werden sowie weitere Einstellungen für die Daten.The following properties indicate what type of data a column stores, as well as additional settings for that data. Diese Eigenschaften schließen sich gegenseitig aus – in einer Spalte kann nur eines der beiden angegeben werden.These properties are mutually exclusive -- a column can only have one of them specified.

EigenschaftennameProperty name TypType BeschreibungDescription
booleanboolean booleanColumnbooleanColumn In dieser Spalte werden boolesche Werte gespeichert.This column stores boolean values.
calculatedcalculated calculatedColumncalculatedColumn Die Daten in dieser Spalte werden anhand von anderen Spalten berechnet.This column's data is calculated based on other columns.
choicechoice choiceColumnchoiceColumn In dieser Spalte werden Daten aus einer Auswahlliste gespeichert.This column stores data from a list of choices.
currencycurrency currencyColumncurrencyColumn In dieser Spalte sind die Währungswerte gespeichert.This column stores currency values.
dateTimedateTime dateTimeColumndateTimeColumn In dieser Spalte sind die DateTime-Werte gespeichert.This column stores DateTime values.
defaultValuedefaultValue defaultColumnValuedefaultColumnValue Der Standardwert für diese Spalte.The default value for this column.
lookuplookup lookupColumnlookupColumn Die Daten in dieser Spalte werden aus einer anderen Quelle dieser Website abgerufen.This column's data is looked up from another source in the site.
numbernumber numberColumnnumberColumn In dieser Spalte werden Zahlenwerte gespeichert.This column stores number values.
personOrGrouppersonOrGroup personOrGroupColumnpersonOrGroupColumn In dieser Spalte werden Personen- oder Gruppenwerte gespeichert.This column stores Person or Group values.
texttext textColumntextColumn In dieser Spalte werden Textwerte gespeichert.This column stores text values.

Hinweis: Diese Eigenschaften entsprechen der [SPFieldType][]-Enumeration von SharePoint.Note: These properties correspond to SharePoint's [SPFieldType][] enumeration. Während die am häufigsten verwendeten Feldtypen oben dargestellt werden, Fehlen dieser API noch einige.While the most common field types are represented above, this API is still missing some. In diesen Fällen werden keine der Spaltentyp-Facets aufgefüllt und die Spalte weist nur die grundlegenden Eigenschaften auf.In those cases, none of the column type facets will be populated, and the column will only have its basic properties.

BemerkungenRemarks

ColumnDefinitions und Feldwerte für hidden-Spalten werden standardmäßig nicht angezeigt.ColumnDefinitions and field values for hidden columns are not shown by default. Um diese bei der Auflistung von ColumnDefinitions anzuzeigen, fügen Sie hidden in Ihre $select-Anweisung ein.To see them when listing columnDefinitions, include hidden in your $select statement. Um diese beim Anzeigen von field-Werten mit listItems anzuzeigen, fügen Sie die gewünschten Spalten ein, indem Sie $select in Ihre Anweisung aufnehmen.To see them when showing field values on listItems, include the desired columns by name in your $select statement.

[SPFieldType]: https://msdn.microsoft.com/library/microsoft.sharepoint.spfieldtype.aspx[SPFieldType]: https://msdn.microsoft.com/library/microsoft.sharepoint.spfieldtype.aspx