SUPPORT DE COURS TECHNIQUE TOUR DE FRANCE COMMENT LE FAIRE EN. Vous méritez le meilleur DÉVELOPPEZ 10 FOIS PLUS VITE

Transcription

1 TOUR DE FRANCE TECHNIQUE 2005 SUPPORT DE COURS COMMENT LE FAIRE EN Vous méritez le meilleur DÉVELOPPEZ 10 FOIS PLUS VITE Fournisseur Officiel de la Préparation Olympique

2 Avertissement Le document que vous avez entre les mains n a pas la finalité de remplacer les documentations techniques ou commerciales livrées avec WinDev, WebDev, WinDev Mobile. Ce document n est pas un cours d auto-formation, mais uniquement un support papier à la présentation technique que vous allez suivre. (C) PC SOFT 2005 «Reproduction et diffusion interdite sans l autorisation écrite de PC SOFT.» Tour de France Technique PC SOFT - Juin page 1

3 SOMMAIRE 6 Présentation de WinDev 8 Présentation de WinDev Mobile 10 Présentation de WebDev Les Concepts Internet 14 Thème 1 : Gains développeur 14 Ancrages Avancés Gestion avancée des ancrages et conflits d ancrage 15 Table Multi-sélection Gestion de la multi-sélection sur une table fichier 16 Les configurations Gérer les configurations multiples de projets 18 Clés composées Exploitation de la nouvelle syntaxe de construction des clés composées 19 Différences de code Comparer le code d un projet après modification 20 Patchs de mise à jour Mise en place et utilisation des patchs de mise à jour 21 Multi-Langues Comment créer une application en plusieurs langues? 24 Pattern RAD Comment créer un pattern pour générer son code 26 Installation Réseau Mettre en place une installation réseau ou Internet de son application 30 Installation Internet Installation avec téléchargement automatique du framework 31 Installation MSI Comment générer une procédure d installation au format MSI? 32 Thème 2 : Gains utilisateur 32 MCU : les macros Les utilisateurs gèrent leurs macros 33 Les splitters Personnaliser l environnement de l utilisateur sans programmation 34 Persistance des champs Mémoriser le contenu des variables ou des champs 35 Boutons Minuterie Validation automatique des boutons après un délai défini 36 Ajouter une aide Comment ajouter une aide au format CHM dans une application 37 Documentation FAA La documentation utilisateur des FAA Tour de France Technique PC SOFT - Juin page 2

4 38 Thème 3 : Base de données 38 Installation Installer Hyper File Client/Serveur sur Windows 40 Base de données Comment créer une base de données sur le serveur Hyper File Client/Serveur 41 Transfert de données Transférer une base de données Hyper File Classic vers Hyper File Client/Serveur 42 Analyse et code Modifier l analyse et le code pour prendre en compte Hyper File Client/Serveur 43 Applications Installation d une application réseau exploitant Hyper File Client/Serveur 45 Gestion des droits Configurer les droits sur une base de données Hyper File Client/Serveur 46 Installation Linux Installer un serveur Hyper File Client/Serveur sur Linux 47 Accès natifs Accès natifs et bases tierces depuis une application WinDev 48 Optimisation Optimisation des tables fichiers sur une base de données SQL Server 49 Thème 4 : Accès distant 49 Sites distants Partager en temps réel une base de données entre sites distants via ADSL 50 Accès GPRS Accéder à une base distante par GPRS depuis un Pocket PC ou un Smartphone 51 Citrix / TSE Comment exploiter une application WinDev sur serveur Citrix ou TSE? 53 Thème 5 : Réplication 53 Réplication Hyper File Réplication classique et réplication hétérogène sur une base Hyper File 54 Réplication hétérogène Réplication entre une base de données Hyper File et une base de données SQL Server 56 Synchronisation Mobile Synchroniser des bases de données Hyper File Classic et Hyper File Mobile Tour de France Technique PC SOFT - Juin page 3

5 58 Thème 6 : Architecture d application 58 Fenêtre interne Utilisation des fenêtres internes 59 Composants Utilisation des composants et des fenêtres internes 60 Multi-produits Composant Multi-produits et code cible conditionnel 61 Composant métier Mise à jour à chaud, importation, compatibilité Thème 7 : Communication 62 Récupération HTML Récupération automatique d informations sur un site Internet 64 Mailing Réaliser un mailing personnalisé 65 Mailing Fax Réaliser un mailing fax personnalisé 66 Thème 8 : La sécurité 66 WebDev et SSL Traitement sécurisé avec WebDev et SSL 68 Paiement sécurisé Implémenter un paiement par Carte bleue dans un site WebDev 69 Thème 9 : Internet / Intranet 69 Installation Installer un serveur d application WebDev sur Windows 71 Mode AWP AWP? Ca change quoi concrètement? Quand l utiliser? 72 Site PHP Créer un site PHP et le déployer chez un hébergeur 73 Portage d application Porter une application WinDev vers WebDev 74 Installation Linux Installer un serveur d application WebDev sur Linux 76 Thème 10 : La Mobilité 76 Portage d application Porter une application WinDev sur un Pocket PC 77 Déploiement Déploiement d une application Mobile (Internet ou par média de type CD-ROM) 79 Thème 11 : Autres technologies 79.NET : Utilisation Utiliser un traitement.net depuis une application WinDev 80.NET : Publier Publier un traitement.net réalisé depuis un projet WinDev Tour de France Technique PC SOFT - Juin page 4

6 81 Java Créer une application Java depuis un projet WinDev 83 Service Web Créer un Service Web d accès aux données 85 Thème 12 : Les états 85 Etats croisés Réaliser un état croisé 86 Facture et PDF Créer une facture et l envoyer par au format PDF 87 WDEtat Utilisateur Utilisation de WDEtat Utilisateur 88 Thème 13 : Optimisation de l application 88 Performances Utiliser l analyseur de performances et optimiser les requêtes 89 Tailles de pages Optimiser la taille de pages Web 90 Thème 14 : Suivi de projet 90 Suivi de planning Utilisation du centre de suivi de projets 91 Partage d éléments Partage d éléments entre développeurs le Groupware développeur 92 Suivi des incidents Suivi des incidents et des suggestions 93 Tests de non régression Création d un test de non régression 94 Annexe A : Les commandes W-Langage 96 Annexe B : Les touches de raccourci Tour de France Technique PC SOFT - Juin page 5

