|
|
@@ -7,7 +7,8 @@ INSTALLATION
|
|
|
---------
|
|
|
|
|
|
VCS est un add-in (ou complément) pour Access, qui utilise le code fourni par msaccess-vcs-integration (opensource)
|
|
|
-
|
|
|
+
|
|
|
+
|
|
|
Pour l'installer (Access 2010):
|
|
|
- Télécharger le fichier [vcs.accda.zip](http://codebox/dev/VCS/blob/master/vcs.accda.zip)
|
|
|
- Extraire le fichier 'vcs.accda' de l'archive
|
|
|
@@ -15,8 +16,8 @@ Pour l'installer (Access 2010):
|
|
|
- Menu 'Outils de la base de données' > 'Compléments' > 'Gestionnaire de complément'
|
|
|
- Cliquer sur 'Ajouter un nouveau'
|
|
|
- Trouver le fichier 'vcs.accda' téléchargé, et le sélectionner; valider.
|
|
|
-- Fermer le gestionnaire
|
|
|
-
|
|
|
+- Fermer le gestionnaire
|
|
|
+
|
|
|
VCS est maintenant accessible depuis la liste des compléments pour tous les projets Access ouverts avec cette session Windows.
|
|
|
|
|
|
|
|
|
@@ -30,134 +31,114 @@ Pour utiliser les commandes VCS (Access 2010):
|
|
|
Une boite de dialogue s'affiche et demande de taper la commande désirée.
|
|
|
|
|
|
Liste des commandes VCS:
|
|
|
-* makesources: met à jour le code source
|
|
|
-* * zippe le fichier de l'application
|
|
|
-* * met à jour le code source
|
|
|
+* `makesources`
|
|
|
+> met à jour le code source
|
|
|
+ * zippe le fichier de l'application
|
|
|
+ * met à jour le code source
|
|
|
|
|
|
-* update: met à jour l'application à partir du code source
|
|
|
-* * Créé une sauvegarde de l'application: [nom_app].accdb.old
|
|
|
-* * met à jour l'application à partir du code source
|
|
|
+* `update`
|
|
|
+> met à jour l'application à partir du code source
|
|
|
+ * Créé une sauvegarde de l'application: [nom_app].accdb.old
|
|
|
+ * met à jour l'application à partir du code source
|
|
|
|
|
|
-* init: configure le dépot GIT pour VCS
|
|
|
-* * complète le fichier .gitignore
|
|
|
+* `init`
|
|
|
+> configure le dépot GIT pour VCS
|
|
|
+ * complète le fichier .gitignore
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
-
|
|
|
-
|
|
|
-Configurer le dépot GIT d'une application Access pour utiliser VCS
|
|
|
+Configurer le dépot GIT d'une application Access pour utiliser VCS
|
|
|
-------
|
|
|
|
|
|
[Si le dépot GIT n'est pas encore créé:
|
|
|
-Créer le projet dans Codebox
|
|
|
-> git init
|
|
|
-> git remote add origin ...
|
|
|
-]
|
|
|
-
|
|
|
-
|
|
|
-Créer le fichier .gitignore s'il n'existe pas
|
|
|
-Dans .gitignore, ajouter:
|
|
|
-*.accdb
|
|
|
-*.laccdb
|
|
|
-*.mdb
|
|
|
-*.ldb
|
|
|
-
|
|
|
-[Si un dépot Git existait déjà, il faut retirer ces derniers fichiers de l'index:
|
|
|
-> git rm --cached FILENAME
|
|
|
-]
|
|
|
-
|
|
|
-
|
|
|
-Ouvrir l'application Access
|
|
|
-
|
|
|
-Créer une table "ztbl_vcs_tables", avec un seul champ texte: [tablename] (CP)
|
|
|
-Ajouter à ce champs le nom de chacune des tables qui doivent être incluses dans le système de versionnage.
|
|
|
-Exemple: 'tbl_parametres', 'Communes'...Etc
|
|
|
-
|
|
|
-
|
|
|
-*********
|
|
|
-*option 1*
|
|
|
-Installer le complément VCS
|
|
|
-
|
|
|
-Enregistrer
|
|
|
-
|
|
|
-Compacter l'application
|
|
|
-
|
|
|
-Lancer le complément VCS
|
|
|
-
|
|
|
-Choisir make-sources
|
|
|
-
|
|
|
-
|
|
|
-*option2*
|
|
|
+Créer le projet dans Codebox
|
|
|
+`git init`
|
|
|
+`git remote add origin ...`
|
|
|
+]
|
|
|
+
|
|
|
|
|
|
-Ouvrir VBA (Alt+F11)
|
|
|
+Créer le fichier .gitignore s'il n'existe pas
|
|
|
+Dans .gitignore, ajouter:
|
|
|
+*.accdb
|
|
|
+*.laccdb
|
|
|
+*.mdb
|
|
|
+*.ldb
|
|
|
|
|
|
-Outils > Références
|
|
|
+[Si un dépot Git existait déjà, il faut retirer ces derniers fichiers de l'index:
|
|
|
+`git rm --cached FILENAME`
|
|
|
+]
|
|
|
|
|
|
-Parcourir
|
|
|
|
|
|
-Ajouter c:\...\vcs.accdb
|
|
|
+Ouvrir l'application Access
|
|
|
+
|
|
|
+Créer une table "ztbl_vcs", avec un deux champs texte: [key] (CP), [val]
|
|
|
+Ajouter une entrée avec pour clé `include_tables`
|
|
|
+Dans le champs [val], lister les tables de paramètre qui doivent être incluses dans le suivi de version
|
|
|
+ex: "tbl_parametres", "tbl_communes"...
|
|
|
|
|
|
-Enregistrer
|
|
|
|
|
|
-Afficher la fenetre d'éxécution (Ctrl+G)
|
|
|
+Installer le complément VCS
|
|
|
|
|
|
-Taper make-sources
|
|
|
+Enregistrer
|
|
|
|
|
|
-*********
|
|
|
+Compacter l'application
|
|
|
|
|
|
-(les sources doivent maintenant avoir été créées)
|
|
|
+Lancer le complément VCS
|
|
|
|
|
|
-Zippez votre application: application.accdb -> application.zip
|
|
|
+Taper `makesources`
|
|
|
|
|
|
-> git add *
|
|
|
-> git add .gitignore
|
|
|
-> git commit -m "Mise en place de VCS"
|
|
|
+(les sources doivent maintenant avoir été créées)
|
|
|
|
|
|
-> git push origin master
|
|
|
+Lancer Git:
|
|
|
+`git add *`
|
|
|
+`git add .gitignore`
|
|
|
+`git commit -m "Mise en place de VCS"`
|
|
|
|
|
|
-!!!
|
|
|
-Il est possible qu'il faille à ce niveau effectuer un force push:
|
|
|
-> git push -f origin master
|
|
|
-Il faut pour cela que la branche master cible soit non protégée.
|
|
|
-!!!
|
|
|
+`git push origin master`
|
|
|
|
|
|
-Envoyer une nouvelle version de l'application sur Codebox
|
|
|
+!!!
|
|
|
+Il est possible qu'il faille à ce niveau effectuer un force push:
|
|
|
+`git push -f origin master`
|
|
|
+Il faut pour cela que la branche master cible soit non protégée.
|
|
|
+!!!
|
|
|
+
|
|
|
+
|
|
|
+Pour envoyer une nouvelle version de l'application sur Codebox
|
|
|
-------
|
|
|
|
|
|
-Aprés avoir modifié l'application, et de manière générale à chaque fois qu'il faut utiliser Git sur les sources de l'appli:
|
|
|
-
|
|
|
-Ouvrir l'application Access (si elle n'est pas déjà ouverte)
|
|
|
+Aprés avoir modifié l'application, et de manière générale à chaque fois qu'il faut utiliser Git sur les sources de l'appli:
|
|
|
|
|
|
-Compacter l'application
|
|
|
+Ouvrir l'application Access (si elle n'est pas déjà ouverte)
|
|
|
|
|
|
-Vérifier le contenu de 'ztbl_vcs'
|
|
|
+Compacter l'application
|
|
|
|
|
|
+Vérifier le contenu de 'ztbl_vcs'
|
|
|
|
|
|
-Lancer le complément VCS
|
|
|
|
|
|
-Taper 'makesources'
|
|
|
+Lancer le complément VCS
|
|
|
|
|
|
-Une fois l'opération terminée, lancez git, puis:
|
|
|
+Taper 'makesources'
|
|
|
|
|
|
-> git add *
|
|
|
-> git commit -m [votre message]
|
|
|
+Une fois l'opération terminée, lancez git, puis:
|
|
|
|
|
|
-Récupérer d'éventuelles modifications effectuées par d'autres
|
|
|
-> git pull origin master
|
|
|
-(résoudre les éventuels conflits)
|
|
|
+`git add *`
|
|
|
+`git commit -m [votre message]`
|
|
|
|
|
|
-> git push origin master
|
|
|
+Récupérer d'éventuelles modifications effectuées par d'autres
|
|
|
+`git pull origin master`
|
|
|
+(résoudre les éventuels conflits)
|
|
|
|
|
|
-Si le pull a effectué des modifications:
|
|
|
+`git push origin master`
|
|
|
|
|
|
-Ouvrir l'application Access (si elle n'est pas déjà ouverte)
|
|
|
+Si le pull a effectué des modifications:
|
|
|
|
|
|
+Ouvrir l'application Access (si elle n'est pas déjà ouverte)
|
|
|
|
|
|
-Lancer le complément VCS
|
|
|
+Lancer le complément VCS
|
|
|
|
|
|
-Taper update
|
|
|
+Taper update
|
|
|
|
|
|
|
|
|
|