|
|
@@ -1,6 +1,8 @@
|
|
|
-
|
|
|
========================
|
|
|
|
|
|
+OpenAccess est un add-in (complément) Access utilisé pour générer le code source d'une application
|
|
|
+(ce qui permet ensuite l'utilisation d'outils de contrôle de version comme Git).
|
|
|
+
|
|
|
CREDITS
|
|
|
---------
|
|
|
This project use the code from the project: [msaccess-vcs-integration](https://github.com/timabell/msaccess-vcs-integration)
|
|
|
@@ -9,142 +11,33 @@ Logo by [Freepik](http://www.freepik.com), from [Flaticon](http://www.flaticon.c
|
|
|
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
|
|
|
-- Ouvrir Access
|
|
|
+- Télécharger le fichier [OpenAccess.zip](http://codebox/dev/VCS/blob/master/OpenAccess.zip)
|
|
|
+- Extraire le fichier 'OpenAccess.accda' de l'archive
|
|
|
+- Ouvrir votre application Access
|
|
|
- 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.
|
|
|
+- Trouver le fichier 'OpenAccess.accda' téléchargé, le sélectionner, valider.
|
|
|
- Fermer le gestionnaire
|
|
|
|
|
|
-VCS est maintenant accessible depuis la liste des compléments pour tous les projets Access ouverts avec cette session Windows.
|
|
|
+OpenAccess est maintenant accessible depuis la liste des compléments pour tous les projets Access ouverts avec cette session Windows.
|
|
|
|
|
|
|
|
|
UTILISATION
|
|
|
-------
|
|
|
|
|
|
-Pour utiliser les commandes VCS (Access 2010):
|
|
|
-
|
|
|
-> Menu 'Outils de la base de données' > 'Compléments' > 'VCS'
|
|
|
-
|
|
|
-Un formulaire s'affiche et permet de sélectionner la commande désirée.
|
|
|
-
|
|
|
-Choisir la commande voulue, ajouter des arguments si nécessaire, puis cliquer sur 'Run'
|
|
|
-
|
|
|
-Liste des commandes VCS:
|
|
|
-* `makesources`
|
|
|
-> met à jour le code source
|
|
|
- * zippe le fichier de l'application
|
|
|
- * met à jour le code source
|
|
|
-
|
|
|
-* `update_from_sources`
|
|
|
-> 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
|
|
|
-
|
|
|
-* `configure_git_repo`
|
|
|
-> configure le dépot GIT pour VCS
|
|
|
- * complète le fichier .gitignore
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-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", 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,ztbl_liens"
|
|
|
-
|
|
|
-
|
|
|
-Installer le complément VCS
|
|
|
-
|
|
|
-Enregistrer
|
|
|
-
|
|
|
-Compacter l'application
|
|
|
-
|
|
|
-Lancer le complément VCS
|
|
|
-
|
|
|
-Choisir `make_sources`
|
|
|
-
|
|
|
-Attendre que le message 'Done' apparaisse
|
|
|
-
|
|
|
-Lancer Git:
|
|
|
-`git add *`
|
|
|
-`git add .gitignore`
|
|
|
-`git commit -m "Mise en place de VCS"`
|
|
|
-
|
|
|
-`git push origin master`
|
|
|
-
|
|
|
-!!!
|
|
|
-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)
|
|
|
-
|
|
|
-Compacter l'application
|
|
|
-
|
|
|
-Vérifier le contenu de 'ztbl_vcs'
|
|
|
-
|
|
|
-
|
|
|
-Lancer le complément VCS
|
|
|
+Pour lancer OpenAccess (Access 2010):
|
|
|
|
|
|
-Choisir 'make_sources', cliquer sur 'Run'
|
|
|
+> Menu 'Outils de la base de données' > 'Compléments' > 'OpenAccess'
|
|
|
|
|
|
-Une fois l'opération terminée, lancez git, puis:
|
|
|
+Pour plus d'informations sur l'utilisation de OpenAccess, consultez le [Wiki](http://codebox/dev/OpenAccess/wikis/home)
|
|
|
|
|
|
-`git add *`
|
|
|
-`git commit -m [votre message]`
|
|
|
|
|
|
-Récupérer d'éventuelles modifications effectuées par d'autres
|
|
|
-`git pull origin master`
|
|
|
-(résoudre les éventuels conflits)
|
|
|
|
|
|
-`git push origin master`
|
|
|
|
|
|
-Si le pull a effectué des modifications:
|
|
|
|
|
|
-Ouvrir l'application Access (si elle n'est pas déjà ouverte)
|
|
|
|
|
|
-Lancer le complément VCS
|
|
|
|
|
|
-Choisir 'update'
|
|
|
-'Run'
|
|
|
|
|
|
|
|
|
|