SharePoint

Apprendre à intégrer ONLYOFFICE Docs dans la plateforme collaborative SharePoint à l'aide du connecteur disponible sur la page ONLYOFFICE sur GitHub.

À propos de l'intégration ONLYOFFICE et SharePoint

Pour modifier vos documents au sein de la plateforme collaborative SharePoint vous pouvez Intégrer ONLYOFFICE Docs à la bibliothèque de documents à l'aide du connecteur officiel ONLYOFFICE ou en utilisant WOPI. Pour en savoir plus, veuillez visiter la page du connecteur ONLYOFFICE à SharePoint sur GitHub. Le connecteur est rendu accessible sous la licence AGPL-3.0.

Pour en savoir plus sur le fonctionnement du connecteur ONLYOFFICE pour SharePoint, veuillez consulter notre documentation API .

Méthodes de connexion

Il y a deux façons de connecter ONLYOFFICE Docs à SharePoint: connecteur officiel ou WOPI. Tous les deux méthodes permettent de modifier des documents directement dans SharePoint, mais les fonctionnalités et les formats pris en charge varient.

Avertissement Nous vous recommandons vivement de ne choisir qu'une seule méthode d'installation. Si l'installation est effectuée à l'aide des deux méthodes, les fonctionnalités collaboratives et l'enregistrement des documents risquent de ne pas fonctionner correctement.

Comparaison des fonctionnalités

Fonctionnalité	Connecteur officiel	WOPI
Édition des documents depuis le menu contextuel / ruban	✓ (Ouvrir avec ONLYOFFICE)	✓ (Cliquez sur fichier / Menu contextuel → Ouvrir → Ouvrir dans le bureau en ligne)
Mode de collaboration Rapide	✓	✓
Mode de collaboration Strict	✓	✗ ¹
Suivi des modifications	✓	✗
Commentaires, chat intégré	✓	✓
Historique des versions	✗	✗
Publipostage	✓	✓
Insérer l'image à partir de l'espace de stockage	✗	✗
Comparer des documents	✓	✗

¹ Le mode de collaboration Strict peut avoir un impact négatif sur le paramètre du jeton d'accès lors de l'utilisation de WOPI.

ImportantLors de l'utilisation de WOPI, les jetons d'accès expirent après une certaine période. Définissez 10 heures pour la propriété access_token_ttl pour le mode de collaboration Rapide.

Formats pris en charge

Connecteur officiel

Afficher et modifier: DOCM, DOCX, DOTM, DOTX, PDF, POTM, POTX, PPSM, PPSX, PPTM, PPTX, XLSB, XLSM, XLSX, XLTM, XLTX
En lecture seule: CSV, DJVU, DOC, DOT, DPS, DPT, EPUB, ET, ETT, FB2, FODP, FODS, FODT, HML, HTM, HTML, HWP, HWPX, KEY, MD, MHT, MHTML, NUMBERS, ODG, ODT, ODP, ODS, OTT, OTP, OXPS, PAGES, POT, PPS, PPT, RTF, STW, SXC, SXI, SXW, TXT, VSDM, VSDX, VSSM, VSSX, VSTM, VSTX, WPS, WPT, XLS, XLT, XML, XPS

WOPI:

Afficher et modifier: DOCX, XLSX, PPTX, DOCM, XLSM, PPTM, ODT, ODS, ODP, CSV, PDF
En lecture seule: DJVU, XPS

Les formats disponibles varient selon la version d'ONLYOFFICE Docs et le mode de connexion sélectionné.

Toutes les nouveautés de la version 3.1.0

Fonctionnalités modifiées

Nouveaux formats pris en charge

Le journal des modifications complet est disponible ici.

Connecteur officiel

Exigences

ONLYOFFICE Document Server v7.1 (version serveur ou cloud) ou version ultérieure. L'instance doit être accessible à la fois depuis SharePoint et depuis n'importe quel client final, et doit pouvoir envoyer des requêtes POST directement à SharePoint. Veuillez consulter la documentation officielle pour en savoir plus sur l'installation d'ONLYOFFICE Docs.
SharePoint 2019
Connecteur ONLYOFFICE 3.1.0 pour SharePoint

Installer et configurer

La solution d'intégration ONLYOFFICE SharePoint est le connecteur officiel ONLYOFFICE disponible sur la page GitHub sous la Licence GNU AGPL v.3.

Pour en savoir plus sur le fonctionnement et la compilation de la solution , veuillez consulter notre documentation API .

