Activité FTP Répertorier fichiers

A l'exécution, l'activité FTP Répertorier fichier se connecte à un serveur FTP et génère une liste de fichiers depuis l'emplacement de répertoire spécifié, à l'aide de l'expression régulière indiquée. 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, 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. Si la case Répertorier uniquement les fichiers (NLST) est cochée et que l'activité FTP Répertorier fichiers gère le format de la liste de répertoires de votre serveur FTP, une structure répétée de noms de fichiers uniquement (si elle est prise en charge par le serveur FTP) 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. Le serveur FTP auquel vous vous connecter doit gérer la commande NLST. La réponse fournie par le serveur FTP est renvoyée.

Dans certains cas, vous devez associer l'activité FTP Répertorier fichiers aux activités FTP Obtenir fichier, FTP Placer fichier, FTP Supprimer fichier et FTP Renommer fichier. pour traiter un ensemble de fichiers trouvés dans un répertoire FTP, alors que dans d'autres cas, vous pouvez simplement utiliser l'activité FTP Interroger répertoire.

Associez l'activité FTP Répertorier fichiers aux activités FTP Obtenir fichier, FTP Placer fichier, FTP Supprimer fichier et FTP Renommer fichier pour traiter un ensemble de fichiers trouvés dans un répertoire FTP si l'une des conditions suivantes est vérifiée :

Liens symboliques

Le support de liens symboliques par l'activité FTP Répertorier fichiers pendant l'exécution dépend des facteurs suivants :   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.

Traitement de sous-répertoires à l'aide du noeud final FTP de Microsoft

Pour le noeud final FTP Microsoft IIS (Internet Information Services), le comportement d'exécution de l'activité FTP Répertorier fichiers, lors du traitement des sous-répertoires et des fichiers dans les sous-répertoires, dépend de l'expression régulière spécifiée dans la zone Fichier nommé de la tâche Configurer de l'activité, comme décrit dans les cas suivants :

Ajout d'une activité FTP Répertorier fichiers 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é Répertorier fichiers 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. Passez à 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éez ou éditez 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 toutes les zones de ce panneau comme décrit dans le tableau suivant :
    Tableau 2.
    Zone Description
    Dans le répertoire Indique le répertoire sur le serveur FTP où le dispositif d'intégration génère la liste des fichiers du répertoire. 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.
    Fichier nommé Spécifie un masque glob définissant les noms de fichier que vous souhaitez obtenir du serveur FTP. Le traitement du masque glob est réalisé par le serveur FTP. Pour plus d'informations, consultez la description du masque (pattern) glob dans la documentation du serveur FTP.
    Fichiers de liste uniquement (NLST) La case Fichiers de liste uniquement (NLST) détermine le type de liste de répertoires renvoyé par le bouton Tester et pendant l'exécution. En outre, cette case définit si le paramètre de sortie fileListing ou directoryListing est affiché dans la tâche Mapper les sorties et renvoyé par l'activité pendant l'exécution.
      Si la case Répertorier uniquement les fichiers (NLST) est cochée, seuls les noms de fichiers (si ceci est pris en charge par le serveur FTP) sont renvoyés lorsque vous cliquez sur le bouton Tester, comme illustré dans la Figure 1. En outre, lorsque la case Fichiers de liste uniquement (NLST) est cochée, le paramètre de sortie fileListing est répertorié dans la tâche Mapper les sorties. A l'exécution, l'ensemble de fichiers est renvoyé dans le noeud répété fileName du paramètre de sortie fileListing. Le serveur FTP auquel vous vous connecter doit gérer la commande NLST. La réponse fournie par le serveur FTP est renvoyée.
      Si la case Fichiers de liste uniquement (NLST) est désélectionnée, 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 lorsque vous cliquez sur le bouton Test, comme illustré dans Figure 2. En outre, lorsque la case Fichiers de liste uniquement (NLST) est cochée, le paramètre de sortie directoryListing est répertorié dans la tâche Mapper les sorties. A l'exécution, la liste complète de répertoires est fournie en tant que chaîne unique et renvoyée à l'aide du paramètre de sortie directoryListing.
    Figure 1. Exemple répertoriant les cas dans lesquels l'option Fichiers de liste uniquement(NLST) est sélectionnée.
    bidAcmeInc.txt
    bidBudgetManufacture.txt
    bidCrankCo.txt
    bidSamAndSons.txt
    bidWidgetRUs.txt
    Figure 2. Exemple répertoriant les cas dans lesquels l'option Fichiers de liste uniquement(NLST) n'est pas sélectionnée.
    -rw-r--r--  1 551    551      65 May  3 11:39 bidAcmeInc.txt
    -rw-r--r--  1 551    551     43 May  3 11:39 bidBudgetManufacture.txt
    -rw-r--r--  1 551    551       0 May  3 11:39 bidCrankCo.txt
    -rw-r--r--  1 551    551      73 May  3 11:39 bidSamAndSons.txt
    -rw-r--r--  1 551    551      33 May  3 11:39 bidWidgetRUs.txt

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éfinit les options de tentative pour une connexion à un serveur FTP :
    Tableau 3.
    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 - nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le serveur FTP avant d'émettre une erreur.

    Si vous déployez une orchestration qui commence par une activité FTP Répertorier fichiers 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 le journal système jusqu'à ce que la valeur du nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans le journal système, remet le nombre d'erreurs de connexion à zéro et poursuit les tentatives d'établissement d'une connexion au serveur FTP.

    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 remet à zéro le nombre d'erreurs de connexion. Par conséquent, la cinquième erreur de connexion génère un avertissement dans le journal système. Le dispositif d'intégration continue de tenter l'établissement d'une connexion avec le serveur FTP.

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. Le mappage des paramètres d'entrée de l'activité FTP Répertorier fichiers est facultatif. L'activité FTP Répertorier fichiers prend en charge les paramètres d'entrée facultatifs suivants :
    • directory
    • connection

    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 obtient la liste de fichiers, dans la tâche Configurer par le répertoire appelé input. A l'exécution, le nom du répertoire inputXML 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, la liste de fichiers est générée à partir du répertoire inputXML.

Tableau 4.
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 génère la liste des fichiers de 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 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 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.

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.

A l'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 Répertorier uniquement les fichiers (NLST) est cochée et que l'activité FTP Répertorier fichiers gère le format de la liste de répertoires de votre serveur FTP, une structure répétée de noms de fichiers uniquement (si elle est prise en charge par le serveur FTP) 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.




Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/ftp_list_files_activity.html