Vous êtes sur la page 1sur 29

Manuel utilisateur

TX2 OFTP

226 rue Marcel Belot


V1.0 45160 Olivet - FRANCE
14/01/2011 Tl : 02 38 69 65 43
Fax : 02 38 69 38 37
Mail : tx2concept@itx2.com
Site commercial : www.tx2.fr
14/01/2011

I. INTRODUCTION ...............................................................................................................2
II. PRE REQUIS .................................................................................................................3
III. ARBORESCENCE DES REPERTOIRES DE LAPPLICATION ..................................3
IV. PARAMETRAGES DE LAPPLICATION ......................................................................4
1. PARAMETRES GENERAUX .................................................................................................. 4
1.1 Paramtres ............................................................................................................. 4
1.2 Loguer les informations ........................................................................................ 5
1.3 Alertes mails .......................................................................................................... 5
1.4 Colonnes affiches.................................................................................................. 6
2. SITE LOCAUX.................................................................................................................... 6
2.1 Liste des sites locaux ............................................................................................. 6
2.2 Ajout/Modification dun site local........................................................................ 7
3. PARTENAIRES .................................................................................................................. 8
3.1 Liste de partenaires ............................................................................................... 8
3.2 Ajout/Modification dun partenaire ..................................................................... 9
4. GESTION DES CERTIFICATS .............................................................................................10
4.1 Gestion du truststore ...........................................................................................10
4.2 Identification dun certificat ...............................................................................11
4.3 Associations dune identification de certificat....................................................12
4.4 Liste des certificats ..............................................................................................13
V. UTILISATION.............................................................................................................. 14

1. INTERFACE UTILISATEUR .................................................................................................14


1.1 Dmarrer le client et le(s) serveur(s) ...................................................................15
1.2 Historisation des transferts.................................................................................15
1.3 Rapport de transfert ............................................................................................16
1.4 Journal dactivit.................................................................................................16
2. PARAMETRES ET FICHIERS DECLENCHEURS .....................................................................17
1. RECEPTION DE FICHIERS .................................................................................................18
2. ENVOI DE FICHIERS.........................................................................................................18
2.1 Utilisation d'un fichier de paramtres ...............................................................19
2.2 Cration de fichiers d'acquittements ..................................................................20
3. LISTE DES CODE ERREUR ................................................................................................22
3.1 Codes erreur : SFNA Start File Negative Answer ...........................................22
3.2 Codes erreur : EFNA End File Negative Answer ............................................22
3.3 Codes erreur : ESID End Session Reason Code ..............................................23
3.4 Codes erreur : NERP Negative End Response.................................................23
4. GESTION DES ALERTES (MAIL) .........................................................................................24
VI. ANNEXES ................................................................................................................... 26

1. TYPE DE MESSAGES OFTP LES PLUS UTILES ...................................................................26


2. LE PROTOCOLE OFTP2 ..................................................................................................26
3. CINEMATIQUE DENVOI / RECEPTION DE FICHIERS .............................................................27
4. CERTIFICATION ODETTE ...............................................................................................28

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 1


14/01/2011

I. INTRODUCTION

TX2 OFTP est un client/serveur de transferts de fichiers qui permet dchanger de manire
simple et scuris des informations via le protocole OFTP (Odette File Transfert Protocol) en
versions 2.0, 1.4, 1.3 et antrieures.

TX2 OFTP vous permet dautomatiser vos transferts grce son fonctionnement en mode
serveur. Vous pourrez galement monitorer de manire intuitive le suivi de tous vos
changes.

TX2 OFTP est multi sessions. Vous pourrez ainsi envoyer des fichiers plusieurs
destinataires en mme temps tout en recevant des flux de plusieurs metteurs au mme
moment.

La solution TX2 OFTP t officiellement certifie en Octobre 2010 par lorganisation


Odette aprs avoir passer avec succs tous les tests dinteroprabilit imposs. TX2
Concept fait ainsi parti des premiers diteurs de logiciels franais mettre disposition une
solution certifie OFTP2.

Pour de plus amples informations sur le protocole OFTP2, vous pouvez allez directement
sur le site dOdette ladresse suivante :

