Activité FTP Renommer fichier

Utilisez l'activité FTP Renommer fichier pour renommer et/ou déplacer un fichier vers un répertoire différent, en phase d'exécution.

Le répertoire que l'activité FTP Renommer fichier renomme apparaît dans les cas pris en charge suivants : Pour consulter un exemple de projet qui utilise une activité FTP Renommer fichier, voir Exemple d'analyse syntaxique de liste de répertoires : Exemple d'analyse syntaxique de liste de répertoires.

Lien symbolique

L'activité FTP Renommer 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 Renommer 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é Renommer 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 "Configuration de 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
    Renommer  
    Fichier nommé Cette zone n'est pas utilisée pour cette activité. Vous indiquez le nom du fichier à renommer à l'aide du paramètre d'entrée fromFilename de la tâche Mapper les entrées.
    Répertoire source 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.
    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.
    Nouveau chemin Cette zone n'est pas utilisée pour cette activité. Vous indiquez le chemin d'accès complet, y compris le nouveau nom de fichier et le nouveau répertoire sur le serveur FTP, où le dispositif d'intégration place le fichier qui a été déplacé à l'aide du paramètre d'entrée toPath de la tâche de mappage d'entrée.
    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.
    Options - Sélectionnez l'une des options suivantes pour définir le comportement lorsqu'un fichier existant du même nom existe déjà dans le répertoire de sortie spécifié :
    Ecraser le fichier existant si un nom en double est trouvé Indique si le fichier existe et remplace le contenu du fichier initial par de nouvelles données renvoyées par l'activité.
    Générer une erreur si un nom en double est trouvé Indique si le fichier existe, conserve les données originales dans le fichier, renvoie une erreur et n'utilise pas les nouvelles données renvoyées par l'activité.

Spécification des options de 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 nouvelle tentative pour la 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 de tentatives - 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 Renommer 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 sur les paramètres d'entrée suivants :
    • fromFilename - Pendant une action de changement de nom, ce paramètre spécifie le nom initial du fichier à renommer.
    • toPath - Pendant une action de changement de nom, ce paramètre spécifie le chemin d'accès, y compris le nouveau nom de répertoire et le nouveau nom du fichier. Par exemple, pour spécifier que le fichier doit être déplacé vers le répertoire /output de la racine du serveur FTP à l'aide du nom de fichier fileNewName.txt, spécifiez la valeur suivante pour toPath: /output/fileNewName.txt.

      Tous les autres paramètres d'entrée sont facultatifs. Voir Création d'une mappe pour accéder à des instructions générales sur le mappage.  

      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 place le fichier généré dans cette activité, dans la tâche Configurer dans le répertoire appelé sortie. En phase d'exécution, le nom du répertoire outputXML 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 placé dans le répertoire outputXML.

      Tableau 3.
      Nom de paramètre d'entrée/Noeud Description Remplace le paramètre dans la tâche ?
      fromDirectory Indique le répertoire sur le serveur FTP où le dispositif d'intégration obtient la liste des fichiers. Le paramètre d'entrée directory remplace la zone Dans le répertoire de la tâche Configurer.
      overwrite Spécifie la durée en 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 Répertorier fichiers, 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/timeout Spécifie le nom d'hôte ou l'adresse IP du serveur FTP. 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 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 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.

Mappage de la sortie de l'activité

  1. Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle. Le paramètre de sortie directoryListing ou fileListing est affiché dans le panneau Depuis l'activité.
  2. Mappez le paramètre de sortie directoryListing ou fileListing sur une variable. Voir Création d'une mappe pour accéder à des instructions générales sur le mappage.

    En phase d'exécution, l'activité FTP Répertorier fichiers renvoie la liste des fichiers à l'orchestration, à l'aide du paramètre de sortie directoryListing ou fileListing.

    Si la case Fichiers de liste uniquement (NLST) est désélectionnée dans la tâche Configurer, une liste complète de répertoires, contenant notamment les droits d'accès sur les répertoires, les horodatages et la propriété, est renvoyée dans le paramètre de sortie directoryListing en tant que chaîne unique. Lorsqu'une liste complète de répertoires est renvoyée sous forme de chaîne, vous devez analyser cette liste à l'aide d'un schéma de fichier à plat, avec l'activité Lire fichier à plat. Vous pouvez créer un schéma de fichier à plat à l'aide de l'éditeur de schéma de fichier à plat. Pour consulter un exemple d'orchestration analysant une liste de répertoires à l'aide d'un schéma de fichier à plat, voir Exemple d'analyse syntaxique de liste de répertoires : Exemple d'analyse syntaxique de liste de répertoires.

    Si la case Fichiers de liste uniquement (NLST) est cochée et que l'activité FTP Répertorier fichiers prend en charge le format de la liste de répertoires pour votre serveur FTP, une structure répétée de noms de fichiers uniquement est renvoyée dans le paramètre de sortie fileListing. Lorsqu'une structure répétée de nom de fichier est renvoyée, il n'est pas nécessaire d'analyser la liste de répertoires, il suffit de renouveler l'opération dans la liste à l'aide de l'activité Pour chaque ou Pendant que.