SAFE X3 Eclipse
Quelques mots à propos de Sage
Sage dans le monde 3 ème éditeur mondial de solutions de gestion d entreprises. Un choix fait par 6,1 millions d entreprises 25 ans d expérience dans les progiciels de gestion pour les entreprises Sage, un éditeur pérenne Chiffres clés au 30 septembre 2010 1 650 millions d'euros de chiffre d'affaires 420 millions d euros d excédent brut d exploitation EBITA 13 400 employés dans 26 pays sur les 5 continents 30 000 partenaires revendeurs et intégrateurs 3 2010 Sage Division Moyennes & Grandes Entreprises
Sage en France 1 er éditeur en France de solutions de gestion d entreprises en nombre de clients (Source : IDC) Une base installée unique assurant une forte compréhension de l évolution du marché 2 ème éditeur en France de solutions de gestion d entreprises en chiffre d affaires (Source : IDC) Chiffres clés au 30 septembre 2010 315 millions d'euros de chiffre d'affaires 570 000 entreprises clientes, soit une entreprise équipée sur deux 2 455 employés 3 500 partenaires revendeurs et intégrateurs 4 2010 Sage Division Moyennes & Grandes Entreprises
Une organisation efficace à l écoute de nos marchés Sage accompagne les projets et la croissance de ses clients à travers des unités opérationnelles réactives sur leur marché Division Moyennes et Grandes Entreprises Division PME Les autres unités opérationnelles sont consacrées : A la gestion des processus métier (automobile, transport & logistique, agroalimentaire frais, immobilier...), Aux experts comptables A l export de nos solutions Ciel 5 2010 Sage Division Moyennes & Grandes Entreprises
Sage, le spécialiste des Moyennes et Grandes Entreprises La Division Moyennes et Grandes Entreprises de Sage est la première organisation dédiée à ce marché en France :» 770 collaborateurs expérimentés et spécialistes, la satisfaction client au centre des préoccupations 36% en R&D 42% en Support & Services» 13 000 entreprises clientes de plus de 100 salariés Un retour d expérience fort pour l évolution des offres et des services Une offre complète, experte et pragmatique, dédiée aux Moyennes et Grandes Entreprises 6 2010 Sage Division Moyennes & Grandes Entreprises
Sage Formation, un centre de formation agréé Une expertise produit doublée d une expertise métier» Un savoir faire pédagogique» Un savoir faire technique sur les environnements de Formation» 3 000 jours de formation animées par an» 4 500 stagiaires formés par an» 120 formations produits et thématiques Une direction de la formation et une équipe de formateurs dédiée» au métier de la formation,» à nos clients et nos partenaires» charge de toute l ingénierie pédagogique Un réseau de partenaires et des implantations géographiques importantes» Une équipe pédagogique soutenue et relayée par 150 consultants Sage et par un réseau de 100 partenaires en France» Des relais internationaux avec 9 filiales et une présence dans 44 pays Des formations certifiantes 7 2010 Sage Division Moyennes & Grandes Entreprises
Objectif A l issue de la formation, vous serez capable d installer et de manipuler Eclipse, un environnement de développement intégré libre, dans le cadre de projets de développement mettant œuvre le langage L4G Safe X3. 8 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 9 2010 Sage Division Moyennes & Grandes Entreprises
1. Présentation d éclipse Eclipse est un environnement de développement intégré libre, permettant de créer des projets de développement mettant en œuvre différents langage de programmation dont le langage L4G X3 par l ajout d un plugin. Cette IDE largement répandu dans le domaine de la programmation vous permettra de gagner en rapidité dans le développement des traitements. 10 2010 Sage Division Moyennes & Grandes Entreprises
Un assemblage de Plugins SAFE X3 JDT Studio (Java) for Eclipse IDE Help Resources Team Platform Runtime 11 2010 Sage Division Moyennes & Grandes Entreprises
Un IDE mais pas «que» Plus qu un IDE» Largement répandu pour développer en Java» Mais aussi pour C/C++, PHP, Javascript, Python,...» Plateforme pour développer des IDE mais aussi des applications Desktop (RCP), Webtop (RAP) ou serveurs Les bénéfices de la plateforme» Plugins chargés dynamiquement au besoin» Système de mise à jour intégré» «Personnalisable»» Multi OS (Windows, Linux, AIX,...)»... 12 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 13 2010 Sage Division Moyennes & Grandes Entreprises
2. Installation Eclipse Télécharger la dernière version d éclipse (Hélios 3.6) «Eclipse IDE for Java Developers»» Sur le site de sun http://www.eclipse.org/downloads/» Lors d une installation : Le composant Eclipse est présent dans le répertoire «FREECOMPONENTS\Eclipse» du DVD-ROM.» Sur OSP http://pluginx3.sage.fr/safex3/studio/downloads/downloads.html Extraire dans un répertoire» Renommer et déplacer au besoin dans un répertoire plus parlant : (ex: «C:\eclipse\» ou «C:\eclipse\3.5\») 14 2010 Sage Division Moyennes & Grandes Entreprises
Vérification de la JVM Nécessite une JVM 1.6 minimum» http://java.sun.com/javase/downloads/index.jsp Pour connaitre la version qui sera utilisée :» Taper «Java -version» dans un prompt de commande C:\>java -version java version "1.6.0_17" Java(TM) SE Runtime Environment (build 1.6.0_17-b04) Java HotSpot(TM) Client VM (build 14.3-b01, mixed mode, sharing) Attention! Certaines installations Oracle installent une vieille JVM (1.4.2) et modifient le Path système. 15 2010 Sage Division Moyennes & Grandes Entreprises
Corriger une mauvaise JVM Télécharger et installer une JVM sur le site de sun» http://java.sun.com/javase/downloads/index.jsp Si une version antérieure est exécutée 2 possibilités» Vérifier et corriger la variable d environnement PATH» Modifier le fichier eclipse.ini dans le répertoire d installation eclipse. Ajouter avant -vmargs (...) -vm Chemin_vers_mon_JRE1.6\bin\client\jvm.dll -vmargs -Dosgi.requiredJavaVersion=1.5 -Xms40m -Xmx256m 16 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 17 2010 Sage Division Moyennes & Grandes Entreprises
Démarrer... Démarrer eclipse = exécuter eclipse.exe Choisir un «workspace» Ne pas mettre les workspaces dans un sous-répertoire de son installation eclipse» Eclipse peut créer des répertoires au même niveau que le workspace Créer un répertoire chapeau (ex: D:\workspaces\X3)» Celui par défaut n est pas forcément un bon choix! 18 2010 Sage Division Moyennes & Grandes Entreprises
Configuration réseau Le déploiement de notre plugin repose sur une mise à jour via un accès HTTP. Dépendant de la stratégie d entreprise» Direct» Via Proxy sans authentification» Via Proxy avec authentification Modifier la configuration d accès au réseau si besoin menu «Window Preferences» Network Connection» Direct = pas de proxy» Native = informations fournies par le système Ne fonctionne pas toujours suivant les proxy» Manual = informations saisies par l utilisateur C est ce qu il faut utiliser en interne chez Sage 19 2010 Sage Division Moyennes & Grandes Entreprises
Configuration réseau «Manual» 20 2010 Sage Division Moyennes & Grandes Entreprises
Configuration réseau «Edit» Modifier l entrée HTTP Ne pas renseigner les entrées HTTPS et SOCKS User et Password sont des informations partagées entre toutes les installations eclipse Préferences : Secure Storage %USERPROFILE%\.eclipse\org.eclipse.equinox.security\secure_storage 21 2010 Sage Division Moyennes & Grandes Entreprises
Sites de mise à jour Eléments de base pour maintenir sa version à jour Menu «Help Install New Software» Ajouter un nouveau site de mise à jour» «Add...»» Name SAFE X3 Studio Update Site» Location http://pluginx3.sage.fr/safex3/studio/update/ (site externe) ou http://uranus2:8080/safex3/studio/update (site interne) 22 2010 Sage Division Moyennes & Grandes Entreprises
3. Installer ou mettre à jour le plugin Depuis le Menu «Help Install New Software»» Work with Sélectionner «SAFE X3 Studio Update Site»» Cocher «SAFE X3 Studio for Eclipse»» Cliquer sur «Next >», «Next >»» Accepter les termes de la licence» Cliquer sur«finish»» Redémarrer lorsque vous y êtes invité Depuis le Menu «Help Check for updates»» Interroge tous les sites référencés pour vérifier si des mises à jour sont disponibles.» Revoir la sélection si vous le souhaitez» Installer puis redémarrer Si un avertissement sur un contenu non signé apparait, cliquer sur OK 23 2010 Sage Division Moyennes & Grandes Entreprises
Installer ou mettre à jour le plugin localisation Plugin «SAFE X3 Studio for Eclipse Localization» N apporte qu une traduction Française partielle. Ce qui est hérité d Eclipse n est pas traduit.» Le projet Babel traduit les plugins Eclipse http://www.eclipse.org/babel/ Sur Eclipse Ganymede, Galileo et Helios nous avons constaté des dysfonctionnements majeurs après avoir testé la localisation via Babel! 24 2010 Sage Division Moyennes & Grandes Entreprises
Options de lancement Préciser un workspace» eclipse.exe data chemin_de_mon_workspace Démarrer eclipse en forçant une langue» eclipse.exe -nl en En Anglais» eclipse.exe -nl en_uk En Britannique» eclipse.exe -nl en_us En Américain» eclipse.exe -nl fr En Français Forcer eclipse à reconstituer son cache d informations sur les plugins installés» eclipse.exe clean Plus d infos sur» http://help.eclipse.org/help32/index.jsp?topic=/org.eclipse.platf orm.doc.user/tasks/running_eclipse.htm 25 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 26 2010 Sage Division Moyennes & Grandes Entreprises
Environnement de travail Les perspectives» Définissent une «façon» d agencer son environnement» Une perspective par défaut SAFE X3 Studio» Affichées via : Le Menu «Window Open Perspective» La toolbar Les vues» Fenêtre que l on organise autour de l éditeur de code source» Fournissent différents services et informations Explorateur de source Vue synthétique du code source (outline) Liste des erreurs de compilation Liste des fichiers verrouillés...» Affichées via : Le Menu «Window Show View» La toolbar 27 2010 Sage Division Moyennes & Grandes Entreprises
4. Créer un projet Menu «File New Project...»» Sélectionner «SAFE X3 Project»» «Next >»» Donner un nom pour le projet (ex: myserver_demo)» Renseigner les informations demandées (idem client X3) Folder (ex: DEMO) Hostname (ex: myserver) Port (ex: 16000) X3 User et X3 Password Language (ex: FRA, ENG,...) User et Password (authentification OS) Help Ne saisir que si l info n est pas présente dans le fichier solution.xml» «Finish» Performances au démarrage (lancement de la connexion)» 8 seconde pour la V1.2» 40 secondes pour les versions antérieurs. 28 2010 Sage Division Moyennes & Grandes Entreprises
Ajouter des traitements Sélectionner le projet Menu «File Open SAFE X3 Source file...»» Sélectionner dans la liste» Filtrer la liste» Saisir directement le nom d un traitement Organiser en créant des dossiers» Clic droit sur un projet, puis «New Folder»» Sélectionner les fichiers puis 2 options : Déplacement à la souris dans le dossier Clic droit menu «Move...» Commencer par désactiver le build automatique Menu «Project Build Automatically» Problème corrigé sur la V1.2 29 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 30 2010 Sage Division Moyennes & Grandes Entreprises
5. Les vues» Project Explorer : Arborescence des projets» Navigator : Arborescence des fichiers» Outline : Sous-programmes, Fonctions et traitements liés au traitement en cours d édition» Files properties : Infos de GESADC (ADICTRT)» Locked Files : Fichiers verrouillés (*.LCKsrc)» History : Historique local des modifications et/ou historique lié à un gestionnaire de sources (SVN, CVS,...)» Help : Aide dynamique» Bookmarks : Visualiser ses repères dans les sources» Problems : Erreurs de compilations, alertes sur la syntaxe» Error Log : Erreurs, Informations liés au fonctionnement des plugins Eclipse» Progress : Affiche les tâches d arrière plan en cours.» Search : Résultat des recherches dans les fichiers» Console : même possibilité que la calculatrice X3. 31 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur - 1» Colorisation syntaxique modifiable au menu Window Preferences puis SAFE X3 Studio Editor» Multi-fenêtrage» Passage en plein écran (Ctrl + M)» Complétion (Ctrl + Espace) sur les mots clés, les variables globales, les variables systèmes» Complétion sur les champs des abréviations (Tables et Masques) déclarées dans le traitement (Local File, Local Mask)» Auto-fermeture des caractères fonctionnant par paires : ", ', ( et [» Bulle d'aide (tables, masques, variables globales, menus locaux)» Templates de code et possibilité d'ajouter ses propres templates dans Window Preferences puis SAFE X3 Studio Templates 32 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur - 2» Commenter / dé-commenter (Ctrl + /) une ou plusieurs lignes à la fois» Indentation (Tab) d une ou plusieurs lignes à la fois» Atteindre les étiquettes, les procédures et fonctions (y compris celles déclarées dans d'autres traitements) selon la position actuelle du curseur (F3)» Détection des erreurs de syntaxe à la saisie» Navigation dans l'historique des déplacements multi-fichiers (Alt + flèche gauche et Alt + flèche droite)» Historique local des modifications (Clic droit, puis Compare With Local History...)» Comparaison fichier à fichier» Recherche multi-fichiers (Ctrl + H) dans les fichiers du workspace, d'un projet,... 33 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur 3 ; depuis la V1.2 Outline» Repose sur la modélisation du traitement sous forme d'une arborescence d'éléments.» Prise en charge de la «Quick Outline» (Ctrl+O).» Lien dynamique avec l'éditeur de code. Complétion» Sur les noms de traitements, fonctions, sous-programmes et étiquettes.» Complétion style notation pointée MONTRT. Afficher la liste des sous-pro puis remplace par Call... Ou Func...» Filtre pour les propositions Ne pas faire afficher les instructions x3 Ne pas faire afficher les propositions qui "contiennent" le texte à compléter 34 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur 4 ; depuis la V1.2 Editeur» Pliage / dépliage des «Subprog», «Funprog» et étiquettes.» Marquage dans la marge de la portée de l'élément de code.» Plier ou non les régions à l affichage d'un traitement.» Colorisation des étiquettes et des méthodes.» Action "Open Type" Ctrl+Shfit+T pour ouvrir un traitement présent dans le projet.» Repérage visuel pour les caractères allant par paires '(', '[',... Naviguer au sein de cette paire par Ctrl+Shift+P» Commentaires TODO et FIXME reportés dans la vue "Task".» Recherche typée (variables, méthodes,...) Se limiter aux déclarations et/ou aux références sur les éléments concernés.» Sauvegarder un traitement vide supprime celui-ci sur le serveur.» Ouverture de fichier en mode «local» 35 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur 5 ; depuis la V1.2 Vérification syntaxique» Prise en compte de la version du moteur» Erreur sur les instructions Goto... From A l'exécution elle se comportent comme une instruction End» Erreur sur les noms des procédures, fonctions et variables qui sont supérieurs à 30 caractères pour la V6 12 caractères pour une V5» Alertes sur les arguments non déclarés ou les déclarations d'arguments inattendues.» Alertes sur les Subprog, Funprog et étiquettes susceptibles de continuer en séquence. Projet» Dépendances de projets pour gérer le lien entre les dossiers mères et dossiers filles 36 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur 6 ; depuis la V1.2 Aides» Amélioration de la présentation des bulles d'aides.» Affichage du code et du libellé pour les tables et les masques.» Format de documentation dans un style Javadoc.» Vue "X3 documentation" synchronisée avec la position du curseur affiche l'aide sur les instructions et l'aide «Javadoc like»» Affichage de la valeur des messages mess() même en l absence du 3ème paramètre. Console» Amélioration de l ergonomie Prompt Correction du problème de positionnement du curseur» Complétion et historique des commandes saisies 37 2010 Sage Division Moyennes & Grandes Entreprises
L éditeur 7 ; depuis la V1.2 Tags» Regrouper les traitements selon diverses catégories» Vue "Explorateur X3" dédiée» Filtrer les projets suivant un ou plusieurs tags Mylyn» http://www.eclipse.org/mylyn/» Contexte de travail associé à une tâche correction, nouvelle fonctionnalité,...» Le contexte s'enrichit automatiquement au fur et à mesure de l'ouverture de traitements.» Passer d'un contexte à l'autre pour rétablir ses sousensembles de traitements.» Intégration avec les outils suivi de bugs et de projets Bugzilla, Trac, Jira,...» Collecter le temps passé sur chacune des tâches. 38 2010 Sage Division Moyennes & Grandes Entreprises
Préférences Personnaliser sa façon de travailler Menu «Window Preferences»» Keys : Touches claviers (différents profils)» Connection : Connexion Timeout Lock refresh rate» Editor : Colorisations Commentaires Instructions Etiquettes Chaînes Sous-programmes et fonctions» Http Service lien avec Client X3» Locks : Verrous Autoriser le déverrouillage (de ses propres verrous) Autoriser le déverrouillage de tous les verrous» Templates : Modèle de code 39 2010 Sage Division Moyennes & Grandes Entreprises
Important Ne pas utiliser le «rename» de fichiers» N est pas répercuté sur le serveur Suppression d un fichier du projet» Ne supprime pas le fichier sur le serveur Veiller à désactiver «Build Automatically» en version antérieur à la 1.2. Penser au «File Reset object cache», bouton» Accéder à des éléments nouvellement créés 40 2010 Sage Division Moyennes & Grandes Entreprises
Sommaire 1. Présentation d Eclipse 2. Installation et configuration d Eclipse 3. Installation du plugin SAFE X3 Studio 4. Paramétrage d un projet X3 5. Les fonctionnalités 6. Diagnostiquer 41 2010 Sage Division Moyennes & Grandes Entreprises
6. Diagnostiquer Serveur» Pour les dossiers V5 un traitement AXDTMAIN est à intégrer dans le dossier de référence» Ideclient.jar dans.../x3_pub/x3_root/x3cli Eclipse (poste client)» Java 1.6 Client X3 (poste client)» Configuration Menu «Outils Options» Utilisateur X3» Paramètre AECLIPSE à Oui Active les interactions avec Eclipse Chapitre «superviseur» Groupe «DEV» 42 2010 Sage Division Moyennes & Grandes Entreprises
Diagnostiquer - Versions Eclipse» 3.5 SR1 recommandé (Eclipse Platform 3.5.1)» Plugin SAFE X3 Studio version 1.0.2.200911161752 mini En autonome pour accès au serveur» Moteur >= 15r.120 Lancement Eclipse depuis Client X3» Moteur >= 16r.114» CLI.104 mini 43 2010 Sage Division Moyennes & Grandes Entreprises
Diagnostiquer - Versions Exécution d un traitement depuis Eclipse» Moteur >= 16r.115» Superviseur >=16.002» CLI.105 mini 44 2010 Sage Division Moyennes & Grandes Entreprises
Diagnostiquer - Eclipse Mode debug et affichage des logs» eclipse -debug consolelog Menu «Help About», Puis «Installation Details»» Installed Software Version des plugins (features)» Installation History Visualiser et/ou revenir en arrière» Features Liste des «features»» Plug-ins Liste de tous les plugins» Configuration : configuration de démarrage d Eclipse Options de lancement Version de la JVM Plugins... Voir le contenu de «Error Log» 45 2010 Sage Division Moyennes & Grandes Entreprises
Liens utiles Documentation X3, recherchez Eclipse Wiki techno» http://ecintradon2/wiki/index.php/catégorie:xdt» https://www.oursageplace.com/web/our-sage-place/technologies Blog OurSagePlace» https://www.oursageplace.com/web/our-sage-place/safe-x3-studio-foreclipse Wiki OurSagePlace» https://www.oursageplace.com/web/our-sage-place/safe-x3-studio-foreclipse1 Forum OurSagePlace (plutôt international)» https://www.oursageplace.com/web/our-sage-place/forum-sage-erpnegoce/-/message_boards/category/19813 46 2010 Sage Division Moyennes & Grandes Entreprises
Exercice Création d un traitement de comptage des tiers» Enoncé : Créez un traitement qui écrira dans une trace le nombre de tiers de type client, transporteur, fournisseur et pour finir le nombre de tiers total. Ce traitement est à appeler YFUNBPC.» 1 ère partie Ecriture du traitement : Pour la création d un traitement, passez en mode pleine écran. Utilisez au moins un Template. Utilisez l auto complétion. Ne passez pas par X3, aidez-vous des infos-bulles et de l auto-complétion pour rechercher vos données. Exécutez votre traitement depuis Eclipse. 47 2010 Sage Division Moyennes & Grandes Entreprises
Exercice» 2 ème Ajout d une tache : Nous souhaitons ajouter le comptage des commandes passés par les tiers de types clients. La fin de journée approchant, positionnez une tâche à l emplacement ou devra être fait le développement. De ce fait, vous ou un autre développeur, pourrez retrouver la suite à faire rapidement. Visualisez cette tache sur la vue appropriée. 48 2010 Sage Division Moyennes & Grandes Entreprises
Exercice» 3 ème Utilisation des templates: Ajouter un message de confirmation au démarrage de votre traitement. Pour ce faire utilisez le sous-programme OUINON de GESECRAN. Utilisez l auto complétion sur les sous-programmes Après plusieurs utilisation de ce type d entête, vous décidez de faire un Template contenant les lignes de codes suivantes: 49 2010 Sage Division Moyennes & Grandes Entreprises
Exercice 50 2010 Sage Division Moyennes & Grandes Entreprises
Exercice» 3 ème Utilisation des historiques traitements : Vous souhaitez revenir au traitement ne comportant aucun message d avertissement. comment faire, sans réécrire votre traitement? 51 2010 Sage Division Moyennes & Grandes Entreprises
Merci
53 2010 Sage Division Moyennes & Grandes Entreprises