For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Beschreibung

Verwendet die Microsoft Graph Microsoft Search- API (für die erweiterte Suche) oder die Microsoft Graph Search Items -API (für die einfache Suche), um eine Aktivität oder eine Reihe von Aktivitäten für jede Datei/jeden Ordner auszuführen, die/der den Filterkriterien entspricht.

Weitere Informationen zur Microsoft Search-API-Implementierung finden Sie in den folgenden Ressourcen:

• Übersicht über die Microsoft Search-API
• Microsoft Search API zum Durchsuchen von Inhalten in OneDrive und SharePoint
• Durchsuchbare Websiteeigenschaften

Hinweis:

Diese Aktivität unterstützt keine Persistenz.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Im Textkörper der Aktivität

• For each – Geben Sie einen Namen ein, der für die aktuelle Datei in der Iteration verwendet werden soll. Die Verwendung eines Namens, der den Dateityp im Ordner beschreibt, erleichtert das Identifizieren und Auswählen der Option für die aktuelle Datei beim Konfigurieren von Aktivitäten, die in „For Each File in Folder“ eingefügt werden. Beispiel: Für einen Ordner, der Berichte enthält, können Sie Report eingeben. Der Standardwert ist DriveItem.

Eigenschaften-Panel

Allgemein

• Anzeigename – Der Name der Aktivität im Designerbereich. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Erweiterte Suche – Die KQL-Abfrage für die abzurufenden Dateien und Ordner.
  Hinweis:

  Die Aktivität verwendet die Eigenschaftsbeschränkung documentLink mit einer URL, die aus dem im Files-Repository angegebenen Speicherort und dem Wert im Ordner- Parameter erstellt wurde. Verwenden Sie nicht die Eigenschaftsbeschränkung „documentLink:“ oder „path:“ im AdvancedSearch- Parameter.

• Einfache Suche - Der Abfragetext, der zur Suche nach Dateien und Ordnern in mehreren Feldern wie Dateiname und Dateiinhalt verwendet wird. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Einfache Suche verwenden – Wenn diese Option aktiviert ist, wird die einfache Suche anstelle der erweiterten Suche verwendet. Wenn diese Option aktiv ist, wird der Parameter Unterordner einbeziehen ignoriert. Dieses Feld unterstützt nur boolesche Werte.
  Hinweis:

  Wenn Einfache Suche verwenden ausgewählt ist, unterstützt die Eigenschaft Dateien-Repository nur die Optionen OneDrive, SharePoint und Bestimmte URL . Die Aktivität kann jetzt mit persönlichen Microsoft-Konten und mit den Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate verwendet werden ( bei Verwendung innerhalb der Aktivität Microsoft Office 365 Scope ), wenn die Option Einfache Suche verwenden aktiviert ist.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• Konto – Die ID oder der Benutzerprinzipalname für den Benutzer, der die OneDrive-Instanz besitzt. Dieser Parameter muss für die Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate festgelegt werden. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Ordner – Der Pfad zu einem Ordner innerhalb des angegebenen Dateien-Repositorys, in dem gesucht werden soll (z. B SomeFolder oder SomeFolder/AnotherFolder). Wenn leer gelassen, wird der Stammordner durchsucht. Wird nicht berücksichtigt, wenn Files Repository auf All festgelegt ist. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• Unterordner mit einbeziehen – Gibt an, ob die Suche erweitert werden soll, um alle Unterordner des ausgewählten Cloud-Speicherorts einzuschließen. Dieses Feld unterstützt nur boolesche Werte.
• Limit To First - The maximum number of files and folders to return. If left blank, it retrieves all files and folders matching the filter criteria. This field supports only integer and Int32 variables. The default value is 200.
• Trim Duplicates - Specifies whether duplicate file/folder items should be removed from the search results. This field only supports Boolean values (True, False). The default value is False.
• Was zurückgegeben werden soll – Wählen Sie aus, ob nur Dateien, nur Ordner oder beides zurückgegeben werden soll:
  • Dateien und Ordner
  • Dateien
  • Ordner

Ausgabe

• Index - A zero-based index that specifies which element of the current collection is being iterated. This field supports only integer and Int32 variables.

Repository

• Files Repository - The files repository where to search for files and folder. Select one of four options: All, OneDrive, SharePoint, SpecificUrl. The default value is All.

• SharePoint-Dokumentbibliothek – Die Dokumentbibliothek innerhalb der angegebenen SharePoint-Website. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

• SharePoint-Website-URL – Die URL einer SharePoint-Website, auf der gesucht werden soll. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.

• Spezifische URL – Die URL eines bestimmten Speicherorts, an dem gesucht werden soll. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

  Hinweis:

  Sometimes Microsoft Search API returns duplicate file or folder items. By selecting the option Trim Duplicates, the activity removes duplicates from the search results.

Filterbeispiele

Die folgende Tabelle zeigt Beispiele für Filter, die bei der Abfrage von Dateien oder Ordnern nützlich sein können:

Abfrage	Filterausdruck
Alle Excel-Dateien am angegebenen Speicherort	"fileextension:xlsx"
Alle Dateien im Text- und portablen Dokumentformat am angegebenen Speicherort	"fileextension:txt OR fileextension:pdf"
Alle Dateien mit dem Namen "Agenda Brief.xlsx"	"filename:""Agenda Brief.xlsx"""
Alle Excel-Dateien mit dem Wort "users" im Dateinamen	"fileextension:xlsx AND filename:users"
Alle Excel-Dateien, die am 14.06.2021 geändert wurden, mit dem Wort "users" im Dateinamen	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Alle Excel-Dateien, die vor dem 14.06.2021 mit dem Wort "users" im Dateinamen geändert wurden	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
Alle Dateien und Ordner, die von "John Smith" vor dem 12.06.2021 erstellt wurden	"createdby:""John Smith"" AND created<06/12/2021"
Alle Dateien, die explizit freigegeben wurden für "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""