GIRTitan-Hyperion Lia · PDF fileGIR Titan-Hyperion lit régulièrement le...

$: GIRTitan-Hyperion Lia · PDF fileGIR Titan-Hyperion lit régulièrement le répertoire data\dti. Lorsqu'un -chierdontlenomvéri elasyntaxeci-dessusesttrouvé,etqu'ilestaccompagn$
GIR Titan-HyperionLiaison gestion de parc

www.gir.fr [email protected]

Version 1.0-14, février 2010

2

Copyright c© 2004-2009 klervi. All rights reserved.La reproduction et la traduction de tout ou partie de ce manuel sontinterdites, sans autorisation écrite préalable de klervi.Les informations contenues dans ce document ne sont données qu'àtitre indicatif ; elles peuvent être modi�ées sans préavis. Klervi nepeut, en aucun cas, être tenu responsable des erreurs qui pourraients'y être glissées.

Table des matières

1 Généralités 51.1 Modèle de données . . . . . . . . . . . . . . . . . . . . . . . . . . 51.2 Principe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.3 Création de �chier . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1.3.1 Exemple . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.4 Exécution de script . . . . . . . . . . . . . . . . . . . . . . . . . . 7

1.4.1 Syntaxe du programme hyp_script . . . . . . . . . . . . 81.4.2 Syntaxe du �chier script . . . . . . . . . . . . . . . . . . . 81.4.3 Exécution distante . . . . . . . . . . . . . . . . . . . . . . 91.4.4 Annulation . . . . . . . . . . . . . . . . . . . . . . . . . . 101.4.5 Erreurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2 Import 112.1 Fichiers d'import . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.1.1 Première ligne . . . . . . . . . . . . . . . . . . . . . . . . 112.1.2 Lignes suivantes . . . . . . . . . . . . . . . . . . . . . . . 11

2.2 Types d'imports . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.2.1 Rapprochement . . . . . . . . . . . . . . . . . . . . . . . . 122.2.2 Import des parties �xes (IGV1, IGD1, IGV3, IGD3) . . . 142.2.3 Import des parties variables (IGV2 et IGD2) . . . . . . . 162.2.4 Chaînes d'options . . . . . . . . . . . . . . . . . . . . . . 17

2.3 Purge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172.4 Exemple d'import . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3 Autres commandes 193.1 Commande 'set' . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.2 Commande 'export' . . . . . . . . . . . . . . . . . . . . . . . . . 19

A Formats d'import 21A.1 Format IGV1 - Véhicules, partie �xe . . . . . . . . . . . . . . . . 22A.2 Format IGV2 - Véhicules, partie variable . . . . . . . . . . . . . . 25A.3 Format IGV3 - Véhicules, partie �xe . . . . . . . . . . . . . . . . 26A.4 Format IGD1 - Usagers, partie �xe . . . . . . . . . . . . . . . . . 32A.5 Format IGD2 - Usagers, partie variable . . . . . . . . . . . . . . 34A.6 Format IGD3 - Usagers, partie �xe . . . . . . . . . . . . . . . . . 35A.7 Format IGS1 - Approvisionnements . . . . . . . . . . . . . . . . . 40A.8 Format IGC1 - Cartes pétrolières . . . . . . . . . . . . . . . . . . 41A.9 Format IGA1 - Activités . . . . . . . . . . . . . . . . . . . . . . . 42

3

4 TABLE DES MATIÈRES

A.10 Format IGE1 - Codes destinations . . . . . . . . . . . . . . . . . 42

Chapitre 1

Généralités

1.1 Modèle de donnéesLa liaison gestion de parc permet de synchroniser les données de GIR Titan-

Hyperion avec celles d'une autre application. Généralement, les deux principalestables sur lesquelles portera la synchronisation seront les tables des véhicules etdes usagers.

Dans GIR Titan-Hyperion, les véhicules et usagers s'intègrent dans le modèlede données suivant :

Véhicule

Type de véhicule

Réservoir 3Réservoir 2Réservoir 1

Usager

Service

Direction

� Les véhicules sont rattachés à un type de véhicule et à un service, lui-mêmerattaché à une direction. Un véhicule est également associé à une liste deréservoirs, qui dé�nit l'ensemble des produits autorisés sur ce véhicule.

� Les usagers sont rattachés à un service.

1.2 PrincipePlusieurs méthodes sont disponibles pour la synchronisation des données

avec GIR Titan-Hyperion :� Création de �chier : Un �chier de données est créé dans un répertoire

dédié, avec un nom prédé�ni. GIR Titan-Hyperion lit régulièrement cerépertoire, et lorsqu'un nouveau �chier est détecté, il est importé.

5

6 CHAPITRE 1. GÉNÉRALITÉS

� Exécution de script : Un �chier de données ainsi qu'un �chier script conte-nant les commandes à exécuter sont créés dans un répertoire partagé. Lasynchronisation s'e�ectue en exécutant le script avec un utilitaire fourni(hyp_script), qui se connecte à GIR Titan-Hyperion.

L'import par création de �chier est recommandé dans la plupart des cas, caril est plus simple à mettre en oeuvre. Chacune de ces méthodes est détailléedans la suite de ce document.

Dans tous les cas, plusieurs modes d'import sont disponibles :� Import complet : le �chier de données contient une ligne d'en-tête et plu-

sieurs lignes de données. L'import e�ectue synchronisation complète entrele �chier et la base de données de GIR Titan-Hyperion :� Les enregistrements présents dans le �chier et pas dans la base sont

créés� Les enregistrements présents dans le �chier et dans la base sont mis à

jour� Les enregistrements présents dans la base et pas dans le �chier sont

marqués 'À supprimer' et interdits.� Import incrémental : le �chier de données contient une ligne d'en-tête et

une seule ligne de données. L'enregistrement présent dans le �chier estcréé dans la base, ou mis à jour s'il existe déjà.

� Suppression : le �chier de données contient une ligne d'en-tête et une seuleligne de données. L'enregistrement présent dans le �chier est marqué 'Àsupprimer' et interdit dans la base.

Il est conseillé de plani�er un import complet au moins une fois par jour (parexemple en traitement de nuit), a�n de garantir une autoréparation du systèmeen cas de défaillance d'une synchronisation individuelle.

1.3 Création de �chierLa synchronisation par création de �chier s'e�ectue en deux étapes :� Création du �chier de donnée dans le répertoire data\dti. Le nom du

�chier doit véri�er une syntaxe précise, dé�nie ci-dessous.� Création du �chier d'acquittement dans le même répertoire. C'est un �-

chier vide avec le même nom de base que le �chier de donnée, en dehorsde l'extension qui doit être �.ok�. Ce �chier ne doit être créé qu'une foisque le �chier de donnée a été entièrement écrit, a�n d'éviter l'import d'un�chier partiel.

Le nom du �chier de données doit véri�er la syntaxe suivante :hypimp-<format>-<mode>-<id>.txtavec :� format: nom du format. Le nom de chaque format est précisé dans sa

description, en annexe de ce document. Exemples : IGV3, IGD3, . . .� mode: mode d'import

� all: Import complet

1.4. EXÉCUTION DE SCRIPT 7

� inc-add: Import incrémental� inc-del: Suppression

� id: identi�ant. Il doit être unique pour chaque nouveau �chier. Identi�antsrecommandés :� Pour l'import complet, date de génération du �chier à la seconde près,au format AAAAMMJJHHNNSS.

