Configuration de l'adaptateur FTP

 
  • L'adaptateur FTP prend en charge la lecture et l'écriture de données à partir d'un serveur FTP sécurisé. L’adaptateur prend en charge pour le transfert de fichiers à partir d’un serveur FTP via Secure Sockets Layer (SSL) / niveau de sécurité TLS (Transport).
  • L’adaptateur FTP prend en charge le téléchargement de fichiers à partir des emplacements de fichier en lecture seule.
  • L’adaptateur FTP prend en charge le transfert atomique de fichiers pour le mode ASCII également.

Consultez meilleures pratiques et recommandations pour l’adaptateur FTP.

Vous pouvez définir FTP propriétés d’emplacement de l’adaptateur de réception dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies dans l’emplacement de réception, les valeurs du Gestionnaire de réception par défaut dans la console Administration de BizTalk Server sont utilisés.

System_CAPS_ICON_note.jpg Remarque

Avant d’effectuer la procédure suivante, vous devez avoir déjà ajouté un port de réception. Consultez la création d’un Port de réception.

  1. Dans la console Administration de BizTalk Server, développez Administration de BizTalk Server, développez groupe BizTalk, développez Applications, puis développez l’application dans laquelle vous souhaitez créer un emplacement de réception.

  2. Dans le volet gauche, cliquez sur le Ports de réception nœud. Dans le volet droit, cliquez sur le port de réception associé à un emplacement de réception existant ou que vous souhaitez associer à un nouvel emplacement, puis cliquez sur propriétés.

  3. Dans la Propriétés de Port de réception boîte de dialogue, dans le volet gauche, sélectionnez emplacements de réception. Dans le volet droit, double-cliquez sur un emplacement de réception ou existant Cliquez sur nouveau pour créer un nouvel emplacement de réception.

  4. Dans le Propriétés de l’emplacement de réception boîte de dialogue, dans le Transport section ensuite Type, sélectionnez FTP dans la liste déroulante, puis cliquez sur configurer.

  5. Dans Propriétés du Transport FTP, procédez comme suit :

    Traitement par lots

    UtiliserPour effectuer cette opération
    Nombre maximal de fichiersIndiquer le nombre maximal de fichiers par lot BizTalk Server.

    La valeur zéro (0) indique qu'aucune limite n'est définie.

     Valeur par défaut : 0
    Taille maximaleIndiquer le nombre maximal d'octets par lot BizTalk Server.

    La valeur zéro (0) indique qu'aucune limite n'est définie.

     Valeur par défaut : 0

    Pare-feu

    UtiliserPour effectuer cette opération
    AdresseIndiquer l'adresse du pare-feu, à savoir un nom DNS ou une adresse IP.
    ModeIndiquez le mode utilisé par l'adaptateur pour se connecter au serveur FTP.

     Valeurs valides : passif et actif

    En mode actif, le serveur FTP se connecte à un port ouvert par l'adaptateur FTP. En mode passif, l'adaptateur FTP se connecte à un port ouvert par le serveur FTP.

     Valeur par défaut : Active
    Mot de passeIndiquer le mot de passe du pare-feu.
    PortIndiquer le port du pare-feu.

     Valeurs valides : 1 à 65535 (inclus)

     Valeur par défaut : 21
    TypeIndiquer le type de pare-feu déployé.

     Valeurs valides : Aucun, Socks 4 et Socks 5

     Valeur par défaut : aucun
    UtilisateurIndiquer le nom d'utilisateur associé au pare-feu.

    FTP

    UtiliserPour effectuer cette opération
    CompteIndiquer le nom du compte pour le serveur FTP. Cette option est déconseillée et utilisation de cette propriété est déconseillée.
    Après obtentionIndiquer les commandes FTP à exécuter après l’OBTENTION du fichier. Séparez les commandes par un point-virgule (;).
    Avant obtentionIndiquer les commandes FTP à exécuter avant l’OBTENTION du fichier. Séparez les commandes par un point-virgule (;). Remarque : commande QUIT n’est pas pris en charge avant l’OBTENTION du fichier.
    Seuil d’erreurIndiquer le nombre d'erreurs que le serveur BizTalk Server peut rencontrer avant que l'emplacement ne soit désactivé.

     Valeur par défaut : 10
    Masque de fichierIndiquer le filtre de masque de fichier à utiliser pour la transmission des fichiers.
    DossierIndiquer l'emplacement d'interrogation sur le serveur FTP.
    Type de serveur FTPNouveau compter BizTalk Server 2016.

    Cette propriété permet de choisir un serveur FTP qui ne nécessite pas la commande le SYSTÈME. Les options sont None, AIX, détecter, GXS, MVS, OS400 et autres.

    Si la valeur aucun, la commande le SYSTÈME est utilisée. Autres est utilisé lorsque le type de système d’exploitation ne rentre dans aucune des catégories spécifiées.

     Valeur par défaut : aucun
    JournalIndiquez l'emplacement d'enregistrement d'une copie du fichier journal. Ce fichier permet de diagnostiquer les conditions d’erreur lors de l’envoi ou de réception de fichiers via FTP.
    Taille max. de fichierIndiquer la taille maximale de téléchargement des fichiers (en Mo).

    Zéro (0) indique que la taille des fichiers n'est pas limitée.

     Valeur par défaut : 100
    Mot de passeIndiquer le mot de passe utilisateur pour vous connecter au serveur FTP.
    PortIndiquer l'adresse du port pour ce serveur FTP.

     Valeur par défaut : 21
    Représentation sous forme dePermet de sélectionner la méthode de réception des données via FTP.

     Valeurs valides : binaire ou ASCII

     Valeur par défaut : binaire
    ServeurIndiquer le nom de serveur ou l'adresse IP du serveur FTP. Remarque : l’URI pour un envoi de port ou de réception emplacement ne peut pas dépasser 256 caractères.
    Application associée SSOIndiquer l'application associée à authentification unique de l'entreprise.
    Utilisez la liste des noms (NLST)Indiquer la méthode utilisée par l'adaptateur pour répertorier les fichiers. Pour afficher les noms de fichier au lieu de la liste de fichiers définie par le système, définissez cette valeur sur Oui.

     Valeur par défaut :
    Nom d’utilisateurIndiquer le nom d'utilisateur pour la connexion au serveur FTP.

    Interrogation

    UtiliserPour effectuer cette opération
    Supprimer après téléchargementIndiquer si l'adaptateur supprime un fichier du serveur FTP après l'avoir téléchargé.

     Valeur par défaut : Oui Remarque :
    Activer l’horodatageIndiquer si l'adaptateur télécharge de nouveau un fichier selon le cachet de date modifié. Lorsque l'adaptateur ne possède pas d'autorisations de suppression sur le serveur FTP, la commande MDTM (heure de modification) permet à l'adaptateur de savoir si un fichier a été modifié depuis le dernier téléchargement. Selon la valeur de cette propriété, le fichier est de nouveau téléchargé.

     Valeur par défaut : non Remarque: dans le cas où le serveur FTP ne prend pas en charge MDTM, définissez le intervalle de retéléchargement propriété. Remarque : cette propriété est applicable uniquement lorsque Supprimer après téléchargement est définie sur non.
    IntervalleIndiquer la fréquence d'interrogation de cet emplacement. Pour effectuer une interrogation continue, définissez cette valeur sur zéro (0).

     Valeur par défaut : 60
    Intervalle de retéléchargementSpécifiez l’intervalle après lequel l’adaptateur télécharge les fichiers de nouveau. Cette propriété est applicable uniquement lorsque les deux Supprimer après téléchargement et d’horodatage activer sur non.

     Valeur par défaut : -1

    -1 indique que l'adaptateur téléchargera de nouveau les fichiers.

    0 indique que l'adaptateur téléchargera le fichier à chaque cycle d'interrogation.
    UnitéSpécifiez le type d’unités pour la intervalle et intervalle de retéléchargement Propriétés.

     Valeurs valides : secondes, Minutes, heures et jours

     Valeur par défaut : secondes

    SSL

    UtiliserPour effectuer cette opération
    Hachage de certificat clientSpécifier le code de hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL.

    Selon ce hachage, le certificat client est récupéré dans le magasin personnel du compte d'utilisateur sous lequel l'instance de l'hôte de BizTalk est exécutée.
    Mode de connexion FTPSSpécifier le mode de connexion SSL au serveur FTPS.

     Valeurs valides : implicite ou explicite

     Valeur par défaut : explicite
    Utilisez la Protection des donnéesDéfinir ce paramètre sur Oui si l'adaptateur doit utiliser le chiffrement SSL lors de l'envoi et de la réception des fichiers de données à partir du serveur FTPS. Définissez ce paramètre sur Non pour que l'adaptateur envoie et réceptionne les fichiers de données en texte brut. Remarque : cette propriété s’applique uniquement si la utiliser SSL est définie sur Oui.

     Valeurs valides : Yes ou No

     Valeur par défaut : Oui
    Utiliser SSLIndiquer si l'adaptateur FTP doit utiliser une connexion SSL pour communiquer avec le serveur FTPS.

     Valeurs valides : Yes ou No

     Valeur par défaut :

    Paramètres de réglage

    UtiliserPour effectuer cette opération
    Délai d’expiration des données de réceptionIndiquer le délai (en millisecondes) avant l'abandon de l'appel de réception. Cette propriété vous permet d’empêcher un serveur lent à partir de l’emplacement de réception cesse de répondre.

     Valeur par défaut : 90000
    Dossier temporaireIndiquer l'emplacement du dossier temporaire. Cet emplacement permet la récupération après un échec de transfert.
  6. Cliquez sur OK pour enregistrer les paramètres.

  7. Dans la Propriétés de l’emplacement de réception boîte de dialogue, entrez les valeurs appropriées pour terminer la configuration de l’emplacement de réception, puis OK pour enregistrer les paramètres. Pour plus d’informations sur les Propriétés des emplacements de réception boîte de dialogue, consultez la création d’un emplacement de réception.