7 PRÉSENTATION DE WINDEV WinDev est un AGL (Atelier de Génie Logiciel). L éditeur d IHM de WinDev WinDev permet de développer simplement tout type d applications Windows dans les domaines de la gestion, de l industrie, du médical,etc Les applications développées peuvent inclure l accès à des bases de données. WinDev inclut un puissant moteur de base de données : Hyper File. Il est conseillé d utiliser Hyper File pour vos applications afin d obtenir les meilleures performances dans vos traitements de fichiers. Une version Hyper File Client/Serveur est aussi disponible. L environnement de développement intégré de WinDev se compose de différents éditeurs : Un éditeur de projet permettant de visualiser et d agir sur le graphe du projet. Un éditeur d analyses permettant l accès à tout type de base de données (Hyper File, Hyper File Client/Serveur, xbase, AS/400*, Oracle*, SQL Server*, Access**, ODBC, OLE DB ) Un éditeur UML permettant une modélisation objet de vos données et traitements Un éditeur d IHM avec correcteur d interface en temps réel Un éditeur de code évolué (avec assistants, vérification du code saisi, coloration syntaxique, aide contextuelle ) incluant un puissant débogueur. Tour de France Technique PC SOFT - Juin page 6

8 Un éditeur de requêtes pour les sélections dans les fichiers Un éditeur d états Un éditeur d aide permettant de générer des fichiers d aide au format CHM Un éditeur d installation Un éditeur de dossier technique reprenant intégralement toutes les informations techniques de votre projet * accès natif optionnel, ** accès natif inclus Des outils facilitant le développement sont également fournis (WDMAP, WDOUTIL, WDVERSION... ) ainsi que de nombreux exemples et assistants réutilisables. Des centres de contrôle permettent la gestion du cycle de vie de vos applications ainsi que leur administration. Une aide en ligne vous guide tout au long du développement de votre application. Cette aide inclut également une aide à la correction d erreur. Les différents éditeurs seront utilisés, depuis la définition d une analyse jusqu à l installation, en passant par toutes les phases du développement (création des fenêtres, des états, des traitements...), sans oublier les sauvegardes. Le moteur Hyper File sera utilisé pour les fichiers de données exemples de l application. L utilisation d autres moteurs de base de données est également possible sur le même principe. Tour de France Technique PC SOFT - Juin page 7

9 PRÉSENTATION DE WINDEV MOBILE L éditeur d IHM de WinDev Mobile WinDev Mobile permet de développer simplement tout type d applications destinées à être utilisées sur un Pocket PC, un SmartPhone, et la plupart des terminaux mobiles (Symbol, Psion,...) Les applications développées peuvent inclure l accès à des bases de données. WinDev Mobile inclut un puissant moteur de base de données : Hyper File Mobile. Il est conseillé d utiliser Hyper File pour vos applications afin d obtenir les meilleures performances dans vos traitements de fichiers. Une version Hyper File Client/Serveur est aussi disponible. WinDev Mobile permet également d accéder aux bases de données CEDB, bases de données standard des Pockets PC. L environnement de développement intégré de WinDev Mobile se compose de différents éditeurs : Un éditeur de projet permettant de visualiser et d agir sur le graphe du projet. Un éditeur d analyses permettant l accès à tout type de base de données (Hyper File, Hyper File Client/Serveur, Oracle Lite * ) Un éditeur UML permettant une modélisation objet de vos données et traitements Un éditeur d IHM avec correcteur d interface en temps réel Un éditeur de code évolué (avec assistants, vérification du code saisi, coloration syntaxique, aide contextuelle?) incluant un puissant débogueur Un éditeur de requêtes pour les sélections dans les fichiers Un éditeur d états Un éditeur d installation Tour de France Technique PC SOFT - Juin page 8

10 Un éditeur de dossier technique reprenant intégralement toutes les informations techniques de votre projet * accès natif optionnel Des outils facilitant le développement sont également fournis (WDREGISTRE, WDCAPTURE, WDVERSION... ) ainsi que de nombreux exemples et assistants réutilisables. Des centres de contrôle permettent la gestion du cycle de vie de vos applications ainsi que leur administration. Une aide en ligne vous guide tout au long du développement de votre application. Cette aide inclut également une aide à la correction d erreur. Le moteur Hyper File Mobile sera utilisé pour les fichiers de données exemples de l application. L utilisation d autres moteurs de base de données est également possible sur le même principe. Tour de France Technique PC SOFT - Juin page 9

11 PRÉSENTATION DE WEBDEV L éditeur de pages de WebDev WebDev est un AGL (Atelier de Génie Logiciel) orienté développement de sites Intranet et Internet. WebDev permet de développer tout type de sites dynamiques incluant l accès à des bases de données. Il permet aussi de développer des sites semi-dynamiques et statiques. Il est composé de différents éditeurs : Un éditeur de projet permettant de visualiser et d agir sur le graphe du projet. Un éditeur de pages. Un éditeur d analyses permettant l accès à tout type de base de données (Hyper File, Hyper File Client/Serveur, xbase, AS/400*, Oracle*, SQL Server*, Access**, OLE DB, etc.). Un éditeur de code évolué (avec assistants, vérification du code saisi, coloration syntaxique, aide contextuelle ) incluant un puissant débogueur. Un éditeur de styles incluant police, couleur, position, etc. Un éditeur de requêtes pour les sélections dans les fichiers. Un éditeur d états. Un éditeur de dossier technique reprenant intégralement toutes les informations techniques de votre projet. Un éditeur d installation. * accès natif optionnel, ** accès natif inclus L éditeur d installation assure la mise en place des sites créés, ainsi que leur maintenance. Cet outil permet de réaliser une installation sur le serveur via FTP ou par média physique (CD, Zip, etc.). Tour de France Technique PC SOFT - Juin page 10

