Module Office 365 2.0
Description
Le module Office 365 permet aux utilisateurs de partager et de co-éditer des documents MS Office directement dans un site JPlatform.
Les utilisateurs peuvent démarrer la co-édition à partir de:
- un document vierge
- Un document créé à partir d'un modèle de document disponible sur le site
- Un document créé à partir d'un document MS Office déposé à partir de l'ordinateur de l'utilisateur
Les utilisateurs peuvent modifier le document en ligne ou avec les applications MS Office (Word, PowerPoint, Excel).
Les utilisateurs peuvent également naviguer dans leurs fichiers OneDrive par la portlet Office 365 Explorer. Cette portlet offre plusieurs fonctionnalités pour travailler sur des fichiers: télécharger, téléchargement, partage, création de dossier, ...
Ce module nécessite l'installation de la version 1.2 ou plus du module OAuth .
Captures d'écran
Installation
Ce module nécessite l'installation de la version 1.2 ou plus du module OAuth.
Configuration OAuth dans Azure AD
Pour pouvoir intéragir avec les documents stockés dans Office 365, il est nécessaire d'indiquer à Office 365 que notre application web souhaite y accéder. Pour cela, il est nécessaire de configurer l'authentification OAuth dans Azure Active Directory.
Vous pouvez suivre les documentations suivantes qui explique comment registrer votre application web :
http://graph.microsoft.io/docs/authorization/associate_account
https://dev.onedrive.com/app-registration.htm
Pour accéder à Azure AD, veuillez aller dans le menu d'Office 365 en haut à gauche puis sur Admin :
Dans le centre d'administration, cliquez sur "Azure AD" se trouvant dans la section "ADMINISTRATEUR" :
Quand vous arrivez dans Azure AD, vous devez créer un Annuaire. Pour cela, cliquez sur "NOUVEAU" en bas à gauche et remplissez les champs du formulaire :
Après cela, vous devez créer une application dans l'annuaire. Pour faire cela, allez dans l'annuaire que vous avez créé précédemment, puis cliquez sur "APPLICATIONS". Cliquez ensuite sur "AJOUTER" en bas de la page :
l'URL DE CONNEXION doit être du type
http(s)://www.mywebsite.com[:port]/[WEBAPP]/plugins/Office365Plugin/jsp/oauth/doAuth.jsp
Une fois l'application créée, cliquez dessus puis sur "CONFIGURER" :
Vous devez ajouter des autorisations pour d'autres Applications. Pour cela, cliquez sur "Ajouter une application", sélectionnez l'application dans la colonne de gauche. Elle est ensuite ajouter à la colonne de droite, puis validez. Une fois l'application ajoutée à la liste, vous devez cocher des "Autorisations d'application" et des "Autorisations déléguées" :
APPLICATIONS | AUTORISATIONS D'APPLICATION | AUTORISATIONS DELEGUEES |
---|---|---|
Office 365 Management APIs |
|
|
Office 365 SharePoint Online |
|
|
Windows Azure Active Driectory |
|
Ces autorisations peuvent être amenées à changer dans de futures mises à jour du module.
PENSEZ A REMPLIR LA SECTION "CLES" EN SELECTIONNANT PAR EXEMPLE "2 ANS"
Cliquez ensuite sur "ENREGISTRER" en bas de la page.
Après l'enregistrement :
- Recopiez la clé qui apparaît dans la section "Clés". Ne perdez pas cette clé car celle-ci sera nécessaire à la configuration du module Office 365.
- Recopiez l'ID Client nécessaire également à la configuration du module Office 365
Configuration du module Office 365
Allez dans l'administration du module, et entrez les 2 clés précédentes dans leur champ respectif.
Il est possible de configurer une catégorie racine qui sera utilisé pour le stockage des modèles de document.
Pensez à activer le type de Document que vous avez choisi dans l'espace où vous souhaitez utiliser le module Office 365.
Connexion d'un membre à Office 365
Allez dans l'édition de profil d'un membre, puis cliquez sur l'onglet "Identifiant d'accès".
Cliquez ensuite sur "Se connecter à Office 365". Dans la fenêtre qui s'ouvre, vous autorisez les droits demandés.
La fenêtre se ferme. Vous êtes à présent connecté.
Création d'un document Office
Pour créer un nouveau document, cliquez sur le menu "Ajouter" de la topbar, puis "Documents", puis "Un document Office365"
Vous pouvez créer soit un nouveau document vierge soit un nouveau document à partir d'un document local.
Suivez les étapes de la modale, puis cliquez sur "Terminer".
La modale se ferme après le temps de traitement puis vous êtes redirigé vers votre nouveau document Office 365 :
A partir de là, un document présent sur Office 365 est alors lié à un document présent sur votre site. Vous voyez alors la visionneuse Office 365.
il est donc possible de :
- Modifier le document directement en ligne ou en passant par l'un de vos logiciels Office (Word, Excel, Powerpoint) présent sur votre poste
- Partager le document en édition ou en consultation avec d'autres membres
- Récupérer le contenu du document présent sur Office 365 afin de mettre à jour le Document lié sur votre site
- Arrêter l'édition : cela aura pour conséquence de supprimer le document Office 365, vous ne verrez alors plus la visionneuse sur votre site. Lors de l'arrêt de l'édition, il est possible de demander la récupération avant l'arrêt de manière à mettre à jour le document présent sur votre site.
Création d'un document Office à partir d'un FileDocument
Il est possible de créer un document Office à partir d'un document (Word, Excel ou Powerpoint) déjà présent sur votre site.
Pour cela, il faut aller sur la page présentant le document, puis dans le menu de droite cliquer sur "Editer avec Office 365"
Après avoir cliqué, une modale de confirmation s'ouvre. Après avoir confirmé, la modale se ferme après le temps de traitement puis vous êtes redirigé vers votre nouveau document Office 365.
La portlet Explorateur
Une fois ajoutée à votre portail, cette portlet vous permet de :
- Naviguer dans votre espace Office 365
- Créer, renommer, supprimers des répertoires
- Déposer de nouveaux documents
- Rechercher dans votre espace Office 365