For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Beschreibung

Verwendet die Microsoft Graph-API für die Microsoft-Suche (für die erweiterte Suche) oder die Microsoft Graph-API für Suchelemente (für die einfache Suche), um eine Aktivität oder eine Reihe von Aktivitäten für jede Datei/jeden Ordner auszuführen, die 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 Keyword Query Language (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 Datei-Repository angegebenen Speicherort und dem Wert im Parameter Folder erstellt wird. Verwenden Sie nicht die Eigenschaftseinschrä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 einschließen ignoriert. Dieses Feld unterstützt boolesche Werte.

  Hinweis:

  Wenn Einfache Suche verwenden ausgewählt ist, unterstützt die Eigenschaft Datei- Repository nur die Optionen OneDrive, SharePointund Spezifische URL .

  Die Aktivität kann jetzt mit persönlichen Microsoft-Konten und mit den Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate (bei Verwendung innerhalb der Aktivität Microsoft Office 365 Scope) verwendet werden, 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 String-formatierte Werte.
• Ordner – Der Pfad zu einem Ordner innerhalb des angegebenen Datei-Repositorys, in dem gesucht werden soll (z. B SomeFolder oder SomeFolder/AnotherFolder). Wenn dieses Feld leer bleibt, wird der Stammordner durchsucht. Wird nicht berücksichtigt, wenn das Datei- Repository auf Allefestgelegt ist. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Unterordner einschließen – Gibt an, ob die Suche erweitert werden soll, um alle Unterordner des ausgewählten Cloudspeicherorts einzuschließen. Dieses Feld unterstützt boolesche Werte.
• Auf zuerst beschränken – Die maximale Anzahl der zurückzugebenden Dateien und Ordner. Wenn dieses Feld leer bleibt, werden alle Dateien und Ordner abgerufen, die den Filterkriterien entsprechen. Dieses Feld unterstützt nur Integer- und Int32 -Variablen. Der Standardwert ist 200.
• Duplikate entfernen – Gibt an, ob doppelte Datei-/Ordnerelemente aus den Suchergebnissen entfernt werden sollen. Dieses Feld unterstützt nur Boolean-Werte (True, False). Der Standardwert ist 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 – Ein nullbasierter Index, der angibt, welches Element der aktuellen Sammlung iteriert wird. Dieses Feld unterstützt nur Integer- und Int32 -Variablen.

Repository

• Datei-Repository – Das Datei-Repository, in dem nach Dateien und Ordnern gesucht werden soll. Wählen Sie eine von vier Optionen aus: All, OneDrive, SharePoint, SpecificUrl. Der Standardwert ist Alle.
• SharePoint-Dokumentbibliothek – Die Dokumentbibliothek innerhalb der angegebenen SharePoint-Site. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• SharePoint-Site- URL – Die URL einer SharePoint-Site, in der gesucht werden soll. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Spezifische URL – Die URL eines bestimmten Speicherorts, an dem gesucht werden soll. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
  Hinweis: Manchmal gibt die Microsoft Search-API doppelte Datei- oder Ordnerelemente zurück. Wenn Sie die Option Duplikate trimmenauswählen, entfernt die Aktivität Duplikate aus den Suchergebnissen.

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 mit dem Wort „Benutzer“ im Dateinamen geändert wurden	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Alle Excel-Dateien, die vor dem 14.06.2021 mit dem Wort „Benutzer“ 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 für „Cory Belcher“ freigegeben wurden	"sharedwithusersowsuser:""Cory Belcher"""