12 Des outils facilitant le développement sont également fournis (WDMAP, WDOUTIL, WDSQL, etc.) ainsi que de nombreux exemples et assistants réutilisables. Les principaux éditeurs sont utilisés, depuis la définition d une analyse jusqu à l installation, en passant par toutes les phases du développement (création de pages, traitements, états, etc.), sans oublier les sauvegardes. Les Concepts Internet Les différents services de l Internet Internet est un réseau mondial d ordinateurs pouvant dialoguer entre eux. Ces ordinateurs peuvent être de types différents (micros, minis, ) et fonctionner sur des systèmes d exploitation différents (Windows, Linux, MacOS, Unix, ) Tous ces ordinateurs sont reliés par le biais du protocole TCP/IP. WWW (World Wide Web) ou toile d araignée mondiale a été créé en Il peut véhiculer des pages pouvant contenir du texte, des images, du son, de la vidéo. Un regroupement de pages constitue un site. Le terme Internet regroupe plusieurs services d utilisation différente : FTP (File Transfer Protocol) est un service permettant de transférer des fichiers d un ordinateur vers un autre à travers Internet. SMTP (Simple Mail Transfer Protocol) permet d envoyer des messages ou mails à un utilisateur défini. Chaque utilisateur doit disposer d une adresse qui lui sert de boîte aux lettres. HTTP (Hypertext Transfer Protocol). HTTP est un protocole de niveau application qui est utilisé pour le transfert de pages sur Internet. Chacun de ces services nécessite un gestionnaire de services installé sur un serveur : Le gestionnaire de services FTP gère l hébergement des fichiers, les droits d utilisation des fichiers et la réponse aux demandes en provenance des autres postes. Le gestionnaire de services SMTP prend en charge les demandes d envoi de messages et le routage vers les serveurs POP (réception des messages) concernés. Le gestionnaire Web (www) permet l hébergement des pages et répond aux demandes de consultation de la part des postes client. Le Web en détail Les pages Web sont visualisées sur un poste par l intermédiaire d un navigateur Web (Internet Explorer, Netscape, Opera, etc.). Le navigateur interprète le contenu des fichiers au format HTML décrivant les pages. On parle de pages HTML. WebDev génère automatiquement le code HTML et Javascript HTML (HyperText Markup Language) est un langage de description de pages. Toute la mise en page est décrite par l intermédiaire de balises. Tour de France Technique PC SOFT - Juin page 11

13 Exemple de code HTML : <B>Bonjour!</B> indique que Bonjour! va apparaître en gras. Une page peut aussi être composée de scripts en langage Javascript. Javascript est utilisé pour réaliser des traitements dynamiques au niveau du navigateur, par exemple contrôler la saisie par l utilisateur d une valeur dans une page. Il est possible d afficher directement une page dans un navigateur en tapant son URL dans la zone adresse du navigateur. L URL (Uniform Resource Locator) correspond au chemin d accès de la page sur le serveur qui l héberge. Exemple d URL : Une URL peut aussi être composée simplement du nom du domaine. Dans ce cas, c est la page du sommaire du serveur qui s affichera. Exemple : Si l URL ne correspond pas à une adresse valide, une erreur de connexion est retournée dans l écran du navigateur. Si l URL est valide, la page demandée s affiche dans le navigateur. L utilisateur peut alors déclencher une action en cliquant sur un lien ou un bouton. La requête correspondante est alors envoyée au serveur qui l analyse. Le lien permet de lancer le chargement d une autre page ou bien de lancer une application Web. Site statique, semi-dynamique ou dynamique? Le site statique est composé de pages conçues à l avance de manière définitive. Dans ce cas, le contenu des pages n évoluera pas dynamiquement en fonction d un choix de l utilisateur. Le site semi-dynamique est un site statique composé de pages conçues à l avance mais enrichies par une base de données. Dans ce cas, le contenu des pages n évoluera pas dynamiquement en fonction d un choix de l utilisateur. L un des meilleurs exemples est un catalogue de pièces détachées. Le site dynamique est constitué de pages enrichies de données provenant d une base de données. Il est nécessaire d exécuter des traitements d accès aux données sur le serveur permettant de constituer la page. WebDev permet de développer des sites dynamiques composés de pages, de traitements serveur (accès aux bases de données, calculs, etc.) et de traitements exécutés par le navigateur (contrôles, traitements répétitifs, etc.). WebDev permet aussi de développer des sites statiques et semidynamiques. Fonctionnement d une application WebDev Une application WebDev hébergée sur un serveur peut être exécutée en appelant une URL particulière depuis un navigateur. Exemple : monappli Le lanceur de WebDev wd90awp.exe permet d exécuter l application sur le serveur grâce au serveur d application wd90session.exe. Le serveur d application construit dynamiquement la première page Tour de France Technique PC SOFT - Juin page 12

14 de l application et l envoie au navigateur par l intermédiaire du serveur Web. Le schéma ci-dessous illustre le fonctionnement d une application WebDev. Principe de programmation WebDev Le débit entre le serveur Internet et le poste client est plus lent qu avec un réseau local classique. Les échanges de données entre le poste client et le serveur doivent donc être réduits pour que l application puisse s exécuter sans ralentissement. WebDev permet de différencier les traitements exécutés sur le serveur et les traitements exécutés sur le poste client. 1. Les traitements sur le serveur Les traitements exécutés sur le serveur sont les traitements principaux de l application. Ils concernent la gestion de la base de données (Hyper File et Hyper File Client/Serveur, xbase, AS/400, Oracle, SQL Server, Access, OLE DB, etc.), les traitements de calcul. Ces traitements sont écrits en W-Langage. 2. Les traitements sur le poste client Les traitements exécutés sur le poste client sont les traitements de contrôle de saisie, de vérification qui ne nécessitent pas d accéder au serveur. Ces traitements utilisent uniquement les informations contenues dans la page. Ces traitements peuvent être écrits en Javascript ou W-Langage. Dans ce dernier cas, WebDev se charge de convertir automatiquement le code W-Langage en Javascript pour qu il puisse être exécuté par le navigateur. 3. Administrateur WebDev L administrateur WebDev est un exécutable installé sur le serveur. L administrateur permet de configurer le nombre de connexions autorisées en même temps pour le serveur, par site, par utilisateur. Il permet aussi de fixer le temps maximum d exécution d une requête et le temps limite pour la déconnexion des utilisateurs inactifs. L administrateur peut à tout moment afficher la liste des utilisateurs connectés au site. Tour de France Technique PC SOFT - Juin page 13

