Get File/Folder

UiPath.MicrosoftOffice365.Activities.Files.GetItem

Description

Utilise l'API Get item Microsoft Graph pour obtenir les métadonnées d'un élément spécifié avec un ID connu (IDÉlément). Pour obtenir l'ID de l'élément, vous pouvez utiliser une activité qui génère un objet DriveItem (par exemple, Find Files And Folders).

Après avoir localisé l'élément, l'activité renvoie ses métadonnées dans un nouvel objet DriveItem (Item) que vous pouvez utiliser dans les activités suivantes.

Étendues

Cette activité nécessite les étendues suivantes :

• Sites.Lus.Tous

OU

• Sites.Lecture.Écriture.Tout

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Dans le corps de l’activité

• Fichier ou dossier : le fichier ou dossier cible. Cliquez sur Parcourir à côté du champ, puis recherchez et sélectionnez le dossier ou le fichier. 
• Saisir l'ID : pour obtenir l'ID, entrez une variable de sortie DriveItem à partir d'une dépendance d'activité (par exemple, Find Files And Folders, Copy File/Folder, Create Folder). Lors de la saisie de la variable DriveItem , obtenez l'ID de l'objet en ajoutant ".Id" à la fin de la variable (par exemple, firstFolderFound.Id). Cette propriété prend en charge les variables de String et les valeurs au format chaîne.
• Saisir l'URL - URL de l’élément Drive du fichier ou du dossier d’intérêt. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

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

• ID de l'élément - ID ÉlémentDrive du fichier ou du dossier d'intérêt. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.
• URL de l'élément - URL de l’élément Drive du fichier ou du dossier d’intérêt. Cette propriété prend en charge les variables de chaîne String et les valeurs au format chaîne.

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.

Sortie

• Élement - Fichier ou dossier d'intérêt en tant qu'ÉlémentDrive.

Sharepoint

• Nom du lecteur (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 String et les valeurs au format chaîne.
• URL dusite : l'URL du site SharePoint recherché pour les fichiers ou dossiers indiqué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 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 une activité ou exécutez un processus externe qui génère un objet DriveItem (par exemple, Find Files and Folders, Create Workbook, Copy File/Folder).
4. Ajoutez l’activité Ajouter un participant à l’activité Étendue Microsoft Office 365.
5. Entrez des valeurs pour les propriétés d'entrée.
6. Créez et entrez une variable DriveItem pour votre propriété Output (Sortie).

7. Exécutez l’activité.

   • Les valeurs de vos propriétés d'entrée sont envoyées à l'API GetItem .
   • L'API renvoie la valeur DriveItem à votre variable de propriété de sortie.