Vous êtes sur la page 1sur 133

Connecteur IE

TMS Suite

CONNECTEUR IE

© AKANEA Développement Page 1 sur 133


Connecteur IE
TMS Suite

SOMMAIRE
1. INTRODUCTION .......................................................................................................................... 5
2. INSTALLATION CONNECTEUR IE ............................................................................................. 6
2.1. PRE REQUIS ............................................................................................................................ 6
2.2. INSTALLATION CONNECTEUR IE ................................................................................................ 6
2.3. VERIFICATION .......................................................................................................................... 8
2.4. BROKER .................................................................................................................................. 8
2.5. MISE A JOUR PROGICIEL METIER .............................................................................................. 8
2.6. ACTIVATION BASE CONNECTEUR IE .......................................................................................... 9
3. ACTIVATION COMMUNICATION PROGICIEL/CONNECTEUR IE ........................................... 11
3.1. PARAMETRAGE PROGICIEL ..................................................................................................... 11
3.2. TACHES PLANIFIEES ............................................................................................................... 12
3.3. PARAMETRAGE CONNECTEUR IE ............................................................................................ 12
3.4. CONTROLE D’ACTIVATION ....................................................................................................... 21
3.5. PARAMETRAGE MULTI-BASE................................................................................................... 22
4. PARAMETRAGE PROGICIEL TRANSPORT ............................................................................ 23
4.1. EVENEMENT .......................................................................................................................... 23
4.2. CONFIGURATION .................................................................................................................... 23
4.3. EVENEMENT IE ...................................................................................................................... 26
4.4. FICHE MATERIEL.................................................................................................................... 27
4.5. FICHE SALARIE ...................................................................................................................... 28
4.6. ETAT DES DOCUMENTS .......................................................................................................... 29
5. SUITE PROGICEL ..................................................................................................................... 31
5.1. ENVOI DE MISSION ................................................................................................................. 31
5.2. ENVOI MESSAGE LIBRE .......................................................................................................... 31
5.3. RETOUR D’INFORMATIONS ...................................................................................................... 32
5.4. INFO MOBILE ......................................................................................................................... 34
5.5. CARTOGRAPHIE ..................................................................................................................... 35
5.6. COMPTEUR & KILOMETRAGE .................................................................................................. 36
5.7. GESTION DES TEMPS ............................................................................................................. 36
5.8. GESTION DES ENSEMBLES ...................................................................................................... 38
6. OUTIL DE MISE A JOUR .......................................................................................................... 40
6.1. LANCEMENT MISE A JOUR ...................................................................................................... 40
6.2. INFORMATIONS COMPLEMENTAIRES ........................................................................................ 41
6.3. MISE EN MAINTENANCE .......................................................................................................... 42
7. SIMULATEUR ET MODE AUTONOME ..................................................................................... 44
7.1. PRESTATAIRE AUTONOME ...................................................................................................... 44
7.2. PARAMETRAGE PROGICIEL METIER ......................................................................................... 46
7.3. JEU D’ESSAI .......................................................................................................................... 47
8. ARRET REDEMARRAGE AUTOMATIQUE .............................................................................. 48
8.1. CHECK LIST DES FICHIERS...................................................................................................... 48
8.2. ARRET CONNECTEUR IE ........................................................................................................ 49
8.3. REDEMARRAGE CONNECTEUR IE............................................................................................ 50

© AKANEA Développement Page 2 sur 133


Connecteur IE
TMS Suite

8.4. REDÉMARRAGE MACHINE ....................................................................................................... 51


8.4.1. Windows 2008 et Seven ................................................................................................ 52
9. PRESTATAIRE IE...................................................................................................................... 54
9.1. AVANT-PROPOS .................................................................................................................... 54
9.2. AKANEA STD ...................................................................................................................... 54
9.2.1. Prérequis ....................................................................................................................... 54
9.2.2. Synthèse des Fonctions ................................................................................................ 55
9.2.3. Evénements Traités....................................................................................................... 55
9.2.4. Configuration du connecteur IE ..................................................................................... 56
9.2.5. Sabatier ......................................................................................................................... 56
9.2.6. Ubidata .......................................................................................................................... 60
9.2.7. Strada............................................................................................................................ 63
9.3. TOMTOM ............................................................................................................................... 64
9.3.1. Synthèse des Fonctions ................................................................................................ 64
9.3.2. Evénements Traités....................................................................................................... 65
9.3.3. Configuration Connecteur IE ......................................................................................... 65
9.3.4. Exemple Affichage......................................................................................................... 66
9.4. GREENCAT ........................................................................................................................... 68
9.4.1. Synthèse des Fonctions ................................................................................................ 68
9.4.2. Evénements Traités....................................................................................................... 69
9.4.3. Configuration du connecteur IE ..................................................................................... 69
9.4.4. Exemple Affichage......................................................................................................... 71
9.4.5. Particularités.................................................................................................................. 75
9.5. GREENCAT MUT .................................................................................................................. 76
9.6. QUALCOMM QTRACS (QUALCOMM 1) .................................................................................... 76
9.6.1. Synthèse des Fonctions ................................................................................................ 76
9.6.2. Evénements Traités....................................................................................................... 77
9.6.3. Configuration du connecteur IE ..................................................................................... 78
9.6.4. Macro Standard ............................................................................................................. 82
9.7. QUALCOMM OMNIEXPRESS (QUALCOMM 2) ......................................................................... 84
9.7.1. Synthèse des Fonctions ................................................................................................ 84
9.7.2. Evénements Traités....................................................................................................... 85
9.7.3. Configuration du connecteur IE ..................................................................................... 85
9.7.4. Exemple Affichage......................................................................................................... 87
9.7.5. Particularités.................................................................................................................. 89
9.8. ELOMOBILE V2 ...................................................................................................................... 89
9.8.1. Synthèse des Fonctions ................................................................................................ 89
9.8.2. Evénements Traités....................................................................................................... 90
9.8.3. Configuration du connecteur IE ..................................................................................... 90
9.8.4. Particularités.................................................................................................................. 90
9.9. ELOMOBILE V3 ...................................................................................................................... 91
9.9.1. Synthèse des Fonctions ................................................................................................ 91
9.9.2. Evénements Traités....................................................................................................... 92
9.9.3. Configuration du connecteur IE ..................................................................................... 92
9.9.4. Exemple Affichage......................................................................................................... 95
9.9.5. Particularités.................................................................................................................. 97
9.10. TRANSICS .......................................................................................................................... 97
9.10.1. Synthèse des Fonctions ............................................................................................. 97
9.10.2. Evénements Traités ................................................................................................... 98
9.10.3. Configuration du connecteur IE .................................................................................. 98
9.10.4. Exemple Affichage ................................................................................................... 100
9.10.5. Contenu Mission ...................................................................................................... 102

© AKANEA Développement Page 3 sur 133


Connecteur IE
TMS Suite

9.10.6. Particularités ............................................................................................................ 103


9.11. TRANSICS TXCONNECT (API TANGO) .............................................................................. 106
9.11.1. Synthèse des Fonctions ........................................................................................... 106
9.11.2. Evénements Traités ................................................................................................. 107
9.11.3. Configuration du connecteur IE ................................................................................ 107
9.11.4. Exemple Affichage ................................................................................................... 109
9.11.5. Particularités ............................................................................................................ 111
9.12. FLEETBOARD ................................................................................................................... 113
9.12.1. Synthèse des Fonctions ........................................................................................... 113
9.12.2. Evénements Traités ................................................................................................. 114
9.12.3. Configuration Connecteur IE .................................................................................... 114
10. COMPLEMENT CONNECTEUR IE.......................................................................................... 117
10.1. INSTALLATION MULTI-BASE IE POUR UN MEME PRESTATAIRE................................................ 117
10.2. VUE DE CONTROLE ........................................................................................................... 117
10.3. CONCATENATION .............................................................................................................. 119
10.3.1. Activation ................................................................................................................. 120
10.3.2. Paramétrage ............................................................................................................ 121
10.4. CHAMPS LIBRES ............................................................................................................... 123
10.5. CONTENUE MISSION ......................................................................................................... 123
10.6. ORDRE D’ENVOI DES MISSIONS .......................................................................................... 128
10.7. CODE ISO DES PAYS ........................................................................................................ 129
10.8. ELEMENTS TECHNIQUES ................................................................................................... 130
10.8.1. Description ............................................................................................................... 130
10.8.2. Paramétrage des fichiers de transformation XSLT ................................................... 130
10.8.3. Trace ........................................................................................................................ 131
10.8.4. Gestion de fichiers.................................................................................................... 131
11. RETOUR SOMMAIRE AIDE TRANSPORT 14 ........................................................................ 133

© AKANEA Développement Page 4 sur 133


Connecteur IE
TMS Suite

1. INTRODUCTION

Le connecteur IE est l’outil qui permet aux progiciels métiers Suite et Entreprise de
communiquer avec différents prestataires d’informatique embarquée. Les éléments de paramétrages
sont génériques mais la disponibilité de l’information peut varier d’un prestataire IE à un autre.

Poste Utilisateur Poste Utilisateur


Transport Transport

Connecteur IE

Serveur Progiciel
(Suite ou Entreprise)
Transport

Prestataire IE

© AKANEA Développement Page 5 sur 133


Connecteur IE
TMS Suite

2. INSTALLATION CONNECTEUR IE

2.1. PRE REQUIS


Avant l’installation du connecteur IE, le serveur doit être configuré comme un serveur TSE, c’est-à-dire
avec son propre lecteur M:\ et mis en serveur de réplication sur le serveur de DB.
2.2. INSTALLATION CONNECTEUR IE

Il faut impérativement être connecté avec le compte local administrateur avant de lancer
l’installation et il est nécessaire de vérifier si la machine sur laquelle est faite l’installation a bien un m:\
mappé sur le progiciel métier.

Une fois le Setup lancé, il faut cliquer sur suivant,

© AKANEA Développement Page 6 sur 133


Connecteur IE
TMS Suite

Le chemin d’installation qui doit être C:\Chemin_TMSV14\iemdw\ et cliquez sur suivant,

Cliquez sur suivant,

Cliquez sur suivant,

© AKANEA Développement Page 7 sur 133


Connecteur IE
TMS Suite

Une fois la mise en place du progiciel terminée, cliquez sur « Terminer » en laissant cocher
« Installer le Core en tant que service ».

Une fois l’installation terminer un nouveau répertoire « IEmdw » est créé sur m: qui contient
l’ensemble des programmes.

2.3. VERIFICATION

Il faut contrôler que le service Windows « Akanea Connecteur IE » soit bien installé et démarré.

2.4. BROKER

Pour que le progiciel puisse réaliser certains traitements il est nécessaire d’installer un broker.
Si un broker est déjà présent cette installation n’est pas nécessaire, sinon il faut installer la partie client
du progiciel Transport Suite et paramétrer un broker (voir documentation « Process »).

2.5. MISE A JOUR PROGICIEL METIER

© AKANEA Développement Page 8 sur 133


Connecteur IE
TMS Suite

Avant d’activer le Connecteur IE, il est conseillé de mettre à jour le progiciel métier afin de
bénéficier des dernières fonctionnalités.

2.6. ACTIVATION BASE CONNECTEUR IE

L’étape précédente a permis d’installer les programmes. Ces programmes vont s’appuyer sur
une base de données dédiée au Connecteur IE.

L’outil d’installation va créer un nouveau fichier « properties » pour l’OpenEdge Explorer. Si


l’installation des bases actives n’a pas été réalisée en automatique par « Akanea Configuration », dès
lors avant de lancer l’installation de la base, il faut relever les paramètres actuels afin de les refaire
une fois l’installation terminée.
« Akanea configuration » doit être exécuté depuis le serveur de base de données. Comme cette
opération utilise « Akanea Configuration » qui manipule des bases de données, il est conseillé de faire
une sauvegarde de la base de données du progiciel métier et de faire sortir les utilisateurs le temps de
la création de la base de données du Connecteur IE.

Pour lancer l’installation il faut aller dans Akanea configuration et sélectionnez Base de
données du Connecteur IE.

Sélectionnez la base de données qui sera attachée au connecteur IE puis cliquez sur appliquer.

Dès lors l’outil va lancer la création et le branchement d’une nouvelle base EUROBASE_IE qu’il
faut prendre en compte dans le plan de sauvegarde.
Il faut planifier le lancement du SaveConnecteurIE se trouvant dans TMS\DB\Utils au même titre que
le saveeuro et penser à sauvegarder la base.

© AKANEA Développement Page 9 sur 133


Connecteur IE
TMS Suite

Lancez une réplication des fichiers via le batch ReplicationGlobale.cmd se trouvant


sur m:\tms\

© AKANEA Développement Page 10 sur 133


Connecteur IE
TMS Suite

3. ACTIVATION COMMUNICATION PROGICIEL/CONNECTEUR IE

3.1. PARAMETRAGE PROGICIEL

Dans un premier temps il faut renseigner le numéro de série permettant d’activer de wizard
« Connecteur Informatique Embarquée ».

Une fois le wizard activé il faut l’ouvrir sur la machine où se trouve le Connecteur IE. La base du
connecteur IE choisie, il faut faire suivant (le bouton Test connexion n’est opérationnel qu’une fois
l’ensemble paramétré).

Mettre un identifiant de la base : par exemple 1 pour la première base.

Faire suivant jusqu’à la dernière fenêtre de configuration.

© AKANEA Développement Page 11 sur 133


Connecteur IE
TMS Suite

Choisir un compte qui servira à lancer les tâches planifiées, son mot de passe et le chemin UNC du
connecteur IE.

Cliquer ensuite sur créer les tâches planifiées sélectionnées.

Cliquer sur Appliquer.


3.2. TACHES PLANIFIEES

Vérifier la présence des 3 tâches planifiées ci-dessous :

3.3. PARAMETRAGE CONNECTEUR IE

Avant de paramétrer le Connecteur IE, il est préférable de mettre à jour le connecteur IE, pour
bénéficier de tous les prestataires et de leur fonctionnalité.

Pour finir la configuration il faut double cliquez sur le raccourci « Akanea Connecteur I.E ». Le
connecteur IE s’ouvre. Cette application fonctionne sur le principe d’un service. Quand il est lancé une

icône apparaît dans la barre de tâche.

© AKANEA Développement Page 12 sur 133


Connecteur IE
TMS Suite

Une fois le connecteur ouvert, il faut paramétrer différents éléments pour que celui-ci fonctionne
correctement. Dans un premier il faut le paramétrer en mode autonome afin de valider la
communication entre le progiciel et le connecteur IE.

Pour commencer la configuration il faut aller dans le menu « Configuration/Wizard » ou faire


F9.

Une fenêtre s’ouvre, il faut laisser les valeurs pas défaut et cocher « Activation de la console »
si la case n’est pas cochée, puis cliquer sur suivant.

Une nouvelle fenêtre s’ouvre. Pour activer un prestataire, il faut double cliquer sur une ligne
correspondant au prestataire. Pour l’activer en mode autonome il faut choisir le prestataire
« Autonome ».

© AKANEA Développement Page 13 sur 133


Connecteur IE
TMS Suite

Une nouvelle fenêtre s’ouvre, pour activer le prestataire, il faut cocher la case « Actif », puis cliquer
sur suivant. Les autres paramètres sont les paramètres par défaut à conserver.

© AKANEA Développement Page 14 sur 133


Connecteur IE
TMS Suite

Une nouvelle fenêtre s’ouvre contenant une liste de paramétrage. Seules les fonctions disponibles
pour un prestataire sont actives. La zone « Calcul Données Sociales» doit être cochée pour les
prestataires qui fournissent des éléments liés au temps de service et si ces éléments doivent alimenter
les temps cumulés (jour, semaine, mois). Dans ce cas le connecteur IE fera les cumuls qui seront
configurés dans le wizard suivant.

