Hochladen, Herunterladen und Verwalten von Dateien

Gilt für: Entwickler

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

Schließen Sie zuerst Container erstellen und verwalten ab, damit Sie über eine Container-ID verfügen.

Grundlegendes zum Dateispeicher

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

Jeder Container macht Dateiinhalte über Microsoft Graph-Dateispeicher und DriveItem-APIs verfügbar.

Verwenden Sie Ihr Anwendungsdatenmodell, um zu entscheiden, welches Geschäftsobjekt die 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 den folgenden Microsoft Graph-Verweisen:

Wichtig

Verwenden Sie dokumentierte Microsoft Graph DriveItem- und Dateispeicher-APIs. Erfinden Sie keine SharePoint Embedded-spezifischen Dateinamen.

Voraussetzungen

Stellen Sie vor dem Verwalten von Dateien Folgendes sicher:

  • Ihre App kann Microsoft Graph-Token abrufen.
  • Die App verfügt über eine FileStorageContainer.Selected Zustimmung.
  • Die App verfügt über Containertypberechtigungen für beabsichtigte Vorgänge.
  • Der Zielcontainer ist vorhanden.
  • Bei delegierten Aufrufen ist der Benutzer Mitglied des Containers.
  • Ihre App speichert die container-ID und die DriveItem-IDs, die sie benötigt.

Zuordnen von Container-IDs zu Laufwerken

Die Vorschauquelle weist darauf hin, dass der Graph-Vorschauendpunkt ein driveIdverwendet, und für SharePoint Embedded ist die Laufwerks-ID die Container-ID, die mit b!beginnt.

In Ihrer App:

  1. Speichern Sie die Container-ID, die beim Erstellen des Containers zurückgegeben wird.

  2. Verwenden Sie die Container-ID beim Aufrufen von DriveItem-APIs, die einen Laufwerkbezeichner erfordern.

  3. Speichern von Element-IDs, die durch Upload- oder Ordnererstellungsvorgänge zurückgegeben werden.

  4. Vermeiden Sie die Wiederherstellung 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 einzelnen PUT für den Inhalt des Elements.

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

In Ihrem Uploadflow:

  1. Überprüfen Des Schreibzugriffs.
  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. Anzeige von Dateiname, Größe und status.

Tipp

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

Dateien herunterladen

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

In Ihrem Downloadflow:

  1. Überprüfen des Lesezugriffs.
  2. Lösen Sie die Container-ID und die DriveItem-ID auf.
  3. Fordern Sie den Dateiinhalt an, oder laden Sie die URL mithilfe von DriveItem-APIs herunter.
  4. Stream den Inhalt dem Benutzer oder Dienst.
  5. Behandeln Sie den Ablauf für kurzlebige Download-URLs.
  6. Protokollieren Sie sich gemäß Ihren Überwachungsanforderungen.

Ordner erstellen

Verwenden Sie driveItem-Ordnererstellungs-APIs, um Inhalte zu organisieren.

Erstellen Sie Ordner für vorhersagbare Inhaltsstruktur, Workflowphasen, verwandte Uploads und stabile übergeordnete Elemente für Office-Start-URLs.

Beim Erstellen von Ordnern:

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

Aktualisieren des Dateiinhalts

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

Vor dem Ersetzen von Inhalten:

  • Bestätigen Sie die Schreibberechtigung.
  • Lesen Sie die aktuellen Metadaten, wenn Parallelitätsprüfungen erforderlich sind.
  • Behalten Sie die DriveItem-ID bei, sofern dies unterstützt wird.
  • 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-Dateien automatisch aktiviert.

Weitere Informationen finden Sie unter Öffnen von Office-Dateien aus Ihrer App für Office.

Umbenennen oder Verschieben von Elementen

Verwenden Sie dokumentierte DriveItem-Aktualisierungs- und Verschiebungsvorgänge, sofern diese unterstützt werden.

Ein sicherer Flow sollte das aktuelle DriveItem lesen, den Zielordner bestätigen, den Vorgang anwenden, den gespeicherten Pfad oder Anzeigenamen aktualisieren und die DriveItem-ID nach Möglichkeit als dauerhaften Verweis beibehalten.

Löschen von Dateien

Verwenden Sie Löschvorgänge, wenn eine Datei nicht mehr in der aktiven Inhaltsumgebung angezeigt werden soll.

Vor dem Löschen:

  • Bestätigen Sie die Benutzerabsicht.
  • Bestätigen Sie die Schreib- oder Löschberechtigung.
  • Entscheiden Sie, ob Ihre App vorläufiges Löschen erfordert.
  • Aktualisieren Sie den App-Zustand nur, nachdem Graph erfolgreich zurückgegeben hat.

Wiederherstellen von Dateien

Verwenden Sie microsoft Graph- und SharePoint-Funktionen zur Dateiwiederherstellung, die für DriveItems und die Diensterfahrung dokumentiert sind.

Ein Wiederherstellungsflow sollte das gelöschte Element oder die version identifizieren, die Berechtigung bestätigen, die Wiederherstellung durchführen, die Elementliste aktualisieren und den wiederhergestellten Speicherort mitteilen.

Hinweis

recycleBinItem: Wiederherstellung wird als alternativer Schlüssel unterstützt driveItemId (Oktober 2025). Wenn Sie die ID des ursprünglichen driveItem kennen, können Sie das entsprechende recycleBinItem-Objekt direkt wiederherstellen, ohne zuerst den Papierkorb aufzuzählen.

Hinweis

Für genaue Details zur Anforderung und Antwort von Dateivorgängen verwenden Sie die Microsoft Graph DriveItem-Dokumentation.

Herstellen einer Verbindung mit Office- und Vorschaufunktionen

Fügen Sie nach dem Upload umfangreichere Funktionen hinzu:

Überprüfen von Dateivorgängen

Erstellen sie einen Feuerprobe:

  1. Erstellen Sie einen Testcontainer.
  2. Erstellen Sie einen Ordner.
  3. Laden Sie eine Datei hoch.
  4. Liest zurückgegebene 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
Fehler beim Hochladen WriteContent Berechtigung und Rolle "Benutzerautor".
Fehler beim Herunterladen ReadContent Berechtigung und Rolle "Benutzerleser".
Fehler beim Erstellen des Ordners ID des übergeordneten Ordners und Schreibberechtigungen.
Fehler in der Vorschau Unterstützung von Dateitypen und Generierung von VORSCHAU-URLs.
Office-Start öffnet den falschen Modus Starten Sie den URL-Parameter action oder das Office-URI-Schema.
Der Zugriff unterscheidet sich je nach Benutzer. Delegierter Zugriff überschneidet App-Berechtigungen mit Mitgliedschaft.

Nächste Schritte

Aktivieren Sie Office-Startfunktionen unter Office-Dateien aus Ihrer App öffnen.

  • Last updated on