tipo de recurso columnDefinition

Artículo
04/22/2024

Espacio de nombres: microsoft.graph

Representa una columna de un sitio, lista o contentType.

De forma predeterminada, no se muestran columnDefinitions ni los valores de campo de hidden las columnas. Para enumerar columnDefinitions ocultos, incluya hidden en la $select instrucción . Para enumerar los valores de campoocultos en listItems, incluya las columnas deseadas por nombre en la $select instrucción .

Métodos

Método	Tipo devuelto	Descripción
Enumerar columnas en un sitio	columnDefinition (colección)	Obtenga una lista de los objetos columnDefinition y sus propiedades en un sitio.
Enumerar columnas en una lista	columnDefinition (colección)	Obtenga una lista de los objetos columnDefinition y sus propiedades en una lista.
Enumerar columnas en un tipo de contenido	columnDefinition (colección)	Obtenga una lista de los objetos columnDefinition y sus propiedades en un tipo de contenido.
Creación de columnDefinition para un sitio	columnDefinition	Cree un nuevo objeto columnDefinition en un sitio.
Creación de columnDefinition para una lista	columnDefinition	Cree un nuevo objeto columnDefinition en una lista.
Creación de columnDefinition para un tipo de contenido	columnDefinition	Cree un nuevo objeto columnDefinition en un tipo de contenido.
Obtener columnDefinition	columnDefinition	Lea las propiedades y relaciones de un objeto columnDefinition .
Actualizar columnDefinition	columnDefinition	Actualice las propiedades de un objeto columnDefinition .
Eliminar columnDefinition	Ninguno	Elimine un objeto columnDefinition .

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 (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text, term, hyperlinkOrPicture, thumbnail y contentApprovalStatus) son mutuamente excluyentes; una columna solo puede tener una de ellas especificada.

Nombre de propiedad	Tipo	Descripción
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.
columnGroup	string	Para las columnas de sitio, el nombre del grupo al que pertenece esta columna. Ayuda a organizar las columnas relacionadas.
contentApprovalStatus	contentApprovalStatusColumn	Esta columna almacena el estado de aprobación de contenido.
currency	currencyColumn	Esta columna almacena valores de moneda.
dateTime	dateTimeColumn	Esta columna almacena valores DateTime.
defaultValue	defaultColumnValue	El valor predeterminado de esta columna.
description	string	Descripción de cara al usuario de la columna.
displayName	string	Nombre de cara al usuario de la columna.
enforceUniqueValues	Booleano	Si `true`es , no hay dos elementos de lista que tengan el mismo valor para esta columna.
Geolocalización	geolocationColumn	Esta columna almacena una geolocalización.
hidden	Booleano	Especifica si la columna se muestra en la interfaz de usuario.
hyperlinkOrPicture	hyperlinkOrPictureColumn	Esta columna almacena valores de hipervínculo o imagen.
isDeletable	Booleano	Indica si esta columna se puede eliminar.
isReorderable	Booleano	Indica si los valores de la columna se pueden reordenar. Solo lectura.
id	string	El identificador único de la columna.
indexed	Booleano	Especifica si los valores de columna se pueden usar para ordenar y buscar.
isSealed	Booleano	Especifica si se puede cambiar la columna.
lookup	lookupColumn	Los datos de esta columna se buscan desde otro origen en el sitio.
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.
number	numberColumn	Esta columna almacena valores de números.
personOrGroup	personOrGroupColumn	Esta columna almacena valores de personas o grupos.
propagateChanges	Booleano	Si es "true", los cambios en esta columna se propagarán a las listas que implementan la columna.
readOnly	Booleano	Especifica si se pueden modificar los valores de columna.
required	Booleano	Especifica si el valor de columna no es opcional.
sourceContentType	contentTypeInfo	ContentType del que se hereda esta columna. Solo se presenta en la respuesta de columnas contentTypes. Solo lectura.
Término	termColumn	Esta columna almacena los términos de taxonomía.
text	textColumn	Esta columna almacena valores de texto.
thumbnail	thumbnailColumn	Esta columna almacena los valores de miniatura.
type	columnTypes	Para las columnas de sitio, el tipo de columna. Solo lectura.
Validación	columnValidation	Esta columna almacena la fórmula de validación y el mensaje de la columna.

Relaciones

Nombre de la propiedad	Tipo	Descripción
sourceColumn	columnDefinition	Columna de origen de la columna de tipo de contenido.

Nota: Estas propiedades corresponden a la enumeración SPFieldType de SharePoint. Tenga en cuenta que los tipos de campo más comunes se representan en la tabla anterior. Sin embargo, a esta API todavía le faltan algunas. En esos casos, no se rellenará ninguna de las facetas de tipo de columna y la columna solo tendrá sus propiedades básicas. La respuesta de sitios y columnas de lista no contendrá las propiedades isDeletable, propagateChanges, isReorderable, isSealed, validation, hyperlinkOrPicture, term, sourceContentType, thumbnail, type, contentApprovalStatus y sourceColumn .

Representación JSON

La siguiente es una representación JSON del recurso

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