Compartir a través de


tipo de recurso columnDefinition

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 truees , 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 representación JSON muestra el tipo de 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" }
}