Vous êtes sur la page 1sur 13

System Network and Communication

Rseaux - Systmes Informatiques Tlcommunications


Bureau dEtudes
________________________________________________________________



















XML2CAR version 2.0

CONVERTISSEUR DE MANIFESTE XML POUR SYDONIA

MANUEL DE LUTILISATEUR














Octobre 2012

1


I. Introduction
Le convertisseur Xml2Car vous permet de transformer vos fichiers Xml-maison en
format compatible Asycuda/Sydonia. Bien quinstall de prfrence sur une
machine relie au rseau Sydonia, il na pas besoin dtre connect au serveur
Sydonia pour effectuer la conversion. En cas de perte de connexion avec le
serveur Sydonia, Xml2Car continuera travailler en mode offline et vous pourrez
ainsi valider votre manifeste quand la connexion sera rtablie.

II. Installation
1. Pre-requis
Microsoft .Net Framework 3.5. Vous pouvez linstaller partir du disque
dinstallation. Vous pouvez aussi cliquez ici pour le tlcharger.
Microsoft Visual J# 2.0. Installez-le partir du disque dinstallation ou bien
Cliquez ici pour le tlcharger. Au cas o vous choisissez le
tlchargerment, une connection est indispensable au succs de
lopration.
2. Installation
Double-cliquez sur le fichier Setup.
Suivez les instructions. Par dfaut lapplication sera install sur C:\Program
Files\SysNetCom\Xml2Car. Il cherchera par dfaut les tables Sydonia
(Rpertoire ASY) lors de la premire utilisation.
Une fois linstallation termine, vous trouverez lapplication sur votre menu
de dmarrage sous le dossier SysNetCom .

III. Configuration initiale

1. Quand vous ouvrez pour la premire fois lapplication, vous devez slectionner un
des pays qui figure sur la courte liste. Il sagit du pays o les dclarations
douanires seront faites.

2. Une fois votre choix sur le pays fait, une boite de dialogue vous demandera
dindiquer lemplacement du fichier ASY et une autre pour indiquer
lemplacement de la base des donnes AsyData.mde . Par dfaut, ils sont
respectivement sous C:\ASY et C:\Program Files\SysNetCom\Xml2Car .

2

3. Ensuite une fentre dinformation sur la licence souvre. Cliquez sur Demo , vous
pourrez lutiliser encore pendant 30 jours.

La licence dfinitive sobtient en envoyant un mail avec votre nom de la socit
ladresse indique ci-dessus.
4. Saisissez le nom utilisateur (par dfaut ADM001) et le mot de passe (adm123 pour
ADM001). Vous pourrez par la suite ajouter dautres utilisateurs et mme supprimer
ce compte (bouton utilisateur).



5. Cliquez sur le bouton Replication pour copier les tables Sydonia actuelles dans
lapplication Xml2Car.
LOGO
LOGO

3


La rplication permet de lire et dintgrer les donnes des tables Sydonia suivantes:
UNCARTAB : Liste des transporteurs
UNCMPTAB : Liste des clients
UNCTNTAB : Liste de types des containers
UNCTYTAB : Liste des pays
UNCUOTAB : Liste des bureaux de douane
UNINDTAB : Liste dindicateur de remplissage de container
UNLOCTAB : Liste des ports/villes
UNMOTTAB : Liste des types de transport
UNPKGTAB : Liste des types de colis
UNSEATAB : Liste des parties pouvant poser le scell.
UNTRDTAB : Types de titres de transports
Aprs un temps qui varie selon le volume des donnes rpliquer, un
message annonant la fin de la rplication saffichera.
Il est vident que les tables UNLOCTAB et UNCTYTAB subissent trs peu de
modification. Aprs la rplication initiale, elles ne seront copies et
compares que si vous le souhaitez. Rpondez non quand lapplication
vous demande de les rpliquer. La table des clients tant trs longue, sa
vrification est elle aussi optionnelle. Toutefois si vous jugez ncessaire de la
rpliquer pour inclure les noms des nouveaux clients, il vous sera demand si
vous voulez par la mme occasion vrifier les anciens enregistrements.

6. Dfinir les options par dfaut (Options)
Une fois les tables rpliques, quittez lapplication et re-ouvrez-la pour dfinir les
options.


4

Par dfaut le dossier de destination des fichiers Xml (transforms en format
compatible Unix) est le le C:\Program Files\SysNetCom\Xml2Car\XmlFiles.
Prenez exemple sur la figure ci-dessus pour effectuer vos reglages.
Ajoutez le logo de votre socit en cliquant sur Modifier Logo .
Cocher la nature des connaissements traiter (Imports, transits, transbos).
Validez les options et la fentre se fermera.

