tipo de recurso columnDefinition

Artículo
04/04/2024

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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 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 .

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 (booleano, calculado, choice, currency, dateTime, lookup, number, personOrGroup, text) son mutuamente excluyentes: una columna solo puede tener una de ellas especificada.

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	Booleano	Si `true`es , no hay dos elementos de lista que tengan el mismo valor para esta columna.
hidden	Booleano	Especifica si la columna se muestra en la interfaz de usuario.
id	string	El identificador único de la columna.
indexed	Booleano	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	Booleano	Especifica si se pueden modificar los valores de columna.
required	Booleano	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.
Geolocalización	geolocationColumn	Esta columna almacena una geolocalización.
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.
isDeletable	Booleano	Indica si esta columna se puede eliminar.
propagateChanges	Booleano	Si `true`es , los cambios en esta columna se propagarán a las listas que implementan la columna.
isReorderable	Booleano	Indica si los valores de la columna se pueden reordenar. Solo lectura.
isSealed	Booleano	Especifica si se puede cambiar la columna.
Validación	columnValidation	Esta columna almacena la fórmula de validación y el mensaje de la columna.
hyperlinkOrPicture	hyperlinkOrPictureColumn	Esta columna almacena valores de hipervínculo o imagen.
Término	termColumn	Esta columna almacena los términos de taxonomía.
sourceContentType	contentTypeInfo	ContentType del que se hereda esta columna. Solo se usa para capturar columnas contentTypes.
thumbnail	thumbnailColumn	Esta columna almacena los valores de miniatura.
type	columnTypes	Para las columnas de sitio, el tipo de columna. Solo lectura.
contentApprovalStatus	contentApprovalStatusColumn	Esta columna almacena el estado de aprobación de contenido.

Relaciones

Relación	Tipo	Descripción
sourceColumn	columnDefinition	Columna de origen para 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 beta 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.

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"},
  "propagateChanges": "Boolean",
  "readOnly": "Boolean",
  "required": "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"}
}