Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Beschreibung

Verwendet die Microsoft Graph -Suchelemente und APIs für freigegebene Dateien , um die Dateien, Metadaten und/oder Inhalte zu finden, die den Werten Ihrer Suchparameter entsprechen (Abfrage). Standardmäßig durchsucht diese Aktivität Ihr verbundenes OneDrive. Sie haben die Möglichkeit, Ihren Suchort in eine SharePoint-Website (DriveName und SiteURL) zu ändern.

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

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

Hinweis: Dateien und Ordner suchen unterstützt die Anwendungsberechtigung Sites.Selected nicht.

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 leer gelassen, wird der Inhalt des Stammordners zurückgegeben. Eine vollständige Liste der unterstützten Abfrageparameter finden Sie unter Drive-Elementeigenschaften in der Microsoft API-Dokumentation. Diese Eigenschaft unterstützt String -Variablen und stringformatierte 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 zeichenfolgenformatierte 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 - Die erste Datei oder der erste Ordner, die der angegebenen Abfrage entspricht. Dieses Feld unterstützt nur DriveItem Variablen. Erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten. DriveItem enthält Informationen über die Datei, einschließlich Name, Größe, Typ usw., die Sie in nachfolgenden Aktivitäten verwenden können.
• Ergebnisse – Alle Dateien und Ordner, die der Abfrage entsprechen, die als Array von DriveItems zurückgegeben werden. DriveItems enthalten Informationen wie Dateiname, Typ, Größe, ID usw. und können in nachfolgenden Aktivitäten verwendet werden. Wenn Sie die Variable Results DriveItem in anderen Aktivitäten verwenden, geben Sie das Element im Array an, das Sie verwenden möchten (z. B. 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 String-formatierte 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 stringformatierte 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. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Fügen Sie die Aktivität Find Files And Folders innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
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.