Une nouvelle fenêtre s’ouvre. Sur ce nouvel écran cliquez sur suivant. Une nouvelle fenêtre
s’ouvre avec des paramètres techniques et de connexions. En effet si on choisit le prestataire « X »
avec lequel on communique avec un lien ODBC, il faudra bien renseigner par exemple l’adresse IP du
serveur, le nom de la base de donnée un login et un mot de passe. Chaque prestataire à ces propres
paramètres, pour déterminer les paramètres à sélectionner il faut parcourir la liste, dès qu’une chaîne
est encadrée par % c’est que c’est un paramètre à renseigner en fonction du prestataire et de
l’installation. Pour renseigner les paramètres il faut double cliquer sur le chiffre un écran s’ouvre, il
suffit de renseigner les valeurs. Une fois les paramètres renseignés il suffit de cliquer sur « Terminé ».

© AKANEA Développement Page 15 sur 133


Connecteur IE
TMS Suite

Mettre le même chemin pour la partie Input.

Si des paramètres ont été oubliés un message d’alerte apparait, indiquant les variables non
renseignées.

Une fois l’écran de paramétrage du prestataire validé on revient sur l’écran initial, il suffit alors
de cliquer sur suivant. Dès lors un écran apparait présentant la liste des progiciels transports présents.
Pour configurer les fonctions de transformation entre le progiciel métier et le connecteur IE, il faut
double cliquer sur la ligne correspond au progiciel.

© AKANEA Développement Page 16 sur 133


Connecteur IE
TMS Suite

Un écran s’ouvre, pour activer les fonctions de communication il faut cocher « Actif ».

© AKANEA Développement Page 17 sur 133


Connecteur IE
TMS Suite

Ensuite il faut cliquer sur le bouton Progiciel. Un nouvel écran s’ouvre il faut cocher actif puis
cliquer sur le bouton « Paramètres ».

© AKANEA Développement Page 18 sur 133


Connecteur IE
TMS Suite

Une nouvelle fenêtre s’ouvre, où il faut renseigner la chaîne de connexion à la base de données
du progiciel (le login et le password sont PUB). La chaîne de connexion est paramétrée par défaut par
l’installeur.

Une fois cet écran paramétrer cliquer sur terminer pour revenir à l’écran précédent, puis encore
sur terminer. Sur le nouvel écran affiché, il faut cliquer sur le bouton « Ajout » pour sélectionner le
prestataire actif pour ce progiciel qui sera dans un premier temps autonome et renseigner dans la zone
fichier « queriesprestataires.properties » correspondant à la configuration du progiciel Transport Suite.
Une fois l’opération finie dès lors il faut cliquer sur Terminer.

© AKANEA Développement Page 19 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 20 sur 133


Connecteur IE
TMS Suite

3.4. CONTROLE D’ACTIVATION

Pour contrôler si le paramétrage réalisé est opérationnel il faut, dans le menu du connecteur
IE, cliquer sur « Démarrer », dès lors une icône verte apparaît, dès lors le connecteur IE est actif
(l’affichage de l’icône peut prendre quelques secondes).

Ensuite il faut aller dans le wizard Connecteur Informatique Embarquée dans le progiciel et
cliquer sur « Test Connexion », un message d’alerte apparaît indiquant le bon fonctionnement.

Pour finir, suivant les prestataires le Connecteur IE peut être amené à lire des fichiers,
notamment pour le social. Même si il a été paramétré un chemin UNC dans le Connecteur IE, il est
nécessaire de monter le lecteur réseau correspondant, sur la session Windows utilisant le connecteur
IE.

© AKANEA Développement Page 21 sur 133


Connecteur IE
TMS Suite

3.5. PARAMETRAGE MULTI-BASE

Le Connecteur IE est une plateforme de communication. Il permet plusieurs type de configuration,


une base progiciel métier pour un prestataire IE, une base progiciel métier pour plusieurs prestataires
IE, et enfin plusieurs bases progiciel métier pour un ou des prestataires IE. Ce dernier cas nécessite
un paramétrage complémentaire, car le Connecteur IE ne pourrait ne pas savoir à quelle base
retournée l’information car dans les 2 bases le véhicule existe.

Ce préfixe ne change pas le fait qu’un code IE matériel est unique, c'est-à-dire que si dans la base
1 on renseigne un code IE 16, dans la base 2 il ne sera pas possible de renseigner un code IE 16 sur
une fiche matériel.

La mise en place du paramétrage nécessite qu’aucun véhicule de la base ne soit actif dans le
Connecteur IE. Si tel était le cas dans un premier temps il faut retirer dans le progiciel métier sur les
fiches matériel et salarié la correspondance IE. Une fois cela fait, il faut aller dans le wizard du
connecteur IE, et saisir un préfixe. Ce préfixe sera attribué à toutes les données envoyées depuis le
progiciel métier au Connecteur IE. Ce préfixe doit être constitué de 4 caractères alphanumériques et il
doit être unique (si la base 1 à la préfixe BAS1, la base 2 doit avoir un préfixe différent de BAS1).

Lors de la validation du wizard, un message apparaît. En effet une fois ce paramètre activé, il
est impossible de revenir en arrière. Donc un message de confirmation apparaît. Pour des questions
de sécurité et d’erreur de manipulation, réponde « Oui » annule la saisie de préfixe, et répondre
« Non » active le mode.

© AKANEA Développement Page 22 sur 133


Connecteur IE
TMS Suite

4. PARAMETRAGE PROGICIEL TRANSPORT

4.1. EVENEMENT

Il est possible de tracer et d’afficher dans le progiciel métier, quand un exploitant a fait envoi de
mission dans le Connecteur IE. Pour cela il faut créer un événement dans le menu Fichier de
base\paramètres Généraux\document\événement.

4.2. CONFIGURATION

© AKANEA Développement Page 23 sur 133


Connecteur IE
TMS Suite

3 4

1- Saisir le code événement qui a été paramétré dans le paragraphe précédent


2- Ces zones permettent d’identifier le code événement lié à une mission qui définit le début du voyage
et la fin d’un voyage, cela permettra de définir quelles valeurs de compteur seront prises en compte
pour le calcul des kilomètres IE (compteur de début de voyage IE = 123400, compteur de fin de voyage
IE = 123800 donc Km IE du voyage 123800 – 123400 = 400). Les événements définis ci-dessous
peuvent si la case est cochée être posés sur le voyage afin d’être visible sur le planning graphique par
exemple
3- Ces cas permettent de définir les missions qui seront envoyées dans le camion. Par défaut les
missions liées à un point de chargement à un point de livraison et les points générés par la fonction
« Dépose à qui » ne peuvent être exclus. Exclusion Voyage permet de ne pas envoyer la mission
correspondant au début et à la fin du voyage. Exclusion voyage segment permet de ne pas envoyer la
mission correspondant au début et à la fin du voyage si elle correspond à la mission d’un segment (cas
d’un lot complet). Les exclusions « passage à quai » (à ne pas confondre avec dépose à quai) et
« relais » correspondent aux missions des villes de rupture des segments. Si la ville de rupture du
segment de la mission correspond à un tiers de quai (voir traitement Tiers de quai de la fiche Tiers) et
que le porteur ou la remorque (précédent pour une ville de départ ou suivant pour une ville d’arrivée)
est différent du voyage traité, la mission sera une mission de passage à quai car dans ce cas on
considère que l’on décharge ou que l’on recharge la marchandise. Les autres cas correspondent à des
missions de relais.
4- Quand on rend actif ou inactif une fiche matériel ou salarié, une sécurité contrôle que la ressource
en question n’est pas sur un voyage en cours dans le Connecteur IE. Il est possible de désactiver cette
sécurité en cochant la case « Désactive le contrôle des ressources ».

Pour choisir le mode dans un premier temps il est conseillé de ne cocher aucune exclusion dans
un premier temps et de les activer au fur et à mesure des besoins.

© AKANEA Développement Page 24 sur 133


Connecteur IE
TMS Suite

1- Permet de définir le numéro du broker qui communiquera avec le connecteur IE. Une fois le broker
défini, il n’est pas nécessaire de programmer des requêtes. Le broker ne sert pas pour l’envoi mais
uniquement pour la récupération. La zone « Horaire récupération cumuls données sociales » permet
de définir les heures de déclenchement de récupération des compteurs et des temps de services du
voyage (08 :00,09 :00,10 :00). Les autres retours (géopositionnement, statut, temps) se font à chaque
fois que le broker se déclenche.
2- Permet de définir quels évènements il faut prendre en compte pour les champs formule du catalogue
des voyages (détail voir chapitre « Retour d’informations »).

© AKANEA Développement Page 25 sur 133


Connecteur IE
TMS Suite

1- Permet de paramétrer de définir quels sont les événements à prendre en compte dans le calcul du
champ formule « Missions non traitées » du catalogue des voyages (détail voir chapitre « Retour
d’informations »).
2- Permet d’automatiser la création d’ensemble lors de l’intégration de géopositionnement IE. La mise
en œuvre de cette option demande une période d’essai pour valider son fonctionnement car sa
pertinence varie suivant les prestataires IE et d’une entreprise à une autre.
3- Dès que l’on modifie des éléments d’exploitation sur une mission, il faut à nouveau envoyer la
mission via le traitement d’envoi de missions afin que le connecteur IE renvoi les nouveaux éléments
au prestataire d’IE. Il est possible d’automatiser ce renvoie en cochant la case « Synchronisation
automatique ». Si la case est cochée et qu’un voyage a un ordre en plus ou en moins ou si le code
chauffeur ou moteur du voyage change, dès lors les informations sont envoyées au connecteur IE qui
renvoie à son tour les informations au prestataire IE. Cette action ne s’applique qu’aux voyages déjà
envoyés. Cette option simplifie le travail des utilisateurs et évite les oublies d’envoi par contre elle
multiplie les nombre de messages envoyés au prestataire. Quand un voyage est totalement déplanifié
et que donc il n’a plus d’existence en termes d’exploitation dès lors que l’on soit en mode synchronisé
ou pas, l’ordre de suppression est envoyé en direct au connecteur IE.
4- Quand le connecteur IE est mis à jour, une sécurité est activée. Cette sécurité empêche le progiciel
métier de se connecter à l’informatique embarquée durant la mise à jour. Il peut arriver, une fois la
mise à jour terminée, que la sécurité reste active. Si le connecteur IE est opérationnel dès il suffit de
cliquer sur le bouton « Désactiver la mise ne maintenance ».

4.3. EVENEMENT IE

© AKANEA Développement Page 26 sur 133


Connecteur IE
TMS Suite

La fiche événement permet de traduire un statut en un élément d’exploitation et visuel. En effet


