Tuto - Un GDS pour WEBDEV

• Une version de référence de chacun de vos projets est présente sur un serveur. L'ensemble de ces versions est appelé "Base de sources".
• Chaque développeur a sur son poste une copie locale des différents projets sur laquelle il travaille.
  
• Lorsqu'un développeur veut modifier un élément d'un projet (une page, un état, une requête, etc.), il indique au GDS qu'il s'approprie temporairement cet élément. Pour cela, le développeur va extraire cet élément de la base de sources.
• Ce développeur obtient alors les droits exclusifs sur cet élément : il peut faire toutes les modifications voulues sur cet élément.
• Les autres développeurs continuent de travailler avec la copie de la version de référence de cet élément (présente dans la base de sources).
• Dès que le développeur a terminé ses modifications, il réintègre l'élément extrait dans la base de sources.
• Les autres développeurs sont automatiquement avertis de cette réintégration. Ils peuvent alors mettre à jour leur copie locale.
  

GDS ou GitHub ?
Il est également possible de partager des éléments sources à travers GitHub.
L'environnement permet de sauver les projets, les fenêtres, les pages, les états, les classes, les collections de procédures et le code dans une base de sources Git. Pour plus de détails, consultez Partagez vos projets via Git.
Cependant, l'utilisation du GDS est conseillée. En effet, le GDS permet en plus d'une comparaison de texte, une comparaison des objets riches (propriétés des champs par exemple). Une interface spécifique, dédiée au GDS, permet de réaliser simplement le "diff" et le "merge" des éléments.

• lors de l'installation de WEBDEV.
• lors de l'importation d'un projet dans le GDS.
• quand vous le souhaitez, directement depuis WEBDEV 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 WEBDEV (Ctrl + <).
2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Créer un site WEBDEV (Back Office et Front Office)", double-cliquez sur "Site WEBDEV Complet - 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.
   
   

   Nous allons créer une base de sources "Client/Serveur" sur le serveur installé lors du tuto Administrer une base HFSQL Client/Serveur. Si vous n'avez pas suivi ce tuto, il est nécessaire de suivre la leçon concernant l'installation du serveur HFSQL.
2. Cliquez sur "HFSQL Client/Serveur".
   
   

   L'utilisation d'une base de sources au format HFSQL Client/Serveur permet d'utiliser cette base de sources à distance.
3. L'écran permettant de créer la base de sources en mode HFSQL Client/Serveur s'affiche.
4. Indiquez les paramètres du serveur HFSQL installé précédemment :
   
   • Le nom du serveur, son port.
   • Le nom de l'administrateur, son mot de passe éventuel.
5. Validez la création de la base de sources (bouton "Créer la base de sources"). Cette opération peut être relativement longue en mode Client/Serveur.
6. La base de sources est à présent créée. Nous allons pouvoir intégrer notre projet dans cette base de sources.
7. Passez à l'étape suivante. L'utilisateur en cours n'est pas autorisé à accéder au serveur HFSQL.
   
   Nous allons créer cet utilisateur : renseignez les informations demandées et cliquez sur le bouton "Créer le compte".
8. 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.
9. 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. Cliquez sur "Tous" et passez à l'étape suivante.
10. 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.
11. Validez 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, pages, 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.

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. Dans l'onglet "HFSQL C/S", 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 page 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 "Ambiance".
3. Cochez l'option "Appliquer l'ambiance sur les boîtes de dialogue (OuiNon et OKAnnuler)".
4. Validez 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.
   WEBDEV 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. Validez cette fenêtre.
4. Différentes fenêtres d'intégration et d'extraction s'ouvrent permettant d'ajouter un modèle de page et des pages internes dans le projet de la base de sources et de les extraire dans le projet local. 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 page 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 page "PAGE_Fiche_du_produit" dans le volet "Explorateur du projet" et double-cliquez sur l'élément pour l'ouvrir sous l'éditeur de pages.
   
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 du volet GDS ().
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 page en mode exclusif. Conservez l'option "Exclusif" cochée.
6. Saisissez un commentaire ("Modification des boutons" par exemple). Ce commentaire sera utile pour les autres développeurs.
7. Validez l'extraction.
   La page est extraite.
8. Sélectionnez le bouton "Valider".
9. Déplacez le bouton vers la droite (en dessous du champ de téléchargement).
10. Enregistrez votre page (Ctrl + S).

1. Affichez la page "PAGE_Liste_des_produits".
2. Testez la page ( parmi les boutons d'accès rapide).
3. Cliquez sur le lien "Modifier" d'un des produits.
4. La page de détail du produit s'affiche. Le bouton "Valider" a bien changé de place.
5. Fermez le navigateur.

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, WEBDEV 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.