https://forum.odette.org/OFTP/oftp2/OFTP2-FrenchVersion.pdf/at_download/file

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 2


14/01/2011

II. PRE REQUIS

Pour son bon fonctionnement, lapplication TX2 OFTP requiert les lments suivants :

- Un lien de communication utilisant le rseau IP


- Un serveur avec Java 6 install (Java Runtime Environment)
- Un certificat SSL (si vous souhaitez utilis une connexion scurise) dlivr par un
organisme reconnu de prfrence (par exemple Odette, Thawte, Verisign, ).

III. ARBORESCENCE DES REPERTOIRES DE LAPPLICATION

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 3


14/01/2011

IV. PARAMETRAGES DE LAPPLICATION

1. Paramtres gnraux

1.1 Paramtres
- Rpertoire racine : rpertoire o est installe lapplication

- Authentification client (TLS) : activer si vous souhaitez que les clients sauthentifie en
mode TLS (dsactiv par dfaut)

- Intervalle de scrutation : dlai en secondes entre chaque tche dmission

- Nombre de r-essais : nombre de tentatives de rmission avant mise en erreur du fichier


(tentatives infinies si 0)

- Taille de tampon : taille du tampon dmission (plus ce chiffre est grand et plus les
transferts seront rapides, entre 128 et 99999)

- Taille de fentre : taille de la fentre dmission (plus ce chiffre est grand et plus les
transferts seront rapides, entre 1 et 999);

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 4


14/01/2011

- Port dcoute du serveur : port sur lequel on coute les connexions clientes (3305 par
dfaut)

- Port dcoute du serveur TLS : port sur lequel on coute les connexions clientes
scurises via TLS (6619 par dfaut)

- Vrifier les certificats tous les : dlai en jours entre chaque vrification des certificats

- Heure de vrification des certificats : heure laquelle vous souhaitez vrifier


automatiquement les certificats (traitement de 10secs environ, ne bloque pas lapplication).

- URL de la liste TSL Odette : laisser http://www.odette.org/TSL/TSL_OFTP2.xml par


dfaut

- Date de dernire vrification : Date de dernire vrification des certificats

- Remise a zro du numro de session : remet le numro de session 0

1.2 Loguer les informations


- Messages OFTP : messages gnraux du protocole OFTP

- Messages OFTP dtaills : dtails de tous les messages OFTP (utile pour dbuguer)

- Variables dtat : utile pour dbuguer uniquement

- Variables : utile pour dbuguer uniquement

- Evnements : utile pour dbuguer uniquement

- Donnes : utile pour dbuguer uniquement (attention, ralenti normment lapplication)

1.3 Alertes mails

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 5


14/01/2011

- Notifier les warnings : erreurs de niveau 1 non bloquantes

- Notifier les erreurs de transfert : erreurs de niveau 2 : chec lors dun transfert

- Notifier les exceptions : erreurs de niveau 3 souvent bloquantes

- Envoi des fichiers en pices jointes : mission des fichiers lors dun chec de transfert

1.4 Colonnes affiches


Vous pouvez ici choisir dafficher ou cacher certaines colonnes du tableau des transferts
selon vos prfrences.

2. Site locaux
2.1 Liste des sites locaux

Cet cran vous permet de lister tous vos sites locaux.

Vous pouvez faire des recherches par Nom ou par SSID.

Vous pouvez ajouter, modifier ou supprimer un site local. Un message de confirmation est
demand lors de la suppression dun site local. Aprs confirmation de suppression, le site
local est supprim de la base de donne mais son dossier sur le systme nest quant lui
pas supprim pour des raisons de scurit.

Vous pouvez galement dfinir un site local comme site local principal en un simple click sur
le bouton dfinir comme site principal .

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 6


14/01/2011

2.2 Ajout/Modification dun site local

- Nom : nom du site local (galement le nom du dossier)

- Identifiant Odette : SSID du site local

- Mot de passe : mot de passe du site local

- Site principal : 1 seul site principal autoris, le site principal est utilis pour toutes les
rceptions de messages

- Gestion des associations :

Il est impratif dassocier tous les partenaires avec qui on souhaite communiquer dans cette
liste. Si un partenaire non associ tente de communiquer avec nous, une erreur de type
Invalid origin sera gnr et aucun transfert ne pourra avoir lieu.