7. Documenter la table des correspondances des termes (convertisseur interne):
Le transporteur peut utiliser des codes diffrents de ceux dfinis par Sydonia (et
insrs lors de la rplication) pour dsigner la mme donne. Cest pourquoi il
faudra renseigner la correspondance des termes pour que la conversion se fasse
de faon optimale. Toutefois si lors de la transformation du fichier, lapplication
rencontre un code inconnu et ne trouve pas sa correspondance dans la table de
conversion, lutilisateur sera pri denregistrer la correspondance. Avec le temps, il
y aura de moins en moins dajout de correspondance.

Pour ajouter une correspondance :
- Cliquez sur le bouton Nouveau de la barre doutils (en forme de croix).
- Choisissez la catgorie (voir ci-dessous) et cliquez sur la loupe pour rechercher
le code Sydonia que vous souhaitez traduire.
- Dans le champ Interne , tapez le terme interne correspondant.
- Cliquez sur le bouton Enregistrer (image disquette).

5
Il est fortement recommand de mettre jour avant la premire utilisation les
tables suivantes :
UNCTNTAB : Liste de types des containers
UNINDTAB : Liste dindicateur de remplissage de container
UNPKGTAB : Types de colis
UNSEATAB : Liste des parties pouvant poser le scell.
UNTRDTAB : Types de titres de transports

IV. Types doprations sur les manifestes
La prsente version de Xml2Car vous permet deffectuer 3 types doprations :
Conversion des fichiers XML standard en fichiers CAR (lisible avec le MODTRB)


Conversion des fichiers CAR en fichiers XML standards


Fusion des deux manifestes en un seul.

Pour passer dun format un autre, il suffit de cliquer sur le bouton de slection de
mode de conversion (la barre qui affiche le type dopration actuellement
slectionn).
V. Oprations sur les manifestes

1. Conversion dun fichier XML standard en fichier CAR.
Allez dans le logiciel de gestion des imports et gnrez un fichier manifeste au
format XML.
Une fois le fichier reu dans votre messagerie lectronique, le mettre sur une cl
USB ou tout autre support et lamener sur la machine ou sont installs le
convertisseur Xml2Car et Sydonia/Asycuda.
Assurez-vous que la barre des oprations affiche Asy Xml => Car . Sinon
cliquez sur le bouton de slection de type dopration jusqu ce quil affiche
Asy Xml => Car .
Cliquez sur le bouton de slection de fichier et slectionnez le fichier XML que
vous avez copi sur votre cl USB.
Cliquez ensuite sur le bouton de lecture de fichier (flche verte) pour que le
convertisseur lise le contenu de fichier XML.

6



Si le fichier XML est correct, Xml2Car va extraire et afficher les informations sur le
numro de voyage, le port dorigine, la date darrive, la date de dpart, le
poids de la cargaison en kilogramme, le nombre de conteneurs (botes), le
nombre de connaissement (BL) et le nombre de colis.
Durant la procdure de conversion Xml2Car va recalculer le poids et le nombre
de colis pour comparer le total obtenu avec le total affich.
Enfin cliquez sur le bouton de conversion pour lancer la conversion du fichier
vers le format CAR.

Durant la conversion, chaque fois que le convertisseur rencontrera un code non
connu de Sydonia, il vous demandera de lui donner le code correspondant. Voici
les correspondances qui posent souvent problme :
Nom du client : Sydonia utilise des identifiants internes pour reconnaitre les
clients. Votre logiciel-maison aussi possde ses propres identifiants. Afin dviter
toute confusion entre client pouvant avoir des noms semblables, il faudra laisser
les codes clients blancs.


7
Indicateur de remplissage de conteneur : la douane utilise 4 indicateurs pour
dsigner un conteneur vide, plein, moiti plein ou au trois-quart plein. Il faudra
faire correspondre cet indicateur aux codes interne de votre logiciel-maison.


Poseur des scells : des intervenants de types diffrents peuvent poser les scells
(plombs). La douane, loprateur du terminal, le transitaire (comprenez
armateur, transporteur, expditeur) peuvent poser des plombs. Il faudra
vrifier quel code de votre logiciel-maison correspond aux codes fournis par la
douane (et prsent par le convertisseur).

Types de colis : les colis viennent dans des emballages diffrents (caisses,
conteneurs, colis nu, palette). Tous ces emballages ont des codes distincts
qui sont diffrents de ceux utiliss par votre logiciel-maison.

Types de titre de transport : votre logiciel-maison utilise par exemple MBL (Master
BL) pour parler de connaissement de premier niveau. Sydonia utilise une autre
terminologie

8


Le bouton Blanc permet de remplacer un code de votre logiciel-maison par un
champ vide. Ceci est utile quand on nest pas sr de la correspondance entre
votre logiciel-maison et Sydonia.
Le bouton Arrter permet darrter le processus de conversion nimporte quel
moment.
Le bouton Annuler permet de ne pas procder la conversion dun code et de
le laisser tel quel lors du transfert la douane.
A la fin de la conversion, Xml2Car affichera un message indiquant que la
conversion a russi (ou a chou) et aussi lemplacement et le nom du fichier
CAR.


