Based on project: [msaccess-vcs-integration](https://github.com/timabell/msaccess-vcs-integration)

========================

CREDITS
---------
This project use the code from: [msaccess-vcs-integration](https://github.com/timabell/msaccess-vcs-integration)
Logo by [Freepik](http://www.freepik.com), from [Flaticon](http://www.flaticon.com) (licensed by [Creative Commons BY 3.0](http://creativecommons.org/licenses/by/3.0/))

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
- 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  
  
VCS 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  

Choisir 'make_sources', cliquer sur 'Run'

Une fois l'opération terminée, lancez git, puis:  

`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'