Almacenar y consultar metadatos de contenedores

Se aplica a: Desarrollador

Use metadatos cuando la aplicación necesite campos estructurados en archivos en un contenedor de SharePoint Embedded. Los metadatos se almacenan como columnas en un fileStorageContainer y como valores de campo en los elementos de la unidad contenedora. La aplicación es responsable de crear y administrar el esquema de columnas de cada instancia de contenedor. Para obtener la lista completa de las propiedades de los recursos de contenedor, consulte el tipo de recurso fileStorageContainer.

Permisos y autores de llamadas admitidos

Llame a las API de metadatos con un token de portador delegado o de solo aplicación. Úsalo FileStorageContainer.Selected para aplicaciones y llamadas delegadas.

Los propietarios y administradores de contenedores pueden crear, actualizar y eliminar columnas. Los miembros del contenedor pueden leer y enumerar columnas.

Elegir tipos de columna

Los metadatos de SharePoint Embedded admiten estas propiedades de tipo de columna: boolean, choice, currency, personOrGroupnumberdateTimehyperlinkOrPicturey .text También admite configuraciones de columna como , , , , namereadOnly, y type. isSealedisDeletableindexed

Los nombres de columna deben seguir las reglas de SharePoint. No use nombres que contengan !, empiecen por un dígito o puntuación, contengan espacios, que se parezcan a referencias de celdas de hojas de cálculo, que representen valores verdaderos o falsos localizados ni nombres reservados como Author, Created, o Description.

Crear una columna

Cree una columna en el contenedor antes de escribir los valores de campo en los archivos.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
Content-Type: application/json

{
  "description": "test",
  "displayName": "Title",
  "enforceUniqueValues": false,
  "hidden": false,
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

La solicitud de creación no admite typey el texto maxLength debe ser menor o igual que 255.

Nota:

A partir de enero de 2026, las API de columnas de contenedor (lista, creación, actualización, eliminación de columnas) también están disponibles con carácter general en el punto de conexión v1.0 de Microsoft Graph. Puede reemplazar /beta/ con /v1.0/ en las solicitudes de columna a continuación. El punto de conexión beta sigue estando disponible.

Administrar columnas

Use el identificador de columna devuelto por la operación crear o enumerar.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
DELETE https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}

Revisión de propiedades admitidas cuando cambia el esquema. Puede actualizar cualquier propiedad de una columna excepto la id propiedad.

{
  "required": true,
  "hidden": false,
  "description": "This is my new column description"
}

Leer y escribir metadatos de archivos

Los valores de los campos se almacenan en los campos de elementos de lista del elemento de unidad. Lea todos los campos o seleccione los que necesite su interfaz de usuario.

GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields?$select=Name,Color

Revise los valores de los campos para actualizar los metadatos. Se usa null para borrar un valor de campo cuando la columna permite valores vacíos.

PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Content-Type: application/json

{
  "Color": "Fuchsia",
  "Quantity": 934
}

{
  "Color": null
}

Consultar archivos por metadatos

Use opciones de consulta OData en columnas personalizadas cuando necesite filtrado estructurado u orden dentro de una unidad de contenedor.

GET https://graph.microsoft.com/beta/drives/{drive-id}/items?$orderby=listitem/fields/TestField asc&$filter=startswith(listitem/fields/TestField, '3')&$expand=listitem($expand=fields)

Úselo $expand=listitem($expand=fields) cuando el resultado necesite valores de campo en la respuesta. Cree columnas indexadas para los filtros de cardinalidad alta que su aplicación ejecute con frecuencia.

Para realizar búsquedas de texto completo en contenedores y metadatos personalizados, consulte Buscar contenedores y archivos. Para filtrar la recuperación semántica por metadatos personalizados indexados, consulte Filtrar la recuperación por metadatos personalizados. En ambas experiencias se usan propiedades administradas de SharePoint, como la propiedad generada para una columna de OWSTEXT texto.

Use OData $filter para consultas estructuradas dentro de una unidad de contenedor. Usa la búsqueda de consultas de texto libre en muchos contenedores o usa la API de recuperación para devolver extracciones para la conexión a tierra de la IA.

Mantener la coherencia del esquema

Cree columnas necesarias durante el aprovisionamiento de contenedores. Almacene la versión de esquema esperada en los datos de la aplicación y ejecute migraciones cuando se introduzcan nuevas columnas. Evite eliminar columnas hasta que sepa que ningún flujo de trabajo, consultas, exportaciones o experiencias de búsqueda dependen de sus valores.

Pasos siguientes

  • Last updated on