For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Description

Utilise l'API Microsoft Graph Microsoft Search (pour la recherche avancée) ou l'API d' éléments Microsoft Graph Search (pour la recherche simple) pour effectuer une activité ou une série d'activités sur chaque fichier/dossier qui correspond aux critères de filtre.

Pour plus de détails sur l'implémentation de l'API Microsoft Search, consultez les ressources suivantes :

• Présentation de l'API Microsoft Search
• Microsoft Search API pour rechercher du contenu dans OneDrive et SharePoint
• Propriétés de site interrogeables

Remarque : cette activité ne prend pas en charge la persistance.

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Dans le corps de l’activité

• Pour chaque (For Each) - Saisir le nom par lequel faire référence au fichier actif de l'itération. L'utilisation d'un nom représentatif du type de fichier dans le dossier facilitera l'identification et la sélection de l'option « Fichier actuel » lors de la configuration des activités ajoutées dans l'activité « For Each File in Folder ». Par exemple, pour un dossier contenant des rapports, vous pouvez saisir Report. La valeur par défaut est DriveItem.

Panneau propriétés

Commun

• NomComplet (DisplayName) : le nom affiché pour l'activité dans le panneau Concepteur (Designer). Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

Entrée

• Recherche avancée : requête KQL (Keyword Query Language) pour les fichiers et dossiers à récupérer.

  Remarque :

  L'activité utilise la restriction de propriété documentLink avec une URL créée à partir de l'emplacement spécifié dans le Référentiel de fichiers ( Files Repository) et de la valeur du paramètre Dossier (Folder). N'utilisez pas la restriction des propriétés « documentLink: » ou « path : » dans le paramètre AdvancedSearch .

• Recherche simple - Saisissez le texte de la requête utilisé pour rechercher des fichiers et des dossiers dans plusieurs champs tels que le nom de fichier et le contenu du fichier. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

• Utiliser la recherche simple (Use Simple Search ) : lorsque cette option est activée, la recherche simple est utilisée à la place de la recherche avancée. Si cette option est active, le paramètre Inclure les sous-dossiers est ignoré. Ce champ prend en charge les valeurs booléennes.

  Remarque :

  Si Utiliser la recherche simple est sélectionné, la propriété Référentiel de fichiers ne prend en charge que les options OneDrive, SharePointet URL spécifique .

  L’activité peut désormais être utilisée avec des comptes Microsoft personnels et avec les types d’authentification ApplicationIdAndSecret et ApplicationIdAndCertificate (lorsqu’elle est utilisée dans l’activité Étendue Microsoft Office 365) si l’option Utiliser une recherche simple (Use simple search) est cochée.

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.

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. Cette propriété prend en charge les variables de tableau de type chaîne String et les valeurs de tableau au format chaîne.
• Dossier - Le chemin d’accès à un dossier, situé dans le référentiel de fichiers indiqué, et dans lequel la recherche doit être effectuée (par exemple SomeFolder ou SomeFolder/AnotherFolder). S’il est vide, la recherche est effectuée dans le dossier racine. Il n’est pas pris en compte si Files Repository est défini sur Tous (All). Cette propriété prend en charge les variables de tableau de type chaîne String et les valeurs de tableau au format chaîne.
• Inclure des sous-dossiers - Spécifie si la recherche doit être étendue pour inclure tous les sous-dossiers de l'emplacement cloud sélectionné. Ce champ prend en charge les valeurs booléennes.
• Limiter au premier (Limit To First) - le nombre maximal de fichiers et de dossiers à renvoyer. Si ce champ est laissé vide, tous les fichiers et dossiers correspondant aux critères de filtre seront récupérés. Ce champ ne prend en charge que les entiers et les variables Int32. La valeur par défaut est de 200.
• Supprimer les doublons - Indique si les éléments de fichiers ou de dossiers en double doivent être supprimés des résultats de la recherche. Ce champ prend uniquement en charge les valeurs booléennes Boolean (Vrai (True), Faux (False)). La valeur par défaut est False.

• Que renvoyer (What To Return ) : indiquez si vous souhaitez renvoyer uniquement les fichiers, uniquement les dossiers ou les deux :

  • Fichiers et dossiers
  • Fichiers
  • Dossiers

Sortie

• Index - Un index de base zéro qui spécifie quel élément de la collection actuelle est itéré. Ce champ prend uniquement en charge les variables entières et Int32 .

Référentiel

• Référentiel de fichiers : le référentiel de fichiers où rechercher des fichiers et des dossiers. Sélectionnez l'une des quatre options : All, OneDrive, SharePoint, SpecificUrl. La valeur par défaut est Tout.
• Bibliothèque de documents SharePoint : la bibliothèque de documents du site SharePoint spécifié. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• URL du siteSharePoint : l'URL d'un site SharePoint dans lequel effectuer la recherche. Cette propriété prend en charge les variables String et les valeurs au format chaîne.
• URL spécifique - L'URL d'un emplacement spécifique dans lequel effectuer la recherche. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.
  Remarque : Parfois, l'API Microsoft Search renvoie des éléments de fichier ou de dossier en double. En sélectionnant l'option Trim Duplicates(Trim Duplicates), l'activité supprime les doublons des résultats de la recherche.

Exemples de filtrage

Le tableau suivant montre des exemples de filtres qui peuvent être utiles lorsque vous interrogez des fichiers ou des dossiers :

Requête	ExpressionFiltre
Tous les fichiers Excel à l'emplacement spécifié	"fileextension:xlsx"
Tous les fichiers au format texte et document portable à l'emplacement spécifié	"fileextension:txt OR fileextension:pdf"
Tous les fichiers portant le nom « Agenda Brief.xlsx »	"filename:""Agenda Brief.xlsx"""
Tous les fichiers Excel dont le nom contient le mot « users »	"fileextension:xlsx AND filename:users"
Tous les fichiers Excel modifiés le 14/06/2021 avec le mot « users » dans le nom du fichier	"fileextension:xlsx AND filename:users AND lastmodifiedtime=06/14/2021"
Tous les fichiers Excel modifiés avant le 14/06/2021 avec le mot « users » dans le nom du fichier	"fileextension:xlsx AND filename:users AND lastmodifiedtime<06/14/2021"
Tous les fichiers et dossiers créés par « John Smith » avant le 12/06/2021	"createdby:""John Smith"" AND created<06/12/2021"
Tous les fichiers qui ont été explicitement partagés avec « Cory Belcher »	"sharedwithusersowsuser:""Cory Belcher"""