le prestataire IE attribue un Start (mission commencée) sans forcément savoir si c’est un chargement
ou une livraison. Il est possible par le paramétrage du progiciel d’avoir un événement début de
chargement et un événement début de livraison en créant un événement suivant le type de mission (
le Start d’une mission de chargement devant l’événement Début de chargement, le Start d’une mission
de livraison devant l’événement de Début de livraison.

Code : cette zone permet de définir un code propre au progiciel métier


Libellé : cette zone permet de donner un libellé propre au progiciel métier
Dépose sur l’ordre : si cette case est cochée la pose de cet événement sur une mission déclenchera
aussi la pose d’un événement sur l’ordre
Dépose sur le segment : si cette case est cochée la pose de cet événement sur une mission
déclenchera aussi la pose d’un événement sur l’ordre
Icône aux suivis : logo de l’événement
Couleur aux suivis : couleur de l’événement affichée sur le suivi des missions
Type de mission : La zone type de mission permet d’affiner la traduction des éléments fournis par le
connecteur IE. En effet sur une mission le connecteur peut recevoir mission commencée ou mission
terminée. Dans le progiciel métier il est possible de dire si c’est une mission de chargement et qu’elle
est commencé alors c’est l’événement chargement en cours par exemple.
Evénement par défaut : Cette zone permet de définir à quel événement venant de l’IE correspond le
paramétrage réalisé.

4.4. FICHE MATERIEL

© AKANEA Développement Page 27 sur 133


Connecteur IE
TMS Suite

Dans chaque fiche matériel, il faut renseigner la correspondance entre le numéro du véhicule
dans le progiciel métier et celui de l’informatique embarquée. Cette opération est à réaliser avec le
traitement Informatique Embarquée. Si cette référence n’existe pas dans le progiciel d’informatique
embarquée il faut renseigner la correspondance avec le code du progiciel métier.

S’il y a des missions IE « en cours » utilisant la ressource sélectionnée, la zone identifiant est
grisée. Les critères, qui grisent la zone, sont l’existence de mission IE qui utilise la ressource
sélectionnée et qui ont un événement de type START ou STARTL (mission commencée) mais qui
n’ont pas un événement de type DONE ou DONEL (mission terminée).

Si un voyage contenant la ressource a été envoyé au connecteur IE, et que l’on change
l’identifiant, il est conseillé d’envoyer à nouveau le voyage au connecteur IE.

Le code IE du matériel est unique, il ne peut y avoir plusieurs codes matériel avec le même
code IE au sein d’une même base. Le fait de décocher dans la fiche matériel la case « Actif », retire le
code IE de la fiche matériel et donc désactive la fiche matériel dans le connecteur IE. Si des missions
sont « en cours » (voir paragraphe précédent), dès lors il ne sera pas possible de désactiver la fiche
matériel. Il est possible de contourner ce dernier blocage en cochant la case « Désactive le contrôle
des ressources » dans le wizard de configuration.

4.5. FICHE SALARIE

Dans chaque fiche salarié, il faut renseigner la correspondance entre le numéro du véhicule
dans le progiciel métier et celui de l’informatique embarquée. Cette opération est à réaliser avec le
traitement Informatique Embarquée. Si cette référence n’existe pas dans le progiciel d’informatique
embarquée il faut renseigner la correspondance avec le code du progiciel métier.

© AKANEA Développement Page 28 sur 133


Connecteur IE
TMS Suite

S’il y a des missions IE « en cours » utilisant la ressource sélectionnée, la zone identifiant est
grisée. Les critères, qui grisent la zone, sont l’existence de mission IE qui utilise la ressource
sélectionnée et qui ont un événement de type START ou STARTL (mission commencée) mais qui
n’ont pas un événement de type DONE ou DONEL (mission terminée).

Si un voyage contenant la ressource a été envoyé au connecteur IE, et que l’on change
l’identifiant, il est conseillé d’envoyer à nouveau le voyage au connecteur IE.

Le code IE de la fiche salarié est unique, il ne peut y avoir plusieurs codes salarié avec le même
code IE au sein d’une même base. Le fait de décocher dans la fiche salarié la case « Actif », retire le
code IE de la fiche salarié et donc désactive la fiche salarié dans le connecteur IE. Si des missions
sont « en cours » (voir paragraphe précédent), dès lors il ne sera pas possible de désactiver la fiche
salarié. Il est possible de contourner ce dernier blocage en cochant la case « Désactive le contrôle des
ressources » dans le wizard de configuration.

4.6. ETAT DES DOCUMENTS

Dans le menu fichier de base, paramètres généraux, document, état des documents, il est
possible sur les documents de type IE de paramétrer les couleurs qu’auront les lignes de mission
suivant leur état.

© AKANEA Développement Page 29 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 30 sur 133


Connecteur IE
TMS Suite

5. SUITE PROGICEL

Les opérations décrites sont liées aux fonctions du progiciel transport et ne tiennent pas compte
des contraintes de chacun des prestataires.

5.1. ENVOI DE MISSION

L’envoi de mission se fait à partir du traitement « Envoi de Mission » disponible dans le suivi
des voyages et dans le planning cartographique. Ce traitement écrit les missions dans le suivi des
missions du progiciel métier et dans le connecteur IE qui le met à disposition du prestataire dans la
secondes qui suivent.

Pour visualiser les missions envoyées il faut soit faire un F2 du suivi des voyages vers le suivi
des missions, ou faire une recherche dans le suivi des missions.

Quand une mission a été envoyée si le wizard a été configuré, un événement a été posé sur le
voyage pour indiquer que ce voyage a été transmis au prestataire. Il est dès lors possible d’afficher
cet événement et ou de faire des recherche dans le suivi des voyages sur cet événement.

5.2. ENVOI MESSAGE LIBRE


Pour envoyer un message libre il faut soit cliquer sur l’icône nouveau dans le suivi des missions,
saisir le message et faire OK.

© AKANEA Développement Page 31 sur 133


Connecteur IE
TMS Suite

Soit le Planning Cartographique est activé et dans ce cas en cliquant sur l’icône représentant
le camion il est possible de saisir un message libre et de l’envoyer.

5.3. RETOUR D’INFORMATIONS

Les retours d’informations sont visibles sous forme d’événement sur la mission et suivant leur
paramétrage ils sont aussi visibles sur l’ordre et le segment.

Dans le suivi des missions il est possible des visualiser les missions et à l’aide d’un jeu de
couleur de voir leur état (mission commencée, terminée ..).

De plus il est possible de paramétrer le « Mes événements » pour faire afficher les 10
principaux événements à suivre. Dès lors si l’événement est présent la colonne prend la couleur de
l’événement et contient la date et heure de l’événement correspondant à la date et heure renvoyé par
le prestataire.

© AKANEA Développement Page 32 sur 133


Connecteur IE
TMS Suite

Il est possible aussi de voir le détail des événements d’une mission en faisant une F2 vers le
suivi des événements IE.

Enfin dans le catalogue voyage plusieurs champs formules contenant des informations liées au
retour de mission du voyage sont disponibles.

- Missions non traitées : nombre de missions du voyage dont le dernier événement fait partie de la liste
définit dans le wizard « Connecteur IE » du menu Système/Configuration.

© AKANEA Développement Page 33 sur 133


Connecteur IE
TMS Suite

- Missions terminées : Nombre de mission d’un voyage qui ont comme statut « Effectué » ou « Effectué
avec réserve ».

- Missions terminées avec réserve : Nombre de mission d’un voyage qui ont comme statut « Effectué
avec réserve ».

- Missions en cours : Nombre de mission d’un voyage qui ont comme statut « Commencé » ou
« Commencée avec Réserve ».

- Nombre de mission du voyage : Nombre de missions générées du voyage.

En complément à ces champs formules il est possible d’activer d’autres champs formules. Pour
les activer il faut aller dans le menu Système/Configuration, ouvrir le wizard Connecteur IE et aller sur
la deuxième fenêtre. Dans cet écran il est possible de paramétrer 15 événements. Le paramétrage
d’un événement va créer 2 champs formules par événements disponibles dans le catalogue du voyage.
Le premier type compte le nombre de mission ayant le code événement paramétré, son nom dans le
catalogue est « Nb de » + libellé de l’événement. Le deuxième type compte le nombre de mission
ayant comme dernier événement l’événement paramétré, son nom dans le catalogue est «Nb dernier »
+ libellé de l’événement.

5.4. INFO MOBILE

La fonction Info Mobile est disponible dans le menu général Info Embarquée ou via un
traitement dans le suivi des voyages « Info Mobile ». Ce traitement affiche une synthèse sur une
ressource en fonction d’information venant de l’informatique embarquée.

© AKANEA Développement Page 34 sur 133


Connecteur IE
TMS Suite

5.5. CARTOGRAPHIE

Les outils de cartographie permettent d’afficher des informations en lien avec l’informatique
embarquée, un ballon ayant la couleur du dernier événement IE apparait sur le dernier événement IE,
en cliquant sur le ballon un écran s’ouvre présentant un ensemble d’information (voir documentation
« Gestion des KM & Cartographie »).

© AKANEA Développement Page 35 sur 133


Connecteur IE
TMS Suite

5.6. COMPTEUR & KILOMETRAGE

Suivant les données fournies par les prestataires, les compteurs liés au positionnement ou aux
événements sont récupérés. Ces compteurs alimentes dans un premier temps le menu
Parc/Ensembles&Compteurs/Compteurs. Ces compteurs sont donc pris en compte dans les
statistiques du parc. De plus si les événements marquant de départ et l’arrivée du voyage sont
paramétrés dans le wizard dès lors les champs Kilométrage IE et Kilométrage Approche IE sont
alimentés et permettent de connaître les kilomètres IE d’un voyages. Pour définir le kilométrage d’un
voyage le progiciel prend en compte le compteur du premier événement de type début de mission et
le compteur du dernier événement de type fin de mission. La différence entre les deux compteurs
fournis le kilométrage du voyage. Pour le kilométrage d’approche, le progiciel prend en compte le
compteur de début du voyage en cours et le compteur de fin du voyage précédent. Ces champs sont
disponibles dans le catalogue voyage.

5.7. GESTION DES TEMPS

Au-delà des cumul des temps présents sur l’écran info mobile, sur l’écran de positionnement
IE disponible sur la cartographie, sur l’écran d’affectation avec alerte, et sur la liste des disponibilités
chauffeur, les temps de service au voyages sont disponibles. Ces temps sont récupérés avec les
prestataires fournissant le détail des temps de services. Le temps de service est calculé sur la
fourchette de temps de service compris entre la date et heure du premier événement IE du voyage et
le dernier événement IE du voyage. Le champ alimenté sur le voyage peut être utilisé pour les calculs
de coûts et il est disponible dans le catalogue du suivi des voyages.

© AKANEA Développement Page 36 sur 133


Connecteur IE
TMS Suite

De plus sur chaque mission il est possible de mesurer le temps d’une mission. Pour cela le
progiciel fait la différence entre la date et heure de l’événement de début et fin de mission. Ce temps
est disponible en minute dans le champ « Durée de la mission » du catalogue IE Mission du suivi des
missions. Par exemple il est possible en faisant une rupture sur l’expéditeur, le destinataire ou le client
de mesurer le temps passé par mission.

Enfin sur l’écran d’affectation avec alerte des indicateurs liés au temps de service sont affichés.
La zone « Heb réalisé » affiche le cumul les temps de services (lié à l’informatique) du chauffeur de la
semaine (en fonction de la date du jour). La zone « Mensuel réalisé » affiche le cumul les temps de
services (lié à l’informatique) du chauffeur du mois (en fonction de la date du jour). La zone « H.R +
Estimé » est la somme des temps de services théorique du voyage plus les temps de la zone « Heb
Réalisé ». La zone « M.R + Estimé » est la somme des temps de services théorique du voyage plus
les temps de la zone « Mensuel Réalisé ».

© AKANEA Développement Page 37 sur 133


Connecteur IE
TMS Suite

De plus si dans le traitement « Temps et Législation » la temps de service hebdomadaire ou


mensuel est renseigné, un contrôle affiche ou non une alerte. Si le temps « H.R. + Estimé » est
supérieur au temps Hebdomadaire du salarié un feu rouge apparaît pour indiquer que l’on dépense le
nombre d’heure. Le même contrôle peut s’appliquer au temps mensuel.

5.8. GESTION DES ENSEMBLES

Dans le menu système/configuration/Connecteur IE, sur la troisième fenêtre il est possible


d’activer une fonction qui permet de créer des ensembles.

© AKANEA Développement Page 38 sur 133


Connecteur IE
TMS Suite

Si la case est cochée, lors de la création d’un positionnement IE, un ensemble sera créé. La
date et heure d’activation de l’ensemble sera la date et heure du positionnement. L’ensemble qui sera
créé sera un ensemble Chauffeur/Moteur. Le code chauffeur ou moteur sera directement récupéré de
l’informatique embarqué, si le code chauffeur ou moteur n’est pas présent l’ensemble ne sera pas créé.

© AKANEA Développement Page 39 sur 133


Connecteur IE
TMS Suite

6. OUTIL DE MISE A JOUR

Le connecteur IE à ses propres programmes et sa propre base et donc peut évoluer être mis à
jour indépendamment du progiciel métier.

6.1. LANCEMENT MISE A JOUR

Pour faire une mise à jour du connecteur, il faut ouvrir Akanea Support et cliquer sur l’icône de
mise à jour du connecteur IE. La mise à jour doit toujours être lancée depuis le poste qui supporte le
connecteur IE.

Rentrer en RD CD dans le support. Et lancer la MAJ du connecteur IE

© AKANEA Développement Page 40 sur 133


Connecteur IE
TMS Suite

Un nouvel écran s’ouvre. Pour faire une mise à jour, il faut cliquer sur « Lancer la mise
à jour sans téléchargement ».
Pendant cette opération il est préférable de faire sortir les utilisateurs du progiciel
Transport ou du moins de n’utiliser aucune fonction en lien avec l’informatique embarqué, et
d’arrêter le broker lié à l’IE. Les cases à cocher permettent de contrôler à la fin de la mise à
jour les opérations qui se sont exécutées.

Lors de l’installation il est conseillé de mettre à jour le connecteur IE pour :


- vérifier le fonctionnement de la mise à jour
- récupérer l’ensemble des prestataires
- récupérer l’ensemble des fonctionnalités disponibles

6.2. INFORMATIONS COMPLEMENTAIRES

La mise à jour au-delà des évolutions des programmes contient deux éléments. Ces éléments
seront visibles lors du lancement du Connecteur IE. Ils sont déduits des différences entre les fichiers
M:\IEmdw\core\Notes.properties et M:\IEmdw\core\Notes.last.

Le premier de ces éléments est la liste des évolutions fonctionnelles du connecteur IE entre la
dernière version et la nouvelle version. Ce contenu est déterminé par les écarts des versions et il est
affiché une fois la mise à jour terminée.

© AKANEA Développement Page 41 sur 133


Connecteur IE
TMS Suite

L’ensemble des commentaires sur les mises à jour apparaissent en deux familles :
Importante -> rouge
Mineure -> bleu

Le deuxième élément contient la version de Java à utiliser. Si la version Java est inférieure à
la version requise un message apparaît, et par défaut on ouvre le site de téléchargement de la dernière
version de Java.

6.3. MISE EN MAINTENANCE

Quand le connecteur IE est mis à jour, une sécurité bloque la communication entre le progiciel
transport et le connecteur IE. Si cette sécurité n’a pas été retirée à la fin de la mise à jour, des
messages apparaissent dans le progiciel pour indiquer que le connecteur IE est en maintenance.
Pour retirer cette sécurité il faut cliquer sur le « Désactiver le mise en maintenance » sur le wizard
de configuration du connecteur IE dans le progiciel Transport.

© AKANEA Développement Page 42 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 43 sur 133


Connecteur IE
TMS Suite

7. SIMULATEUR ET MODE AUTONOME

La communication entre le progiciel métier et l’informatique embarquée se fait au travers du


Connecteur IE qui sert de « Traducteur ». Un mode Autonome (Prestataire Autonome), permet de
simuler la communication avec un prestataire d’informatique embarquée fictif. Cette outil permet de
répondre à deux besoins : vérifier que la communication et que le paramétrage entre le progiciel métier
et le connecteur IE sont opérationnels.

Pour que le simulateur fonctionne, il faut que le connecteur IE soit actif, que le wizard
« Connecteur IE » du progiciel ait été validé et que le broker soit paramétré tout comme installation
réelle.

7.1. PRESTATAIRE AUTONOME

Ci-dessous les copies d’écran de paramétrage de la fiche prestataire autonome.

© AKANEA Développement Page 44 sur 133


Connecteur IE
TMS Suite

Sur l’écran ci-dessous, il faut paramétrer le chemin de dépose des missions (le chemin
paramétrer doit exister pour que le mode autonome fonctionne).

Sur l’écran ci-dessous, il faut paramétrer le chemin permettant de récupérer les événements
de missions correspondant aux missions envoyées (le chemin paramétrer doit être le même que le
chemin de dépose).

© AKANEA Développement Page 45 sur 133


Connecteur IE
TMS Suite

7.2. PARAMETRAGE PROGICIEL METIER

Dans le progiciel métier il est conseillé de créer une fiche matériel, une fiche salarié et des
fiches d’événements IE de test pour simuler l’envoi de mission et la réception des événements. Le jeu
d’essai fonctionne avec quatre événements, « SEND » pour indiquer l’envoi de mission, « START »
pour indiquer le début de mission, « DONE » pour indiquer la réalisation des missions de
déchargement, et « DONEL » pour indiquer la réalisation des missions de chargements avec réserve.

Ci-dessous liste des copies d’écran à titre d’exemple :

© AKANEA Développement Page 46 sur 133


Connecteur IE
TMS Suite

7.3. JEU D’ESSAI

La saisie du jeu d’essai permet de simuler l’envoie de missions, et de vérifier que le retour
d’information fonctionne :
- Saisir un ordre
- Affecter l’ordre au chauffeur et moteur de test
- Envoyer la mission
- Lancer le broker
- Vérifier l’état des missions (normalement les missions de chargement doivent avoir
l’événement « DONEL », et les missions de déchargement doivent avoir l’événement
« DONE ».
- En faisant F2 des missions sur le suivi des événements, on doit voir l’événement « SEND »,
« START », « DONE » ou « DONEL », si la réplication sur les ordres ou les segments a été
paramétré, il est aussi possible de vérifier la pose de ces événements

© AKANEA Développement Page 47 sur 133


Connecteur IE
TMS Suite

8. ARRET REDEMARRAGE AUTOMATIQUE

Le connecteur IE et le broker sont des outils de communication qui font appel à des
technologies diverses et variées sur des volumétries conséquentes. De plus, le Connecteur IE est
toujours en activité car il doit toujours vérifier s’il y a de la donnée à récupérer. Il ne peut fonctionner
comme un service Windows car il a besoin d’établir des connexions réseaux et donc il a besoin d’une
session. Ces différentes contraintes font que le Connecteur IE sollicite constamment le système, et il
est aussi donc dépendant du bon fonctionnement de son environnement. Même si le Connecteur IE
possède des sécurités, celles-ci ont des limites. Dans certains cas, nous pouvons être sur un
environnement possédant plusieurs machines, dont certaines, peuvent être arrêtées en entraînant en
cascade un dysfonctionnement du Connecteur IE.

Pour diminuer ces phénomènes, la solution la plus simple est d’arrêter et redémarrer la machine
et le Connecteur IE. Ces opérations peuvent être faites en automatique afin de réduire le temps
d’administration des machines.

Dans un premier il faut définir si l’on veut arrêter ou pas la machine et, si oui, sur quel créneau
Horaire. Une fois ces règles définies, il faut brancher deux tâches planifiées. La première arrêtera le
Connecteur IE automatiquement, la deuxième redémarrera la machine. Pour redémarrer le
connecteur, il faudra ajouter un programme dans les fonctions de démarrage de Windows.

Enfin il ne faut pas oublier dans la tâche planifiée du broker d’indiquer des fourchettes entre
lesquelles il ne doit pas s’exécuter pour éviter des erreurs pendant l’arrêt de la machine.

Avec la dernière version du setup, trois tâches planifiées sont créées automatiquement. Dans
le cas contraire il faut les créer.

8.1. CHECK LIST DES FICHIERS

Pour que ces opérations s’effectuent correctement, les fichiers suivant doivent être présents :

M:\IEmdw\fmInterfaces.bat (copier de M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer vers


M:\IEmdw\)

© AKANEA Développement Page 48 sur 133


Connecteur IE
TMS Suite

M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_service.exe
M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_service.ini

M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_start.bat

M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_stop.bat

8.2. ARRET CONNECTEUR IE

Pour arrêter le Connecteur IE, il faut créer une tâche planifiée qui exécute l’arrêt du connecteur
IE, cet arrêt doit être planifié 20 minutes avant l’arrêt de la machine afin de laisser le temps au
Connecteur IE de finir les tâches qu’il a commencé.

© AKANEA Développement Page 49 sur 133


Connecteur IE
TMS Suite

8.3. REDEMARRAGE CONNECTEUR IE

Pour redémarrer le Connecteur IE au démarrage de la machine, il faut faire un raccourci du


fichier « M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_start.bat » et le placer
dans le menu Windows « Démarrer\Programmes\Démarrage\ »

© AKANEA Développement Page 50 sur 133


Connecteur IE
TMS Suite

Il se peut que l’outil, s’il est branché dans le menu « Démarrage » ne fonctionne pas
correctement. En effet, si Windows n’a pas fini de charger tous les lecteurs réseaux et les services
nécessaires au moment où le Connecteur IE est démarré, dès lors il se peut que le Connecteur IE ne
démarre pas correctement. Dans ce cas il faut créer une tâche planifiée qui lance
« M:\IEmdw\core\arborescence\tools\utilities\Scie_Timer\stopStart\scie_start.bat » à l’heure
demandée.

8.4. REDÉMARRAGE MACHINE

Dans un premier temps il faut paramétrer une tâche planifiée qui exécute la commande :
shutdown -r

© AKANEA Développement Page 51 sur 133


Connecteur IE
TMS Suite

Quand une machine est redémarrée en général, la machine se redémarre et reste sur l’écran
d’ouverture de session. Il existe des méthodes pour forcer l’ouverture de la session, par contre elles
doivent être mise en place avec l’accord de l’administrateur réseau.

8.4.1. Windows 2008 et Seven

Pour activer l’ouverture de session automatique, il faut aller dans le menu Démarrer de
Windows et cliquer sur « Exécuter ». Dans la fenêtre qui s’ouvre il faut saisir « control
userpasswords2 » et cliquer sur OK.

Une nouvelle fenêtre s’ouvre, dans cette fenêtre il faut décocher « Les utilisateurs doivent
… » et valider la fenêtre.

© AKANEA Développement Page 52 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 53 sur 133


Connecteur IE
TMS Suite

9. PRESTATAIRE IE

9.1. AVANT-PROPOS

Pour paramétrer le connecteur IE il faut connaître les contraintes liées aux prestataires.
Et valider avant de réaliser la configuration si les éléments nécessaire sont disponibles (chemin
de serveur mot de passe, droits de lecture/écriture, mise à jour de la version progiciel IE si
nécessaire dans les camions et sur le serveur, …).

Il est conseillé de prendre contact avec le prestataire IE avant de commencer


l’installation afin de s’assurer des versions installées, que les boitiers soient bien à jour, d’avoir
les mots de passe et compte de connexion, et qu’il n’y ait pas de contrindication avec un
spécifique du prestataire IE.

9.2. AKANEA STD

Akanea STD est une interface permettant à un prestataire d’informatique embarqué de


communiquer avec Akanea Connecteur IE. Cette interface standardisée se présente sous la forme
d’une interface de fichier XML permettant d’envoyer des missions, des messages libres et de
réceptionner les événements liés aux missions.

9.2.1. Prérequis

Dans le cas de l’intégration du connecteur IE par un prestataire, ce dernier doit avoir accès à des
répertoires locaux sur le serveur ou se trouve le connecteur IE.

Les fichiers, générés par le connecteur IE, sont stockés dans le répertoire spécifié dans la
configuration du prestataire.

© AKANEA Développement Page 54 sur 133


Connecteur IE
TMS Suite

Les fichiers déposés par le prestataire seront mis dans .\core\arborescence\client\fichier\ « ID


CLIENT » \reception.

9.2.2. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Oui

Réception d’événements de Oui


Missions

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui
Réception Temps Oui
Hebdomadaire
Réception Temps Mensuel Oui

Réception Compteur Oui


Réception Position Oui

9.2.3. Evénements Traités

© AKANEA Développement Page 55 sur 133


Connecteur IE
TMS Suite

Liste des événements que le connecteur IE est capable de traduire.

ON_SERVER Prise en charge prestataire


SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
STARTL Commencé avec réserve
DONE Effectué
DONEL Effectué avec réserve
LITIGE Litige
INFO Information
ARRIVED Arrivée
LEAVED Départ
CONFIRMED Confirmé
NO_RECEIVE Non reçu
NO_SEND Non envoyé
NO_SUP Suppression non effectuée
CANCELED Annulé
REFUSED Refusé
BAD_FORMAT Mauvais formatage données
ERREUR En erreur
ATTENTE En attente
TRAIT_ATT En attente de traitement
EN_COURS En cours
EXCLU Exclu
NO_CHANGE Aucun changement
TRAITEMENT Traité
YET_MOD Déjà modifié
YET_SUP Déjà supprimé
EPURATION Epuration

9.2.4. Configuration du connecteur IE

Pour utiliser un prestataire avec le mode AKANEA-STD, il faut créer une fiche prestataire et la
paramétrer. Les chapitres suivants présentent par prestataire les fonctions et la configuration à faire
pour les prestataires référencés.

9.2.5. Sabatier

9.2.5.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Non

© AKANEA Développement Page 56 sur 133


Connecteur IE
TMS Suite

Réception d’événements de Oui


Missions

Réception Messages Libres Non

Réception Temps Détaillé Non


Réception Temps Journalier Non
Réception Temps Non
Hebdomadaire
Réception Temps Mensuel Non

Réception Compteur Non


Réception Position Non

9.2.5.2. Evénements Traités

ON_SERVER Prise en charge prestataire


SEND Envoyé
START Commencé
DONE Effectué
DONEL Effectué avec réserve

9.2.5.3. Fiche Prestataire et configuration

Sur l’écran présentant la liste des prestataires, il faut cliquer sur le bouton « Ajout ».

© AKANEA Développement Page 57 sur 133


Connecteur IE
TMS Suite

Un écran de paramétrage vierge apparaît. Sur cet écran il faut saisir les mêmes éléments que
la copie d’écran ci-dessous et mettre « Guest» dans la zone Nom.

Ensuite il faut cliquer deux fois sur « Suivant » et sur le dernier écran de paramétrage du
prestataire il faut définir le répertoire de communication et enfin cliquer sur « Terminer »

© AKANEA Développement Page 58 sur 133


Connecteur IE
TMS Suite

Une fois la création du prestataire terminée, sa fiche apparaît dans la liste et il est possible de
l’utiliser.

Pour finir le paramétrage il démarrer une fois le connecteur IE. Cette opération va permettre de
créer les répertoires de communication.

Les fichiers émis par le Connecteur IE (l’envoi de mission par exemple) sont posés dans un
répertoire dont le chemin est « M:\iemdw\core\arborescence\prestataire\fichier \» + « Nom du
prestataire IE » + « \ ENVOI\» + « Jour de génération du fichier. Et ils sont répliqués dans le répertoire
de communication paramétré précédemment dans la fiche prestataire, c’est dans ce répertoire que le
prestataire doit prendre les fichiers.

Exemple : « M:\iemdw\core\arborescence\prestataire\fichier\SABATIER\envoi\20100916 »

Les fichiers intégrés par le Connecteur IE (état des missions par exemple) sont récupérés dans
un répertoire dont le chemin est « M:\iemdw\core\arborescence\client\fichier\» + « Nom du client dans
le connecteur IE » + « \ RECEPTION».

Exemple : « M:\iemdw\core\arborescence\client\fichier\1STAN901493\reception »

© AKANEA Développement Page 59 sur 133


Connecteur IE
TMS Suite

9.2.6. Ubidata

9.2.6.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Non

Réception d’événements de Oui


Missions

Réception Messages Libres Non

Réception Temps Détaillé Non


Réception Temps Journalier Non
Réception Temps Non
Hebdomadaire
Réception Temps Mensuel Non

Réception Compteur Non


Réception Position Non

9.2.6.2. Evénements Traités

ON_SERVER Prise en charge prestataire


SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
DONE Effectué
DONEL Effectué avec réserve
CANCELED Annulé

© AKANEA Développement Page 60 sur 133


Connecteur IE
TMS Suite

9.2.6.3. Fiche Prestataire et configuration

Sur l’écran présentant la liste des prestataires, il faut cliquer sur le bouton « Ajout ».

Un écran de paramétrage vierge apparaît. Sur cet écran il faut saisir les mêmes éléments que
la copie d’écran ci-dessous et mettre « Guest» dans la zone Nom.

© AKANEA Développement Page 61 sur 133


Connecteur IE
TMS Suite

Ensuite il faut cliquer deux fois sur « Suivant » et sur le dernier écran de paramétrage du
prestataire il faut définir le répertoire de communication et enfin cliquer sur « Terminer »

Une fois la création du prestataire terminée, sa fiche apparaît dans la liste et il est possible de
l’utiliser.

Les fichiers émis par le Connecteur IE (l’envoi de mission par exemple) sont posés dans un
répertoire dont le chemin est « M:\iemdw\core\arborescence\prestataire\fichier \» + « Nom du
prestataire IE » + « \ ENVOI\»+ « Jour de génération du fichier. Et ils sont répliqués dans le répertoire
de communication paramétré précédemment dans la fiche prestataire, c’est dans ce répertoire que le
prestataire doit prendre les fichiers.

Exemple : « M:\iemdw\core\arborescence\prestataire\fichier\UBIDATA\envoi\20100916 »

Les fichiers intégrés par le Connecteur IE (état des missions par exemple) sont récupérés dans
un répertoire dont le chemin est « M:\iemdw\core\arborescence\client\fichier\» + « Nom du client dans
le connecteur IE » + « \ RECEPTION».

Exemple : « M:\iemdw\core\arborescence\client\fichier\1STAN901493\reception »

© AKANEA Développement Page 62 sur 133


Connecteur IE
TMS Suite

9.2.7. Strada

9.2.7.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Non

Réception d’événements de Oui


Missions

Réception Messages Libres Non

Réception Temps Détaillé Non


Réception Temps Journalier Non
Réception Temps Non
Hebdomadaire
Réception Temps Mensuel Non

Réception Compteur Non


Réception Position Non

9.2.7.2. Evénements Traités

ON_SERVER Prise en charge prestataire


RECEIVED Reçu
READ Lu
START Commencé
DONE Effectué
DONEL Effectué avec réserve

© AKANEA Développement Page 63 sur 133


Connecteur IE
TMS Suite

9.3. TOMTOM

9.3.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui Les temps journaliers sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Oui Les temps hebdomadaires sont
Hebdomadaire reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Mensuel Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui Il faut que la cartographie soit
disponible. Car Greencat
envoie une coordonnée GPS
dont il faut trouver le lieu le plus
proche.

© AKANEA Développement Page 64 sur 133


Connecteur IE
TMS Suite

9.3.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec TomTom.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
READ Lu
START Commencé
DONE Fait
INFO Information
ARRIVED Arrivée
LEAVED Départ
CONFIRMED Confirmé

9.3.3. Configuration Connecteur IE

Pour que le Connecteur IE communique avec TomTom il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de
paramétrage.

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres sont à renseigner sur l’entrée :

2-3, 3-3 : %%TOMTOMFLEES%%


Exemple (compte client): trsie

2-4, 3-4 : %%USER%%


Exemple : thirdparty

1-5, 2-5 : %%PW%%


Exemple : EXEMPLE_10532

© AKANEA Développement Page 65 sur 133


Connecteur IE
TMS Suite

1-8, 2-8 : %%USERPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-9, 2-9 : %%PWPROXY%%


Exemple (Si il n’y a___20 pas de proxy la zone doit être vidée): none

1-10, 2-10 : %%IPPROXY%%


Exemple (Si il n’y a___20 pas de proxy la zone doit être vidée): none

1-11, 2-11 : %%PORTPROXY%%


Exemple (Si il n’y a___20 pas de proxy la zone doit être vidée): none

Le paramètre 2-12, « address » si il est positionné à « true » permet d’afficher un indicateur sur
la carte de navigation TomTom. Cet indicateur correspondant aux adresses des missions envoyées.

9.3.4. Exemple Affichage

En cliquant sur l’icône « Enveloppe » on accède à la liste des missions.

© AKANEA Développement Page 66 sur 133


Connecteur IE
TMS Suite

Dans la liste des missions, on peut visualiser chacune des missions et son état grâce à un jeu
d’icône.

Il faut ouvrir la mission pour voir le détail. Pour naviguer dans le détail, il faut utiliser les flèches
positionnées à droite.

© AKANEA Développement Page 67 sur 133


Connecteur IE
TMS Suite

9.4. GREENCAT

9.4.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Modification de Missions en Non
cours
Suppression de Missions Oui Avec ou sans événement

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Non


Réception Temps Journalier Oui
Réception Temps Oui Les temps hebdomadaires sont
Hebdomadaire reconstitués par le connecteur
IE à partir des temps
journaliers, pour cela il faut
activer la gestion des DS dans
le connecteur IE
Réception Temps Mensuel Oui Les temps hebdomadaires sont
reconstitués par le connecteur
IE à partir des temps
journaliers, pour cela il faut
activer la gestion des DS dans
le connecteur IE

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui Il faut que la cartographie soit
disponible. Car Greencat
envoie une coordonnée GPS
dont il faut trouver le lieu le plus
proche.

© AKANEA Développement Page 68 sur 133


Connecteur IE
TMS Suite

9.4.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Greencat.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
READ Lu
START Commencé
STARTL Commencé avec Réserve
DONE Fait
DONEL Fait avec Réserve

9.4.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec GreenCat il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de
paramétrage.

© AKANEA Développement Page 69 sur 133


Connecteur IE
TMS Suite

Le paramétrage est à réaliser pour l’entrée 1, 2 et 3 de la partie supérieure et inférieure de


l’écran. Pour accéder au paramétrage, il faut cliquer sur la flèche positionnée devant le chiffre. Une
liste détaillée de paramètres est affichée. Il faut remplacer les chaînes qui sont entre %%. Dans le cas
de Greencat les paramètres sont ceux de la chaîne de connexion au serveur avec login et mot de
passe, le chemin de stockage de fichier concernant les temps par exemple.

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres (partie supérieure) sont à renseigner sur l’entrée :

1-2, 2-2, 3-2 : jdbc:jtds:sqlserver://%%SERVER%%/%%BASE%%;SelectMethod=cursor


Exemple : jdbc:jtds:sqlserver://192.40.1.6/GIT;SelectMethod=cursor

1-4, 2-4, 3-4 : %%USER%%


Exemple : U_GITINTERFACES

1-5, 2-5, 3-5 : %%PW%%


Exemple : agat

Les paramètres (de la fenêtre suivante) sont à renseigner sur l’entrée :

1-2, 2-2, 3-2 : jdbc:jtds:sqlserver://%%SERVER%%/%%BASE%%;SelectMethod=cursor


Exemple : jdbc:jtds:sqlserver://192.40.1.6/GIT;SelectMethod=cursor

1-4, 2-4, 3-4 : %%USER%%


Exemple : U_GITINTERFACES

1-5, 2-5, 3-5 : %%PW%%

© AKANEA Développement Page 70 sur 133


Connecteur IE
TMS Suite

Exemple : agat

1-11 2-11 3-11 :%%path REPERTOIRE DE RECUPERATION DES MESSAGES%%


Exemple : S :
Dans l’exemple ci-dessus « S : » correspond à un lecteur monté correspondant au chemin de stockage
des fichiers émis par Greencat, \\srv-greencat\export_legis par exemple. Pour que le connecteur IE
puisse lire modifier ou supprimer des fichiers il faut monter un lecteur réseau.

Dans le contexte de GreenCat seul les temps journaliers sont disponibles. Le connecteur IE
avec ces temps journalier peut reconstituer les temps hebdomadaire et mensuel. Pour cela il faut
cocher « Calcul DS » sur le premier écran de configuration du prestataire.

Si la case est cochée dans l’entrée 4 de la configuration du prestataire il faut mettre


« true » dans 4 zones.

9.4.4. Exemple Affichage

© AKANEA Développement Page 71 sur 133


Connecteur IE
TMS Suite

Terminal avec écran graphique monochrome. Clavier alphanumérique favorisant la saisie numérique.
Résolution de l’écran : 10 lignes de 40 caractères.
6 touches de fonctions disponibles en bas de l’écran permettant des actions conducteurs.
Numérotées F1 (touche à l’extrême gauche) à F6
Touches Ok et No permettant également des validations ou cheminement dans les différents écrans.
Flèches directionnelles permettant scrolling dans les listes ou passages d’une zone de saisie à l’autre
au sein d’un même écran.

© AKANEA Développement Page 72 sur 133


Connecteur IE
TMS Suite

Ecran principal :

Touche <F1> permet d’accéder à l’écran « Liste des Missions » ayant été envoyées au conducteur.
Autres touches de fonction : accès aux fonctionnalités standard du système.

Liste des Missions :

Affichage des missions envoyées au conducteur.


Touche <Ok> : permet d’accéder à écran « Détail mission » de la mission sélectionnée. Envoi
automatique de la macro Accusé Lecture.
Touche <No> : retour écran principal.

Ecran Détail Mission :

Affichage des informations sur le site de chargement/livraison.


Date : segments 7003 et 7004
Site : segments 7005 à 7011
Touche <F1> : validation du début de mission (date/heure réelle, position GPS, index km véhicule
seront envoyés automatiquement à la base).
Touche <F2> : accès écran « Détail Marchandises ».
Touche <F4> : accès écran « Commentaires » sur lieu de chargement/livraison.
Touche <F5> : accès écran « Litiges » au chargement.

© AKANEA Développement Page 73 sur 133


Connecteur IE
TMS Suite

Touche <F6> : validation de la fin de chargement (date/heure réelle, position GPS, index km véhicule,
litige, palettes seront envoyés automatiquement à la base). Cette action supprime automatiquement
l’OT de chargement de la liste.
Touche <No> : retour écran « Liste des OT »

Ecran Commentaire :

Affichage des zones de commentaires associées à un lieu de chargement ou livraison.


Références : segments 7012 et 7013
Commentaire : segment 7014
Touche <No> : retour écran « Détail mission »

Ecran Détail Marchandise :

Affichage des quantités prévues et validation/modification possible des quantités réelles. Pour un point
de chargement/livraison, possibilité d’avoir N marchandises. Le conducteur devra valider (touche
<F3>) chaque marchandise.

Touche <F1> : passage marchandise précédente.


Touche <F3> : validation de quantités pour la marchandise en cours. Chaque validation de
marchandise entraîne un envoi à la base des quantités réelles chargées / livrées.
Touche <F6> : passage marchandise suivante.
Touche <No> : retour écran « Détail Chargement/Livraison »

Ecran Liste des litiges :

© AKANEA Développement Page 74 sur 133


Connecteur IE
TMS Suite

Affichage de la liste des litiges. Un litige peut être associé à un Chargement / livraison. Cette indication
de litige sera retournée à la base lors de la validation de Fin de chargement/Livraison.

Ecran validation Début / Fin de Mission :

Début OT : envoi de la macro Début Mission


Fin OT : envoi de la macro Fin Mission et suppression automatique de l’OT.

9.4.5. Particularités

Pour que la communication entre le Connecteur IE et Greencat, il faut que Greencat réalise
certaines opérations :
- Mettre à jour les boitiers avec le modèle Akanea
- Si le client a fait développer des spécificités, mettre à niveau les programmes spécifiques
avec le modèle Akanea
- Dans le cas d’installation non locale du serveur Greencat il n’y a pas de récupération de
temps de service possible.
- La correspondance matérielle Greencat à saisir dans le progiciel métier doit correspondre
au code Parc de GreenCat (et non l’identifiant Greencat du véhicule)
- Si l’installation de Greencat n’est pas locale mais en hébergement il faut mettre en place
une procédure qui arrête le Connecteur IE entre 22H45 et 23H45
- Si après plusieurs essais d’envoi de mission aucun retour d’informations n’est présent, il
faut vérifier auprès de GreenCat si l’option des retours est bien activée pour le client.
- Le paramètre « FORMAT » (copie d’écran ci-dessous) est positionné par défaut à 7 à partir
des nouvelles installations du Connecteur IE au 01/11/2011. Il est préférable lors de
l’installation de ce faire confirmer la valeur du paramètre auprès de GreenCat.

© AKANEA Développement Page 75 sur 133


Connecteur IE
TMS Suite

9.5. GREENCAT MUT

Le mode GREENCAT MUT permet de communiquer avec les installations en mode serveur
mutualisé de GREENCAT.

Le fonctionnement et la mise en œuvre sont identiques au mode GREENCAT défini dans le


chapitre précédent, à l’exception d’une particularité. En effet sur un serveur mutualisé, on peut trouver
sur une même base, plusieurs véhicules avec le même code Parc pour des clients différents. Dès lors
le code Parc GreenCat n’est pas un identifiant unique. Donc il est nécessaire dans les fiches matériel
et salarié du progiciel transport de renseigner l’ID de la ressource GREENCAT et non le code Parc.

9.6. QUALCOMM QTRACS (QUALCOMM 1)

9.6.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Non
Suppression de Missions Non

Envoi de Messages Libres Oui


Modification de Messages Non
Libres

© AKANEA Développement Page 76 sur 133


Connecteur IE
TMS Suite

Suppression de Messages Non


Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui Les temps journaliers sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Oui Les temps hebdomadaires sont
Hebdomadaire reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Mensuel Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui

9.6.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Qualcomm.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
STARTL Commencé avec Réserve (Réserve saisie sur un
DONE)
DONE Fait
DONEL Fait avec Réserve (Réserve saisie sur un DONE)
NO_RECEIVE Non Reçu
REFUSED Refusé

© AKANEA Développement Page 77 sur 133


Connecteur IE
TMS Suite

9.6.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec Qualcomm il faut renseigner les paramètres de
connexions et avoir sur le poste du connecteur IE la DLL Qualcomm.

9.6.3.1. Installation DLL Qualcomm

Le client Qualcomm (QUALCOMM Local Integration.msi) doit être préalablement installé sur le
poste où sera exécuté le connecteur IE.

Double cliquez sur « COM Register.vbs » et li.reg

Les paramètres doivent être modifiés dans la base de registre.


HKEY_LOCAL_MACHINE\SOFTWARE\QUALCOMM

Dans général, il faut définir :


Dbserver : nom du serveur Qualcomm
Dbuser : nom de l’utilisateur pour la bdd
LogLevel :0
UserHTRACS :1 (données sociales)
UserQTRACS : 1 (accès à la dll)

Dans HKEY_LOCAL_MACHINE\SOFTWARE\QUALCOMM\LI\HTRACS\General, il faut définir


Customer: nom du client
LogLevel:0

© AKANEA Développement Page 78 sur 133


Connecteur IE
TMS Suite

Dans le répertoire des librairies (\lib), il faut renommer Qualcomm « version ».jar en
qualcomm.jar.
Ainsi, le core utilisera le wrapper correspond à la libraire installée.

9.6.3.2. Configuration Connecteur IE

Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de paramétrage.

Le paramétrage est à réaliser pour l’entrée 1de la partie inférieure de l’écran. Pour accéder au
paramétrage, il faut cliquer sur la flèche positionnée devant le chiffre. Une liste détaillée de paramètres
est affichée. Il faut remplacer les chaînes qui sont entre %%. Dans le cas de Qualcomm les paramètres
sont ceux de la chaîne de connexion au serveur avec login et mot de passe, le chemin de stockage de
fichier concernant les temps par exemple.

© AKANEA Développement Page 79 sur 133


Connecteur IE
TMS Suite

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres sont à renseigner sur l’entrée :

1-3 : NAME
Exemple : POUPEAU

1-4 : %%USER%%
Exemple : export

1-5 : %%PW%%
Exemple : export

La récupération des temps de service se fait au travers d’une connexion internet sur le serveur
de Qualcomm. Si le connecteur IE se trouve sur un réseau ayant un PROXY il peut être nécessaire de
renseigner les paramètres suivants. Dans le cas contraire, il faut mettre « none » comme valeur au
paramètre.

1-15 : %%USERPROXY%%

© AKANEA Développement Page 80 sur 133


Connecteur IE
TMS Suite

Exemple : none

1-16 : %%PWPROXY%%
Exemple : none

1-17 : %%IPPROXY%%
Exemple : none

1-18 : %%PORTPROXY%%
Exemple : none

Dans le contexte de Qualcomm seul le détail des temps est disponible. Le connecteur IE avec
ces temps peut reconstituer les temps journalier, hebdomadaire et mensuel. Pour cela il faut cocher
« Calcul DS » sur le premier écran de configuration du prestataire.

Si la case est cochée dans l’entrée 3 de la configuration du prestataire il faut mettre toutes les
zones qui sont à « false » à « true ».

© AKANEA Développement Page 81 sur 133


Connecteur IE
TMS Suite

9.6.4. Macro Standard

Le connecteur IE est livré avec trois macros d’envoi. La première envoie une mission pas
message. Le deuxième envoi des couples de missions par message. L’ordre des couples est défini
par un « Order By » dans le fichier QueriesPrestataire.properties (situé dans \arborescence\client\), il
est possible de modifier cet ordre en modifiant l’ « Ordrer By » (dans ce cas il ne faut pas modifier le
standard mais dupliquer le .properties et utiliser ce dernier pour la configuration). La troisième macro
est une macro qui permet d’envoyer plusieurs missions dans un message.

Macro 1 (macro unitaire) : 15 lignes

FORWARD UNIT 15 lignes


Mission: _______________________ 09 +25 dynamique
Action: _____________________ 08 +15 dynamique
Le: ______________________ 04 + 25 dynamique (date
sous la forme AAAA/MM/JJ
à HH:MI)

Tiers: ______________________ 07 + 25 dynamique


Ad1: ________________________ 05 + 30 dynamique
Ad2: ________________________ 05 + 30 dynamique
Vil: ________________________ 05 + 30 dynamique
Ref: __________________________ 06 + 30 dynamique
Info: __________________________ 06 + 30 dynamique
Com: ________________________ 05 + 30 dynamique
Art: __________________ 05+07 dynamique
Pal: ________ 05+07 dynamique
Poids: _________ 07+05 dynamique
ML: ________ 05+07 dynamique
Col: ________ 05+07 dynamique

© AKANEA Développement Page 82 sur 133


Connecteur IE
TMS Suite

Macro 2 (macro Duo) : 30 lignes

FORWARD DUO 30 lignes


Mission: _______________________ 09 +25 dynamique
Action: _____________________ 08 +15 dynamique
Le: ______________________ 04 + 25 dynamique (date
sous la forme AAAA/MM/JJ
à HH:MI)

Tiers: ______________________ 07 + 25 dynamique


Ad1: ________________________ 05 + 30 dynamique
Ad2: ________________________ 05 + 30 dynamique
Vil: ________________________ 05 + 30 dynamique
Ref: __________________________ 06 + 30 dynamique
Info: __________________________ 06 + 30 dynamique
Com: ________________________ 05 + 30 dynamique
Art: __________________ 05+07 dynamique
Pal: ________ 05+07 dynamique
Poids: _________ 07+05 dynamique
ML: ________ 05+07 dynamique
Col: ________ 05+07 dynamique
.Mission: _______________________ 09 +25 dynamique
.Action: _____________________ 08 +15 dynamique
.Le: ______________________ 04 + 25 dynamique (date
sous la forme AAAA/MM/JJ
à HH:MI)

.Tiers: ______________________ 07 + 25 dynamique


.Ad1: ________________________ 05 + 30 dynamique
.Ad2: ________________________ 05 + 30 dynamique
.Vil: ________________________ 05 + 30 dynamique
.Ref: __________________________ 06 + 30 dynamique
.Info: __________________________ 06 + 30 dynamique
.Com: ________________________ 05 + 30 dynamique
.Art: __________________ 05+07 dynamique
.Pal: ________ 05+07 dynamique
.Poids: _________ 07+05 dynamique
.ML: ________ 05+07 dynamique
.Col: ________ 05+07 dynamique

Macro (2, 6, 8 points): 36 lignes

FORWARD FULL1 30 lignes


VOYAGE: _______________________ 09 +25 dynamique
1 Type de Mission + Date et Heure 08 +15 dynamique
2 MISSION.PLACELIB + MISSION.ADRESSE1 + 04 + 25 dynamique (date
MISSION.PAYS + MISSION.CP + MISSION.VILLE sous la forme AAAA/MM/JJ
à HH:MI)

© AKANEA Développement Page 83 sur 133


Connecteur IE
TMS Suite

3 MISSION.NUMERO + MISSION.REF1 + 07 + 25 dynamique


MISSION.COMMENT1
4 QTE_TOTALE_PALETTE + QTE_TOTALE_COLIS 05 + 30 dynamique
5 Séparateur 05 + 30 dynamique

9.7. QUALCOMM OMNIEXPRESS (QUALCOMM 2)

9.7.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui Les temps journaliers sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Oui Les temps hebdomadaires sont
Hebdomadaire reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Mensuel Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE

© AKANEA Développement Page 84 sur 133


Connecteur IE
TMS Suite

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui

9.7.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Qualcomm.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
STARTL Commencé avec Réserve (Réserve saisie sur un
DONE)
DONE Fait
DONEL Fait avec Réserve (Réserve saisie sur un DONE)
NO_RECEIVE Non Reçu
CANCELED Annulé

9.7.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec Qualcomm il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de
paramétrage.

© AKANEA Développement Page 85 sur 133


Connecteur IE
TMS Suite

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres (partie supérieure) sont à renseigner sur l’entrée :

1-3, 2-3 : %%NAME%%


Exemple (compte client): trsie

1-4, 2-4 : %%USER%%


Exemple : thirdparty

1-5, 2-5 : %%PW%%


Exemple : EXEMPLE_10532

1-8, 2-8 : %%USERPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-9, 2-9 : %%PWPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-10, 2-10 : %%IPPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-11, 2-11 : %%PORTPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

Les paramètres (sur la fenêtre suivante) sont à renseigner sur l’entrée :

1-3 : %%NAME%%
Exemple (compte client): trsie

1-4 : %%USER%%
Exemple : thirdparty

1-5 : %%PW%%
Exemple : EXEMPLE_10532

1-15 : %%USERPROXY%%
Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-16 : %%PWPROXY%%
Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-17 : %%IPPROXY%%
Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-18 : %%PORTPROXY%%
Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

© AKANEA Développement Page 86 sur 133


Connecteur IE
TMS Suite

9.7.4. Exemple Affichage

Sur le premier écran, une icône indique le nombre de messages réceptionnés. En cliquant
dessus la liste des messages apparaît.

Sur la liste des messages apparaît le numéro et le type de mission. Pour voir le détail de la
mission

© AKANEA Développement Page 87 sur 133


Connecteur IE
TMS Suite

Pour naviguer dans le détail, il faut utiliser les flèches positionnées à droite.

© AKANEA Développement Page 88 sur 133


Connecteur IE
TMS Suite

9.7.5. Particularités

Par défaut les macros du Connecteur IE pour Qualcomm sont branchées sur la 40 pour l’envoi et
la 50 et 51 pour les retours. Le respect de cette config doit être indiqué à Qualcomm lors de
l’installation.
Lorsqu’une mission est terminées (DONE ou DONEL) par le chauffeur, une commande de
suppression est envoyée par le Connecteur IE au boitier Qualcomm Omniexpress, pour le purger des
missions terminées. Pour que cette fonction s’applique, si le contenu d’une mission est personnalisé,
cette personnalisation ne doit pas utiliser le champ IE_MISSION_MEMO_LIBRE5.

Le connecteur utilise des macros dont les numéros par défaut sont 40, 50, 51. Dans le cas d’une
installation Qualcomm ou ces valeurs ne seraient pas respectées. Il faut modifier le paramétrage du
Connecteur IE. 2 éléments sont à modifier :
- dans le fichier prestataire M:\IEmdw\core\arborescence\prestataire\prestataires.xml, il faut
modifier la balise suivante <param context="macro" value="40 50 51" /> et attribuer les
bonnes valeurs.

- dans la transformation ALTOVA, exemple avec QualcommQtsUp

9.8. ELOMOBILE V2

9.8.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Non
Modification de Missions en Non
cours
Suppression de Missions Non

Envoi de Messages Libres Non


Modification de Messages Oui
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Non

Réception Temps Détaillé Oui


Réception Temps Journalier Oui

© AKANEA Développement Page 89 sur 133


Connecteur IE
TMS Suite

Réception Temps Oui


Hebdomadaire
Réception Temps Mensuel Oui

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui Il faut que la cartographie soit
disponible. Car Elomobile
envoie une coordonnée GPS
dont il faut trouver le lieu le plus
proche.

9.8.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Elomobile.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
READ Lu
START Commencé
DONE Fait
DONEL Fait avec Réserve
NO_SEND Non Envoyé
BAD_FORMAT Mauvais formatage de donnée
ATTENTE En attente

9.8.3. Configuration du connecteur IE

Voir le chapitre de configuration ELOMOBILE V3.

9.8.4. Particularités

Dans ELOMOBILE la notion d’événement à la mission, n’existe pas de manières assez


complètes. Les événements de début de mission et de fin de mission sont globaux au voyage. Donc
on sait quand on commence le voyage et quand il est fini, mais on ne sait pas à quelle heure a
commencé ou fini chacune des missions. Le connecteur IE permet tout de même de redescendre
l’événement de début ou de fin sur chacune des missions en répliquant les missions du voyage sur les
missions. Pour activer ce mode, dans le fiche prestataire de ELOMOBILE V2, il faut cocher « Dispatch
Evt Voyage ».

© AKANEA Développement Page 90 sur 133


Connecteur IE
TMS Suite

9.9. ELOMOBILE V3

9.9.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Modification de Missions en Non
cours
Suppression de Missions Oui

Envoi de Messages Libres Non


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Non

Réception Temps Détaillé Oui


Réception Temps Journalier Oui
© AKANEA Développement Page 91 sur 133
Connecteur IE
TMS Suite

Réception Temps Oui


Hebdomadaire
Réception Temps Mensuel Oui

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui Il faut que la cartographie soit
disponible. Car Elomobile
envoie une coordonnée GPS
dont il faut trouver le lieu le plus
proche.

9.9.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Elomobile.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
READ Lu
START Commencé
DONE Fait
DONEL Fait avec Réserve
LITIGE Litige
NO_SEND Non Envoyé
NO_SUP Suppression non effectuée
BAD_FORMAT Mauvais formatage de donnée
ATTENTE En attente
NO_CHANGE Aucun Changement

9.9.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec ELOMOBILE il faut renseigner les paramètres
de connexions. Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de
paramétrage.

© AKANEA Développement Page 92 sur 133


Connecteur IE
TMS Suite

Le paramétrage est à réaliser pour l’entrée 1, 2, 3 et 4 et l’entrée 1, 2 et 3 de la fenêtre suivante.


Pour accéder au paramétrage, il faut cliquer sur la flèche positionnée devant le chiffre. Une liste
détaillée de paramètres est affichée. Il faut remplacer les chaînes qui sont entre %%. Dans le cas de
Elomobile les paramètres sont ceux de la chaîne de connexion au serveur avec login et mot de passe,
le chemin de stockage de fichier concernant les temps par exemple.

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

1-2, 2-2, 3-2, 4-2 : jdbc:jtds:sqlserver//%%SERVER%%:%%PORT%%


Exemple : jdbc:jtds:sqlserver://172.16.1.2:1433/BD_ELOCOM;domain=;Instance=ELOSYSTEMES

1-4, 2-4, 3-4, 4-4 : %%USER%%


Exemple : sa

1-5, 2-5, 3-5, 4-5 : %%PW%%


Exemple : elosystemes

© AKANEA Développement Page 93 sur 133


Connecteur IE
TMS Suite

1-2 : %%path REPERTOIRE D'EXPORT/%%


Exemple : S:\recup

2-2, 3-2 : %%path REPERTOIRE D'IMPORT%%


Exemple : S:\depart

Dans l’exemple ci-dessus « S : » correspond à un lecteur monté correspondant au chemin de stockage


des fichiers émis par Elomobile, \\srv-Elomobile\interface par exemple. Pour que le connecteur IE
puisse lire modifier ou supprimer des fichiers il faut monter un lecteur réseau.

© AKANEA Développement Page 94 sur 133


Connecteur IE
TMS Suite

9.9.4. Exemple Affichage

© AKANEA Développement Page 95 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 96 sur 133


Connecteur IE
TMS Suite

9.9.5. Particularités

Elomobile est sensible au code ISO des pays qui sont envoyé dans les missions. Par défaut le
progiciel métier envoie le code International. Un fichier de correspondance entre les codes du progiciel
et les codes ISO pour le connecteur est disponible (voir chapitre Code ISO pays) afin de rétablir les
éléments nécessaires.

Dans le cas d’ELOMOBILE la notion de « DONEL » n’existant pas, un scenario est mis en place
(uniquement ELOMOBILE V3) sur le « DONE » de la mission. Donc quand le chauffeur terminera une
mission, le système lui posera la question suivante :

« Mission terminée avec réserve ? »

Si le chauffeur saisit « Oui » dès lors, il faudra compléter le « DONE » d’un événement « DONEL ».

Si le chauffeur saisit « Non » dès lors seul le DONE sera posé.

9.10. TRANSICS

9.10.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Modification de Missions en Non
cours
Suppression de Missions Oui

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Oui
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
© AKANEA Développement Page 97 sur 133
Connecteur IE
TMS Suite

Réception Temps Oui Les temps mensuels sont


Hebdomadaire reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Mensuel Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui .

9.10.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Transics.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
DONE Fait
DONEL Fait avec Réserve
LITIGE Litige
INFO Information
CONFIRMED Confirmé
NO_SEND Non Envoyé
CANCELED Annuler
ERREUR En erreur

9.10.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec TRANSICS il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire « TRANSICS » et aller sur la troisième
fenêtre de paramétrage.

© AKANEA Développement Page 98 sur 133


Connecteur IE
TMS Suite

Le paramétrage est à réaliser pour les entrées 1, 2 et 3. Pour accéder au paramétrage, il faut
cliquer sur la flèche positionnée devant le chiffre. Une liste détaillée de paramètres est affichée. Il faut
remplacer les chaînes qui sont entre %%. Dans le cas de Transics les paramètres sont ceux de la
chaîne de connexion au serveur avec login et mot de passe.

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres sont à renseigner sur l’entrée :

1-2, 2-2, 3-2 : jdbc:ianywhere:DSN=%%Base%


Exemple : jdbc:ianywhere:DSN=2589TRANSICS
(Mettre le nom de la source ODBC, détail voir chapitre « Particularités »)

1-4, 2-4, 3-4 : %%USER%%


Exemple : thirdparty

1-5, 2-5, 3-5 : %%PW%%


Exemple : EXEMPLE_10532

© AKANEA Développement Page 99 sur 133


Connecteur IE
TMS Suite

1-9, 2-10 : %%CLIENTTRANSICS%%


Exemple : 2589

9.10.4. Exemple Affichage

Saisie Ordre

Commentaire chargement Commentaire livraison

Affichage mode liste dans Boitier

© AKANEA Développement Page 100 sur 133


Connecteur IE
TMS Suite

Affichage du détail de la mission dans le boitier

© AKANEA Développement Page 101 sur 133


Connecteur IE
TMS Suite

9.10.5. Contenu Mission

Table :TOU_PLACE_EXTERN

Champ Transics Champ Akanea Connecteur IE


IDPRESTATAIRE VOYAGE.IDPRESTATAIRE
IDMESSAGE MESSAGE.ID
C_AUTHOR « SAGE »
C_COMMENT MISSION.PLACE_LIB + MISSION.ADRESSE1 + MISSION.ADRESSE2
+ MISSION.PAYS + MISSION.CP + MISSION.VILLE
C_IDSPATCHER VIDE
C_DISPLAY Type de Mission + MISSION. PLACE_LIB (nom du tiers de la mission,
expéditeur ou destinataire), si la mission correspond à un point de début
ou de fin de voyage, c’est le type de mission + MISSION.VOYAGE
(numéro du voyage)
C_FLAGS VIDE
C_PLACEID MISSION.IDMISSIONSENT
D_POSX MISSION. LATITUDE
D_POSY MISSION. LONGITUDE
DT_EXECUTION MISSION.DATE_DEB + MISSION.HEURE_DEB
DT_TRANSFER Date et heure d’envoi du Connecteur IE
I_5MINUTES_PERIOD VIDE
I_ALARMTIME VIDE
I_ERROR 0
I_GEO_EVENT VIDE
I_MODE 2
I_RADIUS VIDE
I_SORT MISSION.SENTPOSITION
I_SYSTEM_NR « id interne du client »
I_TRANSFER_METHOD 4
NR_BCI_ANT MISSION.TYPES (mission à une livraison ou fin de voyage = 2 sinon =
1)
TNR_MAT Code Véhicule du connecteur IE

Table :TOU_PRODUCT_EXTERN (Article)

Champ Transics Champ Akanea Connecteur IE


C_AUTHOR « SAGE »
C_COMMENT
MISSION.REF1 + MISSION.CAB + IE_ARTICLE.
QTE_TOTALE_POIDS + IE_ARTICLE.QTE_TOTALE_PALETTE +
QTE_TOTALE_MPLANCHER + IE_ARTICLE.
QTE_TOTALE_COLIS

EMABALLGE.TYPE_PALETTE + EMBALLAGE.QTE_TOTAL +
EMBALLAGE.QTE_RECU

MISSION.MEMO_LIBRE3

© AKANEA Développement Page 102 sur 133


Connecteur IE
TMS Suite

MISSION.TEXTE_LIBRE2 + MISSION.TEXTE_LIBRE3 +
MISSION.MEMO_LIBRE1 + MISSION.MEMO_LIBRE2 (21 à 80
caractères)
C_DISPLAY IE_ARTICLE.LIB_ARTICLE
IE_ARTICLE.LIB_ARTICLE
MISSION.DATE_DEB + MISSION.HEURE_DEB
MISSION.TEXTE_LIBRE1 + MISSION.MEMO_LIBRE2 (de 1 à 20)
C_KIND P
C_PLACEID MISSION.IDMISSIONSENT
C_PRODUCTID IE_ARTICE. IDARTICLESENT
C_PRODUCTID_COMMENT Vide
C_REF_ADRESSE Vide
C_REF_CLIENT MISSION.NUMERO
C_REF_TRANSPORTER1 Vide
C_REF_TRANSPORTER2 Vide
C_REF_TRANSPORTER3 Vide
CNR_ADDRESSEE Vide
CNR_CLIENT Vide
DT_TRANSFER Date et heure du transfert du Connecteur IE
I_ERROR 0
I_SORT 1100 + IE_ARTICLE.NUM_ORDRE

9.10.6. Particularités

Les versions compatibles sont :


- Transics Technical V17
- Version driver SYSBASE 10.01.3931
- Appeler Transics au +33 (0) 825 825 624 pour obtenir les éléments de connexion (Nom de la base,
Nom du serveur, Adresse IP sur serveur, Port du serveur, Code utilisateur de la base, Mot de passe
de la base)
- Demander à Transics (sauf si ce n’est fait) d’installer et de configurer sur le poste où sera le
connecteur IE la connexion ODBC nécessaire à la communication entre le connecteur IE et Transics
(SQLAnywhere10_Windows_Developer_10.0.1.exe et
SA10_Full_WIN32+x64.1001_3931_EBF.exe)

La connexion du connecteur à la Base de données Transics se fait au travers d’une connexion


JODBC s’appuyant sur le paramétrage d’une connexion ODBC.
Il faut que cette connexion fonctionne pour le Connecteur IE fonctionne.

Pour tester cette connexion il faut aller dans les sources ODBC du poste. Une source de
donnée dont le nom correspond à l’identifiant du client suivi de TRANSICS doit être présente. Cette
connexion doit avoir comme pilote SQL Anywhere 10.

© AKANEA Développement Page 103 sur 133


Connecteur IE
TMS Suite

Si on clique sur configurer pour ouvrir l’écran de paramétrage, il faut vérifier que l’onglet
connexion est paramétré. Cet onglet doit être paramétré avec le login et password. Ceux sont ces
mêmes paramètres qui permettent au connecteur IE de se connecter.

© AKANEA Développement Page 104 sur 133


Connecteur IE
TMS Suite

L’onglet « Base de donnée » doit comporter le nom de la base qui sera le même pour le
connecteur IE.

L’onglet Réseau contient le routage vers les serveurs Transics.

Enfin sur le premier onglet se trouve un bouton « Tester la connexion » permettant de valider
la communication entre le poste et Transics.

L’installation de l’ODBC doit être réalisée par Transics afin de s’assurer de la conformité de
l’installation, notamment l’ouverture des ports

© AKANEA Développement Page 105 sur 133


Connecteur IE
TMS Suite

9.11. TRANSICS TXCONNECT (API TANGO)

9.11.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Modification de Missions en Non
cours
Suppression de Missions Oui

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
Suppression de Messages Non
Libres

Réception d’événements de Oui


Missions
Réception d’événements de Oui
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Oui


Réception Temps Journalier Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Oui Les temps mensuels sont
Hebdomadaire reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE
Réception Temps Mensuel Oui Les temps mensuels sont
reconstitués par le connecteur
IE à partir des temps détaillés,
pour cela il faut activer la
gestion des DS dans le
connecteur IE

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui .

© AKANEA Développement Page 106 sur 133


Connecteur IE
TMS Suite

9.11.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec Transics.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
SEND Envoyé
RECEIVED Reçu
READ Lu
START Commencé
DONE Fait
DONEL Fait avec Réserve
LITIGE Litige
INFO Information
CONFIRMED Confirmé
NO_SEND Non Envoyé
CANCELED Annuler
ERREUR En erreur

9.11.3. Configuration du connecteur IE

Pour que le Connecteur IE communique avec TRANSICS il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire « TXCONNECT » et aller sur la troisième
fenêtre de paramétrage.

Le paramétrage est à réaliser pour les entrées 1, 2 et 3. Pour accéder au paramétrage, il faut
cliquer sur la flèche positionnée devant le chiffre. Une liste détaillée de paramètres est affichée. Il faut
remplacer les chaînes qui sont entre %%. Dans le cas de Transics les paramètres sont ceux de la
chaîne de connexion au serveur avec login et mot de passe.

© AKANEA Développement Page 107 sur 133


Connecteur IE
TMS Suite

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres sont à renseigner sur l’entrée :

1-4, 2-4 : %%USER%%


Exemple : thirdparty

1-5, 2-5 : %%PW%%


Exemple : EXEMPLE_10532

1-7, 2-7 : %%USERPROXY%%


Exemple : userproxy

1-8, 2-8 : %%PWPROXY%%


Exemple : passwordproxy

1-9, 2-9 : %%IPPROXY%%


Exemple : 172.15.15.15

1-10, 2-10 : %%PORTPROXY%%


Exemple : 8080

1-11, 2-11 : %%CLIENTTRANSICS%%


Exemple : Exemple : 2589

1-14, 2-14 : %%INTEGRATOR%%

© AKANEA Développement Page 108 sur 133


Connecteur IE
TMS Suite

Exemple : 3952_SAGE_01

1-15 : %%VERSION%%
Exemple : 9052
*** Le paramètre version correspond à la notion Set d’instruction dans les documents de Transics.
Pour les flottes hétérogènes en termes de boîtier Transics, Transics fournit une liste de Set d’instruction
(9300, 8301 ,8300 par exemple). Dans ce cas il faut utiliser le numéro le plus élevé (9300 par exemple).

Sur la page suivante du wizard, il est nécessaire de rentrer aussi des paramètres, il suffit de
reprendre les valeurs définies précédemment.

9.11.4. Exemple Affichage

© AKANEA Développement Page 109 sur 133


Connecteur IE
TMS Suite

© AKANEA Développement Page 110 sur 133


Connecteur IE
TMS Suite

9.11.5. Particularités

- Les échanges se font via webservice. Il faut donc s’assurer que le serveur SCIE accède au serveur
hôte du webservice. Pour tester cette couche de communication, il suffit par exemple de saisir l’adresse
© AKANEA Développement Page 111 sur 133
Connecteur IE
TMS Suite

suivante sur le navigateur, https://tx-connect.transics.com/IWSLead/service.asmx?wsld. Si la


communication fonctionne une page avec une liste de service s’affiche. En cliquant sur un service, un
fichier XML doit s’afficher dans le navigateur.
- Appeler Transics au +33 (0) 825 825 624 pour obtenir les éléments de connexion. Transics mettra à
disposition lors des installations un document référençant tous les éléments.

Nom du client
Adresse
Chefs de projet
Date d’intervention prévue
Mode de fonctionnement : hébergement / local
Mode connexion existante : IWS / ODBC / aucune -> ODBC n’est plus supporté
Nombre de chaque type d’ordinateur de bord :
Q+ Ancien terminaux

TX-MAX Dernière génération

TX- Android
SMART

Niveau de planification :
Trip (Voyage) – Place (Mission) – Job (non-supporté) – Produit (Produit)
-> Gestion des voyages et Gestion sans voyage (mission par mission)

Sets d’instruction en production :


Version de la liste des activités (important pour le typage des missions) permet de
renseigner %%version%%

Les activités correspondent à notre typage de mission. Nous en avons défini des standards que
Transics doit installer chez le client avec le même id.

Activité (code Disponible Remarques


Transics)
Chargement (1)
Déchargement (2)
Début de tournée
(8003)
Fin de tournée
(8004)
Début de voyage
(1113)
Fin de voyage
(1114)
Relais
Passage à quai
Repos
Lavage

Détails de la connexion web services


WSDL Url de connexion
Dispatcher/Login

© AKANEA Développement Page 112 sur 133


Connecteur IE
TMS Suite

Mot de passe/Pw
Numéro de system/Client
transics
Integrateur/Integrator

- Si dans la fiche retournée par Transics « Niveau de planification » est à « Trip » alors le paramètre
« Format » de la fiche prestataire peut être positionné à « Voyage ». Si le « Niveau de planification »
est à « Place », alors le paramètre « Format » de la fiche prestataire doit être positionné à voyage.

- Tout envoi de mission dont la date est antérieure à la date du jour sera rejeté par Transics, et la
mission ne sera donc pas disponible dans les boitiers.

- La liste des activités est fournie dans la fiche Transics (Charment(1)). Ces activités correspondent à
des types de missions (Chargement, relais, passage à quai …). Dans le document fournit par Transics,
les activités suivies d’un chiffre sont activées, les autres non. Dans le cas où une activité n’est pas
active, il faut activer les exclusions de mission nécessaires dans le progiciel (wizard connecteur IE).
par exemple Tout envoi de mission dont la date est antérieure à la date du jour sera rejeté par Transics,
et la mission ne sera donc pas disponible dans les boitiers. Si une activité non active doit être activée,
alors il faut prendre contact avec Transics pour installer les éléments nécessaires.

Les éléments fournis dans la fiche d’information permettront de renseigner les paramètres du
connecteur IE :
<classe>
<param context = "classe" value = "specific.transicsTango.TransicsTangoUp"/>
<param context = "name" value = "transicsTangoUp.xslt"/>
<param context = "url" value = "https://tx-connect.transics.com/IWSLead/service.asmx/"/>
<param context = "login" value = "SAGE"/>
<param context = "pw" value = "SAGE_1106"/>
<param context = "version" value = "2"/>
<param context = "clientTransics" value = "3952"/>
<param context = "versionTransics" value = "9052"/>
<param context = "language" value="fr" />
<param context = "integrator" value="3952_SAGE_01" />
</classe>

9.12. FLEETBOARD

9.12.1. Synthèse des Fonctions

Fonctions Oui/Non Détail


Envoi de Missions Oui
Modification de Missions Oui
Suppression de Missions Oui

Envoi de Messages Libres Oui


Modification de Messages Non
Libres
© AKANEA Développement Page 113 sur 133
Connecteur IE
TMS Suite

Suppression de Messages Non


Libres

Réception d’événements de Oui


Missions
Réception d’événements de Non
Messages Libres

Réception Messages Libres Oui

Réception Temps Détaillé Non


Réception Temps Journalier Non
Réception Temps Oui
Hebdomadaire
Réception Temps Mensuel Oui

Réception Compteur Oui A partir des événements de


missions
Réception Position Oui .

9.12.2. Evénements Traités

Liste des événements traités par le Connecteur IE en lien avec FleetBoard.

Nom Connecteur IE Libellé Progiciel


ON_SERVER Pris en charge par le prestataire
RECEIVED Reçu
READ Lu
START Commencé
DONE Fait
INFO Information

9.12.3. Configuration Connecteur IE

Pour que le Connecteur IE communique avec FleetBoard il faut renseigner les paramètres de
connexions. Pour cela il faut aller dans la fiche prestataire et aller sur la troisième fenêtre de
paramétrage.

© AKANEA Développement Page 114 sur 133


Connecteur IE
TMS Suite

Pour modifier un paramètre il faut double cliquer sur le numéro du paramètre.

Les paramètres (partie supérieure) sont à renseigner sur l’entrée :

1-3, 2-3 : %%USER%%


Exemple : thirdparty

1-4, 2-4 : %%PW%%


Exemple : EXEMPLE_10532

1-7, 2-7 : %%FLEET%%


Exemple ((compte client) ou Flotte): TRSFLEET

1-8, 2-8 : %%USERPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-9, 2-9 : %%PWPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-10, 2-10 : %%IPPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-11, 2-11 : %%PORTPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-12 : %%IDFORM%%
Exemple (nom du modèle de mission) : 40000614

Les paramètres (partie inférieure) sont à renseigner sur l’entrée :

1-3, 2-3, 3-3: %%USER%%


Exemple : thirdparty

1-4, 2-4, 3-4 : %%PW%%


Exemple : EXEMPLE_10532

1-8, 2-8, 3-8 : %%USERPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

© AKANEA Développement Page 115 sur 133


Connecteur IE
TMS Suite

1-9, 2-9, 3-9 : %%PWPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-10, 2-10, 3-10 : %%IPPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-11, 2-11, 3-11 : %%PORTPROXY%%


Exemple (S’il n’y a pas de proxy la zone doit être vidée): none

1-7, 2-7, 3-7 : %%FLEET%%


Exemple ((compte client) ou Flotte): TRSFLEET

© AKANEA Développement Page 116 sur 133


Connecteur IE
TMS Suite

10. COMPLEMENT CONNECTEUR IE

10.1. INSTALLATION MULTI-BASE IE POUR UN MEME PRESTATAIRE

Le progiciel métier peut être monobase mais avec plusieurs sociétés. Ces sociétés pourraient
avoir chacune une base IE et des paramètres de connexion qui leur sont propres. Dans ce cas, il faut
sélectionner une fiche prestataire et la dupliquer (clic droit sur le prestataire) autant de fois que
nécessaire.

10.2. VUE DE CONTROLE

Le connecteur IE à 4 modes mode de visualisation. Ces modes s’activent par le menu


« Fenêtre », « Vue ».

© AKANEA Développement Page 117 sur 133


Connecteur IE
TMS Suite

1- le mode console affiche un état des principaux process du Connecteur IE

2- Le deuxième mode affiche une trace de tous les processus exécutés par le Connecteur IE

© AKANEA Développement Page 118 sur 133


Connecteur IE
TMS Suite

3- Le troisième affiche une vue simplifiée de l’état de connecteur IE (arrêté ou démarré)

4- Le mode SQL permet d’accéder à un outil permettant de visualiser les tables et les données
des tables du Connecteur IE

10.3. CONCATENATION

© AKANEA Développement Page 119 sur 133


Connecteur IE
TMS Suite

Le connecteur IE permet de cumuler des missions, cette fonction est appelée


« Concaténation » dans le connecteur IE. La concaténation permet d’envoyer sous une mission un
ensemble de mission. En effet prenons une tournée de livraison qui contient 3 positions pour le même
destinataire. Sans concaténation le chauffeur aura trois missions à traiter, même si réellement il n’en
traite qu’une. Si on utilise une concaténation sur le nom du destinataire, au lieu d’envoyer trois missions
le connecteur IE enverra une seule mission représentant les 3 missions ayant le même destinataire.

10.3.1. Activation

Pour activer la gestion du mode concaténation il faut dans la fiche prestataire du Connecteur
IE cocher la case à cocher « Concaténation ».

Ensuite il faut copier le fichier suivant M:\iemdw\core\arborescence\client\


QueriesPrestataire.properties dans le même répertoire sous le même nom précédé du RAC du client.

© AKANEA Développement Page 120 sur 133


Connecteur IE
TMS Suite

Puis dans la liste des clients, il faut ouvrir le client correspondant à l’installation, et ouvrir dans
la liste des prestataires. Dans la fiche prestataire il fait remplacer QueriesPrestataire.properties par le
nouveau nom du fichier de paramétrage.

10.3.2. Paramétrage

Le niveau de concaténation pouvant être plus moins complexe, ce chapitre n’évoquera que des
cas simples dans les autres cas il sera nécessaire de réaliser une analyse plus détaillée.

La concaténation peut se faire en fonction des éléments référencés dans la table


IE_T_MISSION (table du corps de la mission), IE_T_EMBALLAGE (table des emballages de la
mission), IE_T_ARTICLE (table des marchandises et quantités de la mission). Le fait de l’activer sur
les missions la concaténation induit l’activation de la concaténation sur les articles et les emballages.

Pour paramétrer les critères de concaténation il faut ouvrir le nouveau fichier properties.

Avoir requête type afin d’avoir des exemples

Il est possible de regrouper les éléments d’un voyage selon certains critères, pour se faire il faut
modifier les requêtes gs_XXXXX
Ces select vont permettre au système de faire du regroupement d’informations.
Vous ne pouvez modifier que la partie group by et compléter les conditions de jointures.
En attendant une interface graphique de modification, ces transformations doivent être effectuée par
des personnes aguerrit aux requêtes Sql.
Exemple
Si je veux regrouper les missions ayant le même type et le même place_lib
On obtiendra ceci
gs_mission=
select T1.IDMISSIONSENT,T1.MISSION_GRP,T0.IDVOYAGE,T0.IDMISSION
© AKANEA Développement Page 121 sur 133
Connecteur IE
TMS Suite

from
(SELECT IDVOYAGE, Min(IDMISSION) IDMISSIONSENT, Decode(count(*),1,'N','O')
MISSION_GRP, PLACE_LIB,TYPES
FROM IE_T_MISSION
group by IDVOYAGE,PLACE_LIB,TYPES) T1, IE_T_MISSION T0
where 1=1
and T0.IDVOYAGE = T1.IDVOYAGE
and T0.PLACE_LIB = T1.PLACE_LIB
and T0.TYPES = T1.TYPES
and T0.IDVOYAGE = ?

Si vous ne désirez faire aucun regroupement, il ne faut rien mettre dans les select de regroupement.
Exemple :
Si l’on ne désire faire aucun regroupement sur les missions on doit avoir dans le fichier ceci :
gs_mission=

On trouve donc 3 options de regroupement


Regroupement de mission : gs_mission
Regroupement d’articles : gs_article
Regroupement d’emballage : gs_emballage

Ces regroupements ne peuvent se faire qu’au sein d’un même voyage, il n’est pas possible de
regrouper les éléments de plusieurs voyages

Les 3 autres lignes (t_mission, t_article et t_emballage) vont indiquer au système quels sont les
champs qu’il doit prendre en compte pour l’envoi vers le prestataire.
Ce select dépend étroitement du regroupement que vous avez pu effectuer (décrit ci-dessus).
Si vous n’avez effectué aucun regroupement, vous pouvez sélectionner les champs simplement.
S’il y a regroupement, vous devez préciser une action pour chaque colonne
(min, max, sum, avg, null, une valeur en dure,…)
Par défaut, mettez min(NOM_COLONNE) sauf si vous désirez effectuer une opération spécifique.
Pensez à bien protéger chaque colonne en lui associant l’alias correspondant.
Au niveau des champs d’ID soit mettre tout le temps Min ou tout le temps max et rien d’autre.
Exemple
SELECT MIN(IDMISSION) IDMISSION,MIN(IDVOYAGE) IDVOYAGE,…

Si lors de votre transformation, vous désirer rediriger une colonne vers une autre, du genre remplacer
l’adresse 1 par la valeur contenu dans la colonne de l’adresse 3 vous pouvez le faire ici (même si il est
plus pratique de le faire au niveau des transformations XLST).
Ce qui donnerait :
Select . . . ., min(ADRESSE3) ADRESSE1, …

Attention : pour la base oracle il faut bien penser formater les dates

Vous pouvez laisser des commentaires dans ce fichier, il faut pour cela que la ligne de commentaire
commence par un « # »

Préconisation :
Il est recommandé de faire une copie du fichier a modifié et de le renommer ; Ainsi si vos modifications
ne sont pas correctes, vous pourrez toujours revenir au fichier de base.
Le fichier ainsi renommé, devra être référencé au sein du fichier clients.xml, à savoir
Dans le fichier clients.xml, vous avez des balises clients.
Au sein de ces balises vous avez autant de balise prestataire, que de prestataire utilisé.

© AKANEA Développement Page 122 sur 133


Connecteur IE
TMS Suite

Dans cette balise prestataire vous devez indiquer le nom du fichier Querie Prestataire que vous voulez
utiliser.
Cette méthode offre l’avantage de pouvoir paramétrer des regroupements en fonction des prestataires
et de leur mode de fonctionnement.

10.4. CHAMPS LIBRES

Le connecteur IE n’envoi que des éléments contenus dans ses tables. Il se peut donc que dans
certains cas des informations particulières doivent être envoyées par le connecteur IE alors que la
donnée n’est pas disponible.

Pour gérer les exceptions et les cas particuliers le table des missions du connecteur IE a à sa
disposition 5 champs libres pour chacun des types suivants date, heure, texte, décimal et commentaire.
Pour alimenter ces champs il faut mettre en place un programme dans Profiles/SRC dont le nom est
RAC_IECONNECT.P « RAC devant être remplacé par le RAC du client ». (un fichier
stand_ieconnect.p est présent sur le répertoire d’installation qu’il suffit alors de copier-coller dans
profiles/src et de renommer).

Exemple:

DEFINE INPUT PARAMETER suite_mission AS HANDLE NO-UNDO.


DEFINE INPUT PARAMETER connect_mission AS HANDLE NO-UNDO.

FOR FIRST ordre field(otscle tiecode) WHERE ordre.otscle = INTE(suite_mission::otscle) NO-LOCK:


Find first tier where tier.tiecode = ordre.tiecode NO-LOCK no-error.
CONNECT_mission::TEXTE_LIBRE5 = TIER.TIENOM.
END.

Ce programme prend en charge la clé de l’ordre de la missions à partir de là on peut rebondir


sur chacune des tables liées comme pour le corps de facture. L’attribution d’un valeur à une champ se
fait avec la commande CONNECT_MISSION :: »Nom du champs du connecteur ».

Liste des champs libres disponibles : TEXTE_LIBRE1, TEXTE_LIBRE2, TEXTE_LIBRE3,


TEXTE_LIBRE4, TEXTE_LIBRE5, MEMO_LIBRE1, MEMO _LIBRE2, MEMO _LIBRE3, MEMO
_LIBRE4, MEMO _LIBRE5,
DATE_LIBRE1, DATE _LIBRE2, DATE _LIBRE3, DATE _LIBRE4, DATE _LIBRE5,
HEURELIBRE1, HEURELIBRE2, HEURELIBRE3, HEURELIBRE4, HEURELIBRE5,
DECIMALLIBRE1, DECIMALLIBRE2, DECIMALLIBRE3, DECIMALLIBRE4, DECIMALLIBRE5,

10.5. CONTENUE MISSION

La mission générée dans le connecteur IE alimente un catalogue de champs qui sont


disponibles pour l’outil de transformation dans le connecteur IE.

© AKANEA Développement Page 123 sur 133


Connecteur IE
TMS Suite

Nom Table : IE MISSION

Nom Champ Libellé Valeur Commentaire


Connecteur IE Progiciel
IDMISSION Réservé 0
IDVOYAGE Réservé 0
IDMISSIONPRO Clé mission IEMCLE
IDVOYAGEPRO Clé voyage VOYCLE
IDMISSIONSENT Réservé 0 ou null
MISSION_GRP Réservé VIDE Indique si mission a été
concaténée
IDMISSION_IE Réservé VIDE
IDMESSAGE Réservé 0
IDPRESTATAIRE Réservé VIDE
VOYAGE Clé voyage VOYCLE
SEGMENT Clé du segment PLACLE N’est alimenté que sur la mission
ayant un segment
IDPROGICIEL Réservé VIDE
MODELMISSION Réservé VIDE
METIER Réservé VIDE
EXPLOITANT Code exploitant Code exploitant
qui a envoyé la
mission
UTILISATEUR Réservé VIDE
NUMERO Numéro ordre/ VIDE Numéro de l’ordre si mission lié à
voyage un planning sinon numéro du
voyage
IDPOINT Clé du point de OTDCLE Clé de l’orddet lié à la mission
chargement ou de
livraison
VEHICULE Code véhicule Code véhicule
de progiciel
CHAUFFEUR Code chauffeur Code chauffeur
du progiciel
NUM_ORDRE Numéro ordre Numéro venant
mission de
l’ordonnanceme
nt du voyage
SENSPOSITION Réservé 0
ACTION Réservé NEW
ETAT Réservé « ATTENTE »
ENVOI_IMMEDIA Réservé VIDE
T
TYPES Réservé IEMTYPE
RUPTURE Réservé VIDE
DATE_DEB Date de début de IEMDATE Date début du point de
mission chargement ou de livraison de
l’ordre ou du planning dans le cas
de mission de type relais
HEURE_DEB Heure de début de IEMHTDEB Heure de début du point de
mission chargement ou de livraison de

© AKANEA Développement Page 124 sur 133


Connecteur IE
TMS Suite

l’ordre ou du planning dans le cas


de mission de type relais
DATE_FIN Date de début de IEMDATEFIN Date fin du point de chargement
mission ou de livraison de l’ordre ou du
planning dans le cas de mission de
type relais
HEURE_FIN Heure de début de IEMHTDEB Heure fin du point de chargement
mission ou de livraison de l’ordre ou du
planning dans le cas de mission de
type relais
KM Réservé 0
PLACE_ID Donneur d’ordre TIECODE Code Tiers du donneur d’ordre
PLACE_LIB Tiers IEMNOM Nom du tiers de la mission
ADRESSE1 Adresse 1 IEMADR1 Adresse 1 du tiers de la mission
ADRESSE2 Adresse 2 IEMADR2 Adresse 2 du tiers de la mission
ADRESSE3 Réservé VIDE
PAYS Pays IEMPAYINTER Code international de la fiche pays
de la mission
DPT Département IEMCP
CP Code Postal IEMCP
VILLE Ville IEMVILLE
LATITUDE Latitude IEMLAT
LONGITUDE Longitude IEMLONG
REF1 Référence IEMREFCLT Référence client de l’ordre
REF2 Numéro de OSTNUMCDE
commande
REF3 Réservé VIDE
COMMENT1 Commentaire IEMMEMO1 Commentaire lié au point de
chargement ou de livraison de
l’ordre, ou commentaire du voyage
dans le cas de missions liées à un
voyage
COMMENT2 Commentaire IEMMESS
COMMENT3 Expéditeur/Destinata OtdNom + " " + Nom de l’expéditeur, département
ire Dpt + " " + et ville si la mission est de type
OtdVille livraison, nom du destinataire,
département et ville si la mission
est de type chargement
COMMENT4 Donneur d’ordre Tier.TieNom + " Nom du donneur d’ordre, plus
" + Dpt + " " + département, plus ville
TieVille.
PORT_DU Montant Port Dû OTSASSIGNE
C_REMB Montant contre OTSMTCR
remboursement
CTNR_ID Numéro container OTSCONTAINE
R
CTNR_TAILLE Taille container OTSCONT-
TAILLE
CTNR_FULL Container Plein/Vide OTSCONT-
PLEINVIDE

© AKANEA Développement Page 125 sur 133


Connecteur IE
TMS Suite

CNTR_ENTREE Container OTSCONT-


Entrée/Sortie ENTREESORTI
E
CNTR_REF_DOU Ref Douane OTSCONT-
ANE NDOUANE
CNTR_NAVIRE Nom du Navire OTSCONT-
NAVIRE
CNTR_REFAMP Ref AMP OTSCONT-
REF-AMP
CNTR_CONSIGN Consignataire OTSCONT-
CONSIGNATAI
R
CNTR_ARMEMEN Armement OTSCONT-
T COMPAGNIE
TEXTE_LIBRE1 Libre
TEXTE_LIBRE2 Libre
TEXTE_LIBRE3 Libre
TEXTE_LIBRE4 Libre
TEXTE_LIBRE5 Libre
MEMO_LIBRE1 Libre
MEMO_LIBRE2 Libre
MEMO_LIBRE3 Libre
MEMO_LIBRE4 Libre
MEMO_LIBRE5 Libre
DATE_LIBRE1 Libre
DATE_LIBRE2 Libre
DATE_LIBRE3 Libre
DATE_LIBRE4 Libre
DATE_LIBRE5 Libre
HEURELIBRE1 Libre
HEURELIBRE2 Libre
HEURELIBRE3 Libre
HEURELIBRE4 Libre
HEURELIBRE5 Libre
DECIMALLIBRE1 Libre
DECIMALLIBRE2 Libre
DECIMALLIBRE3 Libre
DECIMALLIBRE4 Libre
DECIMALLIBRE5 Libre
DATE_ETAT Réservé VIDE
HEURE_ETAT Réservé VIDE

Nom Table : IE EMBALLAGE

Nom Champ Libellé Valeur Commentaire


Connecteur IE Progiciel
IDEMBALLAGE Réservé 0
IDMISSION Réservé 0
IDVOYAGE Réservé 0
IDEMBALLAGEPRO Type d’emballage TYPEPAL
IDMISSIONPRO Clé de la mission IEMCLE
IDVOYAGEPRO Clé du voyage VOYCLE

© AKANEA Développement Page 126 sur 133


Connecteur IE
TMS Suite

IDMISSIONSENT Réservé Vide


IDEMBALLAGESENT Réservé Vide
IDEMBALLAGE_IE Réservé Vide
ETAT Etat « ATTENTE »
IDMISSIONOLD Vide
TYPE_PALETTE Type d’emballage Typepal
QTE_TOTALE Nb total Total pal
d’emballage
QTE_RECU Réservé Vide
DATE_ETAT Réservé Vide
HEURE_ETAT Réservé Vide

Nom Table : IE ARTICLE

Nom Champ Connecteur IE Libellé Valeur Progiciel Commentaire


IDARTICLE Réservé 0
IDMISSION Réservé 0
IDVOYAGE Réservé 0
IDARTICLEPRO Article Mission IEMARTCODE Code article de l’ordre
ou du voyage
IDMISSIONPRO Clé de la IEMCLE
mission
IDVOYAGEPRO Clé du voyage VOYCLE
IDMISSIONENT Réservé VIDE
IDARTICLESENT Réservé VIDE
ARTICLE_GRP Réservé VIDE
IDARTICLE_IE Réservé VIDE
ETAT Etat « ATTENTE »
NUM_ORDRE Numéro Ordre IEMNUMORDRE
COD_ARTICLE Code article IEMARTCODE
LIB_ARTICLE Libellé article IEMARTLIB
TYPE_PALETTE Réservé Vide
QTE_TOTALE_PALETTE Nombre de IEMPALETTE
palette
QTE_RECU_PALETTE Réservé 0
QTE_TOTALE_COLIS Nombre de IEMCOLIS
colis
QTE_RECU_ COLIS Réservé 0
QTE_TOTALE_POIDS Poids en Kg IEMKG
QTE_RECU_ POIDS Réservé 0
QTE_TOTALE_VOLUME Volume IEMVOLUME
QTE_RECU_ VOLUME Réservé 0
QTE_TOTALE_MPLANCHER Mètre de IEMLONGUEUR
plancher
QTE_RECU_ MPLANCHER Réservé 0
QTE_TOTALE_HAUTEUR Hauteur IEMHAUT
QTE_RECU_ HAUTEUR Réservé 0
QTE_TOTALE_LARGEUR Largeur IEMLARG
QTE_RECU_ LARGEUR Réservé 0
TYPE_UM Réservé VIDE
QTE_TOTALE_UM Réservé 0

© AKANEA Développement Page 127 sur 133


Connecteur IE
TMS Suite

QTE_RECU_UM Réservé 0
UNITE1 Unité Joker 1 IEMPT1
UNITE1_RECU Réservé 0
UNITE2 Unité Joker 2 IEMPT2
UNITE2_RECU Réservé 0
UNITE3 Unité Joker 3 IEMPT3
UNITE3_RECU Réservé 0
UNITE4 Unité Joker 4 IEMPT4
UNITE4_RECU Réservé 0
UNITE5 Unité Joker 5 IEMPT5
UNITE5_RECU Réservé 0
UNITE6 Unité Joker 6 IEMPT6
UNITE6_RECU Réservé 0
UNITE7 Unité Joker 7 IEMPT7
UNITE7_RECU Réservé 0
UNITE8 Unité Joker 8 IEMPT8
UNITE8_RECU Réservé 0
UNITE9 Unité Joker 9 IEMPT9
UNITE9_RECU Réservé 0
UNITE10 Unité Joker 10 IEMPT10
UNITE10_RECU Réservé 0
DANGEREUX Réservé ORDRE.OTSMARDANG
CODE_ONU Réservé VIDE
VALEUR_DANGER Réservé ORDTXAE.OTTDANGER
CAB Réservé VIDE
DATE_ETAT Réservé VIDE
HEURE_ETAT Réservé VIDE

10.6. ORDRE D’ENVOI DES MISSIONS

Les missions comportent un ordre d’envoi. Par défaut cet ordre correspond à l’ordre des
éléments de l’ordonnancement du voyage.

Il est possible de contrer cet ordre-là au niveau du Connecteur IE et d’utiliser 3 autres


méthodes.

© AKANEA Développement Page 128 sur 133


Connecteur IE
TMS Suite

Aucun = Ordre du voyage


Chrg/Date = les missions sont envoyées en fonction de leur type (début voyage, chargement, livraison,
fin voyage) et de la date et heure. Quand se mode est activé, il faut activer l’exclusion des passages
à quai, des relais et des Voyages Segments
Date = les missions sont envoyées en fonction de leur date et heure
Libre = le mode sert à faire des tris personnalisés

10.7. CODE ISO DES PAYS

Le fichier M:\IEmdw\core\arborescence\client\countriesToISO.properties, contient la


correspondance entre le code International du progiciel et les codes ISO du connecteur IE. En cas
d’erreur lié au code ISO des pays, il faut corriger le fichier.

© AKANEA Développement Page 129 sur 133


Connecteur IE
TMS Suite

10.8. ELEMENTS TECHNIQUES

10.8.1. Description

Le Connecteur IE utilise un certain nombre d’ordre SQL pour fonctionner. Certains ordres ne
sont pas modifiables et d’autres, le sont afin de répondre au mieux aux besoins du client. Les requêtes
non modifiables sont situées dans .\ iemdw\src\com.sage.atl.middleware\jdbc\. Le fichier
« Queries.properties » contient des requêtes qui peuvent être modifiées, mais pour cela il faut
renommer le fichier et l’indiquer dans la fiche prestataire de la fiche client. Dans le répertoire .\
iemdw\arborescence\client\ doit se trouver les fichiers relatifs aux prestataires. Ces fichiers sont
référencés dans Clients.xml au niveau du nœud du prestataire

Ex :
<prestataire id="ELOSYSTEM" query="QueriesPrestataire.properties" />
Pour un client et un prestataire on doit forcément avoir un fichier « properties » Correspondant.

10.8.2. Paramétrage des fichiers de transformation XSLT

Pour communiquer et adapter ses données à chaque prestataire IE, le Connecteur IE utilise
une phase intermédiaire de transformation de fichier xml, transformant une structure standard
Connecteur IE en une structure s’approchant de celle du prestataire.

© AKANEA Développement Page 130 sur 133


Connecteur IE
TMS Suite

Le principe est de transformer un fichier XML au format Connecteur IE en un fichier XML au


format prestataire (et inversement pour les retours). Cette transformation se fait par le biais d’un fichier
de transformation XSLT. L’outil qui génère ce fichier est Altova MapForce. Les fichiers sources de
transformation (*.mfd) sont présents dans le répertoire « transformation » pour le Connecteur IE et
dans des sous répertoires pour chacun des prestataires.
Dans le répertoire de transformation on trouve en générale une transformation pour les envois,
une transformation pour les retours et éventuellement d’autres transformations, comme celle pour la
récupération des données sociales. Pour effectuer une transformation, il faut connaitre la structure
d’entrée et la structure de sortie. Ces structures sont décrites par le biais de fichier XSD qui se trouvent
dispatchés dans l’arborescence : ..\arborescence\model\xml\. Dans ce répertoire se trouvent les
fichiers descriptifs de la base du Connecteur IE. Pour les prestataires, il faut utiliser les fichiers
contenus dans le prestataire concerné. XXXUp.xsd étant le fichier à utiliser comme cible pour l’envoi
et XXXDown.xsd étant le fichier à utiliser comme source pour le retour. On peut aussi trouver des
fichiers XXXDS.xsd pour les données sociales. Ces fichiers ne doivent pas être modifiés, en cas de
manque d’informations, il faudra faire une demande au service R&D.

Comment modifier une transformation ?

Tout d’abords dupliquer et renommer le fichier de transformation que vous voulez modifier.
Ouvrez le fichier avec Altova MapForce, faites vos modifications et testez la transformation via l’onglet
output. Pour simuler une transformation, il faut disposer de fichier xml contenant des informations.
A l’ouverture, la visualisation des transformations peut paraître complexe. Une fois la
modification effectuée, gênerez le fichier XSLT (file\generate code in selected language) et renommez
celui-ci avant de le placer dans le répertoire qui convient : « \arborescence\joblet\prestataire\ ». Une
fois ce fichier placé, il faut le référencer au sein du fichier prestataires.xml (dans ..\
arborescence\prestataire). Arrêtez et Redémarrez le middleware et faites un test de communication.

10.8.3. Trace
Dans le répertoire M:\iemdw\core\arborescence\log sont stockés des fichiers. Ces fichiers
contiennent les traces de chaque opération réalisée par le connecteur IE. Lors de problèmes ces
fichiers peuvent être récupérés pour analyse.

10.8.4. Gestion de fichiers

Le connecteur IE est amené à gérer un certain nombre de fichiers. Il peut s’agir de fichiers
temporaires, de fichiers d’envois, de réceptions qui sont situés à divers endroits. Il n’existe pas
aujourd’hui de processus d’épuration, c'est-à-dire que les différents répertoires vont voir leur taille
grandir au fil du temps. Il faudra penser à planifier des Interventions d’épuration afin de parer à toutes
les problématiques que cela peut engendrer. De plus lors d’installation, il faudra bien s’assurer que les
droits de lecture et d’écriture soient activés.

Fichiers intermédiaire de traitement :


A l’issu de la prise en charge par le connecteur IE des informations contenues dans les tables
de dépose peuvent être stockées sous forme de fichier (si le paramètre est activé). Le système va
alors générer un fichier xml contenant l’image des informations issues de la première phase de
transformation.

Ces informations sont écrites dans :

© AKANEA Développement Page 131 sur 133


Connecteur IE
TMS Suite

middleware\arborescence\client\<ID_CLIENT>\envoi\<REP_DATE>
exemple :
.\middleware\arborescence\client\TST_CLI_ENT\envoi\20081107\
On aura donc autant de répertoire que de jour de fonctionnement et autant de fichiers que de
voyage ou message ayant passé la première phase de vérification et transformation.

Fichiers des messages envoyés :


Tous les voyages ou messages libre à envoyer au prestataire IE sont d’abord générés sous
forme de fichier XML au format AKANEA. Il s’agit des fichiers référencés dans la table
IE_MESSAGE_ENVOYE. Ici chaque fichier est déjà prédestiné à un prestataire, ils sont donc
dispatchés dans les répertoires adéquates :
\middleware\arborescence\prestataire\<ID_PRESTAIRE>\envoi
Dans ce répertoire nous trouvons un répertoire par jour (nom= YYYYMMDD). Les fichiers
seront donc déposés dans le répertoire du jour. Une fois traités, ils seront déplacés soit dans le
répertoire « histo » si tout c’est bien passé lors de la transformation, soit dans le répertoire « erreur »
si il y a des erreurs de transformation.

© AKANEA Développement Page 132 sur 133


Connecteur IE
TMS Suite

11. RETOUR SOMMAIRE AIDE TRANSPORT 14

Pour revenir sur le sommaire général cliquer sur le titre.

© AKANEA Développement Page 133 sur 133

Vous aimerez peut-être aussi