For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolderConnections

Beschreibung

Durchläuft eine Liste von Dateien und Ordnern von OneDrive oder SharePoint.

Fügen Sie die zu wiederholenden Aktivitäten in For Each File/Folder hinzu und wählen Sie beim Konfigurieren der Aktivitäten Variable verwenden > CurrentItem im Schaltflächenmenü Mehr anzeigen aus, um anzugeben, dass Sie die Aktionen für jedes Element in der Iteration wiederholen möchten.

Hinweis: Diese Aktivität verwendet die Paginierung, um eine große Anzahl von Elementen zu verarbeiten und Leistungsprobleme zu vermeiden. Diese Aktivität unterstützt keine Persistenz.

Wichtig: Die Microsoft Graph-API unterscheidet nicht zwischen Ordnern und OneNote-Dateien, daher werden beide zurückgegeben.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

Files.Read
Files.ReadWrite
Files.Read.All
Files.ReadWrite.All
Sites.Read.All
Sites.ReadWrite.All

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

Microsoft OneDrive und SharePoint-Verbindung – Die Verbindung für das Microsoft 365-Konto, das in der Aktivität verwendet werden soll.
An Speicherort – Der Speicherort, an dem nach Dateien und Ordnern gesucht werden soll. Die Methode zum Angeben der abzurufenden Datei oder des abzurufenden Ordners: ID eingeben, URL eingeben oder Variable verwenden.
- Ordnerauswahl- Option – Durchsuchen Sie die OneDrive- oder SharePoint-Ordner und wählen Sie eine Datei oder einen Ordner aus. Dieses Feld akzeptiert nur IResource -Eingaben.
- Option „ID eingeben “:
  - Datei- oder Ordner-ID – Die ID der Datei oder des Ordners. Um die ID abzurufen, öffnen Sie die Datei in OneDrive Web und rufen Sie die URL ab. Die ID ist in der URL codiert. Beispiel: Wenn die URL https://yourcompany.sharepoint.com/Doc.aspx?sourcedoc=%7BA1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85%7D&file=Merge_sheets.xlsx ist, ist die decodierte Datei-ID A1CA7E78-BA59-4DD4-A6B9-5F5BBC37FA85. %7B und %7D sind die Trennzeichen um die Datei-ID. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
  - SharePoint-Websiteadresse – Die URL der SharePoint-Website, die die Datei oder den Ordner enthält. Öffnen Sie Ihre SharePoint-Website in einem Browser und rufen Sie die URL ab, z. B. https://yourCompany.sharepoint.com/sites/Marketing. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
  - SharePoint-Dokumentbibliothek – Die Dokumentbibliothek innerhalb der angegebenen SharePoint-Website, die die Datei oder den Ordner enthält. Öffnen Sie Ihre SharePoint-Website in einem Browser, wechseln Sie zur Registerkarte Dokumente und rufen Sie die URL ab, z. B. https://yourCompany.sharepoint.com/sites/Marketing/Shared%20Documents/Forms/AllItems.aspx. Diese Eigenschaft unterstützt String-Variablen und String-formatierte Werte.
- Option URL eingeben:
  - Datei- oder Ordner-URL – Die URL der Datei oder des Ordners. Öffnen Sie die Datei oder den Ordner im Browser und rufen Sie die URL ab. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
- Verwenden Sie die Option Mehr anzeigen um eine Variable zu verwenden, oder wählen Sie die Option Ordnerauswahl neu laden aus, wenn Sie Ihre Ordner geändert haben und die neuesten Daten abrufen müssen.

Zusätzliche Optionen

Optionen

Auf erste beschränken – Die maximale Anzahl der zurückzugebenden Dateien und Ordner. Wenn leer gelassen, gibt es keine Beschränkung. Dieses Feld unterstützt Int32-Variablen und Int32-Werte.
Was zurückgegeben werden soll – Die Typen der Ergebnisse, die zurückgegeben werden sollen: Dateien und Ordner, nur Dateien, nur Ordner.
Duplikate trimmen – Boolescher Wert. Auf True festlegen, um doppelte Dateien und Ordner aus den Suchergebnissen zu entfernen.
Einfache Suche - Der Abfragetext, der zur Suche nach Dateien und Ordnern in mehreren Feldern (z. B. Dateiname oder Dateiinhalt) verwendet wird. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte. Verwenden Sie das Schaltflächenmenü Mehr sehen, um zur erweiterten Suche zu wechseln.
Hinweis: Die einfache Suche ist für Geschäftskonten und persönliche Konten verfügbar. Dieerweiterte Suche ist nur für Geschäftskonten verfügbar und enthält die Option Unterordner einschließen.
Erweiterte Suche – Ein erweitertes Suchkriterium, das definiert wird, um die Dateien und Ordner zu filtern. Diese Option wird nicht für persönliche Microsoft-Konten unterstützt. Die erweiterte Suche verwendet den Filtergenerator, um die Suchkriterien zu konfigurieren.
- Unterordner einschließen – Boolescher Wert. Auf True festlegen, um die Suche auf alle Unterordner am ausgewählten Speicherort zu erweitern.

Ausgabe

Gesamtzahl der verarbeiteten Dateien oder Ordner – Die Gesamtzahl der von der Aktivität verarbeiteten Elemente. Kann außerhalb der Aktivität For Each File/Folder verwendet werden. Automatisch generierte Ausgabevariable. Sie können ihn so verwenden, wie er ist, oder unter einem anderen Namen speichern.

Text

Der Text der Aktivität, in dem andere Aktivitäten gespeichert werden, die in der Automatisierung verwendet werden.

Einschränkungen beim Filtern

Das Filtern nach Dateierweiterung im Filter-Generator funktioniert möglicherweise nicht für Erweiterungen wie .avi, SVG-, .gif-, .ico, JPEG, .jpg, .mov, .mp3, .mp4, OGG, PNG, RTF-, TIFF-, .wav-, .webm-, .webp, oder .wmv-Datei.
Das Filtern nach „ Zuletzt geändert von “ oder „Für Benutzer freigegeben“ gibt möglicherweise unvollständige Ergebnisse zurück.
Die Graph-API schneidet Sonderzeichen ab dem Anfang eines gesuchten Werts ab. Wenn Sie beispielsweise nach „_Sorted“ suchen, gibt die API alle Dateien/Ordner zurück, deren Name das Wort „Sorted“ enthält, wobei das Zeichen „_“ weggelassen wird.
Beim Durchlaufen von Dateien im OneDrive-Stammordner mithilfe der erweiterten Suche ohne konfigurierte Filter und auch wenn für Unterordner einschließen Falsefestgelegt ist, gibt die Aktivität möglicherweise alle OneDrive-Dateien zurück, anstatt nur die Dateien des OneDrive-Stammordners.
Aufgrund einer Microsoft-Einschränkung identifiziert die einfache Suche keine Bilddateien.Verwenden Sie stattdessen die erweiterte Suche und filtern Sie nach: File or folder name contains .jpg.