Integración de intercambio de archivos

Para abrir Excel en Univer, conviértelo primero en datos que pueda leer el editor. Para exportarlo, convierte los datos editados de nuevo en Excel. El módulo servidor @univerjs-pro/exchange-node realiza la conversión; el navegador sube archivos, abre documentos y descarga resultados.

Sin edición colaborativa

Por ejemplo, un usuario sube Excel, lo edita en la página y descarga el resultado como Excel.

1. El navegador sube el archivo y el servidor lo convierte a datos Univer y los devuelve.
2. El navegador abre una hoja con esos datos para editarla.
3. Al exportar, envía los datos editados al servidor, que genera Excel para descargar.

No requiere servicio de colaboración. La «instantánea» de las API del navegador es el conjunto de datos usado aquí. Su importación y exportación siguen necesitando conversión en el servidor. Para guardar el trabajo y retomarlo después, la aplicación debe almacenar esos datos.

Consulta Importación y exportación de Office para instalar y usar el módulo. Empieza allí también si solo necesitas procesar archivos en Node.js.

Con edición colaborativa

Por ejemplo, un usuario importa Excel, comparte el documento con compañeros, lo edita con ellos y lo exporta después.

1. El servidor convierte el archivo subido y guarda el resultado como documento colaborativo.
2. Devuelve un ID; el navegador lo abre y los demás usuarios se unen mediante el mismo ID.
3. Al exportar, el servidor lee el contenido más reciente y genera Excel para descargar.

El unitId de las API del navegador es ese ID. Completa primero la integración de colaboración y ejecuta el ejemplo Exchange, que incluye el código de navegador, servidor y conversión para seguirlo conjuntamente.

Espera a que se sincronicen las ediciones antes de exportar o podrían faltar cambios recientes. Consulta Office Exchange del lado servidor en Módulos de extensión para leer y convertir documentos colaborativos.

Conectar los botones de importación y exportación

Cuando funcione la conversión del servidor, conéctala a la página:

• Menús Univer o API Facade: sigue el ejemplo Exchange para implementar subida, conversión, consulta de tareas y descarga, y configura los plugins del navegador. Las direcciones y formatos de respuesta deben coincidir.
• Botones propios: llama a las API de tu aplicación. Tras importar, abre los datos o el ID devueltos; tras exportar, descarga el archivo generado.

Consulta la configuración en Sheets, Docs, Slides, Boards, Bases y PDFs. El ejemplo colaborativo usa Sheets. Para otros productos, consulta Importación y exportación de Office y los formatos de tu versión.

Comprobar la integración

Importa un archivo real de la aplicación, edítalo y expórtalo. Ábrelo en Office y revisa cambios, fórmulas, imágenes y diseño. En colaboración, verifica además que otros usuarios abran el mismo documento y que su contenido sobreviva a un reinicio del servidor.

Antes de desplegar, sustituye archivos temporales y tareas en memoria por almacenamiento de la aplicación, limita el tamaño de subida y gestiona fallos y tiempos de espera. Subidas, consultas y descargas necesitan controles de acceso; consulta Identidad y autorización.