Activité FTP Interroger répertoire

A l'exécution, l'activité FTP Interroger répertoire se connecte à un serveur FTP et cherche l'existence du ou des fichiers indiqués à l'emplacement précisé. Après avoir lu le contenu des fichiers et mappé ce contenu sur des variables de l'orchestration, l'activité FTP Interroger répertoire peut supprimer, déplacer ou conserver ces fichiers dans le répertoire du serveur FTP.

L'activité FTP Interroger répertoire est une activité de démarrage. Lorsque vous déployez une orchestration qui commence par l'activité FTP Interroger répertoire sur le dispositif d'intégration, ce dernier interroge le serveur FTP à la recherche de fichiers à ajouter à un répertoire donné. Lorsque des fichiers sont affichés sur le serveur FTP, un travail d'orchestration est démarré pour traiter ces fichiers et les activités restantes de l'orchestration. Pour plus d'informations, voir Comportement de l'intervalle d'interrogation. Pour consulter un exemple d'orchestration à l'aide de l'activité FTP Interroger répertoire, voir le manuel Getting Started Guide.

En fonction des exigences de votre application, vous pouvez traiter une liste de fichiers dans un répertoire FTP à l'aide de l'une des méthodes suivantes :
Utilisez l'activité FTP Interroger répertoire pour traiter un ensemble de fichiers figurant dans un répertoire FTP lorsque les conditions suivantes sont vérifiées :

Liens symboliques

Le support de liens symboliques par l'activité FTP Interroger répertoire pendant l'exécution dépend des facteurs suivants :  
  • Les types de lien symbolique pris en charge par le système d'exploitation qui héberge le serveur FTP.
  • Les types de lien symbolique pris en charge par le serveur FTP même.
  • Les types de lien symbolique pris en charge par l'activité FTP Interroger répertoire, comme indiqués dans le tableau suivant :
    Tableau 1.
    Liens symboliques vers Liens en dur Liens symboliques Remarques
    Fichiers Non pris en charge Non pris en charge L'activité FTP Interroger répertoire n'interprète pas les liens symboliques vers des fichiers en tant que fichiers et, par conséquent, les liens symboliques vers des fichiers ne sont pas traités par l'activité FTP Interroger répertoire en phase d'exécution.
    Répertoires Pris en charge Pris en charge  
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.

Persistance

Vous pouvez activer la persistance pour une orchestration contenant une activité FTP Interroger répertoire. Par exemple, si vous désactivez la persistance et qu'un travail d'orchestration est en cours avec l'activité FTP Interroger répertoire et l'option Conserver à l'emplacement sélectionnée, si un échec se produit en cours d'exécution et cause l'arrêt du travail, lorsque l'orchestration est redémarrée, elle traite à nouveau le fichier. L'état du travail est perdu et le dispositif d'intégration ne sait pas qu'il a déjà traité le fichier. Pour plus d'informations, voir Activation de la persistance.

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 Interroger répertoire, 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 :
  • Lorsque l'expression régulière est égale à la chaîne : *, le travail d'orchestration traite les sous-répertoires dans le répertoire spécifié.
  • Lorsque l'expression régulière est égale à la chaîne : *.*, le travail d'orchestration ne traite pas les sous-répertoires dans le répertoire spécifié.
  • Lorsque l'expression régulière est vide, le travail d'orchestration ne traite pas les sous-répertoires dans le répertoire spécifié
.