- Gestion des certificats :

Les certificats pour les sites locaux doivent imprativement tre au format P12.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 7


14/01/2011

3. Partenaires
3.1 Liste de partenaires

Cet cran vous permet de lister tous vos partenaires.

Vous pouvez faire des recherches par Nom ou par SSID mais galement par nom de fichier
virtuel.

Vous pouvez galement ajouter, modifier ou supprimer un partenaire. Un message de


confirmation est demand lors de la suppression dun site local. Aprs confirmation de
suppression, le partenaire est supprim de la base de donne mais son dossier sur le
systme nest quant lui pas supprim pour des raisons de scurit.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 8


14/01/2011

3.2 Ajout/Modification dun partenaire

- Routage par : partenaire utilis pour le routage du message (les champs IP, port, IP TLS,
port TLS, certificat TLS, Authentification OFTP2 seront ceux du partenaire utilis pour le
routage)

- Nom : Nom du partenaire (galement nom du dossier qui sera cr)

- Identifiant Odette : SSID du partenaire

- Mot de passe : mot de passe du partenaire

- SFID : SFID du destinataire (normalement identique au SSID)

- Nom de fichier virtuel : nom du fichier virtuel utilis pour le transfert

- Adresse IP : IP du serveur du partenaire

- Port : port du serveur du partenaire

- Version OFTP : version du protocole OFTP support par le partenaire

- Taille de tampon : taille du tampon dmission (plus ce chiffre est grand et plus les
transferts seront rapides, entre 128 et 99999)

- Taille de fentre : taille de la fentre dmission (plus ce chiffre est grand et plus les
transferts seront rapides, entre 1 et 99);

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 9


14/01/2011

- Format : format utilis pour le transfert (U = non structur, T = texte, F = fixe, V = variable).
Laisser U par dfaut, sauf si le partenaire exige un autre format.

- Taille max des records : utilis uniquement pour les formats F et V

- Transcodage EBCDIC : permet de transcoder un fichier avant envoi (ASCII vers EBCDIC)
ou aprs rception (EBCDIC vers ASCII) ou les deux.

- Ne pas autoriser lenvoi et la rception dans une mme session : permet dtablir des
connexions dans un sens unique. Par exemple, si vous souhaitez uniquement envoyer des
fichiers (et ne pas recevoir de fichier dans la mme session), il faut activer cette option. De
mme si vous souhaitez uniquement recevoir des fichiers dans une mme session. Si cette
option nest pas active, il sera alors possible la fois de recevoir et envoyer des fichiers
dans une mme session.

- Fichiers batchs excuter : permet le lancement de scripts dclenchs la suite dun


envoi ou dune rception. La coche Attendre la fin dun batch avant de continuer permet
dviter le lancement simultan du mme script pour un mme partenaire (pour viter les
conflits).

- Adresse IP TLS et port TLS : Adresse IP et port du serveur si on souhaite utilis une
connexion scurise (TLS). Dans le cas dune connexion scuris, il est impratif davoir un
certificat pour le TLS associ notre site local par dfaut.

- Gestion des associations : comme pour les sites locaux

- Gestion des certificats : comme pour les sites locaux sauf que le format des certificats
doit tre le format DER.

4. Gestion des certificats


Les certificats peuvent tre ajouts manuellement dans lapplication (dans la page
ajout/modification dun site local ou bien ajout/modification dun partenaire) mais ils peuvent
aussi tre ajouts de faon automatique dans lapplication par le biais de messages
ODETTE.

4.1 Gestion du truststore

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 10


14/01/2011

Le truststore est ce qui permet lapplication didentifier quels certificats sont autoriss ou
non. Ce truststore est aliment automatiquement partir de la ODETTE TSL LIST chaque
vrification des certificats (les certificats provenant de cette liste sont tous prfixs par
odette_tsl ). Si vous souhaitez utiliser un certificat dont lautorit de confiance nest pas
dans cette liste, vous pouvez lajouter manuellement partir de ce menu.

4.2 Identification dun certificat


Chaque certificat est identifi de manire unique grce la relation suivante :

