Module Google FR: Difference between revisions

m
Tag: 2017 source edit
Tag: 2017 source edit
Line 52: Line 52:
=Configuration=
=Configuration=
{{ActivationModuleFr}}
{{ActivationModuleFr}}
==Configuration Google Contacts==
Le module permet de réaliser une synchronisation de vos contacts Dolibarr avec votre annuaire Google contact. Les éléments pouvant être synchronisés sont:
*Les tiers
*Les adresses
*Les adhérents du module Association
La synchronisation ne peut se faire que vers un 1 compte Google, mais il est possible via les fonctions de partage Google que de nombreux autres utilisateurs aient accès aux contacts de ce compte.
1) Dans un premier temps, vous devez activer l'API pour votre compte Google. Pour cela, aller sur la page {{ModuleGoogleUrlToCreateApiAccount}}. Cliquez pour "Activer API" pour "API People".
2) Ensuite, allez sur la page de configuration du module Google dans Dolibarr et choisissez les éléments que vous voulez synchroniser. Vous pouvez choisir l'un d'eux ou tous:
*Tiers (si le module Tiers est activé)
*Contacts/Adresses (si le module Tiers est activé)
*Adhérents (si le module Adhérents est activé)
Pour chaque type de synchro activé, renseigner le nom du libellé de groupe de votre choix. Ce groupe sera celui visible dans Google Contact qui regroupera toutes les fiches issues de Dolibarr. Le groupe sera créé dans Google Contact si il n'existe pas. Vous pouvez aussi utiliser un des libellés de groupes systèmes prédéfinis par Google comme: '''"System Group: My Contacts", "System Group: Friend", "System Group: CoWorker", "System Group: Family"'''
Notez aussi que seul le groupe système prédéfini '''"System Group: My Contacts"''' est partagé par la fonction "Delegation de contacts" de Google contact (Google Apps for Work). Aussi, si vous désirez partager votre annuaire Google pour que d'autres voient cet annuaire, il vous faut mettre vos fiches Dolibarr dans ce groupe. Elles ne doivent être mise dans un groupe autre dans ce cas.
Ensuite, renseignez les informations suivantes:
3) Le compte google (exemple myaccount@gmail.com ou myname@mycompany.com)
4) Le Google Client ID et le Google Client Secret. Vous pouvez créer votre Google Client ID et Secret depuis la page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Services" -> "Identifiants". Cliquer sur "Créer un client ID" et choisir "Web Application", positionner "Allowed Javascript origin" à vide et positionner "URI de Redirection" sur la valeur proposée dans le champ "Note" sur la page de configuration Dolibarr. Ce doit être une valeur du genre http://mycompanydomain/.../google/oauth2callback.php
Ensuite cliquer sur "Créer". Vous obtiendrez un nouveau Client ID et un Code secret du client.
5) Recopier les valeurs du Client ID et du Code secret client sur la page de configuration du module Google de Dolibarr puis Enregistrer.
6) Une alerte doit indiquer que vous n'avez pas encore de jetons Google sauvé dans votre base de donnée Dolibarr. Cliquez sur le lien sous le warning pour vous authentifier sur Google, et entrez vos identifiants/mot de passe Google si demandé (ceux en rapport avec le compte saisi à l'étape 2 et accepter toute confirmation. Vous allez revenir sur la page de configuration Dolibarr mais avec une valeur de jeton sauvé en base Dolibarr qui sera renseigné.
7) Les boutons pour réaliser des test de synchronisation deviennent disponibles. Utilisez les pour faire des tests.
8) Vous pouvez désormais exporter vos tiers/contacts/adhérents vers Google Contacts. De plus, dès lors où vous créerez, modifierez ou supprimerez un tiers/contact/adhérent directement depuis les pages Dolibarr prévues à cet effet, les modifications se reporteront dans Google Contacts sans que vous ayez à vous en soucier. Enfin, les libellés affectés à chacun des éléments Dolibarr seront également reportés vers Google Contacts.
'''Troubleshooting'''
*[[File:Warning.png]] Note: Une erreur possible est que Google refuse l'accès même si votre configuration est correcte, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous.
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.
*[[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès même si votre configuration est correcte, parce que vous avez activez la validation en 2 étapes. Pour vérifiez si vous avez effectivement activé cette option, aller sur la page: {{GoogleURLToSetup2StepValidation}}
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.
*[[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès, même si votre configuration est correcte, parce que le serveur sur lequel tourne Dolibarr ou l'ordinateur avec lequel vous y accédez n'est pas à l'heure.


==Configuration Google Agenda==
==Configuration Google Agenda==
Line 124: Line 186:
Cette fonction nécessite un acte manuelle à chaque besoin de synchronisation.
Cette fonction nécessite un acte manuelle à chaque besoin de synchronisation.
Aller dans le menu "Agenda/Événements", sur la vue "Liste". Vous devez cliquez sur le lien "Rafraîchir les événements depuis Google"
Aller dans le menu "Agenda/Événements", sur la vue "Liste". Vous devez cliquez sur le lien "Rafraîchir les événements depuis Google"
==Configuration Google Contacts==
Le module permet de réaliser une synchronisation de vos contacts Dolibarr avec votre annuaire Google contact. Les éléments pouvant être synchronisés sont:
*Les tiers
*Les adresses
*Les adhérents du module Association
La synchronisation ne peut se faire que vers un 1 compte Google, mais il est possible via les fonctions de partage Google que de nombreux autres utilisateurs aient accès aux contacts de ce compte.
1) Dans un premier temps, vous devez activer l'API pour votre compte Google. Pour cela, aller sur la page {{ModuleGoogleUrlToCreateApiAccount}}. Cliquez pour "Activer API" pour "API People".
2) Ensuite, allez sur la page de configuration du module Google dans Dolibarr et choisissez les éléments que vous voulez synchroniser. Vous pouvez choisir l'un d'eux ou tous:
*Tiers (si le module Tiers est activé)
*Contacts/Adresses (si le module Tiers est activé)
*Adhérents (si le module Adhérents est activé)
Pour chaque type de synchro activé, renseigner le nom du libellé de groupe de votre choix. Ce groupe sera celui visible dans Google Contact qui regroupera toutes les fiches issues de Dolibarr. Le groupe sera créé dans Google Contact si il n'existe pas. Vous pouvez aussi utiliser un des libellés de groupes systèmes prédéfinis par Google comme: '''"System Group: My Contacts", "System Group: Friend", "System Group: CoWorker", "System Group: Family"'''
Notez aussi que seul le groupe système prédéfini '''"System Group: My Contacts"''' est partagé par la fonction "Delegation de contacts" de Google contact (Google Apps for Work). Aussi, si vous désirez partager votre annuaire Google pour que d'autres voient cet annuaire, il vous faut mettre vos fiches Dolibarr dans ce groupe. Elles ne doivent être mise dans un groupe autre dans ce cas.
Ensuite, renseignez les informations suivantes:
3) Le compte google (exemple myaccount@gmail.com ou myname@mycompany.com)
4) Le Google Client ID et le Google Client Secret. Vous pouvez créer votre Google Client ID et Secret depuis la page {{ModuleGoogleUrlToCreateApiAccount}}, menu "API & Services" -> "Identifiants". Cliquer sur "Créer un client ID" et choisir "Web Application", positionner "Allowed Javascript origin" à vide et positionner "URI de Redirection" sur la valeur proposée dans le champ "Note" sur la page de configuration Dolibarr. Ce doit être une valeur du genre http://mycompanydomain/.../google/oauth2callback.php
Ensuite cliquer sur "Créer". Vous obtiendrez un nouveau Client ID et un Code secret du client.
5) Recopier les valeurs du Client ID et du Code secret client sur la page de configuration du module Google de Dolibarr puis Enregistrer.
6) Une alerte doit indiquer que vous n'avez pas encore de jetons Google sauvé dans votre base de donnée Dolibarr. Cliquez sur le lien sous le warning pour vous authentifier sur Google, et entrez vos identifiants/mot de passe Google si demandé (ceux en rapport avec le compte saisi à l'étape 2 et accepter toute confirmation. Vous allez revenir sur la page de configuration Dolibarr mais avec une valeur de jeton sauvé en base Dolibarr qui sera renseigné.
7) Les boutons pour réaliser des test de synchronisation deviennent disponibles. Utilisez les pour faire des tests.
8) Vous pouvez désormais exporter vos tiers/contacts/adhérents vers Google Contacts. De plus, dès lors où vous créerez, modifierez ou supprimerez un tiers/contact/adhérent directement depuis les pages Dolibarr prévues à cet effet, les modifications se reporteront dans Google Contacts sans que vous ayez à vous en soucier. Enfin, les libellés affectés à chacun des éléments Dolibarr seront également reportés vers Google Contacts.
'''Troubleshooting'''
*[[File:Warning.png]] Note: Une erreur possible est que Google refuse l'accès même si votre configuration est correcte, juste parce que votre serveur qui héberge Dolibarr ne se situe pas dans le même pays que vous.
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.
*[[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès même si votre configuration est correcte, parce que vous avez activez la validation en 2 étapes. Pour vérifiez si vous avez effectivement activé cette option, aller sur la page: {{GoogleURLToSetup2StepValidation}}
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.
*[[File:Warning.png]] Note: Une autre erreur possible est que Google refuse l'accès, même si votre configuration est correcte, parce que le serveur sur lequel tourne Dolibarr ou l'ordinateur avec lequel vous y accédez n'est pas à l'heure.


==Configuration fonction GMaps==
==Configuration fonction GMaps==