Ajout d'une activité FTP Interroger répertoire 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é Interroger répertoire 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.
        ATTENTION :
        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 correspondant à la structure de répertoire du serveur FTP spécifié initialement, soit changer le répertoire configuré dans la zone Dans le répertoire en cliquant sur Parcourir, comme décrit dans la procédure "Configurer l'activité".
      2. Sélectionnez un noeud final existant et cliquez sur OK. Passez à la procédure "Configurer l'activité".
    • Sélectionnez un noeud final existant et éditez le noeud final :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
        ATTENTION :
        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 correspondant à la structure de répertoire du serveur FTP spécifié initialement, soit changer le répertoire configuré dans la zone Dans le répertoire en cliquant sur Parcourir, comme décrit dans la procédure "Configurer l'activité". 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.

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
    Fichier nommé Spécifie un modèle ou une expression régulière qui définit les noms de fichier provenant du serveur FTP. Le traitement de l'expression régulière est effectué par le serveur FTP. Pour plus d'informations, voir la documentation du serveur FTP sur les expressions régulières. Généralement, les serveurs FTP prennent en charge les caractères génériques suivants dans leurs expressions régulières :
    • * - zéro ou plusieurs caractères
    • ? - pour zéro ou un caractère
    Remarque : Etant donné que le traitement de l'expression régulière est effectué sur le serveur FTP, la sensibilité à la casse est déterminée par le serveur FTP. Si le serveur FTP est sensible à la casse, la concordance de fichiers effectuée par l'activité FTP Interroger répertoire est également sensible à la casse.
    Dans le répertoire Spécifie le répertoire dans lequel le dispositif d'intégration recherche des fichiers sur le serveur FTP. 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 : input. 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/input.
    • 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.
    Tester Lorsque vous avez indiqué une expression régulière dans la zone Fichier nommé et le répertoire dans lequel doivent être recherchés les fichiers sur le serveur FTP, dans la zone Dans le répertoire, cliquez sur Tester pour tester l'expression régulière sur l'ensemble de fichiers, dans le répertoire spécifié, sur le serveur FTP. Une boîte de dialogue s'affiche, répertoriant les fichiers correspondants.
    De type Spécifie comment lire le contenu du fichier - soit en tant que données binaires, soit en tant que texte codé. Si l'option Texte est sélectionnée, définissez le type de codage à l'aide de l'une des options suivantes :
    • Dans la liste déroulante codé avec, sélectionnez l'un des types de codage par défaut.  
    • Entrez le type de codage directement en cliquant dans la zone codé avec et en saisissant le type de codage.
    Remarque : Certains caractères codés sur deux octets ne sont pas convertis à l'aide du codage SHIFT-JIS. Pour plus d'informations, voir Utilisation du codage Shift-JIS.
     
    ATTENTION :
    Vous devez spécifier l'option Transfert au format texte (ASCII) pour les activités FTP lorsque vous extrayez des fichiers et placez des fichiers texte sur un serveur FTP pour des noeuds finaux qui manipulent des données texte en transférant des données depuis et vers le noeud final FTP en mode ASCII. Par exemple, les noeuds finaux FTP de grand système et DOS manipulent les données ASCII lorsqu'ils transmettent des données en mode ASCII. Par exemple, si votre orchestration extrait des fichiers ASCII à l'aide de l'activité FTP Interroger répertoire et place les fichiers ASCII, à l'aide de l'activité FTP Placer fichier, sur un serveur FTP de grand système, vous devez spécifier les options des tâches suivantes dans Studio :
    • Dans la tâche Configurer d'une activité FTP Interroger répertoire, pour la zone De type, sélectionnez l'option Texte.
    • Dans la tâche Règles de distribution d'une activité FTP Interroger répertoire, pour la zone Type de transfert de fichier , sélectionnez l'option Transfert au format texte (ASCII).
    • Dans la tâche Configurer d'une activité FTP Placer fichier, pour la zone De type, sélectionnez l'option Texte.
    • Dans la tâche Règles de distribution d'une activité FTP Placer fichier, pour la zone Type de transfert de fichier , sélectionnez l'option Transfert au format texte (ASCII).
    Après la lecture du fichier

    Le supprimer - Supprimez le fichier après la lecture.

    Le déplacer dans le répertoire - Déplacez le fichier dans le répertoire indiqué, une fois qu'il a été lu.

    Indiquez le répertoire vers lequel est déplacé le fichier en phase d'exécution à l'aide de l'une des options suivantes :
    • Entrez directement un 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 : /input. 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/input.
    • Cliquez sur Parcourir pour remplir la liste déroulante de répertoires disponibles. Sélectionnez le répertoire approprié dans la liste déroulante.
     
    Avertissement : Indiquez le séparateur de répertoire après le dernier nom de répertoire affiché. Par exemple, pour déplacer un fichier vers le répertoire processed/acme dans un chemin relatif, spécifiez le répertoire suivant dans la zone Le déplacer dans le répertoire : processed/acme/
    Facultatif - Indiquez le format du nom de fichier après l'avoir renommé. Dans la liste déroulante Masque, sélectionnez le masque souhaité. Pour spécifier le caractère utilisé pour séparer les sous-zones dans le nom de fichier, entrez un caractère dans la zone Séparateur de masque. Indiquez le comportement en phase d'exécution lorsqu'un fichier portant le même nom existe :
    • Cochez la case Ecraser pour spécifier que le fichier existant doit être remplacé si un fichier de même nom existe.
    • Désélectionnez la case Ecraser pour spécifier que le fichier existant ne doit pas être remplacé si un fichier de même nom existe.
    Remarque : Lors de la première exécution de l'activité FTP Interroger répertoire en phase d'exécution, si l'activité ne peut pas se déplacer vers le fichier car le répertoire cible n'existe pas, un avertissement est consigné (et non une erreur) dans la console de gestion Web et le fichier n'est pas déplacé. Pour toutes les interrogations suivantes, l'activité ne tente pas de déplacer le même fichier et un message d'information est consigné dans la console de gestion Web indiquant que le fichier a déjà été traité.

    Conserver à l'emplacement - Conservez le fichier dans le répertoire d'entrée une fois qu'il a été lu.

    Options avancées Description
    Taille de liste dupliquée Taille de la liste interne utilisée par le dispositif d'intégration pour savoir quels fichiers ont été interrogés sur le serveur FTP. La valeur par défaut est 10000. Vous devez uniquement spécifier une taille supérieure à la taille par défaut.

