Aller au contenu

Tâche File Exists

Résumé

  • Nom interne : FileExists
  • Catégorie : File System
  • Objectif : Vérifier si un fichier ou un dossier existe au chemin donné. Oriente le workflow : true s'il existe, false sinon.
  • Type de tâche : Condition

Compatibilité

  • Version AndroMate minimale : 1.1.0

  • Version AndroMate maximale : 1.1.0

  • Android minimum : Android 13 (API 33)

  • Android testé maximum : Android 16 (API 36)

  • Permissions requises : MANAGE_EXTERNAL_STORAGE

Description détaillée

La tâche File Exists vérifie la présence d'un chemin sur le système de fichiers via File.exists(). Elle agit comme un nœud de condition : le workflow prend la branche true si le fichier ou le dossier existe, et la branche false sinon.

La vérification retourne true pour les fichiers comme les dossiers — elle indique seulement si le chemin existe, pas son type.

Paramètres d'entrée

Paramètre Type Requis Valeurs possibles / Règles Compatibilité Android Compatibilité AndroMate Défaut
file_path String Oui Chemin vers un fichier ou dossier (interpolation supportée) Android 13 (API 33) → Android 16 (API 36) 1.1.0 → 1.1.0 ""

Paramètres de sortie

C'est une tâche de type Condition — elle ne stocke pas de valeur. Elle oriente plutôt l'exécution du workflow :

Condition Prochaine étape
Le chemin existe (fichier ou dossier) Branche true
Le chemin n'existe pas Branche false

Exceptions

Cette tâche ne lève pas d'exceptions. Un chemin absent oriente vers la branche false.

Diagramme d'exécution

flowchart TD
    Start([▶ FileExists]) --> Resolve[🔧 Résolution file_path]

    Resolve --> Check[📁 File.exists]

    Check --> Exists{Existe ?}

    Exists -->|Oui| TrueBranch([✅ branche true])
    Exists -->|Non| FalseBranch([❌ branche false])

    style Start fill:#e3f2fd
    style TrueBranch fill:#c8e6c9
    style FalseBranch fill:#ffcdd2
    style Check fill:#fff9c4

Fonctionnement :

  1. Résolution : le file_path est résolu avec le contexte AndroMate
  2. Vérification : File.exists() est évalué
  3. Branchement : existe → branche true ; sinon → branche false

Exemples de code

Exemple 1 — Brancher selon la présence d'un fichier de config

{
  "FileExists": [
    {
      "id": "1",
      "title": "Config existe ?",
      "file_path": "/sdcard/AndromateFileTask/config.json"
    }
  ]
}

Détails des paramètres d'entrée

file_path — Chemin à vérifier

Chemin absolu vers un fichier ou un dossier. Supporte l'interpolation $variable et ${SPECIAL_VAR}. La vérification réussit pour les fichiers comme les dossiers.

Détails des paramètres de sortie

C'est une tâche de type Condition — elle ne stocke aucune variable de sortie. Le résultat pilote le branchement du workflow (true / false).

Exemple JSON complet

{
  "FileExists": [
    {
      "id": "1",
      "title": "File Exists",
      "file_path": "/sdcard/AndromateFileTask/logs/result.log"
    }
  ]
}