Microsoft SharePoint Connector in Power Automate

  • Artikel

In Power Automate unterstützt Microsoft SharePoint Connector die folgenden Flowtrigger und -aktionen.

SharePoint-Trigger

Mit SharePoint-Triggern können Sie Flows erstellen, die änderungen in einer SharePoint-Liste oder -Bibliothek überwachen. Wenn eine oder mehrere Änderungen in einer abonnierten Liste auftreten, wird dieser Flow zur Ausführung ausgelöst.

Wenn ein Element erstellt wird

Löst den Flow aus, wenn Sie ein Element in einer SharePoint-Liste erstellen.

Wenn ein Element erstellt oder geändert wird

Löst den Flow aus, wenn Sie ein Element erstellen und jedes Mal, wenn Sie es in einer SharePoint-Liste ändern.

Wenn ein Element oder eine Datei geändert wird

Löst den Flow aus, wenn Sie ein Element oder eine Datei in einer SharePoint-Liste oder Dokumentbibliothek ändern.

Weitere Informationen zur Verwendung dieses Triggers finden Sie in diesem Tutorialvideo: Einführung in den Trigger "Wenn ein Element oder eine Datei geändert wurde" und die Aktion "Änderungen abrufen"

Wenn ein Element gelöscht wird

Löst den Flow aus, wenn Sie ein Element in einer Liste löschen. Um die Eigenschaften eines gelöschten Elements abzurufen, müssen Sie diesen Trigger mithilfe eines Websitesammlungsadministratorkontos mit der zugeordneten SharePoint-Website verbinden, auf der es ausgeführt werden soll.

Für ein ausgewähltes Element

Ermöglicht Benutzern von Listen, einen Flow auszulösen, nachdem sie ein Element in einer Liste ausgewählt haben.

Hinweis

Nur Flows innerhalb der Standardumgebung können manuell aus einer SharePoint-Liste ausgeführt werden.

Wenn eine Datei von einem Inhaltsverständnismodell klassifiziert wird

Löst den Flow aus, wenn ein Microsoft Syntex Content Understanding-Modell eine Datei klassifiziert, die in der Klassifizierungsdatumseigenschaft der Datei angezeigt wird.

Weitere Informationen dazu, wann Microsoft Syntex und wie Dateien klassifiziert werden, finden Sie unter Einführung in Microsoft Microsoft Syntex

Wenn eine Datei erstellt wird (nur Eigenschaften)

Löst den Flow aus, wenn Sie eine Datei in einer Dokumentbibliothek erstellen, und gibt nur die benutzerdefinierten Dateieigenschaften zurück, die dieser Datei zugeordnet sind.

Wenn eine Datei in einem Ordner erstellt wird [veraltet]

Hinweis

Dieser Trigger ist veraltet und funktioniert möglicherweise nicht wie erwartet.

Löst den Flow aus, wenn Sie eine Datei in einem SharePoint-Ordner erstellen. Dieser Trigger wird nicht ausgeführt, wenn Sie eine Datei in einem Unterordner innerhalb des Ordners hinzufügen oder aktualisieren, in dem dieser Trigger ausgeführt wird. Wenn der Flow in Unterordnern ausgelöst werden muss, erstellen Sie verschiedene Flows für einen oder mehrere Unterordner.

Wenn eine Datei erstellt oder geändert wird (nur Eigenschaften)

Löst den Flow aus, wenn Sie eine Datei erstellen und jedes Mal, wenn Sie die Dateieigenschaften in einer Bibliothek ändern. Geben Sie einen Wert in der Eigenschaft "Folder" für einen bestimmten Ordner an. Andernfalls gilt der Trigger für die gesamte Bibliothek. Gibt nur die benutzerdefinierten Dateieigenschaften zurück, die dieser Datei zugeordnet sind.

Wenn eine Datei in einem Ordner erstellt oder geändert wird [veraltet]

Hinweis

Dieser Trigger ist veraltet und funktioniert möglicherweise nicht wie erwartet.

Wird ausgelöst, wenn eine Datei erstellt wird, und jedes Mal, wenn sie in einem SharePoint-Ordner geändert wird. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn es erforderlich ist, in Unterordnern auszulösen, sollten mehrere Trigger erstellt werden.