15 Thème 1 : Gains développeur ANCRAGES AVANCÉS Gestion avancée des ancrages et conflits d ancrage WinDev, vous le savez sans doute déjà propose la notion d ancrage sur les fenêtres. L ancrage permet de définir le positionnement des champs lors d un changement de taille de la fenêtre. Cet exemple utilise le projet GainsDeveloppeur et la fenêtre Fenêtre Ancrage. Ce projet est accessible depuis le kouglof. Ancrage proportionnel en largeur Lorsque l utilisateur va agrandir la fenêtre, les champs nom et prénom doivent s agrandirent sans se chevaucher. Il n y a aucune raison que le nom s agrandisse plus que le prénom ou inversement, il faut donc répartir l agrandissement. Il suffit de sélectionner les deux champs et de choisir un ancrage proportionnel vers la droite. Testez : Go! Les 2 champs s agrandissent bien proportionnellement lors du redimensionnement de la fenêtre. Ancrage proportionnel en hauteur Maintenant, le champ adresse doit s agrandir en largeur et en hauteur. En largeur pas de problème, car les boutons sont ancrés à droite. Ils vont suivre le bord de la fenêtre lors de son agrandissement et laisser ainsi de la place au champ adresse pour s agrandir. Pour la hauteur, il est possible de choisir un pourcentage d agrandissement 50% par exemple. WinDev détecte un conflit d ancrage : les champs apparaissent en rouge. Normal : il faut ancrer les champs en-dessous du champ adresse pour éviter la superposition lors de l agrandissement. Il suffit de décaler donc vers le bas de 50%, le champ adresse s agrandissant potentiellement de 50 % seulement. Testez : GO! En bas, c est dommage de perdre cette place. Pourquoi ne pas agrandir le champ observation? Il suffit de définir pour le champ Observation, un ancrage largeur et hauteur avec une hauteur à 50 %. Si vous voulez tester l IHM de la fenêtre sans exécuter les traitements, cliquez sur l icône de l œil, ou sélectionnez le menu Affichage Afficher la fenêtre ou Shift + F9. De la même façon, les champs adresse et Observations augmenteront de façon proportionnelle. Les champs Code Postal, ville, téléphone,... devront se déplacer vers le bas du fait que le champ adresse peut augmenter de 50% : il faut modifier l ancrage en hauteur à 100%. Tour de France Technique PC SOFT - Juin page 14

16 TABLE MULTI-SÉLECTION Gestion de la multi-sélection sur une table fichier La gestion de la multi-sélection a été étendue aux tables fichier depuis WinDev 9. C est très simple à gérer. Cet exemple utilise la fenêtre fenmultisélection du projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Cette fenêtre contient une table fichier basée sur les Clients Pour permettre à l utilisateur d imprimer les fiches Clients à partir d une sélection qu il aura faite, les étapes sont les suivantes : Indiquer que la table fichier autorise la multi-sélection (cocher l option sélection multiple dans la fenêtre de description du champ table). Il y a alors deux possibilités: Soit un traitement manuel de la multi-sélection. Ce traitement se fait exactement comme pour la gestion des listes en parcourant les différents éléments sélectionnés. Soit un traitement automatique de la multi-sélection en modifiant la description de l état qui imprime les fiches. C est ce second cas qui est utilisé dans l état Etat_ MultiSelection. Indiquer dans la description de l état que l état imprime, non plus, toutes les lignes de la table mais seulement les lignes sélectionnées. Il suffit de tester le programme pour voir le fonctionnement : Go, faire une sélection multiple et imprimer. Pour sélectionner plusieurs fiches, les touches standard de sélection sont utilisées à savoir le CTRL pour sélectionner ou désélectionner une ligne supplémentaire ou le SHIFT pour une sélection de lignes contiguës. Lancement de l impression : seules les fiches des Clients sélectionnés sont imprimées. Tour de France Technique PC SOFT - Juin page 15

17 LES CONFIGURATIONS Gérer les configurations multiples de projets La configuration de projet c est quoi? C est la possibilité de créer des applications distinctes, des exécutables, des composants, des assemblages.net, etc à partir d un projet unique. Cet exemple utilise la fenêtre FenGestionParc du projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Les configurations de projet vont être utilisées pour réaliser une version adaptée d un projet (sans modifier le projet normal ). Création d une configuration Pour créer une nouvelle configuration, il suffit d utiliser l option Nouveau du menu Projet Gestion des configurations. Les informations nécessaires sont les suivantes : Le nom de la nouvelle configuration, Montpellier. Le type de génération : un exécutable. Le nom de l exécutable. La nouvelle configuration apparaît dans la liste des configurations. Cette liste est rappelée dans le volet WinDev. Association à une configuration Une fois la nouvelle configuration créée, il est possible de partager différents objets (fenêtres, états, requêtes, etc...) entre les 2 configurations (celle créée et celle correspondante au projet principal) ou avoir d autres objets spécifiques à une configuration. Pour l exemple, nous allons définir une première fenêtre spécifique à chaque configuration. Pour la rendre spécifique, il suffit de changer le libellé de la fenêtre et de le remplacer, par exemple, par MONTPELLIER. Enregistrez la fenêtre FenGestionParc par exemple sous le nom FenGestionParc_MONTPELLIER.wdw et définissez cette fenêtre comme 1ère fenêtre du projet. Nous avons maintenant 2 fenêtres qui sont adaptées à chacune des 2 configurations. Il nous reste à retirer de la configuration MONTPELLIER, la fenêtre initiale principale (clic droit sur la fenêtre FenGestionParc et sélectionnez exclure de la configuration courante ). A tout moment, il est possible de travailler sur une configuration spécifique : les éléments n appartenant pas à cette configuration apparaissent grisés sous l éditeur de projet. Tour de France Technique PC SOFT - Juin page 16

