openaccess

Based on: msaccess-vcs-integration [from this page

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

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
• 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, [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'