Activité FTP Supprimer fichier

Utilisez l'activité FTP Supprimer fichier pour supprimer des fichiers spécifiques de répertoires spécifiques, en phase d'exécution.

Généralement, l'activité FTP Supprimer fichier est associée à l'activité FTP Répertorier fichiers, comme illustré dans l'exemple d'orchestration suivant : Pour consulter un exemple de projet qui utilise une activité FTP Supprimer fichier, voir Exemple d'analyse syntaxique de liste de répertoires.

Lien symbolique

L'activité FTP Supprimer fichier prend en charge les liens symboliques vers des répertoires si les conditions suivantes sont vérifiées : Pour déterminer le support de lien symbolique spécifique pour un serveur FTP spécifique sur un système d'exploitation spécifique, consultez la documentation de votre système d'exploitation et du serveur FTP.

Ajout d'une activité FTP Supprimer fichier dans l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
  2. Sélectionnez l'onglet Activités et développez le dossier FTP.
  3. Déplacez l'activité Supprimer fichier sur l'orchestration.
  4. Sélectionnez l'activité. La Liste de contrôle est affichée.

Création, sélection ou édition d'un noeud final FTP

  1. Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
    • Sélectionnez un noeud final existant :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
        Avertissement : Si vous spécifiez un nouveau noeud final FTP avec une structure de répertoire différente de celle du noeud final FTP initial, le travail d'orchestration peut échouer en phase d'exécution. Vous devez soit spécifier un nouveau serveur FTP qui correspond à la structure de répertoire du serveur FTP spécifié initialement, soit modifier le répertoire configuré dans la zone Dans le répertoire en cliquant sur Parcourir, comme décrit ci-dessous dans la procédure "Configurer l'activité".
      2. Sélectionnez un noeud final existant et cliquez sur OK. Allez à la procédure "Configuration de l'activité".
    • Sélectionnez un noeud final existant et éditez-le.
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
        Avertissement : Si vous spécifiez un nouveau noeud final FTP avec une structure de répertoire différente de celle du noeud final FTP initial, le travail d'orchestration peut échouer en phase d'exécution. Vous devez soit spécifier un nouveau serveur FTP qui correspond à la structure de répertoire du serveur FTP spécifié initialement, soit modifier le répertoire configuré dans la zone Dans le répertoire en cliquant sur Parcourir, comme décrit ci-dessous dans la procédure "Configuration de l'activité".
      3. Cliquez sur Editer. Le panneau Editer un noeud final apparaît.
    • Créez un noeud final : sélectionnez Nouveau. Le panneau Créer un noeud final apparaît.
  2. Création ou édition d'un noeud final FTP : Création ou édition d'un noeud final FTP

Configuration de l'activité

  1. Sélectionnez la tâche Configurer dans la Liste de contrôle. La tâche Configuration apparaît.
  2. Configurez les zones de ce panneau comme décrit dans le tableau suivant :
    Tableau 1.
    Zone Description
    Rechercher  
    Fichier nommé Cette zone n'est pas utilisée pour cette activité. Vous indiquez le nom du fichier à supprimer à l'aide du paramètre d'entrée filename de la tâche Mapper les entrées.
    Dans le répertoire Indique le répertoire sur le serveur FTP où le dispositif d'intégration supprime le fichier spécifié. Vous pouvez indiquer un répertoire à l'aide de l'une des options suivantes:
    • Entrez directement le chemin de répertoire en cliquant dans la zone et en entrant l'un des chemins de répertoire suivants :
      • Chemin de répertoire relatif, par exemple : /process. Considère que le répertoire de base FTP a été configuré pour le compte utilisateur qui se connecte au serveur FTP. Pour plus d'informations, consultez la remarque ci-dessous.
      • Chemin de répertoire complet, par exemple, sur une machine UNIX : /home/user/process.
    • Cliquez sur Parcourir... pour remplir la liste déroulante de répertoires disponibles. Sélectionnez le répertoire approprié dans la liste déroulante.
    En phase d'exécution, la valeur spécifiée dans la zone Dans le répertoire de la tâche Configurer est remplacée si une valeur est fournie pour le paramètre d'entrée directory facultatif à l'aide de l'une des options suivantes :
    • Le paramètre d'entrée directory est mappé sur une variable.
    • Une valeur par défaut est fournie pour le paramètre d'entrée directory.
    Pour plus d'informations, voir la procédure "Mappage de l'entrée de l'activité".
    Remarque : UNIX : Si vous spécifiez un chemin de répertoire relatif lorsque vous vous connectez à un serveur FTP sur une machine UNIX, vérifiez que le répertoire de base FTP a été correctement spécifié dans le fichier /etc/password pour le compte utilisateur qui se connecte au serveur FTP.

