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'

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", 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"...

Installer le complément VCS

Enregistrer

Compacter l'application

Lancer le complément VCS

Taper makesources

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

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

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