DEPRECATED

Find Files And Folders

UiPath.MicrosoftOffice365.Activities.Files.FindFilesAndFolders

Description

Utilise les API Microsoft Graph Search items et Shared files pour rechercher les fichiers, les métadonnées et/ou le contenu qui correspondent aux valeurs de vos paramètres de recherche (Query). Par défaut, cette activité recherche votre OneDrive connecté. Vous avez la possibilité de remplacer votre emplacement de recherche par un site SharePoint (DriveName et SiteURL).

Après avoir effectué la recherche, l'activité renvoie les objets DriveItem correspondants (Premier et Résultats) que vous pouvez utiliser comme variables d'entrée dans les activités suivantes ; presque toutes les activités Excel et Fichiers l'exigent comme variable d'entrée.

Cette activité est limitée à 200 résultats. Si vous travaillez avec davantage de fichiers, utilisez l'activité Pour chaque fichier/dossier (For Each File/Folder) .

Remarque : Rechercher des fichiers et des dossiers ne prend pas en charge l'autorisation d'application Sites.Selected .

Étendues

Cette activité nécessite les étendues suivantes :

• Sites.Lus.Tous

OU

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Propriétés

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

Entrée

• Requête : définit l'expression de recherche en texte libre pour les fichiers ou dossiers à récupérer. Si ce champ est laissé vide, le contenu du dossier racine est renvoyé. Pour obtenir la liste complète des paramètres de requête pris en charge, consultez Propriétés de l'élément du lecteur dans la documentation de l'API Microsoft. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• Sous-dossier - (Facultatif) Chemin d'accès d'un sous-dossier dans lequel effectuer une recherche (par exemple, SomeFolder ou SomeFolder/Another/OneMore). Si laissé vide. le dossier racine est recherché. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

Options

• Compte - ID ou nom d'utilisateur principal de l'utilisateur propriétaire de OneDrive. Ce paramètre doit être défini pour les types d'authentification ApplicationIdAndSecret et ApplicationIdAndCertificate.

Divers

• Privé (Private) : si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose). Ce champ prend en charge les valeurs booléennes.

Sortie

• Premier (First ) : le premier fichier ou dossier correspondant à la requête spécifiée. Ce champ ne prend en charge que DriveItem variables. Obligatoire si vous prévoyez d'utiliser les données de sortie dans des activités ultérieures. Le DriveItem contient des informations sur le fichier, notamment son nom, sa taille, son type, etc., que vous pouvez utiliser dans des activités ultérieures.
• Résultats : tous les fichiers et dossiers correspondant à la requête renvoyés sous la forme d'un tableau d'élémentsDrive. Les DriveItems contiennent des informations telles que le nom de fichier, le type, la taille, l'ID, etc., et peuvent être utilisés dans des activités ultérieures. Lorsque vous utilisez la variable Résultats DriveItem dans d'autres activités, spécifiez l'élément du tableau que vous souhaitez utiliser (par exemple, myFiles(0)).

Sharepoint

• Nom dulecteur (Drive Name) - Le nom du lecteur dans OneDrive ou SharePoint recherché pour les fichiers ou dossiers indiqués. Si ce lecteur existe dans SharePoint, l'URL du site doit être spécifiée. Si ce champ est laissé vide, la recherche est effectuée dans le lecteur par défaut (généralement « Documents ») du site SharePoint spécifié dans le champ URL du site. Cette propriété prend en charge les variables de tableau de type chaîne String et les valeurs de tableau au format chaîne.
• URL du site - SharePoint dont les fichiers ou dossiers indiqués sont recherchés. Obligatoire uniquement lors de la recherche dans SharePoint. Par exemple, si vous souhaitez effectuer une recherche dans les documents de votre site SharePoint, l'URL de votre site peut être « https://uipath.sharepoint.com/sites/Quickstart » et le nom de votre lecteur serait « Documents ». Cette propriété prend en charge les variables de String et les valeurs au format chaîne.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Effectuez les étapes.
2. Ajoutez l’activité Étendue Microsoft Office 365 à votre projet.
3. Ajoutez l’activité Télécharger le fichier (Download File) à l’intérieur de l’activité Étendue Microsoft Office 365.
4. Entrez des valeurs pour les propriétés d'entrée.
5. Créez et entrez les variables DriveItem et DriveItem[] pour les propriétés de sortie.

6. Exécutez l’activité.

   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API SearchItems.
   • L'API renvoie les valeurs DriveItem et DriveItem[] à votre variable de propriété de sortie.