Cliquez sur Démarrer, passez à All Programs (Tous les programmes), passez à Administrative Tools (Outils administratifs), ensuite cliquez sur Services et vérifiez si le service Administration de SharePoint est démarré.
Cliquez sur Start (Démarrer), ouvrez SharePoint Management Shell et passez au répertoire comportant le fichier .wsp.
Exécutez le script Install.ps1 script:
```
PS> .\Install.ps1
```
Saisissez l'adresse de votre site SharePoint:
```
https://<yoursharepointsite>
```
Pour sauter les étapes 3 et 4, saisissez la commande suivante:
```
Add-SPSolution -LiteralPath<solutionpath>/onlyoffice.wsp
```
Sur la page d'accueil SharePoint Central Administration (Administration centrale de SharePoint), cliquez sur System Settings > Farm Management > Manage farm solutions. (Paramètres de système > Gestion de batterie > Solutions de gestion de la batterie). Sur la page Solution Management (Gestion de la solution), cliquez sur onlyoffice.wsp, ensuite cliquez sur Deploy Solution (Déployer la solution).
Sur la page d'accueil SharePoint Central Administration (Administration centrale de SharePoint), cliquez sur Application Management (Gérer les applications) au-dessous de Manage web applications (Gestion des applications).
Assurez-vous que vous sélectionnez votre site et cliquez sur l'icône Authentication Providers (Fournisseurs d'authentification).
Dans la fenêtre Authentication Providers (Fournisseurs d'authentification), cliquez sur Default zone (Zone par défaut).
Au-dessous de l'option Edit Authentication (Modifier l'authentification), activez Enable anonymous access (Activer l'accès anonyme) et cliquez sur Save (Enregistrer).
Revenez à Web Application Management (Gérer les applications web) et cliquez sur l'icône Anonymous Policy (Stratégie anonyme).
Au-dessous de Anonymous Access Restrictions (Restrictions d'accès anonyme) sélectionnez votre Zone et saisissez l'option Permissions to None – No policy (Aucune permission - Pas de stratégie) et cliquez sur Save (Enregistrer).
Dans SharePoint, accédez à la page he /\_layouts/15/Onlyoffice/Settings.aspx comportant les paramètres d'administration. Saisissez l'adresse suivante:
```
https://<documentserver>/
```
Où documentserver est le nom du serveur sur lequel ONLYOFFICE Docs est installé. L'adresse doit être accessible au navigateur de l'utilisateur et à partir du serveur SharePoint. L'adresse du serveur SharePoint doit également être accessible depuis ONLYOFFICE Docs pour un bon fonctionnement.

Lorsque l'architecture de votre SharePoint est construite à l'aide de sous-sites, il vous faut également configurer, la connexion de ONLYOFFICE Docs à chaque sous-site pour un bon fonctionnement. Accédez aux paramètres de chaque sous-site et saisissez l'adresse de Docs dans le champ approprié.

À partir de la version v.7.2 d'ONLYOFFICE Docs, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut également activer la validation du jeton du côté SharePoint: recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète sur la page comportant les paramètres d'administration de SharePoint. Pour en savoir plus, consulter la section Configurer le jeton JWT ci-après.

Lorsque la protection du JWT est activé, il faut indiquer l'en-tête personnalisé puisque les en-têtes externes Autorisation sont bloqués par SharePoint. Les paramètres de l'en-tête doivent être également fourni dans la signature ONLYOFFICE Docs (pour plus d'informations, cliquez ici).

Compiler la solution

Il y a de façons de compiler la solution d'intégration ONLYOFFICE SharePoint:

Utilisant MS Visual Studio:
1. Accédez au serveur SharePoint et ouvrez ce projet dans Visual Studio.
2. Dans Solution Explorer (Explorateur de solutions), ouvrez le menu contextuel du projet et ensuite sélectionnez Publish (Publier).
3. Dans la boîte de dialogue Publish (Publier), choisissez l'option Publish to File System (Publier dans le système de fichiers).
4. Cliquez sur le bouton Publish (Publier). Une fois la publication terminée, le fichier .wsp sera créé.
5. Copiez le fichier résultant et le fichier Install.ps1 vers le dossier (dossier BuildAndInstall par défaut).
Utilisant le fichier build.bat :
1. Passez au dossier BuildAndInstall.
2. Lancez le fichier build.bat.
3. La solution résultante .wsp sera créée et placée dans le dossier BuildAndInstall.

Comment cela fonctionne

L'intégration ONLYOFFICE suit l'API disponible ici.

L'utilisateur accède au document au sein de SharePoint et sélectionne Edit in ONLYOFFICE (Modifier dans ONLYOFFICE) dans le menu contextuel ou dans le ruban.
SharePoint envoie une requête vers la page d'éditeur (l'URL du formulaire: /\_layouts/15/Onlyoffice/editorPage.aspx?SPListItemId={ItemId}&SPListURLDir={ListUrlDir}&action=track).
SharePoint prépare un objet JSON ayant les caractéristiques suivantes:
- url - l'adresse URL utilisée par ONLYOFFICE Docs pour télécharger le document;
- callbackUrl - l'adresse URL utilisée par ONLYOFFICE Docs pour informer sur l'état de l'édition du document;
- DocumentSeverHost - l'adresse URL envoyée par le client au service de documents ONLYOFFICE (peut être configuré sur la page de configuration);
- Key— l'identifiant du fichier depuis SharePoint;
- FileName— le titre du document (nom);
- CurrentUserId— l'identificateur d'utilisateur;
- CurrentUserName— le nom d'utilisateur.
SharePoint construit une page et remplit toutes les valeurs pour que le navigateur du client puisse télécharger l'éditeur.
Le navigateur du client envoie une demande vers la bibliothèque JavaScript depuis ONLYOFFICE Docs et la configuration DocEditor vers ONLYOFFICE Docs avec les caractéristiques ci-dessous.
Ensuite, ONLYOFFICE Docs charge le document depuis SharePoint et l'utilisateur commence l'édition.
Lorsque tous les utilisateurs et les navigateurs clients ont terminé la rédaction, la fenêtre d'édition est fermée.
Après 10 secondes d'inactivité, ONLYOFFICE Docs envoie une requête POST vers callbackUrl pour notifier la solution SharePoint ONLYOFFICE que tous les clients ont terminé l'édition et ont fermé le document.
SharePoint télécharge la nouvelle version du document qui remplace la version ancienne.

Pour en savoir plus sur les problèmes les plus courants et les solutions à y apporter, veuillez consulter notre guide de dépannage.

Activer JWT

Afin de protéger des documents contre un accès non autorisé, les éditeurs ONLYOFFICE utilisent le jeton JSON (JWT). Le jeton est ajouté à la configuration lorsque l'éditeur de documents est initialisé et l'échange de commandes entre les services internes de ONLYOFFICE Docs est effectué. La clé secrète est utilisée pour signer le jeton web JSON et valider le jeton sur demande à ONLYOFFICE Docs.

À partir de la version v.7.2 d'ONLYOFFICE Docs, JWT est activé par défaut et la clé secrète est générée automatiquement. Il vous faut rechercher votre clé secrète dans le fichier de configuration ONLYOFFICE Docs, ensuite indiquez la même clé secrète dans les paramètres du connecteur.

Étape 1. Recherchez votre clé secrète dans le fichier de configuration ONLYOFFICE Docs

Ouvrez le fichier local.json avec tout éditeur de texte disponible:

Sous Linux: /etc/onlyoffice/documentserver/local.json
Sous Windows: %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

Sous Docker: accédez au conteneur ONLYOFFICE Docs utilisant docker exec -it <containerID> bash et ouvrez /etc/onlyoffice/documentserver/local.json. Ou exécutez:

sudo docker exec <containerID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

Le fichier local .json doit ressembler à ceci:

{"services": {"CoAuthoring": {"token": {"enable": {"request": {"inbox": true,"outbox": true},"browser": true}},"secret": {"inbox": {"string": "yoursecret"},"outbox": {"string": "yoursecret"},"session": {"string": "yoursecret"}}}}}

La valeurtrue est spécifiée dans trois sections, ce qui signifie que la validation du jeton est activée:
- services.CoAuthoring.token.enable.browser
- services.CoAuthoring.token.enable.request.inbox
- services.CoAuthoring.token.enable.request.outbox
La clé secrète qui a été généré automatiquement figure dans trois sections. Vous pouvez remplacer la valeur par défaut par votre propre clé — celle-ci doit être identique dans les trois sections:
- services.CoAuthoring.secret.inbox.string
- services.CoAuthoring.secret.outbox.string
- services.CoAuthoring.secret.session.string
Si vous apportez des modifications, enregistrez-les et redémarrez les services:
```
supervisorctl restart all
```

Étape 2. Indiquez la même clé secrète dans la configuration du connecteur.

Dans la configuration du connecteur, indiquez la même clé secrète dans le champ Secret key (Clé secrète) et enregistrez les paramètres.

WOPI

Il est possible également de connecter ONLYOFFICE Docs à SharePoint à l'aide de WOPI - un protocole basé sur REST qui envoie les demandes HTTP vers un ensemble de points de terminaison REST lorsqu'un client établie une connexion au serveur contenant vos données.

Limites

La connexion d'ONLYOFFICE Docs via WOPI manque de certaines fonctions compte tenu de l'architecture de WOPI:

La fonction Historique des versions n'est pas pris en charge.
L'insertion des images à partir de votre stockage n'est pas pris en charge.
La comparaison des documents n'est pas pris en charge.
Les formats suivants ne sont pas pros en charge: DOC, XLS, PPT.

Exigences

ONLYOFFICE Document Server v7.1 ou version ultérieure et WOPI activé. Suivez les instructions pour activer WOPI.
SharePoint 2019

Connecter à l'aide de WOPI

Ouvrez votre serveur SharePoint. Démarrez la console SharePoint Management Shell (Shell de gestion SharePoint) et définissez la zone nécessaire WOPI:
```
Set-SPWOPIZone -Zone "external-http"
```
Le paramètre par défaut de documentserver est external-http.
Vérifiez s'il y a des liaisons de WOPI avec d'autres types de documents sur la batterie actuelle:
```
Get-SPWOPIBinding
```
Le cas échéant, supprimez ces liasons:
```
Remove-SPWOPIBinding -All:$true
```
Créez de nouvelles liaisons pour les actions par défaut en fonction des types de fichiers.
Pour créer des liaisons pour tous les types de fichiers à la fois:
```
New-SPWOPIBinding -ServerName ip_or_domain.com:port
```
Pour créer des liaisons uniquement pour certains types de fichiers:
```
New-SPWOPIBinding -ServerName ip_or_domain.com:port -Extension DOCX
```
Lorsque SSL n'est pas utilisé, ajoutez -AllowHTTP à la fin de la commande.

Créer un nouveau document

Important Les instructions suivantes s'appliquent uniquement à la méthode de connexion WOPI.

Pour pouvoir créer de nouveaux documents, il faut configurer les paramètres ci-dessous. Cet exemple concerne uniquement les fichiers DOCX, mais vous pouvez ajouter les fichiers XLSX, PPTX et d'autres fichiers de la même façon.

Activez l'option Allow management of content types (Autoriser la gestion du contenu): passez à Documents → Library settings → Advanced settings (Documents → Paramètres de bibliothèque → Paramètres avancés). Dans la section Allow management of content types (Autoriser la gestion du contenu), sélectionnez Yes (Oui) et cliquez sur OK.
Dans la bibliothèque Documents, passez à Site contents → Site Settings → Site content types (Contenu du site → Paramètres du site → Types du contenu sur site). Cliquez sur Créer. Remplissez le formulaire: Nom (Nouveau document), Description. Dans Parent Content type (Type de contenu parent), sélectionnez Document content types, Document. (Types de contenu des documents, Documents). Dans Existing group (Groupe existant), sélectionnez Custom Content Types (Types de contenu personnalisés) et cliquez sur OK.
Dans la bibliothèque Documents, passez à Site contents → Site Settings → Site content types (Contenu du site → Paramètres du site → Types du contenu sur site). Sélectionnez le Nouveau document que vous venez d'ajouter. Passez à Advanced settings → Document Template → Upload a new document template (Paramètres avancés → Modèle de document → Télécharger un nouveau modèle de document). Cliquez sur le bouton Choose File (Choisir un fichier), téléchargez le document nécessaire et cliquez sur OK.
Passez à la bibliothèque Documents→ Library settings (Documents - Paramètres de la bibliothèque). Dans la section Content Types (Types de contenu), sélectionnez l'option Add from existing site content types. (Ajouter des type de contenu de site existants). Dans la liste Select site content types from (Sélectionner les type de contenu de site depuis), sélectionnez Custom content types. (Types de contenu personnalisées). Dans le champ Available Site Content Types (Types de contenu de site disponibles), sélectionnez New document (Nouveau document). Cliquez sur le bouton Add > (Ajouter), ensuite cliquez sur OK.
Dans la bibliothèque Documents, actualisez la page et appuyez sur le bouton New (Nouveau).
Le type Document content (Contenu de documents) sera ajouté automatiquement en tant que contenu parent. Il faut masquer celui-ci: passez à la bibliothèque Documents→ Library settings (Documents - Paramètres de la bibliothèque). Dans la section Content Types (Types de contenu), sélectionnez Change new button order and default content type (Modifier l'ordre de nouveaux boutons et le type de contenu par défaut).

Dans la colonne Visible, désactivez l'option Document content type (Type de contenu des documents) et cliquez sur OK.
Dans la bibliothèque Documents, actualisez la page et appuyez sur le bouton New (Nouveau) – c'est uniquement l'élément de menu New document (Nouveau document) qui sera disponible.