Wenn eine Datei gelöscht wird

Löst den Flow aus, wenn Sie eine Datei in einer Dokumentbibliothek löschen. Optional können Sie einen Ordner angeben, der watch werden soll. Wenn Sie einen Ordner löschen, wird der Trigger nur einmal für den gelöschten Ordner aktiviert, einschließlich seiner Unterordner. Um die Eigenschaften der gelöschten Datei abzurufen, müssen Sie diesen Trigger mithilfe eines Websitesammlungsadministratorkontos mit der zugeordneten SharePoint-Website verbinden, auf der der Trigger ausgeführt werden soll.

Für eine ausgewählte Datei

Ermöglicht Benutzern von Dokumentbibliotheken, einen Flow auszulösen, nachdem sie eine Datei ausgewählt haben.

Hinweis

Nur Flows innerhalb der Standardumgebung können manuell aus einer SharePoint-Bibliothek ausgeführt werden.

Wenn eine Website den Beitritt zu einer Hubwebsite angefordert hat

Löst einen Flow bei der Genehmigungsanforderung für den Hubwebsitebeitritt aus.

SharePoint-Aktionen

Anlage hinzufügen

Fügt dem angegebenen Listenelement eine neue Anlage hinzu.

Genehmigen der Anforderung für den Hub-Sitebeitritt

Genehmigt die Anforderung für den Hub-Sitebeitritt. Diese Aktion gibt ein Genehmigungstoken zurück, um die Joinanforderung mithilfe der Join-Hub-Websiteaktion abzuschließen.

Abbrechen der Anforderung für den Hubwebsitebeitritt

Bricht die Anforderung zur Hubeinbindung ab. Geben Sie ggf. dieselbe Genehmigungskorrelations-ID an, die in der Aktion Hubwebsitejoin festlegen status auf ausstehende Aktion verwendet wurde.

Datei einchecken

Checkt eine ausgecheckte Datei in einer Dokumentbibliothek ein, wodurch die Version des Dokuments für andere Benutzer verfügbar ist.

Datei auschecken

Checkt eine Datei in einer Dokumentbibliothek aus, um zu verhindern, dass andere Personen das Dokument bearbeiten, und Ihre Änderungen sind sichtbar, bis Sie das Dokument einchecken.

Datei kopieren

Kopiert eine Datei. Funktioniert ähnlich wie der Befehl Kopieren in sharePoint-Bibliotheken. Nach dem Kopieren gibt Informationen zur neuen Datei zurück.

Datei kopieren [veraltet]

Hinweis

Diese Aktion ist veraltet und funktioniert möglicherweise nicht wie erwartet.

Kopiert eine Datei auf eine SharePoint-Website.

Ordner kopieren

Kopiert einen Ordner. Funktioniert ähnlich wie der Befehl Kopieren in sharePoint-Bibliotheken. Gibt nach dem Kopieren Informationen zum neuen Ordner zurück.

Datei erstellen

Lädt eine Datei auf eine SharePoint-Website hoch. Stellen Sie sicher, dass Sie eine vorhandene Bibliothek auswählen.

Element erstellen

Erstellt ein neues Element in einer SharePoint-Liste.

Neuen Ordner erstellen

Erstellt einen neuen Ordner oder Ordnerpfad.

Erstellt einen Freigabelink für eine Datei oder einen Ordner.

Anlage löschen

Löscht die angegebene Anlage.

Datei löschen

Löscht die durch den Dateibezeichner angegebene Datei.

Element löschen

Löscht ein Element aus einer SharePoint-Liste.

Auschecken verwerfen

Verwirft das Auschecken, anstatt die Datei zu speichern, wenn Sie eine Datei auschecken und keine Änderungen daran vornehmen oder Änderungen vornehmen, die Sie nicht beibehalten möchten. Wenn Ihre organization Versionen nachverfolgt, wird bei jedem Einchecken einer Datei in die Bibliothek eine neue Version erstellt. Wenn Sie das Auschecken verwerfen, können Sie vermeiden, neue Versionen zu erstellen, wenn Sie keine Änderungen an der Datei vorgenommen haben.

Ordner extrahieren

