Activité FTP Placer fichier

A l'exécution, l'activité FTP Placer fichier extrait des données de variables de l'orchestration, place ces données dans un fichier, puis se connecte à un serveur FTP et place le fichier à l'emplacement de répertoire spécifié.

Pour consulter un exemple d'utilisation de l'activité FTP Placer fichier, voir le manuel Getting Started Guide.

Interruption de transfert

Le transfert de fichiers effectué par l'activité FTP Placer fichier en phase d'exécution n'est pas transactionnel et n'est pas donc pas garanti. Par exemple, si une activité FTP Placer fichier transfère un fichier du dispositif d'intégration vers un serveur FTP et que le transfert de fichier est interrompu car le dispositif d'intégration est réamorcé, il n'est pas garanti que la totalité du fichier soit transférée.

Lien symbolique

L'activité FTP Placer fichier prend en charge les liens symboliques vers des répertoires si les liens symboliques vers les répertoires sont pris en charge par le système d'exploitation qui héberge le serveur FTP et si les liens symboliques vers les répertoires sont pris en charge par le serveur FTP même. 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 Placer 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é Placer 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 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.
      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 dans la procédure "Configurer 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

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. 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. Si la sécurité est activée pour le noeud final FTP, le type de transfert de fichier est toujours binaire.
  2. 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) - Cette option est utilisée pour le transfert de fichiers (HTML, XML et autres fichiers texte). Les fins de lignes sont converties et les autres conventions de fichiers texte sont respectées.
      ATTENTION :
      L'utilisation de cette option avec des fichiers binaires peut entraîner une perte de données.
    • Transfert au format binaire (BINARY) - Cette option est utilisée por le transfert de fichiers binaires. Le dispositif d'intégration utilise cette option pour transférer les données sans conversion.

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
    Sauvegarder
    Fichier nommé Cette zone n'est pas utilisée pour cette activité. Vous indiquez le nom du fichier de sortie à 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 place le fichier généré dans cette activité. 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 : /output. 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/output.
    • 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.
    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.
     
    Avertissement : 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).
    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é.
    Ajouter au fichier existant Indique si le fichier existe, conserve les données originales dans le fichier et ajoute les nouvelles données (renvoyées par l'activité) à la fin du fichier.
    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é.
    Remarque : Lorsque vous sélectionnez cette option, l'activité FTP Placer fichier vérifie si le fichier existe sur le serveur avant de le télécharger. Sur certains serveurs FTP, vous n'avez pas l'autorisation de vérifier si le fichier existe avant de le télécharger. On appelle ces serveurs des serveurs FTP aveugles. Dans ce cas, le fichier est écrasé, même si vous avez sélectionné l'option Générer une erreur si un nom en double est trouvé.

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 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 Placer 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. Il n'est pas obligatoire de mapper tous les paramètre d'entrée pour cette activité. Les paramètres suivants sont obligatoires :
    • filename
    • data
Tous les autres paramètres sont facultatifs. Voir Création d'une mappe pour 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. A l'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 ?
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.
encoding Spécifie comment les données sortantes sont écrites dans le fichier :
  • Si aucun codage n'est requis, spécifiez la chaîne : binary.
  • Si un codage est nécessaire, spécifiez le type de codage qui doit être utilisé pour coder les données sortantes, par exemple, UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US ou SHIFT-JIS.
Le paramètre d'entrée encoding remplace le codage spécifié dans la zone De type de la tâche Configurer mais si l'option Binaire est sélectionnée dans la zone De type de la tâche Configurer, le codage spécifié par le paramètre d'entrée encoding n'est pas pris en compte.
overwrite Indique le comportement lorsqu'un fichier existant du même nom existe déjà dans le répertoire de sortie spécifié. Indiquez l'une des valeurs suivantes :
  • y - Indique si le fichier existe et remplace le contenu du fichier initial par de nouvelles données renvoyées par l'activité.
  • a - Indique si le fichier existe, conserve les données originales dans le fichier et ajoute les nouvelles données (renvoyées par l'activité) à la fin du fichier.
  • n - Indique si le fichier existe, conserve les données originales dans le fichier et n'utilise pas les nouvelles données renvoyées par l'activité.
Le paramètre d'entrée overwrite remplace la zone Options de la tâche Configurer.
connection/timeout Spécifie le délai de connexion - 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 Placer 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.



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