Activité Système de fichiers

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.

• L'ouverture et la fermeture des applications se font de manière asynchrone. Les robots qui ouvrent et ferment des répertoires doivent attendre la fin des opérations ou utiliser des noms d'application pour éviter de trouver une application précédente.

  Attribuez différents noms d'application aux applications d'un robot pour éviter les erreurs.

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.

Utilisez 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és

• Lister le répertoire : Ouvre une nouvelle application représentant le contenu du répertoire. 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. 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.

• État verrouillé : Effectue un test des verrous en lecture/écriture sur les fichiers Windows et renvoie un indicateur d'état numérique. L'état de verrouillage n'est pas disponible sur RFS et Linux.

  • 1 Le fichier existe et n'est pas verrouillé.

  • 0 Le fichier existe et est verrouillé (lecture et écriture).

  • -1 Le fichier n'existe pas.

  • -2 La fonction n'est pas prise en charge.

  • -3 Échec pour une autre raison. (Utilisez l'étape Obtenir la dernière erreur pour récupérer l'erreur correspondante.)

• Copier le fichier : Copie un fichier vers un nouvel emplacement. Utilisez également pour copier des fichiers entre RFS 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 correspondante.

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

  Pour 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 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é renvoie les valeurs suivantes :

  • l'objet Fichier est un fichier.

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

  • L'objet Autre 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é effectue des vérifications d'existence et des 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. 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.

Une arborescence présente la structure suivante.

<fs title=”…” driver=”…” name=”…”>
    <directory path=”…” count=”…”>
        <item name=”…” size=”…” extension=”…” type=”…” created=”…” modified=”….”>
        <item name=”…” size=”…” extension=”…” type=”…” created=”…” modified=”….”>
        <item name=”…” size=”…” extension=”…” type=”…” created=”…” modified=”….”>
        ….

Les tableaux suivants définissent les nœuds (également appelés éléments), les attributs et les éléments enfants de l'arborescence.