Charger, télécharger et gérer des fichiers

S’applique à : Développeur

Utilisez les API de fichier Microsoft Graph et DriveItem pour gérer les fichiers à l’intérieur des conteneurs SharePoint Embedded.

Terminez d’abord Créer et gérer des conteneurs afin de disposer d’un ID de conteneur.

SharePoint Embedded offre à votre application un magasin de documents API uniquement avec des fonctionnalités Microsoft 365 intégrées. La gestion de fichiers est entièrement par programme via Microsoft Graph, sans interface utilisateur SharePoint. Le cycle de vie complet comprend le chargement et le téléchargement, les dossiers, la gestion des versions, une corbeille et la restauration du contenu de 93 jours. Le contenu peut faire l’objet d’une recherche via l’API de recherche Microsoft et hérite de la conformité Microsoft Purview du client. Les utilisateurs finaux de votre application n’ont pas besoin d’une licence Microsoft 365 pour les opérations de fichier de base.

Comprendre le stockage de fichiers

Un conteneur SharePoint Embedded constitue la limite de stockage du contenu de votre application.

Chaque conteneur expose le contenu du fichier via le stockage de fichiers Microsoft Graph et les API DriveItem.

Utilisez votre modèle de données d’application pour déterminer l’objet métier propriétaire de chaque conteneur, les dossiers créés par votre application, les utilisateurs ou services pouvant lire et écrire, et les ID de fichiers stockés par votre application.

Pour plus d’informations sur l’architecture, voir Architecture d’application incorporée SharePoint.

Utiliser les API de stockage de fichiers Microsoft Graph

Commencez par ces références Microsoft Graph :

• type de ressource fileStorageContainer
• Type de ressource DriveItem
• Vue d’ensemble du stockage de fichiers Microsoft Graph

Configuration requise

Avant de gérer des fichiers, vérifiez que :

• Votre application peut acquérir des jetons Microsoft Graph.
• L’application a FileStorageContainer.Selected le consentement.
• L’application dispose d’autorisations de type conteneur pour les opérations prévues.
• Le conteneur cible existe.
• Pour les appels délégués, l’utilisateur est membre du conteneur.
• Votre application stocke les ID de conteneur et les ID DriveItem dont elle a besoin.

Mapper les ID de conteneur aux lecteurs

Les API DriveItem Microsoft Graph utilisent un driveId. Pour SharePoint Embedded, l’ID de lecteur est l’ID de conteneur qui commence par b!.

Dans votre application :

1. Stockez l’ID de conteneur renvoyé lors de la création du conteneur.
2. Utilisez l’ID de conteneur lors de l’appel d’API DriveItem qui nécessitent un identificateur de lecteur.
3. Stocker les ID d’éléments renvoyés par les opérations de chargement ou de création de dossiers.
4. Évitez de reconstruire les ID à partir des URL.

Charger des fichiers

Utilisez des modèles de chargement Microsoft Graph pour DriveItems.

Pour les petits fichiers (jusqu’à 250 Mo), utilisez l’API de téléchargement simple documentée pour DriveItems avec un seul PUT au contenu de l’élément.

Pour les fichiers plus volumineux (plus de 250 Mo), utilisez une session de chargement comme indiqué par Microsoft Graph et envoyez le fichier par blocs de plage d’octets (par exemple, des multiples de 320 Ko) jusqu’à la fin du téléchargement.

Dans votre flux de chargement :

1. Valider l’accès en écriture.
2. Choisissez un dossier de destination dans le conteneur.
3. Créez d’abord des dossiers si le chemin d’accès n’existe pas.
4. Chargez les octets du fichier avec la méthode Graph appropriée.
5. Stockez l’ID DriveItem renvoyé.
6. Afficher le nom, la taille et le status du fichier.

Téléchargement de fichiers

Utilisez les fonctionnalités de téléchargement de Microsoft Graph DriveItem pour le contenu des fichiers.

Dans votre flux de téléchargement :

1. Valider l’accès en lecture.
2. Résolvez l’ID de conteneur et l’ID DriveItem.
3. Demander le contenu du fichier ou télécharger l’URL à l’aide des API DriveItem.
4. Stream du contenu à l’utilisateur ou au service.
5. Expiration du handle pour les URL de téléchargement de courte durée.
6. Consignez en fonction de vos besoins d’audit.

Créer des dossiers

Utilisez les API de création de dossiers DriveItem pour organiser le contenu.

Créez des dossiers pour une structure de contenu prévisible, des étapes de flux de travail, des téléchargements associés et des éléments parents stables pour les URL de lancement d’Office.

Lors de la création de dossiers :

1. Vérifiez si le dossier existe.
2. Créez uniquement le segment de chemin manquant.
3. Stockez l’ID DriveItem du dossier si nécessaire.
4. Appliquer les règles d’affectation de noms de manière cohérente.

Mettre à jour le contenu du fichier

Utilisez la mise à jour de Microsoft Graph DriveItem ou chargez des modèles de session pour remplacer le contenu.

Avant de remplacer du contenu :

• Confirmez l’autorisation d’écriture.
• Lire les métadonnées actuelles si des vérifications d’accès concurrentiel sont nécessaires.
• Conservez l’ID DriveItem là où cela est pris en charge.
• Mettez à jour les métadonnées de votre application une fois Graph réussi.

Le contrôle de version des fichiers Office stockés dans SharePoint Embedded est activé automatiquement pour Word, Excel et PowerPoint.

Consultez Comportement Ouvrir des fichiers Office à partir de votre application pour Office.

Renommer ou déplacer des éléments

Utilisez les opérations documentées de mise à jour et de déplacement de DriveItem là où elles sont prises en charge.

Lisez le DriveItem actuel, confirmez le dossier de destination, appliquez l’opération, actualisez le chemin d’accès ou le nom d’affichage stocké et conservez l’ID DriveItem comme référence durable lorsque cela est possible.

Supprimer des fichiers

Utilisez les opérations de suppression lorsqu’un fichier ne doit plus apparaître dans l’expérience de contenu actif.

Avant de supprimer :

• Confirmez l’intention de l’utilisateur.
• Confirmez les autorisations d’écriture ou de suppression.
• Déterminez si votre application nécessite une suppression réversible.
• Mettre à jour l’état de l’application uniquement après le succès du graphique.

Restaurer des fichiers

Utilisez les fonctionnalités de restauration de fichiers Microsoft Graph et SharePoint documentées pour DriveItems et l’expérience de service.

Identifiez l’élément ou la version supprimé, confirmez l’autorisation, effectuez la restauration, actualisez la liste des éléments et communiquez l’emplacement restauré.

Se connecter à Office et aux expériences d’aperçu

Après le chargement, ajoutez des expériences plus riches :

• Ouvrez des fichiers Office à partir de votre application pour le comportement de lancement de Word, Excel et PowerPoint.
• Prévisualisez les fichiers dans votre application pour les aperçus du navigateur.
• Recherchez des conteneurs et des fichiers à découvrir.

Valider les opérations de fichier

Créez un test de fumée :

1. Créez un conteneur de test.
2. Créer un dossier.
3. Charger un fichier.
4. Lire les métadonnées DriveItem retournées.
5. Téléchargez le fichier.
6. Remplacez le contenu.
7. Renommez le fichier.
8. Supprimez ce fichier.
9. Restaurez-la si prise en charge.
10. Nettoyez le récipient d’essai.

Résoudre les problèmes d’opérations sur les fichiers

Étapes suivantes

Activez les expériences de lancement d’Office dans Ouvrir des fichiers Office à partir de votre application.