Si vous avez l'intention d'utiliser le protocole de transfert FTP ou FTPS pour les documents entrants, vous devez installer un serveur FTP. Si vous envisagez d'utiliser le protocole FTP mais que vous n'avez pas encore installé de serveur, installez-en un avant de poursuivre. Assurez-vous que l'une des conditions ci-après s'applique à votre installation :
Après avoir installé le serveur FTP, l'étape suivante consiste à créer la structure de répertoires requise sous le répertoire principal du serveur FTP. WebSphere Partner Gateway requiert une structure de répertoires précise pour permettre aux composants Réceptionnaire et Gestionnaire de documents d'identifier correctement le participant qui envoie le document entrant. La structure est décrite à la figure 15.
Le répertoire de chaque participant contient un répertoire Binary et un répertoire Documents. Chacun de ces deux répertoires contient un répertoire Production et un répertoire Test.
Le répertoire Documents est utilisé lorsqu'un participant envoie un document XML contenant des informations d'acheminement complètes (via FTP) vers le concentrateur. Il convient dans ce cas de créer une définition XML personnalisée.
Le répertoire Binary est utilisé lorsqu'un participant envoie tout autre document (via FTP) au concentrateur.
Pour chaque participant appelé à envoyer ou recevoir des documents via FTP, vous devez créer les dossiers suivants à partir du répertoire racine de votre serveur FTP :
Il est important de comprendre comment les fichiers binaires et XML sont traités par le serveur FTP.
Les noms de fichiers binaires doivent être structurés selon un modèle précis, car les fichiers ne sont pas du tout inspectés par le Gestionnaire de documents.
La structure des noms de fichiers est : <ID_participant_destinataire><Nom_fichier_unique>
Lorsqu'un fichier binaire est détecté par le Réceptionnaire, il est écrit dans la mémoire partagée puis transmis au Gestionnaire de documents en vue de son traitement.
Le nom du répertoire dans lequel le fichier a été détecté identifie le nom du participant d'origine, tandis que la première partie du nom du fichier identifie le nom du participant de destination. Par ailleurs, la position du répertoire dans l'arborescence permet de déterminer s'il s'agit d'une transaction de Production ou de Test.
Par exemple, un fichier nommé 123456789.abcdefg1234567 est détecté dans le répertoire \ftproot\partenaireB\binary\production. Le Gestionnaire de documents a pris connaissance des informations suivantes :
Le Gestionnaire de documents recherche ensuite une connexion de participants de production entre le partenaireB et le partenaireA pour :
Le Gestionnaire de documents traite alors le fichier.
Un fichier XML n'obéit à aucune règle d'appellation de fichiers car il est inspecté par le Gestionnaire de documents et les informations d'acheminement sont extraites du document lui-même.
Lorsqu'un fichier XML est détecté par le Réceptionnaire, il est écrit dans la mémoire partagée puis transmis au Gestionnaire de documents en vue de son traitement.
Le Gestionnaire de documents compare le fichier XML aux formats XML définis et sélectionne le format XML qui convient. (Le paramétrage des formats XML est décrit dans la section Création de documents XML personnalisés.) Le nom du Participant d'origine, le nom du Participant de destination et les informations d'acheminement sont extraits du fichier XML.
Par ailleurs, la position du répertoire dans l'arborescence permet de déterminer s'il s'agit d'une transaction de Production ou de Test.
Le Gestionnaire de documents utilise alors ces informations pour localiser la connexion de participants correspondante avant de traiter le fichier.
Après avoir créé la structure de répertoires requise, vous devez configurer votre serveur FTP pour chaque participant de la communauté du concentrateur. La façon dont vous allez configurer le serveur FTP dépend du serveur que vous utilisez. Consultez la documentation du serveur FTP, puis effectuez les opérations suivantes :
Si vous utilisez un serveur FTPS pour recevoir des documents, les considérations relatives à la sécurité pour les sessions SSL sont gérées uniquement par le serveur FTPS et le client utilisés par le participant. Il n'existe pas de configuration de sécurité spécifique à WebSphere Partner Gateway pour les documents FTPS entrants. WebSphere Partner Gateway extrait les documents de la cible FTP (décrite dans Définition d'une cible FTP) une fois que le serveur a négocié les canaux sécurisés et reçu le document. Pour configurer un canal sécurisé qui puisse être contacté par un participant, reportez-vous à la documentation relative au serveur FTPS pour connaître les certificats requis (et où ils sont nécessaires).
Pour authentifier le serveur, fournissez le certificat du réceptionnaire aux participants. Si ce certificat est fourni par une Autorité de certification, fournissez également la chaîne de certificat de CA. Si l'authentification de client est prise en charge par le serveur FTPS, les certificats d'authentification client des participants doivent être précisés sur le serveur FTPS. Consultez la documentation du serveur FTPS pour obtenir des informations sur l'authentification client et les certificats.