Explorer les Livres électroniques
Catégories
Explorer les Livres audio
Catégories
Explorer les Magazines
Catégories
Explorer les Documents
Catégories
TMS Suite
CONNECTEUR IE
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
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.
Connecteur IE
Serveur Progiciel
(Suite ou Entreprise)
Transport
Prestataire IE
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 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 »).
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.
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.
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.
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é).
Choisir un compte qui servira à lancer les tâches planifiées, son mot de passe et le chemin UNC du
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
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.
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 ».
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.
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é ».
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.
Un écran s’ouvre, pour activer les fonctions de communication il faut cocher « Actif ».
Ensuite il faut cliquer sur le bouton Progiciel. Un nouvel écran s’ouvre il faut cocher actif puis
cliquer sur le bouton « Paramètres ».
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.
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.
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.
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
3 4
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.
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 »).
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
- 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 ».
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.
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.
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 »).
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.
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.
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é ».
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éé.
Le connecteur IE à ses propres programmes et sa propre base et donc peut évoluer être mis à
jour indépendamment du progiciel métier.
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.
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.
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.
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.
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.
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.
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).
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.
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
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.
Pour que ces opérations s’effectuent correctement, les fichiers suivant doivent être présents :
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
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é.
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.
Dans un premier temps il faut paramétrer une tâche planifiée qui exécute la commande :
shutdown -r
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.
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.
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, …).
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.
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
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.
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.
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 »
9.2.6. Ubidata
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.
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 »
9.2.7. Strada
9.3. TOMTOM
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.
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.
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.
9.4. GREENCAT
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.
Exemple : agat
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.
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.
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.
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 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.
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.
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.
Le mode GREENCAT MUT permet de communiquer avec les installations en mode serveur
mutualisé de GREENCAT.
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.
Le client Qualcomm (QUALCOMM Local Integration.msi) doit être préalablement installé sur le
poste où sera exécuté le connecteur IE.
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.
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.
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%%
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 ».
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.
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.
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
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
Pour naviguer dans le détail, il faut utiliser les flèches positionnées à droite.
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.
9.8. ELOMOBILE V2
9.8.4. Particularités
9.9. ELOMOBILE V3
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.
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 :
Si le chauffeur saisit « Oui » dès lors, il faudra compléter le « DONE » d’un événement « DONEL ».
9.10. TRANSICS
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.
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.
Saisie Ordre
Table :TOU_PLACE_EXTERN
EMABALLGE.TYPE_PALETTE + EMBALLAGE.QTE_TOTAL +
EMBALLAGE.QTE_RECU
MISSION.MEMO_LIBRE3
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
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.
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.
L’onglet « Base de donnée » doit comporter le nom de la base qui sera le même pour le
connecteur IE.
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
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.
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.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
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- Android
SMART
Niveau de planification :
Trip (Voyage) – Place (Mission) – Job (non-supporté) – Produit (Produit)
-> Gestion des voyages et Gestion sans voyage (mission par mission)
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.
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
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.
1-12 : %%IDFORM%%
Exemple (nom du modèle de mission) : 40000614
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.
2- Le deuxième mode affiche une trace de tous les processus exécutés par le Connecteur IE
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
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 ».
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.
Pour paramétrer les critères de concaténation il faut ouvrir le nouveau fichier properties.
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=
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é.
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.
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:
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
Les missions comportent un ordre d’envoi. Par défaut cet ordre correspond à l’ordre des
éléments de l’ordonnancement du voyage.
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.
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.
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.
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.
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.