Recurso ColumnDefinition

Representación JSON

A continuación se incluye una representación JSON de un recurso ColumnDefinition.

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

Propiedades

Las columnas pueden contener datos de distintos tipos. Las propiedades siguientes indican qué tipo de datos almacena una columna, así como una configuración adicional para esos datos. Las propiedades relacionadas con el tipo (booleano, calculado, choice, currency, dateTime, lookup, number, personOrGroup, text) son mutuamente excluyentes: una columna solo puede tener una de ellas especificada.

Nombre de propiedad	Tipo	Descripción
columnGroup	string	Para las columnas de sitio, el nombre del grupo al que pertenece esta columna. Ayuda a organizar las columnas relacionadas.
description	string	Descripción de cara al usuario de la columna.
displayName	string	Nombre de cara al usuario de la columna.
enforceUniqueValues	boolean	Si es true, dos elementos de la lista no pueden tener el mismo valor para esta columna.
hidden	boolean	Especifica si la columna se muestra en la interfaz de usuario.
id	string	El identificador único de la columna.
indexed	boolean	Especifica si los valores de columna se pueden usar para ordenar y buscar.
name	string	El nombre de cara a la API de la columna tal como aparece en fields en un recurso listItem. Para el nombre de cara al usuario, consulte displayName.
readOnly	bool	Especifica si se pueden modificar los valores de columna.
required	boolean	Especifica si el valor de columna no es opcional.
boolean	booleanColumn	Esta columna almacena valores booleanos.
calculated	calculatedColumn	Los datos de la columna se calculan en función de otras columnas.
choice	choiceColumn	Esta columna almacena los datos de una lista de opciones.
currency	currencyColumn	Esta columna almacena valores de moneda.
dateTime	dateTimeColumn	Esta columna almacena valores DateTime.
defaultValue	defaultColumnValue	El valor predeterminado de esta columna.
lookup	lookupColumn	Los datos de esta columna se buscan desde otro origen en el sitio.
number	numberColumn	Esta columna almacena valores de números.
personOrGroup	personOrGroupColumn	Esta columna almacena valores de personas o grupos.
text	textColumn	Esta columna almacena valores de texto.

Nota: Estas propiedades se corresponden con la enumeración SPFieldType de SharePoint. Aunque los tipos más comunes de campo están representados en la tabla anterior, aún faltan algunos en esta API de versión beta. En esos casos, no se rellenará ninguna de las facetas de tipo de columna y la columna solo tendrá sus propiedades básicas.

Comentarios

De forma predeterminada, las ColumnDefinitions y los valores de campo de las columnas hidden no se muestran. Para verlas al enumerar las columnDefinitions, incluya hidden en su instrucción $select. Para verlos al mostrar valores de campo en listItems, incluya las columnas deseadas por nombre en la $select instrucción .