Extrahiert eine Archivdatei in einen SharePoint-Ordner (z. B. .zip).

Abrufen aller Listen und Bibliotheken

Ruft alle Listen und Bibliotheken ab.

Abrufen von Anlageninhalten

Gibt dateiinhalte unter Verwendung des Dateibezeichners zurück. Der Inhalt kann an eine andere Stelle kopiert oder als Anlage verwendet werden.

Abrufen von Anlagen

Gibt die Liste der Anlagen für das angegebene Listenelement zurück. Um zum Inhalt der Datei zu gelangen, fügen Sie den Schritt Anlageinhalt abrufen hinzu, und verwenden Sie die Eigenschaft Dateibezeichner , die von dieser Aktion zurückgegeben wird.

Abrufen von Änderungen für ein Element oder eine Datei (nur Eigenschaften)

Ruft alle Spalten oder Dateieigenschaften ab, die seit und bis zu einem angegebenen Zeitintervall geändert wurden. So rufen Sie alle Spalten ab, die geändert werden, wenn ein Element oder eine Datei geändert wird:

  • Verwenden Sie den Trigger , wenn ein Element oder eine Datei geändert wird , und
  • Verwenden Sie das Starttoken des Triggerfensters & Ausgabe des Triggerfenster-Endtokens aus dem Trigger , wenn ein Element oder eine Datei geändert wird , um abzuleiten, welche Spalten seit der letzten Überprüfung auf Element- oder Dateiaktualisierungen geändert wurden.

Weitere Informationen zur Verwendung dieser Aktion finden Sie in diesem Tutorialvideo: Einführung in den Trigger "Wenn ein Element oder eine Datei geändert wurde" und die Aktion "Änderungen abrufen"

Hinweis

  • Für die Liste oder Bibliothek sollte die Versionsverwaltung konfiguriert sein, um abzuleiten, welche Spalten oder Eigenschaften seit der letzten Änderung geändert wurden.
  • Für Listen und Bibliotheken werden nur Spaltenänderungen unterstützt.
  • Änderungen an Dateiinhalten werden nicht unterstützt.
  • Anlagenänderungen werden nicht unterstützt.
  • Trigger Window Start Token & Trigger Window End Token sind nur verfügbar, wenn Sie verwenden , wenn ein Element oder eine Datei geändert wird .

Abrufen von Dateiinhalten

Ruft den Dateiinhalt mithilfe des Dateibezeichners ab. Sie können den Inhalt an eine andere Stelle kopieren oder als Anlage verwenden.

Abrufen von Dateiinhalten mithilfe des Pfads

Ruft den Dateiinhalt unter Verwendung des Dateipfads ab.

Abrufen der Dateimetadaten

Ruft Informationen zur Datei ab, z. B. Größe, ETag, Erstellungsdatum usw. Verwendet einen Dateibezeichner, um die Datei auszuwählen. Verwenden Sie die Aktion Dateieigenschaften abrufen , um die in den Spalten in der Bibliothek gespeicherten Werte abzurufen.

Abrufen von Dateimetadaten mithilfe des Pfads

Ruft Informationen zur Datei ab, z. B. Größe, ETag, Erstellungsdatum usw. Verwendet einen Dateipfad, um die Datei auszuwählen. Verwenden Sie die Aktion Dateieigenschaften abrufen , um die in den Spalten in der Bibliothek gespeicherten Werte abzurufen.

Abrufen von Dateieigenschaften

Ruft die Eigenschaften ab, die in den Spalten in der Bibliothek für das durch die Element-ID angegebene Element gespeichert sind. Um zum Inhalt der Datei zu gelangen, fügen Sie einen Schritt "Dateiinhalt abrufen" hinzu, und verwenden Sie die eigenschaft "Dateibezeichner", die von dieser Aktion zurückgegeben wird. Wenn Sie dies mit dem lokalen Datengateway verwenden, müssen Sie möglicherweise manuell den Namen der Bibliothek eingeben, mit der eine Verbindung hergestellt werden soll.

Abrufen von Dateien (nur Eigenschaften)

