Référence : [N de ref.] Version N : [N de version] Créé le : 20/04/2012 Créé par : Téléphone : Grégori DESAI [Téléphone]
Sommaire 1 Vue d ensemble du flot de données... 4 2 Installation du connecteur... 5 3 Correspondances et règles de gestion par entité... 6 3.1 Ecritures comptables / sociétés... 6 3.1.1 Abonnements / Contrats... 7 3.1.2 Lignes d abonnement / Prestations de service... 8 3.1.3 Lignes de document / Eléments de parc... 10 4 Configuration... 11 4.1 Fichier de configuration du connecteur... 11 4.1.1 Fichiers de configuration des données à remonter et des règles de gestion associées... 13 5 Annexes... 16 5.1 Requêtes SQL des modules de synchronisation... 16 5.2 Planifier l exécution du connecteur sur Windows Server... 18 Confidentiel Coservit Page 2
Préambule Les informations (données) contenues sur chacune des pages de ce document constituent des informations confidentielles de la société CoServIT et sont uniquement communiquées pour les besoins du projet. A réception de ce document, le destinataire accepte de garder confidentielles lesdites informations et de ne reproduire ou divulguer d aucune manière ces informations à toute autre personne que celles directement impliquées dans le projet, sauf autorisation écrite de CoServIT. Cette obligation de confidentialité ne concerne pas les informations qui (i) étaient connues du destinataire avant la réception du présent document sans restriction aucune, ceci pouvant être attesté par des éléments tangibles ; (ii) deviennent accessibles au public sans faute du destinataire ; (iii) sont valablement reçues par le destinataire à partir d une autre source sans restriction aucune. Légende Symbole Description Avertissement, remarque importante Information complémentaire A ne pas faire Aide à la compréhension d un sujet complexe Astuce, recommandation et bonne pratique texte Lignes de code, commande technique texte Lignes de fichier de configuration Confidentiel Coservit Page 3
1 Vue d ensemble du flot de données Sage L100 Ecritures comptables F_ECRITUREC Mise à jour Sociétés Company Sage CRM Abonnements F_ABONNEMENT Insertion / Mise à jour Contrats SSDI_business Lignes des pièces d abonnement F_ABOLIGNE + F_ABONNEMENT Insertion / Mise à jour Prestations de service SSDI_service Lignes de documents F_DOCLIGNE + F_ARTICLE + F_LOTSERIE Insertion / Mise à jour Eléments de parc SSDI_ci La synchronisation des données n est effective que sur les sociétés de Sage CRM ayant un code comptable identique à celui figurant sur Sage L100. Le code comptable est renseigné automatiquement sur Sage CRM lorsqu une intégration L100 standard est activée. Le code comptable peut être également saisi manuellement dans Sage CRM. Champ sur Sage CRM : comp_codecomptable Champ sur Sage L100 : CT_NUM Confidentiel Coservit Page 4
2 Installation du connecteur Le connecteur est composé de plusieurs ressources : Le job compilé archivé dans un fichier ZIP Les fichiers de configuration XML import+ à placer dans le répertoire de Sage CRM Un fichier «context» de configuration 3 fichiers Excel de configuration des règles de filtrage Une machine virtuelle Java dans sa version 6.x doit être installée sur la machine hébergeant le connecteur. Décompresser le fichier IntegrationL100etendueGeneriquev2.zip dans le répertoire «coservit» (généralement présent à la racine de c:\). Copier le fichier «default.properties» dans le répertoire relatif suivant : IntegrationL100etendueGeneriquev2\IntegrationL100\l100generiquev2\integrationl100_1_0\contexts\ Renseigner les informations contenues dans le fichier Copier les 3 fichiers XML dans le répertoire Sage : <repertoire Sage> <instance sage>/wwwroot\custompages\talend\xmlfiles\savedfiles\configs Renseigner les fichiers XLS de filtrage dans <Coservit>\IntegrationL100EtendueV2\IntegrationL100\Config Vérifier la présence la machine JAVA sur le système : ouvrir une console Ms Dosc (Menu démarrer executer cmd) taper en console : java version. Si la version s affiche, la configuration est bonne. Si la commande n est pas reconnue ou si une erreur s affiche, vérifier la bonne installation des Runtime Java (JRE) sur le système. Si java n est pas installé, ce rendre à l adresse suivante : http://www.java.com/fr/download/manual_v6.jsp Si java est installé et que la commande n est pas reconnue, vérifier que l exécutable est dans le PATH du système : Faire un clic droit sur le poste de travail dans le bureau Propriétés Dans l onglet «Avancé» cliquer sur Variables d environnement Double cliquer sur la variable d environnement «Path» Ajouter à la suite de la «valeur de la variable» le chemin d accès à l exécutable java.exe : C:\Program Files\Java\jre6\bin Valider, relancer un console dos et taper de nouveau : java version En console toujours, lancer une première exécution du Job avec le fichier IntegrationL100_run.bat présent dans : IntegrationL100etendueGeneriquev2\IntegrationL100etendueGeneriquev2\IntegrationL100 Confidentiel Coservit Page 5
3 Correspondances et règles de gestion par entité 3.1 Ecritures comptables / sociétés Mode de synchronisation : Mise à jour Correspondances Affichage Sage L100 Fiche : Client Onglet : Statistiques/solvabilité Sage CRM Fiche : Société comp_ssdi_solde comp_ssdi_encaisse comp_ssdi_encours1 comp_ssdi_encours2 comp_ssdi_encours3 comp_ssdi_blfa comp_ssdi_dernierefact comp_ssdi_dernierreglement Confidentiel Coservit Page 6
3.1.1 Abonnements / Contrats Un abonnement correspond à un contrat. Mode de synchronisation : Insertion / Mise à jour Clé de mise à jour : AB_No (Numéro interne de la table F_ABONNEMENT) CORRESPONDANCES DES CHAMPS Sage L100 Sage CRM Correspondance liste choix Fiche : Fiche : Abonnement Contrat Onglet : AB_Intitule busi_name Fiche principale AB_Contrat busi_commentcontrat AB_Periodicite et AB_TypePeriod busi_periodicite * AB_Debut busi_datedebut AB_Fin busi_datefin AB_Duree et AB_TypeDuree busi_dureecontrat * AB_Reconduction busi_typereconduction Tacite = Tacite A confirmer = Express Aucune = Non renseigné AB_Modele busi_typecontrat AB_Type Somme Montants HT des lignes d abonnement * Durée automatiquement convertie en mois busi_statut busi_prix Proposition abonnement = En cours Abonnement = En cours Résiliation = Résilié Modèle = Inactif Confidentiel Coservit Page 7
3.1.2 Lignes d abonnement / Prestations de service Une ligne d abonnement correspond à une prestation. Mode de synchronisation : Insertion / Mise à jour Clé de mise à jour : cbmarq (Numéro interne de la table F_ABOLIGNE) CORRESPONDANCES DES CHAMPS Sage L100 Sage CRM Correspondance liste choix Fiche : Fiche : Pièce type Nom contrat lié Prestation abonnement client AB_Intitule serv_ssdi_businessid Début abonnement lié AB_Debut Fin abonnement lié AB_Fin serv_datedebut serv_datefin AL_Design Aucun champ de correspondance Calcul basé sur Quantité ligne abonnement, durée contrat et périodicité contrat serv_name serv_modeleconso serv_qtevendu Voir section configuration via fichiers Excel Voir section suivante pour règle de gestion EU_Enumere Type abonnement lié AB_Type AR_Ref Modèle de l abonnement lié AB_Modele serv_uniteconso serv_statut serv_typeservice serv_typecontrat Heure = Heure Jour = Jour Unité = Jeton Proposition abonnement =En cours Abonnement = En cours Résiliation = Résiliée Modèle = Résiliée Pour être synchronisée, une ligne d abonnement doit obligatoirement appartenir à un contrat synchronisé. Dans le cas contraire, la prestation ne sera pas insérée. Cela peut survenir lorsque des règles de filtrages hétérogènes sont appliquées aux contrats et aux prestations. Confidentiel Coservit Page 8
Règles de gestion Quantité vendue. La quantité vendue est basée sur le calcul suivant : Quantité x (Durée Abonnement / Périodicité Abonnement) Exemple : Quantité ligne abonnement : 4 Durée abonnement 2 ans (24 mois) Périodicité abonnement : 3 mois Quantité vendue = 4 x (24/3) = 4 x 8 = 32 Confidentiel Coservit Page 9
3.1.3 Lignes de document / Eléments de parc Une ligne de document correspond à un élément de parc. Seules les lignes de document de type «facture» et «facture comptabilisée» seront retournées. L article devra également être sérialisé si précisé dans le fichier de configuration du connecteur. Mode de synchronisation : Insertion / Mise à jour Clé de mise à jour : cbmarq (Numéro interne de la table F_DOCLIGNE) CORRESPONDANCES DES CHAMPS Sage L100 Sage CRM Correspondance liste choix Fiche : Fiche : Facture à Référence article Référence Elément comptabiliser / AR_Ref ci_reference Facture de parc comptabilisée Désignation DL_Design N série / Lot LS_NoSerie Libellé ci_name Numéro de série ci_numserie Famille Article FA_CodeFamille Catégorie ci_categorieci Marque Article AR_Stat03 Marque éditeur ci_constructeur Date BC DL_DateBC Date d achat ci_dateachat Confidentiel Coservit Page 10
4 Configuration 4.1 Fichier de configuration du connecteur Le fichier de configuration se nomme «Default.properties» et est situé dans le répertoire suivant : <Coservit>\IntegrationL100EtendueV2\IntegrationL100\l100generique\integrationL100\contexts\ # Configuration Connexion MS SQL Sage CRM # #adresse IP ou nom serveur sqlserverhostcrm=cosvgre11 #Port serveur sqlserverportcrm=1433 #Instance serveur qui heberge la base de données (vide si aucun) sqlserveradditionaljdbcparameterscrm=instance\=sagecrm #Base de données sqlserverdatabasecrm=sagecrm #Compte SQL utilisé pour connexion sqlserverusernamecrm=sa #Mot de passe compte SQL sqlserverpasswordcrm=xxxxxx #Schéma de connexion (généralement dbo) sqlserverschemacrm=dbo # Configuration Connexion MS SQL Sage L100 # #Adresse IP ou nom serveur sqlserverhost=serveurip #Port serveur sqlserverport=1433 #Instance serveur qui heberge la base de données (vide si aucun) sqlserveradditionaljdbcparameters=instance\=sage #Base de données sqlserverdatabase=bijou #Compte SQL utilisé pour connexion sqlserverusername=sa #Mot de passe compte SQL sqlserverpassword=xxxxxx #Schéma de connexion (généralement dbo) sqlserverschema=dbo Confidentiel Coservit Page 11
# Configuration Connexion Connecteur CRM # #Nom de l'instance Sage CRM (identique nom de la base de données) sageinstance=sagecrm #Login compte admin sageuser=admin #Mot de passe compte admin sagepassword=xxxxxxx #Chemin d'accès au répertoire contenant les fichiers de config xml sageconfigpath=c\:/program Files/Sage/CRM/sagecrm/WWWRoot/CustomPages/Talend/XMLFiles/SavedFiles/Configs/ # Configuration du Job # #Chemin des fichiers de données générés datafilespath=c\:\\coservit \\IntegrationL100etenduev2\\IntegrationL100etenduev2\\IntegrationL100\\data\\ #Chemin fichiers de config Intégration configfilespath=c\:\\coservit \\IntegrationL100etenduev2\\IntegrationL100etenduev2\\IntegrationL100\\config\\ #Ne rémonter que les articles séralisés articlesserialisesseulement=1 #Adresse email de notification en cas d'erreur du job mailnotif=mail@example.com #Nom du client utilisé dans le titre du mail nomclient=client #Filtrage Dates // Pas encore pris en charge par le connecteur générique Confidentiel Coservit Page 12
4.1.1 Fichiers de configuration des données à remonter et des règles de gestion associées 3 fichiers Excel déterminent les enregistrements à remonter et les règles de gestion relatives aux 3 entités qui sont synchronisées. Ces fichiers sont situés dans le répertoire suivant : <Coservit>\IntegrationL100EtendueV2\IntegrationL100\Config ConfigContrat.xls La remontée des données se base sur deux champs issus des abonnements la Ligne100 : AB_Modele et AB_Intitule Les enregistrements des lignes d abonnements qui seront synchronisés seront ceux qui correspondront aux informations saisies dans ce fichier. Si rien n est renseigné, le connecteur ne synchronisera pas les contrats. Configurations possibles : «AB_Modele renseigné, AB_Intitule vide (Ligne 2) : la correspondance ne se fait que sur le modèle d abonnement, indépendamment de son l intitulé AB_Intitule renseigné, AB_Modele vide (Ligne 3) : la correspondance ne se fait que sur l intitulé de l abonnement, indépendamment de son modèle AB_Modele et AB_Intitule renseignés (Ligne 4) : la correspondance se fait sur les deux champs (opérande ET) Confidentiel Coservit Page 13
ConfigPrestation.xls La remontée des données se base sur deux champs issus des lignes d abonnements la Ligne100 : AB_Modele et AB_Ref Les enregistrements des lignes d abonnements qui seront synchronisés seront ceux qui correspondront aux informations saisies dans ce fichier. Si rien n est renseigné, le connecteur ne synchronisera pas les prestations. Configurations possibles : AB_Modele renseigné, AR_Ref vide (Ligne 2) : la correspondance ne se fait que sur le modèle d abonnement, indépendamment de sa référence article AR_Ref renseigné, AB_Modele vide (Ligne 3) : la correspondance ne se fait que sur la référence article de la ligne d abonnement, indépendamment de son modèle d abonnement AB_Modele et AR_Ref renseignés (Ligne 4) : la correspondance se fait sur les deux champs (opérande ET). Ce type de configuration est prioritaire sur les deux autres et permet de définir par exemple des cas particuliers. S ajoute à cela la configuration du mode de consommation, de l unité de mesure et de l équivalent du nombre d heures par unité dans Sage CRM des prestations correspondantes qui seront créées. Confidentiel Coservit Page 14
ConfigElementParc.xls Le fonctionnement de la configuration de ce fichier est identique à celui des contrats. Les champs de filtrage sont le code famille et la référence article. Confidentiel Coservit Page 15
5 Annexes 5.1 Requêtes SQL des modules de synchronisation A titre strictement informatif, les requêtes exécutées par le connecteur. Les données issues de ces requêtes sont traitées et modifiées par le connecteur avant leur insertion dans Sage CRM. Informations comptables : En cours SELECT convert(varchar(255),cbct_num),sum (EC_Montant * (1-2 * EC_Sens)) As 'Solde du Jour', SUM (CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END) As 'Encaissé', SUM(CASE EC_Sens WHEN 0 THEN CASE WHEN EC_Echeance <= GetDate() THEN EC_Montant ELSE 0 END ELSE 0 END) - SUM(CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END) - (SUM(CASE EC_Sens WHEN 0 THEN CASE WHEN EC_Echeance <= DATEADD(M,-1,GetDate()) THEN EC_Montant ELSE 0 END ELSE 0 END)- SUM(CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END)) As 'Echus à 1 mois', SUM(CASE EC_Sens WHEN 0 THEN CASE WHEN EC_Echeance <= DATEADD(M,-1,GetDate()) THEN EC_Montant ELSE 0 END ELSE 0 END) - SUM(CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END) - (SUM(CASE EC_Sens WHEN 0 THEN CASE WHEN EC_Echeance <= DATEADD(M,-2,GetDate()) THEN EC_Montant ELSE 0 END ELSE 0 END)- SUM(CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END)) As 'Echus à 2 mois', SUM(CASE EC_Sens WHEN 0 THEN CASE WHEN EC_Echeance <= DATEADD(M,-2,GetDate()) THEN EC_Montant ELSE 0 END ELSE 0 END)- SUM(CASE EC_Sens WHEN 1 THEN EC_Montant ELSE 0 END) As 'Echus à 3 mois' FROM F_ECRITUREC WHERE DATEADD(d,EC_Jour - 1,JM_Date) <= GetDate() AND DATEADD(d,EC_Jour - 1,JM_Date) >= (SELECT CASE WHEN D_DebutExo01 > D_DebutExo02 THEN D_DebutExo01 WHEN D_DebutExo02 > D_DebutExo03 THEN D_DebutExo02 WHEN D_DebutExo03 > D_DebutExo04 THEN D_DebutExo03 WHEN D_DebutExo04 > D_DebutExo05 THEN D_DebutExo04 WHEN D_DebutExo05 > D_DebutExo01 THEN D_DebutExo05 END FROM P_DOSSIER) AND EC_Lettre = 0 AND EC_Norme <> 2 GROUP BY cbct_num Informations comptables : BL & FA SELECT convert(varchar(255),cbct_num),sum (DL_MontantTTC) As 'Portefeille BL & FA' FROM F_DOCENTETE fent INNER JOIN F_DOCLIGNE flig ON (fent.do_type = flig.do_type AND fent.cbdo_piece = flig.cbdo_piece) WHERE fent.do_type>= 3 AND fent.do_type<= 3 AND flig.dl_valorise=1 GROUP BY cbct_num Confidentiel Coservit Page 16
Informations comptables : Dernière facture SELECT convert(varchar(255),cbct_num),max(dateadd(d,ec_jour - 1,JM_Date)) As 'Date Derniere Facture' FROM F_ECRITUREC fecg INNER JOIN F_JOURNAUX fcjr ON fcjr.cbjo_num = fecg.cbjo_num WHERE JO_Type = 1 AND EC_Norme <> 2 GROUP BY cbct_num Informations comptables : Dernier règlement SELECT convert(varchar(255),cbct_num),max(dateadd(d,ec_jour - 1,JM_Date)) As 'Date Dernier Reglement' FROM F_ECRITUREC fecg INNER JOIN F_JOURNAUX fcjr ON fcjr.cbjo_num = fecg.cbjo_num WHERE JO_Type = 2 AND EC_Sens = 1 AND EC_Norme <> 2 GROUP BY cbct_num Contrats SELECT AB_No, AB_TypeTiers, AB_Type, CT_Num, cbct_num, AB_Modele, cbab_modele, AB_Intitule, cbab_intitule, AB_Contrat, AB_Periodicite, AB_TypePeriod, AB_Duree, AB_TypeDuree, AB_Debut, AB_Fin, AB_Resiliation, AB_Motif, AB_Delai, AB_TypeDelai, AB_FinAbo, AB_Reconduction, AB_Tarif FROM F_ABONNEMENT Prestations SELECT al.ab_no, AR_Ref, AL_Design, AL_Qte, AL_PrixUnitaire, AB_Type,AB_Debut, AB_Fin, 'A la consommation' as modeconso, EU_Enumere as unitemesure, '1' as equivheure, al.cbmarq, LTRIM(RTRIM(ab.CT_Num)), AB_Periodicite, AB_TypePeriod, AB_Duree, AB_TypeDuree, AB_Modele FROM F_ABOLIGNE al LEFT JOIN F_ABONNEMENT ab ON al.ab_no = ab.ab_no WHERE AR_Ref IS NOT NULL Eléments de parc Select F_DOCLIGNE.cbMarq,F_DOCLIGNE.CT_NUM,F_DOCLIGNE.AR_ref,LS_NoSerie,FA_CodeFamille,AR_Stat03,DL_D esign,dl_datebc From F_DOCLIGNE INNER join F_LOTSERIE on F_DOCLIGNE.DL_No = F_LOTSERIE.DL_NOout INNER join F_ARTICLE on F_DOCLIGNE.AR_ref = F_ARTICLE.AR_ref WHERE (F_DOCLIGNE.DO_Type = 6 or F_DOCLIGNE.DO_Type = 7) Confidentiel Coservit Page 17
5.2 Planifier l exécution du connecteur sur Windows Server Menu Démarrer Outils d administration Planificateur de tâches Notes : copies d écran sur environnement Windows Server 2008 Confidentiel Coservit Page 18
Onglet «Déclencheurs» Nouveau Onglet «Actions» Nouveau : sélectionner le fichier IntegrationL100_run.bat Les configurations des onglets «Conditions» et «Paramètres» sont facultatives mais peuvent être modifiées au besoin. Confidentiel Coservit Page 19
Siège social Agence Grenoble 13 rue des Trembles 38100 Grenoble Tel : +33 (0) 4 76 70 57 10 Agence Paris 20 rue du docteur Georges Lafosse 92170 Vanves Tel : +33 (0) 1 41 90 68 30 www.coservit.fr Copyright 2009 Coservit. Tous droits réservés