Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Beschreibung

Wichtig:

Diese Aktivität wurde ab Version 2.7.21 als veraltet betrachtet und aus dem Paket entfernt. Es wird empfohlen, diese Aktivität stattdessen durch For Each File/Folder (klassisch) oder For Each File or Folder (Integration Service-Verbindung) zu ersetzen.

Verwendet die Microsoft Graph- Suchelemente und Freigegebene Dateien -APIs, um die Dateien, Metadaten und/oder Inhalte zu finden, die mit den Werten Ihrer Suchparameter übereinstimmen (Abfrage). Standardmäßig durchsucht diese Aktivität Ihr verbundenes OneDrive. Sie haben die Möglichkeit, Ihren Suchspeicherort auf einer SharePoint-Website (Laufwerksname und SiteURL) zu ändern.

Nach dem Durchführen der Suche gibt die Aktivität die übereinstimmenden DriveItem -Objekte zurück (Erste und Ergebnisse), die Sie in nachfolgenden Aktivitäten als Eingabevariablen verwenden können; die meisten Excel- und Dateien-Aktivitäten erfordern dies als Eingabevariable.

Diese Aktivität ist auf 200 Ergebnisse begrenzt. Wenn Sie mit mehr Dateien arbeiten, verwenden Sie die Aktivität For Each File/Folder .

Find Files and Folders doesn't support the Sites.Selected application permission.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Sites.Read.All

ODER

• Sites.ReadWrite.All

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Abfrage – Definiert den Freitext-Suchausdruck für die abzurufenden Dateien oder Ordner. Wenn keine Angabe erfolgt, wird der Inhalt des Stammordners zurückgegeben. Eine vollständige Liste der unterstützten Abfrageparameter finden Sie unter den Eigenschaften des Laufwerkselements in der Microsoft API-Dokumentation. Diese Eigenschaft unterstützt String -Variablen und String-formatierte Werte.
• Unterordner – (Optional) Der Pfad eines Unterordners, in dem gesucht werden soll (z. B SomeFolder oder SomeFolder/Another/OneMore). Wenn leer gelassen Der Stammordner wird durchsucht. Diese Eigenschaft unterstützt String -Variablen und stringformatierte 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.

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.

Ausgabe

• First - The first file or folder matching the specified query. This field supports only DriveItem variables. Required if you plan to use the output data in subsequent activities. The DriveItem contains information about the file including its name, size, type, etc., that you can use in subsequent activities.
• Results - All files and folders matching the query returned as an array of DriveItems. DriveItems contain info such as filename, type, size, ID, etc., and can be used in subsequent activities. When using the Results DriveItem variable in other activities, specify the item in the array that you want to use (e.g., myFiles(0)).

SharePoint

• Drive-Name - Der Name des Drive innerhalb der OneDrive- oder SharePoint-Instanz, die nach den angegebenen Dateien oder Ordnern durchsucht wurde. Wenn dieses Drive innerhalb von SharePoint vorhanden ist, muss SiteUrl angegeben werden. Wenn leer gelassen, wird die Suche im Standardlaufwerk (normalerweise „Dokumente“) der SharePoint-Site ausgeführt, die im Feld Site-URL angegeben ist. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Site-URL - Die URL der SharePoint-Website, die nach den angegebenen Dateien oder Ordnern durchsucht wurde. Nur bei der Suche in SharePoint erforderlich. Wenn Sie beispielsweise in den Dokumenten Ihrer SharePoint-Website suchen möchten, könnte Ihre Website-URL „ https://uipath.sharepoint.com/sites/Quickstart “ und Ihr Drive-Name „Documents“ lauten. Diese Eigenschaft unterstützt String -Variablen und String-formatierte Werte.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Add the Find Files And Folders activity inside the Microsoft Office 365 Scope activity.
4. Geben Sie Werte für die Eingabeeigenschaften ein.
5. Erstellen und geben Sie eine DriveItem und eine DriveItem[] -Variable für die Ausgabeeigenschaften ein.
6. Führen Sie die Aktivität aus.
   • Ihre Eingabeeigenschaftswerte werden an die SearchItems- API gesendet.
   • Die API gibt die Werte DriveItem und DriveItem[] an Ihre Ausgabeeigenschaftsvariable zurück.