Spécification des options de nouvelle tentative

  1. Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer apparaît.
  2. Configurez les options de tentative pour la connexion à un serveur FTP. Le tableau suivant décrit les options de tentative de connexion à un serveur FTP :
    Tableau 2.
    Zone Description
    Réessayer  
    1) Attendre ___ seconde(s) entre chaque tentative. Nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter d'établir une connexion avec le serveur FTP.
    2) Tenter de se connecter ___ fois avant l'échec. Indique le nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le serveur FTP avant d'émettre une erreur et d'arrêter le traitement du travail d'orchestration en cours.

    Si vous déployez une orchestration qui contient une activité FTP Supprimer fichier et que le dispositif d'intégration ne peut pas se connecter au serveur FTP spécifié, le dispositif d'intégration consigne les erreurs de connexion en tant qu'avertissements dans les journaux du système et de l'orchestration jusqu'à ce que la valeur de nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans les journaux du système et de l'orchestration et arrête le traitement du travail d'orchestration en cours.

    Par exemple, si vous définissez le nombre de tentatives à 3, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements. Le dispositif d'intégration consigne la quatrième erreur de connexion en tant qu'Erreur et arrête le traitement du travail d'orchestration en cours.

Mappage de l'entrée de l'activité

  1. Sélectionnez la tâche Mapper les entrées dans la Liste de contrôle. Le panneau Réessayer apparaît. Les paramètres d'entrée de l'activité sont affichés dans le panneau Vers l'activité.
  2. Vous devez mapper une variable au paramètre d'entrée filename. Tous les autres paramètres d'entrée sont facultatifs. Le paramètre filename spécifie le nom du fichier à supprimer sur le serveur FTP.

Si les paramètres d'entrée répertoriés dans le tableau suivant ne sont pas affichés dans le panneau Vers l'activité de la fenêtre Mapper les entrées, sélectionnez Mapper > Afficher les paramètres facultatifs dans le menu de la barre d'outils ou cliquez avec le bouton droit de la souris dans le panneau Vers l'activité et sélectionnez l'option Afficher les paramètres facultatifs. Si vous ne pouvez pas sélectionner l'option Mapper > Afficher les paramètres facultatifs dans le menu de la barre d'outils, cliquez sur un noeud dans le panneau Mapper les entrées pour activer cette option.

Si vous le souhaitez, vous pouvez remplacer les paramètres spécifiés dans la tâche Configurer et Sélectionner le noeud final de la Liste de contrôle, dynamiquement en phase d'exécution, à l'aide des paramètres d'entrée définis dans le tableau suivant.

Par exemple, vous pouvez définir le répertoire du serveur FTP où le dispositif d'intégration supprime le fichier, dans la tâche Configurer par le répertoire appelé processus. En phase d'exécution, le nom du répertoire processXML peut être transmis à l'activité à l'aide du paramètre d'entrée directory. Le nom du répertoire spécifié dynamiquement pendant l'exécution remplace le paramètre initial, spécifié dans le panneau Configurer. Dans cet exemple, le fichier est supprimé du répertoire processXML.

Tableau 3.
Nom de paramètre d'entrée/Noeud Description Remplace le paramètre dans la tâche ?
directory Indique le répertoire sur le serveur FTP où le dispositif d'intégration place le fichier généré dans cette activité. Le paramètre d'entrée directory remplace la zone Dans le répertoire de la tâche Configurer.
connection/timeout Spécifie le nombre de secondes avant l'expiration du délai entre la tentative du dispositif d'intégration pour établir une connexion avec le noeud final et le temps nécessaire au noeud final pour répondre à la demande de connexion. Pour l'activité FTP Supprimer fichier, durée pendant laquelle le dispositif d'intégration tente d'établir une connexion avec le serveur FTP avant l'expiration du délai.   Le noeud timeout du paramètre d'entrée connection remplace la zone Délai de connexion - Dépassement de délai d'attente après ___ seconde(s) lors de l'établissement d'une connexion avec le noeud final du noeud final FTP.  
connection/host Spécifie le nom d'hôte ou l'adresse IP du serveur FTP. Le noeud host du paramètre d'entrée connection remplace la zone Nom d'hôte du noeud final FTP.
connection/port Spécifie le numéro de port attribué au nom d'hôte spécifié. Le port standard pour le trafic FTP est 21. Le port par défaut pour le trafic SFTP est 22. Le noeud port du paramètre d'entrée connection remplace la zone Port du noeud final FTP.
connection/username Spécifiez le nom d'utilisateur du compte utilisé pour la connexion au serveur FTP. Le noeud username du paramètre d'entrée connection remplace la zone Nom d'utilisateur du noeud final FTP.
connection/password Spécifiez le mot de passe du compte utilisé pour la connexion au serveur FTP. Le noeud password du paramètre d'entrée connection remplace la zone Mot de passe du noeud final FTP.