Tuto - Un GDS pour WINDEV

• lors de l'installation de WINDEV.
• lors de l'importation d'un projet dans le GDS.
• quand vous le souhaitez, directement depuis WINDEV ou depuis l'administrateur du GDS.

• HFSQL Classic.
• HFSQL Client/Serveur.
  
  

  L'utilisation d'une base de sources au format HFSQL Client/Serveur permet d'utiliser cette base de sources à distance.
• PCSCloud (solution payante, clé en main). Le mode PCSCloud permet d'avoir accès aux sources des projets depuis n'importe où, n'importe quand. Ce mode correspond à un Cloud privé (serveur dédié) et propose de nombreuses options (plateforme dédiée, utilisation des Centres de Contrôle, etc.). Pour plus de détails, consultez PCSCloud.
• GDSDrive (solution payante, clé en main). Le mode GDSDrive permet d'avoir accès aux sources des projets présents dans le GDS depuis n'importe où, n'importe quand. Cette solution utilise un serveur mutualisé. Pour plus de détails, consultez GDSDrive.

Pour simplifier les manipulations, ce projet va être intégré dans une nouvelle base de sources locale (sur le poste de développement) au format HFSQL Classic. Le fonctionnement du GDS serait similaire pour un autre type de base de sources.

1. Affichez la page d'accueil de WINDEV (Ctrl + <).
2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Application WINDEV : gérer des données", double-cliquez sur "Application complète - Corrigé".

1. Sous le volet "GDS", dans le groupe "Ajouter le projet", cliquez sur "Ajouter le projet dans le GDS". L'assistant d'ajout d'un projet dans le GDS se lance :
   
   Nous n'avons pas précédemment créé de base de sources. Nous allons donc en créer une.
   
2. Cliquez sur le lien "Base locale" pour créer une base de source locale au poste de développement. La fenêtre permettant de créer la base de sources s'affiche.
   
3. Indiquez le répertoire de cette base de sources ("C:\Mes Projets\GDS Base de sources locale" par exemple).
4. Cliquez sur le bouton "Créer la base de sources" pour valider la création de la base de sources.
5. La base de sources créée est automatiquement sélectionnée dans l'assistant. Nous allons pouvoir intégrer notre projet dans cette base de sources.
6. Passez à l'étape suivante.
7. L'assistant nous propose de placer le projet dans le sous-répertoire "Projets" de la base de sources.
   
   Nous allons accepter cet emplacement. Passez à l'étape suivante.
8. L'assistant nous demande de sélectionner les différents éléments du projet à ajouter dans la base de sources.
   
   Nous voulons que tous les éléments du projet soient ajoutés. Passez à l'étape suivante.
9. L'assistant nous demande de sélectionner les différentes dépendances du projet à ajouter dans la base de sources. Ces dépendances correspondent à tous les éléments externes nécessaires au projet (images, feuilles de styles, etc.).
   Nous voulons que toutes les dépendances du projet soient ajoutées. Passez à l'étape suivante.
10. Cliquez sur "Terminer" pour valider l'intégration du projet dans le GDS. Notre projet et tous ses éléments sont désormais ajoutés dans notre base de sources.
    
    

    Partage d'éléments du projet
    Lors de l'intégration dans le GDS de projets partageant diverses ressources (analyse, fenêtres, etc.), ces ressources peuvent également être partagées entre les différents projets présents dans le GDS. Ainsi, le même élément n'est intégré qu'une seule fois dans le GDS et les modifications sont automatiquement reportées dans les autres projets.

Première ouverture du projet depuis le GDS

1. Ouvrir le projet depuis le gestionnaire de sources : sous le volet "Accueil", dans le groupe "Général", dérouler "Ouvrir" et sélectionner "Ouvrir un projet depuis le GDS".
2. Indiquer les paramètres de localisation de la base de sources et valider (cette étape est nécessaire uniquement si le projet en cours sous l'éditeur n'appartient pas au GDS) :
   
3. Dans la fenêtre qui s'affiche, indiquer si nécessaire la connexion et le répertoire local :
   

Les prochaines ouvertures d'un projet géré par le GDS sont identiques aux ouvertures d'un projet non géré par le GDS : il suffit d'ouvrir le projet correspondant à la copie locale.

• Modifier un paramètre du projet.
• Modifier une fenêtre du projet.

Modification d'un paramètre du projet

1. Affichez la description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
2. Cliquez sur l'onglet "Style".
3. Pour l'option "Fenêtres système Info, OuiNon, Confirmer, Dialogue (pour les configurations WINDEV)", sélectionnez "Personnalisées (intégrées dans le projet)".
4. Cliquez sur "OK" pour valider la fenêtre de description du projet.

1. Tout d'abord la fenêtre d'extraction automatique du projet s'affiche. En effet, nous modifions une caractéristique du projet, il est nécessaire d'extraire le projet.
   
   
   
   

   Par défaut, le GDS utilise le mode d'extraction automatique : si vous tentez de modifier un élément du GDS non extrait, le GDS propose automatiquement d'extraire cet élément.
   WINDEV propose plusieurs modes d'extraction. Pour plus de détails, consultez Les modes de gestion du projet.
