Import et export de fichiers
Convertissez les fichiers Office en snapshots produit, puis les snapshots modifiés en fichiers.
L'importation et l'exportation de fichiers lie les formats de fichiers externes aux modèles de contenu utilisés par Univer. Importe un fichier dans l'instantané de produit correspondant. Exporte un instantané de produit dans le format de sortie choisi.
Du fichier au snapshot
.xlsx, .docx et .pptx sont des paquets OOXML qui détiennent XML et des ressources telles que les images. .xls, .doc et .ppt utilisent des structures binaires plus anciennes. CSV et TSV sont des textes simples. Soumettre le fichier original dans un format pris en charge, et le module de conversion gère le décodage, l'analyse des paquets et la cartographie des ressources.
Un instantané est l'état de contenu d'un produit sous une forme qui peut être sauvegardée et restaurée. Les six schémas d'instantané de produit sont énumérés ci-dessous.
Import : fichier → snapshot
Importer du contenu, des styles et des ressources dans le modèle de produit correspondant, qu'il s'agisse de feuille, de doc, de diapositive, de table relationnelle ou d'un autre produit.
Export : snapshot → fichier
Exporter lit l'instantané actuel du produit et écrit la structure et les ressources du format cible. Un instantané est le modèle de contenu à l'exécution, normalement transféré ou stocké sous JSON.
Pour Sheet, cela signifie calculer les formules, les pivots et les formats de nombres selon la politique sélectionnée, puis mettre à jour l'instantané. Voir calcul côté serveur.
Structures de données Snapshot
Chaque produit définit son propre contrat d'instantané pour les références de contenu et de ressource persistantes, habituellement sous le nom de JSON. L'interface permet de créer des définitions de champ, des types et des exemples.
| Produit | Interface Snapshot | Contenu principal |
|---|---|---|
| Feuilles de calcul (Sheet) | IWorkbookData | Feuilles, cellules, styles partagés et ressources de plugins. |
| Documents (Doc) | IDocumentData | Corps, paragraphes, styles, en-têtes, pieds de page et ressources. |
| Présentations (Slide) | ISlideData | Diapositives, éléments, masques, thèmes et ressources. |
| Table relationnelle (Relational Table) | IBaseSnapshot | Tables, champs, enregistrements, vues et leur ordre. |
| Canevas (Canvases) | IBoardData | Pages, éléments, thèmes et ressources. |
IPdfUnitData | Document source, état des modifications persistantes et liaisons de ressources. |
Appeler save() sur le produit Facade pour obtenir l'instantané courant, puis utiliser l'API de création correspondante pour le restaurer. Le contenu déjà chargé est édité par les API Facade. Pour le PDF, pdf.save() préserve à la fois la base de référence source et editState.
Formats par produit
Les formats Office et table ci-dessous utilisent les itinéraires directs Rust Exchange. PDF utilise son propre module de conversion et est donc listé séparément dans le même tableau.
| Produit | Import / compilation | Export | Portée |
|---|---|---|---|
| Feuilles de calcul (Sheet) | .xls, .xlsx, .csv, .tsv | .xlsx, .csv, .tsv | CSV/TSV contient une feuille de travail. |
| Documents (Doc) | .doc, .docx | .docx | L'héritage des importations DOC dans le modèle Docs. La sortie est DOCX. |
| Présentations (Slide) | .ppt, .pptx | .pptx | Legs PPT importe dans le modèle de diapositives. La sortie est PPTX. |
| Table relationnelle (Relational Table) | .xls, .xlsx, .csv, .tsv | .xlsx, .csv, .tsv | CSV/TSV tient une table. XLSX prend en charge la cartographie de table et de champ. |
| Canevas (Canvases) | Mermaid (.mmd / texte source) | .pptx | Mermaid produit un avant-projet d'importation, qui est appliqué à travers la Façade Canvas avant qu'un instantané soit enregistré. PPTX exporte la page active. |
.pdf | .pdf | Nécessite le service de conversion PDF, qui est séparé de l'ICL Rust Exchange. |
.xls,.docet.pptsont des formats d'importation. Leurs formats de sortie sont respectivement.xlsx,.docxet.pptx.- Une exportation CSV/TSV contient une feuille de travail ou une table de table Relationnelle. Sauvegardez l'instantané du produit lorsque le modèle de contenu complet et ses ressources sont nécessaires.
- Différents points d'entrée SDK acceptent différentes extensions. Pour les formats tels que
.xlsm,.pptmet.ppsx.ppsmou.potx, vérifiez le moteur déployé et l'API du navigateur. Ce ne sont pas des noms de formats Rust CLI directs supplémentaires.
Calcul pendant la conversion
Pour les flux de travail de conversion pris en charge, la conversion de fichiers peut être combinée avec le calcul côté serveur:
- La formule de calcul remplit les résultats caches manquants lors de l'importation, ou recalcule avant l'exportation selon la politique sélectionnée.
- Le calcul du pivot dérive du regroupement et de l'agrégation des données sources et de la configuration du pivot, puis matérialise les résultats pour l'instantané ou le cahier de travail exporté.
- Le calcul au format numérique transforme les valeurs en date, en pourcentage, en monnaie et en autre texte d'affichage formaté. Les exportations CSV/TSV peuvent écrire des valeurs d'affichage ou des valeurs brutes.
Consultez Headless et calcul serveur pour le traitement de contenu associé.
Intégration
La conversion de fichier appartient au Server SDK. L'application fournit les paramètres de téléchargement, de traitement des tâches, de stockage et de téléchargement. La conversion de snapshot peut se faire sans collaboration. Exporter un document partagé lit une révision confirmée après que les modifications en attente ont synchronisé.
Commencez par Intégration de la conversion et Conversion Node.js.
Utilisez la liste des caractéristiques de chaque produit et les fichiers d'affaires réels pour vérifier les formules, les images, les styles et la mise en page par l'importation, l'édition et l'exportation.
Que pensez-vous de ce guide ?