Ruft die Eigenschaften ab, die in den Spalten in der Bibliothek für alle Ordner und Dateien gespeichert sind, die in der Bibliothek gespeichert sind. Sie können auch nach den Elementen filtern, die einer Bedingung entsprechen. Um mit der Ausgabe dieser Aktion zu arbeiten, verwenden Sie den Abschnitt Apply to each .To each .To work with the output from this action, use the Apply to each section. Wenn Sie dies mit dem lokalen Datengateway verwenden, müssen Sie möglicherweise manuell den Namen der Bibliothek eingeben, mit der eine Verbindung hergestellt werden soll. Weitere Informationen zu dieser Aktion finden Sie unter: Ausführliche Analyse in Elemente abrufen und SharePoint-Dateien abrufen-Aktionen für Flows in Power Automate.

Abrufen von Ordnermetadaten

Ruft Informationen zum Ordner ab. Verwendet einen Dateibezeichner, um den Ordner auszuwählen.

Abrufen von Ordnermetadaten mithilfe des Pfads

Ruft Informationen zum Ordner ab. Verwendet einen Ordnerpfad, um den Ordner auszuwählen.

Element abrufen

Ruft ein einzelnes Element anhand seiner ID aus einer SharePoint-Liste ab.

Elemente abrufen

Ruft Elemente aus einer SharePoint-Liste ab. Weitere Informationen zu dieser Aktion finden Sie unter: Ausführliche Analyse in Elemente abrufen und SharePoint-Dateien abrufen-Aktionen für Flows in Power Automate.

Abrufen von Listenansichten

Ruft Ansichten aus einer SharePoint-Liste ab.

Listen abrufen

Ruft SharePoint-Listen von einer Website ab.

Gewähren des Zugriffs auf ein Element oder einen Ordner

Gewährt bestimmten Personen Zugriff auf ein Element oder einen Ordner in SharePoint.

Beitreten zur Hubwebsite

Verknüpft die angeforderte Website mit der Hubwebsite. Ein Genehmigungstoken ist erforderlich, um den Join erfolgreich abzuschließen, wenn für diesen Hub eine Genehmigung erforderlich ist. Geben Sie ggf. dieselbe Genehmigungskorrelations-ID an, die in der Aktion Hubwebsitejoin festlegen status auf ausstehende Aktion verwendet wurde.

Listenordner

Gibt Dateien zurück, die in einem SharePoint-Ordner enthalten sind.

Stammordner auflisten

Gibt Dateien im SharePoint-Stammordner zurück.

Datei verschieben

Verschiebt eine Datei. Funktioniert ähnlich wie der Befehl Verschieben in SharePoint-Bibliotheken. Gibt Nach dem Verschieben Informationen zur neuen Datei zurück.

Ordner verschieben

Verschiebt einen Ordner. Funktioniert ähnlich wie der Befehl Verschieben in SharePoint-Bibliotheken. Gibt Nach dem Verschieben Informationen zum neuen Ordner zurück.

Person auflösen

Gibt einen einzelnen übereinstimmenden Benutzerwert zurück, damit er einer Spalte vom Typ Person zugewiesen werden kann. Wenn keine Übereinstimmungen oder mehrere Übereinstimmungen vorhanden sind, tritt bei dieser Aktion ein Fehler auf.

Senden einer HTTP-Anforderung an SharePoint

Erstellt eine aufzurufende SharePoint-REST-API. Weitere Informationen zu dieser Aktion finden Sie unter Arbeiten mit der SharePoint-Aktion HTTP-Anforderung senden in Power Automate.

Wichtig

Diese Aktion kann jede SharePoint-REST-API ausführen, auf die Sie Zugriff haben. Gehen Sie mit Vorsicht vor.

Festlegen des Inhaltsgenehmigungsstatus

Legt die Inhaltsgenehmigung status für ein Element in einer Liste oder Bibliothek fest, für die die Inhaltsgenehmigung aktiviert ist. Sie müssen ein ETag für Seiten und Dateien bereitstellen. Sie können das ETag mithilfe der Aktion Dateimetadaten abrufen abrufen. Diese Aktion ist nur für SharePoint Online und SharePoint 2019 verfügbar.

Festlegen von hub site join status auf Ausstehend

