EN English version

Technik suchen
  • Grüner Gürtel
  • Standard
  • Tipp 153

SharePoint-Datei per REST umbenennen

Quizfrage

Warum benennst du per FileLeafRef um statt zu kopieren?

Auflösung

  1. A) Kopieren geht in Bibliotheken grundsätzlich nichtFalsch. Kopieren geht, erzeugt aber ein neues Element mit neuer ID und ohne Versionsverlauf.
  2. B) FileLeafRef ändert auch gleich die DateiendungFalsch. Eine geänderte Endung ignoriert SharePoint bei FileLeafRef. Dafür brauchst du MoveTo.
  3. C) ID, Versionen und Metadaten bleiben erhaltenRichtig. MERGE auf FileLeafRef ändert nur den Namen. Das Element selbst bleibt dasselbe.

Worum es geht

Der SharePoint-Connector hat keine Aktion zum Umbenennen. Kopieren und Löschen erzeugt eine neue Datei mit neuer ID, ohne Versionsverlauf und Metadaten. Sauberer ist ein einziger Aufruf mit «Send an HTTP request to SharePoint». Du schickst einen POST an das Listenelement der Datei und machst ihn mit den Kopfzeilen IF-MATCH: * und X-HTTP-Method: MERGE zu einer Änderung. Im Body steht nur das Feld FileLeafRef mit dem neuen Dateinamen samt Endung. Mit den Kopfzeilen odata=nometadata brauchst du keinen Eintrag __metadata. Die Antwort 204 bedeutet Erfolg. ID, Versionen, Berechtigungen und Metadaten bleiben erhalten. Die Dateiendung lässt sich so nicht ändern, dafür gibt es MoveTo.

Der Ausdruck aus dem Tipp

X-HTTP-Method: MERGE

Wann einsetzen, wann nicht

Einsetzen

Für Namenskonventionen, Referenznummern im Dateinamen oder Korrekturen an hochgeladenen Dateien.

Lieber nicht

Wenn sich die Dateiendung oder der Ordner ändern soll. Dafür ist MoveTo der richtige Aufruf.

Häufigster Fehler

Den Namen ohne Endung in FileLeafRef schreiben. Der Dateiname enthält die Endung immer mit.

Lizenz

Standard Läuft ohne Premium-Connector, also mit der Lizenz aus Microsoft 365. Beleg bei Microsoft Learn: SharePoint, Connector-Referenz. Für deinen ganzen Flow: Lizenz-Check.

Ganzer Tipp mit Screenshots auf powerplatformtip.comPowerPlatformTip #153, auf Englisch

Lieber mit Begleitung? Der Live-Kurs Power Automate der Power Platform Academy führt in vier Wochen von den Grundlagen bis zu Error Handling und Scopes.

Teilen

Als Quizfrage auf LinkedIn teilenFehler in dieser Frage melden

Kurzadresse: powerautomate.ninja/153

Quelle: PowerPlatformTip #153, Microsoft Learn: Working with the SharePoint Send HTTP Request flow action.