Le robot utilise l'activité Lister le répertoire pour ouvrir une application qui contient des nœuds <élément> pour chaque objet du répertoire et certaines propriétés principales de cet objet. L'application est statique et ne met pas à jour le contenu du répertoire lorsqu'il change. Pour mettre à jour le contenu, votre robot peut soit fermer l'application et la rouvrir, soit utiliser l'activité Actualiser pour réanalyser le contenu du répertoire.

L'activité Lister le répertoire ouvre une nouvelle application. L'activité fournit un paramètre Nom d'application obligatoire pour définir l'attribut nom sur l'application.

Si une erreur se produit dans une activité, elle produit une exception DeviceIssue. Ces erreurs peuvent être détectées à l'aide de l'étape Tentative-Récupération. Vous pouvez utiliser l'activité Obtenir la dernière erreur pour récupérer une erreur émise par la dernière activité effectuée par le pilote du système de fichiers.

Activité

• Lister le répertoire : Ouvre une nouvelle application représentant le contenu du répertoire. Notez que cette activité peut prendre beaucoup de temps.

  Spécifiez les paramètres Accès au fichier, Répertoire et Nom d'application.

• Supprimer le fichier : Supprime un fichier.

  Spécifiez les paramètres Accès au fichier et Fichier.

• Créer un répertoire : Crée un répertoire avec le nom spécifié. Cette activité utilise la sémantique de création de répertoire du stockage sous-jacent.

  Spécifiez les paramètres Accès au fichier et Répertoire.

• Supprimer le répertoire : Supprime un répertoire. En fonction du stockage sous-jacent, cette activité peut échouer si le répertoire n'est pas vide.

  Spécifiez les paramètres Accès au fichier et Répertoire.

• Existe : Teste si un objet existe et renvoie le résultat sous forme booléenne.

  Spécifiez les paramètres Accès au fichier et Élément, ainsi qu'une variable pour stocker le résultat dans le champ Résultat.

• Copier le fichier : Copie un fichier vers un nouvel emplacement et peut être utilisé pour copier des fichiers entre RFS (Système de fichiers du robot) et le système de fichiers local. Les paramètres Source et Destination doivent inclure le nom du fichier. Cette activité utilise la sémantique de copie du stockage sous-jacent.

  Spécifiez les paramètres Source et Destination, en utilisant les chemins d'accès avec les noms de fichier, ainsi que le paramètre Accès au fichier.

  Si vous souhaitez copier le fichier C:\a\b\c.txt dans le répertoire D:\destination, le champ Source doit contenir C:\a\b\c.txt et le champ Destination doit contenir D:\destination\c.txt. Si vous omettez le nom de fichier dans le champ Destination ou si le répertoire de destination n'existe pas, les résultats peuvent être imprévisibles.

• Déplacer : Déplace ou renomme un objet. Les paramètres Source et Destination doivent inclure le nom de l'objet. Cette activité ne peut pas être utilisée pour déplacer des objets entre RFS (Système de fichiers du robot) et le système de fichiers local. L'implémentation utilise la sémantique de déplacement du stockage sous-jacent.

  Spécifiez les paramètres Accès au fichier, Source et Destination, en utilisant les chemins d'accès avec les noms d'objet.

• Renommer : Renomme un objet à son emplacement actuel.

  Spécifiez les paramètres Accès au fichier, Élément et Nouveau nom.

• Obtenir le type : Récupère le type d'un objet. Produit une exception DeviceIssue si l'objet n'existe pas. Cette activité peut renvoyer les valeurs suivantes :

  • fichier : L'objet est un fichier.

  • répertoire : L'objet est un répertoire.

  • autre : L'objet existe, mais ce n'est ni un fichier ni un répertoire. Le type exact de l'objet dépend du stockage sous-jacent, mais il peut s'agir d'autres objets, tels que des dispositifs ou des liens symboliques.

  Spécifiez les paramètres Accès au fichier et Élément, ainsi qu'une variable pour stocker le résultat dans le champ Type.

• Obtenir le chemin d'accès : Récupère le chemin d'accès à l'élément.

• Fermer tous les répertoires : Ferme toutes les applications associées aux répertoires ouverts par le robot.

• Fermer le répertoire : Ferme l'application.

• Compteur : Compte le nombre d'objets correspondant au localisateur de composant. Cette activité peut être utilisée pour les vérifications d'existence et les recherches génériques.

• Obtenir la dernière erreur : Récupère un message d'erreur de la dernière activité effectuée par le pilote du système de fichiers.

  Spécifiez une variable dans laquelle stocker le résultat du champ Erreur.

• Actualiser : Analyse et recharge le contenu du répertoire représenté par l'application et met à jour l'arborescence.

  Notez que cette activité peut prendre beaucoup de temps.

Propriétés

• Accès au fichier : Sélectionnez Accès direct ou Via RFS.

• Répertoire : Spécifiez le chemin d'accès et le nom du répertoire.

• Fichier : Spécifiez le chemin d'accès et le nom du fichier.

• Élément : Spécifiez le chemin d'accès et le nom de l'élément.

• Nom d'application : Définissez l'attribut nom sur l'application.

• Résultats : Spécifiez la variable dans laquelle stocker le résultat de l'activité.

Chaque répertoire ouvert avec l'activité Lister le répertoire est représenté par une application avec sa propre arborescence. Les éléments de cette arborescence et leurs valeurs ne sont pas localisés, sauf indication contraire explicite. L'arborescence a la structure suivante.

Élément fs

Élément	Description
title	attribut ; titre de l'application. Ce paramètre est défini comme le chemin d'accès du répertoire.
driver	attribut ; fixe : « fs ».
name	attribut ; nom de l'application. Cet attribut est défini par l'activité Lister le répertoire ou généré lorsque le paramètre nom est omis.
directory	élément ; représente le répertoire.

élément répertoire

Élément	Description
path	attribut ; contient le chemin d'accès utilisé dans l'activité Lister le répertoire.
count	attribut ; nombre d'objets dans le répertoire.
item	élément, répétitif ; chaque élément représente un objet dans le répertoire. L'ordre de ces éléments n'est pas défini et peut changer après l'activité Actualiser.

Élément élément

Cet élément contient les éléments nœud suivants.

Élément	Description
nom	attribut ; nom de l'objet.
taille	attribut ; taille de l'objet en octets telle que rapportée par le stockage sous-jacent.
extension	attribut ; l'extension de l'objet, s'il s'agit d'un fichier, convertie en minuscules. Vide pour les répertoires.
type	attribut ; type de fichier. Soit fichier pour un fichier, répertoire pour un répertoire, ou autre pour tous les autres types d'objet.
créé	attribut ; l'heure à laquelle l'objet a été créé, telle qu'indiquée par le stockage sous-jacent. Cette valeur est représentée en heure locale sous la notation ISO 8601.
modifié	attribut ; l'heure à laquelle l'objet a été modifié pour la dernière fois, telle qu'indiquée par le stockage sous-jacent. Cette valeur est représentée en heure locale sous la notation ISO 8601.