Hochladen, Herunterladen und Verwalten von Dateien

Gilt für: Entwickler

Verwenden Sie Microsoft Graph-Dateien und DriveItem-APIs, um Dateien in SharePoint Embedded-Containern zu verwalten.

Schließen Sie zuerst das Erstellen und Verwalten von Containern ab, damit Sie über eine Container-ID verfügen.

SharePoint Embedded bietet Ihrer App einen reinen API-Dokumentspeicher mit integrierten Microsoft 365-Funktionen. Die Dateiverwaltung erfolgt vollständig programmgesteuert über Microsoft Graph, ohne SharePoint-Benutzeroberfläche. Der gesamte Lebenszyklus umfasst Upload und Download, Ordner, Versionsverwaltung, einen Papierkorb und eine 93-tägige Inhaltswiederherstellung. Inhalte können über die Microsoft Search-API durchsucht werden und erben die Microsoft Purview-Compliance des Mandanten. Die Endbenutzer Ihrer App benötigen für grundlegende Dateivorgänge keine Microsoft 365-Lizenz.

Grundlegendes zum Dateispeicher

Ein SharePoint Embedded-Container ist die Speichergrenze für Ihre Anwendungsinhalte.

Jeder Container stellt Dateiinhalte über Microsoft Graph-Dateispeicher und DriveItem-APIs bereit.

Verwenden Sie Ihr Anwendungsdatenmodell, um zu entscheiden, welches Geschäftsobjekt den einzelnen Container besitzt, welche Ordner Ihre App erstellt, welche Benutzer oder Dienste lesen und schreiben können und welche Datei-IDs Ihre App speichert.

Informationen zur Architektur finden Sie unter SharePoint Embedded-App-Architektur.

Verwenden von Microsoft Graph-Dateispeicher-APIs

Beginnen Sie mit diesen Microsoft Graph-Referenzen:

Wichtig

Verwenden dokumentierter Microsoft Graph DriveItem- und Dateispeicher-APIs. Erfinden Sie keine SharePoint-Embedded-spezifischen Datei-API-Namen.

Voraussetzungen

Stellen Sie vor dem Verwalten von Dateien Folgendes sicher:

  • Ihre App kann Microsoft Graph-Token abrufen.
  • Die App hat FileStorageContainer.Selected zugestimmt.
  • Die App verfügt über Containertypberechtigungen für beabsichtigte Vorgänge.
  • Der Zielcontainer ist vorhanden.
  • Bei delegierten Anrufen ist der Benutzer Mitglied des Containers.
  • Ihre App speichert die benötigte Container-ID und DriveItem-IDs.

Zuordnen von Container-IDs zu Laufwerken

Microsoft Graph DriveItem-APIs verwenden eine driveId. Bei SharePoint Embedded ist die Laufwerks-ID die Container-ID, die mit b!beginnt.

In Ihrer App:

  1. Speichern der Container-ID, die beim Erstellen des Containers zurückgegeben wird.
  2. Verwenden Sie die Container-ID, wenn Sie DriveItem-APIs aufrufen, die einen Laufwerkbezeichner erfordern.
  3. Speichern von Element-IDs, die von Upload- oder Ordnererstellungsvorgängen zurückgegeben werden.
  4. Vermeiden Sie das Rekonstruieren von IDs aus URLs.

Dateien hochladen

Verwenden Sie Microsoft Graph-Uploadmuster für DriveItems.

Verwenden Sie für kleine Dateien (bis zu 250 MB) die einfache Upload-API, die für DriveItems dokumentiert ist, mit einem Single PUT zum Inhalt des Artikels.

Verwenden Sie für größere Dateien (über 250 MB) eine von Microsoft Graph dokumentierte Uploadsitzung, und senden Sie die Datei in Bytebereichsblöcken (z. B. 320 KB-Vielfache), bis der Upload abgeschlossen ist.

Im Uploadflow:

  1. Überprüfen Sie den Schreibzugriff.
  2. Wählen Sie einen Zielordner im Container aus.
  3. Erstellen Sie zuerst Ordner, wenn der Pfad nicht vorhanden ist.
  4. Laden Sie Dateibytes mit der entsprechenden Graph-Methode hoch.
  5. Speichern Sie die zurückgegebene DriveItem-ID.
  6. Dateiname, Größe und Status anzeigen.

Tipp

Behalten Sie Geschäftsmetadaten in Ihrer Anwendungsdatenbank bei, und behalten Sie Dateiinhalte in SharePoint Embedded bei.

Dateien herunterladen

Verwenden Sie die Microsoft Graph DriveItem-Downloadfunktionen für Dateiinhalte.

Im Downloadfluss:

  1. Überprüfen Sie den Lesezugriff.
  2. Lösen Sie die Container-ID und DriveItem-ID auf.
  3. Fordern Sie den Dateiinhalt oder die Download-URL mithilfe der DriveItem-APIs an.
  4. Stream Sie den Inhalt an den Benutzer oder Dienst.
  5. Ablauf für kurzlebige Download-URLs behandeln
  6. Protokollieren Sie gemäß Ihren Audit-Anforderungen.