18 Bien entendu, lors de la génération de la configuration (un exécutable, une bibliothèque, etc ) seuls les éléments appartenant à cette configuration sont intégrés dans la cible. Création de l exécutable Cliquez sur le bouton créer l exécutable, dans la liste des éléments de la bibliothèque, seuls les éléments de la configuration courante sont intégrés. Le raccourci Alt+F8 ou le menu Atelier Génération multiple vous permet de générer plusieurs configurations en même temps. Tour de France Technique PC SOFT - Juin page 17

19 CLÉS COMPOSÉES Exploitation de la nouvelle syntaxe de construction des clés composées Une nouvelle syntaxe est disponible en version 9 pour utiliser les clés composées. Cet exemple utilise le projet GainsDeveloppeur et la fenêtre ClesComposees. Ce projet est accessible depuis le kouglof. Sans cette nouvelle syntaxe, un code de recherche avec une clé composée est de la forme : svalrech est une chaîne svalrech = HConstruitValClé (Client,... CléCodePostalSocieté,... RechercheCodePostal, RechercheSociete) HLitRecherche(Client,CléCodePostalSocieté,... svalrech) TableAffiche(Table_Client,taCourantPremier) Maintenant, il suffit d indiquer les valeurs de la clé entre crochets directement. Il n y a plus besoin d utiliser HConstruitValClé. HLitRecherche(Client,CléCodePostalSocieté,... [RechercheCodePostal,RechercheSociete]) TableAffiche(Table_Client,taCourantPremier) Cette nouvelle syntaxe simplifie l écriture du code, mais aussi sa compréhension et donc sa maintenance. Tour de France Technique PC SOFT - Juin page 18

20 DIFFÉRENCES DE CODE Comparer le code d un projet après modification Très souvent, vous avez besoin de connaître dans vos projets les différences entre votre sauvegarde de la semaine et votre version actuelle afin de comprendre par exemple un comportement différent. Une fenêtre fonctionnait très bien et elle ne fonctionne plus maintenant. Cet exemple utilise le projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Recherche des différences sur la classe cpayboxdirect Allez sur le code de la classe cpayboxdirect. Choisissez le choix Comparer l élément en cours dans le menu fichier. Sélectionnez la classe cpayboxdirect-old dans le répertoire \ Ancienne Classe, puis cliquez sur le bouton Terminer. Sélectionnez la classe à comparer avec la classe actuelle. Le comparateur de WinDev présente les différentes méthodes qui ont été modifiées. Vous pouvez par exemple voir que la méthode smsgerreurappel n existait pas dans l ancienne version. Visualisation des différences Pour visualiser les différences de la méthode Credite, doublecliquez sur la méthode Credite. A gauche, s affiche la version actuelle, à droite l ancienne version. En rose, c est le code modifié, En bleu, le code supprimé dans la classe actuelle, En vert, le code ajouté. C est la même chose pour tous les éléments : les requêtes, les fenêtres, les états,... Tour de France Technique PC SOFT - Juin page 19

21 PATCHS DE MISE À JOUR Mise en place et utilisation des patchs de mise à jour Un patch pourquoi et quand? Le patch répond à un besoin précis : modification limitée, diffusion urgente. Cet exemple utilise la fenêtre Ancrage du projet WD Patch. Ce projet est accessible depuis le kouglof. Supposons, par exemple, que dans cette fenêtre le développeur ait oublié d inclure le champ de saisie . La rubrique a bien été prévue au niveau de l analyse mais oubliée dans l IHM. Pour ajouter le champ, il suffit de faire un simple Drag and Drop depuis l analyse (fichier Client ) vers la fenêtre. Pensez à remplir les informations RAD dans l analyse. Cela sera très utile dans vos développements notamment dans le cas présent. Pour propager cette évolution sans passer par la création d une procédure d installation, il suffit de créer un patch. Cette fonctionnalité est accessible depuis l option Créer un patch de la bibliothèque du menu Atelier..Bibliothèque. Les étapes de la création du patch sont les suivantes : Indiquer les éléments à intégrer dans le patch. Ici la fenêtre modifiée : la fenêtre ancrage. Ajouter un libellé explicatif du patch. Cliquer sur l option Générer une installation. Cliquer sur Terminer. Un répertoire Patch est créé dans le répertoire du projet. Ce répertoire contient un fichier auto extractible d installation à exécuter sur le poste client : il suffit alors d envoyer ce fichier auto extractible à votre client. Ce fichier patch (de la forme fichier.wdl.001) sera simplement installé à coté de l exécutable de l application en clientèle. Lors du prochain lancement de l application par l utilisateur, le patch sera pris en compte et l application intégrera les modifications définies dans le patch. Tour de France Technique PC SOFT - Juin page 20

22 MULTI-LANGUES Comment créer une application en plusieurs langues? WinDev prend en compte jusqu à 20 langues différentes par application et ceci à toutes les étapes du développement d une application. Cet exemple utilise la fenêtre FenMultilangue du projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Paramétrage du projet Voici les différentes étapes pour rendre un projet multi-langues : 1- Tout d abord définir dans la description du projet les langues (20 langues maxi par projet) qui seront utilisées par le projet (français, anglais, allemand, espagnol, italien, portugais, russe, chinois, etc.). Dans cet exemple, nous ajoutons la gestion de l anglais à notre projet qui sera donc français et anglais. 2- Ensuite, il sera nécessaire de convertir les chaînes de caractères en ressources multi-langues. Conversion des chaînes en ressources multi-langues En effet, un message affiché par un ordre Info est une ressource multi-langues, par exemple le message confirmez-vous la modification, etc sera à traduire. Par contre un nom de fichier ne devra pas être traduit! Pour réaliser cette conversion, utilisez l option convertir les chaînes simples en messages multi-langues du menu Code.. Message multi-langues. WinDev parcourt automatiquement tout le code source et pour chaque chaîne propose de la convertir ou non en ressource multilangues. Remarquez le petit drapeau qui apparaît juste derrière la chaîne pour spécifier qu il s agit maintenant d une ressource multi-langues et donc qu elle pourra être traduite. Arrêtons-nous sur cette chaîne : Le client +TXT_NOM+ a bien été +soperation Nous avons ici le cas typique d erreur due à la construction syntaxique liée au multi-langues : la chaîne est construite dynamiquement par programmation en intégrant une variable. Mais la construction syntaxique en français est différente de l anglais. Le client + variable + a bien été +variable ne se traduit pas par Tour de France Technique PC SOFT - Juin page 21

