tipo de recurso columnDefinition
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
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 truees , 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 truees , 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 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"},
"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"}
}