For Each File/Folder

UiPath.MicrosoftOffice365.Activities.Files.ForEachFileFolder

Description

Utilise l'API de recherche Microsoft Graph pour effectuer une recherche avancée ou l'API de recherche d'éléments Microsoft Graph 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é

• 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 String et les valeurs au format chaîne.

Entrée

• Recherche avancée : la requête KQL pour les fichiers et dossiers à récupérer.
  Remarque :

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

• 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 String et les valeurs au format chaîne.
• Utiliser la recherche simple - Lorsqu'elle 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 l’option Utiliser la recherche simple est sélectionnée, la propriété Référentiel de fichiers ne prend en charge que les options OneDrive, SharePoint et 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 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 String et les valeurs 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 String et les valeurs 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.
• Limit To First - The maximum number of files and folders to return. If left blank, it retrieves all files and folders matching the filter criteria. This field supports only integer and Int32 variables. The default value is 200.
• Trim Duplicates - Specifies whether duplicate file/folder items should be removed from the search results. This field only supports Boolean values (True, False). The default value is False.
• Éléments à renvoyer : Indiquez si vous souhaitez renvoyer uniquement les fichiers, uniquement les dossiers ou les deux :
  • Fichiers et dossiers
  • Fichiers
  • Dossiers

Sortie

• Index - A zero-based index that specifies which element of the current collection is being iterated. This field supports only integer and Int32 variables.

Référentiel

• Files Repository - The files repository where to search for files and folder. Select one of four options: All, OneDrive, SharePoint, SpecificUrl. The default value is All.

• 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 site SharePoint : l’URL du 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 String et les valeurs au format chaîne.

  Remarque :

  Sometimes Microsoft Search API returns duplicate file or folder items. By selecting the option Trim Duplicates, the activity removes duplicates from the search results.

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 avec le nom "Agenda Brief.xlsx"	"filename:""Agenda Brief.xlsx"""
Tous les fichiers Excel avec le mot "users" dans le nom du fichier	"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 ayant été explicitement partagés avec "Cory Belcher"	"sharedwithusersowsuser:""Cory Belcher"""