Importación y exportación de archivos

Convierte archivos Office en snapshots de producto y los snapshots editados en archivos.

Importar archivos y exportar enlaces de archivos externos a los modelos de contenido que Univer utiliza. Importar analiza un archivo en la instantánea correspondiente del producto. Exportar serializa una instantánea de producto en el formato de salida elegido.

Del archivo al snapshot

Los archivos de la oficina caen en dos grupos. .xlsx, .docx, y .pptx son paquetes OOXML que contienen XML y recursos como imágenes. .xls, .doc, y .ppt utilizan estructuras binarias antiguas. CSV y TSV son texto simple. Presentar el archivo original en un formato compatible, y el módulo de conversión maneja decodificación, persiguiendo paquetes y mapeo de recursos.

Una instantánea es el estado de contenido de un producto en un formulario que se puede guardar y restaurar. Los seis esquemas de instantáneas de producto se enumeran a continuación.

Importación: archivo → snapshot

Importar el contenido, los estilos y los recursos en el modelo de producto que coincida, ya sea Hoja, Doc, Diapositiva, Tabla Relacional, u otro producto.

100%

Exportación: snapshot → archivo

Exportar lee la instantánea del producto actual y escribe la estructura y los recursos del formato objetivo. Una instantánea es el modelo de contenido en tiempo de ejecución, normalmente transferido o almacenado como JSON.

100%

Para Sheet, esto significa calcular fórmulas, pivotes y formatos de números según la política seleccionada, luego actualizar la instantánea. Ver cálculo lado del servidor.

Estructuras de datos Snapshot

Cada producto define su propio contrato de instantáneas para las referencias de contenido y recursos persistentes, generalmente como JSON. Los enlaces de interfaz conducen a definiciones, tipos y ejemplos de campo.

ProductoInterfaz SnapshotContenido principal
Hojas de cálculo (Sheet)IWorkbookDataHojas, celdas, estilos compartidos y recursos de complementos.
Documentos (Doc)IDocumentDataCuerpo, párrafos, estilos, encabezados, pies de página y recursos.
Presentaciones (Slide)ISlideDataDiapositivas, elementos, patrones, temas y recursos.
Tabla relacional (Relational Table)IBaseSnapshotTablas, campos, registros, vistas y su orden.
Lienzo (Canvases)IBoardDataPáginas, elementos, temas y recursos.
PDFIPdfUnitDataDocumento original, estado de edición persistente y vínculos de recursos.

Llame a save() en el producto Facade para obtener la instantánea actual, a continuación, utilice la API de creación correspondiente para restaurarlo. Contenido que ya está cargado se edita a través de las API de Facade. Para PDF, pdf.save() preserva tanto la base de referencia fuente como editState.

Formatos por producto

Los formatos de oficina y tabla que aparecen a continuación utilizan las rutas directas de Rust Exchange. PDF utiliza su propio módulo de conversión y, por lo tanto, se enumeran por separado en la misma tabla.

ProductoImportar / compilarExportarAlcance
Hojas de cálculo (Sheet).xls, .xlsx, .csv, .tsv.xlsx, .csv, .tsvCSV/TSV tiene una hoja de trabajo.
Documentos (Doc).doc, .docx.docxLegacy DOC se importa en el modelo Docs.
Presentaciones (Slide).ppt, .pptx.pptxLegacy PPT importa en el modelo Slides. Output es PPTX.
Tabla relacional (Relational Table).xls, .xlsx, .csv, .tsv.xlsx, .csv, .tsvCSV/TSV tiene una tabla. XLSX soporta la cartografía de mesa y campo.
Lienzo (Canvases)Mermaid (.mmd / texto fuente).pptxMermaid produce un borrador de importación, que se aplica a través de la Fachada de los Canvases antes de que se guarde una instantánea. PPTX exporta la página activa.
PDF.pdf.pdfRequiere el servicio de conversión de PDF, que está separado del Rust Exchange CLI.
  • .xls, .doc, y .ppt son formatos de importación. Sus formatos de salida son .xlsx, .docx, y .pptx respectivamente.
  • Una exportación CSV/TSV contiene una hoja de trabajo o una tabla de tablas relacionales. Ahorre la instantánea del producto cuando se requiera el modelo de contenido completo y sus recursos.
  • Diferentes puntos de entrada SDK aceptan diferentes extensiones. Para formatos como .xlsm, .pptm, .ppsx, .ppsm, y .potx, compruebe el backend desplegado y la API del navegador. No son nombres de formato Rust CLI directos adicionales.

Cálculo durante la conversión

Para los flujos de trabajo de conversión de hoja de cálculo soportada, la conversión de archivos se puede combinar con el cálculo lado servidor:

  • El cálculo de la Fórmula llena los resultados de caché perdidos en la importación, o recalcula antes de la exportación de acuerdo con la política seleccionada.
  • El cálculo de Pivot deriva agrupación y agregación de los datos fuente y la configuración de pivote, luego materializa los resultados para la instantánea o el libro de trabajo exportado.
  • El cálculo de formato número convierte los valores en fecha, porcentaje, moneda y otro texto de visualización formateado. Las exportaciones CSV/TSV pueden escribir valores de visualización o valores brutos.

Consulta Headless y cálculo en el servidor para el procesamiento de contenido relacionado.

Integración

La conversión de archivos pertenece al Server SDK. La aplicación proporciona la carga, el manejo de tareas, el almacenamiento y los endpoints de descarga. La conversión de instantáneas puede funcionar sin colaboración. Exportar un documento compartido lee una revisión confirmada después de que las ediciones pendientes se hayan sincronizado.

Empieza por Integración de la conversión y Conversión en Node.js.

El soporte de formato y la preservación de características individuales son preguntas separadas. Utilice la lista de características de cada producto y archivos de negocios reales para verificar fórmulas, imágenes, estilos y diseño a través de importación, edición y exportación.

Todas las funciones

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.