System_CAPS_ICON_note.jpg Remarque

Ne configurez pas plusieurs emplacements de réception FTP pour interroger la même URL FTP. Si plusieurs emplacements de réception FTP interrogent la même URL simultanément, chaque emplacement de réception peut recevoir une copie du fichier, ce qui peut entraîner des données dupliquées. Ce comportement survient car le protocole FTP n'a pas été configuré pour le verrouillage des fichiers lors de leur lecture à partir de l'URL cible.

Pour fournir une haute disponibilité pour le protocole FTP : adaptateur de réception, vous devez configurer l’adaptateur de réception FTP à exécuter dans une instance d’hôte BizTalk en cluster. Consultez Considérations pour l’exécution des gestionnaires d’adaptateur au sein d’un cluster hôte.

Vous pouvez définir les propriétés de l’adaptateur FTP send port dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies pour le port d’envoi, la valeur par défaut Gestionnaire d’envoi dans la console Administration de BizTalk Server, les valeurs sont utilisées.

  1. Dans la console Administration de BizTalk Server, créez un port d’envoi ou double-cliquez sur un port d’envoi existant pour le modifier. Consultez la création d’un Port d’envoi. Configurer toutes les options de port d’envoi, puis, dans le Transport section de la Général spécifiez FTP pour la Type option.

  2. Sur le Général page, dans le Transport cliquez sur le configurer situé en regard Type.

  3. Dans Propriétés du Transport FTP, procédez comme suit :

    Pare-feu

    UtiliserPour effectuer cette opération
    AdresseIndiquer l'adresse du pare-feu, à savoir un nom DNS ou une adresse IP.
    ModeSpécifier le mode utilisé par l'adaptateur pour se connecter au serveur FTP.

     Valeurs valides : passif et actif

    En mode actif, le serveur FTP se connecte à un port ouvert par l'adaptateur FTP. En mode passif, l'adaptateur FTP se connecte à un port ouvert par le serveur FTP.

     Valeur par défaut : Active
    Mot de passeIndiquer le mot de passe du pare-feu.
    PortIndiquer le port du pare-feu.

     Valeurs valides : entre 1 et 65535 (inclus)

     Valeur par défaut : 21
    TypeSélectionner le type de pare-feu déployé.

     Valeurs valides : Socks 4, Socks 5, aucun

     Valeur par défaut : aucun
    UtilisateurIndiquer le nom d'utilisateur associé au pare-feu.

    FTP

    UtiliserPour effectuer cette opération
    CompteCe paramètre est facultatif. Indiquer le nom du compte pour le serveur FTP. L'option est supprimée et l'utilisation de cette propriété est déconseillée.
    Après placementIndiquer les commandes FTP à exécuter après le fichier PUT. Séparez les commandes par un point-virgule (;).
    Allocation de stockageIndiquer si de l'espace de stockage doit être alloué pour les systèmes hôtes existants. Cette option est fournie à des fins de compatibilité descendante.

     Valeurs valides : non et Oui

     Valeur par défaut :
    Avant placementIndiquer les commandes FTP à exécuter avant le placement du fichier, telles que les commandes permettant de modifier les valeurs par défaut sur le serveur FTP. Séparez les commandes par un point-virgule (;). Aucune commande Ouvrir n'est requise. Remarque : commande QUIT n’est pas pris en charge avant le PLACEMENT du fichier.
    DossierIndiquer l'emplacement vers lequel déplacer les fichiers sur le serveur FTP.
    Type de serveur FTPNouveau compter BizTalk Server 2016.

    Cette propriété permet de choisir un serveur FTP qui ne nécessite pas la commande le SYSTÈME. Les options sont None, AIX, détecter, GXS, MVS, OS400 et autres.

    Si la valeur aucun, la commande le SYSTÈME est utilisée. Autres est utilisé lorsque le type de système d’exploitation ne rentre dans aucune des catégories spécifiées.

     Valeur par défaut : aucun
    JournalIndiquer l'emplacement où enregistrer une copie d'un fichier journal. Ce fichier permet de diagnostiquer les conditions d'erreur lors de l'envoi ou de la réception de fichiers via l'adaptateur FTP.
    Mot de passeSpécifier le mot de passe de connexion au serveur FTP.
    PortSpécifier l'adresse du port du serveur FTP.

     Valeur par défaut : 21
    Représentation sous forme deSélectionner la méthode utilisée par l'adaptateur FTP pour l'envoi de données (au format binaire ou ASCII).

     Valeurs valides : binaire ou ASCII

     Valeur par défaut : binaire
    ServeurIndiquer le nom de serveur ou l'adresse IP du serveur FTP.
    Application associée SSOIndiquer l'application associée à authentification unique de l'entreprise.
    Nom de fichier cibleIndiquer un autre nom pour le fichier. Conserver le nom par défaut garantit l'unicité des noms de message pour chaque message envoyé.

     Valeur par défaut : %MessageID%.xml
    Nom d’utilisateurIndiquer le nom d'utilisateur pour la connexion au serveur FTP.

    SSL

    UtiliserPour effectuer cette opération
    Hachage de certificat clientSpécifier le code de hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL.

    Selon ce hachage, le certificat client est récupéré dans le magasin personnel du compte d'utilisateur sous lequel l'instance de l'hôte de BizTalk est exécutée.
    Mode de connexion FTPSSpécifier le mode de connexion SSL au serveur FTPS.

     Valeurs valides : implicite ou explicite

     Valeur par défaut : explicite
    Utilisez la Protection des donnéesDéfinir ce paramètre sur Oui si l'adaptateur doit utiliser le chiffrement SSL lors de l'envoi et de la réception des fichiers de données à partir du serveur FTPS. Définissez ce paramètre sur Non pour que l'adaptateur envoie et réceptionne les fichiers de données en texte brut. Remarque : cette propriété s’applique uniquement si la utiliser SSL est définie sur Oui.

     Valeurs valides : Yes ou No

     Valeur par défaut : Oui
    Utiliser SSLIndiquer si l'adaptateur FTP doit utiliser une connexion SSL pour communiquer avec le serveur FTPS.

     Valeurs valides : Yes ou No

     Valeur par défaut :

    Paramètres de réglage

    UtiliserPour effectuer cette opération
    Nombre maximal de connexionsSpécifier un nombre maximal de connexions FTP simultanées pouvant être établies vers le serveur. La valeur 0 indique une absence de limite.

     Valeur par défaut : 0 Remarque : cette propriété remplace l’entrée de Registre qui a été utilisée dans les versions antérieures de BizTalk Server pour contrôler la limite de connexion. BizTalk Server ignore l’entrée de Registre utilisée pour contrôler la limite de connexion.
    Dossier temporaireIndiquer l'emplacement d'un dossier temporaire sur le serveur FTP. Ce fichier est d'abord téléchargé ici, puis déplacé vers le dossier FTP de destination. En cas d'échec du transfert, l'adaptateur redémarre le téléchargement du fichier en mode de transfert ASCII et reprend le mode binaire pour le transfert. Remarque : Si le transfert de fichiers est atomique entre l’emplacement temporaire et l’emplacement adéquat sur le serveur FTP, le téléchargement du fichier est également atomique.
  4. Cliquez sur OK et OK pour enregistrer les paramètres.

