Microsoft SharePoint Connector in Power Automate
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.
Erstellen eines Freigabelinks für eine Datei oder einen Ordner
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
- "Spalten nach Ansicht einschränken" wird nicht unterstützt.
- 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
- Das Erstellen einer großen Datei durch Hochladen als Gruppe von Blöcken wird nicht unterstützt.
- Diese Aktion enthält "[veraltet]" im Anzeigenamen. Die Aktion "Datei kopieren" unterscheidet sich von dieser Aktion.
- 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.
- "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.