23 The customer +variable+ a bien été +variable, mais plutôt par The customer + variable + has been + variable + successfully. Dans ce cas comment faire? Tout simplement, utiliser l ordre du W-langage ChaîneConstruit avec le paramètre optionnel pour-cent %. La chaîne pourra ainsi être traduite en toute sécurité. Traduction des ressources multi-langues Une ressource multi-langues peut être un message mais également le titre d une fenêtre, le Libellé d un champ, le message d aide d un champ, la bulle d aide d un champ, le contenu d un champ (liste, combo, interrupteur et sélecteur) etc. Vous pouvez traduire les ressources une à une sous l éditeur, soit directement à la main, soit à l aide d un outil de traduction de type Systran (bouton traduire ). Cette solution est difficilement envisageable sur un projet conséquent L autre solution est d utiliser WDMSG. WDMSG est un module optionnel qui va industrialiser cette phase de traduction. Tout d abord, WDMSG va automatiquement extraire du projet toutes les ressources multi-langues et générer un fichier texte en utilisant l option extraction des messages du menu outils WDMSG. Vous pouvez alors soit directement traduire dans ce fichier texte, soit utiliser WDTRAD. Utilisation de WDTrad WDTRAD va permettre de mettre en forme ce fichier texte pour en faciliter la traduction, mais surtout, WDTrad va vous seconder dans la traduction. Le grand plus de WDTRAD est de gérer un dictionnaire de traduction que vous allez pouvoir enrichir au fur et à mesure. Par défaut le dictionnaire est alimenté par plus de traductions (les plus courantes). Pour utiliser ce dictionnaire et faire une première passe de traduction automatique sur notre fichier texte, il suffit d utiliser le bouton AutoTrad. WDTRAD va donc pour chaque ressource, regarder si une correspondance exacte et une traduction sont disponibles dans le dictionnaire. Si oui, la traduction est automatiquement affichée. Ensuite pour les ressources non trouvées dans le dictionnaire, il suffira de les saisir dans la colonne de droite, et alimenter ainsi automatiquement le dictionnaire. Vous pouvez très bien avoir plusieurs dictionnaires dans différentes langues. Il ne reste maintenant plus qu à réimporter dans le projet le fichier texte traduit vers la langue anglaise grâce à l option Réintégration des messages du menu Outils WDMSG Tour de France Technique PC SOFT - Juin page 22

24 Changement de langue par programmation Créez deux boutons : un avec français un avec english puis éditez le code du bouton. Pour passer l application dans la langue anglaise, le code à utiliser est simplement la fonction Nation du W-Langage avec le n de la langue. Pour l anglais c est 3. Et ensuite, la fonction Utilise permet de réafficher la fenêtre : Nation(3) Utilise(Nom de la fenêtre) Et pour repasser en français, il suffit d utiliser la fonction Nation avec le code 5. Nation(5) Utilise(Nom de la fenêtre) Go du projet! L application est en français Lors d un clic sur le bouton english, l application passe en anglais. Cliquez sur le bouton english puis français pour tester. Tour de France Technique PC SOFT - Juin page 23

25 PATTERN RAD Comment créer un pattern pour générer son code Nous allons maintenant voir comment on peut créer un pattern pour générer son code à soi. WinDev propose des modèles RAD que l on peut modifier. Dans cet exemple, nous allons ajouter un bouton dans un modèle fiche qui permettra de bloquer l enregistrement en cours du fichier. Cet exemple le projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Voici comment procéder pour modifier un pattern existant. Ouvrir le projet GainsDeveloppeur. Sélectionner l option de menu Atelier..Modèle RAD personnalisé (Pattern)..Ouvrir un modèle RAD... Dans le sélecteur de fichiers qui s ouvre, sélectionner le chemin..\<répertoire d installation de WinDev 9>\Programmes\Donnees\ Modeles\RAD\WD. Choisir le modèle fiche.mdl : celui-ci s affiche. Enregistrer sous pour mettre dans le répertoire Personnel du produit. Le mode Mode édition des zones permet de définir l aspect visuel de la fenêtre (IHM). Une fois dans ce mode d édition de zone, il est possible d agrandir la zone contenant les boutons pour ajouter un nouveau bouton. Sélectionnez la zone de boutons Bouton_Fiche_Parcours pour l agrandir vers le bas. Créez un nouveau bouton. Menu Affichage, option mode gabarit (pour décocher l option mode gabarit ). Modifiez le nom du bouton (BTN_BLOQUE) et son libellé (Bloque). Tapez le code suivant dans le bouton : %ifdef PROC %ifdef FICHIER H B l o q u e N u m E n r ( { R A D _ F I C H I E R _ A},hNumEnrEnCours, hblocagelectureecriture) %endif %endif Reportez-vous à la documentation pour la signification des mots-clés du RAD (%ifdef PROC, etc...) Tour de France Technique PC SOFT - Juin page 24

26 Le code est réalisé, il suffit d enregistrer le modèle RAD modifié pour pouvoir le tester. Créez une nouvelle fenêtre grâce à l option Fichier Nouvelle fenêtre Onglet RAD. Sélectionnez le modèle qui vient d être créé : fiche avec parcours (il est possible de changer ce nom dans la fenêtre de description du pattern). Le modèle personnalisé dispose d un icone spécifique pour le distinguer des modèles classiques. Validez. Sélectionnez le mode de programmation Programmation Procédurale. Choisissez le fichier Client. Laissez toutes les options par défaut et terminez l assistant. Le bouton ajouté est disponible dans la fenêtre ainsi que le code généré. Tour de France Technique PC SOFT - Juin page 25