- Emetteur du certificat (socit, pays, adresse, adresse mail, organisation, nom


commun, tat ou rgion)

- Sujet du certificat (socit, pays, adresse, adresse mail, organisation, nom commun,
tat ou rgion)

- Utilisation de la cl certificat (signature numrique, chiffrement des donnes,


authentification du serveur, authentification du client, ).

- Utilisation du certificat (Connexion scurise, Authentification OFTP2, chiffrement


des fichiers, vrification de la signature des fichiers, exiger la signature des EERP.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 11


14/01/2011

4.3 Associations dune identification de certificat


Pour pouvoir recevoir le certificat dun partenaire de manire automatique via le protocole
OFTP2, il faut associer une identification de certificat un partenaire en prenant soin de bien
renseigner lutilisation du certificat.

Ainsi, lors de la rception dun message de type ODETTE_CERTIFICATE_DELIVER ou


ODETTE_CERTIFICATE_REPLACE, si lapplication parvient identifier celui-ci, il sera
automatiquement ajouter dans lapplication.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 12


14/01/2011

4.4 Liste des certificats

Dans cet cran, vous aurez accs la liste de tous les certificats connus par lapplication.
Vous avez la possibilit consulter les dtails dun certificat mais aussi dajouter ou supprimer
un certificat.

Attention :

- En cas de suppression dun certificat, les partenaires ou sites locaux qui utilisaient
ce certificat ne pourront plus sen servir.

Odette Certificate Deliver : envoi du certificat au partenaire slectionn (il faut avoir
transmis au pralable lidentification du certificat que lon souhaite envoyer au
partenaire)

Odette Certificate Replace : envoi du nouveau certificat au partenaire slectionn (il


faut avoir transmis au pralable lidentification du certificat que lon souhaite envoyer
au partenaire). Le nouveau certificat remplacera lancien certificat (reconnaissance
grce son identification) stock dans le systme du partenaire

Odette Certificate Request : demande recevoir tous les certificats du partenaire


slectionn (il faut avoir ajout au pralable les identifications de tous les certificats
du partenaire)

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 13


14/01/2011

Le bouton Vrifier les certificats permet de rcuprer tous les certificats de la liste TSL
dODETTE (certificats reconnus par Odette) mais galement de vrifier la validit de tous les
certificats de notre application par rapport la fois cette liste Odette TSL mais aussi par
rapport la date de validit des diffrents certificats ainsi que par rapport aux diffrentes
listes de rvocation des certificats.

Si un certificat nest plus valide, une alerte mail (de type WARN) peut tre transmise. Le
statut du certificat passera galement de VALID REVOKED (certificat rvoqu) ou
CA_NOT_TRUSTED (certificat non reconnu par la liste Odette TSL).

Les certificats non valides ne peuvent plus tre utilis par lapplication.

NB : La faon la plus simple dajouter un certificat est de passer directement par les
crans dajout/modification de site local ou partenaire. De cette faon toutes les
informations relatives au certificat seront ajoutes de manire transparente pour
lutilisateur

V. UTILISATION

1. Interface utilisateur

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 14


14/01/2011

1.1 Dmarrer le client et le(s) serveur(s)

Les boutons situs en haut droite de lcran principal servent dmarrer le client et le
serveur.

Le client soccupe de transfrer les fichiers prts tre envoys par lapplication.

Le serveur permet daccepter les connexions entrantes de nos diffrents partenaires pour
recevoir des fichiers.

Attention : pour dmarrer le serveur TLS, il faut imprativement avoir un certificat TLS
valide associ notre site local par dfaut.

NB : Il est possible dutiliser uniquement soit le client, soit le serveur. En effet, si nous
dmarrons le client seul, aucune connexion entrante ne pourra aboutir mais nous pourrons
tout de mme dclencher la rception de fichiers avec un partenaire juste en se connectant
sur celui-ci (ou aprs lui avoir envoy des fichiers). Le mme principe sapplique si nous ne
dmarrons que le serveur. Le mode normal de fonctionnement de lapplication est tout
de mme de dmarrer la fois le client et le serveur.

Attention : Lapplication ne peut pas tre lance plus dune fois sur le mme serveur.
Un message dalerte sera affich si une instance de lapplication est dj en cours
dexcution.

1.2 Historisation des transferts

Tous les transferts sont historiss et accessible via la partie central de linterface.

Vous pouvez faire des recherches bass sur :

- Le sens de transfert

- La date du transfert et la date du fichier virtuel

- Le nom du fichier virtuel,

- Le site local

- Le partenaire

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 15


14/01/2011

- Le format du transfert

- Le statut du transfert

Il est galement possible de trier les diffrents transferts par colonne. Par ailleurs, vous
pouvez modifier lordre des colonnes ainsi que leur taille ; ces informations seront sauves
et charges au prochain lancement de lapplication.

1.3 Rapport de transfert

En double cliquant sur un transfert, vous pourrez afficher un rapport reprenant lensemble
des informations concernant celui-ci. Il est galement possible de visualiser au format texte
les fichiers (envoys ou reus) de moins de 5Mo.

1.4 Journal dactivit

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 16


14/01/2011

Le journal dactivit est divis en plusieurs onglets :

- Connexions : Historisation de toutes les connexions entrantes et sortantes (avec un


numro de session pour chaque session Rxxx : rception ou Sxxx : envoi. Ce
numro de session peut-tre remis zro dans la fentre paramtres.)

- Pr-traitement : historisation des pr-traitements de tous les fichiers

- Post-traitement : historisation des post-traitements de tous les fichiers

De plus, un onglet est ouvert lors de chaque nouvelle session avec un nouveau partenaire
(si celui-ci na pas dj t cr). Les informations concernant tous les changes de
donnes avec ce partenaire seront historises dans cet onglet.

Tous ces journaux dactivit sont aussi historiss dans un fichier journalier situ sous le
rpertoire suivant : [tx2oftp_root]\logs.

2. Paramtres et fichiers dclencheurs


- Dmarrage automatique du serveur : paramtre autostart

- Dmarrage automatique du serveur TLS : paramtre autostart_tls (ncessite davoir un


certificat TLS valide associ notre site local par dfaut)

Le client est dmarr automatiquement si lun des paramtres prcdent est activ

- Arrt automatique du serveur : placer le fichier arreter.top sous le rpertoire racine de


lapplication (le serveur sarrtera sous 5secs)

- Vrifier si lapplication fonctionne correctement : placer le fichier alive.top sous le


rpertoire racine de lapplication, si lapplication fonctionne correctement, le fichier sera
supprim sous 5secs. Vous pouvez galement placer un fichier alive.bat sous le rpertoire
racine de lapplication. Si lapplication fonctionne correctement, le script sera excut sous
5secs.

- Rception force de fichiers : placer le fichier recevoir.top sous


[tx2oftp_root]/outbox/[partenaire] (la requte sera excute sous 5secs). Si vous
souhaitez effectuer plus connexion partir de sites locaux diffrents, il suffit de spcifier le
paramtre SSIDLOCAL=.. dans le fichier. Ce paramtre peut tre rpt, il suffit de pour
cela de sparer les diffrents SSIDLOCAL par un retour chariot.

Exemple :

SSIDLOCAL=SITE1

SSIDLOCAL=SITE2

- Fichiers de journalisation :

Un fichier de log journalier est cr sous [tx2oftp_root]\logs

- Le fichier truststore.jks contient tous les certificats auquel lapplication peut faire
confiance. Il est possible dajouter manuellement des certificats dedans en utilisant le menu
Gestion du truststore .Ce fichier est galement utilis lors de la vrification automatique
des certificats.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 17


14/01/2011

- Un fichier tx2oftp.lock est cr sous [tx2oftp_root]. Il permet de sassurer que


lapplication nest pas lance plus dune fois.

- Un fichier tx2oftp.pref est cr sous [tx2oftp_root]. Il permet de sauvegarder les


informations daffichage concernant le tableau dhistorisation des fichiers.

1. Rception de fichiers
Pour chaque site local dfini dans lapplication TX2 OFTP, un rpertoire portant son nom est
cr dans le rpertoire [tx2oftp_root]/inbox/[site_local].

La rgle de nommage des fichiers en rception est la suivante :

[YYYYMMDD_hhmmsscccc]_[SSID_Emetteur]_[SSID_destinataire]_[Virtual_Filename]

A la rception dun fichier, celui-ci est plac dans le rpertoire


[tx2oftp_root]/inbox/[site_local]/temp pour tre post trait.

Aprs avoir subi les diffrents traitements ncessaires (dchiffrement, dcompression,


vrification de signature, transcodage EBCDIC vers ASCII). Le fichier est plac directement
sous [tx2oftp_root]/inbox/[site_local]/

Ce mme fichier est archiv sous [tx2oftp_root]/inbox/[site_local]/archives avec


lextension [.arc].

En cas derreur lors du post traitement du fichier reu, celui-ci est plac sous le rpertoire
[tx2oftp_root]/inbox/[site_local]/error dans ltat quil tait au moment de la rception
(c'est--dire sans aucun post traitement) avec lextension [.err].

Une notification derreur de transfert peu galement tre envoye par mails (si active dans
paramtres)

2. Envoi de fichiers
Pour chaque partenaire distant dfini, un rpertoire portant son nom est cr dans le
rpertoire [tx2oftp_root]/outbox/[partenaire]. Les fichiers envoyer doivent tre placs
dans ce rpertoire.

Lors de lmission dun fichier, celui-ci est tout dabord dplac sous
[tx2oftp_root]/inbox/[partenaire]/sending pour tre pr trait.

Aprs envoi dun fichier sans erreur, celui-ci est archiv sous
[tx2oftp_root]/outbox/[partenaire]/archives.

La rgle de nommage des fichiers aprs mission est la suivante :

[YYYYMMDD_hhmmsscccc]_[nom_du_fichier]

En cas derreur lors du pr traitement dun fichier envoyer, celui-ci est plac sous le
rpertoire [tx2oftp_root]/outbox/[partenaire]/error dans ltat quil tait avant le pr
traitement.

En cas derreur de transfert (SFNA, EFNA, ESID), le fichier avant pr traitement sera
galement plac sous le rpertoire [tx2oftp_root]/outbox/[partenaire]/error avec

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 18


14/01/2011

lextension [.ori] et le fichier transfr (avec pr traitement) sera archiv avec lextension
[.err].

Une notification derreur de transfert peu galement tre envoye par mails (si active dans
paramtres)

2.1 Utilisation d'un fichier de paramtres


Un fichier peut tre utilis pour prciser des paramtres spcifiques un envoi. Les
paramtres dfinis dans ce fichier surchargeront les paramtres par dfaut de l'application
pour cet envoi uniquement.

La rgle de nommage des fichiers de paramtres est la suivante :

[fichier__envoyer].cfg

Exemple :

On souhaite envoyer un fichier P-RENAULT.SND vers le partenaire Renault avec des


paramtres prcis.

Le fichier P-RENAULT.SND devra tre plac sous [tx2oftp_root]/outbox/[partenaire] avec


le fichier de paramtre [tx2oftp_root]/outbox/[partenaire]/P-RENAULT.SND.CFG

Une fois placs au bon endroit, les fichiers sont envoys automatiquement par l'application.

Contenu d'un fichier de paramtres

Il se prsente sous la forme d'un fichier texte o chaque paramtre est dfini sur une ligne
de la manire suivante :

PARAMETRE=VALEUR

L'ordre des paramtres n'a pas d'importance et tous sont facultatifs.

Voici la liste des paramtres :

Nom du paramtre Commentaire Valeur

DESCRIPTION Description du fichier Texte encod en UTF-8 d'une taille


maximale de 999 octets.

VIRTUALNAME Nom de fichier virtuel. Chaine1 de 26 chars max.

FORMAT Format de fichier virtuel. Caractre parmi F, V, U, T

BUFFER Taille de tampon. Entier entre 0 et 99999.

WINDOW Taille de fentre d'mission. Entier entre 0 et 999.

SSIDLOCAL Odette ID du site local utilis (uniquement si on ne Chaine1 de 25 chars max.


souhaite pas utilis le site local par dfaut)

USERDATA Utilisation dfinie hors du protocole avec le partenaire. Chaine1 de 8 chars max.

ADRPHY Adresse physique dmission Chaine de 8 chars max

DATE Date du fichier virtuel Date du transfert (format :


YYYYMMDD )

TIME Heure du fichier virtuel Heure du transfert (format :


HHMMSScccc )

ROUTAGE Ne pas utiliser

SFIDORIG SSID de lmetteur Chaine1 de 26 chars max.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 19


14/01/2011

SFIDDEST SSID du destinataire Chaine1 de 26 chars max.

SFIDLRECL Taille max des records (format F et V) Entier entre 0 et 99999.

1 : Caractres autoriss : Chiffres de 0 9, lettres capitales de A Z, caractres / - . & ( )

Exemple :

Fichier P-RENAULT.SND.CFG

2.2 Cration de fichiers d'acquittements

Pour chaque fichier envoy, un ou plusieurs fichiers dacquittement seront gnrs sous
[tx2oftp_root]/ack

La rgle de nommage des fichiers dacquittement est la suivante :

[YYYYMMDD_hhmmsscccc]_[nom_du_fichier_emis].ack

Exemple :

Un fichier P-RENAULT.SND destin au partenaire Renault a t envoy le 14/12/2010


14h52 (17s et 835ms). Le fichier dacquittement sera le suivant :

[tx2oftp_root]/ack/20101214_145217835_P-RENAULT.SND.ACK

Contenu d'un fichier d'acquittement

Il se prsente sous la forme d'un fichier texte o plusieurs champs sont dfinis de la manire
suivante :

CHAMPS=VALEUR

Voici la liste des champs dans l'ordre :

Champs Valeur Descriptif

ACK EERP , NERP , EFPA , EFNA , EERP = acquittement positif reu


SFNA , ESID
NERP = acquittement ngatif reu

EFPA = Fichier envoy sans erreur

EFNA = Fichier envoy mais erreur

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 20


14/01/2011

FILEPATH Chemin du rpertoire o se trouve le fichier.

FILENAME Nom du fichier.

VIRTUALNAME SFIDDSN Nom du fichier virtuel

FORMAT F , V , U , T Format du fichier virtuel

DESTINATION SFIDDEST Odette ID du destinataire

ORIGINATOR SFIDORIG Odette ID de l'metteur

DATE SFIDDATE Date de gnration du fichier (format :


YYYYMMDD )

TIME SFIDTIME Heure de gnration du fichier (format :


HHMMSScccc )

ERRORSOURCE1 SFNA , EFNA , ESID , NERP Indique quel niveau l'erreur est
survenue.

ERRORCODE1 Code de l'erreur cf. Tableau des codes erreur.

ERRORTEXT1 Texte de l'erreur Texte facultatif encod en UTF-8


prcisant l'erreur.

DATEREC NOW Date de rception de lacquittement


(format : YYYYMMDD )

TIMEREC NOW Heure de rception de lacquittement


(format : HHMMSScccc )

DATESND NOW Date de rception de transfert (format :


YYYYMMDD )

TIMESND NOW Heure de rception de transfert (format :


HHMMSS )

TAILLEORI Taille originale du fichier envoy

TAILLESND Taille du fichier virtuel transmis

1
Uniquement prsent dans le cas d'un acquittement ngatif.

Exemple :

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 21


14/01/2011

3. Liste des code erreur


3.1 Codes erreur : SFNA Start File Negative Answer
01 Invalid filename.

02 Invalid destination.

03 Invalid origin.

04 Storage record format not supported.

05 Maximum record length not supported.

06 File size is too big.

10 Invalid record count.

11 Invalid byte count.

12 Access method failure.

13 Duplicate file.

14 File direction refused.

15 Cipher suite not supported.

16 Encrypted file not allowed.

17 Unencrypted file not allowed.

18 Compression not allowed.

19 Signed file not allowed.

20 Unsigned file not allowed.

99 Unspecified reason.

3.2 Codes erreur : EFNA End File Negative Answer


01 Invalid filename.

02 Invalid destination.

03 Invalid origin.

04 Storage record format not supported.

05 Maximum record length not supported.

06 File size is too big.

10 Invalid record count.

11 Invalid byte count.

12 Access method failure.

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 22


14/01/2011

13 Duplicate file.

14 File direction refused.

15 Cipher suite not supported.

16 Encrypted file not allowed.

17 Unencrypted file not allowed.

18 Compression not allowed.

19 Signed file not allowed.

20 Unsigned file not allowed.

21 Invalid file signature.

22 File decryption failure.

23 File decompression failure.

99 Unspecified reason.

3.3 Codes erreur : ESID End Session Reason Code


01 Command not recognised.

02 Protocol violation.

03 User code not known.

04 Invalid password.

05 Local site emergency close down.

06 Command contained invalid data.

07 Exchange Buffer size error.

08 Resources not available.

09 Time out.

10 Mode or capabilities incompatible.

11 Invalid challenge response.

12 Secure authentication requirements incompatible.

99 Unspecified Abort code.

3.4 Codes erreur : NERP Negative End Response


03 ESID received with reason code '03' (user code not known)

04 ESID received with reason code '04' (invalid password)

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 23


14/01/2011

09 ESID received with reason code '99' (unspecified reason)

11 SFNA(RETRY=N) received with reason code '01' (invalid file name)

12 SFNA(RETRY=N) received with reason code '02' (invalid destination)

13 SFNA(RETRY=N) received with reason code '03' (invalid origin)

14 SFNA(RETRY=N) received with reason code '04' (invalid storage record format)

15 SFNA(RETRY=N) received with reason code '05' (maximum record length not supported)

16 SFNA(RETRY=N) received with reason code '06' (file size too big)

20 SFNA(RETRY=N) received with reason code '10' (invalid record count)

21 SFNA(RETRY=N) received with reason code '11' (invalid byte count)

22 SFNA(RETRY=N) received with reason code '12' (access method failure)

23 SFNA(RETRY=N) received with reason code '13' (duplicate file)

24 SFNA(RETRY=N) received with reason code '14' (file direction refused)

25 SFNA(RETRY=N) received with reason code '15' (cipher suite not supported)

26 SFNA(RETRY=N) received with reason code '16' (encrypted file not allowed)

27 SFNA(RETRY=N) received with reason code '17' (unencrypted file not allowed)

28 SFNA(RETRY=N) received with reason code '18' (compression not allowed)

29 SFNA(RETRY=N) received with reason code '19' (signed file not allowed)

30 SFNA(RETRY=N) received with reason code '20' (unsigned file not allowed)

31 File signature not valid.

32 File decompression failed.

33 File decryption failed.

34 File processing failed.

35 Not delivered to recipient.

36 Not acknowledged by recipient.

50 Transmission stopped by the operator.

90 File size incompatible with recipient's protocol version.

99 Unspecified reason.

4. Gestion des alertes (mail)


La plupart des erreurs peuvent faire lobjet dune notification par mail. 3 niveaux dalertes
sont dfinis :

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 24


14/01/2011

- WARN : Erreur non bloquante

- ERROR : Erreur de transfert de fichier

- EXCEPTION : Erreur bloquante de lapplication

Lors dune notification derreur de transfert, vous avez la possibilit de demander le fichier
en erreur en pice jointe. Celui-ci sera transmis uniquement si sa taille nexcde pas 2Mo.
Le rapport du transfert est galement transmis.

Exemple dalerte mail (erreur de transfert) :

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 25


14/01/2011

VI. ANNEXES

1. Type de messages OFTP les plus utiles


- SSID : Message dinitialisation de session

- SFID : Message dinitialisation de transfert de fichier

- SFPA : Confirmation positive de dbut de transfert de fichier

- SFNA : Rponse ngative de dbut de transfert de fichier

- EFID : Indicateur de fin de transfert de fichier

- EFPA : Confirmation positive de rception de fichier

- EFNA : Rponse ngative de fin de transfert de fichier

- ESID : Indicateur de fin de session

- EERP : Acquittement positif

- NERP : Acquittement ngatif

- CD : Demande de changement de direction

2. Le protocole OFTP2
Plus dinformations sur le protocole OFTP2 sur le lien suivant :

https://forum.odette.org/OFTP/oftp2

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 26


14/01/2011

3. Cinmatique denvoi / rception de fichiers

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 27


14/01/2011

4. Certification ODETTE

TX2 OFTP Manuel utilisateur Copyright TX2 Concept 28