Apps

Module G Suite 1.0

Description

Le module G Suite permet d'intégrer JPlatform avec votre offre G Suite, de gérer vos documents, vos mails et vos calendriers.

  • Authentification
    • Simplifier la connexion des utilisateurs à votre site grâce à l'authentification Google.
  • Google Drive
    • Naviguer dans un Drive
    • Rechercher des documents présents sur le Drive via la recherche de votre plateforme
    • Créer des documents Google Docs (documents, feuilles de calcul, présentations, dessins)
    • Partager des documents édités avec Google Docs sur votre site avec d'autres membres,
    • Voir les documents édités avec Google Docs via une visionneuse intégrée sur votre site,
    • Co-éditer des documents édités avec Google Docs sans quitter votre site.
  • GMail
    Toutes les fonctionnalité proposées par le module JMail sont couvertes : 
    • Affichage de mails depuis la topbar
    • Importer les pièces jointes
    • Marquer comme lu/nonlu
    • Marquer comme Spam
    • Archiver
    • ...
  • Google Calendar
    Toutes les fonctionnalité proposées par le module JCalendar sont couvertes : 
    • Calendrier d'espace
    • Affichage des calendrier d'utilisateur
    • Création d'évènement
    • Planification d'évènement
    • ...

Ce module nécessite les modules : JServices, JCalendar, JMail, et OAuth .


Captures d'écran

1. Visionneuse Google Docs

Installation

Installation

  • Installez les modules dépendants :
    • Module JServices, 
    • Module JMail,
    • Module JCalendar,
    • Module OAuth
  • Installez le module G Suite, 
  • Redémarrez JPlatform 

 

Ce module peut être utilisé uniquement avec des comptes G Suite.

Configuration

Si vous êtes l'administrateur du site et que vous devez configurer le site pour utiliser le module G Suite, vous devez lire cette section.
Si vous souhaitez simplement utiliser le module G Suite en tant qu'utilisateur, veuillez lire la section Guide Utilisateur.

Configuration des APIs Google

Accédez à la console développeur Google
https://console.developers.google.com/

Création d'un Projet d'API

Créer un projet API Google. 

G Suite - Capture d'écran - Illustration de documentation - 01 -- Console Développeur Google - création projet

Configuration de l'authorisation OAuth

Accédez à la section "Écran d'autorisation OAuth"
https://console.developers.google.com/apis/credentials/consent

 

Renseignez les informations qui seront présentées aux utilisateurs lors de leur authentification dans JPlatform.

  • Nom de l'application. Recommandation :  utilisez le même nom que votre site, ce dernier étant défini dans les propriétés de l'espace d'administration.
  • Logo de l'application. 
  • Domaines autorisés. Renseignez le nom de domaine sur lequel JPlatform est hébergé.

G Suite - Capture d'écran - Illustration de documentation - 02 -- Console Développeur Google - Écran d'autorisation OAuth
mceclip0 - 2019-10-04 10h58m27s

 


Création des Identifiants

Accédez à la section " Identifiants"
https://console.developers.google.com/apis/credentials
 
Créez un ID client OAuth :
G Suite - Capture d'écran - Illustration de documentation - 03 -- Console Développeur Google - création ID client OAuth 
 