27 INSTALLATION RÉSEAU Mettre en place une installation réseau ou Internet de son application Une fois le développement terminé, il reste à installer l application sur les différents postes qui vont l utiliser. Ensuite, lorsque l application va évoluer, il faudra mettre à jour les postes pour qu ils bénéficient de la dernière version. Ces 2 phases sont gérées par l éditeur d installation réseau de WINDEV 9. Nous allons voir comment créer une installation avec mise à jour automatique. Cet exemple le projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Déroulement de la création de la procédure d installation Ouvrir le projet GainsDeveloppeur. Lancer la procédure d installation par l icone CD. Accepter la création de l exécutable. Plan 1 : Choix du modèle d installation : cocher le choix 2 d installation par mise à jour réseau. Plan 2 : Choisir la langue. Nous allons commencer par créer une installation classique. Rappel : vous pouvez créer des installations gérant jusqu à 20 langues. Le moteur d installation (WDSetup) est livré en standard en français et en anglais avec son code source pour une éventuelle traduction. Dans cette phase, il suffit de décrire l installation en répondant tout simplement aux questions posées par l assistant. Plan 3 : Choix du décor de l installation. Le décor de l assistant est bien entendu complètement paramétrable pour le mettre aux couleurs de votre application ou de votre entreprise. Il vous suffit d indiquer ici les différents éléments graphiques qui seront utilisés pour l installation. Plan 4 : Choix des fichiers installés. Ce plan permet de définir les fichiers qui sont concernés par l installation. Bien entendu WINDEV sélectionne automatiquement tous les fichiers nécessaires au fonctionnement de l application. Ce que nous allons préciser ce sont les fichiers que l on souhaite ajouter. Par exemple nous allons ajouter les fichiers contenant un jeu de données par défaut. A noter que les fichiers qui apparaissent en vert sont les nouveaux fichiers depuis la dernière génération d installation. Plan 5 : Choisir un répertoire d installation par défaut Plan 6 : Modules additionnels : cocher la licence et le désinstal- Tour de France Technique PC SOFT - Juin page 26

28 lateur. Ce plan permet d indiquer à l installateur s il doit exécuter automatiquement la modification des fichiers de données (si les fichiers installés chez le Client ne sont plus en phase avec l analyse du projet). De même, il est possible de paramétrer l affichage ou non d un fichier de licence et l installation ou non de l outil de désinstallation d application standard de WinDev. Plan 6 : Licence : Sélectionner le fichier Licence.rtf du répertoire du projet à l aide du bouton Parcourir. Plan 7 : Contrôle des versions. Jusqu à maintenant nous avons vu les paramètres qui concernent l installation. Ce plan est spécifique à la mise à jour de l application. C est ici qu il faut indiquer ce qui doit être fait en cas de présence d un ancienne version de l application en utilisant la notion de version minimale. Deux cas peuvent alors se présenter : soit cette nouvelle version peut coexister avec d anciennes versions de l application et la mise à jour des postes utilisateurs sera optionnelle. Dans ce cas, le numéro de version minimale ne doit pas être modifié. soit les utilisateurs doivent se mettre obligatoirement à jour de cette dernière version. Le numéro de version minimale doit être modifié en indiquant le numéro de version de cette dernière version. Configuration de la mise à jour automatique Le bouton avancé permet d indiquer comment est géré le système de mise à jour (un répertoire partagé dans lequel est stocké une version étalon de l application). dans le cas d une utilisation locale ce sera un répertoire partagé du réseau dans le cas d un déploiement sur des postes distants via un accès HTTP ce sera une URL. Premier onglet : Définit la fréquence de contrôle de version par l application installée sur le poste utilisateur. L application vérifiera qu elle est bien en dernière version par rapport à la dernière installation réseau. Sinon elle vérifiera si la mise à jour est optionnelle ou obligatoire. Il est également possible de préciser les messages à afficher en cas d intervention sur l application (mise à jour en cours, arrêt annoncé, arrêt forcé et reprise d installation en cas d échec). Deuxième onglet : permet de forcer le lancement automatique de la mise à jour au lancement de l exécutable dans un délai défini. Troisième onglet : permet d ajouter des informations dans un historique qui sera proposé à l utilisateur. Ceci est optionnel mais il est conseillé de le remplir régulièrement Quatrième onglet : Une application réseau peut également être référencée dans le Centres de Contrôle. C est ici qu il faudrait le préciser, mais ce n est pas l objet ici, les Centres de contrôles seront vu ultérieurement. Fermeture de l assistant : Tous les paramètres spécifiés sont bien entendu conservés et pourront être modifiés ultérieurement grâce à l interface du contrôle à distance de l application. Ce centre de contrôle des applications réseau, le programme WDAdminExe sera Tour de France Technique PC SOFT - Juin page 27

29 installé dans le répertoire de l application de référence. Cliquez sur Suivant : C est ici que l on choisit d installer l application de référence sur un réseau local ou de la diffuser sur Internet. On choisit ici de placer l application de référence dans un répertoire partagé (fonctionnement en réseau local). Cochez le choix 1 et cliquez sur le bouton Suivant : Par défaut, le centre de contrôle de l application permet de gérer automatiquement la liste des utilisateurs connectés. Laissez OUI et cliquez sur le bouton Suivant : Au niveau de l installation, indiquez à quel endroit, sur quel support la créer, par défaut dans un sous-répertoire du projet. Cliquez sur Suivant puis Terminer. A ce stade, la préparation de l installation est terminée, laissez WINDEV générer l installation. Test de la procédure d installation WINDEV permet de lancer la procédure d installation qui vient d être créée. Cela permet de déployer la nouvelle version de l application directement pour les utilisateurs qui sont connectés sur le même réseau. Pour tester la procédure d installation, il suffit de : Cliquer sur OUI, WDSetup se lance. La proposition de sauvegarde de projet se lance : chaque fois que l on crée un exécutable ou une installation d une application, l éditeur vous propose de réaliser une sauvegarde du projet correspondant à cette version. Choisir la langue d installation. Choisir une interface en Français. Paramétrer le répertoire réseau. Pour déployer l application de référence, il reste à choisir un répertoire partagé du réseau : Choisir un répertoire d une machine du réseau grâce au bouton parcourir puis cliquer sur suivant. Cliquer sur Suivant sans cocher. L installateur affiche un résumé des paramètres de l installation. Cliquer sur Suivant : Ce plan informe de l impact de cette installation pour les utilisateurs de l application. Ici il s agit d une première installation, donc rien ne s oppose au lancement de l installation. Cliquer sur Suivant puis Terminer. Voilà, l installation de référence est prête. Les nouveaux utilisateurs de l application installeront l application sur leur poste en utilisant le programme install.exe. Par la suite, ils n auront plus rien à faire. En cas de mise à jour, c est l application elle-même qui s auto-vérifiera et proposera ou imposera l installation de la mise à jour. Tour de France Technique PC SOFT - Juin page 28