L'adaptateur FTP est soumis aux limitations du protocole FTP. Il requiert que certaines commandes FTP soient disponibles sur le serveur FTP source et de destination.

L’adaptateur FTP opère comme un client FTP et peut-être nécessiter que les commandes suivantes sont disponibles sur le serveur FTP pour fonctionner correctement :

CommandRequis par réceptionEnvoi d’exigibilité
SYST

Facultatif à compter BizTalk Server 2016


Facultatif à compter BizTalk Server 2016
MAGASIN
RETR
USER
PASS
CWD
QUIT
PORT
PASV
ABOR
TYPE
RNFR
RNTO
DELE
PWD
LIST
NLST
NOOP
APPE
ALLO
MDTM
AUTH TLS
PBSZ
PROT

Pour plus d’informations sur ces commandes FTP, consultez :

Cette section répond à ce que vous devez savoir pour faciliter la communication entre l’adaptateur FTP et un macroordinateur.

System_CAPS_ICON_note.jpg Remarque

Vous ne pouvez pas utiliser la fonction de dossier temporaire dans le cadre de l'envoi de fichiers à un hôte MVS ou AS400. La saisie dans ce champ n'est pas prise en charge et génère des erreurs.

System_CAPS_ICON_important.jpg Important

Les informations suivantes sont des indications et ne doivent pas remplacer celles disponibles dans la documentation AS400 ou IBM.