Legt die Hubjoinanforderung der angeforderten Website status auf Ausstehend fest. Die Genehmigungskorrelations-ID ist ein optionaler Parameter, mit dem SharePoint eine bestimmte Hubjoinanforderung identifizieren kann. Die anfordernde Website kann nur eine ausstehende Anforderung zu einem bestimmten Zeitpunkt haben.

Beenden der Freigabe eines Elements oder einer Datei

Löscht alle Links, die Zugriff auf ein Element oder eine Datei gewähren, und entfernt alle Personen mit direktem Zugriff mit Ausnahme von Besitzern.

Datei aktualisieren

Updates den Inhalt der Datei, die durch den Dateibezeichner angegeben wird.

Aktualisieren von Dateieigenschaften

Updates die in Spalten in einer Bibliothek gespeicherten Eigenschaften für das durch die Element-ID angegebene Element. Verwenden Sie zum Aktualisieren von Dateiinhalten die Aktion Datei aktualisieren . Wenn Sie dies mit dem lokalen Datengateway verwenden, müssen Sie möglicherweise manuell den Namen der Bibliothek eingeben, mit der eine Verbindung hergestellt werden soll.

Element aktualisieren

Updates eines Elements in einer SharePoint-Liste.

Unterstützung für SharePoint Server

In den folgenden Tabellen sind alle Aktionen und Trigger aufgeführt, die für SharePoint Lokal 2013, 2016 oder 2019 unterstützt werden. Nicht erwähnte Aktionen oder Trigger werden nicht unterstützt.

Unterstützte Trigger

Auslöser SharePoint 2013 SharePoint 2016 SharePoint 2019
Wenn eine Datei in einem Ordner erstellt wird Ja Ja Ja
Wenn eine Datei in einem Ordner erstellt oder geändert wird Ja Ja Ja
Wenn ein Element erstellt wird Ja1 Ja1 Ja1
Wenn ein Element erstellt oder geändert wird Ja1 Ja1 Ja1
Wenn eine Datei erstellt wird (nur Eigenschaften) Nein Nein Ja1
Wenn eine Datei erstellt oder geändert wird (nur Eigenschaften) Nein Nein Ja1
Wenn ein Element gelöscht wird Nein Nein Ja2
Wenn eine Datei gelöscht wird Nein Nein Ja2
Person auflösen Nein Nein Ja
Festlegen des Inhaltsgenehmigungsstatus Nein Nein Ja

Hinweis

  1. "Spalten nach Ansicht einschränken" wird nicht unterstützt.
  2. Obwohl dieser Trigger für SharePoint 2019 unterstützt wird, können bei Flows, die mit diesem Trigger erstellt wurden, die folgenden Probleme auftreten:
    • Wenn die Liste seit mehr als 60 Tagen keine Aktivität enthält oder eine Aktivität vorhanden ist, aber seit mehr als 60 Tagen keine Elemente gelöscht werden, kann der Trigger nicht aktiviert werden.
    • Durch das Löschen von Listenelementen durch den Systembenutzer wird der Trigger aktiviert.

Unterstützte Aktionen

Aktion SharePoint 2013 SharePoint 2016 SharePoint 2019
Abrufen der Dateimetadaten Ja Ja Ja
Abrufen von Dateimetadaten mithilfe des Pfads Ja Ja Ja
Abrufen von Ordnermetadaten Ja Ja Ja
Abrufen von Ordnermetadaten mithilfe des Pfads Ja Ja Ja
Abrufen von Dateiinhalten Ja Ja Ja
Datei erstellen Ja1 Ja1 Ja1
Datei aktualisieren Ja Ja Ja
Datei kopieren [veraltet]2 Ja Ja Ja
Listenordner Ja Ja Ja
Ordner extrahieren Ja Ja Ja
Abrufen von Anlagen Ja Ja Ja
Anlage hinzufügen Ja Ja Ja
Anlage löschen Ja Ja Ja
Elemente abrufen Ja3 Ja3 Ja3
Element abrufen Ja4 Ja4 Ja4
Element erstellen Ja4 Ja4 Ja4
Element aktualisieren Ja4 Ja4 Ja4
Element löschen Ja Ja Ja
Senden einer HTTP-Anforderung an SharePoint Ja Ja Ja

Hinweis

  1. Das Erstellen einer großen Datei durch Hochladen als Gruppe von Blöcken wird nicht unterstützt.
  2. Diese Aktion enthält "[veraltet]" im Anzeigenamen. Die Aktion "Datei kopieren" unterscheidet sich von dieser Aktion.
  3. Diese Aktion unterstützt nur OData-Parameter, die Parameter wie "Einträge auf Ordner beschränken", "Geschachtelte Elemente einschließen" und "Spalten nach Ansicht beschränken" ausschließen.
  4. "Spalten nach Ansicht einschränken" wird nicht unterstützt.

Veraltete Trigger und Aktionen

Diese Trigger sind veraltet und werden nicht mehr aktiv verwaltet. Sie sind zwar noch im Microsoft SharePoint Connector vorhanden, es wird jedoch empfohlen, in neuen Anwendungen oder Lösungen keine veralteten Trigger oder Aktionen zu verwenden.

Name Typ Unterstützte Version Vorgeschlagene Alternative
Wenn eine Datei in einem Ordner erstellt wird [veraltet] Auslöser SharePoint 2019 Wenn eine Datei erstellt wird (nur Eigenschaften)
Wenn eine Datei in einem Ordner erstellt oder geändert wird [veraltet] Auslöser SharePoint 2019 Wenn eine Datei erstellt oder geändert wird (nur Eigenschaften)
Datei kopieren [veraltet] Aktion SharePoint 2019 Datei kopieren

Bekannte Einschränkungen

Unterstützte Listen- und Bibliotheksvorlagen

Power Automate-Flows für Listen werden nur in generischen Listen (100) und generischen Dokumentbibliotheken (101) unterstützt. Benutzerdefinierte Listen- und Bibliotheksvorlagen, einschließlich, aber nicht beschränkt auf Listen wie Ankündigungen, Kontakte und Aufgaben, werden derzeit nicht unterstützt.

Flowausführungen

Wenn Sie einen Power Automate-Flow erstellen, der für ein Element oder zum Erstellen oder Ändern einer Datei ausgelöst werden soll, überprüft Power Automate in regelmäßigen Abständen nach Änderungen in der Liste oder Bibliothek, die im Trigger des Flows konfiguriert sind. In den meisten Fällen kann die Flowausführung bei einer einzelnen Änderung in der Liste oder Bibliothek innerhalb von Minuten nach dieser Änderung erfolgen. Erwarten Sie jedoch, dass der Flow aufgrund der Zeit zwischen dem Flussintervall seit seiner letzten gültigen Änderung oder nachfolgenden Änderungen an einem Element oder einer Datei mehr als eine Änderung in nachfolgenden Flowausführungen erfassen kann.

Verschieben von Dateien und Flowausführungen

Wenn Sie eine oder mehrere Dateien aus einer Dokumentbibliothek in eine andere verschieben, wird die ursprüngliche Datei aus der Quellbibliothek in die Zielbibliothek verschoben. Durch das Verschieben der Datei werden keine benutzerdefinierten Metadaten geändert, auch wenn die Datei erstellt und geändert wurde. Daher löst diese Aktion keine Flows für die Dateiupdates aus, die der Bibliothek zugeordnet sind, in die sie verschoben wurde.

Synchronisieren von Dateien mit Ihren OneDrive for Business und SharePoint-Dokumentbibliotheken

Wenn Benutzer eine oder mehrere Dateien aus einer Dokumentbibliothek mit einer anderen synchronisieren, wird die ursprüngliche Datei von Ihrem Client in die Zielbibliothek verschoben (synchronisiert). Durch die Synchronisierung der Datei werden keine benutzerdefinierten Metadaten geändert, auch wenn die Datei erstellt und geändert wurde. Daher löst diese Aktion keine Flows für diese Dateisynchronisierungen in dieser Bibliothek oder in Ihrem OneDrive for Business aus.

Unterstützte Nachschlagespalten

Wenn Ihre Liste/Bibliothek Nachschlagespalten enthält, unterstützen die Aktionen Elemente abrufen und Dateien abrufen das Zurückgeben von Elementen mit maximal 12 Nachschlagespalten. Wenn Ihre Liste oder Bibliothek diesen Schwellenwert überschreitet, schlägt der Flow in Power Automate fehl.