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

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

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'  

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

* 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







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*

Ouvrir VBA (Alt+F11)

Outils > Références

Parcourir

Ajouter c:\...\vcs.accdb

Enregistrer

Afficher la fenetre d'éxécution (Ctrl+G)

Taper make-sources

*********

(les sources doivent maintenant avoir été créées)

Zippez votre application: application.accdb -> application.zip

> 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.
!!!

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

Taper 'makesources'

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

Taper update