Pour envoyer des fichiers à un serveur FTP sur un macroordinateur, ce dernier doit prendre en charge le groupe GDG (Generation Data Group) IBM. Dans le champ de nom, chaque nom de fichier ajoute un (+1) au nom du fichier de destination (chemin d'accès complet entouré de guillemets).

Il existe trois méthodes pour nommer les fichiers et définir leurs chemins d'accès dans le cadre du transfert de fichiers via un système AS400 :

  • Champ nom de fichier: lors de l’envoi d’un fichier vers un serveur FTP, entrez le nom de fichier dans le nom de fichier champ. Celui-ci doit être conforme aux conventions d'affectation de noms de fichier du système AS400 car il sera stocké dans le système de fichiers bibliothèque.

  • Commande quote: la commande Quote permet d’exécuter un script sur l’ordinateur distant. Entrez la commande Quote dans le avant d’OBTENIR, avant de PLACER, après AVOIR, et après PLACEMENT champs sur un point de terminaison. en utilisant le format suivant :

    QUOTE RCMD <command to be run on the remote system>.  
    
    
  • Intégré (INSTALLABLE File System): IFS est une zone du système AS400 qui permet le stockage de fichiers PC et donc les mêmes conventions d’affectation de noms qu’un PC. Pour utiliser le système IFS plutôt que le système de fichiers bibliothèque, vous devez entrer quote site namefmt 1 comme première commande. Celle-ci indique au système AS400 d'utiliser la convention d'affectation de noms du système IFS.

Propriétés et schéma de propriété de l’adaptateur FTP

Meilleures pratiques et recommandations de l’adaptateur FTP

Adaptateur FTP

Ajouts de la communauté

AJOUTER
Afficher: