Browse Source

Update README.md

MASSOT Olivier 9 years ago
parent
commit
373baafd13
1 changed files with 11 additions and 118 deletions
  1. 11 118
      README.md

+ 11 - 118
README.md

@@ -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
 CREDITS
 ---------
 ---------
 This project use the code from the project: [msaccess-vcs-integration](https://github.com/timabell/msaccess-vcs-integration)  
 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
 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):  
 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'
 - Menu 'Outils de la base de données' > 'Compléments' > 'Gestionnaire de complément'
 - Cliquer sur 'Ajouter un nouveau'
 - 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  
 - 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
 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'