Spécification des règles de distribution

  1. Sélectionnez la tâche Règles de distribution dans la Liste de contrôle. Le panneau Règles de distribution apparaît.
  2. Spécifiez l'intervalle d'interrogation des fichiers sur le serveur FTP :
    1. Sélectionnez une unité de temps dans le menu déroulant : secondes, minutes, heures ou jours.
    2. Spécifiez la durée en cliquant dans la zone Intervalle d'interrogation et en entrant une valeur ou en utilisant les flèches vers le haut et vers le bas.
    Pour plus d'informations, voir Comportement de l'intervalle d'interrogation.
  3. Si la sécurité n'est pas activée pour le noeud final FTP, les options Transfert au format texte (ASCII) et Transfert au format binaire (BINARY) sont activées dans la tâche Règles de distribution. Si la sécurité est activée pour le noeud final FTP, le type de transfert de fichier est toujours binaire.
    Sélectionnez le type de transfert de fichier entre le dispositif d'intégration et le serveur FTP à l'aide de l'une des options suivantes :
    • Transfert au format texte (ASCII) - Seuls sept bits de chaque caractère du fichier sont transférés depuis le serveur FTP vers le dispositif d'intégration. Cette option est utilisée pour transférer des fichiers ASCII tels que des fichiers HTML et texte. AVERTISSEMENT : L'utilisation de cette option avec des fichiers binaires peut entraîner une perte de données.
    • Transfert au format binaire (BINARY) - Les huit bits de chaque octet du fichier sont transférés depuis le serveur FTP vers le dispositif d'intégration. Cette option est utilisée pour transférer des fichier binaires.
      Remarque : La définition du mode de transfert dans la tâche Règles de distribution équivaut à définir le mode de transfert via une session de ligne de commande avec un serveur FTP, à l'aide des commandes suivantes :
      • ascii
      • binary

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 Interroger répertoire 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 la sortie de l'activité

  1. Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle. Les paramètres de sortie de l'activité sont affichés dans le panneau Depuis l'activité, comme indiqué dans le tableau suivant :
    Tableau 4.
    Paramètre de sortie Description
    filename Fournit le nom du fichier trouvé sur le serveur FTP.
    data Indique le contenu du fichier.
    timestamp Fournit la date et l'heure sous forme de chaîne, au format dataType de schéma XML (AAAA-MM-JJhh:mm:ss, où AA représente l'année, MM le mois, JJ le jour, hh le fuseau horaire, mm les minutes et ss les secondes.)
    Remarque : Si le paramètre de sortie timestamp est mappé dans la tâche Mapper les sorties mais que la fonctionnalité MDTM (renvoie l'horodatage de modification d'un fichier) n'est pas disponible ou n'est pas activée pour le serveur FTP, pendant l'exécution, l'orchestration arrêtera le traitement en raison de cette erreur. Un avertissement est généré et la date d'époque (1/1/1970) est renvoyée dans le paramètre de sortie timestamp.
  2. Il n'est pas obligatoire de mapper les paramètre de sortie pour cette activité. Voir Création d'une mappe pour des instructions générales sur le mappage.  



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_poll_directory_activity.html