Changes

Jump to navigation Jump to search
Line 62: Line 62:     
=== Synchronisation des événements Dolibarr vers Google Agenda ===
 
=== Synchronisation des événements Dolibarr vers Google Agenda ===
L'autre fonction permet de créer/mettre à jour un événement dans Google lors de sa création dans Dolibarr.
  −
Le but de cette fonction est de pousser chaque élément de l'agenda Dolibarr sur l'agenda par défaut d'un compte google. La synchronisation est donc monodirectionnel (de Dolibarr vers Google).
     −
Le compte google peut être (1 seul compte X pour tout le monde) ou bien cela peut être le compte de la personne à qui la tache est affectée.
+
{{ToTranslate}}
 +
The other feature is to write/update an event into Google Calendar, each time an event is added/updated into Dolibarr.
   −
==== Si vous décidez d'utiliser un compte fixe X ====
+
For this, go onto module setup page, tab "Sync to Google Agenda", and set "Create a Google event into Google Calendar when creating a Dolibarr event" to "Yes".
   −
Pour cela, sur la page de configuration du module, pour l'onglet "Sync to Google Agenda", il vous faut saisir:
+
Then, you must setup and enter the API keys provided by Google. This is dones in several step.
* Votre login Google (exemple: moncompte@gmail.com)
  −
* Votre mot de passe Google
  −
Puis cliquer sur '''Enregistrer'''.
     −
Le bouton pour réaliser un test de synchro devient alors cliquable. Cliquez dessus pour faire un test.
+
1) Find the Google Agenda ID or your calendar.
 +
Go into your Google Calendar, then "Parameters" in the wheels, then tab "Agenda", or try this link https://www.google.com/calendar/render#i and then click on name or your Agenda. You Agenda ID is an ID that looks like an email.
   −
[[File:Warning.png]] Remarque: Une erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous.
+
Fille this ID found into field "ID Agenda".
Pour vérifier si Google a bien bloqué l'accès pour ce motif, allez sur la page https://security.google.com/settings/security/activity?hl=fr après l'échec.
     −
Si Google affiche qu'il a bloqué des tentatives d'accès depuis un lien inhabituel, accepter cette tentative. Ensuite, il faut attendre 24h pour essayer à nouveau.
+
2) You must create a service account user/email from page https://code.google.com/apis/console/, menu "API & Authentication" -> "Credentials" . Click on "Create a client ID" and choose "Service Account" then "Create". You will get a new service account with a Service account client ID and a Service account EMail. You need here to enter the Service account EMail.
   −
[[File:Warning.png]] Remarque: Une autre erreur possible est que Google refuse l'accès même si votre login/mot de passe est correct, parceque vous avez activez la validation en 2 étapes. Pour vérifiez si vous avec effectivement activé cette option, aller sur la page: https://security.google.com/settings/security?pli=1
+
Note: A popup to download a file (used by next step)
Si dans la rubrique "Validation en deux étapes", vous avez "Activé", le problème est la. Vous n'êtes pas obligé de la désactiver. Vous pouvez résoudre le problème ainsi: Cliquer sur "Modifier" à côté du titre de la rubrique "Validation en 2 étapes".
  −
Cliquez sur le lien "Gérer les mots de passe spécifiques à des applications". Saisissez un nom, par exemple "Accès google par Dolibarr" et valider. Un mot de passe vous sera fourni.
  −
