Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 los valores de campo en listItems, incluya las columnas deseadas por nombre en $select la 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, elección, moneda, dateTime, lookup, número, personOrGroup, text) son mutuamente excluyentes: una columna solo puede tener una de ellas especificada.
| Propiedad | Tipo | Descripción |
|---|---|---|
| booleano | booleanColumn | Esta columna almacena valores booleanos. |
| calculado | calculatedColumn | Los datos de la columna se calculan en función de otras columnas. |
| Elección | 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 del contenido. |
| Moneda | currencyColumn | Esta columna almacena valores de moneda. |
| dateTime | dateTimeColumn | Esta columna almacena valores DateTime. |
| valor predeterminado | 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, 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. |
| hipervínculoOrPicture | hyperlinkOrPictureColumn | Esta columna almacena valores de hipervínculo o imagen. |
| id | string | El identificador único de la columna. |
| Datos indexados | Booleano | Especifica si los valores de columna se pueden usar para ordenar y buscar. |
| isDeletable | Booleano | Indica si esta columna se puede eliminar. |
| isReorderable | Booleano | Indica si se pueden reordenar los valores de la columna. Solo lectura. |
| isSearchable | Booleano | Especifica si los valores de columna se pueden usar para la búsqueda. Actualmente solo se admite para columnas en un fileStorageContainer. |
| isSealed | Booleano | Especifica si la columna se puede cambiar. |
| Buscar | 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. |
| número | numberColumn | Esta columna almacena valores de números. |
| personOrGroup | personOrGroupColumn | Esta columna almacena valores de personas o grupos. |
| propagateChanges | Booleano | Si true, los cambios en esta columna se propagarán a las listas que implementen la columna. |
| solo lectura | Booleano | Especifica si se pueden modificar los valores de columna. |
| necesario | Booleano | Especifica si el valor de columna no es opcional. |
| sourceContentType | contentTypeInfo | ContentType del que se hereda esta columna. Se usa solo para capturar las columnas contentTypes. |
| term | termColumn | Esta columna almacena términos de taxonomía. |
| text | textColumn | Esta columna almacena valores de texto. |
| vista en miniatura | thumbnailColumn | Esta columna almacena valores de miniaturas. |
| type | columnTypes | Para las columnas del 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. |
Nota:
Las propiedades isSearchable e indexed están relacionadas pero son independientes. Si isSearchable no se especifica explícitamente, usa el valor de indexed. Después de establecer isSearchable, se vuelve independiente de indexado. Si solo se especifica isSearchable , el estado de búsqueda de la columna se actualiza sin cambiar su estado indexado. Actualmente, la propiedad isSearchable solo se admite para las columnas de un fileStorageContainer.
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| columna de origen | columnDefinition | La 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 están representados en la tabla anterior. Sin embargo, a esta API beta todavía le faltan algunos. 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",
"isSearchable": "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"}
}