2. L'option "Réintégrer automatiquement le projet à la fin de l'opération" permet de réintégrer automatiquement le projet à la fin de sa modification. Conservez cette option.
3. Cliquez sur "OK" pour valider cette fenêtre.
4. Différentes fenêtres d'intégration et d'extraction s'ouvrent permettant d'ajouter le composant interne "WDFAA.wci" et ses éléments dans le projet de la base de sources et de les extraire dans le projet local. Ce composant contient les différentes fenêtres système à personnaliser. Validez ces différentes fenêtres.
5. La fenêtre de description du projet se ferme et le projet est automatiquement réintégré dans la base de sources.

Modification d'une fenêtre du projet

La modification d'un élément extrait (UI, code, etc.) s'effectue comme sur un projet non géré par le GDS.
Cependant, toutes les modifications effectuées sur un élément extrait ne sont pas visibles par les autres développeurs.
Si un autre développeur exécute l'élément extrait, l'élément qui est actuellement dans la base de sources sera utilisé.

Il est ainsi possible de faire évoluer une application tout en gardant une version stable dans la base de sources.

1. Sélectionnez la fenêtre "FEN_Fiche_du_produit" dans l'explorateur du projet et double-cliquez sur l'élément pour l'ouvrir sous l'éditeur de fenêtres.
   
2. L'extraction automatique est activée à la première modification : il suffit de déplacer un champ pour extraire l'élément. Il est également possible d'utiliser l'icône "Extraire" présente dans le ruban ().
3. La fenêtre d'extraction apparaît :
   
4. Le GDS propose trois modes d'extraction :
   • Exclusif (mode conseillé) : personne ne pourra extraire cet élément jusqu'à sa réintégration. L'élément pourra uniquement être extrait pour test.
   • Pour test : l'élément pourra être modifié mais les modifications ne pourront pas être réintégrées.
   • Multiple : l'élément pourra également être extrait par d'autres utilisateurs. Dans ce cas, lors de la réintégration, il sera possible de visualiser les différences entre les différentes versions de l'élément. Ce mode est réservé à des cas d'utilisations spécifiques et à des développeurs avancés.
5. Nous allons extraire la fenêtre en mode exclusif. Conservez l'option "Exclusif" cochée.
6. Saisissez un commentaire ("Modification de l'image" par exemple). Ce commentaire sera utile pour les autres développeurs.
7. Validez l'extraction. La fenêtre est extraite.
8. Affichez la fenêtre de description du champ Image (option "Description" du menu contextuel).
9. Dans l'onglet "UI", modifiez le curseur utilisé : sélectionnez le curseur "Main système".
10. Validez la fenêtre de description du champ.
11. Affichez le code du champ Image : sélectionnez le champ Image et utilisez par exemple la touche F2.
12. Saisissez le code suivant dans l'événement "Clic sur ..." :
    

    // Exécute le code de clic du bouton qui modifie l'image
    BTN_Modifier.ExécuteTraitement(trtClic)

13. Fermez la fenêtre de code.
14. Enregistrez votre fenêtre (Ctrl + S).

1. Lancez le test du projet ( parmi les boutons d'accès rapide).
2. Sélectionnez un produit et cliquez sur "Modifier".
3. Dans la fiche qui apparaît, cliquez sur l'image du produit : le sélecteur de fichier s'ouvre pour modifier l'image du produit. C'est bien le fonctionnement attendu.
4. Fermez la fenêtre de test.

Réintégration de l'élément extrait

Sous le volet "GDS", dans le groupe "Elément en cours", cliquez sur le bouton "Réintégrer". La fenêtre suivante s'affiche :

Cette fenêtre permet de :

• connaître les modifications effectuées en comparant l'élément de la base de sources avec l'élément extrait (bouton "Mes Modifs...").
  
  

  Fusion de code

  Vous pouvez comparer un élément avec une de ses versions précédentes. Il est alors possible de comparer le code pour récupérer un code "perdu" ou supprimé par erreur par un autre développeur par exemple.
• accéder à l'historique de l'élément dans la base de sources (bouton "Propriétés...").
• saisir un commentaire sur les modifications réalisées. Par défaut, WINDEV propose le commentaire saisi lors de l'extraction.
• envoyer un message aux autres développeurs.
• réintégrer les modifications effectuées dans l'élément, tout en conservant l'élément extrait (option "Garder l'élément extrait").
  
  

  Si vous utilisez les Centres de Contrôle, il est également possible de terminer la tâche en cours lors de la réintégration de l'élément dans le Gestionnaire de sources. Cette fonctionnalité est utile notamment pour assurer le suivi des tâches, des corrections de bugs, etc.

• Les options du projet spécifiques au GDS.
• Le travail en mode nomade.
• L'administrateur du GDS.

Il est conseillé de faire régulièrement des sauvegardes de la base de sources du GDS. Ces sauvegardes peuvent être réalisées via l'administrateur du GDS.

1. Affichez la fenêtre de description du projet : sous le volet "Projet", dans le groupe "Projet", cliquez sur "Description".
2. Dans l'onglet "GDS", sélectionnez l'option "Aucun GDS ou gestionnaire externe (GIT)".
3. Validez la fenêtre de description du projet.