Erstellen von Ordnern

Verwenden Sie DriveItem-APIs zur Ordnererstellung, um Inhalte zu organisieren.

Erstellen Sie Ordner für vorhersehbare Inhaltsstrukturen, Workflowphasen, zugehörige Uploads und stabile übergeordnete Elemente für Office-Start-URLs.

Beim Erstellen von Ordnern:

  1. Überprüfen Sie, ob der Ordner existiert.
  2. Erstellen Sie nur das fehlende Pfadsegment.
  3. Speichern Sie bei Bedarf die DriveItem-ID des Ordners.
  4. Wenden Sie Benennungsregeln konsistent an.

Dateiinhalt aktualisieren

Verwenden Sie Microsoft Graph DriveItem-Update- oder Upload-Sitzungsmuster, um Inhalte zu ersetzen.

Vor dem Ersetzen von Inhalten:

  • Bestätigen Sie die Schreibberechtigung.
  • Aktuelle Metadaten lesen, wenn Parallelitätsprüfungen erforderlich sind.
  • Behalten Sie die DriveItem-ID bei, sofern unterstützt.
  • Aktualisieren Sie Ihre App-Metadaten, nachdem Graph erfolgreich war.

Für Office-Dateien, die in SharePoint Embedded gespeichert sind, ist die Versionsverwaltung für Word, Excel und PowerPoint automatisch aktiviert.

Informationen zum Verhalten von Office-Dateien finden Sie unter "Office-Dateien aus Ihrer App öffnen ".

Umbenennen oder Verschieben von Elementen

Verwenden dokumentierter Aktualisierungs- und Verschiebevorgänge von DriveItem, sofern unterstützt.

Lesen Sie das aktuelle DriveItem, bestätigen Sie den Zielordner, wenden Sie den Vorgang an, aktualisieren Sie den gespeicherten Pfad oder Anzeigenamen, und behalten Sie die DriveItem-ID nach Möglichkeit als dauerhafte Referenz bei.

Löschen von Dateien

Verwenden Sie Löschvorgänge, wenn eine Datei nicht mehr in der Benutzeroberfläche für aktive Inhalte angezeigt werden soll.

Vor dem Löschen:

  • Benutzerabsicht bestätigen.
  • Bestätigen Sie die Schreib- oder Löschberechtigung.
  • Entscheiden Sie, ob für Ihre App ein vorläufiges Löschen erforderlich ist.
  • Aktualisieren Sie den App-Status nur, nachdem das Diagramm erfolgreich war.

Wiederherstellen von Dateien

Verwenden Sie die für DriveItems und die Diensterfahrung dokumentierten Wiederherstellungsfunktionen von Microsoft Graph und SharePoint.

Identifizieren Sie das gelöschte Element oder die gelöschte Version, bestätigen Sie die Berechtigung, führen Sie die Wiederherstellung durch, aktualisieren Sie die Elementliste und teilen Sie den wiederhergestellten Speicherort mit.

Hinweis

recycleBinItem: die Wiederherstellung wird als Alternativschlüssel in der Betaversion von Microsoft Graph (Oktober 2025) unterstützt driveItemId . Wenn Sie die ID des ursprünglichen driveItem kennen, können Sie das entsprechende recycleBinItem direkt wiederherstellen, ohne zuerst den Papierkorb aufzuzählen.

Genaue Details zu Dateivorgangsanforderungen und -antworten finden Sie in der Microsoft Graph DriveItem-Dokumentation.

Herstellen einer Verbindung mit Office und einer Vorschau

Fügen Sie nach dem Hochladen umfangreichere Erfahrungen hinzu:

Überprüfen von Dateivorgängen

Erstellen Sie einen Rauchtest:

  1. Erstellen Sie einen Testcontainer.
  2. Erstellen eines Ordners
  3. Datei hochladen.
  4. Lesen der zurückgegebenen DriveItem-Metadaten.
  5. Laden Sie die Datei herunter.
  6. Ersetzen Sie den Inhalt.
  7. Benennen Sie die Datei um.
  8. Löschen Sie die Datei.
  9. Stellen Sie es wieder her, falls unterstützt.
  10. Bereinigen Sie den Testcontainer.

Problembehandlung bei Dateivorgängen

Problembeschreibung Prüfen
Hochladen schlägt fehl WriteContent und Benutzerrolle "Autor" festgelegt.
Download schlägt fehl ReadContent und Benutzerleserolle festgelegt werden.
Fehler beim Erstellen von Ordnern Übergeordnete Ordner-ID und Schreibberechtigungen.
Vorschau schlägt fehl Dateitypunterstützung und Vorschau-URL-Generierung.
Der Office-Start öffnet den falschen Modus. Starten Sie den URL-Parameter action oder das Office-URI-Schema.
Der Zugriff unterscheidet sich je nach Benutzer Beim delegierten Zugriff werden App-Berechtigungen mit der Mitgliedschaft überschnitten.

Nächste Schritte

Aktivieren von Office-Startfunktionen in Öffnen Sie Office-Dateien aus Ihrer App.

  • Last updated on