� Pour l'import incrémental ou la suppression, <date>-<key> où date estla date de génération du �chier au format AAAAMMJJHHNNSS, et key laréférence de l'élément synchonisé (ex : matricule de l'usager), que l'onretrouvera dans la colonne 'key' du �chier.

GIR Titan-Hyperion lit régulièrement le répertoire data\dti. Lorsqu'un �-chier dont le nom véri�e la syntaxe ci-dessus est trouvé, et qu'il est accompagnédu �chier d'acquittement �.ok� correspondant, il est importé. Une fois l'importterminé, le �chier donnée et le �chier d'acquittement sont supprimés.

1.3.1 ExempleOn dispose d'une application contenant une liste d'usagers, que l'on souhaite

synchroniser avec GIR Titan-Hyperion.On utilise le format IGD3 pour l'import des usagers.Les �chiers à générer dans data\dti\ sont les suivants :� Toutes les nuits à 1h, génération d'un �chier hypimp-igd3-all-AAAAMMJJHHNNSS.txt,

et du �chier d'acquittement hypimp-igd3-all-AAAAMMJJHHNNSS.ok.� En cas d'ajout ou de modi�cation d'un usager dans l'application cliente,

génération d'un �chier hypimp-igd3-inc-add-AAAAMMJJHHNNSS-<key>.txt,et du �chier d'acquittement hypimp-igd3-inc-add-AAAAMMJJHHNNSS-<key>.ok,où key est la clef de référence de l'usager.

� En cas de suppression d'un usager dans l'application cliente, générationd'un �chier hypimp-igd3-inc-del-AAAAMMJJHHNNSS-<key>.txt, et du �-chier d'acquittement hypimp-igd3-inc-del-AAAAMMJJHHNNSS-<key>.ok.

1.4 Exécution de scriptLa synchronisation par exécution de script s'e�ectue en deux étapes :� Création des �chiers de donnée et du �chier script. Ce dernier peut éven-

tuellement être constant.� Exécution du programme hyp_script.

Un �chier script est un �chier texte contenant une suite de commandes. Lasyntaxe des di�érentes commandes est détaillée ci-dessous.

L'exécution du script est déclenchée par le programme hyp_script qui ef-fectue une requête HTTP GET indiquant à GIR Titan-Hyperion le chemin du�chier à exécuter. Ce programme attend ensuite la �n de l'exécution du script.Il renvoit le code 0 si l'exécution s'est déroulée correctement, et le code 1 en casd'erreur.


1.4.1 Syntaxe du programme hyp_scriptLa syntaxe du programme hyp_script est la suivante :hyp_script [-o <flag_file>] <url> <file> [<port>]avec :� url: adresse web du programme cgi-bin sur le serveur GIR Titan-Hyperion

(ex : http://127.0.0.1/cgi-bin/twcgibin.exe).� file: chemin absolu du �chier script (ex : c:\hyperion\scripts\script.txt).� port: port du serveur GIR Titan-Hyperion (optionel, 4747 par défaut).

Options :� -o <flag_file>: Ecrit le résultat de l'opération dans le �chier spéci�é. La

première ligne du �chier contient le nombre d'anomalies non bloquantesayant généré un avertissement, la deuxième ligne contient la chaîne decaractères �OK� si l'exécution du script s'est terminée sans erreur, ou�ERR� sinon (Voir ci-dessous).

1.4.2 Syntaxe du �chier scriptLes commandes suivantes peuvent être utilisées dans un �chier script :� import [options] <format> <file>: Import d'un �chier de données.format est le format du �chier à importer. Les noms de formats valides

sont IGV1 à IGV3, IGD1 à IGD3, IGS1. Ces formats sont détaillésdans la suite de ce document.

�le est le chemin du �chier à importer, relativement au chemin du �chierscript.

options� --no-add: Ne crée pas les nouveaux enregistrements.� --no-del: Ne marque pas les enregistrements 'à supprimer'.

� purge [vehicles | drivers]: Supression des véhicules et/ou usagersmarqués 'à supprimer' depuis la dernière récupération de transactions,et non référencés. Ceci permet de s'assurer qu'il ne reste pas de transac-tions non récupérées sur certaines bornes qui pourraient référencer ceséléments. Lorsque des éléments sont référencés, la suppression n'est pos-sible que manuellement (Voir 2.3, page 17).

� set <name> <value>: Modi�cation des paramètres généraux.name est le nom du paramètre à modi�er.value est la valeur à a�ecter.Les noms des di�érents paramètres et les valeurs associées sont détaillésdans la suite de ce document.

� export [options] <app>: Export d'un �chier traclient (Voir 3.2, page 19).� lock <app>: suspend l'enregistrement de nouvelles transactions du type

sélectionnéapp est le type de transactions à suspendre :

� fuel: transactions carburant� supplies: approvisionnements� gauges: jaugeages� access: transactions accès

1.4. EXÉCUTION DE SCRIPT 9

� pool: transactions pool� unlock <app>: rétabli l'enregistrement de nouvelles transactions du type

sélectionné� dial [options] <scen>: lance un dialoguescen est le type de dialogue à lancer :

� retrieve: récupération des transactions� send: envoi des données

options� --cpu <val>: Dialogue limité à la borne sélectionnée (rapproche-

ment par Ref.).� live_cp [options] <format> <file>: copie un �chier �l de l'eau vers

la destination choisie� live_rm [options] <format>: supprime un �chier �l de l'eau� copy <source> <dest>: copie d'un �chier quelconque

Un caractère % ou # en début de ligne indique un commentaire. Ces lignessont ignorées lors de l'exécution du script.

Exemple de script d'import :

# Définition du séparateur CSVset ImportCSVDelimiter ,# Import des véhiculesimport IGV1 vehicles.csv# Import des usagersimport IGD1 drivers.csv...

Une commande et ses di�érents arguments doivent être sur une seule ligne,et séparés par au moins un espace ou une tabulation. Les lignes doivent êtreterminées avec les caractères de �n de ligne DOS (CRLF) ou Unix (LF).

Les caractères traités spéci�quement sont les suivants :� la double quote (") permet de dé�nir un argument comportant des espaces.� l'antislash (\) sert de caractère d'échappement, lorsque l'on souhaite uti-

liser un des caractères décrits dans ce paragraphe dans une commande.

Exemples :� import IGV1 "vehicles (backup).csv"� import IGD2 data\\drivers.csv� set ImportCSVStrDelimiter \"

1.4.3 Exécution distanteIl est possible d'éxécuter le programme hyp_script depuis une machine

autre que celle où GIR Titan-Hyperion est installé.Dans ce cas, le programme hyp_script et les �chiers qu'il utilise doivent

être accessibles dans un répertoire partagé, auquel les deux machines ont accèsvia le même chemin.


La machine distante doit également être autorisée à accéder à GIR Titan-Hyperion. Pour cela, on précisera son adresse IP dans la variable 'ScriptAuthAd-dr' du �chier data\dti\cust_cfg.txt. Il est possible d'utiliser les caractères jo-ker * et ? pour autoriser plusieurs machines (Ex : 'ScriptAuthAddr=192.168.0.*').

1.4.4 AnnulationLorsqu'un script est en cours d'exécution, il est possible de l'interrompre

manuellement, via le bouton Annuler dans B Exploitation, Import gestion de parc.Lorsqu'un script est annulé, les éléments 'à supprimer' ne sont pas position-

nés. D'une manière générale, l'annulation d'un script doit être exceptionnelle(ex : Import lancé par erreur en plein jour, tests lors de la phase de développe-ment. . .).

1.4.5 ErreursLes erreurs suivantes provoquent l'arrêt de l'exécution du script :� Fichier script

� Erreur de lecture du �chier� Erreur de syntaxe dans le �chier script� Annulation par l'utilisateur

� Import� Erreur de lecture du �chier d'import� Première ligne du �chier d'import invalide� Erreur d'écriture dans la base de données

D'autres erreurs (ex : ligne avec un format invalide dans le �chier d'import,référence à un élément inconnu,. . .) ne provoquent pas l'arrêt de l'exécutionmais font simplement l'objet d'un avertissement dans le �chier log. Le nombretotal d'avertissements générés au cours de l'exécution d'un script est conservé,et remonté dans la première ligne du �chier résultat généré par le programmehyp_script avec l'option -o.

Chapitre 2

Import

2.1 Fichiers d'importLes �chiers d'import sont des �chiers texte au format CSV. Les séparateurs

par défaut sont le point-virgule (' ;', ascii 0x3B) comme séparateur de champ etla double quote ('"', ascii 0x22) comme séparateur de texte.

En général, un �chier CSV correspond à tout ou partie d'une table dans GIRTitan-Hyperion. Les données attendues lors de la lecture du �chier CSV sontdi�érentes selon qu'il s'agit de la première ligne (en-tête dé�nissant le contenude la suite du �chier) ou des lignes suivantes (données).

2.1.1 Première ligneLa première ligne du �chier dé�nit la correspondance entre les champs CSV

et les champs de données de GIR Titan-Hyperion. Le format de chaque champCSV sur la première ligne est :

<nom>%<options>%<commentaire>nom : Nom identi�ant de manière unique le champ.options : Options a�ectant le traitement qui sera réalisé sur ce champ.commentaire : Chaîne de caractères quelconque, ignorée lors de l'import.

Le caractère '%' sert de délimiteur entre les di�érentes données au sein d'unchamp. Il peut être redé�ni par la commande set.

La présence des parties options et commentaire est facultative. En l'absencede séparateur, la totalité du champ CSV est interprétée comme nom de champ.

2.1.2 Lignes suivantesLes lignes 2 et suivantes dé�nissent les données. Leur format dépend du type

de champ. Les formats acceptés sont texte, numérique, date et date-heure.texte : Chaîne de caractères quelconques.numérique : Ensembles de caractères entre 0 et 9, éventuellement précédés du

signe '-'. Tous les champs numériques sont ramenés à des entiers, il n'y apas de format décimal (Par exemple, un volume est exprimé en centilitres,12.5 litres s'écriront donc '1250').

11

12 CHAPITRE 2. IMPORT

date : jj/mm/aaaa.date-heure : jj/mm/aaaa hh:nn ou jj/mm/aaaa hh:nn:ss. L'année et l'heure

sont séparées par un espace.Pour chaque format, les noms de champs valides ainsi que les types de don-

nées et options associées sont présentés en annexe de ce document.

2.2 Types d'importsLe fonctionnement des imports est très variable selon le type de donnée

importée. On peut distinguer trois types d'imports :1. Import des véhicules et usagers, parties �xes : Ces imports réalisent une

synchronisation entre les données dé�nies dans le �chier CSV et la basede données de GIR Titan-Hyperion. Le �chier CSV doit contenir la listedes véhicules ou usagers dé�nis. GIR Titan-Hyperion détermine à partirde cette liste quelles opérations réaliser pour que sa base de données soitsynchronisée avec ce �chier :Les enregistrements existants sont mis à jour, les nouveaux enregistre-ments sont créés, et les enregistrements qui ne sont plus mentionnés sontmarqués 'à supprimer'.

2. Import des véhicules et usagers, parties variables : Ces imports permettentde mettre à jour les informations susceptibles de varier fréquemment (ex :compteurs des véhicules, messages, . . .). Ils sont limités à la modi�cationde véhicules ou usagers existants.

3. Import de données historisées : Un nouvel enregistrement est créé dansune table d'historiques de GIR Titan-Hyperion, et le traitement associéest e�ectué (ex : dans le cas des approvisionnements, mise à jour du stockcuve). GIR Titan-Hyperion détecte les doublons sur ce type d'import : siune transaction a déjà été importée auparavant, elle sera ignorée.

2.2.1 RapprochementLes types d'imports 1 et 2 doivent e�ectuer un rapprochement entre une ligne

de données dans le �chier CSV, et un enregistrement dans la base de données deGIR Titan-Hyperion. Le champ utilisé pour e�ectuer ce rapprochement portetoujours le nom 'key'. Pour que la synchronisation fonctionne correctement, cetteclef doit identi�er de manière unique un enregistrement au sein d'une table.

Il est possible d'utiliser di�érents champs des tables véhicules et usagers entant que clef.

� Véhicules : Immatriculation, Code ou Ref.� Usagers : Nom, Code ou Ref.

Le rapprochement à utiliser est précisé dans les options du champ 'key'. Lesoptions indiquant une méthode rapprochement sont cumulables, leur ordre dé-termine dans quel ordre les rapprochements seront tentés :

� key%N: Rapprochement par nom (Immatriculation pour les véhicules).� key%R: Rapprochement par ref� key%RN: Rapprochement par ref puis par nom

2.2. TYPES D'IMPORTS 13

Lorsqu'aucune méthode de rapprochement n'est dé�nie, le rapprochementpar nom ('N') est utilisé par défaut.

De manière similaire, il est nécessaire d'utiliser un rapprochement lorsquel'on fait référence à des dépendances du véhicule ou usager. Exemples de tellesdépendances :

� Pour les véhicules : Types de véhicules, Services et Directions, Types debadges, . . .

� Pour les usagers : Services et Directions, Types de badges, . . .Comme pour le champ 'key', la méthode de rapprochement est spéci�ée

dans les options du champ sur lequel le rapprochement doit être e�ectué. Lesdi�érents rapprochements acceptés pour chaque champ sont détaillés dans lesformats d'import en annexe de ce document.

Les di�érentes méthodes de rapprochement sont :� par Nom ('N') : utilise les champs Nom abrégé et Nom complet dans la

table référencée. La recherche est d'abord e�ectuée sur le nom abrégé,puis sur le nom complet si la première recherche n'a pas abouti.

� par Ref. ('R') : utilise le champ Ref. dans la table référencée.� par Code ('C') : utilise le champ Code dans la table référencée.� par No d'enregistrement ('E') : utilise le numéro d'enregistrement interne

de GIR Titan-Hyperion. La numérotation commence à partir de zéro.

Les trois premières méthodes créent un nouvel enregistrement si aucun rap-prochement n'est trouvé (sauf sur les tables de con�guration, voir ci-dessous). Lerapprochement par numéro d'enregistrement nécessite par contre que l'élémentsoit déjà dé�ni dans la base.

Si la chaîne de données dé�nie dans un champ de type rapprochement estvide, deux signi�cations sont possibles :

� Si le champ est facultatif dans la base de données de GIR Titan-Hyperion(ex : Type de badge), la chaîne vide signi�e (N/A).

� Si le champ est obligatoire (ex : Service, Type de véhicule), la chaînevide laisse les enregistrements existants inchangés et utilise une valeur pardéfaut (voir ci-dessous) pour les nouveaux enregistrements.

Certains éléments ne peuvent pas être créés automatiquement lors de l'im-port : il s'agit des produits et des types de badges. Ce sont des informationsde con�guration qui doivent être créées manuellement. Si un type de badge ouproduit inconnu est référencé, il est ignoré avec un avertissement.

Exemples :� service%NR: Rechercher un service par nom, puis par référence.� idbadge%C: Rechercher un type de badge par code.

Le �chier suivant (format IGV1) utilise le champ Ref. pour e�ectuer le rappro-chement, dé�nit les champs immatriculation, type et service, et laisse les autreschamps inchangés (ou vides pour un nouveau véhicule). Les types de véhiculessont recherchés par nom, les services sont recherchés par Ref.


key%R; immat; type%N; service%R;A120; 1234AB69; voiture; S01;A121; 7451AB69; camion; S02;A122; 9834AB69; voiture; S02;

Pour la dé�nition des réservoirs (format IGV1) ou des zones locales (formatsIGV3-IGD3), la méthode de rapprochement est légèrement di�érente. En ef-fet, dans ce cas, la valeur à utiliser pour le rapprochement doit être spéci�éesur la première ligne du �chier CSV, avec l'option 'V'. Dans le cas des réser-voirs, on aura ainsi une colonne dé�nissant les réservoirs de Gasoil, une colonnedé�nissant les réservoirs de Super. . ..

Exemples :� tk1%NV'GOI': Faire un rapprochement sur le produit GOI par nom.� tk1%RNV'GOI': Faire un rapprochement sur le produit GOI par référence,

puis par nom.� lz1%NV'Lyon': Faire un rapprochement sur le site Lyon par nom.

2.2.2 Import des parties �xes (IGV1, IGD1, IGV3, IGD3)L'import des parties �xes réalise une synchronisation entre les données du

�chier CSV et celles de la base. Il peut être amené à créer de nouveaux enre-gistrements, non seulement dans les tables véhicules et usagers, mais égalementdans leurs dépendances (types de véhicules, services, réservoirs, zones locales. . .).

La suite de cette section détaille le fonctionnement de la synchronisation :

Les tables véhicules et usagers contiennent chacune un champ d'options dédiéà la synchronisation avec une gestion de parc. Ces champs contiennent deuxoptions : "Synchronisé" et "À supprimer".

Pour chaque ligne du �chier CSV, le champ de rapprochement ('key') estlu, et un élément véri�ant ce rapprochement est recherché. Plusieurs cas sontpossibles :

� L'élément n'a pas été trouvé : il est créé avec l'option "Synchronisé". Sil'import a été lancé via un script avec l'option --no-add, l'élément estignoré (Voir 1.4.2, page 8).

� L'élément a été trouvé et possède l'option "Synchronisé", il est mis à jour.� L'élément a été trouvé mais ne possède pas l'option "Synchronisé", il est

ignoré avec un avertissement.� L'élément a été trouvé plusieurs fois, il est ignoré avec un avertissement.Dans le cas d'un import complet, les éléments possédant l'option "Synchro-

nisé" qui n'ont pas été trouvés pendant l'import, sont marqués à supprimer etinterdits. La suppression e�ective de ces éléments est réalisée manuellement viaune opération d'exploitation (Voir 2.3, page 17).

Dans le cas d'un import incrémental, les éléments non trouvés restent in-changés.

Dans le cas d'un ajout, tous les champs fournis dans le �chier d'import sontutilisés pour remplir les champs du nouvel enregistrement. Les tables véhiculeset usagers contiennent un certain nombre de champs obligatoires. Si certains de

2.2. TYPES D'IMPORTS 15

ces champs obligatoires ne sont pas dé�nis dans le �chier CSV, une valeur pardéfaut est utilisée. Le tableau ci-dessous récapitule les valeurs par défaut pourles di�érents champs obligatoires des tables véhicules et usagers :

Table Champ Valeur par défautVéhicules Immatriculation Même valeur que celle utilsée pour le

rapprochement (code ou ref.)Véhicules Type Type 'Imported'Véhicules Service Service et/ou direction 'Imported'

selon les champs dé�nisUsagers Nom Même valeur que celle utilsée pour le

rapprochement (code ou ref.)Usagers Service Service et/ou direction 'Imported'

selon les champs dé�nis

Dans le cas d'une mise à jour, pour tous les champs dé�nis dans le �chierd'import, la valeur fournie est comparée à la valeur existante dans la base. Encas de di�érence, la valeur de la base est mise à jour. Les champs qui ne sontpas dé�nis dans le �chier d'import sont ignorés.

La mise à jour peut entraîner la création ou suppression de dépendances :� Création de directions et services� Création de types de véhicules� Création de pro�ls poolSi un service ou un type de véhicule n'est plus référencé, il reste dans la base

de données et doit être supprimé manuellement.

Sous-tablesLors d'un import, les sous-tables suivantes peuvent être modi�ées :

Réservoirs (véhicules seulement) :Le rapprochement est e�ecté par produit. Si un produit n'est pas men-tionné dans le �chier d'import, les éléments correspondants seront laissésinchangés. S'il est mentionné, les éléments correspondants seront ajoutés,supprimés ou mis à jour selon la valeur du champ dans le �chier CSV.

Exemple : Le véhicule '1234ZZ69' possède un réservoir de Gasoil (GOI),sans demande de compteur. Les exemples suivants indiquent quelles modi-�cations seront e�ectuées sur les réservoirs de ce véhicule selon le contenudu �chier d'import :

Réservoirs inchangés (aucune colonne avec V'GOI') :key%N; code;

1234ZZ69; 1234;Ajout de la demande de compteur km sur le réservoir de Gasoil :

key%N; tk1%NV'GOI';1234ZZ69; AK;

Ajout d'un réservoir d'huile :key%N; tk1%NV'GOI'; tk2%NV'HUI';

1234ZZ69; A; A;


Suppression du réservoir de Gasoil :key%N; tk1%NV'GOI';

1234ZZ69; ;

Zones locales (véhicules et usagers) :Le rapprochement est e�ecté par site. Le principe est identique à celui desréservoirs.

Véhicules autorisés (usagers seulement) :Un usager peut être autorisé soit sur certains véhicules spéci�ques, soit surun ensemble de véhicules. Selon la con�guration, l'ensemble de véhiculespeut être un service, une direction ou un groupe de services.Si un ensemble ne correspondant pas à la con�guration est spéci�é dans le�chier d'import (par exemple si le �chier d'import dé�nit des autorisationspar service alors que le logiciel est con�guré pour des autorisations pardirection), la colonne correspondante est ignorée.S'il existe au moins une colonne auth_veh, toutes les autorisations sur unvéhicule spéci�que seront mises à jour pour correspondre à celles dé�niesdans le �chier d'import.De même, s'il existe au moins une colonne auth_svc (respectivementauth_dir ou auth_grp selon la con�guration), toutes les autorisations parservice (resp. par direction ou groupe de services) seront mises à jour.Exemples :

Autorisation sur deux véhicules spéci�ques et autorisations parservice inchangées :key%R; auth_veh1%R; auth_veh2%R;1234; 1111ZZ69; 1112ZZ69;

Autorisation sur un service et aucune autorisation par véhicule :key%R; auth_svc1%R; auth_veh1%R;1234; svc01; ;

2.2.3 Import des parties variables (IGV2 et IGD2)Ces imports ne modi�ent pas les options de synchronisation des véhicules

et usagers, et ne créent pas d'enregistrements dans ces tables. Les élémentsdoivent donc avoir été dé�nis précédemment, via un import de partie �xe oubien manuellement.

Ils peuvent par contre créer de nouveaux messages. Lorsqu'un message crééautomatiquement n'est plus a�ecté à aucun véhicule ou usager, il est supprimé.

Le �chier suivant (format IGV2) utilise le champ Immatriculation pour ef-fectuer le rapprochement, et met à jour les compteurs kilométriques en créantdes transactions de volume nul. Le produit utilisé dans cette transaction estrecherché par nom.

key%N; kmeter; product%N;1234AB69; 74800; GOI;7451AB69; 262630; GOI;9834AB69; 127800; SUP;

2.3. PURGE 17

2.2.4 Chaînes d'optionsLes champs Options et Zones dans les véhicules et usagers sont des champs

de type option, ils sont a�chés dans GIR Titan-Hyperion sous la forme d'unensemble de cases à cocher. Dans les �chiers d'import, ces champs sont dé�nispar une chaîne d'option. Il s'agit d'une chaîne composée de caractères alphanu-mériques, où chaque lettre ou chi�re correspond à une option dans GIR Titan-Hyperion (ex : 'I' pour interdit, 'A' pour la zone A,. . .). Elles peuvent égalementcontenir les caractères '+' et '-'.

Une chaîne d'options interprétée de la façon suivante :

<options initiales>+<options à ajouter>-<options à enlever>

La partie 'options initiales' est utilisée pour a�ecter les nouveaux enregistre-ments. Si la chaîne d'options ne contient pas les caractères '+' ou '-', la partie'options initiales' est également utilisée pour écraser les valeurs existantes.

Si les caractères '+' ou '-' sont présents, ils déterminent respectivement lesoptions à ajouter ou à enlever dans les enregistrements existants.

Exemples :ABC: Positionne les options A, B et C et e�ace les autres options, à la fois dans

les nouveaux enregistrements et dans les enregistrements existants.ABC+B: Positionne les options A, B, et C dans les nouveaux enregistrements,

et positionne l'option B dans les enregistrements existants, en laissant lesautres options inchangées.

-C: Ne positionne aucune option dans les nouveaux enregistrements, et e�acel'option C dans les enregistrements existants.

A+: Positionne l'option A dans les nouveaux enregistrements, et laisse les en-registrements existants inchangés.

2.3 PurgeLors des imports de parties �xes, les éléments qui ne sont plus référencés

dans le �chier d'import sont marqués 'à supprimer' (Voir 2.2.2, page 14), etinterdits pour ne plus pouvoir se servir en carburant.

Ils restent néanmoins dé�nis dans la base, ce qui permet de conserver lestraces de leurs transactions, ou encore de les gérer manuellement (en décochantles options "Synchronisé" et "À supprimer").

La purge e�ective de ces éléments peut être réalisée de deux manières :� Automatiquement, avec la commande purge (Voir 1.4.2, page 8).� Manuellement, dans B Exploitation, Import gestion de parc.Dans ce second cas, le système demande la saisie d'une date et recherche

ensuite tous les éléments qui ont été marqués "À supprimer" avant cette date,puis e�ectue la purge après con�rmation.

S'il reste des transactions référençant des éléments supprimés, elles deviennentnon a�ectées. La purge des transactions est réalisée via une opération distincte,selon des critères de date (Voir le manuel de l'utilisateur).


2.4 Exemple d'importProblème : On dispose d'un parc de véhicules, identi�és par un code parc,qui s'identi�ent par badge à la borne. Le badge n'est pas connu dans le logicielde gestion de parc, et sera saisi dans GIR Titan-Hyperion. On souhaite égale-ment utiliser le code parc pour identi�er les véhicules lors d'une transaction viapompiste.

Solution possible : Les véhicules sont identi�és par leur code parc, cette va-leur va donc naturellement être utilisée pour e�ectuer le rapprochement (champ'key'). Il faut également déterminer dans quel champ ce code parc va être im-porté, et le spéci�er dans les options du champ 'key'.

Étant donné que les véhicules doivent pouvoir être identi�és à la borne parle code parc, le champ Code devra nécessairement contenir cette valeur. C'estdonc ce champ que nous allons utiliser pour e�ectuer le rapprochement, cequi permettra de laisser les champs Immatriculation et Ref. disponibles pourrenseigner d'autres informations. L'option à spéci�er pour le champ 'key' estdonc 'C'.

Il reste maintenant à préciser les informations que l'on souhaite ajouter. Pourchacune de ces informations, deux cas sont possibles :

� Soit on souhaite dé�nir une valeur �xe (par exemple que le champ Imma-triculation du véhicule de code parc 1234 soit toujours '1234AB69').

� Soit on souhaite seulement fournir une valeur par défaut pour les nouveauxvéhicules, qui pourra être ensuite librement modi�ée dans GIR Titan-Hyperion.

Ce comportement est paramétré par l'option 'I' sur les champs qui le sup-portent. Dans notre cas, nous allons l'utiliser pour fournir une valeur par défautau champ Code badge, a�n d'empêcher les véhicules nouvellement créés de pou-voir s'identi�er tous seuls à la borne avec leur code parc. On va donc spéci�erun badge non existant (par exemple 'FFFFFFFF'), qui sera remplacée manuel-lement par le gestionnaire de GIR Titan-Hyperion pour permettre au véhiculede s'identi�er par badge.

L'immatriculation, le service et les produits autorisés sont quant à eux com-plètement spéci�és lors de l'import. Si ces valeurs sont modi�ées dans GIRTitan-Hyperion, elles seront réinitialisées à la valeur spéci�ée à chaque import.

D'autres champs comme le type de véhicule ne sont pas du tout spé�ciésdans le �chier, ils seront donc crées avec une valeur par défaut ('Imported' dansle cas du type), et éditables librement par la suite dans GIR Titan-Hyperion.

Le �chier aura la forme suivante :

"key%C"; "immat"; "cbadge%I"; "service%N"; "zone"; "tk1%NV'GOI'"; "tk1vol""1234"; "1234AB69"; "FFFFFFFF"; "Admin"; "A"; "AK"; 50"1235"; "7531CD51"; "FFFFFFFF"; "Tech"; "A"; "AK"; 50"1236"; "7532CD51"; "FFFFFFFF"; "Tech"; "A"; "AK"; 50"1237"; "4084EJ75"; "FFFFFFFF"; "Admin"; "A"; "AK"; 50

Chapitre 3

Autres commandes

3.1 Commande 'set'Au début de l'exécution d'un script, tous les paramètres sont initialisés avec

leur valeur par défaut. La commande set permet de modi�er cette valeur. Letableau suivant présente les di�érents paramètres, ainsi que leur valeur par dé-faut :

Nom Par défaut CommentaireImportCSVDelimiter ' ;' Séparateur de champs dans les �chiers

CSV d'import.ImportCSVStrDelimiter '"' Séparateur de texte dans les �chiers

CSV d'import.ImportOptDelimiter '%' Délimiteur d'options dans les formats

d'import.ImportLockTimeout 60 Délai maximal d'attente lors du

verrouillage en écriture de la base dedonnées, en secondes.

ClearVehBdgOnRemove 0 Booléen (0 ou 1) indiquant si lescodes badges des véhicules doivent êtree�acés lorsqu'un véhicule est marqué'à supprimer'.

ClearDrvBdgOnRemove 0 Même chose que la variable précédente,pour les usagers.

3.2 Commande 'export'La commande export crée un �chier traclient dans le répertoire data\dto.Les formats utilisés sont déterminés par les paramètres dé�nis dans Con�g.

gestionnaire, Export traclient sécurisé. La description de ces formats est disponibledans le manuel utilisateur.

Syntaxe : export [options] <app>

app est le type de �chier traclient à exporter, parmi les valeurs suivantes :� fuel: transactions carburant

19

20 CHAPITRE 3. AUTRES COMMANDES

� supplies: approvisionnements� gauges: jaugeages� access: transactions accès� pool: transactions pool

options� --output <file>: Si file est un répertoire, le �chier généré dans data\dto

est copié vers ce répertoire. Sinon, file est interprété comme un che-min absolu de �chier, et le �chier généré dans data\dto est copié versce �chier.

� --flt-period <t0> <t1>: Exporte les transactions enregistrées au coursd'une plage de date spéci�que. Le format attendu est jj/mm/aaaa hh:mm:ss.Le mot-clef default est également accepté. Pour la date de début,default est la date de �n du dernier export. Pour la date de �n, defaultest la date actuelle.Lorsqu'aucun �ltre de date n'est précisé, les deux valeurs par défautsont utilisées.

� --flt-region <val>, --flt-site <val>, --flt-direction <val>,--flt-service <val>: Exporte seulement les transactions relatives àla région, au site, à la direction ou au service précisé. Le rapprochements'e�ectue par le champ Ref..

Exemple : export --flt-period "20/05/2007 00:00:00" "20/05/2007 23:59:59" fuel

Annexe A

Formats d'import

Les formats d'import des véhicules et usagers décrits ci-après sont communsaux applications de gestion de carburant et de gestion de pool.

Certains champs ne sont cependant disponibles que dans l'une de ces appli-cations. Ceci est renseigné par la colonne �App.� :

� 'carb.' signi�e que le champ n'est disponible qu'en gestion de carburant.� 'pool' signi�e que le champ n'est disponible qu'en gestion de pool.� une case vide signi�e que le champ est disponible dans les deux applica-

tions.

21

22 ANNEXE A. FORMATS D'IMPORT

A.1 Format IGV1 - Véhicules, partie �xe

Champ Format Options App. Commentairekey Texte CNR Champ obligatoire, utilisé pour le

rapprochement.C : Rapprochement par codeN : Rapprochement parimmatriculationR : Rapprochement par ref.

immat Texte DI Immatriculationref Texte DI Ref.nbadge Texte DIP carb. No badgeidbadge Texte DICEN carb. Type de badge

C : Recherche par code du type debadgeE : Recherche par no d'enregistrementdu type de badgeN : Recherche par nom du type debadge

cbadge Texte DI carb. Code badgecode Texte DI Codescode Num. DI carb. Code secrettype Texte DIENR Type de véhicule

E : Rapprochement parno d'enregistrement du type devéhiculeN : Rapprochement par nom du typede véhiculeR : Rapprochement par ref. du type devéhicule

direction Texte DIENR Direction(mêmes options que le champ type)

service Texte DIENR Service(mêmes options que le champ type)

krange Num. DI carb. Fourchette km (en km)hrange Num. DI carb. Fourchette horaire (en heures)

A.1. FORMAT IGV1 - VÉHICULES, PARTIE FIXE 23

options Texte D Chaîne d'options parmi les caractères :(options communes)I : InterditB : Identi�cation par badgeY : Initialisation badgeZ : Code via pompiste seulement

(options carb.)A : Code activitéS : Code spéci�que2 : 2e identi�cation (Id. usager)P : PompisteM : Menu pompiste

zone Texte D Chaîne d'options parmi [A-Z]tk1 Texte DIENRV carb. Réservoir 1, Chaîne de caractères

parmi :A : Produit autoriséK : Demande de compteurkilométriqueH : Demande de compteur horaireF : Option carburant

Rapprochement sur le produit :E : Rapprochement parno d'enregistrement du produitN : Rapprochement par nom duproduitR : Rapprochement par ref. du produitV : Valeur à utilser pour lerapprochement des produits.Le caractère suivant V est utilisécomme délimiteur :V'GOI' et V#GOI# sont équivalents

tk1vol Num. DI carb. Capacité du réservoir 1. Ce champ estignoré si leréservoir 1 n'est pas dé�ni.

... ... ... ... ...tk16 Texte DIENRV carb. Réservoir 16. Mêmes options que le ré-

servoir 1tk16vol Num. DI carb. Capacité du réservoir 16

L'option 'D' permet de désactiver un champ. Toute la colonne sera ignoréelors de l'import.

L'option 'I' permet de dé�nir un champ actif uniquement si l'enregistrementest créé par l'import. Si l'enregistrement existe déjà, la valeur renseignée dansle �chier est ignorée et le champ reste inchangé dans la base.

L'option 'P' recherche le numéro de badge spé�cié dans les �chiers proxi,et met à jour le champ Code badge si une correspondance est trouvée. Si un


code badge est également spéci�é dans le �chier d'import, il est utilisé lorsquele numéro de badge n'est pas trouvé dans les �chiers proxi, et ignoré sinon.

Le rapprochement sur les services est di�érent selon la présence ou non duchamp direction :

� Si aucune direction n'est précisée, la recherche est e�ectuée sur tous lesservices dé�nis dans la base. Les nouveaux services sont créés dans ladirection 'Imported'.

� Si une direction est précisée, la recherche est e�ectuée parmi les servicesde cette direction. Si la direction n'existe pas, elle sera créée.

Le caractère 'B' dans le champ 'options' permet de forcer le type d'identi�ca-tion à 'Badge'. Il n'est utile de spéci�er cette option que si les champs 'nbadge' et'cbadge' sont vides ou non précisés. En e�et, par défaut, le type d'identi�cation(badge ou code) est déterminé automatiquement d'après les champs dé�nis.

A.2. FORMAT IGV2 - VÉHICULES, PARTIE VARIABLE 25

A.2 Format IGV2 - Véhicules, partie variable



msg1 Texte D Première ligne du message a�ecté au vé-hicule

msg2 Texte D Seconde ligne du message (ignoré simsg1 n'est pas dé�ni)

options Texte D Chaîne d'options parmi :B : Bloqué pour entretien non faitI : Interdit

kmeter Num. D carb. Compteur kilométrique (en km)Importé via une transaction carburantde volume nul.

hmeter Num. D carb. Compteur horaire (en centièmesd'heure)Importé via une transaction carburantde volume nul.

product Texte DENR carb. Produit à utiliser dans la transactionde volume nul.Si aucun produit n'est précisé et quedes compteurs doivent être importés,le premier produit du véhicule selonl'ordre alphabétique est utilisé.E : Rapprochement parno d'enregistrement du produitN : Rapprochement par nom duproduitR : Rapprochement par ref. du produit


A.3 Format IGV3 - Véhicules, partie �xe



immat Texte DI Immatriculationref Texte DI Ref.nbadge Texte DIP carb. No badgeidbadge Texte DICEN carb. Type de badge

C : Recherche par code du type debadgeE : Recherche par no d'enregistrementdu type de badgeN : Recherche par nom du type debadge

cbadge Texte DI carb. Code badgecode Texte DI Codescode Num. DI carb. Code secrettype Texte DIENR Type de véhicule

E : Rapprochement parno d'enregistrement du type devéhiculeN : Rapprochement par nom du typede véhiculeR : Rapprochement par ref. du type devéhicule

type.nick Texte DI Nom abrégé du type de véhicule (à par-tir de la version 1.4.50)

type.name Texte DI Nom complet du type de véhiculetype.ref Texte DI Ref du type de véhiculemodel Texte DIENR Modèle de véhicule

(mêmes options que le champ type)model.nick Texte DI Nom abrégé du modèle de véhiculemodel.name Texte DI Nom complet du modèle de véhiculemodel.ref Texte DI Ref du modèle de véhiculedivision Texte DIENR Division

(mêmes options que le champ type)division.nick Texte DI Nom abrégé de la divisiondivision.name Texte DI Nom complet de la divisiondivision.ref Texte DI Ref de la divisiondirection Texte DIENR Direction

(mêmes options que le champ type)direction.nick Texte DI Nom abrégé de la directiondirection.name Texte DI Nom complet de la direction


direction.ref Texte DI Ref de la directionservice Texte DIENR Service

(mêmes options que le champ type)service.nick Texte DI Nom abrégé du serviceservice.name Texte DI Nom complet du serviceservice.ref Texte DI Ref du servicegroup Texte DIENR pool Groupe

(mêmes options que le champ type)class Texte DIENR pool Catégorie

(mêmes options que le champ type)krange Num. DI carb. Fourchette km (en km)hrange Num. DI carb. Fourchette horaire (en heures)nhours Num. DI carb. Nombre d'heures pour avoir sur capa-

cité (à partir de la version 1.4.15)expiry Date DI Expirationtipp_stat Texte DI carb. Statut TIPP (à partir de la version

1.4.26).Valeurs possibles :Vide : AucunP : PropriétaireL : LocataireSL : Sous-locataire

tipp_expiry Date DI Date de réforme TIPP (à partir de laversion 1.4.26)

msg1 Texte D Première ligne du message a�ecté au vé-hicule (à partir de la version 1.5.13)


kmeter Num. DF carb. Compteur kilométrique (en km) (àpartir de la version 1.5.13)Si l'option 'F' est présente, lecompteur est modi�é directement.Sinon, il est importé via unetransaction carburant de volume nul.

hmeter Num. DF carb. Compteur horaire (en centièmesd'heure) (à partir de la version 1.5.13)Le fonctionnement de l'option 'F' estidentique au compteur kilométrique.


options Texte D Chaîne d'options parmi les caractères :(options communes)I : InterditB : Identi�cation par badgeC : Identi�cation par codeY : Initialisation badgeZ : Code via pompiste seulementx : Critère générique 1y : Critère générique 2z : Critère générique 3

(options carb.)A : Code activitéS : Code spéci�que2 : 2e identi�cation (Id. usager)P : PompisteM : Menu pompisteT : TicketU : MutualiséX : Inhiber véhicule ext.R : Désactiver parcouru/conso.K : Compteur forçableQ : A�cher conso.L : Location

(options pool)a : Code activités : Code spéci�qued : Code destination

zone Texte D Chaîne d'options parmi [A-Z]


tk1 Texte DIENRV carb. Réservoir 1, Chaîne d'options parmi :A : Produit autoriséK : Demande de compteurkilométriqueH : Demande de compteur horaireF : Option carburantC : Avoir sur capacité (à partir de laversion 1.4.15)S : Avoir service (à partir de la version1.5.14)

Rapprochement sur le produit :E : Rapprochement parno d'enregistrement du produitN : Rapprochement par nom duproduitR : Rapprochement par ref. du produitV : Valeur à utilser pour lerapprochement des produits.Le caractère suivant V est utilisécomme délimiteur :V'GOI' et V#GOI# sont équivalents

tk1vol Num. DI carb. Capacité du réservoir 1. Ce champ estignoré si le réservoir 1 n'est pas dé�ni.

tk1cons_kref Num. DI carb. Consommation kilométrique de réfé-rence pour le réservoir 1 (en L/100km* 100)

tk1cons_kmin Num. DI carb. Seuil min. pour la conso. kilométriquedu réservoir 1 (en L/100km * 100)

tk1cons_kmax Num. DI carb. Seuil max. pour la conso. kilométriquedu réservoir 1 (en L/100km * 100)

tk1cons_href Num. DI carb. Consommation horaire de référencepour le réservoir 1 (en L/H * 100)

tk1cons_hmin Num. DI carb. Seuil min. pour la conso. horaire du ré-servoir 1 (en L/H * 100)

tk1cons_hmax Num. DI carb. Seuil max. pour la conso. horaire du ré-servoir 1 (en L/H * 100)

... ... ... ... ...tk16 Texte DIENRV carb. Réservoir 16. Mêmes options que le ré-

servoir 1... ... ... ... ...


lz1 Texte DIENRV Zone locale 1, chaîne de caractèresparmi [A-Z]Rapprochement sur le site :E : Rapprochement parno d'enregistrement du siteN : Rapprochement par nom du siteR : Rapprochement par ref. du siteV : Valeur à utilser pour lerapprochement des sites.Le caractère suivant V est utilisécomme délimiteur :V'Lyon' et V#Lyon# sont équivalents

... ... ... ... ...lz99 Texte DIENRV Zone locale 99 (16 max. dans les ver-

sions inférieures à 1.4.15)vc1 Texte DIENV Caractéristique 1 (à partir de la

version 1.4.32)Chaîne d'options parmi :A : Valeur dé�nie

Rapprochement sur la caractéristique :E : Rapprochement parno d'enregistrement de lacaractéristiqueN : Rapprochement par nom de lacaractéristiqueV : Valeur à utilser pour lerapprochement des caractéristiques.Le caractère suivant V est utilisécomme délimiteur :V'Couleur' et V#Couleur# sontéquivalents

vc1value Texte DI Valeur de la caractéristique 1.Ce champ est ignoré si lacaractéristique 1 n'est pas dé�nie.Le type de ce champ peut être texte,numérique ou date, selon le type de lacaractéristique. Les caractéristiques detype booléen sont interprétées commedes valeurs numériques, où 0 signi�e�faux� et toute autre valeur signi�e�vrai�.

... ... ... ... ...vc16 Texte DIENV Caractéristique 16 (à partir de la ver-

sion 1.4.32). Mêmes options que la ca-ractéristique 1.

... ... ... ... ...


Voir le format IGV1 pour la dépendance entre les champs service et direction,et la signi�cation des options 'D', 'I' et 'P'.


A.4 Format IGD1 - Usagers, partie �xe


rapprochement.C : Rapprochement par codeN : Rapprochement par nomR : Rapprochement par ref.

name Texte DI Nomfstname Texte DI Prénomref Texte DI Ref.nbadge Texte DIP No badgeidbadge Texte DICEN Type de badge

C : Rapprochement par code du typede badgeE : Rapprochement parno d'enregistrement du type de badgeN : Rapprochement par nom du typede badge

cbadge Texte DI Code badgecode Texte DI Codescode Num. DI Code secretdirection Texte DIENR Direction

E : Rapprochement parno d'enregistrement de la directionN : Rapprochement par nom de ladirectionR : Rapprochement par ref. de ladirection

service Texte DIENR Service(mêmes options que le champdirection)

options Texte D Chaîne d'options parmi les caractères :(options communes)I : InterditB : Identi�cation par badgeY : Initialisation badgeZ : Pompiste seulement

(options carb.)A : Code activitéS : Code spéci�que2 : 2e identi�cation (Id. véhicule)P : PompisteM : Menu pompiste

zone Texte D Chaîne d'options parmi [A-Z]

A.4. FORMAT IGD1 - USAGERS, PARTIE FIXE 33



A.5 Format IGD2 - Usagers, partie variable



msg1 Texte D Première ligne du message a�ecté àl'usager


options Texte D I : Interdit


A.6 Format IGD3 - Usagers, partie �xe



name Texte DI Nomfstname Texte DI Prénomnick Texte DI pool Initialesref Texte DI Ref.nbadge Texte DIP No badgeidbadge Texte DICEN Type de badge

C : Rapprochement par code du typede badgeE : Rapprochement parno d'enregistrement du type de badgeN : Rapprochement par nom du typede badge

cbadge Texte DI Code badgecode Texte DI Codescode Num. DI Code secretlogin Texte DI pool Login pour la connexion à l'interface

résa.passwd Texte DI pool Mot de passeemail Texte DI pool Adresse e-mailpro�le Texte DIEN pool Pro�l d'autorisations pool

E : Rapprochement parno d'enregistrement du pro�lN : Rapprochement par nom du pro�l

hierarchy Texte DI pool Hiérarchie, chaîne d'options parmi :D : Responsable de la directionS : Responsable du serviceA : Responsable de toutR : Exclure le responsableV : Validation seulementLes options D,S,A sont exclusives

type Texte DIENR Type d'usager (à partir de la version1.4.50)E : Rapprochement parno d'enregistrement du type d'usagerN : Rapprochement par nom du typed'usagerR : Rapprochement par ref. du typed'usager


type.nick Texte DI Nom abrégé du type d'usager (à partirde la version 1.4.50)

type.name Texte DI Nom complet du type d'usagertype.ref Texte DI Ref du type d'usagerdivision Texte DIENR Division

(mêmes options que le champ type)division.nick Texte DI Nom abrégé de la divisiondivision.name Texte DI Nom complet de la divisiondivision.ref Texte DI Ref de la divisiondirection Texte DIENR (mêmes options que le champ type)direction.nick Texte DI Nom abrégé de la directiondirection.name Texte DI Nom complet de la directiondirection.ref Texte DI Ref de la directionservice Texte DIENR Service

(mêmes options que le champ type)service.nick Texte DI Nom abrégé du serviceservice.name Texte DI Nom complet du serviceservice.ref Texte DI Ref du serviceexpiry Date DI Expirationmsg1 Texte D Première ligne du message a�ecté à

l'usager (à partir de la version 1.5.13)msg2 Texte D Seconde ligne du message (ignoré si

msg1 n'est pas dé�ni)


options Texte D Chaîne d'options parmi les caractères :(options communes)I : InterditB : Identi�cation par badgeC : Identi�cation par codeY : Initialisation badgeZ : Code via pompiste seulementx : Critère générique 1y : Critère générique 2z : Critère générique 3

(options carb.)A : Code activitéS : Code spéci�que2 : 2e identi�cation (Id. véhicule)P : PompisteM : Menu pompisteU : Autorisé sur véhicules mutualisésX : Inhiber véhicule ext.

(options pool)a : Code activités : Code spéci�qued : Code destinationg : Resp. casierG : Menu resp. casiere : E-mail auto

(options login)L : Identi�cation auto (à partir de laversion 1.4.13)

zone Texte D Chaîne d'options parmi [A-Z]tacho_dl Num. carb. Fréquence de déchargement pour cartes

tachygraphiques, en jours (à partir de laversion 1.4.10)

cpu_lang Texte carb. Langue à la borne (à partir de laversion 1.4.10, bornes TIP2-Vatersayseulement).Langues disponibles :Vide : Langue par défautfr : Françaisen : Anglaises : Espagnolnl : Néerlandaisde : Allemandit : Italien


auth_veh1 Texte DIENR carb. Véhicule autorisé 1E : Rapprochement parno d'enregistrement du véhiculeN : Rapprochement parimmatriculationR : Rapprochement par ref. duvéhicule

... ... ... ... ...auth_veh3 Texte DIENR carb. Véhicule autorisé 3auth_svc1 Texte DIENR carb. Service autorisé 1 (même rapproche-

ment que le champ service)auth_svc2 Texte DIENR carb. Service autorisé 2auth_dir1 Texte DIENR carb. Direction autorisée 1 (à partir de la ver-

sion 1.2.71, même rapprochement que lechamp direction)

auth_dir2 Texte DIENR carb. Direction autorisée 2 (à partir de la ver-sion 1.2.71)

auth_grp1 Texte DIENRS carb. Groupe autorisé 1 (à partir de laversion 1.2.71)E : Rapprochement parno d'enregistrement du groupe deservicesN : Rapprochement par nom dugroupe de servicesR : Rapprochement par ref. du groupede servicesS : Rapprochement par service (àpartir de la version 1.2.80). Cetteoption doit être utilisée en conjonctionavec E, N ou R. Ex : �SR� :rapprochement par ref du service.

auth_grp2 Texte DIENRS carb. Groupe autorisé 2 (à partir de la version1.2.71)

lz1 Texte DIENRV Zone locale 1, chaîne de caractèresparmi [A-Z]Rapprochement sur le site :E : Rapprochement parno d'enregistrement du siteN : Rapprochement par nom du siteR : Rapprochement par ref. du siteV : Valeur à utilser pour lerapprochement des sites.Le caractère suivant V est utilisécomme délimiteur :V'Lyon' et V#Lyon# sont équivalents

... ... ... ... ...lz99 Texte DIENRV Zone locale 99 (16 max. dans les ver-

sions inférieures à 1.4.15)


cls1 Texte DIENRV pool Autorisation pool 1. Chaîne d'optionsparmi :A : Autorisation dé�nie

Rapprochement sur la catégorie :E : Rapprochement parno d'enregistrementN : Rapprochement par nomR : Rapprochement par ref.V : Valeur à utilser pour lerapprochement.Le caractère suivant V est utilisécomme délimiteur :V'C1' et V#C1# sont équivalents.S'il existe des catégories avec un nomidentique dans des groupes di�érents,il est possible de préciser le nom dugroupe dans la chaîne derapprochement, en pré�xant le nom dela catégorie par ' :'.Par exemple, NV'G1:C1' recherchera lacatégorie de nom 'C1' dans le groupede nom 'G1'.

cls1order Num. DI pool Ordre de l'autorisationcls1auth_sp Texte DI pool Autorisation en prise spontanée.

Valeurs possibles :F : InterditO : Autorisé en débordementA : Autorisé (automatique)C : Autorisé avec choix véhicule

cls1auth_res Num. DI pool Autorisation en réservation. Mêmes va-leurs que pour la prise spontanée.

cls1auth_val Num. DI pool Autorisation en réservation avec vali-dation hiérarchique. Mêmes valeurs quepour la prise spontanée.

... ... ... ... ...cls32 Texte DIENRV pool Autorisation pool 32. Mêmes options

que l'autorisation pool 1... ... ... ... ...



A.7 Format IGS1 - Approvisionnements(carburant seulement)

Champ Format Options Commentairedate DateHeuretank Texte ENR Cuve

E : Rapprochement parno d'enregistrement de la cuveN : Rapprochement par nom de la cuveR : Rapprochement par ref. de la cuve

volume Num. Volume (en centilitres)uprice Num. Prix unitaire (en euros * 10 000)options Texte F : forcer un nouveau prix unitaire

pour le stock en cuve (désactive lecalcul du p.m.p., voir ci-dessous).

Les champs dates, cuve, volume, et prix unitaire doivent tous être renseignés.

Gestion des erreurs : GIR Titan-Hyperion détecte les approvisionnementsdéjà importés et les ignore. Ainsi, si l'on importe deux fois de suite le même�chier, le deuxième import n'aura aucun e�et.

Cette fonctionnalité peut être utilisée pour faciliter la gestion des erreurs :il est conseillé d'importer les approvisionnements sur une période glissante, a�nque l'échec ponctuel d'un import soit géré de manière transparente.

Par exemple, si un import d'approvisionnements est lancé automatiquementtous les jours, on dé�nira dans le �chier d'import l'ensemble des approvision-nements des 30 derniers jours. De cette façon, si l'import échoue pendant deuxjours, l'import suivant contiendra bien les approvisionnements des deux joursnon traités, et ceux des jours précédents seront ignorés grâce à la détection desdoublons.

Dans le cas où le calcul du prix est e�ectué par GIR Titan-Hyperion, il fautveiller à ce que les approvisionnements soient dé�nis dans l'ordre chronologiquedans le �chier d'import (voir ci-dessous).

Calcul du prix : Par défaut (sans l'option 'F'), GIR Titan-Hyperion calculeautomatiquement le nouveau prix du stock en cuve après approvisionnement,via la méthode du prix moyen pondéré (voir le manuel de l'utilisateur pourplus de détails). Cette méthode de calcul nécessite que les approvisionnementssoient importés dans l'ordre chronologique. Si un approvisionnement plus récentque celui à importer existe déjà dans la base de données, l'approvisionnement àimporter sera ignoré avec un avertissement.

Lorsque l'option 'F' est présente, le prix unitaire renseigné dans le �chierd'import est directement utilisé comme nouveau prix du stock en cuve. Si l'ap-provisionnement importé est le plus récent, le prix unitaire du stock en cuve estmis à jour, sinon il reste inchangé et seul le volume en cuve est mis à jour. Avecl'option 'F', les approvisionnements peuvent donc être importés dans un ordrequelconque, et le stock en cuve sera valorisé avec le prix unitaire de l'approvi-sonnement le plus récent.

A.8. FORMAT IGC1 - CARTES PÉTROLIÈRES 41

A.8 Format IGC1 - Cartes pétrolières(carburant seulement, à partir de la version 1.4.10)

Champ Format Options Commentaireoilco Texte ENC Pétrolier

E : Rapprochement parno d'enregistrement du pétrolierN : Rapprochement par nom dupétrolierC : Rapprochement par id. du pétrolier

oilclient Texte ENC Compte client pétrolier (à partir de laversion 1.4.29).E : Rapprochement parno d'enregistrement du compte clientpétrolierN : Rapprochement par nom ducompte client pétrolierC : Rapprochement par code ducompte client pétrolier

card Texte Numéro de la carteLa longueur des numéros doit être �xepour un même pétrolier

vehicle Texte DIENR VéhiculeE : Rapprochement parno d'enregistrement du véhiculeN : Rapprochement parimmatriculation du véhiculeR : Rapprochement par ref. duvéhicule

driver Texte DIENR UsagerE : Rapprochement parno d'enregistrement de l'usagerN : Rapprochement par nom del'usagerR : Rapprochement par ref. de l'usager

options Texte D Chaîne d'options parmi les caractères :H : compteur horaire

Voir le format IGV1 pour la signi�cation des options 'D' et 'I'.


A.9 Format IGA1 - Activités(à partir de la version 1.4.38)

Champ Format Options Commentairecode Texte Codenick Texte Nom abrégéname Texte DI Nom completref Texte DI Ref.options Texte D Chaîne d'options parmi les caractères :

I : interdit


A.10 Format IGE1 - Codes destinations(pool seulement, à partir de la version 1.4.38)

Champ Format Options Commentairecode Texte Codenick Texte Nom abrégéname Texte DI Nom completref Texte DI Ref.options Texte D Chaîne d'options parmi les caractères :

I : interdit


GIRTitan-Hyperion Lia · PDF fileGIR Titan-Hyperion lit régulièrement le...

Documents

Transcript of GIRTitan-Hyperion Lia · PDF fileGIR Titan-Hyperion lit régulièrement le...