DEPRECATED

Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Beschreibung

Verwendet die Microsoft Graph Search-Elemente und Shared Files -APIs, um die Dateien, Metadaten und/oder Inhalte zu finden, die mit den Werten Ihrer Suchparameter (Query) übereinstimmen. Standardmäßig durchsucht diese Aktivität Ihr verbundenes OneDrive. Sie haben die Möglichkeit, Ihren Suchspeicherort in eine SharePoint-Site (DriveName und SiteURL) zu ändern.

Nach der Suche gibt die Aktivität die übereinstimmenden DriveItem -Objekte (First und Results) zurück, die Sie als Eingabevariablen in nachfolgenden Aktivitäten verwenden können; Fast alle „ Excel “- und „Dateien“-Aktivitäten erfordern dies 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.

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 Freitextsuchbegriff für die abzurufenden Dateien oder Ordner. Wenn das Feld leer bleibt, wird der Inhalt des Stammordners zurückgegeben. Eine vollständige Liste der unterstützten Abfrageparameter finden Sie unter den Eigenschaften des Laufwerkelements in der Microsoft API-Dokumentation. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte 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. Führen Sie die Schritte aus.
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.