Cargar, descargar y administrar archivos

Se aplica a: Desarrollador

Use las API de archivos de Microsoft Graph y DriveItem para administrar archivos dentro de contenedores de SharePoint Embedded.

Complete primero la creación y administración de contenedores para disponer de un identificador de contenedor.

SharePoint Embedded proporciona a la aplicación un almacén de documentos solo de API con capacidades de Microsoft 365 integradas. La administración de archivos es totalmente mediante programación a través de Microsoft Graph, sin interfaz de usuario de SharePoint. El ciclo de vida completo incluye la carga y descarga, las carpetas, el control de versiones, una papelera de reciclaje y la restauración de contenido de 93 días. El contenido se puede buscar a través de la API de Búsqueda de Microsoft y hereda el cumplimiento de Microsoft Purview del inquilino. Los usuarios finales de la aplicación no necesitan una licencia de Microsoft 365 para las operaciones básicas de archivos.

Comprender el almacenamiento de archivos

Un contenedor de SharePoint Embedded es el límite de almacenamiento para el contenido de la aplicación.

Cada contenedor expone el contenido del archivo a través de las API de almacenamiento de archivos de Microsoft Graph y DriveItem.

Use el modelo de datos de su aplicación para decidir qué objeto de negocio posee cada contenedor, qué carpetas crea su aplicación, qué usuarios o servicios pueden leer y escribir, y qué ID de archivo almacena su aplicación.

Para conocer la arquitectura, consulte Arquitectura de aplicaciones de SharePoint Embedded.

Usar las API de almacenamiento de archivos de Microsoft Graph

Comience con estas referencias de Microsoft Graph:

• tipo de recurso fileStorageContainer
• Tipo de recurso DriveItem
• Introducción al almacenamiento de archivos de Microsoft Graph

Requisitos previos

Antes de administrar archivos, asegúrate de lo siguiente:

• La aplicación puede adquirir tokens de Microsoft Graph.
• La aplicación tiene FileStorageContainer.Selected consentimiento.
• La aplicación tiene permisos de tipo de contenedor para las operaciones previstas.
• El contenedor de destino existe.
• En el caso de las llamadas delegadas, el usuario es miembro del contenedor.
• La aplicación almacena los identificadores de contenedor e DriveItem que necesita.

Asignar identificadores de contenedor a unidades

Las API DriveItem de Microsoft Graph usan un driveIdformato Para SharePoint Embedded, el identificador de unidad es el identificador de contenedor que comienza con b!.

En la aplicación:

1. Almacena el id. del contenedor devuelto cuando se crea el contenedor.
2. Usa el id. de contenedor al llamar a las API de DriveItem que requieren un identificador de unidad.
3. Almacenar identificadores de elementos devueltos por las operaciones de carga o creación de carpetas.
4. Evita reconstruir identificadores a partir de direcciones URL.

Cargar archivos

Use los patrones de carga de Microsoft Graph para los elementos de unidad.

Para archivos pequeños (hasta 250 MB), use la API de carga simple documentada para DriveItems con un solo PUT al contenido del elemento.

Para archivos más grandes (más de 250 MB), use una sesión de carga según lo documentado por Microsoft Graph y envíe el archivo en fragmentos de intervalo de bytes (por ejemplo, múltiplos de 320 KB) hasta que se complete la carga.

En el flujo de carga:

1. Validar el acceso de escritura.
2. Elija una carpeta de destino en el contenedor.
3. Cree carpetas primero si la ruta de acceso no existe.
4. Cargue bytes de archivo con el método de Graph adecuado.
5. Almacena el Id. de elemento de unidad devuelto.
6. Mostrar el nombre, tamaño y estado del archivo.

Se descargan los archivos

Use las funcionalidades de descarga de DriveItem de Microsoft Graph para el contenido de archivos.

En el flujo de descarga:

1. Validar el acceso de lectura.
2. Resuelva el identificador de contenedor y el identificador de elemento de unidad.
3. Solicite el contenido del archivo o la dirección URL de descarga mediante las API de DriveItem.
4. Stream el contenido al usuario o servicio.
5. Gestionar la expiración de las URL de descarga de corta duración.
6. Registre de acuerdo con sus requisitos de auditoría.

Crear carpetas

Utilice las API de creación de carpetas DriveItem para organizar el contenido.

Cree carpetas para una estructura de contenido predecible, fases del flujo de trabajo, cargas relacionadas y elementos primarios estables para las direcciones URL de inicio de Office.

Al crear carpetas:

1. Compruebe si la carpeta existe.
2. Cree solo el segmento de ruta que falta.
3. Almacena el Id. de DriveItem de la carpeta si es necesario.
4. Aplique reglas de nomenclatura de forma coherente.

Actualizar el contenido del archivo

Use patrones de sesión de carga o actualización de DriveItem de Microsoft Graph para reemplazar el contenido.

Antes de reemplazar el contenido:

• Confirmar permiso de escritura.
• Lea los metadatos actuales si se necesitan comprobaciones de simultaneidad.
• Conserve el id. de unidad donde se admita.
• Actualice los metadatos de la aplicación después de que Graph se realice correctamente.

Los archivos de Office almacenados en SharePoint Embedded tienen el control de versiones habilitado automáticamente para Word, Excel y PowerPoint.

Consulte Abrir archivos de Office desde la aplicación para obtener información sobre el comportamiento de Office.

Cambiar el nombre de los elementos o moverlos

Use las operaciones de actualización y traslado documentadas de DriveItem cuando sea compatible.

Leer el elemento de unidad actual, confirmar la carpeta de destino, aplicar la operación, actualizar la ruta de acceso almacenada o el nombre para mostrar y mantener el id. de elemento de unidad como referencia duradera siempre que sea posible.

Eliminar archivos

Utilizar operaciones de eliminación cuando un archivo ya no deba aparecer en la experiencia de contenido activo.

Antes de eliminar:

• Confirmar la intención del usuario.
• Confirme el permiso de escritura o eliminación.
• Decida si la aplicación necesita eliminación temporal.
• Actualice el estado de la aplicación solo después de que Graph muestre un resultado correcto.

Restaurar archivos

Use las funcionalidades de restauración de archivos de Microsoft Graph y SharePoint documentadas para DriveItems y la experiencia de servicio.

Identifique el elemento o la versión eliminados, confirme el permiso, realice la restauración, actualice la lista de elementos y comunique la ubicación restaurada.

Conectarse a Office y obtener una vista previa de las experiencias

Después de la carga, agregue experiencias más variadas:

• Abra archivos de Office desde la aplicación para comportamientos de inicio de Word, Excel y PowerPoint.
• Obtenga una vista previa de los archivos de la aplicación para obtener vistas previas del explorador.
• Busque contenedores y archivos para su detección.

Validar operaciones de archivo

Crear una prueba de humo:

1. Cree un contenedor de prueba.
2. Crear una carpeta.
3. Cargue un archivo.
4. Leer los metadatos devueltos de DriveItem.
5. Descargue el archivo.
6. Reemplace el contenido.
7. Cambie el nombre del archivo.
8. Elimine el archivo.
9. Restáurela si es compatible.
10. Limpie el contenedor de prueba.

Solucionar problemas de operaciones de archivos

Pasos siguientes

Habilitar las experiencias de inicio de Office en Abrir archivos de Office desde la aplicación.