Académique Documents
Professionnel Documents
Culture Documents
Installation et utilisation
CARL Software
283 rue de l'Etang, 69578 Limonest Cedex, France
Tél : +33 (0)4 26 29 49 49 - Fax : +33 (0)4 26 29 49 39
E-mail : info@carl.eu – Web : www.carl-software.fr
Sommaire
1 PRESENTATION .................................................................................................................................4
1.1 OBJET............................................................................................................................................... 4
1.2 PRINCIPE DE TRAITEMENT .................................................................................................................... 4
2 PRE-REQUIS ......................................................................................................................................5
3 INSTALLATION ..................................................................................................................................6
3.1 PROCEDURE ..................................................................................................................................... 6
3.2 ORGANISATION DES FICHIERS ............................................................................................................. 6
3.2.1 CARLLoader ................................................................................................................6
3.2.2 CARLLoader /config ..................................................................................................7
3.2.3 CARLLoader / CSV .....................................................................................................8
4 PARAMETRAGE ................................................................................................................................9
4.1 IMPORT DIRECT DANS CARL SOURCE................................................................................................. 9
4.1.1 Principe ........................................................................................................................9
4.1.2 Activation ....................................................................................................................9
4.2 PASSAGE DES PARAMETRES EN LIGNE DE COMMANDE ....................................................................... 10
4.3 EMPLACEMENT DES FICHIERS A TRAITER.............................................................................................. 10
4.4 ENCODAGE DES FICHIERS ................................................................................................................ 10
4.5 DECOUPAGE DES FICHIERS ............................................................................................................... 11
4.6 HEURES ET DATES ............................................................................................................................. 11
5 UTILISATION....................................................................................................................................12
5.1 PREPARATION DES DONNEES ............................................................................................................ 12
5.2 EXECUTION DE LA TRANSFORMATION ................................................................................................ 12
5.2.1 Lancement ................................................................................................................13
5.2.2 Résultat de l’exécution ............................................................................................13
5.2.3 Erreurs .........................................................................................................................14
6 CONTENU DES FICHIERS ................................................................................................................15
6.1 NOMS DE FICHIERS ET COLONNES ..................................................................................................... 15
6.2 FORMAT DES DONNEES A CHARGER.................................................................................................. 15
6.3 PRETRAITEMENT DES DONNEES .......................................................................................................... 16
7 DESCRIPTIF DE CHAQUE FICHIER..................................................................................................17
7.1 LISTES DE CONFIGURATION / CONFIG................................................................................................ 17
7.1.1 Eléments de listes de valeurs (valueListItem.csv) .................................................17
7.1.2 Site (site.csv) ..............................................................................................................17
7.1.3 Symptôme (symptom.csv) .....................................................................................17
7.1.4 Cause de panne (failureCause.csv) ....................................................................18
7.1.5 Remède (cure.csv) .................................................................................................18
7.1.6 Equipe (team.csv) ...................................................................................................18
7.2 MODULE ACHATS / PURCHASE......................................................................................................... 19
7.2.1 Nature d'achat : purchaseType.csv ......................................................................19
7.2.2 Fournisseur : vendor.csv ...........................................................................................19
7.2.3 Adresses fournisseur : vendorAddress.csv .............................................................20
7.2.4 Contacts fournisseur : vendorContact.csv ...........................................................20
7.2.5 Catalogue article : vendorItem.csv .......................................................................21
7.2.6 Catalogue service : vendorService.csv ................................................................21
7.2.7 Commande : PO.csv ...............................................................................................21
7.2.8 Lignes de commandes : POLine.csv ......................................................................23
1 Présentation
1.1 Objet
Ce document présente le mode d’installation et l’utilisation de l’outil qui permet d’effectuer
des chargements de données dans CARL Source pour la version 4.2.0, à partir de fichiers au
format CSV.
Fichiers
CSV
Lecture
Création
CARLLoader_run.bat
Traces
Fichiers
XML
Journalisation
(erreurs et
traitements)
Lecture
Exécution
interface
standard
Base de Journalisation
données (erreurs et
CARL Source traitements)
2 Pré-requis
Pour effectuer un chargement de données dans CARL Source avec CARL Loader, vous devez
disposer sur votre poste informatique des programmes suivants :
CARL Source version 4.2.0 en local ou accessible sur une autre machine.
Une machine virtuelle java (JVM / Sun) de version 1.6 minimum en local : celle-ci
permet l’exécution du programme de transformation.
Un accès au serveur CARL Source et un utilisateur valide : Permet de charger les fichiers
XML produits dans la base CARL Source, par appel du Web Service.
Un éditeur de texte : Pour visualiser les fichiers XML (en vue d’un contrôle éventuel de
leur contenu).
Avant de charger des données, nous vous conseillons d’effectuer une sauvegarde de
l’environnement dans lequel vous allez injecter des données.
CARL Loader permet de charger des données en phase initiale mais n’est pas prévu
pour réaliser des mises à jour au risque d’altérer vos données.
Pour effectuer une mise à jour des données, veuillez privilégier les interfaces de CARL
Source en mode csv.
En cas de chargement d'un même objet en plusieurs lots (plusieurs fichiers), veiller à ne
pas réinitialiser la séquence de codification concernant éventuellement l'identification
des enregistrements dans la base cible.
3 Installation
Le livrable est fourni sous la forme d’un fichier compressé (.zip).
Il comprend :
- Le fichier de commande CARLLoader_ run.bat, qui lance le chargement.
- Les fichiers de données exemples à renseigner.
3.1 Procédure
1) Recopier le fichier .zip dans le répertoire de votre choix.
2) Cliquer droit et choisir dans le menu déroulant “Extraire ici “.
3) Dans le répertoire se crée le dossier « CARLLoader »
3.2.1 CARLLoader
Ce répertoire contient les exécutables de l’outil de chargement de données :
CARLLoader_run.bat : mode non graphique
NB : Gestion de la langue.
Tous les fichiers avec en-têtes de colonnes en langue anglaise se trouvent dans le répertoire
« csv_anglais ».
Pour que ces fichiers soient pris en compte lors de la transformation en xml, il suffit de :
o renommer le répertoire « csv » en « csv_fr »,
o puis de renommer le répertoire « csv_anglais » en « csv ».
4 Paramétrage
CARL Loader offre la possibilité d’importer directement les données dans CARL Source.
4.1.1 Principe
Si cette option est activée, les fichiers xml obtenus à partir des fichiers csv sont directement
importés dans CARL Source en utilisant les interfaces d’importation standard de CARL Source.
Les rejets éventuels lors de l’import sont à consulter dans l’historique d’exécution des interfaces,
fonctionnalité [Systèmes externes] ou [Interfaces].
Par défaut, cette option n’est pas activée. Dans ce cas, les fichiers xml produits par CARL
Loader peuvent être importés depuis CARL Source, fonctionnalité [Systèmes externes] ou
[Interfaces].
4.1.2 Activation
Dans la section « Partie Web Service » du fichier config.properties, renseigner les paramètres
suivants :
# --- Tous les paramètres sont obligatoires si WSDLActive est à true --- #
WSDLActive=true
Login et mot de passe sont ceux utilisés pour la connexion à CARL Source.
Procédure :
- Ouvrir une fenêtre de commande
- Se positionner dans le répertoire CARLLOADER
- Saisir la ligne de commande :
CARLLoader_run --context_param [nom du paramètre]=[valeur]
Exemple :
Par exemple :
root=c:/CARLSource/mesfichiers/
Précisez le nombre maximum d'occurrences dans les fichiers XML produits sur le paramètre :
maxLineInXML
Par exemple :
maxLineInXML=1000
Les fichiers produits seront à importer par ordre croissant de suffixe. Ils seront automatiquement
importés dans cet ordre, si vous avez choisi l'import direct.
timezone=
Par exemple :
timezone=Europe/Paris
5 Utilisation
Cette partie propose une méthode permettant de charger les données dans les meilleures
conditions.
Les données doivent respecter le format décrit au paragraphe Format des données à charger.
UTILISATION D'EXCEL
Vous pouvez utiliser Excel pour renseigner ces fichiers, mais ceux-ci doivent être
impérativement enregistrés au format CSV (séparateur point-virgule).
5.2.1 Lancement
Le résultat pour chaque fichier de données peut être consulté dans les fichiers de log
du répertoire CARLLoader\log\Nom du module :
Les fichiers XML ont été créés ou mis à jour dans le répertoire CARLLoader\xml.
5.2.3 Erreurs
Une ligne peut être rejetée pour l’une des causes suivantes :
Un champ obligatoire n’a pas été renseigné.
La longueur d’un champ dépasse la taille limite.
La ligne est en doublon dans le même fichier.
Les noms des colonnes peuvent être modifiés sans impact sur la transformation, mais l'ordre
des colonnes doit être impérativement conservé.
Afin d'insérer des sauts de lignes dans les libellés long (Commentaires enrichis de CARLSource),
la balise<br> doit être utilisée à la place du retour chariot et le commentaire entier doit être
entouré par les balises <p></p>.
Exemple :
"Commentaire
détaillé
de l'intervention"
Dans les fichiers de caractéristique, les en-têtes des colonnes caractéristiques doivent être
renseignés avec le code de la caractéristique dans CARL Source.
Le nombre de colonnes est limité à 5 caractéristiques.
Même principe que pour les caractéristiques des modèles, en remplaçant le code modèle par
le code point.
Même principe que pour les caractéristiques des modèles, en remplaçant le code modèle par
le code matériel.
7.3.8 Facility
Ces fichiers sont à utiliser uniquement dans le cas de CARL Source Facility.
NB : Les caractéristiques des localisations Facility sont à renseigner dans boxCharact.csv, les
localisations Facility étant des points de structure particuliers.
Pour charger les liens entre Site, Bâtiment, Etage, Zone et Local, il faut utiliser le fichier
« linkequipment.csv ».
Site
Bâtiment
Local
Etage
Local
Zone
Local
NB : Le code de structure doit être celui indiqué dans CARL Source, par exemple 'INVENTAIRE'
remplace 'MATERIEL' dans le cas de la SANTE, et 'LOT_TECHNIQUE' remplace 'PRINCIPAL' en FM.
NB : Chaque code emplacement doit être unique. Cette restriction concerne uniquement le
contexte du chargement de données via CARL Loader, et en particulier le chargement du
détail de stockage des articles.
Dans l'application CARL Source, cette restriction n'existe pas, le code emplacement doit
seulement être unique pour un magasin donné.
Selon le mode de valorisation de stock retenu, la valeur du PMP à prendre en référence doit
être :
- En mode valorisation globale et mode de réapprovisionnement Global :
Dans ce mode, il faut utiliser les fichiers item.csv et batch.csv.
Les données suivantes doivent être égales :
- item.csv : PMP,
- batch.csv : Prix unitaire net
NB : Pour que l'import de mouvements de stock (date antérieure) puisse s’effectuer, il est
impératif d'adapter la valeur du paramètre de profil "Nombre maximum de jours autorisés pour
anti-datage des mouvements de stock", sur la fonction "Article".
Le code du site peut rester vide pour préciser les droits des entités où le site n'est pas renseigné
(matériel, intervention, …).
Colonne Format / Valeurs Commentaire
Numéro de ligne Entier
Code du groupe* Code
Code du site Code Si vide, fait référence aux entités sans
rattachement de site.
Tous les droits ? Booléen Par défaut : FAUX
Si VRAI, les 3 suivants sont à VRAI
Consultation autorisée ? Booléen Par défaut : FAUX
Suppression autorisée ? Booléen Par défaut : FAUX
Modification autorisée ? Booléen Par défaut : FAUX
NB : Le mot de passe pouvant être précisé dans le fichier csv doit être une chaine de
caractères encryptée MD5. Ex : 'DEMO' devient une fois encrypté :
'bd6dbd063f5ab7394879e3c08781cd72'.
De nombreux générateurs MD5 sont disponibles gratuitement sur internet afin de générer cette
donnée.
Il n'est pas possible, dans le chargement en masse proposé, d'indiquer pour un client X une
adresse appartenant à client Y du même groupement de client.
8 Ordre de chargement
Si l'option de chargement automatique dans CARL Source n'est pas activée, les fichiers XML
créés par le CARL Loader dans le répertoire xml sont à charger selon l'ordre indiqué dans le
tableau suivant.
Dans le cas où le nom du fichier est suffixé par un numéro, les fichiers sont à charger par ordre
de numéro croissant. Exemple : material0.xml, material1.xml, material2.xml, etc.
Remarque :
La colonne "Ordre" comporte un numéro qui correspond à l'ordre de chargement des fichiers
afin de ne pas rencontrer d'incohérence lors de l'import de données dans CARL Source.
L'ordre de classement des éléments dans le tableau ci-dessus résulte d’un regroupement par
thèmes fonctionnels.