Retournez sur la page de configuration du module Google dans Dolibarr et enregistrez ce mot de passe dans la page de configuration du module à la place de votre mot de passe habituel, puis '''Enregistrer. Réessayer le test de synchro.
      +
3) Once you have you created your service account user/email (see note on previous fields), you must download your security p12 file (or use the one downloaded at previous step). Return on https://code.google.com/apis/console/ and select "API & Authentication" -> "Credentials". Then Click on "Generate a p12 key" to download the file on your desktop. Then submit it using this form.
   −
Le fonctionnement sera alors le suivant:
+
4) You must also enable the API for your Google account. For this go on page https://code.google.com/apis/console/, menu "API & Authentication" -> "API". Click to enable API for "Calendar API".
   −
Si une tache 1 est affectée à l'utilisateur 1, elle sera poussé sur l'agenda google du compte X.
+
5) You must also share the agenda (all permissions) with the service account user/email (created at step 2): For this, go into Google calendar, choose "Parameters" then tab "Agendas" (direct access with this link https://www.google.com/calendar/render?tab=mc#i). Click on link "Share parameters" at end of line of the Agenda to synchronize (It must be same Agenda than the one choosed on parameter "ID Agenda" at step 1). Then add the service account user into the email field, choose permission "Edit events" and validate by clicking "Add user".  
Si une tache 2 est affectée à l'utilisateur 2, elle sera poussée également ce même agenda google du compte X.
  −
X étant un agenda google, il sera visible sur tout smartphone Android qui a ajouté les identifiants du compte X dans les comptes de son smartphone.  
  −
Inconvénient, tout le monde a le login/pass du compte générique X, et tout le monde verra tous les événements de tout le monde.
     −
==== Si vous utilisez un compte google différent pour chaque utilisateur ====
+
With Google Apps for work (not required for standard gmail account), permissions may be forced to "Ready only" instead of "Edit". To solve this, go onto https://admin.google.com/AdminHome#AppDetails:service=Calendar&flyout=sharing and check that sharing option of Agenda application allows sharing with external service account. [[File:Warning.png]] A 24h delay may be required to be able to return and finish step 5.
   −
Pour cela, sur la page de configuration du module, pour l'onglet "Sync to Google Agenda", laisser le champ login/mot de passe vide. Chaque utilisateur doit par contre, renseigner son compte google et mot de passe sur sa fiche utilisateur.
     −
Le fonctionnement sera alors le suivant:
+
Once all steps are done, you can use the button to make a synchronization test. Click on it to make a test.
   −
Si une tache 1 est affectée à l'utilisateur 1, elle sera poussé sur l'agenda google du compte google de l'utilisateur 1
  −
Si une tache 2 est affectée à l'utilisateur 2, elle sera poussée sur l'agenda google du compte google de l'utilisateur 2
  −
Ce sont des agenda google, donc visible sur smartphones Android.
  −
Chacun ayant son agenda, verra ces événements dans son agenda.
     −
Il est ensuite possible de partager les agendas entre personnes 2 à 2 (Le user 1 rend visible son agenda au user 2 et au user 3 mais pas au user 4).
+
'''TroubleShooting'''
Mais cela est une fonctionnalité propre aux agendas google ou chacun peut rendre son agenda visible à d'autres. Ce n'est pas le module google qui apporte cela mais les fonctions de bases de partage d'agenda accessible depuis la configuration dans google agenda.
     −
Les fonctions de partagent d'agenda proposés par google fonctionnant aussi sur smartphone Android, l'utilisateur à qui les autres ont donnés accès à leur agenda verra les agenda de ces autres. La encore y compris sur smartphone.
+
* If you receive error "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (404) Not Found": Check the step 5 was done.
 +
 
 +
* If you receive error "ERROR Error calling POST https://www.googleapis.com/calendar/v3/calendars/yourcalendarid/events: (403) Forbidden": Check the step 5 was done and that permission granted was read and write and not read only.
 +
 
 +
* [[File:Warning.png]] Note: A possible error is that Google denies access, even if login and password are correct, but just because the server that host Dolibarr is located into another country than country you are using google apps usually
 +
To check Google has locked your access for this reason, go onto page https://security.google.com/settings/security/activity?hl=fr after failure.
 +
 
 +
If it appears Google has blocked access attempts from an unusual location, accept this attempt. Then, you must wait 24 hours to try again.
 +
 
 +
* [[File: Warning.png]] Note: Another possible error is that Google denies access even if your login and password are correct, because you turn on Google option 2-step validation. To check if you have actually enabled this option, go to the page: https://security.google.com/settings/security?pli=1
 +
 
 +
If in the "Validation in two stages," you have "On", the problem is found. You do not have to disable it. You can solve the problem as follows:
 +
Click "Edit" next to the title of the "Validation in two steps."
 +
Click the link "Manage passwords specific to applications". Enter a name, for example "Google Access for Dolibarr" and confirm. A password will be provided.
 +
Return to the configuration page of Google Dolibarr module and enter this password in the configuration page of the module, instead of your regular password, then click '''Save'''.  
 +
Retry the test synchronization.
    
== Configuration Google Contacts ==
 
== Configuration Google Contacts ==

Navigation menu