- Accueil
- Connecteurs
- Alfresco Content App
Alfresco Content App
À propos de l'intégration ONLYOFFICE et Alfresco Content App
ONLYOFFICE propose une intégration officielle qui apporte l'édition et la collaboration documentaires directement dans Alfresco Content App (ACA), l'interface moderne basée sur Angular pour Alfresco Content Services. Vous pouvez télécharger le paquet d'intégration depuis le registre npm ou la page GitHub de ONLYOFFICE.
Remarque : cette intégration concerne spécifiquement Alfresco Content App. Si vous utilisez Alfresco Share, consultez plutôt l'article Connecteur ONLYOFFICE pour Alfresco Share.
Fonctionnalités principales
- Créer, modifier et afficher des documents texte, des feuilles de calcul et des présentations.
- Créer et remplir des formulaires PDF remplissables.
- Coéditer des documents en temps réel : deux modes de coédition (Rapide et Strict), le mode Suivi des modifications, les commentaires et le chat intégré.
- Suivre l'historique des versions du document directement depuis l'interface de l'éditeur.
- Convertir les fichiers aux formats OOXML et les exporter vers différents formats.
- Gérer les autorisations d'accès aux documents depuis l'interface d'édition.
- Actions avancées de l'éditeur : insérer des images depuis Alfresco, joindre des fichiers pour la fusion et publipostage, sélectionner des documents à comparer, utiliser des modules complémentaires, insérer des données à partir de liens externes, accéder au dossier du fichier en cours et créer des documents depuis l'éditeur.
- Prise en charge du JWT pour sécuriser votre trafic afin que personne ne puisse accéder à vos documents, hormis les utilisateurs disposant des droits appropriés.
Formats pris en charge
- Pour l'édition : DOCX, XLSX, PPTX
- Pour l'affichage : DOCX, XLSX, PPTX, PDF et autres formats bureautiques
- Pour la création : DOCX, XLSX, PPTX, formulaires PDF
- Pour la conversion : formats bureautiques vers OOXML
- Pour l'export : différents formats selon la configuration du backend
Remarque : la liste exacte des formats disponibles pour l'édition, l'affichage, la conversion et l'export peut varier selon la version installée et la configuration du backend.
Nouveautés de la version 1.0.0
Première version de l'intégration ONLYOFFICE pour Alfresco Content App.
Le journal des modifications complet est disponible ici.
Connexion de ONLYOFFICE Docs à Alfresco Content App
Prérequis
- Alfresco Content Services, le backend du référentiel Alfresco.
- Alfresco Content App (ACA), l'application Angular hôte.
-
ONLYOFFICE Docs (version serveur ou cloud) accessible et connectable à la fois depuis ACA et depuis les clients finaux.
Consultez la page de documentation officielle pour en savoir plus sur l'installation de ONLYOFFICE Docs.
- Package du module ONLYOFFICE pour Alfresco version 8.3.0 ou ultérieure.
- Intégration ONLYOFFICE pour Alfresco Content App v1.0.0 ou ultérieure.
Installation de l'intégration ONLYOFFICE pour Alfresco Content App
-
Installez le paqauet de l'extension :
npm install @onlyoffice/alfresco-extension - Enregistrez l'extension dans votre projet ACA.
-
Lancez l'application :
npm run start
Pour obtenir des instructions détaillées d'installation et de configuration, consultez la documentation du projet.
Activation du JWT pour l'intégration ONLYOFFICE et Alfresco Content App
Pour protéger les documents contre tout accès non autorisé, les éditeurs ONLYOFFICE utilisent le JSON Web Token (JWT). Le token est ajouté dans la configuration lors de l'initialisation de l'Éditeur de documents et lors de l'échange de commandes entre les services internes de ONLYOFFICE Docs. La clé secrète sert à signer le jeton web JSON et à le valider lors de la requête adressée à ONLYOFFICE Docs.
À partir de ONLYOFFICE Docs v7.2, le JWT est activé par défaut et la clé secrète est générée automatiquement. Vous devez retrouver votre clé secrète dans le fichier de configuration de ONLYOFFICE Docs, ensuite indiquer la même clé secrète dans les paramètres d'intégration.
Étape 1 : retrouvez votre clé secrète dans le fichier de configuration de ONLYOFFICE Docs
-
Ouvrez le fichier local.json avec n'importe quel éditeur de texte disponible.
- Pour Linux —
/etc/onlyoffice/documentserver/local.json - Pour Windows —
%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json - Pour Docker — accédez au conteneur ONLYOFFICE Docs à l'aide de la commande
docker exec -it <containerID> bash, ensuite ouvrez/etc/onlyoffice/documentserver/local.json
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" } } } } } - Pour Linux —
-
La valeur
trueest indiquée dans trois sections, ce qui signifie que la validation du token est activée :services.CoAuthoring.token.enable.browserservices.CoAuthoring.token.enable.request.inboxservices.CoAuthoring.token.enable.request.outbox
-
La clé secrète générée automatiquement est indiquée dans trois sections. Vous pouvez remplacer la valeur secrète par défaut par la vôtre. La clé secrète doit être identique dans les trois sections :
services.CoAuthoring.secret.inbox.stringservices.CoAuthoring.secret.outbox.stringservices.CoAuthoring.secret.session.string
-
Si vous apportez des modifications, enregistrez-les et redémarrez les services pour que les changements de configuration prennent effet :
supervisorctl restart all
Étape 2 : indiquez la même clé secrète dans les paramètres d'intégration
Dans les paramètres d'intégration, indiquez la même clé secrète dans le champ Clé secrète et enregistrez les paramètres.
Commencer à utiliser ONLYOFFICE Docs dans Alfresco Content App
Après l'installation, de nouvelles opérations ONLYOFFICE deviennent disponibles directement dans l'interface d'Alfresco Content App.
Pour modifier un document :
- Faites un clic droit sur un fichier pris en charge dans l'interface ACA.
- Choisissez Modifier dans ONLYOFFICE pour ouvrir le fichier dans l'éditeur.
Pour afficher un document :
- Faites un clic droit sur le fichier.
- Choisissez Afficher dans ONLYOFFICE pour ouvrir un aperçu en lecture seule sans télécharger le fichier.
Pour créer un fichier :
- Utilisez l'option Créer dans ONLYOFFICE dans l'interface ACA.
- Sélectionnez le type de fichier à créer : Document, Feuille de calcul, Présentation ou Formulaire PDF.
- Le nouveau fichier s'ouvre immédiatement pour l'édition.
Pour convertir un fichier au format OOXML :
- Sélectionnez le fichier dans ACA.
- Cliquez sur Convertir dans ONLYOFFICE.
Pour exporter un fichier dans un autre format :
- Sélectionnez le fichier dans ACA.
- Utilisez Télécharger comme et choisissez le format souhaité sans quitter Alfresco Content App.
Pour en savoir plus sur les formulaires, consultez les articles correspondants sur la création et le remplissage des formulaires.