ixbus transmetteur

IXBUS
TRANSMETTEUR
Le transmetteur permet d’envoyer des fichiers présents dans des dossiers au serveur
iXBus. Tous les transferts se font en sortie de la machine cliente (protocole HTTP(S)).
Cela évite à l’ordinateur client d’ouvrir des ports en entrée et de gérer un protocole
de type FTP.
Il se présente sous forme d’un service Windows qui interroge un webservice distant
toutes les (n) minutes.
1. PREREQUIS
Configuration minimum :
Processeur : 2 GHz ou supérieur
Mémoire : 1 Go
Systèmes d’exploitation : Microsoft Windows server 2000 ou supérieur
Framework : Microsoft .Net 3.5
Les droits administrateurs sont nécessaires à l’exécution de l’outil de configuration.
Les ports 80 et 443 doivent être ouverts en sortie.
2|P a g e
2. ARCHITECTURE
Ci-dessous l’architecture du système :
Le transmetteur ne fait qu’interroger le web service. Il n’y a aucun flux entrant sur le
serveur client.
Ci-dessous le diagramme de séquence :
2.1.
Réception
Lorsque la réception débute, un fichier « traitement.lock » (accès exclusif) est créé
dans le dossier de réception de l’organisation. Sa présence indique que des
3|P a g e
messages sont en cours de copie. Avant de copier, une vérification est effectuée
pour valider le hachage (SHA1).
Les fichiers présents dans le dossier sont considérés comme valides à partir du
moment où le fichier de verrouillage n’est plus visible.
2.2.
Emission
Lors de l’émission, le service envoie tous les fichiers présents dans le dossier vers le
web service. Dans le cas où l’envoi s’est bien passé, les fichiers sont supprimés.
Le système vérifie si le fichier n’est pas en mode exclusif ou utilisé par une autre
application. Si c’est le cas le fichier ne sera pas envoyé.
3. CONFIGURATION
La configuration du service est simple. Il suffit d’ajouter un élément dans la liste
déroulante et de saisir les informations présentes dans « Authentification » et
« Dossiers ». Un élément correspond à la configuration de connexion d’une
organisation. Il est donc possible de configurer la réception et l’émission pour
plusieurs organisations.
4|P a g e
3.1.
Authentification
Cette partie permet de configurer l’URL du web service, le nom d’utilisateur, le mot
de passe et le certificat. Toutes ces informations seront transmises au web service
afin de vérifier l’identité.
Fenêtre de sélection des certificats d’authentification client (clé privée) :
3.2.
Dossiers
A partir de cette vue, il est possible de sélectionner les dossiers qui seront utilisés pour
l’échange de fichiers.
5|P a g e
▪
▪
Le dossier de sortie concerne tous les fichiers à envoyer, le parcours du dossier
peut inclure les sous dossiers. De plus, il est possible de compresser (.zip) les
fichiers avant l’émission (si le fichier n’est pas déjà compressé).
Le dossier d’entrée est l’emplacement ou seront copiés les fichiers en
provenance du web service.
3.3.
Proxy
Dans le cas où un serveur proxy est nécessaire pour accéder à internet, il suffit de
saisir les informations dans la partie « Proxy »
3.4.
Gestion du service
Afin de simplifier le démarrage ou l’arrêt du service il est possible de gérer l’état
depuis la partie « Service Windows ». C’est également depuis cette vue que
l’intervalle d’interrogation du web service est défini. De plus, il est possible de saisir
des e-mails qui recevront des alertes informant d’une éventuelle erreur.
6|P a g e
3.5.
Journaux d’erreurs
Lorsqu’une erreur se produit, elle est stockée dans un fichier. Celui-ci est consultable
depuis la vue ci-dessous.
7|P a g e
Erreurs
Dans le cas où il est impossible de recevoir où d’envoyer un fichier, une alerte
sera envoyée par e-mail. L’e-mail ne donne aucune information technique sur
l’erreur et indique seulement le nom du fichier concerné (en cas d’émission). Cette
procédure est volontaire pour éviter de recevoir un trop grand nombre d’e-mail et
risquer de se faire considérer comme courrier indésirable par le logiciel de
messagerie. Cependant, dans le journal d’erreur, toutes les anomalies sont
répertoriées.
Exemple d’e-mail envoyé :
Sujet : Transmetteur EDI – Alerte
Bonjour,
Une erreur est survenue sur le Transmetteur iXBus
Echec d'émission du fichier : c:\Emission\test.xml
Cordialement,
Dictionnaire
Erreurs de communication les plus courantes.
Erreur de serveur
SMTP
Erreur de proxy
Serveur inaccessible
Authentification
incorrect
SMTP.EnvoyerEmail : Impossible d'envoyer le message par
SMTP - ChilkatLog: - SendEmail: Webservice.Test : System.Net.WebException: Impossible de
se connecter au serveur distant -
System.Net.Sockets.SocketException: Une tentative de
connexion a échoué car le parti connecté n'a pas répondu
convenablement au-delà d'une certaine durée ou une
connexion établie a échoué car l'hôte de connexion n'a
pas répondu Webservice.Test : System.Net.WebException: Le nom distant
n'a pas pu être résolu: 'xxx.xxx.xxx.xxx' - à
System.Net.HttpWebRequest.GetRequestStream()
Authentification incorrect, vérifier le paramétrage pour
l'adresse xxx.xxx.xxx.xxx/service.asmx
Ce dictionnaire sera modifié au fur et à mesure de l’évolution du logiciel.
8|P a g e