30 Installation HTTP Nous venons de voir le déploiement pour des utilisateurs qui sont sur un même site. Comment cela se passe si les utilisateurs sont sur des sites distants? Et bien c est la même chose! La création d une installation avec mise à jour http se déroule de la même façon. La différence réside dans la façon de la déployer. Pour déployer une application chez un hébergeur, il suffit d indiquer l URL de connexion au site Internet, les paramètres de connexion FTP pour pouvoir y poser mon installation de référence. A l issue de l installation, il est possible de tester l URL. C est cette URL qu il suffit de communiquer aux utilisateurs. Pour l installation, cette page de téléchargement s affiche, il suffit de cliquer sur le lien Install.exe pour télécharger puis installer l application. Le mécanisme de mise à jour est le même que précédemment. Le lancement de l application détecte les mises à jour et les lance. Voilà nous savons maintenant créer et mettre à jour très simplement nos applications même sur des sites distants. Tour de France Technique PC SOFT - Juin page 29

31 INSTALLATION INTERNET Installation avec téléchargement automatique du framework Dans certains cas, il peut être intéressant de créer une procédure d installation très légère, par exemple pour en accélérer le téléchargement par Internet ou pour en minimiser la taille (à cause du choix du support physique). Une des solutions est l utilisation d une installation avec téléchargement automatique du framework. Cet exemple utilise la fenêtre Ancrage du projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Création de la procédure d installation Pour démarrer l assistant de création de procédure d installation, cliquez sur l option Créer la procédure d installation du menu Atelier. La procédure d installation permet de créer l exécutable : Demandez la création de l exécutable. Indiquez que l exécutable utilise le framework commun. Cliquez sur Terminer. La procédure de création d installation se poursuit automatiquement. Pour une application diffusée sur Internet, il faut que l installateur soit le plus compact possible. Pour réaliser ce type d installation avec WinDev il suffit de : Choisir Créer une installation autonome. Choisir ensuite Installation compacte. Limiter au maximum l ajout de modules additionnels. Choisir comme support un exécutable auto extractible. L installation ainsi définie sera la plus compacte possible. Si l utilisateur installe l application sur une machine qui n est pas encore équipée du framework, le framework sera téléchargé automatiquement depuis le site PC SOFT. Tour de France Technique PC SOFT - Juin page 30

32 INSTALLATION MSI Comment générer une procédure d installation au format MSI? WinDev permet de créer des installations au format MSI de façon aussi simple qu une installation classique. Cet exemple le projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Création de la procédure d installation Pour créer une installation au format MSI, il suffit de : Ouvrir le projet GainsDeveloppeur. Lancer la procédure d installation par l icône CD. Valider la demande de création d exécutable. Plan 1 : Passer le plan Choix du modèle d installation en gardant le premier choix. Plan 2 : Sélectionner Installation par un package MSI (3ème choix). Plan 3 : Valider la liste fichiers nécessaires à l application (la liste des fichiers est détectée automatiquement par l installation). Les fichiers en vert sont nouveaux depuis la dernière génération d installation. Plan 4 : Choisir un répertoire d installation par défaut. Plan 5 : Modules additionnels : Cocher la licence. Plan 6 : Licence : Sélectionner le fichier Licence.rtf du répertoire du projet à l aide du bouton Parcourir. Cliquer sur Terminer A la fin de la génération, cliquer sur «Explorer» pour visualiser le fichier.msi. Déroulement de l installation Lancer le fichier.msi. Valider l assistant et choisir Installation complète. Terminer l installation : l application est installée. Principales limitations du format MSI Par rapport à l installeur WinDev, une installation MSI dispose de certaines limitations. Ainsi, une installation au format MSI : ne permet pas de mettre en oeuvre le mécanisme de mises à jour automatiques. ne permet pas la modification automatique des fichiers Hyper File. ne contient pas les options : ajout d outils redistribuables, installation du driver ODBC et du MDAC, paramétrage des répertoires des fichiers de données Tour de France Technique PC SOFT - Juin page 31

33 Thème 2 : Gains utilisateur MCU : LES MACROS Les utilisateurs gèrent leurs macros Le MCU (Macro Code Utilisateur) permet à l utilisateur final de créer ses propres traitements complémentaires dans l application. Et ceci indépendamment du développeur. Cet exemple utilise le projet GainsDeveloppeur. Ce projet est accessible depuis le kouglof. Ajout d un raccourci Sur la fenêtre FenMultiselection, le développeur n a pas placé de raccourcis clavier sur les boutons et notamment sur le bouton Imprimer. Regardons comment l utilisateur final peut ajouter un raccourci CTRL + P sur ce bouton. Lancez un test de la fenêtre FenMultiselection. Cliquez sur le bouton du MCU. Ajoutez un MCU de type Une action sur une combinaison de touches.. Choisissez de détecter la touche. Détectez la touche CTRL+P. Etudions maintenant le code pour appeler le bouton Imprimer. La fonction permettant de simuler un code de clic est ExécuteTraitement avec en paramètre le nom du bouton. Dans la liste des champs, on voit que le bouton s appelle Imprimer. ExecuteTraitement( Imprimer,trtclic) Voilà c est terminé, l utilisateur final a ajouté son propre raccourci clavier à l application. Pour tester, il suffit d appuyer sur CTRL+P. La combinaison de touches CTRL+P appelle le traitement d impression. Vous pouvez limiter l utilisation du MCU à certaines fenêtres. Cette limitation est accessible depuis la fenêtre de description de la fenêtre, dans l onglet détail (coche interdire l utilisation du MCU ). Lors de la création de l exécutable, vous pouvez également restreindre l utilisation du MCU par un mot de passe, voir même le désactiver totalement. Par défaut, les ordres de modification de fichiers ne sont pas accessibles : vous pouvez cependant les autoriser si vous le souhaitez. Tour de France Technique PC SOFT - Juin page 32