9

Retenez le nom du fichier et ouvrez votre module Sydonia MODBRK.

Dans le menu Fonctions du MODBRK, cliquez successivement sur
Manifeste , puis sur Manifeste , puis encore sur Creation et enfin sur
Fichier Local .
Cliquez sur le fichier rcemment converti (C8120006) et sur Ouvrir .

Le manifeste souvre sur Sydonia. Vous pouvez faire les manipulations dusage sur
Sydonia.


10

2. Conversion dun fichier CAR en XML Standard.
Procdez exactement comme pour le mode de conversion 1. Assurez-vous que
vous avez slectionn le mode Car => Xml et que le fichier source est un fichier
CAR (comme ceux gnr avec les modes 1).

Ce type de conversion vous sera utile quand vous avez dj valid un fichier sur
Sydonia (et que toutes les incompatibilits ont t supprimes) et que vous voulez
rcuprer le fichier Xml pour une autre application/utilisation.

3. Conversion dun fichier PMS en fichier Xml Compatible Sydonia.
Procdez exactement comme pour le mode de conversion prcdent, assurez-
vous tout simplement que vous avez slectionn le mode Fusion 2 manifestes


Quand vous appuyez sur le bouton de lecture du fichier (flche verte), Xml2Car
vous affichera une double flche oriente droite. Cliquez sur la flche pour
pouvoir insrer le deuxime manifeste.

Insrez le deuxime manifeste et cliquez de nouveau sur la flche verte.
Sydonia va gnrer un nouveau fichier XML combinant les deux manifestes.
A la fin de la conversion, le convertisseur vous indiquera lemplacement du
fichier XML gnr quil faudra utiliser en mode Asy xml => Car pour obtenir un
manifeste unique.

11
VI. Maintenance
1. Gestion des utilisateurs
Pour grer les utilisateurs, cliquez sur le bouton Utilisateurs et accdez la
fentre listant tous les utilisateurs.




Avec la gestion des utilisateurs, vous pouvez crer :
Crer les utilisateurs en cliquant sur le bouton en forme de croix. Une fois les
informations entres, il faudra enregistrer (bouton en forme de disquette) et vous
obtiendrez un code utilisateur unique.
Modifier les informations sur un utilisateur. Cliquez sur le bouton en forme de
dossier pour passer en mode modification. Noubliez pas denregistrer avant de
fermer.
Dsactiver et ractiver les utilisateurs. Quand un utilisateur est activ, le bouton
Dsactiver apparat sur la barre des menus. De mme quand lutilisateur est
dsactiv, cest le bouton Activer qui apparait. Veuillez faire attention ne
pas dsactiver tous les utilisateurs existants. Lapplication deviendrait inutilisable.
Changer le mot de passe dun utilisateur. Si vous tes administrateur, vous
pouvez rinitialiser le mot de passe dun utilisateur en cliquant sur le bouton
reset Password .

2. Gestion des conversions
Si aprs avoir enregistr une correspondance, on voudrait lannuler, il faudra
cliquez sur le bouton de conversion, slectionner la catgorie et supprimer la
correspondance indsirable (Voir figure ci-dessous).


12

Vous pouvez aussi enregistrer une conversion directement partir dici ou modifier
une conversion existante. Les boutons de commandes fonctionne dans la mme
logique que sur la fentre de gestion des utilisateurs (voir point 1 de cette section).

3. Rplication des donnes avec Sydonia
Il arrive que lautorit de gestion ou les oprateurs du serveur Sydonia dcident de
modifier une des donnes sur les tables suivantes :
UNCARTAB : Liste des transporteurs
UNCMPTAB : Liste des clients
UNCTNTAB : Liste de types des containers
UNCTYTAB : Liste des pays
UNCUOTAB : Liste des bureaux de douane
UNINDTAB : Liste dindicateur de remplissage de container
UNLOCTAB : Liste des ports/villes
UNMOTTAB : Liste des types de transport
UNPKGTAB : Liste des types de colis
UNSEATAB : Liste des parties pouvant poser le scell.
UNTRDTAB : Types de titres de transports
Ces tables sont utilises par Xml2Car pour contre-vrifier la validit des donnes.
Cest pourquoi il est ncessaire et vitale de procder une rplication des
donnes intervalle rgulier. Une rplication par semaine serait le scenario idal
(par exemple, chaque lundi).
La rplication permet de lire et dintgrer les donnes des tables Sydonia dans
Xml2Car.
Pour rpliquer les donnes, cliquez sur le bouton Replication et attendez le
message de confirmation de fin de la rplication.