Renseignez :

  • Type d'application : Application Web
  • Nom : il s'agit d'un nom interne, non visible pas les utilisateur. Conseil : utilisez un nom qui vous permettent d'associer rapidement ces identifiants à leur utilisation par le module GSuite Jalios
    Exemple : ModuleGSuite
  • URI de redirection autorisés
    Saisissez impérativement cette valeur en utilisant l'URL d'accès à votre webapp suivi du chemin plugins/GSuitePlugin/jsp/oauth2callback.jsp
    Exemple : https://jplatform.example.com/plugins/GSuitePlugin/jsp/oauth2callback.jsp
    (Attention : n'oubliez pas de valider la saisie de votre URL en appuyant sur la touche entrée)

G Suite - Capture d'écran - Illustration de documentation - 04 -- Console Développeur Google - création ID client OAuth Validez.

Copier l'ID client et le code secret client pour configurer JPlatform (cf section "Configuration JPlatform > Identifiants G Suite" de cette documentation)

G Suite - Capture d'écran - Illustration de documentation - 05 -- Console Développeur Google - copie des identifiants de client OAuth

Activation des APIs

Accédez à la page " Bibliothèque d'API"
https://console.developers.google.com/apis/library

 

Procédez à l'activation des APIs suivantes requise par le module G Suite : 

  • Google Drive API 
    G Suite - Capture d'écran - Illustration de documentation - 08 -- Console Développeur Google - activation de l'API Google Drive 
  • Google Calendar API
    G Suite - Capture d'écran - Illustration de documentation - 07 -- Console Développeur Google - activation de l'API Google Calendar
  • GMail API
    G Suite - Capture d'écran - Illustration de documentation - 11 -- Console Développeur Google - activation de l'API GMail 
  • People API 
    G Suite - Capture d'écran - Illustration de documentation - 09 -- Console Développeur Google - activation de l'API Google People 
  • Admin SDK 
    G Suite - Capture d'écran - Illustration de documentation - 10 -- Console Développeur Google - activation de l'API Admin SDK 

Si la création d'identifiant ou de compte de service vous est demandé lors de l'activation d'une des API, vous pouvez ignorer la demande.

Configuration JPlatform

Identifiants G Suite

En tant qu'administrateur JPlatform, accédez à l'interface d'édition de propriétés du module G Suite.

Saisissez l'ID client et le code secret client précédement obtenu depuis la console Google APIs :

G Suite - Capture d'écran - Illustration de documentation - 06 -- Edition des propriétés du module G Suite - saisie des identifiants Google  

Vous pouvez également saisir les valeurs directement dans le fichier custom.prop (ou plugin.prop de votre module de site) comme suit :

jcmsplugin.gsuite.provider.google.apiKey: 123456789012-abcdefghijklmnopqrstuvwxyzabcdef.apps.googleusercontent.com
jcmsplugin.gsuite.provider.google.apiSecret: Ab12cd34ef56gh78ij90_klm

 

Compte de service

Vous devez autoriser le site à accéder à G Suite grâce à un compte de service.

Pour cela,

  • accédez à JPlatform en tant qu'administrateur
  • allez dans l'Espace d'Administration de JPlatform, section "Exploitation" et cliquez sur "Se connecter à Google...".
    G Suite - Capture d'écran - Illustration de documentation - 12 -- lien
  • Identifiez vous avec un utilisateur Google super administrateur de votre domaine G Suite. 
  • Valider les demande d'authorisation 

La page de l'Espace d'Administration est actualisée, le lien "Se connecter à Google..." a été remplacé par un lien "Se déconnecter de Google...", avec une information sur l'email du compte administrateur G Suite.
G Suite - Capture d'écran - Illustration de documentation - 13 -- lien

 

Guide Utilisateur

Se connecter à Google

Vous devez autoriser le site à accéder à G Suite grâce à votre compte Google.
Pour cela, 2 possibilités :

  • Automatiquement, après authentification depuis votre compte Google
    • effectuez l'authentification au site JPlatform via le bouton "Se connecter avec Google"
      (nécéssite l'activation de l'authentification Google par l'administrateur du site)
  • Manuellement, depuis votre profil utilisateur
    • allez dans la page d'édition de votre profil / Identifiants d'accès et cliquez sur "Se connecter à Google..." 
    • Une nouvelle fenêtre s'ouvre dans laquelle vous devez autoriser l'accès en cliquant sur le bouton Autoriser.
    • La page d'édition du profil est actualisée et vous devriez voir "Se déconnecter de Google..." 

Se déconnecter de Google

Si vous voulez vous déconnecter , allez dans la page d'édition de votre profil / Identifiants d'accès et cliquez sur "Se déconnecter de Google...".

Cliquez sur le bouton Oui dans la fenêtre modale de confirmation.

Une nouvelle fenêtre s'ouvre dans laquelle vous devez retirer les droits d'accès au site.

Après la révocation de l'accès, vous pouvez fermer la fenêtre.

Intégration Google Drive

Ajouter un Document Google Docs

Si vous voulez ajouter un document Google Docs, allez dans le menu Ajouter dans la barre du haut de la page d'accueil, puis cliquez sur Documents -> Document Google Docs.

addgoogledrive
Ajouter un document Google Docs à partir du menu Ajouter

Une nouvelle fenêtre modale s'ouvre avec 4 étapes : Source, Modèles, Participants et Informations

googledrive-modal-step1
Ajouter un document Google Docs - Source
  1. Source :

    Vous pouvez sélectionner l'Espace de travail dans lequel le document Google Docs est stocké. Par défaut, le champ est rempli avec l'Espace de travail courant,

    Cette étape vous autorise à choisir comment ajouter le document Google Docs.

    • Démarrer un document vierge :

      Cette option vous permet de créer un nouveau Document Google Docs à partir d'un document vierge ou d'un modèle de document.

      Vous devez entrer le Titre du document et sélectionner un type de Document Google : Document texte, Présentation, Feuille de calcul et Dessin.

    • Déposer un fichier :

      Cette option vous permet de créer un Document Google Docs à partir d'un document en local.

      Les documents, feuilles de calcul et présentations que vous créez, ainsi que les fichiers que vous importez, sont soumis à des limites. Veuillez vous référer à Google Docs, Sheets, Slides and size limits pour plus d'informations.

      Vous devez choir un type de document valide :

      Google Document Type Document Types Mime Types
      Document Document texte DOC application/msword
      DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document
      HTML text/html
      HTM text/html
      RTF application/rtf
      ODT application/vnd.oasis.opendocument.text
      JPEG image/jpeg
      GIF image/gif
      JPG image/jpeg
      PNG image/png
      PDF application/pdf
      Spreadsheet Feuille de calcul XLS application/vnd.ms-excel
      XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
      HTM text/html
      ODS application/x-vnd.oasis.opendocument.spreadsheet
      CSV text/csv
      TAB text/tab-separated-value
      TSV text/tab-separated-values
      TXT text/plain
      Presentation Présentation PPT application/vnd.ms-powerpoint
      PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation
      PPS application/vnd.ms-powerpoint
      Drawing Dessin WMF application/x-msmetafile
    • Référencer un Document Google existant :

      Cette option vous permet de créer un Document Google Docs à partir d'un document de votre Google Drive.

      Note : Cette option est disponible seulement en mode distribué.

  2. Modèles :

    Cette étape apparaît seulement si vous choisissez de créer un document Google Docs à partir d'un document vierge.

    Un modèle est un document déposé sous une racine de catégorie définie dans la propriété Catégories de modèles. Plusieurs ID de catégories peuvent être fournies.

    googledrive-modal-step2
    Ajouter un document Google Docs - Templates
  3. Participants :

    Cette étape est optionnelle, vous pouvez choisir d'attribuer un niveau d'accès pour les membres. Vous pouvez inviter les membres à :

    • éditer : Les membres de ce niveau d'accès peuvent modifier le document et le partager avec d'autres membres.
    • commenter : Les membres de ce niveau d'accès ne peuvent qu'ajouter des commentaires sur le document (non disponible pour Google tableurs).
    • consulter : Les membres de ce niveau d'accès peuvent uniquement afficher le document.

    Ces membres seront avertis par Alerte. Vous pouvez ajouter un message personnel dans le champ Message.

    googledrive-modal-step3
    Ajouter un document Google Docs - Participants
  4. Informations :

    Cette étape est optionnelle, vous pouvez donner plus de détails à propos du document :

    • Ajouter une description du document,

    • Sélectionner les Catégories,

    • Activer le suivi des lecteurs sur le document.

    googledrive-modal-step4
    Ajouter un document Google Docs - Informations

Editer avec Google Docs

Vous pouvez éditer un document existant dans votre site à partir du menu contextuel ou à partir du template détaillé du document, en cliquant sur le bouton Edit with Google Docs....

Les documents, feuilles de calcul et présentations que vous créez, ainsi que les fichiers que vous importez, sont soumis à des limites. Veuillez vous référer à Google Docs, Sheets, Slides and size limits pour plus d'informations.

Vous pouvez interdire l'édition avec Google Docs en cliquant sur l'icone d'interdiction d'édition prohibit-icon.

googledrive-ctxmenu
Edit with Google Docs - Contextual menu

 

googledrive-editwith
Edit with Google Docs and icon of prohibiting editing

La Visionneuse Google Docs

Après avoir créé un document Google Docs, vous pouvez aller sur le modèle détaillé du document, sur lequel apparaît la Visionneuse Google Docs.

La Visionneuse Google Docs est liée à Google Drive, et les navigateurs pris en charge sont ceux pris en charge par Google Drive. Pour connaître la configuration système requise et les navigateurs pris en charge, veuillez vous référer à System requirements and supported browsers.

googledrive-viewer
Google Docs Viewer

La barre de menu au dessus de la visionneuse propose différentes actions :

  • Plein écran :

    Ouvre le document en mode plein écran.

  • Récupérer :

    Récupère une copie du document et met à jour le Document dans JCMS.

    googledrive-modal-fetch
    Récupérer une copie du document
  • Partager :

    Attribue un niveau d'accès pour les membres. Veuillez vous référer à Comment inviter des participants pour plus d'informations.

  • Ouvrir dans Google Drive :

    Ouvre le document Google Docs directement dans Google Drive.

  • Suivi :

    Chaque membre peut signaler si ses modifications sont terminées sur le document. L'auteur du document peut relancer les membres pour les inviter à terminer leurs modifications.

  • Arrêter l'édition :

    Arrête l'édition avec Google Docs, supprime le document Google Docs dans Google Drive. Vous pouvez télécharger le document Google Docs avant l'arrêt de l'édition pour déposer une nouvelle version du document.

    googledrive-modal-stop
    Arrêter l'Edition Google Docs

La Portlet Google Docs

Vous pouvez ajouter une Portlet qui affiche les documents Google Docs, qui peut être affinée sur :

  • l'Espace de travail courant
  • Le membre courant en tant qu'auteur
  • Les documents partagés avec le membre courant

Note : Vous pouvez aussi ajouter un document Google Docs à partir de la Portlet en cliquant sur le lien 'Ajouter un document Google Docs'.

googledrive-portlet-docs
Portlet Google Docs

La Portlet Google Drive Explorer

Vous pouvez ajouter une Portlet qui affiche le contenu d'un Google Drive.

googledrive-portlet-explorer

Portlet Google Drive Explorer
 

Les fonctionnalités présentes dans la Portlet sont les suivantes : 

  • Rafraîchir le dossier courant : Cela peut être utile lorsqu'une personne fait des modifications directement sur le site web du Drive sans passer par JCMS
  • Créer un nouveau document Google Docs dans le dossier sélectionné de la Portlet
  • Déposer un ou plusieurs fichiers dans le dossier sélectionné de la Portlet
  • Créer un nouveau dossier
  • Renommer un fichier
  • Partager un fichier/dossier
  • Supprimer un ou plusieurs fichiers/dossiers
  • Déplacer des fichiers/dossiers
  • Télécharger un fichier
  • Déposer une nouvelle version d'un fichier

Rechercher des documents d'un Drive

La fonction de recherche présente dans JCMS intègre la recherche de fichiers présents dans le Drive du compte Google courant, selon les priorités définies précédemment.

googledrive-instant-searchgoogledrive-search-full

Wysiwyg : Insérer un lien vers un document d'un Drive

Il est possible d'insérer un lien vers un document présent sur un Google Drive depuis l'éditeur wysiwyg texte riche, en utilisant le menu d'insertion unifiée.

G Suite - Capture d'écran - Illustration de documentation - 14 -- Editeur Wysiwyg - Insertion Google Drive

Wysiwyg : Insérer un lien vers un document Google Drive

FAQ

1. Le message "vous ne semblez pas être connecté à votre compte Google" persiste.

Si le message suivant persiste alors que vous êtes bien connecté à votre compte et que vous avez déjà suivi les 2 liens proposés dans le message :

Vérifiez si module dans votre navigateur empêche l'interrogation du service tiers Google.

Par exemple "Adblock plus" propose un filtre "Fanboy Annoyances List" qui bloque cette vérification.

De manière générale, configurez votre intranet dans la liste blanche de tels outils (bloqueur de pub) afin d'éviter ce genre d'effet collatéraux.

Dans l'exemple présent, si vous souhaitez juste appliquer une règle corrective, nous vous proposons la règle suivante :

@@||accounts.google.com/CheckCookie?

Informations

Version
  • 1.0
Stabilité
  • Stable
Compatibilité
  • JPlatform 10 SP3
Certifié Jalios
  • Oui
Prix
  • Module payant
Support
  • Jalios Support
Auteur
  • Jalios SA
Licence
  • Jalios
Taille
  • 5,15 Mo
Mis-à-jour
  • 22/11/19
Téléchargements
  • 19
Modules nécessaires
OAuth
v 1.2
JServices
v 1.0
JCalendar
v 1.1
JMail
v 1.0