Intégration de l’échange de fichiers

Pour ouvrir un fichier Excel dans Univer, convertissez-le en données lisibles par l’éditeur. À l’export, reconvertissez les données modifiées en Excel. Le module serveur @univerjs-pro/exchange-node assure la conversion ; le navigateur téléverse, ouvre les documents et télécharge les résultats.

Sans édition collaborative

Par exemple, l’utilisateur téléverse un fichier Excel, le modifie dans la page et télécharge le résultat en Excel.

1. Le navigateur téléverse le fichier ; le serveur le convertit en données Univer et les renvoie.
2. Le navigateur ouvre un classeur avec ces données pour l’édition.
3. À l’export, le navigateur envoie les données modifiées au serveur, qui génère le fichier Excel.

Aucun service collaboratif n’est nécessaire. L’« instantané » des API navigateur désigne ces données documentaires. Son import-export exige toujours une conversion serveur. Pour sauvegarder le travail et le reprendre plus tard, votre application doit aussi stocker ces données.

Consultez Import-export de fichiers Office pour installer et utiliser le module. Commencez également là pour un simple traitement de fichiers dans Node.js.

Avec édition collaborative

Par exemple, l’utilisateur importe un Excel, partage le document avec ses collègues, le modifie avec eux et l’exporte ensuite.

1. Le serveur convertit le fichier téléversé et enregistre le résultat comme document collaboratif.
2. Il renvoie un ID que le navigateur ouvre ; les autres utilisateurs rejoignent ce même ID.
3. À l’export, le serveur lit le dernier contenu et génère le fichier Excel à télécharger.

Le unitId des API navigateur correspond à cet ID. Terminez d’abord l’intégration collaborative, puis exécutez l’exemple Exchange. Étudiez ensemble son code navigateur, serveur et conversion.

Attendez la synchronisation des modifications avant d’exporter, sinon les changements récents peuvent manquer. Consultez la section Office Exchange côté serveur des modules d’extension pour lire et convertir les documents collaboratifs.

Connecter les boutons d’import-export

Une fois la conversion serveur fonctionnelle, connectez-la à la page :

• Menus Univer ou API Facade : suivez l’exemple Exchange pour implémenter téléversement, conversion, suivi des tâches et téléchargement, puis configurez les plugins navigateur. Adresses et formats de réponse doivent correspondre.
• Vos propres boutons : appelez vos API applicatives. Après import, ouvrez les données ou l’ID renvoyés ; après export, téléchargez le fichier généré.

La configuration navigateur figure dans Sheets, Docs, Slides, Boards, Bases et PDFs. L’exemple collaboratif utilise Sheets. Pour les autres produits, consultez Import-export Office et les formats de votre version.

Vérifier l’intégration

Importez un vrai fichier métier, modifiez-le, puis exportez-le. Ouvrez le résultat dans une application Office et vérifiez changements, formules, images et disposition. En collaboration, vérifiez aussi l’ouverture par d’autres utilisateurs et la conservation après redémarrage serveur.

Avant déploiement, remplacez les fichiers temporaires et tâches en mémoire par du stockage applicatif, limitez les tailles et gérez échecs et délais de conversion. Téléversements, suivi des tâches et téléchargements nécessitent des contrôles d’accès ; consultez Identité et autorisation.